HomeSeer A2Z-Link User Manual page 9

6 . ASCII Control Interface
Devices are controllable by setting their value or label. Each device holds a collection of name/value pairs that represent the available control points.
Control points can be a single value, such as 0 for Off, or a value range such as 1‐98 for a dim level. In the web interface on the device management
page you can click on the name of a device to bring up its properties. Click on the "Status/Graphics" tab to see the available pairs. From here you can
determine how to control the device. You can also issue a command to get the pairs if your control system can deal with that.
Commands are available to retrieve the control information if your control system can support this.
Here is an example of the status pairs for a dimmable light. It can be seen that the possible control values are 0 for Off, 99 for On, 255 for on last
level, and 1‐98 for the dim level.
Commands are issued as simple text strings terminated with a carriage return and linefeed.
Commands are not case sensitive.
Parameters in [] are optional.
The following commands are available for device control:
Command Format
Control a
device by cv,ref,value
value
Control a
device by cl,ref,label
label
Retrieving control information
For advanced systems that can dynamically create a user interface, the control information can be obtained. A request may contain a single device
reference #, of, if omitted, control information for all devices is returned.
A2Z­Link
Description
Controls a device by settings its value. All devices have a
collection of name/value pairs that represent controllable parts
of the device, such as On=99 and Off=0. The value is used for
control.
Controls a device using the control label. All devices have a
collection of name/value pairs that represent controllable parts
of the device, such as On=99, and Off=0. The actual label is
used for control.
Example
Turn on a light
where the reference
# is 2356 and the
ON value is 99:
cv,2356,99
Turn on a light
where the reference
# is 2356 and the
ON label is On:
cl,2356,On