LWM2M官方1.0.1版本技术规范含目录

4星 · 超过85%的资源需积分: 49 14 浏览量更新于2024-07-19 7 收藏 4.93MB PDF 举报

LWM2M (Lightweight Machine-to-Machine) 是一种轻量级的物联网 (IoT) 协议，由Open Mobile Alliance（OMA）制定并维护。该协议版本1.0.1-04Jul2017是针对物联网设备之间高效、低功耗通信的设计，旨在简化设备管理，特别是在窄带物联网 (NB-IoT) 等场景下。LWM2M 提供了一个标准化的方法，使得设备能够与远程服务器进行连接和通信，实现设备自动配置、状态监控和远程控制。 LWM2M 的完整技术规范文档包含了详细的架构、协议栈、功能组件以及操作流程。它分为多个章节，如： 1. **概述**：介绍了LWM2M的背景、目标和设计原则，强调了其在物联网生态系统中的作用，以及对低功耗和安全性的关注。 2. **体系结构**：描述了LWM2M协议的总体框架，包括客户端、服务器、对象服务器和对象存储库等关键组件。这些组件共同构建了一个设备管理和通信的平台。 3. **协议栈**：涵盖了LWM2M协议的不同层，如网络接口层、对象层、对象实例层和对象模型层，阐述了数据传输、寻址、安全和错误处理等方面的技术细节。 4. **对象与实例**：定义了标准对象库，这些对象代表了设备的各种功能，如传感器读数、状态报告、命令执行等。每个对象有多个实例，用于承载具体的数据值。 5. **安全性**：强调了LWM2M对数据隐私和通信安全的重视，包括加密机制、鉴权和访问控制策略。 6. **操作和维护**：描述了如何通过LWM2M进行设备的注册、发现、升级、状态查询和管理操作，以及异常处理和生命周期管理。 7. **实施指南**：提供了开发者在实际应用中如何实现LWM2M的建议，包括编程接口、测试方法和兼容性要求。 8. **版权和使用条款**：声明了文档的版权归属，强调用户只能在遵守使用协议的前提下使用文档，不得修改或脱离上下文使用。由于文档未经批准可能仍处于工作草稿阶段，这意味着可能会有更新或调整。因此，用户在使用时应确保查阅最新版本以获取最准确的信息。LWM2M 的普及对于推动NB-IoT设备的广泛应用至关重要，因为它简化了设备管理和通信过程，有利于大规模部署和管理物联网设备。

OMA-TS-LightweightM2M-V1_0_1-20170704-A Page 16 (141)

Used with the permission of the Open Mobile Alliance under the terms as stated in this document. [OMA-Template-Spec-20170101-I]

LwM2M

Server

LwM2M

Client

Read, Write, Execute, Create,

Delete, Write Attribute, Discover

Figure 5: Device Management and Service Enablement

Figure 6 shows the operation model for interface “Information Reporting”. For this interface, the operations are downlink

operations “Observe” or “Cancel Observation” and an uplink operation “Notify”. This interface is used to send the LwM2M

Server a new value related to a Resource on the LwM2M Client.

LwM2M

Server

LwM2M

Client

Observe, Cancel Observation

Notify

Figure 6: Information Reporting

The relationship between operations and interfaces is listed in the following Table 1.

Interface

Direction

Operation

Bootstrap

Uplink

Bootstrap-Request

Bootstrap

Downlink

Write, Discover, Delete, Bootstrap-

Finish

Client Registration

Uplink

Device Management and Service

Enablement

Downlink

Create, Read, Write, Delete, Execute,

Write-Attributes, Discover

Information Reporting

Downlink

Observe, Cancel Observation

Information Reporting

Uplink

Notify

Table 1: Relationship of operations and interfaces

5.1 Attributes

5.1.1 Attributes Definitions and Rules

Attributes are metadata which can be attached to an Object, an Object Instance or a Resource. The value of an Attribute is

LwM2M Server specific. These attributes can fulfil various roles: from just carrying information (e.g., Discover), up to

containing parameters for Notification for example.

Attributes attached to Object, Object Instance, Resource, are respectively named O-Attribute, OI-Attribute, R-Attribute.

These Attributes MAY be carried in the message payload of Registration and Discover operations; they also MAY be

