ISO/IEC 30118-1:2021
(Main)Information technology - Open Connectivity Foundation (OCF) Specification - Part 1: Core specification
Information technology - Open Connectivity Foundation (OCF) Specification - Part 1: Core specification
The OCF Core specifications are divided into a set of documents: Core specification (this document): The Core specification document specifies the Framework, i.e., the OCF core architecture, interfaces, protocols and services to enable OCF profiles implementation for Internet of Things (IoT) usages and ecosystems. This document is mandatory for all Devices to implement. Core optional specification: The Core optional specification document specifies the Framework, i.e., the OCF core architecture, interfaces, protocols and services to enable OCF profiles implementation for Internet of Things (IoT) usages and ecosystems that can optionally be implemented by any Device. Core extension specification(s): The Core extension specification(s) document(s) specifies optional OCF Core functionality that are significant in scope (e.g., Wi-Fi easy setup, Cloud).
Technologies de l'information — Specification de la Fondation pour la connectivité ouverte (Fondation OCF) — Partie 1: Spécification du coeur
General Information
- Status
- Published
- Publication Date
- 17-Oct-2021
- Technical Committee
- ISO/IEC JTC 1 - Information technology
- Drafting Committee
- ISO/IEC JTC 1 - Information technology
- Current Stage
- 6060 - International Standard published
- Start Date
- 18-Oct-2021
- Due Date
- 16-May-2022
- Completion Date
- 18-Oct-2021
Relations
- Effective Date
- 18-Apr-2021
Overview
ISO/IEC 30118-1:2021 - the OCF Core specification - defines the core framework, architecture, interfaces, protocols and services from the Open Connectivity Foundation (OCF) needed to build interoperable Internet of Things (IoT) devices and ecosystems. This Core specification is the mandatory baseline for all OCF Devices; optional Core and Core extension documents provide additional and large-scope features (e.g., Wi‑Fi setup, cloud integration).
Key topics and technical requirements
The standard covers the technical foundation required for consistent, interoperable IoT implementations, including:
- Architecture & Framework
- Core architecture, functional block diagrams and framework organization.
- Identification & Addressing
- Device, platform and resource identification, namespace and IPv6 network addressing considerations.
- Resource Model
- Resource and property definitions, resource types, device types, interfaces, resource representations, collections and links.
- CRUDN (Create, Retrieve, Update, Delete, Notify)
- RESTful interaction model mapped to OCF resource operations and expected server behaviours.
- Discovery & Endpoints
- OCF Endpoint model, implicit and explicit discovery mechanisms (e.g., /oic/res), multicast discovery.
- Messaging & Transport
- Mapping CRUDN to CoAP (including CoAP over TCP), URIs, content-format negotiation, block transfer and keep‑alive behaviour.
- Payload Encoding
- Use of CBOR for compact binary payloads and OCF content-format versioning.
- Network & Connectivity
- IPv6 node requirements and multicast/coAP network considerations.
- Security
- Security considerations and requirements to protect discovery, messaging and resource access.
- Normative resource type definitions
- Annexed resource type definitions and atomic measurement representations.
Practical applications
ISO/IEC 30118-1:2021 is intended to enable interoperable, secure IoT solutions across domains. Typical applications include:
- Smart home devices (lighting, sensors, actuators) implementing a common resource model for cross-vendor control.
- Industrial and building automation where reliable discovery, CRUDN operations and secure messaging are required.
- Gateway and cloud providers implementing OCF protocol mappings and CBOR payload handling.
- Firmware, SDK and platform vendors building OCF-compliant device stacks and interoperability test suites.
Who should use this standard
- IoT device manufacturers and firmware engineers
- Platform and middleware developers
- System integrators and solution architects
- Test labs, compliance and certification bodies
- Security architects evaluating IoT device communication
Related standards and protocols
Relevant technologies referenced in the specification include CoAP, CBOR and IPv6 as the primary messaging, encoding and network layers used by the OCF Core framework. Implementers should consult the Core optional and extension documents for additional features (e.g., cloud, easy setup).
Frequently Asked Questions
ISO/IEC 30118-1:2021 is a standard published by the International Organization for Standardization (ISO). Its full title is "Information technology - Open Connectivity Foundation (OCF) Specification - Part 1: Core specification". This standard covers: The OCF Core specifications are divided into a set of documents: Core specification (this document): The Core specification document specifies the Framework, i.e., the OCF core architecture, interfaces, protocols and services to enable OCF profiles implementation for Internet of Things (IoT) usages and ecosystems. This document is mandatory for all Devices to implement. Core optional specification: The Core optional specification document specifies the Framework, i.e., the OCF core architecture, interfaces, protocols and services to enable OCF profiles implementation for Internet of Things (IoT) usages and ecosystems that can optionally be implemented by any Device. Core extension specification(s): The Core extension specification(s) document(s) specifies optional OCF Core functionality that are significant in scope (e.g., Wi-Fi easy setup, Cloud).
The OCF Core specifications are divided into a set of documents: Core specification (this document): The Core specification document specifies the Framework, i.e., the OCF core architecture, interfaces, protocols and services to enable OCF profiles implementation for Internet of Things (IoT) usages and ecosystems. This document is mandatory for all Devices to implement. Core optional specification: The Core optional specification document specifies the Framework, i.e., the OCF core architecture, interfaces, protocols and services to enable OCF profiles implementation for Internet of Things (IoT) usages and ecosystems that can optionally be implemented by any Device. Core extension specification(s): The Core extension specification(s) document(s) specifies optional OCF Core functionality that are significant in scope (e.g., Wi-Fi easy setup, Cloud).
ISO/IEC 30118-1:2021 is classified under the following ICS (International Classification for Standards) categories: 35.200 - Interface and interconnection equipment. The ICS classification helps identify the subject area and facilitates finding related standards.
ISO/IEC 30118-1:2021 has the following relationships with other standards: It is inter standard links to ISO/IEC 30118-1:2018. Understanding these relationships helps ensure you are using the most current and applicable version of the standard.
You can purchase ISO/IEC 30118-1:2021 directly from iTeh Standards. The document is available in PDF format and is delivered instantly after payment. Add the standard to your cart and complete the secure checkout process. iTeh Standards is an authorized distributor of ISO standards.
Standards Content (Sample)
INTERNATIONAL ISO/IEC
STANDARD 30118-1
Second edition
2021-10
Information technology — Open
Connectivity Foundation (OCF)
Specification —
Part 1:
Core specification
Technologies de l'information — Specification de la Fondation pour la
connectivité ouverte (Fondation OCF) —
Partie 1: Spécification du coeur
Reference number
© ISO/IEC 2021
© ISO/IEC 2021
All rights reserved. Unless otherwise specified, or required in the context of its implementation, no part of this publication may
be reproduced or utilized otherwise in any form or by any means, electronic or mechanical, including photocopying, or posting on
the internet or an intranet, without prior written permission. Permission can be requested from either ISO at the address below
or ISO’s member body in the country of the requester.
ISO copyright office
CP 401 • Ch. de Blandonnet 8
CH-1214 Vernier, Geneva
Phone: +41 22 749 01 11
Email: copyright@iso.org
Website: www.iso.org
Published in Switzerland
ii
© ISO/IEC 2021 – All rights reserved
Contents Page
Foreword . vii
Introduction . viii
1 Scope . 1
2 Normative references . 1
3 Terms, definitions and abbreviated terms . 3
3.1 Terms and definitions . 3
3.2 Symbols and abbreviated terms . 7
4 Document conventions and organization . 8
4.1 Conventions . 8
4.2 Notation . 8
4.3 Data types . 9
4.4 Resource notation syntax . 10
5 Architecture . 11
5.1 Overview . 11
5.2 Principle . 11
5.3 Functional block diagram. 12
5.4 Framework . 14
6 Identification and addressing . 14
6.1 Introduction . 14
6.2 Identification . 15
6.2.1 Device and Platform identification. 15
6.2.2 Resource identification and addressing . 15
6.3 Namespace: . 16
6.4 Network addressing . 16
7 Resource model . 17
7.1 Introduction . 17
7.2 Resource . 17
7.3 Property . 18
7.3.1 Introduction . 18
7.3.2 Common Properties . 19
7.4 Resource Type . 21
7.4.1 Introduction . 21
7.4.2 Resource Type Property . 21
7.4.3 Resource Type definition . 21
7.4.4 Multi-value "rt" Resource . 23
7.5 Device Type . 23
7.6 OCF Interface . 24
7.6.1 Introduction . 24
7.6.2 OCF Interface Property . 24
7.6.3 OCF Interface methods . 25
7.7 Resource representation . 42
7.8 Structure . 42
7.8.1 Introduction . 42
7.8.2 Resource relationships (Links) . 42
7.8.3 Collections . 48
© ISO/IEC 2021 – All rights reserved iii
7.8.4 Atomic Measurement . 50
7.9 Query Parameters . 52
7.9.1 Introduction . 52
7.9.2 Use of multiple parameters within a query . 52
7.9.3 Application to multi-value "rt" Resources . 53
7.9.4 OCF Interface specific considerations for queries . 53
8 CRUDN . 54
8.1 Overview . 54
8.2 CREATE . 54
8.2.1 Overview . 54
8.2.2 CREATE request . 55
8.2.3 Processing by the Server . 55
8.2.4 CREATE response . 55
8.3 RETRIEVE . 56
8.3.1 Overview . 56
8.3.2 RETRIEVE request . 56
8.3.3 Processing by the Server . 56
8.3.4 RETRIEVE response . 56
8.4 UPDATE . 57
8.4.1 Overview . 57
8.4.2 UPDATE request . 57
8.4.3 Processing by the Server . 57
8.4.4 UPDATE response . 58
8.5 DELETE . 58
8.5.1 Overview . 58
8.5.2 DELETE request . 59
8.5.3 Processing by the Server . 59
8.5.4 DELETE response . 59
8.6 NOTIFY . 59
8.6.1 Overview . 59
8.6.2 NOTIFICATION response . 59
9 Network and connectivity . 60
9.1 Introduction . 60
9.2 Architecture . 60
9.3 IPv6 network layer requirements . 61
9.3.1 Introduction . 61
9.3.2 IPv6 node requirements . 62
10 OCF Endpoint . 62
10.1 OCF Endpoint definition . 62
10.2 OCF Endpoint information . 63
10.2.1 Introduction . 63
10.2.2 "ep" . 63
10.2.3 "pri" . 64
10.2.4 "lat" . 64
10.2.5 OCF Endpoint information in "eps" Parameter . 64
10.3 OCF Endpoint discovery . 65
10.3.1 Introduction . 65
10.3.2 Implicit discovery . 65
iv © ISO/IEC 2021 – All rights reserved
10.3.3 Explicit discovery with "/oic/res" response . 65
11 Functional interactions . 67
11.1 Introduction . 67
11.2 Resource discovery . 68
11.2.1 Introduction . 68
11.2.2 Resource based discovery: mechanisms . 68
11.2.3 Resource based discovery: Finding information . 69
11.2.4 Resource discovery using "/oic/res" . 76
11.2.5 Multicast discovery using "/oic/res" . 77
11.3 Notification . 78
11.3.1 Overview . 78
11.3.2 Observe . 78
11.4 Introspection . 79
11.4.1 Overview . 79
11.4.2 Usage of Introspection . 83
11.5 Semantic Tags . 84
11.5.1 Introduction . 84
11.5.2 Semantic Tag definitions . 85
12 Messaging . 87
12.1 Introduction . 87
12.2 Mapping of CRUDN to CoAP . 87
12.2.1 Overview . 87
12.2.2 URIs . 88
12.2.3 CoAP method with request and response . 88
12.2.4 Content-Format negotiation . 89
12.2.5 OCF-Content-Format-Version information . 90
12.2.6 Content-Format policy . 91
12.2.7 CRUDN to CoAP response codes. 92
12.2.8 CoAP block transfer . 92
12.2.9 Generic requirements for CoAP multicast . 92
12.2.10 Setting timeout on response to a confirmable request . 93
12.3 Mapping of CRUDN to CoAP serialization over TCP . 93
12.3.1 Overview . 93
12.3.2 URIs . 93
12.3.3 CoAP method with request and response . 93
12.3.4 Content-Format negotiation . 93
12.3.5 OCF-Content-Format-Version information . 94
12.3.6 Content-Format policy . 94
12.3.7 CRUDN to CoAP response codes. 94
12.3.8 CoAP block transfer . 94
12.3.9 Keep alive (connection health) . 94
12.3.10 CoAP using a proxy . 94
12.4 Payload Encoding in CBOR . 94
13 Security . 95
Annex A (normative) Resource Type definitions . 96
A.1 List of Resource Type definitions . 96
A.2 Atomic Measurement links list representation . 96
A.2.1 Introduction . 96
© ISO/IEC 2021 – All rights reserved v
A.2.2 Example URI . 96
A.2.3 Resource type . 96
A.2.4 OpenAPI 2.0 definition . 96
A.2.5 Property definition . 102
A.2.6 CRUDN behaviour . 103
A.3 Collection . 103
A.3.1 Introduction . 103
A.3.2 Example URI . 103
A.3.3 Resource type . 104
A.3.4 OpenAPI 2.0 definition . 104
A.3.5 Property definition . 110
A.3.6 CRUDN behaviour . 112
A.4 Device . 112
A.4.1 Introduction . 112
A.4.2 Well-known URI . 112
A.4.3 Resource type . 112
A.4.4 OpenAPI 2.0 definition . 112
A.4.5 Property definition . 115
A.4.6 CRUDN behaviour . 116
A.5 Introspection Resource . 116
A.5.1 Introduction . 116
A.5.2 Well-known URI . 116
A.5.3 Resource type . 116
A.5.4 OpenAPI 2.0 definition . 116
A.5.5 Property definition . 118
A.5.6 CRUDN behaviour . 119
A.6 Platform . 119
A.6.1 Introduction . 119
A.6.2 Well-known URI . 119
A.6.3 Resource type . 119
A.6.4 OpenAPI 2.0 definition . 119
A.6.5 Property definition . 122
A.6.6 CRUDN behaviour . 123
A.7 Discoverable Resources . 123
A.7.1 Introduction . 123
A.7.2 Well-known URI . 123
A.7.3 Resource type . 123
A.7.4 OpenAPI 2.0 definition . 123
A.7.5 Property definition . 128
A.7.6 CRUDN behaviour . 129
Annex B (informative) OpenAPI 2.0 Schema Extension . 130
B.1 OpenAPI 2.0 Schema Reference . 130
B.2 OpenAPI 2.0 Introspection empty file . 130
Annex C (normative) Semantic Tag enumeration support . 131
C.1 Introduction . 131
C.2 "tag-pos-desc" supported enumeration . 131
Bibliography . 132
vi © ISO/IEC 2021 – All rights reserved
Foreword
ISO (the International Organization for Standardization) and IEC (the International Electrotechnical
Commission) form the specialized system for worldwide standardization. National bodies that are members of
ISO or IEC participate in the development of International Standards through technical committees established
by the respective organization to deal with particular fields of technical activity. ISO and IEC technical
committees collaborate in fields of mutual interest. Other international organizations, governmental and non-
governmental, in liaison with ISO and IEC, also take part in the work.
The procedures used to develop this document and those intended for its further maintenance are described in
the ISO/IEC Directives, Part 1. In particular, the different approval criteria needed for the different types of
document should be noted (see www.iso.org/directives or www.iec.ch/members_experts/refdocs).
Attention is drawn to the possibility that some of the elements of this document may be the subject of patent
rights. ISO and IEC shall not be held responsible for identifying any or all such patent rights. Details of any
patent rights identified during the development of the document will be in the Introduction and/or on the ISO list
of patent declarations received (see www.iso.org/patents) or the IEC list of patent declarations received
(see patents.iec.ch).
Any trade name used in this document is information given for the convenience of users and does not constitute
an endorsement.
For an explanation of the voluntary nature of standards, the meaning of ISO specific terms and expressions
related to conformity assessment, as well as information about ISO's adherence to the World Trade
Organization (WTO) principles in the Technical Barriers to Trade (TBT), see www.iso.org/iso/foreword.html. In
the IEC, see www.iec.ch/understanding-standards.
This document was prepared by the Open Connectivity Foundation (OCF) (as OCF Core Specification,
version 2.2.0) and drafted in accordance with its editorial rules. It was adopted, under the JTC 1 PAS procedure,
by Joint Technical Committee ISO/IEC JTC 1, Information technology.
This second edition cancels and replaces the first edition (ISO/IEC 30118-1:2018), which has been technically
revised.
The main changes compared to the previous edition are as follows:
— simplification of specification so that it only includes the core functionality;
— additional resusable infrastructure components are now in the core optional specification;
— addition of semantic tags, sleepy devices based on long latency;
— improvements made on CoAP bindings, Error diagnostic payloads, discovery, reset of device and usage
of baseline interfaces;
— addition of clarifications throughout.
A list of all parts in the ISO/IEC 30118 series can be found on the ISO and IEC websites.
Any feedback or questions on this document should be directed to the user’s national standards body. A
complete listing of these bodies can be found at www.iso.org/members.html and www.iec.ch/national-
committees.
© ISO/IEC 2021 – All rights reserved vii
Introduction
This document, and all the other parts associated with this document, were developed in response to
worldwide demand for smart home focused Internet of Things (IoT) devices, such as appliances, door
locks, security cameras, sensors, and actuators; these to be modelled and securely controlled, locally
and remotely, over an IP network.
While some inter-device communication existed, no universal language had been developed for the
IoT. Device makers instead had to choose between disparate frameworks, limiting their market share,
or developing across multiple ecosystems, increasing their costs. The burden then falls on end users
to determine whether the products they want are compatible with the ecosystem they bought into, or
find ways to integrate their devices into their network, and try to solve interoperability issues on their
own.
In addition to the smart home, IoT deployments in commercial environments are hampered by a lack
of security. This issue can be avoided by having a secure IoT communication framework, which this
standard solves.
The goal of these documents is then to connect the next 25 billion devices for the IoT, providing secure
and reliable device discovery and connectivity across multiple OSs and platforms. There are multiple
proposals and forums driving different approaches, but no single solution addresses the majority of
key requirements. This document and the associated parts enable industry consolidation around a
common, secure, interoperable approach.
ISO/IEC 30118 consists of eighteen parts, under the general title Information technology — Open
Connectivity Foundation (OCF) Specification. The parts fall into logical groupings as described herein:
– Core framework
– Part 1: Core Specification
– Part 2: Security Specification
– Part 13: Onboarding Tool Specification
– Bridging framework and bridges
– Part 3: Bridging Specification
– Part 6: Resource to Alljoyn Interface Mapping Specification
– Part 8: OCF Resource to oneM2M Resource Mapping Specification
– Part 14: OCF Resource to BLE Mapping Specification
– Part 15: OCF Resource to EnOcean Mapping Specification
– Part 16: OCF Resource to UPlus Mapping Specification
– Part 17: OCF Resource to Zigbee Cluster Mapping Specification
– Part 18: OCF Resource to Z-Wave Mapping Specification
– Resource and Device models
– Part 4: Resource Type Specification
– Part 5: Device Specification
viii © ISO/IEC 2021 – All rights reserved
– Core framework extensions
– Part 7: Wi-Fi Easy Setup Specification
– Part 9: Core Optional Specification
– OCF Cloud
– Part 10: Cloud API for Cloud Services Specification
– Part 11: Device to Cloud Services Specification
– Part 12: Cloud Security Specification
© ISO/IEC 2021 – All rights reserved ix
INTERNATIONAL STANDARD ISO/IEC 30118-1:2021(E)
Information technology — Open Connectivity
Foundation (OCF) Specification —
Part 1:
Core specification
1 Scope
The OCF Core specifications are divided into a set of documents:
– Core specification (this document): The Core specification document specifies the Framework, i.e.,
the OCF core architecture, interfaces, protocols and services to enable OCF profiles
implementation for Internet of Things (IoT) usages and ecosystems. This document is mandatory
for all Devices to implement.
– Core optional specification: The Core optional specification document specifies the Framework, i.e.,
the OCF core architecture, interfaces, protocols and services to enable OCF profiles
implementation for Internet of Things (IoT) usages and ecosystems that can optionally be
implemented by any Device.
– Core extension specification(s): The Core extension specification(s) document(s) specifies optional
OCF Core functionality that are significant in scope (e.g., Wi-Fi easy setup, Cloud).
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.
ISO 8601, Data elements and interchange formats – Information interchange – Representation of dates
and times, International Standards Organization, December 3, 2004
ISO/IEC DIS 20924, Information Technology – Internet of Things – Vocabulary, June 2018
https://www.iso.org/standard/69470.html
ISO/IEC 30118-2, Information technology – Open Connectivity Foundation (OCF) Specification –
Part 2: Security specification
https://www.iso.org/standard/74239.html
Latest version available at: https://openconnectivity.org/specs/OCF_Security_Specification.pdf
IETF RFC 768, User Datagram Protocol, August 1980
https://www.rfc-editor.org/info/rfc768
IETF RFC 3339, Date and Time on the Internet: Timestamps, July 2002
https://www.rfc-editor.org/info/rfc3339
IETF RFC 3986, Uniform Resource Identifier (URI): General Syntax, January 2005.
https://www.rfc-editor.org/info/rfc3986
© ISO/IEC 2021 – All rights reserved 1
IETF RFC 4122, A Universally Unique IDentifier (UUID) URN Namespace, July 2005
https://www.rfc-editor.org/info/rfc4122
IETF RFC 4287, The Atom Syndication Format, December 2005,
https://www.rfc-editor.org/info/rfc4287
IETF RFC 4941, Privacy Extensions for Stateless Address Autoconfiguration in IPv6, September 2007
https://www.rfc-editor.org/info/rfc4941
IETF RFC 5646, Tags for Identifying Languages, September 2009
https://www.rfc-editor.org/info/rfc5646
IETF RFC 6347, Datagram Transport Layer Security Version 1.2, January 2012
https://www.rfc-editor.org/info/rfc6347
IETF RFC 6434, IPv6 Node Requirements, December 2011
https://www.rfc-editor.org/info/rfc6434
IETF RFC 6573, The Item and Collection Link Relations, April 2012
https://www.rfc-editor.org/info/rfc6573
IETF RFC 6690, Constrained RESTful Environments (CoRE) Link Format, August 2012
https://www.rfc-editor.org/info/rfc6690
IETF RFC 7049, Concise Binary Object Representation (CBOR), October 2013
https://www.rfc-editor.org/info/rfc7049
IETF RFC 7084, Basic Requirements for IPv6 Customer Edge Routers, November 2013
https://www.rfc-editor.org/info/rfc7084
IETF RFC 7159, The JavaScript Object Notation (JSON) Data Interchange Format, March 2014
https://www.rfc-editor.org/info/rfc7159
IETF RFC 7252, The Constrained Application Protocol (CoAP), June 2014
https://www.rfc-editor.org/info/rfc7252
IETF RFC 7301, Transport Layer Security (TLS) Application-Layer Protocol Negotiation Extension,
July 2014
https://www.rfc-editor.org/info/rfc7301
IETF RFC 7346, IPv6 Multicast Address Scopes, August 2014
https://www.rfc-editor.org/info/rfc7346
IETF RFC 7595, Guidelines and Registration Procedures for URI Schemes, June 2015
https://www.rfc-editor.org/info/rfc7595
IETF RFC 7641, Observing Resources in the Constrained Application Protocol (CoAP), September
https://www.rfc-editor.org/info/rfc7641
IETF RFC 7721, Security and Privacy Considerations for IPv6 Address Generation Mechanisms,
March 20016
https://www.rfc-editor.org/info/rfc7721
IETF RFC 7959, Block-Wise Transfers in the Constrained Application Protocol (CoAP), August 2016
https://www.rfc-editor.org/info/rfc7959
IETF RFC 8075, Guidelines for Mapping Implementations: HTTP to the Constrained Application
Protocol (CoAP), February 2017
https://www.rfc-editor.org/info/rfc8075
2 © ISO/IEC 2021 – All rights reserved
IETF RFC 8085, UDP Usage Guidelines, March 2017
https://www.rfc-editor.org/info/rfc8085
IETF RFC 8288, Web Linking, October 2017
https://www.rfc-editor.org/info/rfc8288
IETF RFC 8323, CoAP (Constrained Application Protocol) over TCP, TLS, and WebSockets, February
https://www.rfc-editor.org/info/rfc8323
IANA ifType-MIB Definitions
https://www.iana.org/assignments/ianaiftype-mib/ianaiftype-mib
IANA IPv6 Multicast Address Space Registry
http://www.iana.org/assignments/ipv6-multicast-addresses/ipv6-multicast-addresses.xhtml
IANA Link Relations, October 2017
http://www.iana.org/assignments/link-relations/link-relations.xhtml
JSON Schema Validation, JSON Schema: interactive and non-interactive validation, January 2013
http://json-schema.org/draft-04/json-schema-validation.html
OpenAPI specification, fka Swagger RESTful API Documentation Specification, Version 2.0
https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md
3 Terms, definitions and abbreviated terms
3.1 Terms and definitions
For the purposes of this document, the terms and definitions given in the following apply.
ISO and IEC maintain terminological databases for use in standardization at the following addresses:
– ISO Online browsing platform: available at https://www.iso.org/obp.
– IEC Electropedia: available at http://www.electropedia.org/.
3.1.1
Atomic Measurement
design pattern that ensures that the Client (3.1.6) can only access the Properties (3.1.33) of linked
Resources (3.1.31) atomically, that is as a single group
3.1.2
Bridged Client
logical entity that accesses data via a Bridged Protocol (3.1.4)
Note 1 to entry: For example, an AllJoyn Consumer application is a Bridged Client (3.1.2).
3.1.3
Bridged Device
Bridged Client (3.1.2) or Bridged Server (3.1.5)
3.1.4
Bridged Protocol
another protocol (e.g., AllJoyn) that is being translated to or from OCF protocols
© ISO/IEC 2021 – All rights reserved 3
3.1.5
Bridged Server
logical entity that provides data via a Bridged Protocol (3.1.4)
Note 1 to entry: For example an AllJoyn Producer is a Bridged Server (3.1.5).
Note 2 to entry: More than one Bridged Server (3.1.5) can exist on the same physical platform.
3.1.6
Client
logical entity that accesses a Resource (3.1.31) on a Server (3.1.36)
3.1.7
Collection
Resource (3.1.31) that contains zero or more Links (3.1.21)
3.1.8
Common Properties
Properties (3.1.33) specified for all Resources (3.1.31)
3.1.9
Composite Device
Device (3.1.13) that is modelled as multiple Device Types (3.1.14); with each component Device Type
(3.1.14) being exposed as a Collection (3.1.7)
3.1.10
Configuration Source
cloud or service network or a local read-only file which contains and provides configuration related
information to the Devices (3.1.13)
3.1.11
Core Resources
those Resources (3.1.31) that are defined in this document
3.1.12
Default OCF Interface
OCF Interface (3.1.18) used to generate the response when an OCF Interface (3.1.18) is omitted in a
request
3.1.13
Device
logical entity that assumes one or more roles, e.g., Client (3.1.6), Server (3.1.36)
Note 1 to entry: More than one Device (3.1.13) can exist on a Platform (3.1.30).
3.1.14
Device Type
uniquely named definition indicating a minimum set of Resource Types (3.1.34) that a Device (3.1.13)
supports
Note 1 to entry: A Device Type (3.1.14) provides a hint about what the Device (3.1.13) is, such as a light or a
fan, for use during Resource (3.1.31) discovery.
3.1.15
Device UUID
stack instance identifier
4 © ISO/IEC 2021 – All rights reserved
3.1.16
Discoverable Resource
Resource (3.1.31) that is listed in "/oic/res"
3.1.17
OCF Endpoint
entity participating in the OCF protocol, further identified as the source or destination of a request and
response messages for a given Transport Protocol Suite
Note 1 to entry: Example of a Transport Protocol Suite would be CoAP over UDP over IPv6.
3.1.18
Framework
set of related functionalities and interactions defined in this document, which enable interoperability
across a wide range of networked devices, including IoT
3.1.19
OCF Interface
interface description extended by OCF that provides a view to and permissible responses from a
Resource (3.1.31)
[SOURCE: IETF RFC 6690]
3.1.20
Introspection
mechanism to determine the capabilities of the hosted Resources (3.1.31) of a Device (3.1.13)
3.1.21
Introspection Device Data (IDD)
data that describes the payloads per implemented method of the Resources (3.1.31) that make up the
Device (3.1.13)
Note 1 to entry: See 11.4 for all requirements and exceptions.
3.1.22
Links
extends typed web links
[SOURCE: IETF RFC 8288]
3.1.23
Non-Discoverable Resource
Resource (3.1.31) that is not listed in "/oic/res"
Note 1 to entry: The Resource (3.1.31) can be reached by a Link (3.1.21) which is conveyed by another
Resource (3.1.31). For example a Resource (3.1.31) linked in a Collection (3.1.7) does not have to be listed in
"/oic/res", since traversing the Collection (3.1.7) would discover the Resource (3.1.31) implemented on the Device
(3.1.13).
3.1.24
Notification
mechanism to make a Client (3.1.6) aware of state changes in a Resource (3.1.31)
© ISO/IEC 2021 – All rights reserved 5
3.1.25
Observe
act of monitoring a Resource (3.1.31) by sending a RETRIEVE operation which is cached by the Server
(3.1.36) hosting the Resource (3.1.31) and reprocessed on every change to that Resource (3.1.31)
3.1.26
OpenAPI 2.0
Resource (3.1.31) and Intropection Device Data (3.1.20) definitions used in this document
[SOURCE: OpenAPI specification]
3.1.27
Parameter
element that provides metadata about a Resource (3.1.31) referenced by the target URI of a Link
(3.1.21)
3.1.28
Partial UPDATE
UPDATE operation to a Resource (3.1.31) that includes a subset of the Properties (3.1.33) that are
visible via the OCF Interface (3.1.18) being applied for the Resource Type (3.1.34)
3.1.29
Permanent Immutable ID
identity for a Device (3.1.13) that cannot be altered
3.1.30
Physical Device
physical thing on which a Device(s) (3.1.13) is exposed
3.1.31
Platform
Physical Device (3.1.29) containing one or more Devices (3.1.13)
3.1.32
Resource
represents an entity modelled and exposed by the Framework (3.1.17)
3.1.33
Resource Interface
qualification of the permitted requests on a Resource (3.1.31)
3.1.34
Property
significant aspect or Parameter (3.1.26) of a Resource (3.1.31), including metadata, that is exposed
through the Resource (3.1.31)
3.1.35
Resource Type
uniquely named definition of a class of Properties (3.1.33) and the interactions that are supported by
that class
Note 1 to entry: Each Resource (3.1.31) has a Property (3.1.33) "rt" whose value is the unique name of the
Resource Type (3.1.34).
6 © ISO/IEC 2021 – All rights reserved
3.1.36
Secure OCF Endpoint
OCF Endpoint (3.1.16) with a secure connection (e.g., CoAPS)
3.1.37
Semantic Tag
meta-information that provides additional contextual information with regard to the Resource (3.1.31)
that is the target of a Link (3.1.21)
3.1.38
Server
Device (3.1.13) with the role of providing Resource (3.1.31) state information and facilitating remote
interaction with its Resources (3.1.31)
3.1.39
Sleepy Server
Server (3.1.37) that will have latency in responding to requests
3.1.40
Unsecure OCF Endpoint
OCF Endpoint (3.1.16) with an unsecure connection (e.g., CoAP)
3.1.41
Vertical Resource Type
Resource Type (3.1.34) in a vertical domain specification
Note 1 to entry: An example of a Vertical Resource Type (3.1.40) would be "oic.r.switch.binary".
3.2 Symbols and abbreviated terms
ACL Access Control List
BLE Bluetooth Low Energy
CBOR Concise Binary Object Representation
CoAP Constrained Application Protocol
CoAPs Secure Constrained Application Protocol
DTLS Datagram Transport Layer Security
IP Internet Protocol
ISP Internet Service Provider
JSON JavaSc
...










Questions, Comments and Discussion
Ask us and Technical Secretary will try to provide an answer. You can facilitate discussion about the standard in here.
Loading comments...