What it does...
With the xAP connector for the CM12U in place, you can extend X-10 control to any xAP enabled application on your network. For message schema, see the doc subdirectory - you can send these sample messages using xap-send (see Test harness).
Configuration
Command Line Options
xap-barcode [serial port] [instance name] [network interface] [udp port] [debug level]
where:
serial port is the serial port the CM12U is attached to. Under linux this has the form /dev/ttyS0. Under Windows, the serial port may also be specified using conventional DOS notation such as com1. If unspecified, defaults to the first serial port.
instance name is the xAP instance name assigned to this CM12U. Typically this might identify the locations served by this CM12U where multiple units are in use. The default instance name is Home.
network interface is the network interface used for outgoing xAP messages. On a Linux and Windows PC host these are named eth0, eth1. Under OSX they are named ne0 etc. By default, eth0 is used. On a Windows PC which has multiple adapters installed, even if they are not active, eth0 may not represent the active interface - some experimentation may be required!
udp port is the UDP port xAP broadcasts on. By default xAP uses its officially allocated port, 3639. Using an alternative port can be useful during isolated testing, however. Be aware that the use of ports below 1024 will fail unless the application is run by a user with administrative privileges. The use of ports below 1024 therefore has security implications and is not recommend.
debug level determines the verbosity of the output written to stdout. Verbose output can be useful for debugging unexpected behaviour. By default, the debug level is 0. Increasing levels of detail may be specified, up to a maximum of 4.
Footnotes
- The xAP control can be used to bridge multi-phase installations, since it is possible to configure multiple CM-12 units to act as a single entity under xAP, all acting on a given instruction, and relaying X-10 events as if they originated from a single source.
Download
CM12U connector (X-10) source (requires xAP-lib)
CM12U connector (X-10) windows executable (requires cygwin dll)
Schema
X-10 schema
|
