Run the UI on a TSW panel
A browser is all you need to use the demo. To run the same UI on a Crestron TSW touchpanel, load the Mobile Control touchpanel wrapper app onto the panel and point the panel at the processor. The wrapper is a small CH5 project. When the panel connects, Essentials sends it the UI's address, and the wrapper opens the demo UI full screen.
You'll need:
- the demo running (see Tutorial 1);
- a TSW-x60, x70 or x80 series panel on the same network as the processor or VC-4 server;
- the wrapper app: download the
.ch5z(about 320 KB). It's kept in this repo'sartifacts/ch5z/folder.
The wrapper only hosts the UI, so updating the demo or its UI doesn't mean reloading the panel. Load the wrapper again only when a new version of it is added to artifacts/ch5z/.
Step 1: Load the wrapper app onto the panel
On VC-4, first add the .ch5z to the demo's Program Library entry in the VC-4 web interface, as the program's touch panel project (see Tutorial 1, Step 1). Then load it onto the panel:
Copy the
.ch5zto the panel's/display/folder, using Crestron Toolbox's file manager or any SFTP client. Sign in with the panel's admin account.Open the panel's console (SSH, or Toolbox's Text Console) and run:
projectload
The panel restarts its project and shows the wrapper's waiting screen until a processor sends it a UI.
Step 2: Point the panel at the processor
The demo's config already has a panel for this, the Test TSW (tsw1070) at IP ID 04:
{
"name": "Test TSW",
"key": "tsw1070",
"type": "mctsw1070",
"properties": {
"control": { "ipid": "04", "method": "ipid" },
"defaultRoomKey": "room1",
"useDirectServer": true,
"theme": "midnight",
"buttonToolbarTimeoutInS": 30
}
}
In the panel's setup (its Settings screen, or Toolbox), set the control system connection:
| Setting | Value |
|---|---|
| Control system address | the processor's IP address or hostname |
| IP ID | 04 |
Once the panel is online, Essentials sends it the UI's address, with a token for room1, and the wrapper opens the demo UI. That takes a few seconds.
Use a different panel model
The device's type tells Essentials which panel model to expect, and the model has to match. For a model other than a TSW-1070, change type in the tsw1070 entry, then restart the program. For example, use mctsw770 for a TSW-770, or mctsw1080 for a TSW-1080. Essentials 3.0 supports:
mctsw550, mctsw560, mctsw570, mctsw750, mctsw760, mctsw770, mcts770, mctsw1050, mctsw1060, mctsw1070, mcts1070, mctsw1080, mcts1080 and mcdge1000.
For a second panel, copy the entry and give the copy its own key and ipid. See Tutorial 3 for editing the config.
If the UI doesn't appear
- The panel stays on the waiting screen. The panel isn't online with the program. Check its address and IP ID. On a 4-series processor, run
ipt -p:1in the console and look for IP ID04. If another program on the processor already uses IP ID04, give thetsw1070entry a differentipid, and set the panel to match. - The panel shows an error loading the page. The panel can't reach port 50002. On VC-4, check the server's firewall.