/
Basic_BasicPane.shtml
257 lines (214 loc) · 11.4 KB
/
Basic_BasicPane.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
<!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>Basic Programming</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" -->
<div id="mBody">
<!--#include virtual="Sidebar" -->
<div id="mainContent">
<a name="Top" id="Top"></a>
<h1>The Basic Programmer</h1>
<h2>Basic Pane</h2>
<div align="right">
<p><a href="Basic_Start.shtml">Previous |</a> <a href=
"Comp_Setup_Roster.shtml">Next</a></p>
<p><a href="index.shtml#Basic%20Programmer">Back to
Index</a></p>
</div>
<hr>
<p>You may have noticed that at the top of the window are Two
tabs: <strong>Roster Entry</strong> and
<strong>Basic</strong>. We have completed the <strong>Roster
Entry</strong> pane of the Program window, now, click on the
<strong>Basic</strong> tab to change panes to continue with
programming your decoder. The Basic pane will be displayed
and look similar to the following illustration: Many panes in
the programmer contain decoder dependent features, as a
result what you see may not exactly agree with what you see
here. Only those variables that your decoder can implement
will be shown.</p>
<div align="center">
<img style="width: 636px; height: 556px;" src=
"images/Basic_Program.png" alt="Basic pane">
</div>
<p>You will see three options you can change, highlighted in
yellow:</p>
<ol>
<li>The decoder address (should be unique among your
locomotives, unless you are operating as a set) often the
locomotive number is used.</li>
<li>Two radio buttons that let you toggle between 2 digit
(one byte, normal) or 4 digit<br>
(two byte, extended) addressing</li>
<li>Analog operation (enables the decoder running under
regular DC voltage/analog<br>
control)</li>
</ol>
<p>The yellow highlighting indicates these options are
"probable" settings and have not been confirmed from the
decoder. Settings that have been changed by the user and have
not been written back to the decoder appear in a orange
color.</p>
<p>Color Codes used in the programming panes.</p>
<dl>
<dt style=
"background: rgb(221, 221, 221) none repeat scroll 0%; color: orange; -moz-background-clip: -moz-initial; -moz-background-origin: -moz-initial; -moz-background-inline-policy: -moz-initial;">
Edited</dt>
<dd>You've changed this value, or it contains default
values from the decoder file. This is shown as orange,
since the value differs from what's in the decoder.</dd>
<dt style=
"background: rgb(221, 221, 221) none repeat scroll 0%; color: yellow; -moz-background-clip: -moz-initial; -moz-background-origin: -moz-initial; -moz-background-inline-policy: -moz-initial;">
From File</dt>
<dd>The field contains values read from a locomotive file.
This is shown as yellow, since we're not certain that the
file agrees with the decoder contents.</dd>
<dt style=
"background: rgb(221, 221, 221) none repeat scroll 0%; color: white; -moz-background-clip: -moz-initial; -moz-background-origin: -moz-initial; -moz-background-inline-policy: -moz-initial;">
Read</dt>
<dd>The value shown has been read from the decoder. This is
shown as white to indicate that the value is
trustworthy.</dd>
<dt style=
"background: rgb(221, 221, 221) none repeat scroll 0%; color: white; -moz-background-clip: -moz-initial; -moz-background-origin: -moz-initial; -moz-background-inline-policy: -moz-initial;">
Stored</dt>
<dd>The value show has been written to the decoder. This is
also shown as white.</dd>
<dt style=
"background: rgb(221, 221, 221) none repeat scroll 0%; color: red; -moz-background-clip: -moz-initial; -moz-background-origin: -moz-initial; -moz-background-inline-policy: -moz-initial;">
Unknown</dt>
<dd>If something goes wrong with the read or write process,
we might have a completely untrustworthy result. This
results in the variable's state being marked as UNKNOWN and
shown as red.</dd>
</dl>
<p>You will see examples of<br>
this throughout the manual.</p><a name="ReadData"></a> To
read the actual settings for these options (and IF your
system and installed decoder will allow readback of decoder
values), click on the <strong><input name="button" id=
"button" value="Read full sheet" type="button"></strong> .
The individual settings will turn red while they are in the
process of being read (clever, eh?), and will turn white once
the values have been read successfully from the decoder. Once
again, Decoder Pro must play "Twenty Questions" to get this
information, and sometimes even has to ask a couple of times.
<p>Be patient, especially with older computers. At the very
bottom of the pane (where it says "idle") you will see a
running account of exactly what DecoderPro is doing, for
example, the specific CV being read.</p>
<p>Again, the <input name="button2" id="button2" value=
"Read full sheet" type="button"> and <strong><input name=
"button3" id="button3" value="Read all sheets" type=
"button"></strong> functions are dependent on your Command
Station. If your system does not have the capability to read
CVs, then these buttons will not be available.</p>
<p><a name="EnterEditData"></a>If you wish to change the
address of the locomotive, type in the new address. To turn
on or off 4 digit addressing, select the desired radio
button. . Be sure that the address type agrees with the
number of characters in the address.</p>
<p>To enable Analog (old style DC, some vendors refer to this
as dual mode) Operation select the appropriate entry from the
drop-down list.</p>
<p>When you are finished, click on <input name="button4" id=
"button4" value="Write full sheet" type="button"> to write
the new values in the decoder.</p>
<p><a name="WriteData"></a>Writing usually takes much less
time than reading, because the value can be sent directly. As
the write operation proceeds, the data will change from
yellow to white. If there is difficulty writing to the
decoder, the data will change to red. The software will
automatically keep trying until the write operation is
successful. In some instances the system will "time-out"
after a certain number of tries without an acknowledgement
from the decoder. This does not necessarily mean that the
values have not been written, just that the program has not
received an acknowledgement. This can be due to the
locomotive moving and getting on dirty track so that it can't
pulse back, or possibly because the command station or
decoder cannot read back. Try moving the loco and try again.
If it is a command station or decoder read-back issue, try
the loco on the mainline and see if the programming was
successful.</p>
<p><a name="SaveData"></a> To finish this "basic"
programming of a decoder, click once more on the
<strong>Roster Entry</strong> tab, You will see that the
address field has now been filled in, so you can now click on
the <strong><input name="button5" id="button5" value=
"Save to roster" type="button"></strong> . Your new decoder
settings have now been written not only to the decoder, but
also saved to a computer file where they may be recalled in
the future. .</p>
<a name="DoMore"></a> But you say..."I want
to change more than what's shown on the Basic decoder pane."
Well… there are other programmers that are available.
But… first we need to look at the various options. In
fact there are so many options the programmers had to use a
slider to get them all to show. Here are the option windows.
Don't panic….Most are of no use to the average user.
<p align="center"><img src="images/Basic_programmers.png"
alt="Basic Programmers" height="341" width="568"><br></p>
<p><strong>Comprehensive</strong> and Advanced are the only
other programmers "<strong><em>Normal Users</em>"</strong>
will ever need, because it is,
well…<strong>Comprehensive</strong> and the
<strong>Advanced</strong> adds features that are optional..
So why all the others?</p>
<p>First of all eliminate the Manufacturer specific
programmers (unless of course you have a
<strong>Zimo</strong> or <strong>ESU</strong> system).</p>
<p>We can also eliminate the <strong>Tutorial</strong> and
<strong>Custom</strong> programmers. They were put in to show
folks that want to <strong>write their own</strong>
programmer (not you right?) all the possible ways to gather
input and to have a common starting point in the roster pane.
Now if you wish to pursue writing a custom programmer go to
the JMRI® website.</p>
<p>If you have need for a special situation programmer you
might want to look at <strong>Sample Club</strong> or
<strong>TrainShowBasic</strong> to see what panes can be
taken out of Comprehensive to make an intermediate
complexity, special purpose programmer. Again, how to do this
is a subject for another manual.</p>
<p>And that leaves us with the <strong>Advanced</strong> and
<strong>Registers</strong> programmers. The
<strong>Advanced</strong> programmer has a couple of
sophisticated features added on top of the
<strong>Comprehensive</strong> programmer and a name was
needed. Well, why not call it <strong>Advanced</strong>?
We'll cover the additional features once we get through with
<strong>Comprehensive</strong>.<br>
So what about the <strong>Registers</strong> programmer? If
you have an old or bargain basement decoder that only
programs using registers, then of course you'll be interested
in <strong>Registers.</strong><br>
So now we've narrowed our "real" choices down to
<strong>Advanced</strong>, <strong>Basic</strong> and
<strong>Comprehensive</strong>. Since we've already covered
<strong>Basic</strong>, let's explore the <a href=
"Comp_Setup_Roster.shtml">Comprehensive Programmer</a>!</p>
<div align="right">
<p><a href="Basic_Start.shtml">Previous |</a> <a href=
"Comp_Setup_Roster.shtml">Next</a><a href=
"Comp_Setup_Roster.shtml"></a></p>
<p><a href="index.shtml#Basic%20Programmer">Back to
Index</a></p>
</div><!--#include virtual="/Footer" -->
</div><!-- closes #mainContent-->
</div><!-- closes #mBody-->
</body>
</html>