Difference between revisions of "OWN OpenWebNet Language Reference"

From piMyHome Project
Jump to navigation Jump to search
Line 58: Line 58:
 
*2*1*91#4#03##      open (1) shutter 9.1 in on interface 3 (#4#03)
 
*2*1*91#4#03##      open (1) shutter 9.1 in on interface 3 (#4#03)
 
*#4*#1*#14*0225*3## Set heating zone 1 manually ON to 22.5°C
 
*#4*#1*#14*0225*3## Set heating zone 1 manually ON to 22.5°C
 +
</pre>'''
  
 
== The Tables of WHO WHAT WHERE ==
 
== The Tables of WHO WHAT WHERE ==

Revision as of 22:49, 15 November 2014

The OpenWebNet protocol was defined in 2000 by Bticino/Legrand to specify the communication with a Bticino domotic gateway, connected via LAN, RS-232 (serial) or USB.

Basic Syntax Rules

A Bticino gateway receives and sends OPEN messages:

  • A message is a simple string, containing the characters asterisk (*), hash (#) and numbers from 0 to 9.
  • each message begins with an asterisk (*) and ends with a double hash (##).
  • within the message, fields are separated by an asterisk (*).

Example: *field1*field2*field3*...fieldN##

The following table shows the allowed syntax:

Message Type Message Note
ACK *#*1## Message accepted/understood
NACK *#*0## Message not accepted/understood
Standard *WHO*WHAT*WHERE## Standard message
Status Request *#WHO*WHERE## Request a state (e.g. if a light is ON or OFF)
Dimension Request *#WHO*WHERE*DIMENSION## Request a dimension
Dimension Write *#WHO*WHERE*#DIMENSION*VAL1*VAL2*...*VALn## Write a dimension

Standard Message

In the table above, we learned a Standard Message consists of *WHO*WHAT*WHERE## .

  • WHO identifies the service, such as scenario, light or automation
  • WHAT is the action to be performed, such as light ON/OFF or dimmer, shutter up/down etc.
  • WHERE identifies the object, which can be an area, group, an environment, or just a single light or shutter etc. A WHERE field can also come with optional parameters, separated by a hash (#), e.g. *WHERE#PAR1#PAR2#...#PARn


Some Examples

*1*0*25##           Turn off light 2.5 on local interface (e.g. F
*1*1*47#4#01##      Turn on light 4.7 on interface 1 (#4#01)
*1*1*0415##         Turn on light 4.15 on local interface
*1*0*0##            Turn off all lights on local interface
*0*13*19#4#06##     Launch command 13 of Scenariolist 19 (e.g a F420 is addressed by 19) on interface 6
*2*1*91#4#03##      open (1) shutter 9.1 in on interface 3 (#4#03)
*#4*#1*#14*0225*3## Set heating zone 1 manually ON to 22.5°C

The Tables of WHO WHAT WHERE

WHO Service
0 Scenarios
1 Lighting
2 Automation
3 Load Control
4 Heating
5 Burglar Alarm
6 Door Entry System
7 Multimedia
9 Auxiliary
13 Device Communication
14 Light+shutters actuators lock
15 CEN MH200N
16 Sound System
17 Scenario Programming
18 Energy Management
24 Lighting Management
25 CEN F454
1000 Diagnostic
1001 Automation Diagnostic
1004 Heating Diagnostic
1013 Device Diagnostic
WHAT Adress
The WHAT table depends on the WHO service. Please click on the appropriate service in WHO table.
WHERE Location
0 General
1..9 Zone 1 to 9
11..99 Light point 11 to 99
#1..#9 Group 1 to 9