Crescendo Docs

Area

The Area model controls and maintains state for two or more Room models.

Summary

Area models maintain power state and provide one-way control of associated rooms. An area usually corresponds with a physically related rooms, but it can be used any time simultaneous control of two or more rooms is desired.

For example, a kitchen, breakfast nook, and family room are open to one another, forming a "great room" area. These rooms can be controlled independently with the room models or together with the area model.

Tutorial

Configure the Name and ID parameters. The area name can be anything. The room ID should use a two-digit, zero-padded hexadecimal number between A1 and A9 (A1 or A9). This keeps the area ID from conflicting with roomIDs and keeps the area out of the rooms list in Rooms-Sources Controller. Advanced programmers may choose to ignore this general rule.

Configure the Rooms parameter as one or more escaped ASCII IDs between 01 and 99 (\x01, \x99, or \x01\x99). If there are no rooms, there is no need to have this model in the program.

Configure the Lights, Shades, and Climate parameters using two-digit, zero-padded numbers between 1 and 99 (01 or 99). If the parameter is not used, use 0 instead (00).

Configure the Default Source parameter use a two-digit, zero-padded number between 1 and 99 (01 or 99). This is the source that will be set on the rising edge of the Power_On/Off and Power_On inputs.

Inputs and Outputs

InputOutput
Source_ID~String 
Power_On/OffPulse 
Power_OnPulseStatePower_On_Fb
Power_OffPulseStatePower_Off_Fb
VolumeString 
Volume_UpState 
Volume_DownState 
MutePulse 
Mute_OnPulseStateMute Fb
Mute_OffPulse 

Parameters

NameDescriptionValidate
NameAnything
Must not be blank.
IDTwo-digital hexadecimal ID
Must be a two-digital hexadecimal number.
RoomsOne or more escaped hexadecimal IDs
Must be one or more escaped hexadecimal IDs or an empty string.
LightsTwo-digital hexadecimal ID
Must be a two-digital hexadecimal number.
ShadesTwo-digital hexadecimal ID
Must be a two-digital hexadecimal number.
ClimateTwo-digital hexadecimal ID
Must be a two-digital hexadecimal number.
Default SourceTwo-digital hexadecimal ID
Must be a two-digital hexadecimal number.