实用的LoRaWAN 应用层协议规范

1. 文档概述

1.1. 目的与范围

本协议旨在建立物联网终端设备与应用服务器之间的直接通信标准，涵盖LoRaWAN设备上行数据协议及门思科技设备专用参数配置协议。协议设计充分考虑：

• 兼容性：支持多型号设备接入
• 扩展性：保留未来功能扩展空间
• 可靠性：完善的数据传输保障机制

1.2. 协议架构

2. 核心术语定义

2.1. 设备类型

2.2. 网络要素

3. LoRaWAN网络规范

3.1. 端口分配策略

3.2. 高级网络功能

3.2.1. ADR机制

LoRaWAN节点具有ADR功能，可以根据实际网络环境调整通信速率，以最大化网络利用率。本协议标准要求节点侧开启本地ADR功能，自动化调整速率。

3.2.2. 时间同步

• 精度要求：设备时钟偏差<5秒/天
• 实现方式：
  1. MAC层DeviceTimeReq命令（推荐）
  2. 应用层时间戳协议（备选）

3.2.3. 数据可靠性策略

4. 上行数据协议规范

4.1. 通用数据格式

+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| 版本标识(1B) | 控制字(1B) | 数据标识(1B) | 数据内容(NB) |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

4.1.1. 版本标识详解

7   6   5   4   3   2   1   0
+---+---+---+---+---+---+---+---+
|EN | RFU   | 主版本号(0-15)    |
+---+---+---+---+---+---+---+---+

• EN=1时版本标识有效
• 示例：0x82表示启用V2.0协议

4.1.2. 控制字解析

7   6   5   4   3   2   1   0
+---+---+---+---+---+---+---+---+
|DIR|OP |RES |ACK | 行业标识    |
+---+---+---+---+---+---+---+---+

• DIR：0=设备上行，固定为0
• OP：0=读操作回复，1=写操作回复
• RES：0=执行失败，1=成功
• ACK：0=无应答，1=需要应答

4.2. KS52设备协议实例

4.2.1. 数据帧示例

21 07 03 0C 6E A005 00 F604 8C03 DB 00 00

4.2.2. 字段解析表

5. 参数配置协议（门思专用）

本指南适用于门思科技LoRaWAN设备的参数修改，通过NS平台下发指令实现。

5.1. 前提条件

• 设备需在网关覆盖范围内且网关已接入NS平台
• ClassA设备：需等待上行数据后才能下发参数
• ClassC设备：可随时下发参数

5.2. 通信规范

5.2.1. 基本参数

5.3. 命令格式

5.3.1. 通用命令结构

5.4. 参数读取

5.4.1. 请求格式

0x8F 0x02 [起始地址] [读取字节数]

5.4.2. 响应格式

0x2F [n+2] [参数地址] [n] [参数值]

5.4.3. 示例

• 请求：0x8F 0x02 0x02 0x04（读取地址2开始的4字节）
• 响应：0x2F 0x06 0x02 0x04 0xA3 0x74 0x00 0x00

5.5. 参数修改

5.5.1. 请求格式

0xCF [n+2] [起始地址] [n] [参数值]

5.5.2. 响应格式

[0x6F/0x4F] 0x01 [结果代码]

（0x6F=成功，0x4F=失败）

5.5.3. 示例

• 请求：0xCF 0x03 0x08 0x01 0x03（修改地址8为0x03）
• 成功响应：0x6F 0x01 0x00
• 失败响应：0x4F 0x01 0x05

5.6. 特殊命令

5.6.1. 频点修改（通用）

0xC2 0x2A [起始地址] [字节长度] [参数值]

5.6.1.1. 频点参数表

5.6.1.2. 完整示例

C2 2A 08 28 
60 35 08 1C 52 
A1 42 0B 1C 52 
E2 4F 0E 1C 52 
23 5D 11 1C 52 
60 6A 14 1C 52 
A1 77 17 1C 52 
E2 84 1A 1C 52 
23 92 1D 1C 52

成功响应：0x620100

5.6.2. 设备复位

0xCF 0x03 0x09 0x01 0x01

成功响应：0x6F0100

5.6.3. 心跳周期修改

0xCF 0x04 0x3A 0x02 [分钟数（小端）]

示例（1800分钟=0x0708）：

0xCF 0x04 0x3A 0x02 0x08 0x07

成功响应：0x6F0100 注：需复位生效

5.7. 6. 透传模式规范

5.7.1. 6.1 技术特性

• 端口号：51（固定）
• 数据格式：原始字节流，不做任何编解码

5.7.2. 6.2 应用场景

1. 传统485设备数据透传
2. 第三方协议兼容模式
3. 调试期原始数据抓取

Thinklink : 开放的LoRaWAN应用平台，接收任何品牌的全球标准LoRaWAN设备，支持BACnet，Home assistant，Thingsboard对接。

• cloud 版本：免费支持1000个设备 https://thinklink.manthink.cn
• edge 版：低成本独立部署，支持1000个设备接入

📌 如果你正在寻找一个稳定、高效、低成本的远距离通信方案，LoRaWAN无疑是一个值得深入研究和应用的技术方向。