Status - HomeSeer A2Z-Link User Manual

Command Format
Get control
gc,[ref]
information
See also

Status

Home > ASCII Control Interface > Status
Status
Please read the Control section first for information on how to connect to the A2Z‐Link and how to format commands.
For more advanced control systems and control systems drivers, you may want to dynamically retrieve the available devices in the system and get their
current status. The following commands can be used to discover all devices, get their current status, and assigned name and location. The A2Z‐Link
allows for 2 location parameters to be set on each device, as well as a device name. This information can be maintained in the A2Z‐Link itself, or left
off and maintained by the controller.
Command Format
Description
Returns control information for a given device, all all
devices if the reference # is omitted. The return
format is:
ref,label=value,label=value,...
If the device supports a control point that accepts a
range of values, such as dimming light, the control
pair will be returned as:
PREFIX (value)SUFFIX=FROM->TO
The PREFIX is a label that appears before the value
and the SUFFIX is a label that appears after the
value. The PREFIX and SUFFIX are listed on the
"Status/Graphics" tab in the device properties and
can be changed if needed.
N o t e: If a label contains a "," it will be escaped and
returned as "\,".
Description
ASCII Control Interface . 7
Example
For example, a dimming device
with ref 3755 may have its PREFIX
set to "Dim" and its SUFFIX set to
"%", and the valid values are 1-98,
the return would be:
3755,On=99,Off=0,Dim
(value)%=1->98
Example
A2Z­Link