OIC SPECIFICATION 1.0
Single file download with all specification files in this release (dated December 23, 2015; 6 MB)
Individual files included in above single .zip package:
- Core Framework
This specifies the OIC core architecture, interfaces, protocols and services to enable OIC profiles implementation for Internet of Things (IoT) usages and ecosystems. The OIC architecture is based on the Resource Oriented Architecture design principles. A resource model to define resources is described in detail. Additional functional interactions (Endpoint and Resource Discovery, Advertisement, Monitoring and Maintenance) and necessary resources for the same are specified. Different vertical specifications use the definitions and models defined in this document.
This describes device on-boarding with a trusted on boarding tool within the IoT network, in particular for a variety of devices with different cryptographic capabilities. The document also defines security resources needed for security functions within the OIC resource-oriented architecture as well as mechanisms for protecting the resources both at rest and in transit. In particular, it defines access control mechanisms to handle OIC software resources hosted by devices and the transport security mechanisms for security exchanges between different devices. Finally, it provides security hardening requirements for the underlying platform hosting the OIC software.
- Smart Home Device
Smart Home Device defines an OIC Device for usage in the Smart Home vertical by making use of functionality defined in the OIC Core Specification and OIC Smart Home Resource Specification. This document further profiles the OIC Core Specification where implementation choices exist in the areas of: messaging protocol, payload encoding and network layer. For the devices defined, the document specifies which resources are mandatory to be implemented.
- Resource Type
This specifies a base resource schema for all Smart Home resources and a set of resources that are on built on the base schema that may be exposed by OIC Devices. The Resource specification uses RAML as a specification language for the APIs exposed by the resources and JSON Schemas as payload definitions for the resource representations. These resources support the modeling of the key Use Cases of: Device Control, Notification, Environment Control, Energy Management and Energy Saving.
- Remote Access
Remote Access describes the use of industry-standard protocols (initially XMPP), in conjunction with OIC Core Framework, Security, and Smart Home Device specifications to facilitate secure access to OIC IoT devices of all types. In Remote Access, the security and resource models described in the other OIC Specifications are mapped to XMPP (and later other) protocols, leveraging the rich capabilities of XMPP for remote discovery, presence, and Pub-Sub functions. Fundamentally, Remote Access makes the I in IoT truly (and securely) mean “Internet”, and not “Intranets”.
There is currently no errata.
Please visit the members-only website for more plugfest event details and access to the certification-related documents.
IoTivity Open Source Code
Visit the IoTivity web page for the open source code: https://www.iotivity.org/
Copyright © 2015 Open Connectivity Foundation, Inc. All rights reserved. The OCF logo is a trademark and/or service mark of Open Connectivity Foundation, Inc. in the United States or other countries. Other names and brands may be claimed as the property of others. USE OF THE INFORMATION CONTAINED HEREIN SHALL BE GOVERNED SOLELY BY THE TERMS AND CONDITIONS OF THE OPEN CONNECTIVITY FOUNDATION, INC. INTELLECTUAL PROPERTY RIGHTS POLICY. THE DOCUMENT AND INFORMATION CONTAINED HEREIN IS NOT, IN ITSELF, A LICENSE, EITHER EXPRESSLY OR IMPLIEDLY, TO ANY INTELLECTUAL PROPERTY OWNED OR CONTROLLED BY ANY MEMBER OF THE OPEN CONNECTIVITY FOUNDATION, INC. OR OF ANY OTHER AUTHORS OR DEVELOPERS OF THIS SPECIFICATION OR OTHER DOCUMENT. THE INFORMATION CONTAINED HEREIN IS PROVIDED ON AN "AS IS" BASIS, AND TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW, THE OPEN CONNECTIVITY FOUNDATION, INC., AS WELL AS THE AUTHORS AND DEVELOPERS OF THIS SPECIFICATION OR OTHER DOCUMENT HEREBY DISCLAIM ALL OTHER WARRANTIES AND CONDITIONS, EITHER EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT NOT LIMITED TO, ANY IMPLIED WARRANTIES, DUTIES OR CONDITIONS OF MERCHANTABILITY, OF FITNESS FOR A PARTICULAR PURPOSE, OF ACCURACY OR COMPLETENESS, OF RESULTS, OF WORKMANLIKE EFFORT, OF LACK OF VIRUSES, OF LACK OF NEGLIGENCE OR NON-INFRINGEMENT.