156 lines
7.5 KiB
Plaintext
156 lines
7.5 KiB
Plaintext
<!DOCTYPE html>
|
|
<html lang="en">
|
|
<head>
|
|
<meta name="generator" content="HTML Tidy for HTML5 for Apple macOS version 5.8.0">
|
|
<title>Basic Programming</title><!--#include virtual="/help/en/parts/Style.shtml" -->
|
|
<!-- DecoderPro Styles -->
|
|
|
|
<style>
|
|
.dp-ctr {
|
|
text-align: center;
|
|
}
|
|
.dp-right {
|
|
text-align: right;
|
|
}
|
|
</style>
|
|
</head>
|
|
<body>
|
|
<!--#include virtual="/help/en/parts/Header.shtml" -->
|
|
|
|
<div id="mBody">
|
|
<!--#include virtual="Sidebar.shtml" -->
|
|
|
|
<div id="mainContent">
|
|
<h1>The Basic Programmer</h1>
|
|
|
|
<h2>The Roster Entry Pane</h2>
|
|
|
|
<div class="dp-right">
|
|
<p><a href="Programmer_Setup.shtml">Previous |</a> <a href=
|
|
"Basic_BasicPane.shtml">Next</a></p>
|
|
|
|
<p><a href="index.shtml#Basic%20Programmer">Back to Index</a>
|
|
</p>
|
|
</div>
|
|
|
|
<hr>
|
|
|
|
<p>The first action in programming a locomotive with DecoderPro® is to fill out the roster
|
|
entry screen.</p>
|
|
A <strong>roster</strong> is a database of all locomotives that your installation of
|
|
DecoderPro has programmed. It includes the information seen in the screen below:
|
|
<div class="dp-ctr"><img style="width: 636px; height: 556px;" src="images/Basic_Roster.png"
|
|
alt="basic roster">
|
|
</div>
|
|
|
|
<p>Most of these fields are self-explanatory. However, note that the first field
|
|
(<strong>ID</strong>) becomes the file name in the Roster for the locomotive you are
|
|
programming. Set up a schema to identify your locomotive to its decoder program. i.e.
|
|
Manufacturer, Loco Type, and Address (e.g. Kato_SD40-2_5645). Spaces in the ID field will be
|
|
changed to underscores (_) when the file is written. In a club environment, often the ID
|
|
begins with the owner's name, or member number. This way the Roster (which is sorted
|
|
alphabetically) will keep all of an owner's locomotives listed together.</p>
|
|
|
|
<p>The <strong>Decoder</strong> <strong>Comment</strong> field is a good place to add the
|
|
date you purchased the locomotive, price, or any other information you might feel is
|
|
important to record.</p>
|
|
|
|
<p>The [Save to Roster] button stores the current decoder information to your computer hard
|
|
drive and folder where your roster file is located. The default storage is the same directory
|
|
where the program is installed.</p>
|
|
|
|
<p>The [Reset to Defaults] button can be used to return the Roster file to the condition of a
|
|
new file for the type and version of the decoder listed in the roster entry. It does NOT
|
|
change the values in the roster file on your hard disk, unless you specifically save it after
|
|
using this reset button. It also is not written to the decoder until you specifically select
|
|
a write operation. It was included in DecoderPro so that if you get hopelessly confused in
|
|
proceeding screen to screen entering variables, you can return to the manufacturers baseline
|
|
default set and start again.</p>
|
|
|
|
<p><br>
|
|
Most decoders will activate the <strong>Reset Menu</strong> (next to the File menu at the top
|
|
of the page). This will reset the decoder to the manufacturers default settings for all the
|
|
CVs, or just some of them if the manufacturer has several reset routines. It does this by
|
|
writing directly to a CV in the decoder, if the decoder has that feature, CV8 in the case of
|
|
Digitrax. All decoders may not support reset and how they work is manufacturer and decoder
|
|
dependent.</p>
|
|
|
|
<p><br>
|
|
One decoder with a lengthy list of reset routines is the QSI Revolution decoder, which
|
|
enables a drop-down list of options for resetting the decoder as shown below:</p>
|
|
|
|
<p class="dp-ctr"><img style="width: 652px; height: 601px;" src="images/Factory%20Reset.png"
|
|
alt="factory reset">
|
|
</p>
|
|
|
|
<p>You will note that the decoder address is shown but grayed out (or blank if this is a new
|
|
locomotive in the roster). This field is automatically filled in by the program and is
|
|
determined from the address entered using the <strong>Basic</strong> tab which we will get to
|
|
shortly. This address is used with the <strong>Ident</strong> function on the start page if
|
|
you wish to recall a locomotive that is already in your roster.</p>
|
|
|
|
<p id="ProgramModes">The Programming mode can be changed by selecting mode from drop-down
|
|
list at the bottom of the window. To the left of the Drop-down list is the current
|
|
programming mode that is selected.</p>
|
|
|
|
<div class="dp-ctr"><img src="images/SetProgramMode.png" alt="Set pogram mode dialog">
|
|
</div>
|
|
|
|
<p>There are several <a href="Basic_Mode.shtml"><strong>programming modes</strong></a>. JMRI
|
|
now selects the best mode for you. It determines this from the command station type you are
|
|
using and the decoder model you are attempting to program. Usually this will be OK. If you
|
|
find that you are having a problem with programming you may try a different mode.</p>
|
|
|
|
<p>For most newer decoders, stay with <strong>Paged mode</strong> or whichever Direct mode
|
|
your Command Station supports. Your decoder documentation should let you know if programming
|
|
in some other mode is necessary... but if you are having problems, experiment. If a mode is
|
|
not supported for the selected decoder and system, that option will be grayed out.</p>
|
|
|
|
<p>When you make your selection, the programming mode should now display to the left of the
|
|
drop-down list.</p>
|
|
|
|
<p>Basic Programming Roster setup for Athearn FP45 n scale with Digitrax Tsunami Diesel
|
|
Genesis OEM decoder.</p>
|
|
|
|
<p class="dp-ctr"><img style="width: 636px; height: 556px;" src="images/Basic_Roster01.png"
|
|
alt="roster">
|
|
</p>
|
|
|
|
<p>Now that we have the Roster information all in order, we can continue with programming the
|
|
decoder.</p>
|
|
|
|
<p>But, first a let's talk a bit about Roster management. The Main DecoderPro window (the one
|
|
where we selected the programmer) and the initial DecoderPro "Splash" screen have a menu
|
|
called <strong>Roster.</strong> When you click on it you get opportunities to modify, print
|
|
and move your roster files. Particularly interesting are <strong>Export/Import</strong> and
|
|
<strong>Copy</strong>. Let's say you and a friend have two identical Berkshires, and you
|
|
desire to have yours to be set up just like your friends. Now, you could put his loco on your
|
|
track and read all the CVs out and then put them in yours, but if he lives on the other coast
|
|
that's not practical. So, have him use DecoderPro to export his loco file and e-mail it to
|
|
you. You import it into DecoderPro, change the address if you wish and then use that roster
|
|
entry to program your loco. Similarly you can Copy a roster entry to duplicate one of your
|
|
own locomotives into a second roster entry with it's own address. Details about the
|
|
<strong><a href="Main_Roster.shtml">Roster Menu</a></strong></p>
|
|
|
|
<p class="dp-ctr"><img style="width: 456px; height: 334px;" alt="roster edit" src=
|
|
"images/RosterEdit.png"><br>
|
|
</p>
|
|
|
|
<p>Let's move on to the Basic Programmer.</p>
|
|
|
|
<div class="dp-right">
|
|
<p><a href="Programmer_Setup.shtml">Previous |</a> <a href=
|
|
"Basic_BasicPane.shtml">Next</a></p>
|
|
|
|
<p><a href="index.shtml#Basic%20Programmer">Back to Index</a>
|
|
</p>
|
|
</div>
|
|
<!--#include virtual="/help/en/parts/Footer.shtml" -->
|
|
</div>
|
|
<!-- closes #mainContent-->
|
|
</div>
|
|
<!-- closes #mBody-->
|
|
<script src="/js/help.js"></script>
|
|
</body>
|
|
</html>
|