Dynamic User interface Manual

  • Customisable UI Tile
  • Up to two, two state buttons
  • Customise Icons and State Text on Buttons
  • Customise and enable tile Icon (Update from multiple Buttons)
  • Extensive flexibility of usage through events and actions.
  • Show and Hide Buttons based on other button states.
  • Passthru Logic Functions for each button state.

Build your own UI with custom Buttons with feedback.

Like Quick Actions but so much more!

Usage

Currently we offer two different dynamic button drivers , a single button and a customisable user interface which offers up to ten buttons on a single user interface page, both also allow the use of the room tile aswell.

These two drivers allow for a multitude of uses to control and monitor the state of devices, functions and controls. The possibilities are really endless.

We have documented many examples in our library of use case examples here

Home View

From a user perspective the user interface provides a tile element on the room page and/or home page and a button or buttons in the main user interface page.

These buttons display an on or off state which can be changed by pressing the button (toggle) changed by pressing the room tile. Or changed using the Actions and Events System in Crestron Home.

In addition to the above which is all configurable in settings, the driver exposes a number of settings, actions and events making the simple button a hugely powerful control element.

Each State allows customisation of the text and icon , In addition the room tile icon and text can be set via actions allowing effecively many states including error states to be displayed.

The buttons can be used just as a status indicator with no user interaction via the user interface. Setting the state using Actions allows the state of a device or system to be displayed to the user.

The buttons state can also be used as a in simple logic allowing you only to allow or to action certain events in your system if the button is in a certain state.

Room View

Setup

Using the Setup pages of the driver you can hide and show buttons and setup the on and off text and icons for each of the buttons you require. NB: Dynamic Button single only has one button although you can hide it if you want!

The setup of the buttons is stored persistantly meaning once you setup a driver the settings will persist a reboot of the driver. The available settings are detailed in the table below and can be found in the setting page of the driver. Acces the setup pages as descibed here

Settings Page

The Settings page shows all current buttons.

Unique Index and Name

The Unique Index is shown for each button. This is used when setting up your actions and events. The name is just added for your reference.

The Current Text and Image are shown for each state.

Edit

The Edit Button (Sliders) allows you to change the Name and for each state the icon and text. In addition all of the per button settings can be found in the button edit page.

The Per Button Settings are detailed in the table in the related section further down this page.

Edit Button Page

The Icon select page is shown when you click to change a state Icon or the tile icon.

Simply click on the icon you wish to use and the Icon will update.

NB: Icons only update on the User facing button once a state change has occured.

Events and Actions

Setting NameDescription TypeNotes
NameName of button only used for your own reference.Text
Off State TextThe text displayed on the button when in the Off stateText
Off State IconThe Icon displayes on the button when in the Off stateIcon Selector
On State TextThe text displayed on the button when in the On stateText
On State IconThe Icon displayes on the button when in the On stateIcon Selector
Reboot Forces Button StateForce the Button state Off/On instead of using the memorized state (State at shutdown)Checkbox
Reboot Forces Button Off StateForce the Button state Off after a reboot CheckboxOnly visible if Reboot forces Button state
Reboot Forces Button On StateForce the Button state On after a rebootCheckboxOnly visible if Reboot forces Button state
Reboot Fires Button State EventFire the Button State Event after a rebootCheckbox
Button Is VisibleButton is shown on the User InterfaceCheckbox
Ignore Button PressesButton Presses on the user interface do not toggle the state of the button. Select if only using as a status button.Checkbox
Show User WarningShows warning on the user interface to warn user that button is ignored.CheckboxOnly visible if button ignored
Button State Changes Room TileAny state change of the button will cause the room tile to display the same icon and text of the button in the new state.Checkbox

Actions

ActionDescriptionParameterValueParameter 2Value
Passthru LogicTriggers the Button Passthru Off State event or Button Passthru On State event depending on the buttons stateButton1-10 *State to PassthruTest Both States
Triggers the Button Passthru Off State event only if the button is in an off stateButton1-10 *State to PassthruOnly Test Off State
Triggers the Button Passthru On State event only if the button is in an on stateButton1-10 *State to PassthruOnly Test On State
Set Button State and EventTriggers the Button State Set Off event and displays the button in an off state Button1-10 *State to setSet to Off State
Triggers the Button State Set On event and displays the button in an on state Button1-10 *State to setSet to On State
Toggles between the Button State Set Off event and Button State Set On event as well as update the button display stateButton1-10 *State to setToggle the State
Set Button StateChanges the button state to off without triggering the Button State Set Off eventButton1-10 *State to displayDisplay as Off State
Changes the button state to on without triggering the Button State Set On eventButton1-10 *State to displayDisplay as On State
Set Button VisibityShows the button on the user interfaceButton1-10 *Visibilty to setShow the button
Hides the button on the user interfaceButton1-10 *Visibilty to setHide the button
SetTileTextThis Event Sets the tile text from a list of available icons. This will be overidden by an icon from a button if enabled.TextText to Set
Set Tile IconThis Event Sets the tile icon from a list of available icons. This will be overidden by an icon from a button if enabled.IconList of Images

Events

