Skip to main content

Installing and commissioning the driver

This page takes you from an unlicensed driver to a working tile with a button that does something. It covers the setup wizard, the browser setup app, building your first control, and wiring it into Crestron Home programming.

Before you start
  • A licence key — a 30-day trial or a full key from store.lcd.network. An existing CHUIDYNAMIC key works.
  • The address of whatever your first button will call, if you want to test outbound HTTP during commissioning — for example a Shelly relay at http://192.168.1.50/relay/0?turn=on.

1. Add the driver

In the Crestron Home configurator, add a device to a room and search for UI Dynamic. Adding it opens the setup wizard, which has two steps: Licence → Setup.

A new driver, not an in-place upgrade

UI Dynamic on the entity model is a new driver. A site running the previous UI Dynamic driver must be commissioned again — the controls are rebuilt (or brought across with the converter), and any Crestron Home programming that referenced the old buttons must be rewired. The licence key carries over: the driver keeps the same product SKU.

2. Enter the licence key

On the Licence step, paste the licence key and press Next. Use Buy a licence to open store.lcd.network if you need a key or a trial first.

This step gates the wizard: without a valid key the driver will not continue, and an unlicensed driver shows its tile but does nothing when a button is pressed. If the key is rejected, check it is correct and that the processor can reach the internet — the driver contacts the licence server to verify it.

Existing keys do not lose a seat

The driver activates against the same identifier the previous CHUIDYNAMIC driver used, so re-licensing a site that already had UI Dynamic re-uses its existing activation rather than consuming a second one.

3. Open the setup app

The Setup step shows two links:

  • SET UP TILES — the UI Dynamic setup app, where you build the controls.
  • PRODUCT MICROAPP — the LCD product and licence page for this processor.

Open SET UP TILES. The app is served from the processor and opens in your browser. It has tabs for Elements, Tile, Webhooks, Activity and Backup & migrate.

Bookmark the setup app

The same app is reachable any time from this wizard step — you do not have to re-run commissioning to change a tile later.

4. Build your first control

On the Elements tab, press Add. A control appears in the list, numbered 1. Give it:

  • a Name — this names the control's Crestron Home programming events, so call it something you will recognise in a scene ("Gate", "Kitchen Fire");
  • a Control type — start with Button (a two-state control);
  • for each state, a Label and an Icon. Icons are chosen from a searchable list of the built-in Crestron glyph names — see the note on icons.

Press Save to processor. Within a few seconds the tile appears in the room with your control on it.

The seeded sample controls

A brand-new install seeds a few sample controls so there is something on the tile to look at. Delete them once you have built your own.

5. Make the button do something

To have a press fire an HTTP request, open the control, expand a state (or On every press), and add a request. Press Send test request to fire it from the browser and confirm it works before you leave site. This is covered in full in Buttons that call HTTP.

To have an outside system drive the control, use the Webhooks tab — see Webhooks in.

6. Wire it into Crestron Home programming

Every control publishes named events and the driver exposes actions, so a tile control can both drive and be driven by automation.

  • Events — in Crestron Home programming, this device's event list shows a named entry per control state and press, e.g. "Gate — Open", "Gate — pressed". Bind a scene or a notification to one.
  • Actions — the driver exposes SetElementState, SetElementDisplay, ToggleElement, PressElement and SetTileText, all taking the control's number. Use them to drive a control from a scene or a schedule.
Names, not slot numbers

The events are named after your controls and their states, so you bind to "Gate — Open" rather than a generic slot. Rename a control and its events are renamed with it the next time you save.