Commands
Contents

1.Introduction

A compilation of all commands in the HS/FS is located here. All commands can be executed to the greatest extent possible in all operating points, timers, and logic. The available respective input fields change depending on the type of command.

2.Processing commands

If several commands are triggered simultaneously, e.g., in the case of sequences, logic, etc., these are entered in their own command processing lists depending on the type of command. If not all commands are in the same processing list, the sequence of processing is undefined. In the case of commands of the same type, processing takes place in the sequence specified by the user (e.g. for light scenes).

3.Command types

The following types of command are differentiated:

3.1.Switch/Query

The state of a communication object (internal/EIB) is queried or changed here. The current value of the communication object is taken from the memory of the HS/FS. After startup, the HS/FS performs a process map of all created communication objects.

Communication object

This communication object is changed with the following command.

Set to constant

The value of the communication object is set to the following constant.

Set to value of communication object

The value of the first communication object is set to the value of the following communication object.

Toggle 0 and constant

During execution, the value of the communication object switches between 0 and the following constants.

Step - (Minus)

The value of the communication object is reduced by the step size. The current value of the communication object is assumed. The step size is created in the Master data\Communication objects.

Step + (Plus)

The value of the communication object is increased by the step size. The current value of the communication object is assumed. The step size is created in the Master data\Communication objects.

List - (Minus)

The value of the communication object is set to the next smaller value from the field Step list. The current value of the communication object is assumed. The list is created in the Master data\Communication objects.

List + (Plus)

The value of the communication object is set to the next higher value from the field Step list. The current value of the communication object is assumed. The list is created in the Master data\Communication objects.

Add constant

The following constant is added to the current value of the communication object. Negative values can be added too.
The Min/Max value of the communication object is not exceeded or undershot during an addition.
Example: 10 should be added to the current dimming value of 95%, but the HS/FS only sends the maximum value of 100% (that was set in the communication object).

Query

This queries the communication object.
IMPORTANT: If the result is to be reused in the following commands, observe a pause of approx. 3 seconds before executing the following command!
You will find further information in the Chapter Process map.

3.2.Send data via e-mail

The following data can be sent via e-mail with this command.

Select data source

  • Archive
  • Message archive
  • Status page
  • Camera image
  • Login protocol
  • Buddy list
  • Debug page
  • EIB Monitor

Data source

The corresponding data source is chosen here after the type of data is selected.

E-mail address of recipient

The recipient group is assigned here. The data is sent to all the e-mail recipients.

3.3.Archive camera image

This command archives a camera image in the following camera archive.

Camera archive

The camera image is saved in this camera archive.

3.4.Enter in archive

This command can carry out an entry in one of the following archives:

Target archive

The target archive is selected here.

3.5.Send data via FTP

Data from the HS/FS is transferred via FTP with this command.

Select data source

  • Camera image
  • Login protocol
  • Buddy list
  • Debug page
  • EIB Monitor
  • Data archive
  • Message archive
  • Status page

Data source

The corresponding data source is chosen here after the type of data is selected.

3.6.Send time/date

Date and time are sent to the EIB with this command. The data is sent to the communication objects from Master data\Project\Network\NTP/Time calibration\Send date/time to EIB.

3.7.Send 14-byte text

Important
This function is only available in projects in which the function is used. In order to send or receive a 14-byte text, please use the functions Receive IP/EIB telegrams or Send IP/EIB telegrams.
This command sends a fixed text or text module to a communication object. The communication object could be located in an info display 2.0, for example. Only communication objects of data type 14 byte can be assigned.

You can switch between static and dynamic text (text module) using the [Stat] [Dyn] button.
If dynamic text is selected, a second communication object (text control) is specified for the control of the text module.

3.8.Sequence

A sequence is started or stopped using this command.

Sequence

Selection of the sequence to be used.

Action

  • Call up
  • Stop

3.9.Scene

A scene is activated using this command.

Scene

Selection of the scene to be used.

