Crescendo Docs

Room

The Room model controls and maintains state for a logical location.

Summary

Room models maintain power and source state and provide full control of associated audio and video switchers. A room usually corresponds with a physical location, but it can be used for any set of switchers requiring independent control.

For example, a sports bar with a dozen televisions would use one room module per television so that each can be controlled without affecting the others.

Tutorial

Configure the Name and ID parameters. The room name can be anything. The room ID should use a two-digit, zero-padded number between 1 and 99 (01 or 99).

Configure the Audio Switchers and Video Switchers parameters as one or more escaped ASCII IDs between 01 and 99 (\x01, \x99, or \x01\x99). If there are no switchers, use two double quotes ("").

Room has internal logic for an audio zone and a video zone. The audio zone controls audio switchers and the video zone controls video switchers. When a room is set to a source, the source ID is passed to both zones, and all switchers will change to the input for that source (if they are configured to do so). Volume control is delegated based on the source type and zone features.

If the source is …
… a video source

and at least one video switcher offers adjustable volume control,

then volume control will be delegated to the video zone.

… a video source

and no video switcher offers adjustable volume control,

then volume control is delegated to the audio zone.

… an audio source

then volume control is delegated to the audio zone.

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.

Notes

  • Interfaces controlling the same room will sync with the room source.

Inputs and Outputs

InputOutput
Source_ID~StringAnalogSource_ID_Fb
Power_On/OffPulse 
Power_OnPulseStatePower_On_Fb
Power_OffPulseStatePower_Off_Fb
Volume~StringAnalogVolume_Fb
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.
Audio SwitchersOne or more escaped hexadecimal IDs
Must be one or more escaped hexadecimal IDs or an empty string.
Video SwitchersOne 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.