Skip to content

Configuring CrestronMobile v3

fpillet edited this page Jun 4, 2012 · 2 revisions

CrestronMobile v3 has two operating modes:

  • a compatibility mode where it works the same way CrestronMobile v1 did
  • a configured mode where you can provide one or more configuration objects that tell CrestronMobile how to operate.

Compatibility mode

The first mode is simple: at startup, it looks for an external TCP system named "CrestronMobile". If found, a new CrestronMobile object is instantiated. This object is configured to talk to a Crestron processor via your GUI's CrestronMobile external system.

The password to connect to the Crestron processor should be stored in a global (Project) token named cmPassword. If this token is missing, the default password (1234) will be used.

Configured mode

This is the new operating mode for CrestronMobile v3. When using the configured mode, you can connect simultaneously to several Crestron processors, and make a very precise configuration for each system.

Providing the configuration information

On startup, CrestronMobile will go through every external system defined in your GUI. For each TCP system it finds, it will look if a global JavaScript variable named CrestronMobileConfig_{system name} is defined.

If this variable is defined and is an object, then a new CrestronMobile object (one object connects to one Crestron processor) is created. The process goes on for every TCP system found in your GUI.

So for example, if you have three Crestron processors and name the external systems in your GUI: Crestron1, Crestron2 and Crestron3, you can create three configuration objects (see below) named CrestronMobileConfig_Crestron1, CrestronMobileConfig_Crestron2 and CrestronMobileConfig_Crestron3 to have the CrestronMobile module automatically create connections to the threee processors at startup.

Configuration details

Clone this wiki locally