15-day Public Reviews for 5 #OBIX Committee Specification Drafts - end December 24th

The OASIS Open Building Information Exchange (oBIX) TC members [1] have produced five updated Committee Specification Drafts (CSDs) and submitted these specifications for 15-day public review:

OBIX Version 1.1
Committee Specification Draft 03 / Public Review Draft 03
06 November 2014

Encodings for OBIX: Common Encodings Version 1.0
Committee Specification Draft 03 / Public Review Draft 03
06 November 2014

Bindings for OBIX: REST Bindings Version 1.0
Committee Specification Draft 03 / Public Review Draft 03
06 November 2014

Bindings for OBIX: WebSockets Bindings Version 1.0
Committee Specification Draft 02 / Public Review Draft 02
06 November 2014

Bindings for OBIX: SOAP Bindings Version 1.0
Committee Specification Draft 03 / Public Review Draft 03
06 November 2014

Specification Overview:

OBIX v1.1 provides the core information model (expressed as an XDM) and interaction pattern for interactions with building control systems, or any control systems. The document specifies an object model used for machine-to-machine (M2M) communication which we name the Open Building Information eXchange (OBIX). It also describes the default XML encoding for OBIX.

Encodings for OBIX: Common Encodings v1.0 specifies different encodings for OBIX objects adhering to the OBIX object model. OBIX provides the core information model and interaction pattern for communication with building control systems.

Specific implementations of OBIX must choose how to encode OBIX Information. The core specification describes an XML encoding, which is used in all examples in that document. The document specifies common alternate encodings, including CoAP, EXI, and JSON.

Bindings for OBIX: REST Bindings v1.0 specifies REST bindings for OBIX. The document describes the REST Binding, an interaction pattern that can be used in conjunction with XML, EXI, CoAP, and JSON encodings, as well as other encodings that may be specified elsewhere.

Bindings for OBIX: SOAP Bindings v1.0 specifies SOAP protocol bindings for OBIX. The document describes the SOAP Binding and includes a WSDL artifact.

Bindings for OBIX: WebSockets Bindings v1.0 specifies Web Socket protocol bindings for OBIX. The OBIX Binding for WebSockets was of partocular interest to consumer electronics and smart televisions.

TC Description:

The OBIX (Open Building Information Exchange) specification enables enterprise applications to communicate with control systems (e.g. mechanical, electrical, security...) in buildings. Since OBIX 1.0 was released in 2006, it has found wide use as a semantic integration layer, in widespread use for communication between control systems, even within a building or site. OBIX is in wide use for gathering wide area situation awareness, in fleet management, and in perimeter security.

OBIX 1.1 is a refresh cycle that is intended to maintain full compatibility with the installed base of OBIX systems. The Technical Committee (TC) has re-written portions of the specification for improved clarity, and has increased the formal conformance sections. The intent of these changes is to improve interoperability between disparate implementations.

The structure of the OBIX Specification has changed. The core model of OBIX is in the OBIX 1.1 specification. Specific guidelines for Encodings, and for Bindings (REST, SOAP, and Web Sockets) are now in separate specifications. The Encoding specification has added the Constrained Application Protocol (CoAP) as a REST Binding. CoAP is a new IETF specification that is of growing interest to those implementing the Internet of Things in constrained environments, such as wireless sensor networks. The Encodings specification also adds JSON and EXI as two new lightweight options that extend the range of the REST interaction pattern. By moving Encodings and Bindings to separate specifications, the TC sought to make the core specification simpler while making it possible to define other encodings and bindings without revisiting the core.

The core specification now includes an XML Data Model (XDM) described using an XML Schema (XSD). The TC did not consider a normative schema in 2004; including one now will enhance the ability for developers to validate messages and develop code using standards modern toolkits. Reviewers are asked be sure to examine the enclosed schema, which is normative.

Two features have been added to revised specification. An OBIX 1.1 server is able to provide metadata on each control point if available. If this metadata is based on one or more published taxonomies, the metadata is so identified. An OBIX 1.1 server is also able to more compactly deliver large data-sets of telemetry, as for example, an OBIX Historian request for fine-grained interval data over a prolonged period. The model for these large data-sets is compatible with models described in the OASIS specification WS-Calendar and in the Report Services of OASIS Energy Interoperation.

The OBIX Watch functionality has been enhanced to handle the needs of smaller devices as well as of intermittent communications such as cell phones.