updated - when writable - through the “Write-Attributes” operation.

Regardless to the LwM2M entity a given Attribute is attached to, the value of such an Attribute can be set at various levels:

Object, Object Instance, Resource levels. Additionally, precedence rules apply when the same Attribute receives a value at

different levels.

Several rules govern usage of LwM2M Attributes

OMA-TS-LightweightM2M-V1_0_1-20170704-A Page 17 (141)

Used with the permission of the Open Mobile Alliance under the terms as stated in this document. [OMA-Template-Spec-20170101-I]

 The value of an O-Attribute MAY only be set at the Object level.

 The value of an OI-Attribute MAY be set at the Object Instance level, and at the Object level.

precedence rules:

 Rule 1: When set at both levels, the value of the OI-Attribute set at Object Instance level will prevail.

 Rule 2: When the Attribute value is set at the Object level, the scope of the OI-Attribute value extends to all the

Instances of that Object, as long as the Rule 1 is respected.

 An R-Attribute MAY be set at 3 different levels: the Resource level, the Object Instance level and the Object level.

precedence rules:

 Rule 3: When set at the Resource level, the value of an R-Attribute prevails for that Resource whatever a value

for this R-Attribute is also specified at an upper level (Object or Object Instance level).

 Rule 4: When set at the Object Instance level, the scope of an R-Attribute value extends to all the Resources of

that Object Instance as long as the Rule 3 is respected.

 Rule 5: When set at the Object level, the scope of an R-Attribute value extends to all the resources of any

Instance of that Object, as long as the Rule 4 is respected.

An attribute is fully determined by several characteristics which are listed in the table below:

Attribute

characteristics

Description

Name

Attribute Name used to reference a specific Attribute in that Enabler (e.g., “Minimum Period”)

CoRE Link Param

the string used when this Attribute is transferred to CoAP as a CoRE link parameter (ex pmin)

Attachment

The Object, Object Instance or Resource, to which an Attribute applies

Assignation Level

The Level (Object, Object Instance, Resource) where the value of the Attribute MAY be set.

Class

Attributes are organized according to their purpose;

2 Class of Attributes are supported in LwM2M TS 1.0

<NOTIFICATION> gather Attributes regarding Notify operations parameters

<PROPERTIES> gather Attributes regarding general information

Access Mode

R, W, RW: operation allowed by the LwM2M Server.

Applicability

Condition to fulfil for allowing to attach such an Attribute

Default Value

<value> or “-” or “ ”

Value Type

Data Type (Refer Appendix C)

Value

The Value carried by this Attribute : its data type must be of “Value Type”

Table 2: Attribute Characteristics

Some Attributes MAY be exposed to the LwM2M Server in the payload response to a “Discover” command (Section 5.4.2).

The value of some Attributes MAY be changed by the LwM2M Server in using the “Write-Attributes” command (Section

5.4.4); which Attribute are concerned are marked as “W” (writable) in the table of the next Section.

Note: A payload response to a “Discover” command is a list of application/link-format CoRE Links [RFC6690] which will

include the LwM2M Attributes.

5.1.2 Attributes Classification

<PROPERTIES> Class Attributes

OMA-TS-LightweightM2M-V1_0_1-20170704-A Page 18 (141)

Used with the permission of the Open Mobile Alliance under the terms as stated in this document. [OMA-Template-Spec-20170101-I]

The role of these Attributes is to provide metadata which may communicate helpful information to LwM2M Server for

example easing data management.

Except when specifically mentioned as required, the LwM2M Server and LwM2M Client SHOULD support

<PROPERTIES> Class Attributes listed Table 3.

Attribute

Name

CoRE

Link

param

Attachment

Assignation

Level

Support

Required

Access

Mode

Value

Type

Default

Value

Applicabili

Notes

Dimension

dim

Resource

YES

(Client)

Integer

[0:255]

Multiple

Resource

Number of

Instantiations

for a Multiple

Resource

Object

Version

ver

Object

YES

(Server)

YES

(Client)

when able

to support

Objects in

version >

1.0

String

1.0

(Initial

Version)

Provide the

version of the

associated

Object. The

rules

governing the

usage of this

parameter are

specified in

