Communication object gateway
Contents
1.
2.
3.
4.
5.
6.
7.
Communication objects of the HS/FS can be read and assigned values via the communication object gateway interface. You can configure access to the interface using this menu item.

To do so, the following prerequisites must be met:
The interface can be accessed both via WebSockets using the methods available as of firmware v4.7, which offers encrypted (HTTPS) and unencrypted communication (HTTP), and via the (non-secure) compatibility mode (HTTP) available since firmware v2.2.

A HS monitor is available for both methods, which demonstrates the use of the communication object gateway interface. The version available since firmware v2.2 is a program for Windows PCs (hsmonitor.exe), which can only be operated in compatibility mode as of firmware v4.7.
The new version of HS monitor available as of firmware v4.7 is a browser application.

Up to 10 concurrent connections are possible with mode 1 and an additional 10 concurrent connections with mode 2.

You can find a more detailed description of the interface in this documentation.

1. Activate access via WebSocket (e.g. HTML HS monitor) (mode 1)

Activates (secure) sending and receiving via the network as of Expert/firmware version 4.7 via WebSockets.
Activate this access if you want to access the HS/FS securely via a browser using the new HS monitor function, for example.

This method is activated by default in newly created projects as of Expert v4.7.

2. Activate compatibility mode (mode 2)

By activating this option, the (non-secure) access to the communication object gateway is permitted, as in the Expert/firmware versions prior to v4.7.
Activate compatibility mode if you want to use the conventional HS monitor (hsmonitor.exe), for example.

This method is deactivated by default in newly created projects as of Expert v4.7.

3. Local IP port

Communication takes place in the HS/FS via this IP port if mode 2 is activated.

4. Access (table with senders 1..5)

IP address/net mask

Specifies the address range from which the communication object gateway may be accessed. Accesses outside the defined ranges are ignored.
Sender Net mask Explanation
192.168.0.17 255.255.255.255 Only the device with the specified IP address has access
192.168.0.0 255.255.255.0 All devices whose IP address starts with 192.168.0 have access

Code

Optional. For each of the five address ranges, any access code can be defined, which must also be specified for communication.
You can find an example in the documentation on the HS monitor (version as of firmware v4.7).

5. Activate receiving for all communication objects

Yes: All communication objects with a group address can be changed via the communication object gateway. This setting overwrites the respective setting of a communication object.
No: Uses the settings of the communication object.

6. Activate sending for all communication objects

Yes: Sends all communication objects with a group address via the communication object gateway. This setting overwrites the respective setting of a communication object.
No: Uses the setting of the communication object.

7. Load XML structure of communication objects on device

Yes: Creates an XML file on the HS/FS which contains all available information relating to the communication objects (group address, name, type, etc.).
Warning
The Transfer images+data+voice messages option must be used when transferring the project to the HS/FS!