Files
2026-06-17 14:00:51 +02:00

141 lines
5.6 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 - Power Line - System Names</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: Powerline - System Names</h1>
Individual inputs (Sensors) and outputs (Turnouts and Lights) in JMRI are accessed via System
Names.<br>
For information on the general scheme, please see <a href=
"../../doc/Technical/Names.shtml">JMRI Naming</a> in the <a href=
"../../doc/Technical/index.shtml">Technical documentation</a>.
<h2 id="hardware">Supported Hardware</h2>
<h3>X10</h3>
X10 devices are addressed via a "House Code" of A through P, and a "Device Code" of 1 through
16.
<p>Outputs (Lights or Turnouts) in each House Code are numbered with their Device Code,
e.g.</p>
<ul>
<li>PTA1 is a JMRI Turnout that talks to device 1 on housecode A</li>
<li>PTB3 is a JMRA Turnout for device 3 on housecode B</li>
<li>PLP16 is a JMRI Light for device 16 on housecode P</li>
</ul>
<p>If an output is called as a Turnout (name starts with PT-), you only get On and Off as
output options.</p>
<p>An output that is used as a Light (name starts with PL-) will take variable intensities.
However, some physical X10 devices may not support dimming.</p>
<p>Inputs (Sensors) are identified by the house code and device number that was reported by
some other X10 device like a motion sensor or light control pad.<br>
NOTE: Due to a large number of false codes experienced by X10 users, Sensors are not
automatically generated. They must be manually entered in the Sensor Table by the user.</p>
<p>JMRI configures the adapter to use House Code "A" now. We'll eventually make that
configurable, but for now that means that input messages will only be received from devices
set to House Code A, so only sensors "PSA1" through "PSA16" will work.<br>
(Early versions of JMRI X10 support used an all-numeric address like PT12, with no House Code
letters; this is no longer available, because it caused way too much confusion)</p>
<h3>Insteon</h3>
<p>
Insteon Adapters are labeled with a three-part number that looks like "01.2A.B4". These are
just random strings as far as the user and the program is concerned, and we don't make any
effort to subdivide them. You should enter these exactly as they appear on the device you
want to address. Do not delete or add leading zeros, etc.
<p>For example, if the device is labeled "01.2A.B4", the corresponding JMRI Light System
Name is "PL01.2A.B4".</p>
<h3 id="documentation">Adding an item to the table</h3>
<p>When you add an item to one of the tables, many times you only have to fill in the numbers
to have JMRI construct the complete system name.<br>
Here's a summary, split up for outputs (eg. Turnouts) and inputs (eg. Sensors):</p>
<table>
<tbody>
<tr>
<th>In/Out</th>
<th>Entry</th>
<th>Meaning</th>
<th>makes System Name</th>
<th>Mask</th>
<th>Minimum</th>
<th>Maximum</th>
</tr>
<tr>
<td>i/o</td>
<td>A3</td>
<td>House code A + num device code</td>
<td>PTA3</td>
<td>caps letter + num</td>
<td>house code: A; device: 1</td>
<td>house code: P; device: 16</td>
</tr>
<tr>
<td>i/o</td>
<td>01.2A.B4</td>
<td>Light (module) PL01.2A.B4</td>
<td>PL01.2A.B4</td>
<td>3 x 2 chars</td>
<td>not documented</td>
<td>
</td>
</tr>
</tbody>
</table>
<!-- this table is an excerpt from the table in the help/en/html/doc/Technical/Names.shtml
based on information from the Hardware help pages
by Egbert Broerse @silverailscolo July 2017 -->
<h3>DMX512</h3>
<p>
The DMX universe uses a array of 512 bytes for all the devices on that connection.
Each device has an intensity of 0 to 255. In JMRI, this is expressed as a value of 0.0 to 1.0.
</p>
<p>
Only lights are supported from JMRI. Each lamp may have a ramp rate to control the rate of change.
This works from the fast clock. If the clock is not running, the effects are immediate.
</p>
<p>
The USB interface device must support a serial port for connecting to the USB device.
Most of these are FTDI driver devices. The Anyma DMX device uses a USB device driver that
is not currently supported on Windows. That device will work for Linux and Mac systems.
<h2>Documentation</h2>
<h3>Third Party info</h3>
<p>More information on the X10 hardware can be found on the (admittedly obnoxious) <a href=
"https://www.x10.com/">X10.com website</a>.</p>
<p>More information on Insteon hardware can be found on the <a href=
"https://www.insteon.com/">insteon.com website</a>.</p>
<h3>JMRI Help</h3>
<p>Back to the <a href="index.shtml">Powerline Help page</a>.</p>
<!--#include virtual="/help/en/parts/Footer.shtml" -->
</div>
</div>
<!-- close #mBody -->
<script src="/js/help.js"></script>
</body>
</html>