当前位置：首页 > article >正文

使用 EMQX 接入 LwM2M 协议设备

article 2026/4/24 23:30:28

LwM2M 协议介绍

LwM2M 是一种轻量级的物联网设备管理协议，由 OMA（Open Mobile Alliance）组织制定。它基于 CoAP （Constrained Application Protocol）协议，专门针对资源受限的物联网设备设计，例如传感器、智能表计等，它们通常由电池供电，并且 CPU、内存、网络链接资源有限。

协议栈结构

LwM2M 协议栈有以下几个特点：

应用层除了协议本身定义了一套标准的对象资源模型外，也允许用户进行自定义对象模型。
传输层上一般是常用的 CoAP/UDP，使其在兼顾轻量的前提下，也提供了一定程度的可靠性保证。
传输安全上采用 DTLS 协议，支持 Pre-Shared Key、Raw Public Key、X.509 证书等多种安全模式。
网络层一般以 UDP + IPv4/6 和 SMS 为主，同时也支持将其部署在 NB-IoT、TCP、LoRAWAN 等网络上。

资源模型

资源模型是 LwM2M 协议的核心，它定义了客户端与服务器之间的通信规范。客户端按该定义的数据格式向服务器上报数据，服务器通过资源模型向客户端对应的资源发送读、写、执行等控制命令。

下图展示了客户端（LwM2M Client)、对象（Objects）和资源（Resources）之间的关系，客户端可能有多个类型的资源，每个资源都隶属于某个对象：

资源模型

所有标准的对象和资源都存在一个固定的编号，他们由 OMA LwM2M Registry 进行统一维护。

例如，用于温度传感器类设备的对象 Id 为 3303，它定义了：

Resource 5700: Sensor Value (current temperature reading)

资源 5700：传感器值（当前温度读数）
Resource 5701: Sensor Units (units of the temperature reading, e.g., Celsius or Fahrenheit)

资源 5701：单位（例如，摄氏度或华氏度）
Resource 5601: Min Measured Value (minimum recorded temperature)

资源 5601：最小测量值
Resource 5602: Max Measured Value (maximum recorded temperature)

资源 5602：最大测量值

LwM2M 协议支持在对象和资源上定义允许的操作，例如：

Read: 获取资源的当前值
Write: 设置新值
Execute: 调用定义在资源上的函数
Observe/Notify: 订阅该资源值的变化，并实时进行通知

优势和主要应用场景

综上可见，LwM2M 协议的主要优势有：

轻量级：基于 CoAP 和 UDP 协议，网络开销小，适合资源受限设备。
远程管理：定义了多种标准化的资源，支持设备升级、资源状态查询、监控等操作。
灵活的资源模型：LwM2M 的资源模型允许灵活地表示设备能力，可根据具体应用定义自定义资源。
安全性：支持 DTLS 安全传输，确保设备数据的安全性。

主要适用的场景有：

智慧城市：管理路灯、交通传感器和环境监测设备。
交通运输：跟踪和管理车队车辆，优化物流，监控车辆健康状况。
工业物联网：在工厂环境中监控和管理机器、传感器和执行器。
智慧农业：远程管理土壤传感器、气象站和灌溉系统。
智能制造：监控和管理机器、传感器和生产线，以提高效率和实现预测性维护。
医疗保健：管理可穿戴健康监测设备和医疗设备。

使用 EMQX 接入 LwM2M 协议

EMQX 是一款大规模分布式 MQTT 消息服务器，功能丰富，专为物联网和实时通信应用而设计。EMQX 除了完整支持 MQTT 协议之外，还可通过网关有效地管理 STOMP、MQTT-SN、CoAP、LwM2M 等非 MQTT 协议的连接、身份验证和消息传输等，并提供统一的用户界面以简化使用。

EMQX 提供了强大的内置 LwM2M 网关功能，能够高效地接入各类 LwM2M 设备。它支持基于 UDP 或 DTLS 的设备连接方式，确保了设备通信的安全性和稳定性。通过 EMQX Dashboard，用户可以轻松地进行设备管理。此外，LwM2M 网关还具备强大的消息转换能力，能够将 LwM2M 消息与 JSON 格式的 MQTT 消息进行相互转换。这一功能不仅实现了设备上行消息的结构化解析，方便用户对设备数据进行进一步的处理和分析，还支持通过 JSON 格式的消息下行操作，实现对设备的灵活控制。这种双向转换机制，使得 EMQX 在物联网设备管理和数据交互方面表现得更加出色，为复杂的物联网应用场景提供了强大的支持。

启用 LwM2M 网关

EMQX 5 及其以上的版本支持通过 EMQX Dashboard 在网页上进行启动 LwM2M 网关。

首先，使用以下命令启动 EMQX 5.8.4，并将端口 1883、18083、5684 映射到宿主机上：

sudo docker run -d --name emqx584 \-p 18083:18083 \-p 1883:1883 \-p 5783:5783/udp emqx/emqx:5.8.4

然后打开 EMQX Dashboard，通过 “Managment“ → “Gateway“ 进入到网关管理页面，选中 ”LwM2M“ 开始配置：

