3.29State Action

The State Action shows the current state of a value. You define a list of states, each with a threshold. The object shows the picture or text of the state whose threshold the live value has reached. It can also run an action when tapped, such as jumping to a page or writing a value to KNX.

#When to use it

• A status icon that changes with a KNX value: door open or closed, alarm armed or not, a gauge image per power band.
• A text display that shows a word per value range, for example Closed, Half open, Open.
• A live text from a gateway calculation, such as prayer times, sunrise or sunset, a Modbus or Zigbee reading, or a Network I/O or Rule Gateway value. Use the System Object protocol for these.

For a plain number with a unit, use an Analog Value. For on/off control, use a Switch.

#What you need first

• For a KNX value: the group address that carries the value or its status. Import the ETS list first for autocomplete (see KNX basics).
• For a System Object: the matching gateway service configured and enabled, so the value exists.

#Properties

Label, Show Label, Label Position (the pixel nudge at the top), Text Style, Access Control and the Width, Height, Position X, Position Y, Size %, Rotation, Mirror, Image Fitting and Image Display fields work as described in Common properties. A new State Action is 96 by 64.

#State Action settings

#When Protocol is System Object

#States Editor

Click Configure States to open the editor. The list on the left holds the states; Add, Clone, Remove, Down and Up manage them. At least two states must remain. A new object starts with State 0 (threshold 0, text 0) and State 1 (threshold 1, text 1). New states are named State_<n> with the threshold set to their position number.

#The action library

Select Action opens the same command library as the Action Button: the same categories, commands and parameters, grouped by category, with a description of each command. For page jumps you choose a Panel and a Page and a Close popup if opened value of 0 or 1. See the table in the Action Button page for which commands the apps actually run.

#How it behaves in the apps

• State selection: the object takes the live value from the KNX Group address, picks the state as described under Threshold, and shows that state's picture (Graphic) or text.
• Graphic type: shows the Image for state of the active state, with the Label above or below as set by Label Position.
• Text type: shows the active state's Text. The Veltnova client does not use Text Format.
• A state's own Text dimension and Text color are used in Text mode; the state's font family is used only when its Custom font is enabled.
• Flashing: the object alternates between full and nearly transparent at the set interval while the state is active.
• System Object: shows the gateway's value, formatted by Display and Format. There are no states.
• Tap: if an Action is set, a tap runs it (a page jump, or a KNX write). With no action, nothing happens.
• Rotation and Mirror are not applied by the Veltnova client.

#Example

A garage door status icon on KNX:

1. Add a State Action. Set Label to Garage.
2. Protocol: KNX. Type: Graphic.
3. KNX Data Type: 1 bit boolean - DPT 1. KNX Group: 3/0/12 (the door's closed-contact status address).
4. Open Feedback States. On State 0 (threshold 0) set Image for state to a closed-door picture. On State 1 (threshold 1) set it to an open-door picture. Turn Flashing state on for State 1 with Flashing timing 500 if you want the open door to blink.
5. Label Position: Bottom.
6. Optionally add an Action: Open Panel/Page on Every Client with Panel Garage and Page Cameras, so a tap opens the garage cameras.

A text display of the sunset time:

1. Add a State Action. Protocol: System Object.
2. System Object: Solar - Sunset. Display: Label + value. Format: 24-hour.
3. Label: Sunset. Value Text Alignment: Left.

#Tips and common problems

• The icon never changes: check KNX Group (not the Action's group address), the KNX Data Type and that the thresholds are in the right range for the value.
• The Action's KNX write and the KNX Group are separate settings. A tap that writes to a different address than the one you read is common for status icons.
• Text shows 0 or 1 instead of words: change the Text of each state.
• Only KNX values and System Objects were verified end to end for this page. For Zigbee, WiFi and MQTT, test the object on a real project before relying on it.

#See also

• Action Button
• Analog Value
• Switch
• Common properties
• KNX basics