ISO/IEC 30118-5:2021
(Main)Information technology — Open Connectivity Foundation (OCF) Specification — Part 5: OCF device specification
Information technology — Open Connectivity Foundation (OCF) Specification — Part 5: OCF device specification
The Device definitions use Resource definitions from ISO/IEC 30118-4. This document is built on top of ISO/IEC 30118-1. ISO/IEC 30118-1 specifies the core architecture, interfaces protocols and services to enable the implementation of profiles for IoT usages and ecosystems. ISO/IEC 30118-1 also defines the main architectural components of network connectivity, discovery, data transmission, device & service management and ID & security. The core architecture is scalable to support simple devices (constrained devices) and more capable devices (smart devices).
Technologies de l'information — Specification de la Fondation pour la connectivité ouverte (Fondation OCF) — Partie 5: Spécification des appareils OCF
General Information
Relations
Buy Standard
Standards Content (Sample)
INTERNATIONAL ISO/IEC
STANDARD 30118-5
Second edition
2021-10
Information technology — Open
Connectivity Foundation (OCF)
Specification —
Part 5:
OCF device specification
Technologies de l'information — Specification de la Fondation pour la
connectivité ouverte (Fondation OCF) —
Partie 5: Spécification des appareils OCF
Reference number
ISO/IEC 30118-5:2021(E)
© ISO/IEC 2021
---------------------- Page: 1 ----------------------
ISO/IEC 30118-5:2021(E)
COPYRIGHT PROTECTED DOCUMENT
© 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
---------------------- Page: 2 ----------------------
ISO/IEC 30118-5:2021(E)
Contents Page
Foreword . v
Introduction . vi
1 Scope . 1
2 Normative references . 1
3 Terms, definitions and abbreviated terms . 2
3.1 Terms and definitions . 2
3.2 Symbols and abbreviated terms . 2
4 Document conventions and organization . 2
4.1 Conventions . 2
4.2 Notation . 3
4.3 Data types . 3
4.4 Document structure . 3
5 Operational scenarios . 4
5.1 Document version . 4
6 Core Resource model . 5
6.1 Introduction . 5
6.2 Device Type . 5
6.3 Profile of ISO/IEC 30118-1 . 5
rd
6.4 Third (3 ) party specified extensions . 6
6.5 Semantic Tags . 7
6.5.1 Introduction . 7
6.5.2 "tag-pos-desc" or position description Semantic Tag . 7
6.5.3 "tag-func-desc" or function description Semantic Tag . 7
7 Modelling of multiple logical Devices . 7
7.1 Introduction . 7
7.2 Single platform model . 7
7.3 Multi-platform model . 8
7.4 Composite Device model . 8
8 Discovery . 10
8.1 Endpoint discovery . 10
8.2 Resource discovery . 10
9 Security . 10
Annex A (normative) Device categories and device types . 12
A.1 Device categories . 12
A.2 Device Types . 12
Annex B (normative) Smart home Device Types . 18
B.1 Smart home required Resources per Device Type . 18
B.2 Standardized enumeration values . 21
B.2.1 Introduction . 21
B.2.2 Alphabetical list of standardized enumeration types . 21
B.2.3 Standardized list of supported values for mode Resource Type
(oic.r.mode) . 27
B.2.4 Standardized list of supported values for operational state Resource Type
(oic.r.operational.state) . 30
© ISO/IEC 2021 – All rights reserved iii
---------------------- Page: 3 ----------------------
ISO/IEC 30118-5:2021(E)
B.2.5 Standardized list of supported values for consumable and consumable
collection Resource Types (oic.r.consumable,
oic.r.consumablecollection) . 36
B.3 Camera media format (oic.r.media) . 37
B.4 Additional requirements per Device Type . 38
B.4.1 Additional requirements for Television Devices ("oic.d.tv") . 38
Annex C (normative) Healthcare Device Types . 39
C.1 Scope . 39
C.2 Introduction to OCF healthcare Devices . 39
C.3 Operational scenarios . 39
C.4 Standardized Device Types . 40
C.4.1 Introduction . 40
C.4.2 Blood pressure monitor . 42
C.4.3 Glucose meter . 42
C.4.4 Body scale . 43
C.4.5 Body thermometer . 44
C.4.6 Heart rate monitor . 45
C.4.7 Pulse oximeter . 46
C.4.8 Sleep monitor . 47
C.4.9 Activity tracker . 48
C.4.10 CGM (Continuous Glucose Meter) . 48
C.4.11 Cycling power meter . 50
C.4.12 Cycling speed sensor . 50
C.4.13 Cycling cadence sensor . 51
C.4.14 Muscle oxygen monitor . 51
C.4.15 Body composition analyser . 52
Annex D (normative) Industrial Device Types . 54
D.1 Operational scenarios . 54
D.2 Industrial required Resources per Device Type . 57
Annex E (normative) PV (Photovoltaic) system Device Types . 58
E.1 Scope . 58
E.2 Operational scenarios . 58
E.3 Standard Device Types . 60
iv © ISO/IEC 2021 – All rights reserved
---------------------- Page: 4 ----------------------
ISO/IEC 30118-5:2021(E)
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 Device 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-5:2018), which has been technically
revised.
The main changes compared to the previous edition are as follows:
— renaming of smarthome to generic applicable device specification;
— addition of new device types and classification of devices;
— 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 v
---------------------- Page: 5 ----------------------
ISO/IEC 30118-5:2021(E)
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
vi © ISO/IEC 2021 – All rights reserved
---------------------- Page: 6 ----------------------
ISO/IEC 30118-5:2021(E)
– 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 vii
---------------------- Page: 7 ----------------------
INTERNATIONAL STANDARD ISO/IEC 30118-5:2021(E)
Information technology — Open Connectivity
Foundation (OCF) Specification —
Part 5:
OCF device specification
1 Scope
The Device definitions use Resource definitions from ISO/IEC 30118-4.
This document is built on top of ISO/IEC 30118-1. ISO/IEC 30118-1 specifies the core architecture,
interfaces protocols and services to enable the implementation of profiles for IoT usages and
ecosystems. ISO/IEC 30118-1 also defines the main architectural components of network connectivity,
discovery, data transmission, device & service management and ID & security. The core architecture
is scalable to support simple devices (constrained devices) and more capable devices (smart devices).
2 Normative references
The following documents are referred to in the text in such a way that some or all of their content
constitutes requirements of this document. For dated references, only the edition cited applies. For
undated references, the latest edition of the referenced document (including any amendments) applies.
ISO/IEC 30118-1, Information technology -- Open Connectivity Foundation (OCF) Specification --
Part 1: Core specification
https://www.iso.org/standard/53238.html
ISO/IEC 30118-2, Information technology -- Open Connectivity Foundation (OCF) Specification --
Part 2: Security specification
https://www.iso.org/standard/74239.html
ISO/IEC 30118-4, Information technology -- Open Connectivity Foundation (OCF) Specification --
Part 4: Resource type specification
https://www.iso.org/standard/74241.html
Latest version available at:
ISO/IEC 61850-7-1, Communication networks and systems for power utility automation -- Part 7-1:
Basic communication structure -- Principles and models
https://webstore.iec.ch/publication/6014
OpenAPI specification, fka Swagger RESTful API Documentation Specification, Version 2.0
https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md
IETF RFC 4566, SDP: Session Description Protocol, July 2006
https://tools.ietf.org/html/rfc4566
Draft Report: A Basic Classification System for Energy-Using Products--Universal Device
Classification, December 2013
https://eta-intranet.lbl.gov/sites/default/files/lbnl-classification-v1.pdf
© ISO/IEC 2021 – All rights reserved 1
---------------------- Page: 8 ----------------------
ISO/IEC 30118-5:2021(E)
3 Terms, definitions and abbreviated terms
3.1 Terms and definitions
For the purposes of this document, the terms and definitions given in ISO/IEC 30118-1 and ISO/IEC
30118-2 and 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
Actuator
Resource with support of the UPDATE operation.
3.1.2
Sensor
Resource without support of the UPDATE operation.
3.1.3
Healthcare Device
Device that is conformant to the normative requirements contained in Annex C of this document.
3.2 Symbols and abbreviated terms
CGM Continuous Glucose Monitor
CRUDN Create Retrieve Update Delete Notify
CSV Comma Separated Value
NREM Non Rapid Eye Movement
REM Rapid Eye Movement
REST Representational State Transfer
SDP Session Description Protocol
UDC Universal Device Classification
4 Document conventions and organization
4.1 Conventions
In this document a number of terms, conditions, mechanisms, sequences, parameters, events, states,
or similar terms are printed with the first letter of each word in uppercase and the rest lowercase (e.g.,
Network Architecture). Any lowercase uses of these words have the normal technical English meaning.
In this document, to be consistent with the IETF usages for RESTful operations, the RESTful operation
words CRUDN, CREATE, RETRIVE, UPDATE, DELETE, and NOTIFY will have all letters capitalized.
Any lowercase uses of these words have the normal technical English meaning.
2 © ISO/IEC 2021 – All rights reserved
---------------------- Page: 9 ----------------------
ISO/IEC 30118-5:2021(E)
4.2 Notation
In this document, features are described as required, recommended, allowed or DEPRECATED as
follows:
Required (or shall or mandatory).
These basic features shall be implemented. The phrases "shall not", and "PROHIBITED" indicate
behaviour that is prohibited, i.e. that if performed means the implementation is not in compliance.
Recommended (or should).
These features add functionality supported by a Device and should be implemented.
Recommended features take advantage of the capabilities a Device, usually without imposing major
increase of complexity. Notice that for compliance testing, if a recommended feature is
implemented, it shall meet the specified requirements to be in compliance with these guidelines.
Some recommended features could become requirements in the future. The phrase "should not"
indicates behaviour that is permitted but not recommended.
Allowed (or allowed).
These features are neither required nor recommended by a Device, but if the feature is
implemented, it shall meet the specified requirements to be in compliance with these guidelines.
Conditionally allowed (CA).
The definition or behaviour depends on a condition. If the specified condition is met, then the
definition or behaviour is allowed, otherwise it is not allowed.
Conditionally required (CR).
The definition or behaviour depends on a condition. If the specified condition is met, then the
definition or behaviour is required. Otherwise the definition or behaviour is allowed as default
unless specifically defined as not allowed.
DEPRECATED
Although these features are still described in this document, they should not be implemented except
for backward compatibility. The occurrence of a deprecated feature during operation of an
implementation compliant with the current document has no effect on the implementation’s
operation and does not produce any error conditions. Backward compatibility may require that a
feature is implemented and functions as specified but it shall never be used by implementations
compliant with this document.
Strings that are to be taken literally are enclosed in "double quotes".
Words that are emphasized are printed in italic.
4.3 Data types
See ISO/IEC 30118-1.
4.4 Document structure
This document describes specific requirements governing the indication of Device Types on Devices
and the requirements that are associated with specific Device Types themselves. The document makes
use of functionality defined in the ISO/IEC 30118-1 and ISO/IEC 30118-4.
Annex A specifies the Device Types that shall be used by an OCF Device.
© ISO/IEC 2021 – All rights reserved 3
---------------------- Page: 10 ----------------------
ISO/IEC 30118-5:2021(E)
Annex B specifies the profiles that that shall be used by an OCF Device that is part of the Smart Home
vertical.
Annex C specifies the profiles that shall be used by an OCF Device that is part of the Healthcare
vertical.
Annex D specifies the profiles that shall be used by an OCF Device that is part of the Industrial vertical.
Annex E specifies the profiles that shall be used by an OCF Device that is part of a Photovoltaic system.
This document further describes which constructs are used for a Device and which Resources are
mandated to be implemented for each Device. A typical Device consisting of data elements defined in
the referenced documents is depicted in Figure 1.
Figure 1 – Device building blocks
5 Operational scenarios
5.1 Document version
All Devices conformant to this document shall add the string "ocf.sh.1.3.0" to the dmv Property in
oic.wk.d. This Property is for legacy Device support only and will no longer be revised in alignment
with document versions.
4 © ISO/IEC 2021 – All rights reserved
---------------------- Page: 11 ----------------------
ISO/IEC 30118-5:2021(E)
6 Core Resource model
6.1 Introduction
The Core Resource model is described in ISO/IEC 30118-1.
6.2 Device Type
The Device Types of all devices shall have a Resource Type name ("rt") prefixed with "oic.d."
Examples of Device Types are:
– oic.d.fan
– oic.d.thermostat
The full list of defined Device names and types are in Table A.2, Annex B, Annex C, Annex D, and
Annex E detail the minimal Resource(s) that a Device shall implement for a specific Device Type where
rd
required by a vertical. A Device may expose additional OCF and 3 party defined Resources other
than those indicated in these Annexes.
ISO/IEC 30118-1 defines a Device Resource with a URI of "/oic/d". A Device shall include in the
"Resource Type" Property of "/oic/d" the Device Type (or Device Types) from Table A.2 of the physical
device hosting the Server; the inclusion of the Device Type shall be done using one of the methods
provided by clause 11.3.4 of ISO/IEC 30118-1 (i.e. add to the array of values).
ISO/IEC 30118-1 supports the inclusion of a Device Type as part of the Resource Type of a Collection
(see also clause 7.4), in such cases the Collection shall include the Resource Types defined as
mandatory for the Device Type by this document. For example, if a Collection Resource has an "rt"
value of ["oic.d.light"], the Collection includes an instance of "oic.r.switch.binary" which is mandatory
for an "oic.d.light" as per clause B.1.
Therefore a Device may be discovered by adding a query for the "rt" of the Device Type itself (e.g.
"?rt=oic.d.fan") to the multicast Endpoint discovery method (see 8.1).
6.3 Profile of ISO/IEC 30118-1
This clause describes the profiling of the Core Resources and transport mechanisms and functions
that are defined in ISO/IEC 30118-1.
The required ISO/IEC 30118-1 Resources are also required for a profile implementation.
In addition to the required Resources the optional ISO/IEC 30118-1 Resources in Table 1 shall be
required.
Table 1 – Required Resources for Devices
Resource ("rt") Required in Profile
Intentionally left blank Intentionally left blank
For each of the Resources listed in Table 1, Table 2 details the Properties within those Resources that
shall be required.
© ISO/IEC 2021 – All rights reserved 5
---------------------- Page: 12 ----------------------
ISO/IEC 30118-5:2021(E)
Table 2 – Required properties in Resource
Resource ("rt") Property name Required in Profile
Intentionally left blank Intentionally left blank Intentionally left blank
A Device shall support CoAP based endpoint discovery as defined in clause 10.3 of ISO/IEC 30118-1.
The messaging protocol for a Device shall be CoAP (see ISO/IEC 30118-1).
A Device shall support a network layer as defined in clause 9 of ISO/IEC 30118-1 including any
necessary defined bridging functions that ensure inter-operability with IPv6.
rd
6.4 Third (3 ) party specified extensions
rd rd
This clause describes how a 3 party may add Device Types, Resource Types, 3 party defined
rd rd
Properties to an existing or 3 party defined Resource Type, 3 party defined enumeration values to
rd
an existing enumeration and 3 party defined Parameters to an existing defined Property.
rd rd
A 3 party may specify additional (non-OCF) Resources within an OCF Device. A 3 party may also
rd
specify additional Properties within an existing OCF defined Resource Type. Further a 3 party may
rd
extend an OCF defined enumeration with 3 party defined values.
rd rd
A 3 party defined Device Type may expose both 3 party and OCF defined Resource Types. A
rd
3 party defined Device Type must expose the mandatory Resources for all OCF Devices defined
within this document.
rd
A 3 party defined Resource Type shall include any mandatory Properties defined in this document
rd
and also any vertical specified mandatory Properties. All Properties defined within a 3 party defined
Resource Type that are part of the OCF namespace that are not Common Properties as defined in this
rd
document shall follow the 3 party defined Property rules in Table 3.
rd
Table 3 defines the syntax rules for 3 party defined Resource Type elements. Within the table the
rd
term "Domain_Name" refers to a domain name that is owned by the 3 party that is defining the new
element.
Table 3 – 3rd party defined Resource elements
Resource Element Vendor Definition Rules
rd
New 3 party defined Device Type "rt" Property Value of "/oic/d" "x..
identification>"
rd
New 3 party defined Resource "rt" Property Value "x..
Type identification>"
rd
New 3 party defined Property within Property Name "x.."
the OCF namespace
rd
Additional 3 party defined values in Enumeration Property Value "x.."
an OCF specified enumeration
rd
Additional 3 party defined Parameter key word x..
Parameter in an OCF specified keyword>
Property
With respect to the use of the Domain_Name in this scheme the
...
INTERNATIONAL ISO/IEC
STANDARD 30118-5
Second edition
Information technology — Open
Connectivity Foundation (OCF)
Specification —
Part 5:
Smart home device specification
Technologies de l'information — Spécification de la Fondation pour la
connectivité ouverte (Fondation OCF) —
Partie 5: Spécification des appareils pour applications domotiques
PROOF/ÉPREUVE
Reference number
ISO/IEC 30118-5:2021(E)
©
ISO/IEC 2021
---------------------- Page: 1 ----------------------
ISO/IEC 30118-5:2021(E)
COPYRIGHT PROTECTED DOCUMENT
© 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 PROOF/ÉPREUVE © ISO/IEC 2021 – All rights reserved
---------------------- Page: 2 ----------------------
ISO/IEC 30118-5:2021(E)
Contents Page
Foreword . v
Introduction . vi
1 Scope . 1
2 Normative references . 1
3 Terms, definitions and abbreviated terms . 2
3.1 Terms and definitions . 2
3.2 Symbols and abbreviated terms . 2
4 Document conventions and organization . 2
4.1 Conventions . 2
4.2 Notation . 3
4.3 Data types . 3
4.4 Document structure . 3
5 Operational scenarios . 4
5.1 Document version . 4
6 Core Resource model . 5
6.1 Introduction . 5
6.2 Device Type . 5
6.3 Profile of ISO/IEC 30118-1 . 5
rd
6.4 Third (3 ) party specified extensions . 6
6.5 Semantic Tags . 7
6.5.1 Introduction . 7
6.5.2 "tag-pos-desc" or position description Semantic Tag . 7
6.5.3 "tag-func-desc" or function description Semantic Tag . 7
7 Modelling of multiple logical Devices . 7
7.1 Introduction . 7
7.2 Single platform model . 7
7.3 Multi-platform model . 8
7.4 Composite Device model . 8
8 Discovery . 10
8.1 Endpoint discovery . 10
8.2 Resource discovery . 10
9 Security . 10
Annex A (normative) Device categories and device types . 12
A.1 Device categories . 12
A.2 Device Types . 12
Annex B (normative) Smart home Device Types . 18
B.1 Smart home required Resources per Device Type . 18
B.2 Standardized enumeration values . 21
B.2.1 Introduction . 21
B.2.2 Alphabetical list of standardized enumeration types . 21
B.2.3 Standardized list of supported values for mode Resource Type
(oic.r.mode) . 27
B.2.4 Standardized list of supported values for operational state Resource Type
(oic.r.operational.state) . 30
© ISO/IEC 2021 – All rights reserved iii
---------------------- Page: 3 ----------------------
ISO/IEC 30118-5:2021(E)
B.2.5 Standardized list of supported values for consumable and consumable
collection Resource Types (oic.r.consumable,
oic.r.consumablecollection) . 36
B.3 Camera media format (oic.r.media) . 37
B.4 Additional requirements per Device Type . 38
B.4.1 Additional requirements for Television Devices ("oic.d.tv") . 38
Annex C (normative) Healthcare Device Types . 39
C.1 Scope . 39
C.2 Introduction to OCF healthcare Devices . 39
C.3 Operational scenarios . 39
C.4 Standardized Device Types . 40
C.4.1 Introduction . 40
C.4.2 Blood pressure monitor . 42
C.4.3 Glucose meter . 42
C.4.4 Body scale . 43
C.4.5 Body thermometer . 44
C.4.6 Heart rate monitor . 45
C.4.7 Pulse oximeter . 46
C.4.8 Sleep monitor . 47
C.4.9 Activity tracker . 48
C.4.10 CGM (Continuous Glucose Meter) . 48
C.4.11 Cycling power meter . 50
C.4.12 Cycling speed sensor . 50
C.4.13 Cycling cadence sensor . 51
C.4.14 Muscle oxygen monitor . 51
C.4.15 Body composition analyser . 52
Annex D (normative) Industrial Device Types . 54
D.1 Operational scenarios . 54
D.2 Industrial required Resources per Device Type . 57
Annex E (normative) PV (Photovoltaic) system Device Types . 58
E.1 Scope . 58
E.2 Operational scenarios . 58
E.3 Standard Device Types . 60
iv © ISO/IEC 2021 – All rights reserved
---------------------- Page: 4 ----------------------
ISO/IEC 30118-5:2021(E)
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 Device 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-5:2018), which has been technically
revised.
The main changes compared to the previous edition are as follows:
— renaming of smarthome to generic applicable device specification;
— addition of new device types and classification of devices;
— 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 v
---------------------- Page: 5 ----------------------
ISO/IEC 30118-5:2021(E)
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
vi © ISO/IEC 2021 – All rights reserved
---------------------- Page: 6 ----------------------
ISO/IEC 30118-5:2021(E)
– 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 vii
---------------------- Page: 7 ----------------------
INTERNATIONAL STANDARD ISO/IEC 30118-5:2021(E)
Information technology — Open Connectivity
Foundation (OCF) —
Part 5:
Smart home device specification
1 Scope
The Device definitions use Resource definitions from ISO/IEC 30118-4.
This document is built on top of ISO/IEC 30118-1. ISO/IEC 30118-1 specifies the core architecture,
interfaces protocols and services to enable the implementation of profiles for IoT usages and
ecosystems. ISO/IEC 30118-1 also defines the main architectural components of network connectivity,
discovery, data transmission, device & service management and ID & security. The core architecture
is scalable to support simple devices (constrained devices) and more capable devices (smart devices).
2 Normative references
The following documents are referred to in the text in such a way that some or all of their content
constitutes requirements of this document. For dated references, only the edition cited applies. For
undated references, the latest edition of the referenced document (including any amendments) applies.
ISO/IEC 30118-1, Information technology -- Open Connectivity Foundation (OCF) Specification --
Part 1: Core specification
https://www.iso.org/standard/53238.html
ISO/IEC 30118-2, Information technology -- Open Connectivity Foundation (OCF) Specification --
Part 2: Security specification
https://www.iso.org/standard/74239.html
ISO/IEC 30118-4, Information technology -- Open Connectivity Foundation (OCF) Specification --
Part 4: Resource type specification
https://www.iso.org/standard/74241.html
Latest version available at:
ISO/IEC 61850-7-1, Communication networks and systems for power utility automation -- Part 7-1:
Basic communication structure -- Principles and models
https://webstore.iec.ch/publication/6014
OpenAPI specification, fka Swagger RESTful API Documentation Specification, Version 2.0
https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md
IETF RFC 4566, SDP: Session Description Protocol, July 2006
https://tools.ietf.org/html/rfc4566
Draft Report: A Basic Classification System for Energy-Using Products--Universal Device
Classification, December 2013
https://eta-intranet.lbl.gov/sites/default/files/lbnl-classification-v1.pdf
© ISO/IEC 2021 – All rights reserved 1
---------------------- Page: 8 ----------------------
ISO/IEC 30118-5:2021(E)
3 Terms, definitions and abbreviated terms
3.1 Terms and definitions
For the purposes of this document, the terms and definitions given in ISO/IEC 30118-1 and ISO/IEC
30118-2 and 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
Actuator
Resource with support of the UPDATE operation.
3.1.2
Sensor
Resource without support of the UPDATE operation.
3.1.3
Healthcare Device
Device that is conformant to the normative requirements contained in Annex C of this document.
3.2 Symbols and abbreviated terms
CGM Continuous Glucose Monitor
CRUDN Create Retrieve Update Delete Notify
CSV Comma Separated Value
NREM Non Rapid Eye Movement
REM Rapid Eye Movement
REST Representational State Transfer
SDP Session Description Protocol
UDC Universal Device Classification
4 Document conventions and organization
4.1 Conventions
In this document a number of terms, conditions, mechanisms, sequences, parameters, events, states,
or similar terms are printed with the first letter of each word in uppercase and the rest lowercase (e.g.,
Network Architecture). Any lowercase uses of these words have the normal technical English meaning.
In this document, to be consistent with the IETF usages for RESTful operations, the RESTful operation
words CRUDN, CREATE, RETRIVE, UPDATE, DELETE, and NOTIFY will have all letters capitalized.
Any lowercase uses of these words have the normal technical English meaning.
2 © ISO/IEC 2021 – All rights reserved
---------------------- Page: 9 ----------------------
ISO/IEC 30118-5:2021(E)
4.2 Notation
In this document, features are described as required, recommended, allowed or DEPRECATED as
follows:
Required (or shall or mandatory).
These basic features shall be implemented. The phrases "shall not", and "PROHIBITED" indicate
behaviour that is prohibited, i.e. that if performed means the implementation is not in compliance.
Recommended (or should).
These features add functionality supported by a Device and should be implemented.
Recommended features take advantage of the capabilities a Device, usually without imposing major
increase of complexity. Notice that for compliance testing, if a recommended feature is
implemented, it shall meet the specified requirements to be in compliance with these guidelines.
Some recommended features could become requirements in the future. The phrase "should not"
indicates behaviour that is permitted but not recommended.
Allowed (or allowed).
These features are neither required nor recommended by a Device, but if the feature is
implemented, it shall meet the specified requirements to be in compliance with these guidelines.
Conditionally allowed (CA).
The definition or behaviour depends on a condition. If the specified condition is met, then the
definition or behaviour is allowed, otherwise it is not allowed.
Conditionally required (CR).
The definition or behaviour depends on a condition. If the specified condition is met, then the
definition or behaviour is required. Otherwise the definition or behaviour is allowed as default
unless specifically defined as not allowed.
DEPRECATED
Although these features are still described in this document, they should not be implemented except
for backward compatibility. The occurrence of a deprecated feature during operation of an
implementation compliant with the current document has no effect on the implementation’s
operation and does not produce any error conditions. Backward compatibility may require that a
feature is implemented and functions as specified but it shall never be used by implementations
compliant with this document.
Strings that are to be taken literally are enclosed in "double quotes".
Words that are emphasized are printed in italic.
4.3 Data types
See ISO/IEC 30118-1.
4.4 Document structure
This document describes specific requirements governing the indication of Device Types on Devices
and the requirements that are associated with specific Device Types themselves. The document makes
use of functionality defined in the ISO/IEC 30118-1 and ISO/IEC 30118-4.
Annex A specifies the Device Types that shall be used by an OCF Device.
© ISO/IEC 2021 – All rights reserved 3
---------------------- Page: 10 ----------------------
ISO/IEC 30118-5:2021(E)
Annex B specifies the profiles that that shall be used by an OCF Device that is part of the Smart Home
vertical.
Annex C specifies the profiles that shall be used by an OCF Device that is part of the Healthcare
vertical.
Annex D specifies the profiles that shall be used by an OCF Device that is part of the Industrial vertical.
Annex E specifies the profiles that shall be used by an OCF Device that is part of a Photovoltaic system.
This document further describes which constructs are used for a Device and which Resources are
mandated to be implemented for each Device. A typical Device consisting of data elements defined in
the referenced documents is depicted in Figure 1.
Figure 1 – Device building blocks
5 Operational scenarios
5.1 Document version
All Devices conformant to this document shall add the string "ocf.sh.1.3.0" to the dmv Property in
oic.wk.d. This Property is for legacy Device support only and will no longer be revised in alignment
with document versions.
4 © ISO/IEC 2021 – All rights reserved
---------------------- Page: 11 ----------------------
ISO/IEC 30118-5:2021(E)
6 Core Resource model
6.1 Introduction
The Core Resource model is described in ISO/IEC 30118-1.
6.2 Device Type
The Device Types of all devices shall have a Resource Type name ("rt") prefixed with "oic.d."
Examples of Device Types are:
– oic.d.fan
– oic.d.thermostat
The full list of defined Device names and types are in Table A.2, Annex B, Annex C, Annex D, and
Annex E detail the minimal Resource(s) that a Device shall implement for a specific Device Type where
rd
required by a vertical. A Device may expose additional OCF and 3 party defined Resources other
than those indicated in these Annexes.
ISO/IEC 30118-1 defines a Device Resource with a URI of "/oic/d". A Device shall include in the
"Resource Type" Property of "/oic/d" the Device Type (or Device Types) from Table A.2 of the physical
device hosting the Server; the inclusion of the Device Type shall be done using one of the methods
provided by clause 11.3.4 of ISO/IEC 30118-1 (i.e. add to the array of values).
ISO/IEC 30118-1 supports the inclusion of a Device Type as part of the Resource Type of a Collection
(see also clause 7.4), in such cases the Collection shall include the Resource Types defined as
mandatory for the Device Type by this document. For example, if a Collection Resource has an "rt"
value of ["oic.d.light"], the Collection includes an instance of "oic.r.switch.binary" which is mandatory
for an "oic.d.light" as per clause B.1.
Therefore a Device may be discovered by adding a query for the "rt" of the Device Type itself (e.g.
"?rt=oic.d.fan") to the multicast Endpoint discovery method (see 8.1).
6.3 Profile of ISO/IEC 30118-1
This clause describes the profiling of the Core Resources and transport mechanisms and functions
that are defined in ISO/IEC 30118-1.
The required ISO/IEC 30118-1 Resources are also required for a profile implementation.
In addition to the required Resources the optional ISO/IEC 30118-1 Resources in Table 1 shall be
required.
Table 1 – Required Resources for Devices
Resource ("rt") Required in Profile
Intentionally left blank Intentionally left blank
For each of the Resources listed in Table 1, Table 2 details the Properties within those Resources that
shall be required.
© ISO/IEC 2021 – All rights reserved 5
---------------------- Page: 12 ----------------------
ISO/IEC 30118-5:2021(E)
Table 2 – Required properties in Resource
Resource ("rt") Property name Required in Profile
Intentionally left blank Intentionally left blank Intentionally left blank
A Device shall support CoAP based endpoint discovery as defined in clause 10.3 of ISO/IEC 30118-1.
The messaging protocol for a Device shall be CoAP (see ISO/IEC 30118-1).
A Device shall support a network layer as defined in clause 9 of ISO/IEC 30118-1 including any
necessary defined bridging functions that ensure inter-operability with IPv6.
rd
6.4 Third (3 ) party specified extensions
rd rd
This clause describes how a 3 party may add Device Types, Resource Types, 3 party defined
rd rd
Properties to an existing or 3 party defined Resource Type, 3 party defined enumeration values to
rd
an existing enumeration and 3 party defined Parameters to an existing defined Property.
rd rd
A 3 party may specify additional (non-OCF) Resources within an OCF Device. A 3 party may also
rd
specify additional Properties within an existing OCF defined Resource Type. Further a 3 party may
rd
extend an OCF defined enumeration with 3 party defined values.
rd rd
A 3 party defined Device Type may expose both 3 party and OCF defined Resource Types. A
rd
3 party defined Device Type must expose the mandatory Resources for all OCF Devices defined
within this document.
rd
A 3 party defined Resource Type shall include any mandatory Properties defined in this document
rd
and also any vertical specified mandatory Properties. All Properties defined within a 3 party defined
Resource Type that are part of the OCF namespace that are not Common Properties as defined in this
rd
document shall follow the 3 party defined Property rules in Table 3.
rd
Table 3 defines the syntax rules for 3 party defined Resource Type elements. Within the table the
rd
term "Domain_Name" refers to a domain name that is owned by the 3 party that is defining the new
element.
Table 3 – 3rd party defined Resource elements
Resource Element Vendor Definition Rules
rd
New 3 party defined Device Type "rt" Property Value of "/oic/d" "x..
identification>"
rd
New 3 party defined Resource "rt" Property Value "x..
Type identification>"
rd
New 3 party defined Property within Property Name "x.."
the OCF namespace
rd
Additional 3 party defined values in Enumeration Property Value "x.."
an OCF specified enumeration
rd
Additional 3 party defined Parameter key word x..
Parameter in an OCF specified keyword>
Property
With respect to the use of the Domain_Name in this scheme the labels are revers
...
Questions, Comments and Discussion
Ask us and Technical Secretary will try to provide an answer. You can facilitate discussion about the standard in here.