Skip to content

command

Description

The command block emits a fixed command at its output when a configured trigger condition is met at the input. This makes it possible to convert a state change, a logical level, or the null value into one of the predefined control commands used by other blocks.

The block has one input and one output. It does not require the use of inputs labeled using the tag block.

Configuration parameters

Parameter name Value
Input edge (input_edge) Required parameter that defines the trigger condition. In the UI, the available values are: Rising (rising), Falling (falling), Rising or falling (both), True (true), False (false), Null (null). In addition, the none value is also supported and disables reaction to ordinary input events.
Output (output) Required parameter that defines the command emitted at the output. Available values are: Set (set), Reset (reset), Up (up), Down (down), Louver up (louver_up), Louver down (louver_down), Cooling (cooling), Heating (heating), Auto (auto).

Meaning of the Input edge (input_edge) parameter:

  • Rising (rising): reacts to a change interpreted as false -> true
  • Falling (falling): reacts to a change interpreted as true -> false
  • Rising or falling (both): reacts to every change between logical states
  • True (true): reacts to every input event whose new value can be interpreted as logical true
  • False (false): reacts to every input event whose new value can be interpreted as logical false
  • Null (null): reacts to every input event whose new value is null
  • none: no reaction to ordinary input events

Input handling

The block reacts to ordinary input events delivered to its input. It requires at least one input connection to operate. If there is no connection, it switches to the disconnected state and does not emit any commands.

Detailed operating rules:

  • when the condition defined by the Input edge (input_edge) parameter is met, the block emits the command selected in the Output (output) parameter
  • the received input value is not forwarded further; it is used only to evaluate the trigger condition
  • for Rising (rising), Falling (falling), and Rising or falling (both), the block requires values that can be interpreted logically
  • for True (true) and False (false), the block reacts to every input event whose new value is interpreted respectively as true or false, even if no change occurred compared to the previous value
  • for Null (null), the block reacts only to input events whose new value is null
  • for none, all ordinary input events are ignored
  • each subsequent trigger causes the command to be emitted again, even if the previously emitted command was identical

Examples of values that can be interpreted logically include boolean values and numbers equal to 0 or different from 0.

Block outputs

The block has one output.

The output always emits exactly the command configured in the Output (output) parameter.

The description visible below the block usually shows the selected command, for example set, reset, or down. If the block has no input connection, the Input disconnected. message is displayed.

Errors visible to the user

The block can display the following error messages:

Error code Error description
Invalid input_edge configuration. The input_edge parameter is invalid or has not been provided.
Invalid output configuration. The output parameter is invalid, empty, or outside the list of supported commands.
Input disconnected. No other block has been connected to the block input.

Examples

  • If Rising (rising) is selected in Input edge and Set (set) is selected in Output, then a change of the input from false to true will cause the set command to be emitted.
  • If Rising or falling (both) is selected in Input edge and Down (down) is selected in Output, then every logical state change at the input will cause the down command to be emitted.
  • If True (true) is selected in Input edge and Heating (heating) is selected in Output, then every input event whose new value is interpreted as true will cause the heating command to be emitted, even if the previous value was also true.
  • If Null (null) is selected in Input edge and Reset (reset) is selected in Output, then receiving the null value will cause the reset command to be emitted.
  • If the none value is selected in Input edge, the block will not emit any command in response to ordinary input events.