-
Notifications
You must be signed in to change notification settings - Fork 331
/
index.shtml
291 lines (228 loc) · 10.8 KB
/
index.shtml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html lang="en">
<head>
<meta name="generator" content=
"HTML Tidy for Mac OS X (vers 31 October 2006 - Apple Inc. build 15.17), see www.w3.org">
<title>JMRI Hardware Support - NAC Services RPS</title>
<!-- Style -->
<meta http-equiv="Content-Type" content=
"text/html; charset=us-ascii">
<link rel="stylesheet" type="text/css" href="/css/default.css"
media="screen">
<link rel="stylesheet" type="text/css" href="/css/print.css"
media="print">
<link rel="icon" href="/images/jmri.ico" type="image/png">
<link rel="home" title="Home" href="/">
<!-- /Style -->
</head>
<body>
<!--#include virtual="/Header.shtml" -->
<div id="mBody">
<!--#include virtual="Sidebar.shtml" -->
<div id="mainContent">
<h1>Hardware Support: NAC Services RPS</h1>
<p><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=
"http://jmri.org/download/index.shtml">are
announced</a>.</em></p>
<p>The <a href=
"http://www.proto87.com/model-trains-DCC-decoders.html">RPS
System</a> allows you to locate the exact position of
locomotives and other rolling stock that have been equipped
with transmitter decoders. The system makes up to 10
measurements per second and each reading is accurate to much
better than an inch, which makes many imaginative uses
possible. <a name="hardware" id="hardware"></a></p>
<h2>Supported Hardware</h2>
<h3>DCC Systems</h3>
<p>The RPS system works in conjunction which your DCC system
to control when the RPS transmitters are activated. You
therefore need a working connection between your DCC system
and JMRI to use RPS.</p>
<p>At the present time, RPS is supported with DCC systems
from:</p>
<ul>
<li>Digitrax</li>
<li>Lenz</li>
<li>NCE</li>
</ul>Others may work, and we're interested in making them
work, but they haven't been tested in combination with RPS
yet. <a name="connecting" id="connecting"></a>
<h2>Connecting</h2>
<p>First, get your DCC system working and connected to JMRI.
As a good test of the connection, you should be able to turn
your layout power on and off from the JMRI Power Control in
the Tools menu.</p>
<h3>Wiring</h3>
<p>Next set up the RPS hardware following the RPS
instructions. You may want to only install a few (but a
minimum of three) receivers while you're first getting the
system working.</p>
<p>Next, connect your computer to the RPS using either a USB
connection or an RS232 cable from a serial port. If you use
an RS232 cable, note that it should be a "straight-through"
or "modem" cable, <i>not</i> a "crossover" or "null-modem"
cable.</p>
<h3>Settings</h3><img src="images/NAC_RPSConnection.png"
width="431" height="200" align="right" alt=
"RPS Connection pane">
<p>To configure RPS in JMRI:</p>
<ul>
<li>Start your JMRI-based program: DecoderPro, PanelPro,
etc.</li>
<li>Go to the Connections tab of the JMRI Preferences. This
opens automatically the first time the application is run,
or you can select it from the "Edit" menu.</li>
<li>Your DCC connection should already be configured in the
top section, as you tested it three steps back.</li>
<li>Click on the "+" sign to the right of your current
Connection to open a new Connections pane.</li>
<li>Select "NAC Services" from the list as the "System
Manufacturer".</li>
<li>Select "RPS Base Station" as the "System
Connection".</li>
<li>In the associated port selection box under Settings,
pick the name of the serial port that you have connected to
the RPS system.</li>
<li>The baud rate will show a fixed value of 115,200
baud.</li>
<li>As a temporary measure during development of the
system, there's a "Protocol" option to select.<br>
The valid choices are "Version 1" and "Version 2"; your
hardware determines which to use. Most current RPS systems
use "Version 2". <em>This selection will eventually be
automated.</em></li>
<li>Click "Save". You'll be asked if it's OK for the
program to quit, click "Yes".</li>
<li>Restart the program. It should come up saying it's
connected to your DCC system, and just below that saying
it's connected to the RPS Base Station on the proper
port.</li>
<li>Next, you have to enter alignment information. From the
RPS menu, select "<a href=
"../../../package/jmri/jmrix/rps/aligntable/AlignTableFrame.shtml">Receiver
Control</a>". This will open a new window.</li>
<li>In the middle of that window, enter the number of
highest-numbered receiver you've got. For example, if you
have three receivers numbered 2, 3 and 6, enter 6 in the
field.<br>
Press the "Set" button next to that field.</li>
<li>In the table at the top, enter the X, Y and Z position
of each of your receivers. If you don't have a receiver
with a particular number, leave that row blank. For now,
just enter approximate values.</li>
<li>Check the boxes next to each receiver you have hooked
up, and make sure that there's no box checked next for
receiver numbers that are not yet connected.</li>
<li>Click the "Set Defaults" button to save these positions
as default values. They'll appear again when you next start
the program.</li>
</ul>At this point, your RPS system is ready to go.
<p>To have your RPS system start measuring positions, you
have to tell it to poll the Locomotives in which you've
installed RPS transmitters.<br>
To do this:</p>
<ul>
<li>Open "<a href=
"../../../package/jmri/jmrix/rps/swing/polling/PollTableFrame.shtml">RPS
Polling Control</a>" from the RPS menu</li>
<li>You should see all of the Locomotives in your
Roster</li>
<li>Check the box under "Poll" for each Locomotive in which
an RPS Transmitter is installed</li>
<li>Check the "poll" box to start making measurements</li>
<li>Click "Store New Default Values" to store these
settings so they'll be used the next time you start
JMRI.</li>
</ul>
<p>To see that the system is working, open the "<a href=
"../../../package/jmri/jmrix/rps/swing/debugger/DebuggerFrame.shtml">Debugger
Window</a>" from the RPS menu. You should see time readings
coming in and being converted to positions. You can also
check the communications with the unit by opening the "RPS
Monitor" from the RPS menu. <a name="tools" id=
"tools"></a></p>
<h2>JMRI RPS Tools</h2><img src="images/RPSmenu.png" width=
"239" height="176" align="right" alt="Menu">
<p>JMRI provides a number of tools in the RPS menu for
working with an RPS system:</p>
<dl>
<dt>RPS Monitor</dt>
<dd>The pane displays all traffic seen on the
connection<br>
<a href="images/RPSMonitor.png"><img src=
"images/RPSMonitor.png" alt="RPS Monitor Pane" width="352"
height="84"></a></dd>
<dt><a href=
"../../../package/jmri/jmrix/rps/aligntable/AlignTableFrame.shtml">
Receiver Control</a></dt>
<dd>This is where you enter position information about your
receiver positions, etc.<br>
<a href="images/ReceiverControl.gif"><img src=
"images/ReceiverControl.gif" alt="Receiver Control Pane"
width="292" height="119"></a></dd>
<dt><a href=
"../../../package/jmri/jmrix/rps/swing/polling/PollTableFrame.shtml">
Polling Control</a></dt>
<dd>This is where you tell JMRI which locomotives have RPS
transmitters, and how often you want JMRI to poll them.<br>
<a href="images/PollControl.gif"><img src=
"images/PollControl.gif" alt="Polling Control Pane" width=
"300" height="80"></a> Older Polling Control pane<br>
<a href="images/RPSPollingControl.png"><img src=
"images/RPSPollingControl.png" alt=
"Polling Control Pane v4.1.6" width="292" height="101"></a>
Version 4.1.6 Polling Control pane with new options</dd>
<dt><a href=
"../../../package/jmri/jmrix/rps/swing/debugger/DebuggerFrame.shtml">
Debugger Window</a></dt>
<dd>This tool shows you the readings and measurements as
the system makes them.<br>
<a href="images/RPSDebugger.png"><img src=
"images/RPSDebugger.png" alt="RPS Debugger Pane" width=
"165" height="207"></a></dd>
<dt><a href=
"../../../package/jmri/jmrix/rps/trackingpanel/RpsTrackingFrame.shtml">
Tracking Display</a></dt>
<dd>This tool shows the points as they are measured on a
graphical display.<br>
<a href="images/RpsTracker.jpg"><img src=
"images/RpsTracker.jpg" alt="RPS Tracker Pane" width="209"
height="248"></a></dd>
<dt><a href=
"../../../package/jmri/jmrix/rps/swing/soundset/SoundSetFrame.shtml">
Sound Speed Monitor</a></dt>
<dd>This tool lets you see and set the speed of sound used
by the RPS system, and can set it automatically in certain
cases.<br>
<a href="images/SoundControl.gif"><img src=
"images/SoundControl.gif" alt="Sound Control Pane" width=
"277" height="100"></a></dd>
<dt><a href=
"../../../package/jmri/jmrix/rps/reversealign/AlignmentPanel.shtml">
RPS Alignment</a></dt>
<dd>This tool lets you read and calculate spatial
coordinates.<br>
<a href="images/RPSAlignment.png"><img src=
"images/RPSAlignment.png" alt="RPS Alignment Pane" width=
"452" height="282"></a></dd>
</dl>You can also display RPS information on PanelPro Control
Panels using an "<a href=
"../../../package/jmri/jmrit/display/RpsIcon.shtml">RPS
Icon</a>".
<p>RPS information may be used to detect occupancy using
<a href="sensors.shtml">JMRI RPS Sensors</a>. <a name=
"documentation" id="documentation"></a></p>
<h2>Documentation</h2>
<h3>Third Party info</h3>
<p>More information on the <a href=
"http://www.proto87.com/model-trains-DCC-decoders.html">RPS
Web Site</a>.</p>
<!--#include virtual="/Footer.shtml" -->
</div><!-- closes #mainContent-->
</div><!-- closes #mBody-->
</body>
</html>