EventDescriptionNotes
Button State was Set OffThis event fires whenever the button is set to the off state from the user interface or the Button Set To State action
Button State was Set OnThis event fires whenever the button is set to the on state from the user interface or the Button Set To State action
Button PressedThis event fires whenever the button is pressed on the user interface even if the Ignore Button Presses setting is enabledThis event always fires even is the Ignore Button Presses is setting is enabled
Button Passthru Off LogicThis event fires whenever the Button Passthru action is triggered and the button is in an off state
Button Passthru On LogicThis event fires whenever the Button Passthru action is triggered and the button is in an on state
Room Tile PressedThis event fires whenever the room tile is pressed on the user interfaceThis event always fires even is the Ignore Button Presses is setting is enabled
Driver LoadedThis event fires whenever the driver is loaded, like after a reboot or if the driver name is changed

UI Tile – Home Control – Crestron Shades

“Control Crestron Shades from the Home Page”

Interface Updates Dynamically based on your Crestron Home Setup.

Home Page Tile Actions

The home page navigates you straight to the user interface of the driver.

See if shades are closed on in the property at a glance using the Home Page tile.

NB: this driver does not show a room page tile.

Crestron Shade control

Main User Interface

  • Whole House
    • Recall All Open and All Close
  • Individual Areas (Dynamic)
    • Recall All Open and All Close for room
    • Hide/Show Shades in room
    • Navigate to Area Page for all area scenes (Pressing Sliders)
  • Shades
    • Name of Shade
    • Status / Position

Room Scenes / Whole House Scenes

  • Default Scenes
    • All On
    • All Off
  • User Scenes
    • Recall Custom Scenes

shade scenes

Driver Specific Settings

  • Licence
    • Launch Licence Settings
  • Hardware
    • Hardware page

Common Settings

Display On Home Page

Licence Settings

Hardware Settings

Technology

This driver leverages the Crestron Home Web API.

Before loading the driver make a note of your API Authentication Token.

We have a “how to” article and video here

Dynamic

Other than entering the token above there is no other configuration to do on the driver.

The UI shown is based on the current Crestron shades and shade Scenes.

Feedback is based on the scene state of the real shades and shade scenes.

Rooms are only shown if there is a shade element in the room.

Changes are made dynamically and there is no need to update or restart the driver following a change. e.g. adding a scene or a room with shades

UI Tile – Home Control – Crestron Lighting

“Control Crestron Lighting at a glance from the Home Page”

Interface Updates Dynamically based on your Crestron Home Setup.

Home Page Tile Actions

The home page navigates you straight to the user interface of the driver.

See if lights are turned on in the property at a glance using the Home Page tile.

Crestron Home Lighting Control Tile

Main User Interface

  • Whole House
    • Toggle Recall All On and All Off
    • Navigate to Area Page
  • Individual Areas (Dynamic)
    • Toggle Recall All On and All Off
    • Navigate to Area Page

Room Scenes

  • Default Scenes
    • All On
    • All Off
  • User Scenes
    • Recall Scenes

Driver Specific Settings

  • Auto Lock
    • Enable
    • Disable
    • Time (in seconds, min 10 – max 600)
  • Display on home page (tick box)
    • Enable
    • Disable
  • Licence
    • Launch Licence Settings

Common Settings

Display On Home Page

Licence Settings

Hardware Settings

Technology

This driver leverages the Crestron Home Web API.

Before loading the driver make a note of your API Authentication Token.

We have a “how to” article and video here

Dynamic Configuration

Other than entering the token above there is no other configuration to do on the driver.

The UI shown is based on the current Crestron Lighting Loads and Scenes.

Feedback is based on the scene state of the real lighting scenes.

Rooms are only shown if there is a lighting element in the room.

Changes are made dynamically and there is no need to update or restart the driver following a change. e.g. adding a scene or a room with lighting

UI Tiles Switching – User Manual

This is a generic datasheet showing the common functionality of our UI Tiles that provide a Switcher function. All of the control functions are common to the whole range of these UI Tiles. This datasheet uses the FireSwitch as an example of the functionality.

Room Page Tile

The room page tile is the main entry point to the driver. Pressing on the tile will toggle the fire state. The fire will turn off if currently on and and on if currently off.

If any timers are currently running then the fire cannot be turned on or the timer cancelled from the tile.

Instead use the top right of the tile to navigate to the main Driver user interface.

Home Page Tile Actions

The home page tile navigates you straight to the user interface of the driver.

Driver User Interface

  • Status
    • This shows the status as per the tiles
  • Controls
    • Fire On
    • Fire Off
  • Time Delay Off
    • Time Delay Off Buttons
    • Configurable in settings
    • Hide if not required
  • Driver Settings
    • Launch Settings (password protected)

Dependant upon which switch type driver tile is purchased the icon and the name of the item being switched is changed appropriately.

For example, if a SprinklerSwitch had been installed then a sprinkler icon would be shown and within the UI “Sprinkler” would appear instead of Fire.

Driver Specific Settings

  • Time Delay Button Configuration
    • Press to edit or hide a Button
    • Shows time options
    • (see below)

Common Settings

Display on home page (tick box)

  • Enable
  • Disable

Licence Settings

Hardware Settings

Time Selection Page

Time Delay Options are available in 5 min increments from 5 to 120 Mins.

Clear Delay Disables this buttons action and hides it from the driver main page.

Select currency
GBP Pound sterling