Public Review Period:

The public review starts 10 December 2014 at 00:00 UTC and ends 24 December 2014 at 23:59 UTC. These specifications were previously submitted for public reviews [2]. These 15-day review are limited in scope to changes made from the previous review. Changes are highlighted in diff-marked PDF files [3].

This is an open invitation to comment. OASIS solicits feedback from potential users, developers and others, whether OASIS members or not, for the sake of improving the interoperability and quality of its technical work.

URIs:
The prose specification document and related files are available here:

- OBIX Version 1.1

PDF (Authoritative):
http://docs.oasis-open.org/obix/obix/v1.1/csprd03/obix-v1.1-csprd03.pdf

HTML:
http://docs.oasis-open.org/obix/obix/v1.1/csprd03/obix-v1.1-csprd03.html

HTML with inline tags for direct commenting:
http://docs.oasis-open.org/obix/obix/v1.1/csprd03/obix-v1.1-csprd03-COMM...

Editable source:
http://docs.oasis-open.org/obix/obix/v1.1/csprd03/obix-v1.1-csprd03.doc

XML schemas:
http://docs.oasis-open.org/obix/obix/v1.1/csprd03/schemas/

- Encodings for OBIX: Common Encodings Version 1.0

PDF (Authoritative):
http://docs.oasis-open.org/obix/obix-encodings/v1.0/csprd03/obix-encodin...

HTML:
http://docs.oasis-open.org/obix/obix-encodings/v1.0/csprd03/obix-encodin...

HTML with inline tags for direct commenting:
http://docs.oasis-open.org/obix/obix-encodings/v1.0/csprd03/obix-encodin...

Editable source:
http://docs.oasis-open.org/obix/obix-encodings/v1.0/csprd03/obix-encodin...

- Bindings for OBIX: REST Bindings Version 1.0

PDF (Authoritative):
http://docs.oasis-open.org/obix/obix-rest/v1.0/csprd03/obix-rest-v1.0-cs...

HTML:
http://docs.oasis-open.org/obix/obix-rest/v1.0/csprd03/obix-rest-v1.0-cs...

HTML with inline tags for direct commenting:
http://docs.oasis-open.org/obix/obix-rest/v1.0/csprd03/obix-rest-v1.0-cs...

Editable source:
http://docs.oasis-open.org/obix/obix-rest/v1.0/csprd03/obix-rest-v1.0-cs...

- Bindings for OBIX: WebSockets Bindings Version 1.0

PDF (Authoritative):
http://docs.oasis-open.org/obix/obix-websocket/v1.0/csprd02/obix-websock...

HTML:
http://docs.oasis-open.org/obix/obix-websocket/v1.0/csprd02/obix-websock...

HTML with inline tags for direct commenting:
http://docs.oasis-open.org/obix/obix-websocket/v1.0/csprd02/obix-websock...

Editable source:
http://docs.oasis-open.org/obix/obix-websocket/v1.0/csprd02/obix-websock...

- Bindings for OBIX: SOAP Bindings Version 1.0

PDF (Authoritative):
http://docs.oasis-open.org/obix/obix-soap/v1.0/csprd03/obix-soap-v1.0-cs...

HTML:
http://docs.oasis-open.org/obix/obix-soap/v1.0/csprd03/obix-soap-v1.0-cs...

HTML with inline tags for direct commenting:
http://docs.oasis-open.org/obix/obix-soap/v1.0/csprd03/obix-soap-v1.0-cs...

Editable source:
http://docs.oasis-open.org/obix/obix-soap/v1.0/csprd03/obix-soap-v1.0-cs...

WSDL files:
http://docs.oasis-open.org/obix/obix-soap/v1.0/csprd03/wsdl/

ZIP distribution files (complete):

For your convenience, OASIS provides complete packages of the prose specifications and related files in a ZIP distribution file. You can download the ZIP files here:

- OBIX Version 1.1: http://docs.oasis-open.org/obix/obix/v1.1/csprd03/obix-v1.1-csprd03.zip

- Encodings for OBIX: Common Encodings Version 1.0: http://docs.oasis-open.org/obix/obix-encodings/v1.0/csprd03/obix-encodin...

- Bindings for OBIX: REST Bindings Version 1.0: http://docs.oasis-open.org/obix/obix-rest/v1.0/csprd03/obix-rest-v1.0-cs...

