Owner's Manual (Complete)

Chapter 11 - Expressions
The Home Control Assistant
13
number = _on ("name")
Turns the named device or group on. Returns the current dim level before the On command is
sent.
number = _off ("name")
Turns the named device or group off. Returns the current dim level before the Off command
is sent.
number = _dimToLevel ("name", level)
Adjusts the illumination level of the named device to the supplied level. Returns the current
dim level before any commands are sent.
number = _dimToPercent ("name", percent)
Adjusts the illumination level of the named device to the supplied percent. Returns the
current dim level before any commands are sent.
string = _CurrentScene ("name")
If the named device or controller supports stored scenes, returns the name of the scene set at
the device. This function does not query the device so the result is based upon HCA internal
state.
string = _SetToScene ("name", "scene name")
Changes the current scene in a switch or controller to the scene named. The current scene in
the device before the new scene is established is returned.
string = _ComposeScene ("name", level)
Returns the name of the scene for the given Compose command (preset dim level) in the
named device or controller. This only applies to Lightolier CI and CP devices in Compose
mode.
Number = _GroupMemberCount ("group name")
Returns the number of members in a group. Used in conjunction with the
GroupMemberName function to get the name for each group member.
String = _GroupMemberName ("group name", number)
Returns the name of the Nth member of the named group. To get the first member name the
2
nd
parameter is a 1.