User`s guide

X10CONFIG(5) X10CONFIG(5)
check this serial line before attempting to transmit a command so as to help avoid collisions on the power-
line. The default is YES. This check is normally bypassed for serial port hardware which does not support
the serial control lines, so setting this directive toNOshould only be required in exceptional situations.
One such situation occurs with USB-Serial adapters using an older Prolific chip under Linux, resulting in
the message "RI serial line may be stuck" after a long delay.Note that this check will be ineffective ifthe
CM11A RI line is disabled by the following directive.
RING_CTRL directive
Setting the value of this directive toDISABLE instructs Heyu to disable the CM11A Ring Indicator (RI)
line of the CM11A, which would otherwise be asserted each time an X10 signal is receivedoverthe power-
line. In addition, Heyu commands like´heyu ping´ and ´heyu wait´ which normally employthe CM11A
Ring_Enable command for their functionality will substitute the CM11A Ring_Disable command. This
directive isnot totally effective because the CM11A asserts the RI line when it is powered up, before Heyu
has a chance to disable it, e.g., in the event of a momentary interruption in ACpower.
The ONLYreason for disabling the RI line is that some computers have a "Start on Ring" feature and/or
"Awake from Sleep on Ring" feature which cannot easily be disabled in the computer´s BIOS and disabling
the CM11A RI line prevents undesired startup of the computer.Otherwise the default value of ENABLE
for this directive should not be overridden since the function to check the RI line before sending would then
be ineffective.
Forchanges in this directive tobecome effective when Heyu is already running, use ´heyu restart´ to incor-
porate the change in the heyu_relay and heyu_aux daemons.
SEND_RETRIES directive
Heyu by default attempts to send an X10 address or function command to the CM11A up to 3 times, which
is the default for this directive.Ifcollisions or noise on the power line result in _occasional_ "Unable to
send ..." messages, use this directive tobump up the number a little. Note: This directive will not help if the
failure to send a command is due to a communication problem with the serial port.
Example:
SEND_RETRIES 5
POWERFAIL_UPDATEdirective
When ACpower resumes after an interruption, the CM11A will poll the computer with a constant stream of
requests at one-second intervals for a time update and will accept no other command until the request is sat-
isfied. The Heyu relay daemon by default automatically responds and updates the CM11A clock. The
choices for this directive are either YES or NO, with the default being YES. Choosing NO for this direc-
tive instructs heyu_relay to respond with a truncated update which satisfies the CM11A but doesn´t actually
reset the clock. If Heyu is already running, use ´heyu restart´ for changes in this directive tobecome effec-
tive inthe heyu_relay daemon.
This directive allows the user to determine the accuracyofthe CM11A clock when operating solely on bat-
tery power.E.g., run ´heyu setclock´ to set the CM11A clock to the system clock, unplug the CM11A from
the wall socket for several hours or a day,plug it back in and run ´heyu readclock´ to compare the CM11A
and system clocks.
NEWFORMATflag (obsolete)
The word NEWFORMATformerly caused the output displayed in the Heyu monitor to appear in a slightly
different format. In Heyu version 2 the monitor output is very different and the older formats are no longer
supported. This directive will be ignored if it appears in the configuration file.
===============================================
local 13