User`s guide

X10CONFIG(5) X10CONFIG(5)

LAUNCHER_SCANMODE directive

See section "SCAN MODE" in man page x10scripts(5) for details.

SCRIPT_SHELL directive

Deﬁnes the shell used when a script is executed. (Provide the full pathname.) The default is to use the shell

deﬁned by the SHELL variable in the user´s environment, or /bin/sh if no such variable exist.

LAUNCHPATH_PREFIX directive

LAUNCHPATH_APPEND directive

Preﬁx and/or append an additional directory or directories to the existing $PATHinthe environment pro-

vided for Heyu scripts. (This works only for shells where the path separator is a semicolon.)

Example:

LAUNCHPATH_APPEND /etc/heyu/scripts

LAUNCH_SOURCE directive

Sets the default source or sources of the X10 signal allowed to launch a script as part of the <launch condi-

tions>. One or more of the following may be speciﬁed. The default is RCVI.

SNDC Sent from the Heyu command line.

SNDM Sent upon execution of an uploaded macro by a Timer.

SNDT Sent upon execution of an uploaded macro by a Trigger

SNDP Sent by Heyu from a power-fail script.

RCVI Receivedoverthe power line via the CM11A interface.

RCVT A Trigger which initiates execution of an uploaded macro.

SNDASent overthe power line by the heyu_aux daemon.

RCVAVirtual data receivedfrom the heyu_aux daemon.

ANYSRC All of the above.

NOSRC None of the above (sources must be speciﬁed in the <launch conditions>).

Example:

LAUNCH_SOURCE rcvi sndc

ISDARK_OFFSET directive

Deﬁnes the offset in minutes from Dusk and Dawn to use for the script environment logical variable

´X10_isDarkTime´. Its default value of 30 minutes means that ´X10_isDarkTime´ will be TRUE from 30

minutes after Dusk until 30 minutes before Dawn. This directive also determines the interval during which

the launch condition ﬂag ´dark´ is TRUE.

ENV_ALIAS_PREFIX directive

Determines whether the preﬁx of ALIAS environmental variables provided for scripts is upper or lower

case, i.e., ´X10_´ or ´x10_´. The choices are LC or UC, with the default being LC for lower case.

This directive enables compatibility with scripts written for earlier releases of Heyu (which used the upper-

case preﬁx), howeverits use is discouraged - please modify your scripts to use the lower-case ´x10_´as

soon as practicable.

Note that this preﬁx applies _only_ to ALIAS environment variables - all other Heyu environment variables

use the upper-case preﬁx. E.g, if the conﬁguration ﬁle deﬁnes:

ALIAS porch_light A6

then the environment variables provided will be:

x10_porch_light=nnnn

X10_A6=nnnn

local 16