OpenWebNet

Last updated

OpenWebNet is a communications protocol developed by Bticino since 2000.

Contents

The OpenWebNet protocol allows a "high-level" interaction between a remote unit and Bus SCS of MyHome domotic system. The latest protocol evolution has been improved to allow interaction with well-known home automation systems like KNX and DMX512-A system, by using appropriate gateways.

The OpenWebNet protocol is disclosed on MyOpen community.

OpenWebNet Protocol

The protocol is thought to be independent from the used technology. For example, it is possible to use a supervisor software connected via Ethernet, via serial RS-232 or via USB to a gateway that is directly connected to a domotic system. One can require protocol message extension. It is enough to propose their own RFC. It will be examined and disclosed if it respects OpenWebNet syntax.

Syntax

An OpenWebNet message is structured with variable length fields separated by the special character '*' and closed by '##'.

The characters admitted in the fields are numbers and the character “#”.

The structure of a message is therefore:

The following fields are admitted: WHO WHAT WHERE DIMENSION VALUE

WHO

It characterizes the domotic system function to which the OpenWebNet message is referred.

For example: WHO = 1, characterizes the messages for lighting system management.

WHAT

It characterizes an action to do or a status to read. For every WHO (and therefore for every function) there is a specific WHAT table.

The field WHAT can also contain optional parameters: WHAT#PAR1#PAR2… #PARn.

Example of actions: switch ON light, dimmer to 75%, switch DOWN shutter, radio ON, etc. Example of status: light ON, active alarm, battery unload, etc.

WHERE

It characterizes the set of objects to which the OpenWebNet message is referred. It can be a single object, a group of objects, a specific environment, the entire system, etc.

For every WHO (and therefore for every function) there is a specified WHERE table.

The tag WHERE can also contain optional parameters: WHERE#PAR1#PAR2… #PARn.

Example of where: all the lights of group 1, sensor 2 of zone 1 of alarm system, etc.

DIMENSION

Is a range of value that characterizes the dimension of the object to which the message is referred. For every WHO (and therefore for every function) there is a specific DIMENSION table.

It’s possible to require/to read/to write the value of one dimension. Every dimension has a prefixed number of values, described in VALUE field.

Example of dimension: sensor temperature, loudspeaker volume, firmware version of a device, etc.

VALUE

It characterizes the read/written value of a written/required/read dimension.

Message

There are 4 types of OpenWebNet Message:

Command / Status Message

*WHO*WHAT*WHERE##

Status Request Message

*#WHO*WHERE##

Request/Read/Write Dimension Message Request:

*#WHO*WHERE*DIMENSION##

Read:

*#WHO*WHERE*DIMENSION*VALUE1*...*VALUEn##

Write:

*#WHO*WHERE*#DIMENSION*VALUE1*...*VALUEn##

Acknowledge Message ACK:

*#*1##

NACK:

*#*0##

Gateway OpenWebNet

It is possible to interact with the SCS home automation bus by using a specific gateway.

There are two typologies of gateways that allow a connection to the field bus by using different standard protocols:

Gateway Ethernet

The current implementation by BTicino is also an embedded web server. It works as a translator between OpenWebNet messages via TCP/IP and the SCS messages transmitted on the SCS bus.

It is possible to control three different kinds of buses:

The Ethernet gateway offers two modes of authentication:

Usually, the default port for the Ethernet gateway is 20000 even if the registered port for the protocol is 20005.

Gateway USB or RS-232

The gateway is an interface that works as a translator between the OpenWebNet messages transmitted on USB or serial and the SCS messages transmitted on the SCS bus.

Functions

