User`s guide

X10CONFIG(5) X10CONFIG(5)
relative timers are programmed.
The choices are YES or NO, with the default being YES.
The downside to using this feature is that the Heyu-assigned name of the concatenated macro will not be
easily recognizable when displayed in Heyu´s monitor.
COMPRESS_MACROS directive
This directive instructs Heyu to merge unit codes for macro elements which have the same command,
housecode, and "data" (e.g. dim level), and also eliminate duplicate elements. It can save a few bytes of
EEPROM space, when macros with similar elements are concatenated.
The choices are YES or NO, with the default being NO.
Example:
macro mac1 0 on A1; on B1; on A2; on B3
becomes:
macro mac1 0 on A1,2; on B1,3
Warning: If you program a macro like:
macro mac1 0 on A1; offA1; on A1; offA1; on A1; offA1; ...
and expect to have a lamp on A1 repeatedly blinking on and off, better set this directive toNO, else the
macro will be compressed to a single on and off. (Heyu maintains the ordering in macros to the extent pos-
sible.)
DAWNDUSK_DEF directive
By default Heyu defines Dawn and Dusk to be Sunrise and Sunset. This directive allows globally defining
them instead as the morning and evening times of several standard twilights, as follows:
RISESET (or simply ´R´) - Sunrise and Sunset (default)
CIVIL (or simply ´C´) - Civil Twilight
NAUTICAL (or simply ´N´) - Nautical Twilight
ASTRONOMICAL (or simply ´A´) - Astronomical Twilight
Example:
DAWNDUSK_DEF CIVIL
DAWNDUSK_DEF N
DAWN_OPTION directive
DUSK_OPTION directive
These directivesinstruct Heyu howtoassign the time for Dawn or Dusk in each timer subinterval. The
options for this directive are:
FIRST - Use the Dawn/Dusk time for the first day in the subinterval.
EARLIEST - Use the earliest of the times for anyday in the subinterval.
LATEST - Use the latest of the times for anyday in the subinterval.
AV ERAGE - Use the arithmetic average of the times in the subinterval.
MEDIAN - Use a time halfway between the earliest and latest times.
The default is FIRST,which is the most convenient for comparing Heyu´s computations with Dawn/Dusk
times published in newspapers or by the US NavalObservatory.(Remember that Heyu´s times are Stan-
dard Time, while newspapers generally publish Civil [wall clock] times.)
MIN_DAW Ndirective
MAX_DAW Ndirective
MIN_DUSK directive
local 19