Serge NOEL
476 lines
16 KiB
Plaintext
476 lines
16 KiB
Plaintext
<!DOCTYPE html>
|
|
<html lang="en">
|
|
<head>
|
|
<meta name="generator" content="HTML Tidy for HTML5 for Apple macOS version 5.8.0">
|
|
<!-- NEEDS REWRITE -->
|
|
|
|
<title>JMRI: DecodePro Preferences</title><!--#include virtual="/help/en/parts/Style.shtml" -->
|
|
<!-- DecoderPro Styles -->
|
|
|
|
<style>
|
|
.dp-center {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>Getting Started with DecoderPro®</h1>
|
|
|
|
<h2>How to set up Preferences</h2>
|
|
|
|
<div class="dp-right">
|
|
<p><a href="Start_DecoderPro.shtml">Previous</a><br>
|
|
<a href="index.shtml#Getting%20Started">Back to Index</a>
|
|
</p>
|
|
</div>
|
|
|
|
<p class="important">The current JMRI Preferences Help is <a href=
|
|
"../../html/setup/index.shtml#setprefs">here</a>.</p>
|
|
|
|
<p>From the Edit menu in DecoderPro select <strong>Preferences</strong>. On Mac OS X choose
|
|
Preferences... from the DecoderPro application menu. This window may open automatically the
|
|
first time you run the program.</p>
|
|
|
|
<p><img src="images/preferences_menu.png" alt="prefernces menu" height="252" width="275">
|
|
</p>
|
|
|
|
<p>As a first time user the most important information is the <strong>Connections</strong>
|
|
screen where you describe how the computer will talk to the command station. Most of rest you
|
|
can leave at the initial or "default" settings until you find a need to change things to suit
|
|
your fancy.</p>
|
|
|
|
<p><strong>Most importantly, you must click <span class="textbutton">Save</span>
|
|
to finalize your settings and then re-start the program to have them take effect.</strong>
|
|
</p>
|
|
|
|
<p>The Preferences window provides access to the basic configuration information to connect
|
|
your computer to your DCC system. You will be using that system to actually program and
|
|
operate trains equipped with DCC decoders. An important concept to keep in mind is that JMRI
|
|
is nothing more than a very smart throttle. If you can do something with your throttle you
|
|
can probably do it faster and easier with JMRI. However, if your system can't do what you
|
|
want, either because your system is not connected properly (it's broken) or the system
|
|
manufacturer did not incorporate that capability, then JMRI will not be able to do it either.
|
|
In the latter case JMRI will probably give you an error message or have the command "greyed
|
|
out" to help you identify why it can't accomplish your request.</p>
|
|
|
|
<p>The window is split into two panes, on the left side is a list of preference groups that
|
|
may be set. Clicking on one of the items opens the options that may be set in the right side
|
|
pane. No selection have been made</p>
|
|
|
|
<blockquote>
|
|
<blockquote>
|
|
<h1><img src="images/Preferences.png" alt="Preferences" height="288" width="502">
|
|
</h1>
|
|
</blockquote>
|
|
</blockquote>
|
|
|
|
<p><a id="Top"></a>
|
|
</p>
|
|
|
|
<table style="margin-left: auto; margin-right: auto;">
|
|
<tbody>
|
|
<tr>
|
|
<td><strong><a href="#Connections">Connections</a><a href="#Connectorss"></a></strong>
|
|
</td>
|
|
<td>Allows you to select the system connection that you are using for controlling DCC
|
|
and the connection to your computer. This is the only required preferences to define
|
|
your DCC system. The rest of the features are used to customize your specific
|
|
system.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td><strong><a href="#Defaults">Defaults</a></strong>
|
|
</td>
|
|
<td>Shows system default settings</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td><strong><a href="#FileLocations">File Locations</a></strong>
|
|
</td>
|
|
<td>Set default location for saving User files and Script Files</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td><strong><a href="#StartUp">Start Up</a></strong>
|
|
</td>
|
|
<td>Allows you to set Actions, Buttons, Files and Scripts that run at Start Up</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td><strong><a href="#Display">Display</a></strong>
|
|
</td>
|
|
<td>Allows you to select your computer display mode</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td><strong><a href="#Messages">Messages</a></strong>
|
|
</td>
|
|
<td>Set default actions for system message when displayed</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td><strong><a href="#Roster">Roster</a></strong>
|
|
</td>
|
|
<td>Allows you to set your default Programmer and roster location</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td><strong><a href="#Throttle">Throttle</a></strong>
|
|
</td>
|
|
<td>Allows you to set up you Throttle preferences</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td><strong><a href="#WiThrottle">Wi Throttle</a></strong>
|
|
</td>
|
|
<td>Allows you to set up a Wi Throttle settings</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td><strong><a href="#JSON">JSON Server</a></strong>
|
|
</td>
|
|
<td>The JMRI <em>Json</em> Servlet provides web access to lists and values for numerous
|
|
JMRI-defined entities, in the modern <em>JSON</em> format.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td><strong><a href="#MiniServer">Web Server</a></strong>
|
|
</td>
|
|
<td>Sets up the Decoder Pro® miniServer</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
<blockquote>
|
|
<blockquote>
|
|
<p>Now we will set up preferences for the JMRI environment with your command station.</p>
|
|
</blockquote>
|
|
</blockquote>
|
|
|
|
<table class="dp-center">
|
|
<tbody>
|
|
<tr>
|
|
<td>I am using a Digitrax Super Chief Command Station (radio) interfaced to the
|
|
computer via LocoNet, PR3 (MS100 mode) and USB port. I keep master roster on the System
|
|
Drive.;</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
<blockquote>
|
|
<blockquote>
|
|
<h3 id="Connections">Connections Pane (TABS are configured to the system your
|
|
selected)</h3>
|
|
|
|
<p>Now select Connections and connection options display in right pane. After saved and
|
|
restarted, the TAB will read LocoNet. This the set up for Digitrax Chief system with PR3
|
|
interface.</p>
|
|
|
|
<p><img src="images/Preferences2.png" alt="connectionpane" height="441" width="666">
|
|
</p>
|
|
</blockquote>
|
|
</blockquote>
|
|
|
|
<table class="dp-center">
|
|
<tbody>
|
|
<tr>
|
|
<td style="width: 20%">System manufacturer:</td>
|
|
<td colspan="2">Drop-down list with all the supported DCC manufacturers, select the
|
|
manufacturer of your system.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td>System connection:</td>
|
|
<td colspan="2">Drop-down list with all of the supported DCC system interfaces
|
|
supported by the manufacturer that you selected, select the interface that you are
|
|
using.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td rowspan="4">Settings:</td>
|
|
<td style="width: 20%">Serial Port:</td>
|
|
<td>Drop-down list to select the serial port to which your DCC interface is connected.
|
|
If you do not know, check your system hardware configuration manual. A second drop-down
|
|
list may include a selection if there are more than one possibility.
|
|
possibilityDrop-down list to select the serial port to which your DCC interface is
|
|
connected. If you do not know, check your system hardware configuration manual. A
|
|
second drop-down list may include a selection if there are more than one
|
|
possibility</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td>Command station type:</td>
|
|
<td>Drop-down list to select the command station type that JMRI will be using to send
|
|
your DCC commands.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td>Connection prefix</td>
|
|
<td>Include the prefix for your connection, in the case shown the "L" is default</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td>Connection name</td>
|
|
<td>Should default to the connection used</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
<blockquote>
|
|
<blockquote>
|
|
<p><input name="checkbox" id="checkbox" type="checkbox"> Additional Connection Settings,
|
|
if checked: <img src="images/Preferences3.png" alt="preference" height="139" width=
|
|
"350"><br></p>
|
|
|
|
<ul>
|
|
<li>Connection Baud rate (if applicable, match your hardware)</li>
|
|
|
|
<li>Flow Control (option only on specific types, best to leave at default)</li>
|
|
|
|
<li>Output Interval (default: 250 milliseconds, serial connections only, intended for
|
|
debugging/advanced users)</li>
|
|
</ul>
|
|
|
|
<p>The <span class="textbutton">Disable Connection</span> button will
|
|
disable all the connection settings.</p>
|
|
|
|
<p><strong><a href="#Top">Top</a></strong>
|
|
</p>
|
|
|
|
<h3 id="Defaults">Defaults Pane</h3>
|
|
|
|
<p><img style="width: 674px; height: 444px;" alt="default preferences" src=
|
|
"images/Preferences4.png"><br>
|
|
</p>
|
|
|
|
<p>Shows the default settings which will depend upon the system used.</p>
|
|
|
|
<p><a href="#Top">Top</a>
|
|
</p>
|
|
|
|
<h3 id="FileLocations">File locations Pane</h3>
|
|
|
|
<p><img src="images/Preferences5.png" alt="preferences" height="450" width="663">
|
|
</p>
|
|
</blockquote>
|
|
</blockquote>
|
|
|
|
<table style="margin-left: auto; margin-right: auto;">
|
|
<tbody>
|
|
<tr>
|
|
<td><strong>User File Locations</strong>
|
|
</td>
|
|
<td>Select the location for your user files on your system</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td><strong>Jython Script Location</strong>
|
|
</td>
|
|
<td>Set the location of Jython Script files</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
<blockquote>
|
|
<blockquote>
|
|
<p><strong><a href="#Top">Top</a></strong>
|
|
</p>
|
|
|
|
<h3 id="StartUp">Start Up Pane</h3>
|
|
</blockquote>
|
|
</blockquote>
|
|
|
|
<p><em>Start Up</em> preferences allow windows and files to be opened, scripts to be run, and
|
|
additional buttons to be placed on the main window when the application starts.</p>
|
|
|
|
<p>Click the <strong>Add ▾</strong> button and select the type of start up action to add. The
|
|
new action will be added last.</p>
|
|
|
|
<p>Start up action order is important. In most cases, scripts should be the last items in the
|
|
start up order. Start up order can be changed by selecting a start up item and moving it
|
|
<em>up</em> or <em>down</em> in the list.</p>
|
|
|
|
<p><strong><a href="#Top">Top</a></strong>
|
|
</p>
|
|
|
|
<blockquote>
|
|
<blockquote>
|
|
<p><strong><a href="#Top">Top</a></strong>
|
|
</p>
|
|
|
|
<h3 id="Display">Display Panes</h3>
|
|
|
|
<h4>GUI TAB</h4>
|
|
|
|
<p><img src="images/Preferences_GUI.png" alt="GUI" height="467" width="667">
|
|
</p>
|
|
</blockquote>
|
|
</blockquote>
|
|
|
|
<table style="margin-left: auto; margin-right: auto;">
|
|
<tbody>
|
|
<tr>
|
|
<td rowspan="5"><strong>Select your preferred appearance for buttons, menus,
|
|
etc.</strong>
|
|
</td>
|
|
<td>Metal</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td>Windows Classic</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td>CDE/Motif</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td>Windows</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td>Nimbus</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td><strong>Select font size in points</strong>
|
|
</td>
|
|
<td>Select font size [12] points</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td>If you experience clicks not working, select</td>
|
|
<td><input name="checkbox2" id="checkbox2" type="checkbox"> Use non-standard release
|
|
event for mouse click?</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
<blockquote>
|
|
<blockquote>
|
|
<h4>Locale TAB</h4>
|
|
|
|
<p><img src="images/Preferences_local.png" alt="locale" height="300" width="657">
|
|
</p>
|
|
|
|
<p>Drop-down list to select your location and language</p>
|
|
|
|
<h4>Console TAB</h4>
|
|
|
|
<p><img src="images/Preferences_Console.png" alt="console" height="444" width="673">
|
|
</p>
|
|
|
|
<p>Display settings for the JMRI System Console.</p>
|
|
|
|
<p><strong><a href="#Top">Top</a></strong>
|
|
</p>
|
|
|
|
<h3 id="Messages">Messages Panes</h3>
|
|
|
|
<p>TABS and selections can be used to set how and when messages are displayed.</p>
|
|
|
|
<p><strong><a href="#Top">Top</a></strong>
|
|
</p>
|
|
|
|
<h3 id="Roster">Roster Panes</h3>
|
|
|
|
<h4>Programmer TAB</h4>
|
|
|
|
<p>Used to set the preferred decoder programmer.</p>
|
|
|
|
<p><img src="images/Preferences_Roster_Programmer.png" alt="roster" height="339" width=
|
|
"648">
|
|
</p>
|
|
|
|
<h4>Roster TAB</h4>
|
|
|
|
<p>You may set the default location of the locomotive roster and the default owners
|
|
name.</p>
|
|
|
|
<p><img src="images/Preferences_roster.png" alt="rosster" height="311" width="669">
|
|
</p>
|
|
|
|
<p><strong><a href="#Top">Top</a></strong>
|
|
</p>
|
|
|
|
<h3 id="Throttle">Throttle Pane</h3>
|
|
|
|
<p>Select throttle startup conditions, shown are defaults, but you may change the
|
|
settings.</p>
|
|
|
|
<p><img style="width: 677px; height: 450px;" src="images/Preferences_throttle.png" alt=
|
|
"throttle">
|
|
</p>
|
|
|
|
<p><strong><a href="#Top">Top</a></strong>
|
|
</p>
|
|
|
|
<h3 id="WiThrottle">WiThrottle Pane</h3>
|
|
|
|
<p>This pane allows WiThrottle users to customize the setup.</p>
|
|
|
|
<p><img src="images/Preferences_Wi.png" height="446" width="669" alt="preferences">
|
|
</p>
|
|
|
|
<p><strong><a href="#Top">Top</a></strong>
|
|
</p>
|
|
|
|
<h2 id="JSON">JSON Server Pane</h2>
|
|
|
|
<p>The JMRI <em>Json</em> Servlet provides web access to lists and values for numerous
|
|
JMRI-defined entities, in the modern <em>JSON</em> format.</p>
|
|
|
|
<p><img src="images/Preferences_JSON.png" alt="json pane" height="444" width="676">
|
|
</p>
|
|
|
|
<p><strong><a href="#Top">Top</a></strong>
|
|
</p>
|
|
|
|
<h2 id="MiniServer">Web Server Pane</h2>
|
|
|
|
<p>Use this pane to setup MinServer if you are using it.</p>
|
|
|
|
<p>Ajax is now in use for smoother image refresh and clicking. For older browser you may
|
|
want to unselect Ajax.</p>
|
|
|
|
<p><img src="images/Preferences_miniServer.png" alt="web server" height="446" width=
|
|
"680">
|
|
</p>
|
|
|
|
<p><strong><a href="#Top">Top</a></strong>
|
|
</p>
|
|
|
|
<h2 class="dp-center">Before you exit the preferences, Click on the <span class="textbutton">Save</span>
|
|
button to save all your selections.</h2>
|
|
|
|
<h2 class="dp-center">You must restart DecoderPro for preferences to take effect</h2>
|
|
|
|
<hr>
|
|
</blockquote>
|
|
</blockquote>
|
|
|
|
<div class="dp-right">
|
|
<blockquote>
|
|
<blockquote>
|
|
<p><a href="Start_DecoderPro.shtml">Previous</a>
|
|
</p>
|
|
|
|
<p><a href="index.shtml#Getting%20Started">Back to Index</a>
|
|
</p>
|
|
</blockquote>
|
|
</blockquote>
|
|
</div>
|
|
<!--#include virtual="/help/en/parts/Footer.shtml" -->
|
|
</div>
|
|
<!-- closes #mainContent-->
|
|
</div>
|
|
<!-- closes #mBody-->
|
|
<script src="/js/help.js"></script>
|
|
</body>
|
|
</html>
|