EN 50090-6-1:2017

SLOVENSKI STANDARD
01-november-2017
Stanovanjski in stavbni elektronski sistemi (HBES) - 6-1. del: Vmesniki - Mrežni
vmesnik
Home and Building Electronic Systems (HBES) - Part 6-1: Interfaces - Webservice
interface
Ta slovenski standard je istoveten z: EN 50090-6-1:2017
ICS:
35.240.67 Uporabniške rešitve IT v IT applications in building
gradbeništvu and construction industry
97.120 Avtomatske krmilne naprave Automatic controls for
za dom household use
2003-01.Slovenski inštitut za standardizacijo. Razmnoževanje celote ali delov tega standarda ni dovoljeno.

EUROPEAN STANDARD EN 50090-6-1

NORME EUROPÉENNE
EUROPÄISCHE NORM
September 2017
ICS 35.240.67; 97.120
English Version
Home and Building Electronic Systems (HBES) - Part 6-1:
Interfaces - Webservice interface
Systèmes électroniques pour les foyers domestiques et les Elektrische Systemtechnik für Heim und Gebäude (ESHG) -
bâtiments (HBES) - Partie 6-1 : Interfaces - Interface de Teil 6-1: Schnittstellen - Webservice Schnittstelle
services web
This European Standard was approved by CENELEC on 2017-05-15. CENELEC members are bound to comply with the CEN/CENELEC
Internal Regulations which stipulate the conditions for giving this European Standard the status of a national standard without any alteration.
Up-to-date lists and bibliographical references concerning such national standards may be obtained on application to the CEN-CENELEC
Management Centre or to any CENELEC member.
This European Standard exists in three official versions (English, French, German). A version in any other language made by translation
under the responsibility of a CENELEC member into its own language and notified to the CEN-CENELEC Management Centre has the
same status as the official versions.
CENELEC members are the national electrotechnical committees of Austria, Belgium, Bulgaria, Croatia, Cyprus, the Czech Republic,
Denmark, Estonia, Finland, Former Yugoslav Republic of Macedonia, France, Germany, Greece, Hungary, Iceland, Ireland, Italy, Latvia,
Lithuania, Luxembourg, Malta, the Netherlands, Norway, Poland, Portugal, Romania, Serbia, Slovakia, Slovenia, Spain, Sweden,
Switzerland, Turkey and the United Kingdom.

European Committee for Electrotechnical Standardization
Comité Européen de Normalisation Electrotechnique
Europäisches Komitee für Elektrotechnische Normung
CEN-CENELEC Management Centre: Avenue Marnix 17, B-1000 Brussels
© 2017 CENELEC All rights of exploitation in any form and by any means reserved worldwide for CENELEC Members.
Ref. No. EN 50090-6-1:2017 E
Contents Page
European foreword . 3
Introduction . 4
1 Scope. 5
2 Normative references . 5
3 Terms, definitions and abbreviations . 5
3.1 Terms and definitions . 5
3.2 Abbreviations . 5
4 Overall introduction . 5
5 General technical introduction to HBES Web Services . 6
6 Overview . 7
6.1 General architecture . 7
6.2 General Home and Building HBES Open Communication System structure . 8
6.3 Structure of this document . 10
7 HBES Information model . 10
7.1 Introduction . 10
7.2 Vocabulary structure . 11
7.3 Core tags . 13
7.4 Modelling example . 18
8 HBES Web interface OBIX . 21
8.1 Introduction . 21
8.2 Information presentation . 21
8.2.1 Introduction . 21
8.2.2 Contract mapping . 23
8.2.3 Data point Type contract mapping . 25
8.2.4 Functional Block Type contract mapping . 26
8.2.5 Entity mapping . 27
8.3 Object addressing . 28
8.4 Object interaction . 29
8.4.1 Introduction . 29
8.4.2 Read transaction . 30
8.4.3 Write transaction . 31
8.4.4 Invoke transaction . 31
9 HBES Gateway OBIX . 32
9.1 Introduction . 32
9.2 Object model . 32
9.3 Representational State Transfer . 33
10 Gateway profiles . 33
10.1 Introduction . 33
10.2 Information encoding . 34
10.3 Message exchange . 34
10.4 Profiles . 35
10.5 Conflict handling . 36

