Crescendo Docs

Touchscreen

The Touchscreen interface module controls and maintains the logical state for a touchscreen device such as a Crestron touchpanel or Apple iPad/iPhone.

Summary

Exactly one Touchscreen module is associated with exactly one Crestron App instance. This module manages the current users selections such as room and source. Many of the signals on the Touchscreen module are directly linked to smart graphics button presses. This is done dynamically through the ID-switching and cross-point routing systems built into the Crescendo framework so that subpage reference lists (such as watch or listen lists) populate dynamically based on current user selections.

The Touchscreen interface module acts almost like an EIC between the Crestron App instance and the program, receiving user button presses as input and outputting the button press feedback.

It is through Touchscreen interface module that the crescendo program framework receives instruction to make and break crosspoint connections and drive dynamic lists, all as a result of user interface button presses.

Tutorial

Parameters

Configure the Name and ID parameters. The Touchscreen name can be anything. The Touchscreen ID should use a two-digit, zero-padded number between 1 and 99 (01 or 99). Default Room accepts the same type of parameter as does ID and the two-digit, zero-padded number between 1 and 99 that it receives should be the ID given to the Room model in which the physical iPad/iPhone/Crestron touchpanel associated to this logical Touchscreen interface model will most often reside or to which it will be assigned.

App URL 1 through 5 parameters denote the apps to be launched in the case that this Touchscreen interface module instance is associated to a physical iPad. Example formatting for App URL 1 and 2, respectively: music:// (move cursor down to next parameter) sonos://

Inputs and Outputs

Complete documentation on interface signal joins can be found in the Join Standard.

Notes

Through the "[App_URL$]" and "[Open_App]" signal slots, the Touchscreen module handles the program's awareness that the Crestron app has been launched. This interface module also handles configurations information for having the iPad open other apps (such as the app for a third party security or climate control system) through the signals "[Open_App_01]" through "[Open_App_05]," so up to 5 apps can be linked for launching (and when launched a button in the top left will allow the user to effortlessly navigate back to the Crestron app).

Inputs and Outputs

InputOutput
Self 
Route~StringPulseInitialized!~
Set_Default_RoomState 
 AnalogDefault_Lights
 AnalogDefault_Shades
 AnalogDefault_Climate
Address_1_ConnectedState 
Address_2_ConnectedState 
Open_App_1StateStringApp_URL$
Open_App_2StatePulseOpen_App
Open_App_3State 
Open_App_4State 
Open_App_5State 
Enable_ShareState 
Digitals 
 StateRoom_Has_Video
 StateRoom_Has_Audio
Power_On/OffState 
Power_OnStateStatePower_On_Fb
Power_OffStateStatePower_Off_Fb
Power_Subpage_ShowStateStatePower_Subpage_Showing
Power_Subpage_HideState 
Sleep_CancelState 
Sleep_In_30_SetStateStateSleep_In_30_Active
Sleep_In_60_SetStateStateSleep_In_60_Active
Sleep_In_90_SetStateStateSleep_In_90_Active
Sleep_In_120_SetStateStateSleep_In_120_Active
 StateVolume_Subpage_Showing
Volume_UpPulse 
Volume_DownPulse 
Volume_SlidePulse 
MuteStateStateMute_Fb
Mute_OnStateStateVolume_Control_Is_Absolute
Mute_OffStateStateVolume_Control_Is_Relative
 StateVolume_Control_Is_Area
Source_Digital_001 … Source_Digital_198StateStateSource_Digital_001_Is … Source_Digital_198_Is
Source_Cursor_UpPulse 
Source_Cursor_DownPulse 
Source_Cursor_LeftPulse 
Source_Cursor_RightPulse 
Source_Cursor_SelectPulse '
Source_GuidePulse 
Source_InfoPulse 
Source_MenuPulse 
Source_ExitPulse 
Source_PlayStateStateSource_Playing
Source_StopStateStateSource_Stopped
Source_PauseStateStateSource_Paused
Source_Scan_ForwardStateStateSource_Scanning_Forward
Source_Scan_BackStateStateSource_Scanning_Back
Source_Skip_ForwardPulse 
Source_Skip_BackPulse 
Source_RecordPulse 
Source_Page_UpPulse 
Source_Page_DownPulse 
Source_Number_0Pulse 
Source_Number_1Pulse 
Source_Number_2Pulse 
Source_Number_3Pulse 
Source_Number_4Pulse 
Source_Number_5Pulse 
Source_Number_6Pulse 
Source_Number_7Pulse 
Source_Number_8Pulse 
Source_Number_9Pulse 
Source_Number_EnterPulse 
Source_Number_ClearPulse 
Source_Channel_UpPulse 
Source_Channel_DownPulse 
Source_Channel_RecallPulse 
Source_BackPulse 
Source_RedPulse 
Source_GreenPulse 
Source_YellowPulse 
Source_BluePulse 
Source_ListPulse 
Source_LivePulse 
Source_FormatPulse 
Device_Digital_001 … Device_Digital_198StateStateDevice_Digital_001_Is … Device_Digital_198_Is
Control_SourcePulse 
Change_SourcePulse 
Page_HomeStateStatePage_Home_Showing
 StatePage_Source_Showing
 StatePage_Device_Showing
Hide MenusPulse 
Room_Menu_ShowStateStateRoom_Menu_Showing
Listen_Menu_ShowStateStateListen_Menu_Showing
Watch_Menu_ShowStateStateWatch_Menu_Showing
Sharing_Menu_ShowStateStateSharing_Menu_Showing
Lighting_Controls_ShowStateStateLighting_Controls_Showing
Shade_Controls_ShowStateStateShade_Controls_Showing
Climate_Controls_ShowStateStateClimate_Controls_Showing
 StateSource_Controls_20_Showing … Source_Controls_48_Showing
 StateDevice_Controls_51_Showing … Device_Controls_68_Showing
Source_Extra_71_Show … Source_Extra_84_ShowStateStateSource_Extra_71_Showing … Source_Extra_84_Showing
Device_Extra_86_Show … Device_Extra_98_ShowStateStateDevice_Extra_86_Showing … Device_Extra_98_Showing
Analogs 
 AnalogRoom_Route
 AnalogSource_Icon
 AnalogRoom_Icon
 AnalogSource_Route
 AnalogLighting_Route
 AnalogShades_Route
 AnalogClimate_Route
VolumeAnalogAnalogVolume_Fb
 AnalogMute_Mode
Source_Analog_001 … Source_Analog_010AnalogAnalogSource_Analog_001_Is … Source_Analog_010_Is
 AnalogSource_Analog_011_Is … Source_Analog_198_Is
Device_Analog_001 … Device_Analog_010AnalogAnalogDevice_Analog_001_Is … Device_Analog_010_Is
 AnalogDevice_Analog_011_Is … Device_Analog_098_Is
Serials 
 StringRoom_Name$
 StringSource_Name$
 StringDevice_Name$
 StringSleep_Message
 StringVolume$
 StringSource_Serial_001_Is … Source_Serial_198_Is
 StringDevice_Serial_001_Is … Device_Serial_098_Is

Parameters

NameDescriptionValidate
NameAnything
Must not be blank.
IDTwo-digit hexadecimal ID
Must be a two-digit hexadecimal number.
Default RoomTwo-digit hexadecimal ID
Must be a two-digit hexadecimal number.
App URL 1 … App URL 5Use Tutorial section examples above
"Chris is a busy guy, give him a break"