OCF SPECIFICATION 1.0
Individual files included in above single .zip package:
This specifies the OCF core architecture, core features, and protocols to enable OCF profiles implementation for Internet of Things (IoT) usages and ecosystems. The OCF architecture is based on the Resource Orientated REST architectural style. OCF Framework of core features is described and a resource model to construct resource instance is defined in detail. Additional functional interactions (CRUDN, Messaging, Discovery, Monitoring, and Maintenance) and necessary resources for transaction are specified. Various vertical specifications (e.g., Smart Home or Healthcare) use the models and procedures defined in this document.
Download the OCF 1.0.0 Core Specification.
The Security specification includes device onboarding with a trusted onboarding tool within the IoT network; including mechanisms for onboarding devices with different cryptographic capabilities. The document also defines security resources needed for secure functions within the OCF resource-oriented architecture as well as access control mechanisms for protecting resources at rest, in use, and in transit. In particular, it defines mechanisms to handle OCF resources hosted by devices and authentication and authorization for secure exchanges between different devices.
Download the OCF 1.0.0 Security Specification.
The Bridging specification specifies a framework for translation between devices in OCF and non-OCF ecosystems. It specifies general requirements for resource discovery, message translation, security, and handling of multiple bridges. Further, it provides specific requirements for translation between OCF and AllJoyn ecosystems including mapping of core resources, propagation of errors, and algorithmically translating custom resource types; and it refers to OCF to AllJoyn Mapping specification for translating well-known resource types.
Download the OCF 1.0.0 Bridging Specification.
The Resource Type specification specifies a base resource schema for all OCF resources and a set of resources that are built on this base schema that may be exposed by OCF 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; the specification further provides these resource definitions using Swagger2.0. These resources enable modeling of key Use Cases including: Device Control, Notification, Environment Sensing and Control, Energy Management and Energy Saving.
Download the OCF 1.0.0 Resource Type Specification.
Smart Home Device
The Smart Home Device specification defines a set of Device Types for use in the Smart Home vertical by making use of functionality defined in the OCF Core Specification where implementation choices exist in the areas of: messaging protocol and network layer. For the Device Types defined, the document specifies which resources are mandatory to be implemented, noting that all OCF defined resources may optionally be exposed by an OCF Device.
Download the OCF 1.0.0 Smart Home Specification.
Resource to AllJoyn Interface Mapping
The OCF Resource to AllJoyn Interface Mapping specification provides detailed mapping information to provide equivalency between AllJoyn defined Interfaces and OCF defined Resources. The specification provides mapping for Device Types (AllJoyn to/from OCF), identifies equivalent OCF Resources for both mandatory and optional AllJoyn interfaces and for each interface defines the detailed Property by Property mapping using OCF defined extensions to JSON schema to programmatically define mappings.
Download the OCF 1.0.0 Resource to AllJoyn Interface Mapping Specification.
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/
Supplemental Spec Resources
On August 18, 2017, the Open Connectivity Foundation, Inc. posted the following specifications for 60-day member IP review. The review period closed on October 17, 2017 at 5:00pm Pacific Time. These documents are now under review by the relevant Work Groups.
Draft Specifications for 60-day Member IP Review
- OCF 1.3 Core Specification
- OCF 1.3 Security Specification
- OCF 1.3 Resource Type Specification
- OCF 1.3 Smart Home Device Specification
- OCF 1.3 Bridging Specification
Each member shall have sixty (60) days to review the above referenced Draft Specifications pursuant to the terms of the Open Connectivity Foundation, Inc.’s Intellectual Policy Rights Policy (the “IPR Policy”). Pursuant to Section 4.2 of the IPR Policy, Members seeking to exclude Necessary Claims from the Royalty Free License Grant in accordance with Section 4.1 of the IPR Policy must provide a complete and timely written notice of such intent (an “RF Exclusion Notice”) to the Executive Director utilizing the form attached hereto no later than the deadline noted above.
Any comments received during this review period will be posted in the members-only website at: https://workspace.openconnectivity.org/kws/docsreview/.
For any questions related to these drafts or the IP review, please contact OCF Administration.
Published Specification Legal Disclaimer
Copyright © 2016-2017 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.
Draft Candidate Specification Legal Disclaimer
THESE ARE DRAFT SPECIFICATIONS ONLY AND HAVE NOT BEEN ADOPTED BY THE OPEN CONNECTIVITY FOUNDATION. THESE DRAFT SPECIFICATIONS MAY NOT BE RELIED UPON FOR ANY PURPOSE OTHER THAN REVIEW OF THE CURRENT STATE OF THE DEVELOPMENT OF THESE DRAFT SPECIFICATIONS. THE OPEN CONNECTIVITY FOUNDATION AND ITS MEMBERS RESERVE THE RIGHT WITHOUT NOTICE TO YOU TO CHANGE ANY OR ALL PORTIONS HEREOF, DELETE PORTIONS HEREOF, MAKE ADDITIONS HERETO, DISCARD THESE DRAFT SPECIFICATIONS IN ITS ENTIRETY OR OTHERWISE MODIFY THESE DRAFT SPECIFICATIONS AT ANY TIME. YOU SHOULD NOT AND MAY NOT RELY UPON THESE DRAFT SPECIFICATIONS IN ANY WAY, INCLUDING BUT NOT LIMITED TO THE DEVELOPMENT OF ANY PRODUCTS OR SERVICES. IMPLEMENTATION OF THESE DRAFT SPECIFICATIONS IS DONE AT YOUR OWN RISK AMEND AND IT IS NOT SUBJECT TO ANY LICENSING GRANTS OR COMMITMENTS UNDER THE OPEN CONNECTIVITY FOUNDATION INTELLECTUAL PROPERTY RIGHTS POLICY OR OTHERWISE. IN CONSIDERATION OF THE OPEN CONNECTIVITY FOUNDATION GRANTING YOU ACCESS TO THESE DRAFT SPECIFICATIONS, YOU DO HEREBY WAIVE ANY AND ALL CLAIMS ASSOCIATED HEREWITH INCLUDING BUT NOT LIMITED TO THOSE CLAIMS DISCUSSED BELOW, AS WELL AS CLAIMS OF DETRIMENTAL RELIANCE.
The OCF logo is a trademark of Open Connectivity Foundation, Inc. in the United States or other countries. *Other names and brands may be claimed as the property of others.
Copyright © 2016-2017 Open Connectivity Foundation, Inc. All rights reserved.
Copying or other form of reproduction and/or distribution of these works are strictly prohibited.