WHO value Function
0 Scenario
1 Lighting
2 Automation
3 Load control
4 Temperature Control/Heating
5 Burglar Alarm/Intrusion
6 Door Entry System
7 Video Door Entry System/multimedia
9 Auxiliary
13 Gateway/interfaces management
14 Light+shutters actuators lock
15 CEN/Scenario Scheduler, switch
16 Sound System/Audio
17 Scenario programming
18 Energy Management
24 Lighting Management
25 CEN/Scenario Scheduler, buttons
1000 Diagnostic
1001 Automation diagnostic
1004 Thermoregulation diagnostic failures
1013 Device diagnostic
WHERE value Lighting Function
0 General
1÷9 Room 1÷9
11÷99 Light point 11÷99
#1÷#9 Group 1÷9

Example

OpenWebNet message examples

Command Message

Switch Off of light 77

*1*0*77##

WHO = 1 WHAT = 0 WHERE = 77

Status Message

Scenario 1 of scenario unit 23 activated.

*0*1*23##

WHO = 0 WHAT = 1 WHERE = 23

Request status message

Status request of probe 1

*#4*1##

WHO = 4 WHERE = 1

Request Dimension Message

Request of Temperature Measured, probe 44

*#4*44*0##

WHO = 4 WHERE = 44 DIMENSION = 0

Read Dimension Message

Temperature Measured, probe 44

*#4*44*0*0251*2##

WHO = 4 WHERE = 44 DIMENSION = 0 VALUE1 = 0251 (T=+25,1 °C) VALUE2 = 2 (System in "cooling mode")

Write Dimension Message

Volume set at 50%, environment 2

*#16*#2*#1*16*##

WHO = #16 WHAT = #2 WHERE = #1 DIMENSION = 1 VALUE1 = 16

See also

Related Research Articles

<span class="mw-page-title-main">SCSI</span> Set of computer and peripheral connection standards

Small Computer System Interface is a set of standards for physically connecting and transferring data between computers and peripheral devices, best known for its use with storage devices such as hard disk drives. SCSI was introduced in the 1980s and has seen widespread use on servers and high-end workstations, with new SCSI standards being published as recently as SAS-4 in 2017.

The Address Resolution Protocol (ARP) is a communication protocol used for discovering the link layer address, such as a MAC address, associated with a given internet layer address, typically an IPv4 address. This mapping is a critical function in the Internet protocol suite. ARP was defined in 1982 by RFC 826, which is Internet Standard STD 37.

<span class="mw-page-title-main">KNX</span> Standard in building automation

KNX is an open standard for commercial and residential building automation. KNX devices can manage lighting, blinds and shutters, HVAC, security systems, energy management, audio video, white goods, displays, remote control, etc. KNX evolved from three earlier standards; the European Home Systems Protocol (EHS), BatiBUS, and the European Installation Bus.

Modbus or MODBUS is a client/server data communications protocol in the application layer of the OSI model. It was originally published by Modicon in 1979 for use with its programmable logic controllers (PLCs). Modbus has become a de facto standard communication protocol for communication between industrial electronic devices in a wide range of buses and network.

<span class="mw-page-title-main">RapidIO</span> Electrical connection technology

The RapidIO architecture is a high-performance packet-switched electrical connection technology. It supports messaging, read/write and cache coherency semantics. Based on industry-standard electrical specifications such as those for Ethernet, RapidIO can be used as a chip-to-chip, board-to-board, and chassis-to-chassis interconnect.

A fieldbus is a member of a family of industrial digital communication networks used for real-time distributed control. Fieldbus profiles are standardized by the International Electrotechnical Commission (IEC) as IEC 61784/61158.

Building automation(BAS), also known as building management system (BMS) or building energy management system (BEMS), is the automatic centralized control of a building's HVAC (heating, ventilation and air conditioning), electrical, lighting, shading, access control, security systems, and other interrelated systems. Some objectives of building automation are improved occupant comfort, efficient operation of building systems, reduction in energy consumption, reduced operating and maintaining costs and increased security.

<span class="mw-page-title-main">Profinet</span> Computer network protocol

