1
2BACKWARD COMPATIBILITY ISSUES FOR HEYU VERSION 2
3
4Configuration file
5------------------
6Heyu version 2 can use an existing Heyu configuration file
7from version 1 (~/.x10config or /etc/x10.conf) provided
8it is renamed and moved to the new location where Heyu
9version 2 expects to find it - either "~/.heyu/x10config"
10or "/etc/heyu/x10.conf" (notice the 'dot' changes).
11There are a number of new configuration options for
12version 2 that the user may then want to add, which are
13explained in both the x10config.5 man page and in the
14example file "x10config.sample" provided.  Of course
15for some users it may be more convenient to simply rename
16and modify the "x10config.sample" file.
17
18In operation, Heyu version 2 must write some files in
19the same directory as the configuration file, so this
20directory must be writeable.
21
22Schedule file
23-------------
24In most cases an existing schedule file used for Heyu
25version 1 will work in version 2, however dawn/dusk
26related events are now handled directly by the Heyu
27program and the old 'makesched' utility is no longer
28used.  The default name for the schedule file is now
29x10.sched and Heyu version 2 will expect to find it
30in the same directory as the configuration file.
31(Its name can be changed via the configuration file.)
32
33Under Heyu version 2, the CM11A clock is maintained
34on Local Standard Time throughout the year.  Events
35in the schedule file are assumed to be Local Civil
36Time (i.e., Wall Clock Time) and Heyu automatically
37adjusts them during periods of Daylight Saving Time.
38Heyu version 2 automatically sets the CM11A clock
39to the correct time (derived from the system clock)
40when a schedule is uploaded or when the 'heyu setclock'
41command is executed.
42
43
44Warning
45-------
46Users running a dual-boot system with MS-Windows
47should read the warning in the x10config.5 man page
48about running X10's ActiveHome software while booted
49into Windows if the CM11A has been programmed under
50Unix/Linux by Heyu with certain configuration options.
51
52
53
54