Management → Gateway

所有页面都保持默认配置即可，配置完成后显示以下提示，即表示成功开启 LwM2M 网关：

Gateways

启用 LwM2M 客户端和消息收发

在本示例中，你可以选择手动编译安装 wakaama 以提供 LwM2M 客户端的支持，或使用已经预编译好的 Docker 镜像进行测试。以 Docker 为例：

先通过 Docker 启动 MQTTX-CLI，用于观察 LwM2M 上线过程：
```
sudo docker run -it --rm --network host emqx/mqttx-cli
```
订阅 up/# 主题以接收 LwM2M 客户端产生的消息：
```
mqttx sub --topic up/#
```

使用 Docker 启动 wakaama 命令行容器：

sudo docker run --rm -it --network host heeejianbo/my-wakaama:1.0

在容器中，使用以下命令建立一个 LwM2M 客户端连接：

lwm2mclient -l 57830 -p 5783 -h 127.0.0.1 -4 -n testlwm2mclient

在 mqttx 客户端观察到以下消息，则表示 LwM2M 客户端成功登录到 EMQX 中：

topic: up/register, qos: 0
{"msgType":"register","data":{"objectList":["/1","/1/0","/2/0","/3/0","/4/0","/5/0","/6/0","/7/0","/31024","/31024/10","/31024/11","/31024/12"],"lwm2m":"1.1","lt":300,"ep":"testlwm2mclient","b":"U","alternatePath":"/"}}
topic: up/resp, qos: 0
{"msgType":"observe","is_auto_observe":true,"data":{"reqPath":"/3/0","content":[{"path":"/3/0","value":"W3siYm4iOiIvMy8wLyIsIm4iOiIwIiwidnMiOiJPcGVuIE1vYmlsZSBBbGxpYW5jZSJ9LHsibiI6IjEiLCJ2cyI6IkxpZ2h0d2VpZ2h0IE0yTSBDbGllbnQifSx7Im4iOiIyIiwidnMiOiIzNDUwMDAxMjMifSx7Im4iOiIzIiwidnMiOiIxLjAifSx7Im4iOiI2LzAiLCJ2IjoxfSx7Im4iOiI2LzEiLCJ2Ijo1fSx7Im4iOiI3LzAiLCJ2IjozODAwfSx7Im4iOiI3LzEiLCJ2Ijo1MDAwfSx7Im4iOiI4LzAiLCJ2IjoxMjV9LHsibiI6IjgvMSIsInYiOjkwMH0seyJuIjoiOSIsInYiOjEwMH0seyJuIjoiMTAiLCJ2IjoxNX0seyJuIjoiMTEvMCIsInYiOjB9LHsibiI6IjEzIiwidiI6MzEwNDg1ODkwM30seyJuIjoiMTQiLCJ2cyI6IiswMTowMCJ9LHsibiI6IjE1IiwidnMiOiJFdXJvcGUvQmVybGluIn0seyJuIjoiMTYiLCJ2cyI6IlUifV0="}],"codeMsg":"content","code":"2.05"}}

再连接一个 MQTTX-CLI 的客户端，用于与 LwM2M 设备交互：
```
sudo docker run -it --rm --network host emqx/mqttx-cli
```
向步骤 3 中创建的 testlwm2mclient 客户端发送一条读指令，读取其设备的固件版本：
```
mqttx pub --topic dn/testlwm2mclient -m '{"msgType": "read", "data": {"path": "/3/0/3"}}'
```

可以观察到步骤1中创建的订阅端接收到了读指令的数据返回，其固件版本为 1.0：

topic: up/resp, qos: 0
{"msgType":"read","data":{"reqPath":"/3/0/3","content":[{"value":"1.0","path":"/3/0/3"}],"codeMsg":"content","code":"2.05"}}

至此，一个简单的 LwM2M 连接和指令收发的示例便完成了。

管理 LwM2M 客户端

在 EMQX 中可以通过 Dashboard 对这三类设备进行管理。例如针对 MQTT，可以在对应网关的 Clients 页面进行查看：

LwM2M Clients

点击该客户端 ID 时，也可查看其详细的信息：

LwM2M Client Info

总结

LwM2M 协议在资源受限设备的场景中有着广泛的应用，它不仅提供了丰富的互操作语来实现设备之间的互联互通，还提供了丰富的安全机制以确保设备数据的安全性。

EMQX 的 LwM2M 网关提供了简单的用户层接口，实现 LwM2M 协议的接入和设备管理。用户可以方便地将 LwM2M 设备接入到 EMQX 中，实现与 MQTT 协议的互通，进行更完整的设备数据采集、处理和分析。

版权声明：本文为 EMQ 原创，转载请注明出处。原文链接：https://www.emqx.com/zh/blog/integrating-lwm2m-with-mqtt

LwM2M 协议介绍

协议栈结构

资源模型

优势和主要应用场景

使用 EMQX 接入 LwM2M 协议

启用 LwM2M 网关

启用 LwM2M 客户端和消息收发

管理 LwM2M 客户端

总结

相关文章：