80 lines
3.4 KiB
Plaintext
80 lines
3.4 KiB
Plaintext
<!DOCTYPE html>
|
|
<html lang="en">
|
|
<head>
|
|
<meta name="generator" content="HTML Tidy for HTML5 for Apple macOS version 5.8.0">
|
|
<title>JMRI Hardware Support - NAC Services RPS Sensors</title>
|
|
<!--#include virtual="/help/en/parts/Style.shtml" -->
|
|
</head>
|
|
<body>
|
|
<!--#include virtual="/help/en/parts/Header.shtml" -->
|
|
|
|
<div id="mBody">
|
|
<!--#include virtual="Sidebar.shtml" -->
|
|
|
|
<div id="mainContent">
|
|
<h1>Hardware Support: NAC Services RPS Sensors</h1>
|
|
<em>Please note that JMRI's RPS support is being rapidly improved. This page refers to most
|
|
recent JMRI test version. If you're using an RPS system, you should update to new test
|
|
versions as they <a href="https://www.jmri.org/download/index.shtml">are announced</a>.</em>
|
|
<p>The <a href="https://www.proto87.com/model-trains-DCC-decoders.html">RPS System</a>
|
|
provides an absolute location of RPS-equipped rolling stock.</p>
|
|
|
|
<p>JMRI can use that to set <a href="../../tools/Sensors.shtml">Sensors</a> when a RPS
|
|
transmitter is in a specific area, which can in turn be used to control other JMRI functions
|
|
such as <a href="../../tools/Signals.shtml">Signals</a>, <a href=
|
|
"../../tools/Routes.shtml">Routes</a> and <a href="../../tools/Logix.shtml">Logix</a>.</p>
|
|
|
|
<h2 id="connecting">Connecting</h2>
|
|
|
|
<h3>Defining a Sensor</h3>
|
|
|
|
<p>An RPS Sensor is associated with an area bounded by a series of points and the lines
|
|
between those points.<br>
|
|
There are two ways to create an RPS Sensor and define the area on the layout that it
|
|
covers.</p>
|
|
|
|
<h4>By Coordinates</h4>
|
|
You can enter a series of coordinates that list the corners of the region to be covered. For
|
|
example, the points defining a square one unit on a side are:
|
|
|
|
<pre style="font-family: monospace;">
|
|
(0,0,0)
|
|
(1,0,0)
|
|
(1,1,0)
|
|
(0,1,0)
|
|
</pre>If you use the Sensor Table's "Add..." button to create a Sensor with the System Name
|
|
|
|
<pre style="font-family: monospace;">
|
|
RS(0,0,0);(1,0,0);(1,1,0);(0,1,0)
|
|
</pre>you'll get an RPS Sensor that shows "ACTIVE" when a Transmitter is present in that area, and
|
|
"INACTIVE" otherwise.
|
|
<p>The "R" means the RPS system, "S" means you're defining a Sensor, and the rest of the name
|
|
defines the coordinates of the corners of the region to include in the Sensor. Each corner is
|
|
specified by its X, Y and Z values, all grouped together with parentheses. The corners should
|
|
be separated by semicolons; see the example above.</p>
|
|
|
|
<p>Once you've defined your Sensor, you can use the <a href=
|
|
"../../../package/jmri/jmrix/rps/trackingpanel/RpsTrackingFrame.shtml">Tracking display</a>
|
|
to see if it's in the right place on your layout.</p>
|
|
|
|
<h4>Using the Tracking Tool</h4>
|
|
(To be written, for now see the <a href=
|
|
"../../../package/jmri/jmrix/rps/trackingpanel/RpsTrackingFrame.shtml">Tracking display help
|
|
page</a>.)
|
|
<h2 id="documentation">Documentation</h2>
|
|
|
|
<h3>JMRI Help</h3>
|
|
Back to the <a href="index.shtml">Main RPS Help</a> page.
|
|
<h3>Third Party info</h3>
|
|
|
|
<p>More information is available on the <a href=
|
|
"https://www.proto87.com/model-trains-DCC-decoders.html">RPS Web Site</a>.</p>
|
|
<!--#include virtual="/help/en/parts/Footer.shtml" -->
|
|
</div>
|
|
<!-- closes #mainContent-->
|
|
</div>
|
|
<!-- closes #mBody-->
|
|
<script src="/js/help.js"></script>
|
|
</body>
|
|
</html>
|