- Bindings for OBIX: WebSockets Bindings Version 1.0: http://docs.oasis-open.org/obix/obix-websocket/v1.0/csprd02/obix-websock...

- Bindings for OBIX: SOAP Bindings Version 1.0: http://docs.oasis-open.org/obix/obix-soap/v1.0/csprd03/obix-soap-v1.0-cs...

Additional information about this specification and the OASIS Open Building Information Exchange (oBIX) TC may be found on the TC's public home page located at:

http://www.oasis-open.org/committees/obix/

Comments may be submitted to the TC by any person through the use of the OASIS TC Comment Facility which can be accessed via the button labeled "Send A Comment" at the top of the TC public home page, or directly at:

http://www.oasis-open.org/committees/comments/form.php?wg_abbrev=obix

Feedback submitted by TC non-members for this work and for other work of this TC is publicly archived and can be viewed at:

http://lists.oasis-open.org/archives/obix-comment/

All comments submitted to OASIS are subject to the OASIS Feedback License, which ensures that the feedback you provide carries the same obligations at least as the obligations of the TC members. In connection with the public reviews of these CSDs we call your attention to the OASIS IPR Policy [4] applicable especially [5] to the work of this technical committee. All members of the TC should be familiar with this document, which may create obligations regarding the disclosure and availability of a member's patent, copyright, trademark and license rights that read on an approved OASIS specification.

OASIS invites any persons who know of any such claims to disclose these if they may be essential to the implementation of the above specification, so that notice of them may be posted to the notice page for this TC's work.

========== Additional references:

[1] OASIS Open Building Information Exchange (oBIX) TC
http://www.oasis-open.org/committees/obix/

[2] Previous public reviews:

- 30-day public review, 26 July 2013 for OBIX Version 1.1, Encodings for OBIX: Common Encodings Version 1.0, Bindings for OBIX: REST Bindings Version 1.0, and Bindings for OBIX: SOAP Bindings Version 1.0: https://lists.oasis-open.org/archives/tc-announce/201307/msg00010.html

- 30-day public review, 15 January 2014 for OBIX Version 1.1, Encodings for OBIX: Common Encodings Version 1.0, Bindings for OBIX: REST Bindings Version 1.0, Bindings for OBIX: SOAP Bindings Version 1.0, and Bindings for OBIX: WebSockets Bindings Version 1.0: https://lists.oasis-open.org/archives/tc-announce/201401/msg00006.html
- Comment resolution logs:
- http://docs.oasis-open.org/obix/obix/v1.1/csprd02/obix-v1.1-csprd02-comm...
- http://docs.oasis-open.org/obix/obix/v1.1/csprd02/obix-v1.1-csprd02-comm...
- http://docs.oasis-open.org/obix/obix-encodings/v1.0/csprd02/obix-encodin...
- http://docs.oasis-open.org/obix/obix-rest/v1.0/csprd02/obix-rest-v1.0-cs...
- http://docs.oasis-open.org/obix/obix-soap/v1.0/csprd02/obix-soap-v1.0-cs...
- http://docs.oasis-open.org/obix/obix-websocket/v1.0/csprd01/obix-websock...

[3] Redlined DIFF file:

- OBIX Version 1.1: http://docs.oasis-open.org/obix/obix/v1.1/csprd03/obix-v1.1-csprd03-diff...

- Encodings for OBIX: Common Encodings Version 1.0: http://docs.oasis-open.org/obix/obix-encodings/v1.0/csprd03/obix-encodin...

- Bindings for OBIX: REST Bindings Version 1.0: http://docs.oasis-open.org/obix/obix-rest/v1.0/csprd03/obix-rest-v1.0-cs...

- Bindings for OBIX: WebSockets Bindings Version 1.0: http://docs.oasis-open.org/obix/obix-websocket/v1.0/csprd02/obix-websock...

- Bindings for OBIX: SOAP Bindings Version 1.0: http://docs.oasis-open.org/obix/obix-soap/v1.0/csprd03/obix-soap-v1.0-cs...

[4] http://www.oasis-open.org/policies-guidelines/ipr

[5] http://www.oasis-open.org/committees/obix/ipr.php
https://www.oasis-open.org/policies-guidelines/ipr#s10.2.3
RF on Limited Terms Mode

Associated TC: 
Open Building Information Exchange (oBIX)