Section 6.2

and Table 19.

Table 3: <PROPERTIES> Class Attributes

<NOTIFICATION> Class Attributes

The role of these R-Attributes is to provide parameters to the “Notify” operation; any readable Resource can have such R-

attributes.

In the message sent by a LwM2M Client in response to an “Observe” operation, the current Resource value is reported; this

event can be considered as the initial notification.

Each time a Resource notification is sent, the “Minimum Period” and “Maximum Period” timers associated to this Resource

are restarted.

The notification of a Resource value will be sent when the combination of a change value condition (“Greater Than”, “Less

Than”, OR “Step”) AND the “Minimum Period” timing conditions are both fulfilled for that Resource.

The LwM2M Server MUST support and LwM2M Client SHOULD support all the <NOTIFICATION> Class Attributes

listed Table 4.

Attribute

Name

CoRE

Link

param

Attachment

Assignation Level

Required

Access

Mode

Value

Type

Default

Value

Apply

Condition

Minimum

Period

pmin

Resource

Object Instance

Object

Integer

0 (sec)

Readable

Resource

Notes: The Minimum Period Attribute indicates the minimum time in seconds the LwM2M Client MUST wait between

two notifications. If a Resource value has to be notified during the specified quiet period, the notification MUST be sent

as soon as this period expires. In the absence of this parameter, the Minimum Period is defined by the Default Minimum

Period set in the LwM2M Server Account.

Maximum

Period

pmax

Resource

Object Instance

Object

Integer

Readable

Resource

OMA-TS-LightweightM2M-V1_0_1-20170704-A Page 19 (141)

Used with the permission of the Open Mobile Alliance under the terms as stated in this document. [OMA-Template-Spec-20170101-I]

Note: the following rules MUST be respected:

- (“lt” value < “gt” value)

- (“lt” value + 2*“st” values <“gt” value)

Table 4: <NOTIFICATION> class Attributes

Examples illustrating Attributes setting are provided in Section 8.2.5 (Device Management & Service Enablement Interface).

5.2 Bootstrap Interface

The Bootstrap Interface is used to provision essential information into the LwM2M Client to enable the LwM2M Client to

perform the operation “Register” with one or more LwM2M Servers.

During the Bootstrap Phase, the Client MAY ignore requests and flush all pending responses not related to the Bootstrap

sequence. There are four bootstrap modes supported by the LwM2M Enabler:

 Factory Bootstrap

 Bootstrap from Smartcard

 Client Initiated Bootstrap

 Server Initiated Bootstrap

The last two Bootstrap modes require the help of a LwM2M Bootstrap-Server to achieve the ultimate goal to connect a

LwM2M Client to their LwM2M Server(s).

The LwM2M Client MUST support at least one bootstrap mode specified in the Bootstrap Interface.

The LwM2M Bootstrap-Server MUST support Client Initiated Bootstrap and Server Initiated Bootstrap modes specified in

the Bootstrap Interface.

Notes: The Maximum Period Attribute indicates the maximum time in seconds the LwM2M Client MAY wait between

two notifications. When this “Maximum Period” expires after the last notification, a new notification MUST be sent. In

the absence of this parameter, the “Maximum Period” is defined by the Default Maximum Period set in the LwM2M

Server Account. The maximum period parameter MUST be not smaller than the minimum period parameter.

Greater

Than

Resource

Float

Numerical

&Readable

Resource

Notes: This “gt” Attribute defines a threshold high value. When this Attributes is present, the LwM2M Client MUST

notify the Server each time the Observed Resource value crosses this threshold with respect to pmin parameter.

Less Than

Resource

Float

Numerical

&Readable

Resource

Notes: This “lt” Attribute defines a threshold low value. When this Attributes is present, the LwM2M Client MUST notify

the Server each time the Observed Resource value crosses this threshold with respect to pmin parameter.

Step

Resource

Float

Numerical

&Readable

Resource

Notes: This “Step” Attribute defines a minimum change value between two notifications. When this Attribute is present,

the change value condition will occur when the value variation since the last notification of the Observed Resource, is

greater or equal to the “Step” Attribute value.

When the “Step” change value condition occurs, the LwM2M Client MUST notify the Server with respect to “Period