Action

  • Learn:
    All current status values of actuators assigned to the scene are saved retentively in the HS/FS. The present statuses are removed from the process map and not read again by the EIB.
  • Call up:
    This calls up the scene. The saved values are sent to the EIB. The number of EIB telegrams per second can be set for the HS/FS in Master data\Project\EIB & iETS.
  • Step - (Minus):
    All actuators of the scene are reduced by the step size. The current value of the individual actuator is changed by this value.
  • Step + (Plus):
    All actuators of the scene are increased by the step size. The current value of the individual actuator is changed by this value.
  • List - (Minus):
    Every actuator value of the scene is set to the next lower value from its list.
  • List + (Plus):
    Every actuator value of the scene is set to the next higher value from its list.

3.10.Trigger visualisation alarm

This command brings a visualisation page into the foreground, e.g., in the case of an alarm.
To this end, the design and the visualisation page has to be selected. The user has to be granted a release for this.

Design

Selection of the design to be used.

Visualisation page

Selection of the visualisation page to be called up.
  • The pop-up visualisation page must be able to be called up from another visualisation page, so that a connection exists.
  • The user must have the required rights on the visualisation page to be called up.
  • Furthermore, the pop-up visualisation page must belong to the user group of the user.
  • If the user is located within the menu, the visualisation or the query, the pop-up visualisation page is only displayed after Refresh (see Project/times). The visualisation alarm does not function inside masks (e.g. graph, timer).
  • If several visual alerts are triggered during the refresh time, the last page that was called up is displayed!

3.11.Trigger alarm (e-mail, SMS, call, push notification)

With this command, alerts can be generated by E-mail, SMS, telephone call and push notification.
For this purpose, alarms and recipient groups have to be defined.

Alarm type

Selection of alerting type.

Alarm

The associated alarm.

Recipient

The alarm recipient/alarm recipient group

3.12.Send IP/EIB telegram / Evaluate web page/IP device

With this command, data can be sent via the network to other HS/FS or network-enabled devices.

Mode

  • Send IP/EIB telegrams
    Here, data can be sent via the network to other HS/FS or network-enabled devices. Furthermore, data can be sent to 14-byte communication objects. The data to be sent is specified in the program item Communication\IP/EIB telegrams (Send).
  • Evaluate web page/IP-device
    Here, data can be sent to websites or network-enabled devices. The response received can be evaluated and processed. The data is specified in the program item Communication\Websites/IP devices.

IP/EIB telegram of website/IP device

Selection of the telegram/website/IP device.

3.13.Dim

This activates the dimming object of a dimmer.
This command is only available with the data type 4-bit.
The behaviour of the HF/FS from the user interface is not comparable to that of an EIB button with dimming application because of the signal runtime!
We recommend working with the setting of the brightness value object of the dimmer.
Otherwise, the individual dimming commands can be combined in a sequence.

Communication object

The dimming object is assigned here.
It can be changed with the following commands.

Direction

  • Stop
    This stops the dimming process.
  • Up
    This starts the increase of the brightness value.
  • Down
    This starts the lowering of the brightness value.

Speed

The speed is set with this.

3.14.Send SNMP trap

The TRAPs are sent with this command. You can find the settings for the TRAPs in Master data\Project\Network\SNMP. The following data is required for sending.

MIB

Here you define the MIB to be used.

Communication object

The value of this communication object is sent.

Factor

During sending, the value of the communication object is multiplied by this factor.

3.15.WakeOnLAN

With this command, a telegram can be sent via the network to a workstation PC, which causes the recipient device to switch on if it is switched off. In order to be able to use this function, it may be necessary to change the PC.
The devices are defined in the program item Communication\WakeOnLAN .

Workstation computer

The computer to be started is set here.

3.16.Scan EIB

Performs a new scanning operation.
Note
If the project is transferred without a scanning operation, this command is ignored.

3.17.Restart device

The HF/FS can be restarted with this command.
Note
A restart is performed automatically with each reprogramming.
Note
If the project was transferred without a scan operation, no scan is undertaken after a restart.
Note
When using this command, the retentive memory is backed up automatically before the HS/FS is shut down!