KNX_BAOS_Protocol.pdf

(138 KB) Pobierz
312888697 UNPDF
WEINZIERL ENGINEERING GmbH
KNX ObjectServer protocol
Version 1.1
WEINZIERL ENGINEERING GmbH
Bahnhofstr. 6
84558 Tyrlaching
Tel. +49 8623 / 987 98 - 03
Fax +49 8623 / 987 98 - 09
E-Mail: info@weinzierl.de
Web: www.weinzierl.de
312888697.007.png
KNX ObjectServer protocol
Document history
Document status
Date
Editor
Draft
23. November 2006 Y.Kyselytsya
Revision
20. February 2007 Y.Kyselytsya
Update
24. April 2007
Y.Kyselytsya
Add discovery
30. July 2007
Y.Kyselytsya
Add FT1.2 protocol description
07. October 2008
Y.Kyselytsya
WEINZIERL ENGINEERING GmbH
Page 2 / 37
7. Oktober 2008
312888697.008.png 312888697.009.png 312888697.010.png 312888697.001.png 312888697.002.png
KNX ObjectServer protocol
Contents
1. WHAT IS AN OBJECTSERVER? ....................................................................................................................... 4
2. COMMUNICATION PROTOCOL ...................................................................................................................... 5
2.1. G ET S ERVER I TEM .R EQ ....................................................................................................................................... 6
2.2. G ET S ERVER I TEM .R ES ....................................................................................................................................... 7
2.3. S ET S ERVER I TEM .R EQ ....................................................................................................................................... 8
2.4. S ET S ERVER I TEM .R ES ........................................................................................................................................ 9
2.5. G ET D ATAPOINT D ESCRIPTION .R EQ ................................................................................................................. 10
2.6. G ET D ATAPOINT D ESCRIPTION .R ES .................................................................................................................. 11
2.7. G ET D ESCRIPTION S TRING .R EQ ........................................................................................................................ 13
2.8. G ET D ESCRIPTION S TRING .R ES ......................................................................................................................... 14
2.9. G ET D ATAPOINT V ALUE .R EQ ........................................................................................................................... 15
2.10. G ET D ATAPOINT V ALUE .R ES .......................................................................................................................... 16
2.11. D ATAPOINT V ALUE .I ND ................................................................................................................................. 18
2.12. S ET D ATAPOINT V ALUE .R EQ .......................................................................................................................... 19
2.13. S ET D ATAPOINT V ALUE .R ES ........................................................................................................................... 21
2.14. G ET P ARAMETER B YTE .R EQ ........................................................................................................................... 22
2.15. G ET P ARAMETER B YTE .R ES ........................................................................................................................... 23
3. ENCAPSULATING OF THE OBJECTSERVER PROTOCOL ..................................................................... 24
3.1. FT1.2 .............................................................................................................................................................. 25
3.2. KNX NET /IP..................................................................................................................................................... 26
3.3. TCP/IP ............................................................................................................................................................ 27
4. DISCOVERY PROCEDURE .............................................................................................................................. 28
4.1. KNX NET /IP DISCOVERY ALGORITHM .............................................................................................................. 29
APPENDIX A. ITEM IDS........................................................................................................................................ 32
APPENDIX B. ERROR CODES ............................................................................................................................. 33
APPENDIX C. DATAPOINT VALUE TYPES...................................................................................................... 34
APPENDIX D. FT1.2 PROTOCOL ........................................................................................................................ 35
D.1. C OMMUNICATION PROCEDURE ....................................................................................................................... 35
D.2. F RAME FORMAT .............................................................................................................................................. 36
D.3. C OMMUNICATION EXAMPLE ........................................................................................................................... 36
WEINZIERL ENGINEERING GmbH
Page 3 / 37
7. Oktober 2008
312888697.003.png 312888697.004.png
KNX ObjectServer protocol
1. What is an ObjectServer ?
The ObjectServer is a hardware component, which is connected to the KNX bus
and represents it for the client as set of the defined “objects”. These objects are the
server properties (called “items”), KNX datapoints (known as “communication
objects” or as “group objects”) and KNX configuration parameters (Fig. 1). The
communication between server and clients is based on the ObjectServer protocol
that is normally encapsulated into some other communication protocol (e.g. FT1.2,
IP, etc.).
Items
Client
ObjectServer protocol
Datapoints
Parameters
ObjectServer
Figure 1. Communication between ObjectServer and Client
WEINZIERL ENGINEERING GmbH
Page 4 / 37
7. Oktober 2008
312888697.005.png
 
KNX ObjectServer protocol
2. Communication protocol
How is mentioned above, the communication between the server and the client is
based on an ObjectServer protocol and consists of the requests sent by client and
the server responses. To inform the client about the changes of datapoint’s value an
indication is defined, which will be sent asynchronously from the server to the
client. In this version of the protocol are defined following services:
- GetServerItem.Req/Res
- SetServerItem.Req/Res
- GetDatapointDescription.Req/Res
- GetDescriptionString.Req/Res
- GetDatapointValue.Req/Res
- DatapointValue.Ind
- SetDatapointValue.Req/Res
- GetParameterByte.Req/Res
WEINZIERL ENGINEERING GmbH
Page 5 / 37
7. Oktober 2008
312888697.006.png
 
Zgłoś jeśli naruszono regulamin