Openwebnet

Using special software, you can carry out centralized control of the MyHome system . Using ethernet , serial RS232 or USB through a gateway, the program connects to the home automation system .

Minimum requirements - the ability to use DTMF codes for the public switched telephone network ( PSTN ) for sending messages.

History

The OpenWebNet protocol was opened in 2006 with the goal of abstracting from the “closed” SCS (Simple Cable Systems) technology, on which all MY HOME automation systems are based, and to offer the possibility of their integration with solutions from other manufacturers, which is not tied to the method of data transfer. For the first time, the protocol was used to control light through a telephone line ( DTMF codes).

Syntax

An OpenWebNet message is in ASCII format and consists of fields of various lengths, separated by the '*' character. Closes the message '##'.

The structure of the message is as follows:

• field1 * field2 * ... * fieldN ##

The following fields can be used: WHO WHERE WHAT DIMENSION VALUE

WHO

Depending on the value in this field, messages refer to a particular subsystem of MyHome. For example, if the value of WHO = 1, the message is intended to control the light, if WHO = 4 - temperature, etc.

WHERE

Depending on the value contained in this field, messages relate to one or another object (set of objects) of the MyHome system. In fact, the field contains the address of the devices. For each of the values ​​of the Who field there is a table value of the Where field. For example, if the value is WERE = 11, the message is intended to control the device with the address A = 1; PL = 1.

The WHERE tag may also contain additional parameters: WHERE # PAR1 # PAR2 ... #PARn.

What

The field describes the action to be performed. This can be on / off the light, setting the dimmer to a certain level of brightness, turning on the radio tuner.

For example, if the value of What = 1, the message will turn on the light, if 0 - turn off. If, for example, you need to set the dimmer to 60%, then What = 6.

DIMENSION

Used to measure the current parameters of an object. Using this field, you can query the current value of the measured parameter, read / write the parameter value.

For example: temperature, volume level, device software version, etc.

Message Structure

Team / Status Message:

  * WHO * WHAT * WHERE ##

Example: * 1 * 1 * 11 ##

WHO = 1 - the message is intended for the lighting system;

WHERE = 11 - device address A = 1, PL = 1;

WHAT = 1 - activator activation;

Status Request Message:

  * # WHO * WHERE ##

Example: * # 1 * 11 ##

WHO = 1 - the message is intended for the lighting system;

WHERE = 11 - address of the relay, the status of which must be requested A = 1, PL = 1;

Request / Read measured parameter:

  * # WHO * WHERE * DIMENSION ##

Example: * # 4 * 01 * 0 ##

WHO = 4 - the message is intended for a thermal monitoring system;

WHERE = 01 - request for reading the temperature sensor of zone 1 (ZA = 0, ZB = 1);

DIMENSION = 0 - sensor readout mode;

Writing a new value:

  * # WHO * WHERE * # DIMENSION * VAL1 * VAL2 ##

Example: * # 4 * 1 * # 14 * 0210 * 1 ##

WHO = 4 - the message is intended for a thermal monitoring system;

WHERE = 1 - address of the temperature control zone (ZA = 0, ZB = 1);

DIMENSION = 14 - mode for setting a new value;

VAL1 = 0210 –new temperature value (21.0 °);

VAL2 = 1 - operation mode (heating);

Confirmation / Non-Confirmation Message:

ACK:

  *#*one##

Confirmation of the successful reception of the team from the client program;

NACK:

  * # * 0 ##

Indicates that the message received from the client contains errors

There are two types of gateways that allow you to communicate with the SCS bus :

TCP / IP Gateway ( Web Server )

It is a converter between OpenWebNet messages transmitted via TCP / IP protocol and SCS messages of MyHome system. The server runs on the Linux platform. Also has a web interface.

Opening session :

1. The server checks the possibility of establishing a connection, which depends on the number of open sessions. By default, the number of sessions should not exceed 50.

2. If the connection is established, the server sends an ACK message.

3. Then the server waits for the OPEN message * 99 * 0 ## or 99 * 1 ## to open the session in one of the modes: command mode, monitoring mode. If no message arrives within 30 seconds, the server terminates the connection.

4. After receiving the OPEN message, the server checks the client IP address. If the IP address is in the range of allowed IP addresses, then the server starts transmitting data.

Serial / USB Gateway

It is a converter between OpenWebNet messages transmitted via the USB / RS-232 bus and SCS messages of the MyHome system.

• Home automation
• Eib
• Dmx

• MyOpen Community
• Bticino website
• Legrand Group