[ General ] [
Setting up the macro ] [ Writing the config file ]
ACEUpdater.pl is a Perl
script that reads an .xml configuration file and sends commands to ACE
based on update messages received from HV. Its original purpose was to
update ACE clients with security information from HV, but it now supports
other Auto Report messages from HV. [Specifically, one other: X-10.] I use
it to power my live floor plan in ACE.
Whenever your macro runs and the security status message is sent, or an
auto report message is sent from HV, ACEUpdater will send the appropriate commands to ACE. Note that the script
keeps track of the last status and only sends commands for objects that have changed. You can
override this and force ACEUpdater to send the the
appropriate commands for all objects if you issue the command
AU:Update. You can do this by either sending the text over HV's
serial port, or directly in ACE with the command
For the later to work you need to check the "Enable custom API command
support using an ActiveX EXE" option in ACE [it's in ACE Server under Setup
| Preferences | Scripts/Plugins]. You can also use the command
cause the script to quit.
How to use:
If you want to use ACEUpdater with a security system, once you have your system up and running
create the macro to generate the the
security status update messages.
Figure out what commands you want to send to ACE, write the config file,
and put it in the same directory as the script.
Start the script. The command line syntax is:
ACEUpdater.exe [/config=configfile.xml] [/log] [/debug]
[/configonly] [/verbose [/verbose]]
All arguments are optional.
|This option specifies the config file to use. If this
option is not specified the script will look for aceUpdater.xml in
the same directory as the script was started from.
|If supplied on the command line will cause a log file
-- AULog.txt -- to be created. What gets written to the log can be
controlled with the /verbose switch.
|Will create a debug file -- AUDebug.txt -- that
contains the structure of the XML config file in Perl code.
|Will stop execution of the script after the config
file has been read, parsed, and the configuration preamble displayed
to the user. This is useful as a quick check to verify your config
file is being parsed correctly.
|Controls the verboseness of the script. Can be
supplied multiple times to increase the verbosity level. Currently,
three levels are supported:
||Default level [no arguments]. only messages received from ACE that
could cause a command to be executed will be written
to the screen and log file.
||All messages will be written to the log file.
||All messages will be written to the screen and log.