Profinet is an industry technical standard for data communication over Industrial Ethernet, designed for collecting data from, and controlling equipment in industrial systems, with a particular strength in delivering data under tight time constraints. The standard is maintained and supported by Profibus and Profinet International, an umbrella organization headquartered in Karlsruhe, Germany.

CANopen is a communication protocol and device profile specification for embedded systems used in automation. In terms of the OSI model, CANopen implements the layers above and including the network layer. The CANopen standard consists of an addressing scheme, several small communication protocols and an application layer defined by a device profile. The communication protocols have support for network management, device monitoring and communication between nodes, including a simple transport layer for message segmentation/desegmentation. The lower level protocol implementing the data link and physical layers is usually Controller Area Network (CAN), although devices using some other means of communication can also implement the CANopen device profile.

EtherCAT is an Ethernet-based fieldbus system developed by Beckhoff Automation. The protocol is standardized in IEC 61158 and is suitable for both hard and soft real-time computing requirements in automation technology.

Philips Dynalite is a lighting control and automation system developed in Sydney, Australia by John Gunton in 1987.

C-Bus is a communications protocol based on a seven layer OSI model for home and building automation that can handle cable lengths up to 1000 metres using Cat-5 cable. It is used in Australia, New Zealand, Asia, the Middle East, Russia, United States, South Africa, the UK and other parts of Europe including Greece and Romania. C-Bus was created by Clipsal Australia's Clipsal Integrated Systems division for use with its brand of home automation and building lighting control system. C-Bus has been briefly available in the United States but Schneider Electric has now discontinued sales in the United States.

A protocol converter is a device used to convert standard or proprietary protocol of one device to the protocol suitable for the other device or tools to achieve the desired interoperability. Protocols are software installed on the routers, which convert the data formats, data rate and protocols of one network into the protocols of the network in which data is navigating. There are varieties of protocols used in different fields like power generation, transmission and distribution, oil and gas, automation, utilities, and remote monitoring applications. The major protocol translation messages involve conversion of data messages, events, commands, and time synchronization.

xPL is an open protocol intended to permit the control and monitoring of home automation devices. The primary design goal of xPL is to provide a rich set of features and functionality, whilst maintaining an elegant, uncomplicated message structure. The protocol includes complete discovery and auto-configuration capabilities which support a fully "plug-n-play" architecture - essential to ensure a good end-user experience.

Sercos III is the third generation of the Sercos interface, a standardized open digital interface for the communication between industrial controls, motion devices, input/output devices (I/O), and Ethernet nodes, such as PCs. Sercos III applies the hard real-time features of the Sercos interface to Ethernet. It is based upon and conforms to the Ethernet standard. Work began on Sercos III in 2003, with vendors releasing first products supporting it in 2005.

BTicino S.p.A. is an Italian metalworking company that operates in the field of electrical low voltage equipment used for residential, employment and production. Bticino proposes solutions for the energy distribution, for the communication and for the control of light, sound, climate and security.

SCS is an acronym for "Sistema Cablaggio Semplificato". It uses a fieldbus network protocol and has applications in the field of home automation and building automation. It is used mainly in bTicino and Legrand installations.

<span class="mw-page-title-main">Index of home automation articles</span>

This is a list of home automation topics on Wikipedia. Home automation is the residential extension of building automation. It is automation of the home, housework or household activity. Home automation may include centralized control of lighting, HVAC, appliances, security locks of gates and doors and other systems, to provide improved convenience, comfort, energy efficiency and security.

A smart home hub, sometimes also referred to as a "smart hub", "gateway'", "bridge", "controller" or "coordinator", is a control center/centre for a smart home, and enables the components of a smart home to communicate and respond to each other via communication through a central point. The smart home hub can consist of dedicated computer appliance, software appliance, or software running on computer hardware, and makes it possible to gather configuration, automation and monitoring of a smart house by communicating and controlling different smart devices that consist of for example home appliances, sensors and relays or robots, many of which are commonly categorized under Internet of things.

References