ETSI TS 118 105 V2.0.0 (2016-09)
oneM2M; Management Enablement (OMA) (oneM2M TS-0005 version 2.0.0 Release 2)
oneM2M; Management Enablement (OMA) (oneM2M TS-0005 version 2.0.0 Release 2)
RTS/oneM2M-000005v200
General Information
Standards Content (Sample)
ETSI TS 118 105 V2.0.0 (2016-09)
TECHNICAL SPECIFICATION
oneM2M;
Management Enablement (OMA)
(oneM2M TS-0005 version 2.0.0 Release 2)
---------------------- Page: 1 ----------------------
oneM2M TS-0005 version 2.0.0 Release 2 2 ETSI TS 118 105 V2.0.0 (2016-09)
Reference
RTS/oneM2M-000005v200
Keywords
IoT, M2M
ETSI
650 Route des Lucioles
F-06921 Sophia Antipolis Cedex - FRANCE
Tel.: +33 4 92 94 42 00 Fax: +33 4 93 65 47 16
Siret N° 348 623 562 00017 - NAF 742 C
Association à but non lucratif enregistrée à la
Sous-Préfecture de Grasse (06) N° 7803/88
Important notice
The present document can be downloaded from:
http://www.etsi.org/standards-search
The present document may be made available in electronic versions and/or in print. The content of any electronic and/or
print versions of the present document shall not be modified without the prior written authorization of ETSI. In case of any
existing or perceived difference in contents between such versions and/or in print, the only prevailing document is the
print of the Portable Document Format (PDF) version kept on a specific network drive within ETSI Secretariat.
Users of the present document should be aware that the document may be subject to revision or change of status.
Information on the current status of this and other ETSI documents is available at
https://portal.etsi.org/TB/ETSIDeliverableStatus.aspx
If you find errors in the present document, please send your comment to one of the following services:
https://portal.etsi.org/People/CommiteeSupportStaff.aspx
Copyright Notification
No part may be reproduced or utilized in any form or by any means, electronic or mechanical, including photocopying
and microfilm except as authorized by written permission of ETSI.
The content of the PDF version shall not be modified without the written authorization of ETSI.
The copyright and the foregoing restriction extend to reproduction in all media.
© European Telecommunications Standards Institute 2016.
All rights reserved.
TM TM TM
DECT , PLUGTESTS , UMTS and the ETSI logo are Trade Marks of ETSI registered for the benefit of its Members.
TM
3GPP and LTE™ are Trade Marks of ETSI registered for the benefit of its Members and
of the 3GPP Organizational Partners.
GSM® and the GSM logo are Trade Marks registered and owned by the GSM Association.
ETSI
---------------------- Page: 2 ----------------------
oneM2M TS-0005 version 2.0.0 Release 2 3 ETSI TS 118 105 V2.0.0 (2016-09)
Contents
Intellectual Property Rights . 6
Foreword . 6
1 Scope . 7
2 References . 7
2.1 Normative references . 7
2.2 Informative references . 8
3 Definitions . 8
4 Conventions . 8
5 OMA DM 1.3 and OMA DM 2.0 . 9
5.1 Mapping of basic data types . 9
5.2 Mapping of Identifiers . 9
5.3 Mapping of resources . 10
5.3.0 Introduction. 10
5.3.1 General Mapping Assumptions . 10
5.3.2 Resource [firmware] . 10
5.3.3 Resource [software] . 10
5.3.4 Resource [memory]. 11
5.3.5 Resource [areaNwkInfo] . 11
5.3.6 Resource [areaNwkDeviceInfo] . 11
5.3.7 Resource [battery] . 12
5.3.8 Resource [deviceInfo] . 12
5.3.9 Resource [deviceCapability] . 13
5.3.10 Resource [reboot] . 13
5.3.11 Resource [eventLog] . 13
5.3.12 Resource [cmdhPolicy] . 14
5.3.12.0 Introduction . 14
5.3.12.1 Resource [activeCmdhPolicy] . 14
5.3.12.2 Resource [cmdhDefaults] . 15
5.3.12.3 Resource [cmdhDefEcValue] . 15
5.3.12.4 Resource [cmdhEcDefParamValues] . 15
5.3.12.5 Resource [cmdhLimits] . 16
5.3.12.6 Resource [cmdhNetworkAccessRules] . 16
5.3.12.7 Resource [cmdhNwAccessRule] . 17
5.3.12.8 Resource [cmdhBuffer] . 17
5.4 Mapping of procedures for management . 17
5.4.1 Mapping for Resource Primitives . 17
5.4.1.1 Create Primitive for Resource . 17
5.4.1.1.0 Introduction . 17
5.4.1.1.1 Create Response Status Code Mapping . 18
5.4.1.2 Retrieve Primitive for Resource . 19
5.4.1.2.0 Introduction . 19
5.4.1.2.1 Retrieve Response Status Code Mapping . 19
5.4.1.3 Update Primitive for Resource . 21
5.4.1.3.0 Introduction . 21
5.4.1.3.1 Update Primitive for Replacing Data in the Management Object . 21
5.4.1.3.2 Update Primitive for Executing Management Commands . 22
5.4.1.4 Delete Primitive for Resource . 24
5.4.1.4.0 Introduction . 24
5.4.1.4.1 Delete Response Status Code Mapping . 24
5.4.1.5 Notify Primitive Mapping . 25
5.4.1.5.0 Introduction . 25
5.4.1.5.1 Subscribe Procedure Mapping for OMA DM 1.3 . 25
5.4.1.5.2 Subscribe Procedure Mapping for OMA DM 2.0 . 25
5.4.1.5.3 Notification Procedure Mapping for OMA DM 1.3 and OMA DM 2.0 . 26
5.4.2 Management Resource Specific Procedure Mapping . 26
ETSI
---------------------- Page: 3 ----------------------
oneM2M TS-0005 version 2.0.0 Release 2 4 ETSI TS 118 105 V2.0.0 (2016-09)
5.4.2.0 Introduction . 26
5.4.2.1 Resource [firmware]. 26
5.4.2.2 Resource [software] . 27
5.4.2.3 Resource [memory] . 28
5.4.2.4 Resource [areaNwkInfo] . 28
5.4.2.5 Resource [areaNwkDeviceInfo] . 28
5.4.2.6 Resource [battery] . 28
5.4.2.7 Resource [deviceInfo] . 28
5.4.2.8 Resource [deviceCapability] . 28
5.4.2.9 Resource [reboot] . 29
5.4.2.10 Resource [eventLog] . 29
5.5 DM Server Interactions . 29
5.5.0 Introduction. 29
5.5.1 Communication Session Establishment . 29
5.5.2 Translation of Requests and Responses between IN-CSE and DM Server. 30
5.5.3 Discovery and Subscription for management objects . 30
5.5.4 Access Control Management . 30
5.6 New Management Objects . 30
5.6.1 M2M CMDH Policies MO (MCMDHMO) . 30
6 OMA Lightweight M2M 1.0 . 40
6.1 Mapping of basic data types . 40
6.2 Mapping of Identifiers . 41
6.2.0 Introduction. 41
6.2.1 Device identifier . 41
6.2.2 Object identifier . 41
6.2.3 Object Instance Identifier . 41
6.3 Mapping of resources . 41
6.2.0 Introduction. 41
6.3.1 General Mapping Assumptions . 42
6.3.2 Resource [firmware] . 42
6.3.3 Resource [software] . 42
6.3.4 Resource [memory]. 43
6.3.5 Resource [areaNwkInfo] . 43
6.3.6 Resource [areaNwkDeviceInfo] . 43
6.3.7 Resource [battery] . 43
6.3.8 Resource [deviceInfo] . 44
6.3.9 Resource [deviceCapability] . 44
6.3.10 Resource [reboot] . 45
6.3.11 Resource [eventLog] . 45
6.3.12 Resource [cmdhPolicy] . 45
6.3.12.0 Introduction . 45
6.3.12.1 Resource [activeCmdhPolicy] . 46
6.3.12.2 Resource [cmdhDefaults] . 47
6.3.12.3 Resource [cmdhDefEcValue] . 47
6.3.12.4 Resource [cmdhEcDefParamValues] . 48
6.3.12.5 Resource [cmdhLimits] . 48
6.3.12.6 Resource [cmdhNetworkAccessRules] . 49
6.3.12.7 Resource [cmdhNwAccessRule] . 49
6.3.12.8 Resource [cmdhBuffer] . 50
6.4 Mapping of procedures for management . 50
6.4.0 Introduction. 50
6.4.1 Create primitive for Resource . 50
6.4.2 Retrieve primitive for Resource . 51
6.4.3 Update primitive for Resource . 51
6.4.3.0 Introduction . 51
6.4.3.1 Update primitive for replacing data . 51
6.4.3.2 Update primitive for execution operation . 52
6.4.4 Delete primitive for Resource . 52
6.4.5 Notify Primitive for Resource . 52
6.4.5.0 Introduction . 52
6.4.5.1 Notify Primitive mapping for subscription to Resource attributes . 52
ETSI
---------------------- Page: 4 ----------------------
oneM2M TS-0005 version 2.0.0 Release 2 5 ETSI TS 118 105 V2.0.0 (2016-09)
6.4.5.2 Notify Primitive mapping for subscription cancellation to Resource attributes . 53
6.4.5.3 Notify Primitive mapping for Notification . 53
6.4.6 Management Resource Specific Procedure Mapping . 53
6.4.6.1 Resource [firmware]. 53
6.4.6.2 Resource [software] . 53
6.4.6.3 Resource [memory] . 53
6.4.6.4 Resource [battery] . 54
6.4.6.5 Resource [deviceInfo] . 54
6.4.6.6 Resource [deviceCapability] . 54
6.4.6.7 Resource [reboot] . 54
6.5 LWM2M Server Interactions . 54
6.5.0 Introduction. 54
6.5.1 Communication Session Establishment . 54
6.5.2 Translation of Requests and Responses between IN-CSE and LWM2M Server . 55
6.5.3 Discovery and Subscription for LWM2M Objects . 55
6.5.4 Access Control Management . 55
6.6 New LWM2M Objects . 55
6.6.0 Introduction. 55
6.6.1 LWM2M CMDH Policy Objects . 55
6.6.1.0 Overview . 55
6.6.1.1 CmdhPolicy Object . 56
6.6.1.2 ActiveCmdhPolicy Object . 56
6.6.1.3 CmdhDefaults Object . 56
6.6.1.4 CmdhDef ECValues Object . 56
6.6.1.5 CmdhDefaultsECParamValues Object . 57
6.6.1.6 CmdhLimits Object . 57
6.6.1.7 CmdhNetworkAccessRules Object . 58
6.6.1.8 CmdhNwAccessRule Object . 58
6.6.1.9 CmdhBuffer Object . 58
History . 59
ETSI
---------------------- Page: 5 ----------------------
oneM2M TS-0005 version 2.0.0 Release 2 6 ETSI TS 118 105 V2.0.0 (2016-09)
Intellectual Property Rights
IPRs essential or potentially essential to the present document may have been declared to ETSI. The information
pertaining to these essential IPRs, if any, is publicly available for ETSI members and non-members, and can be found
in ETSI SR 000 314: "Intellectual Property Rights (IPRs); Essential, or potentially Essential, IPRs notified to ETSI in
respect of ETSI standards", which is available from the ETSI Secretariat. Latest updates are available on the ETSI Web
server (https://ipr.etsi.org/).
Pursuant to the ETSI IPR Policy, no investigation, including IPR searches, has been carried out by ETSI. No guarantee
can be given as to the existence of other IPRs not referenced in ETSI SR 000 314 (or the updates on the ETSI Web
server) which are, or may be, or may become, essential to the present document.
Foreword
This Technical Specification (TS) has been produced by ETSI Partnership Project oneM2M (oneM2M).
ETSI
---------------------- Page: 6 ----------------------
oneM2M TS-0005 version 2.0.0 Release 2 7 ETSI TS 118 105 V2.0.0 (2016-09)
1 Scope
The present document specifies the protocol translation and mappings between the oneM2M Service layer and the
management technologies specified by OMA such as OMA DM 1.3, OMA DM 2.0 and OMA LightweightM2M. Note
that OMA DM 1.3 and OMA DM 2.0 are collectively referenced as OMA DM in the present document.
2 References
2.1 Normative references
References are either specific (identified by date of publication and/or edition number or version number) or
non-specific. For specific references, only the cited version applies. For non-specific references, the latest version of the
referenced document (including any amendments) applies.
Referenced documents which are not found to be publicly available in the expected location might be found at
https://docbox.etsi.org/Reference/.
NOTE: While any hyperlinks included in this clause were valid at the time of publication, ETSI cannot guarantee
their long term validity.
The following referenced documents are necessary for the application of the present document.
[1] ETSI TS 118 001: "oneM2M; Functional Architecture (oneM2M TS-0001)".
[2] ETSI TS 118 004: "Service Layer Core Protocol Specification (oneM2M TS-0004)".
[3] Open Mobile Alliance™: "OMA Device Management Protocol", Version 1.3.
NOTE: Available at http://www.openmobilealliance.org/.
[4] Open Mobile Alliance™: "OMA Device Management Protocol", Version 2.0.
NOTE: Available at http://www.openmobilealliance.org/.
[5] Open Mobile Alliance™: "OMA LightweightM2M", Version 1.0.
NOTE: Available at http://www.openmobilealliance.org/.
[6] Open Mobile Alliance™: "OMA Diagnostics and Monitoring Management Object Framework".
NOTE: Available at http://www.openmobilealliance.org/.
[7] Open Mobile Alliance™: "OMA Firmware Update Management Object".
NOTE: Available at http://www.openmobilealliance.org/.
[8] Open Mobile Alliance™: "OMA Software Component Management Object".
NOTE: Available at http://www.openmobilealliance.org/.
[9] ETSI TS 103 092: "Machine-to-Machine communications (M2M); OMA DM compatible
Management Objects for ETSI M2M".
[10] Open Mobile Alliance™: "OMA Device Capability Management Object ".
NOTE: Available at http://www.openmobilealliance.org/.
[11] Open Mobile Alliance™: "OMA Management Interface to M2M Requirements".
NOTE: Available at http://www.openmobilealliance.org/.
ETSI
---------------------- Page: 7 ----------------------
oneM2M TS-0005 version 2.0.0 Release 2 8 ETSI TS 118 105 V2.0.0 (2016-09)
[12] ISO 8601:2000: "Data elements and interchange formats -- Information interchange --
Representation of dates and times".
NOTE: Available at http://www.iso.ch/.
[13] W3C Recommendation: "XML Schema Part 2: Datatypes", 02 May 2001.
NOTE: Available at http://www.w3.org/XML/Schema/.
[14] IETF RFC 4122: "A Universally Unique Identifier (UUID) URN Namespace", P. Leach, et al. July
2005.
NOTE: Available at http://www.ietf.org/rfc/rfc4122.txt.
[15] ETSI TS 123 003: "Digital cellular telecommunications system (Phase 2+); Universal Mobile
Telecommunications System (UMTS); Numbering, addressing and identification
(3GPP TS 23.003)".
[16] BBF TR-069: "CPE WAN Management Protocol" Issue: 1 Amendment 5, November 2013.
[17] IETF RFC 7252: "The Constrained Application Protocol (CoAP)".
[18] Open Mobile Alliance™: "OMA LightweightM2M - Software Management
...
Questions, Comments and Discussion
Ask us and Technical Secretary will try to provide an answer. You can facilitate discussion about the standard in here.