European foreword
This document (EN 50090-6-1:2017) has been prepared by CLC/TC 205 “Home and Building
Electronic Systems (HBES)”.
The following dates are fixed:
• latest date by which this document has to be (dop) 2018-09-01
implemented at national level by publication of
an identical national standard or by
endorsement
• latest date by which the national standards (dow) 2020-09-01
conflicting with this document have to be
withdrawn
Introduction
The European Committee for Electrotechnical Standardization (CENELEC) draws attention to the fact
that it is claimed that compliance with this document may involve the use of a patent.
CENELEC takes no position concerning the evidence, validity and scope of this patent right.
The holder of this patent right has assured CENELEC that he/she is willing to negotiate licences
under reasonable and non-discriminatory terms and conditions with applicants throughout the world.
In this respect, the statement of the holder of this patent right is registered with CENELEC.
Information may be obtained from:
KNX Association De Kleetlaan 5, Bus 11
B-1831 Brussels-Diegem
Tel: +32 (0)2 775 86 44 Mob: +32 (0) 476 21 56 58 Fax: +32 (0)2 675 50 28
e-mail: info@knx.org
www.knx.org
Attention is drawn to the possibility that some of the elements of this document may be the subject of
patent rights other than those identified above. CENELEC shall not be held responsible for identifying
any or all such patent rights.
1 Scope
This European Standard defines a standardized web service based interface between Home and
Building HBES Open Communication System and other information technology (IT) systems.
The standardized interface is encapsulated in a gateway device, the HBES Gateway, which is able to
communicate with both the Home and Building HBES Open Communication System and the
connected IT systems. The HBES Gateway implements a set of encoding standards (see 10.2) as
well as various message exchange protocols (see 10.3) to enable remote access to the Home and
Building HBES Open Communication System via the Internet or another wide area network (WAN).
For this purpose, gateway profiles define different implementation levels (see 10.4).
2 Normative references
The following documents, in whole or in part, are normatively referenced in this document and are
indispensable for its application. For dated references, only the edition cited applies. For undated
references, the latest edition of the referenced document (including any amendments) applies.
EN 50090-1:2011, Home and Building Electronic Systems (HBES) - Part 1: Standardization structure
EN 50090-3-3, Home and Building Electronic Systems (HBES) - Part 3-3: Aspects of application -
HBES Interworking model and common HBES data types
3 Terms, definitions and abbreviations
3.1 Terms and definitions
For the purposes of this document, the terms and definitions given in EN 50090-1:2011 apply.
3.2 Abbreviations
For the purposes of this document, the following abbreviations apply.
BAS Building Automation System
BMS Building Management System
IoT Internet of Things
OASIS Open Building Information Exchange
WS Web Services
4 Overall introduction
Home and Building HBES Open Communication System is dedicated to the control and monitoring of
networked building automation systems (BASs). Currently, Home and Building HBES Open
Communication System has limited capability to communicate with other systems, as a result of the
use of different protocols, incompatibility or various other restrictions. For the integration of Home and
Building HBES Open Communication System and for solving specific problem scenarios, customized
solutions are currently on offer. A standard interface between the HBES world and the remaining
systems would however constitute a common link to bridge the gap and integrate Home and Building
HBES Open Communication System into systems like the traditional Internet or the emerging Internet
of Things (IoT).
A standard bridge between Home and Building HBES Open Communication System and IT systems
based on Web services (WSs) is currently missing to support upcoming use case scenarios. This
standard specifies such a standard interface.
5 General technical introduction to HBES Web Services
The HBES Gateway is an abstract concept, and thus not restricted to any hardware requirements or
limitations. Constrained devices can be used as well as enterprise systems as HBES Gateway
device. It shall be kept in mind that some configurations may overload the used hardware regarding
the mentioned limitations. For example, a computationally intensive message exchange protocol
cannot be used in resource-constrained HBES Gateways. However, the HBES Web services
specification defines the HBES Gateway in an abstract and platform-independent way irrespective of
any particular hardware.
Figure 1 sketches the intended setting containing the Home and Building HBES Open Communication
System, the IT systems and the HBES Gateway between these two components.

Figure 1 — General intention of the HBES WS interface
In a first version, the HBES Gateway and its WS interface is based on OASIS Open Building
Informatio
...