JMRI: xAP Support

xAP is a home-automation protocol popular used by do-it-yourself hobbyists through large professional installations.

For more information on the protocol and available equipment, please see the xAP home page.

xAP should not be confused with the Lenz XPA, which is a device for using a portable phone as a throttle for a Lenz DCC system.

JMRI's support for xAP started with a simple script available in JMRI 2.9.5 and later releases. Eventually, a full set of JMRI xAP tools will be available directly within the JMRI tool set.

xAP devices that provide either the "input" or "output" form of the Basic Status and Control Schema (BSC devices). "Input" devices are mapped to JMRI Sensor objects, and "Output" devices are mapped to JMRI Turnouts.

When JMRI sees a new BSC device, it creates the necessary Sensor or Turnout. The full source name is used to create the system name, for example:

 IS:xPA:xAPBSC:mi4.homeseer.scafell.91:VIOMBoard.Input14GJDRFXEnable

The xPA-defined user defined name fills in the JMRI user name, for example:

 Input 14 GJD RFX Enable

You can later change the JMRI user name to anything you'd like via the usual tables if desired.