User`s guide

X10CONFIG(5) X10CONFIG(5)
TTY /dev/ttyS0
TTY /dev/cua2
TTY /dev/usb/ttyUSB0 (implies aUSB-Serial adapter)
To configure Heyu for a CM10A interface (instead of a CM11A or CM12), append the keyword "CM10A",
e.g.:
TTY /dev/ttyS0 CM10A
Note: If you´vestarted Heyu before configuring for the CM10A, you must stop and start it up again. I.e.,
´heyu stop´, then ´heyu start´.
TTY dummy directive
Setting the directive
TTY dummy
tells Heyu there is no CM11 powerline interface connected and Heyu commands which attempt to commu-
nicate with the interface will result in a quick error message. Howevercommands which involveonly the
heyu_engine and heyu_aux daemons will continue to function, e.g., setting and reading flags or countdown
timers, and executing scripts launched by RF signals forwarded from heyu_aux. (Likethe name of the
serial port it replaces, the word "dummy" is case sensitive.)
HOUSECODE directive
The housecode directive indicates the housecode for which the CM11A is to store in its internal registers
the on/off/dim status of individual units when signals are sent or receivedoverthe ACpower line. The
´heyu reset´ command (with no housecode parameter supplied) will program the CM11A to use the housec-
ode provided by this directive.(It will not do this automatically.)
Example:
HOUSECODE D
The default for this directive ishousecode A.
ALIAS directive
An alias associates a label (front_porch) with an X10 device (A10) so that we don´t have toremember that
the front porch light is house code A, device 10. In other words, we can use a mnemonic to represent a
device.
There are a fewother directivesinwhich the user may choose to reference an alias label in place of a
housecode|unitcode address. In these cases the alias directive must appear before the other directive inthe
configuration file in order to be resolved. Therefore it´s a good idea to group all the alias directivesator
near the beginning of the file.
Alias labels can refer to one or more X10 devices with the same housecode, howeverHeyu´s monitor will
display the alias label only if the alias references a single device address.
The format for an alias is:
ALIAS Label Housecode|Devices [Module_type [Module option]]
where the Housecode letter and Device string are concatenated.
Label can be anycontiguous string (maximum length 32 characters) of alphanumeric characters or period
´.´, hyphen ´-´, or underscore ´_´, except that the the hyphen and underscore may not be the first character
in the string. The label may not be the word ´macro´.
Alias labels are case sensitive,sothat ´kitchen´ and ´Kitchen´ represent twodistinct aliases.
local 2