Minimum” rule.

OMA-TS-LightweightM2M-V1_0_1-20170704-A Page 20 (141)

Used with the permission of the Open Mobile Alliance under the terms as stated in this document. [OMA-Template-Spec-20170101-I]

This section describes what information is conveyed across the Bootstrap Interface, where the LwM2M Client puts that

information and how to provision the Bootstrap Information for each of these bootstrap modes.

5.2.1 LwM2M Bootstrap-Server

The LwM2M Bootstrap-Server is used to provision the LwM2M Client with the information required to contact the LwM2M

Server(s).

In order for the LwM2M Client and the LwM2M Bootstrap-Server to establish a connection on the Bootstrap Interface, either

in Client Initiated Bootstrap mode or in Server Initiated Bootstrap mode, the LwM2M Client MUST have a LwM2M

Bootstrap-Server Account pre-provisioned in it.

5.2.2 Bootstrap Information

This section specifies the information that needs to be configured in LwM2M Client for connecting to the LwM2M Server(s)

or the LwM2M Bootstrap-Server. This Bootstrap Information can be available before performing the Bootstrap Sequence

described in Section 5.2.4 or obtained as a result of the Bootstrap Sequence.

Bootstrap Information can be categorized into two types:

 LwM2M Server Bootstrap Information

 LwM2M Bootstrap-Server Bootstrap Information

The LwM2M Client MUST have the LwM2M Server Bootstrap Information after the Bootstrap Sequence specified in

Section 5.2.4.

The LwM2M Client SHOULD have the LwM2M Bootstrap-Server Bootstrap Information.

The LwM2M Server Bootstrap Information is used by the LwM2M Client to register and connect to the LwM2M Server.

The LwM2M Server Bootstrap Information MUST contain at least a LwM2M Server Account.

Note that according to the LwM2M Server Account definition, a usual LwM2M Server Account is composed of a Security

Object Instance and a Server Object Instance which are paired by sharing (respectively in Resource 10 and Resource 0 of that

Objects) the same Short Server ID; a Short Server ID being unique in the LwM2M Client.

The LwM2M Server Bootstrap Information MAY additionally contain further Object Instances (e.g., Access Control,

Connectivity Monitoring Object).

The LwM2M Client MAY be configured to use one or more LwM2M Server Account(s).

The LwM2M Client MUST have at most one LwM2M Bootstrap-Server Account.

The LwM2M Bootstrap-Server Bootstrap Information is used by the LwM2M Client to contact the LwM2M Bootstrap-

Server to get the LwM2M Server Bootstrap Information.

The LwM2M Bootstrap-Server Bootstrap Information MUST be a LwM2M Bootstrap-Server Account.

Bootstrap Information Type

Entity

Required

The LwM2M Server Bootstrap

Information

LwM2M Server Account

Yes*

Additional Object Instances (e.g.,

Access Control, Connectivity

Monitoring Object)

The LwM2M Bootstrap-Server

Bootstrap Information

LwM2M Bootstrap-Server Account

(Security Object instance)

Table 5: Bootstrap Information List

*the LwM2M Client MUST have at least one LwM2M Server Account after completion of Bootstrap Sequence specified in

5.2.4.

Please note that the LwM2M Client MUST accept Bootstrap Information sent via Bootstrap Interface without applying

access control as specified in Section 7.3.2 Authorization.

剩余140页未读，继续阅读

xiezhaoxuan

粉丝: 8
资源: 1

LWM2M官方1.0.1版本技术规范含目录

LWM2MForLinux:适用于 Linux 操作系统的 OMA LWM2M 协议的开源实现（C 语言）

物联网协议开源代码

onenet平台LWM2M协议接入解析.pdf

Anjay：客户端OMA LwM2M协议的C实现

Eclipse Leshan：Java轻量级M2M实现与LWM2M协议介绍

锐能微BC26 LWM2M协议AT手册：单相计量芯片接口与校准细节

MQTT协议和LWM2M协议的优劣势

LwM2M-V1_0-20170208-A.pdf

Quectel_BC260Y-CN(R01)_LwM2M_应用指导_V1.21

Quectel BC260Y-CN LwM2M 应用指南(1.0版)：技术支持与服务信息

最新资源