公共 LoRaWAN 参数

本章说明公共网络字段的含义和填写方法。实际区域、信道、密钥和工作模式由项目网络决定；不同型号可能隐藏部分字段。不要照抄截图中的演示值。

公共网络参数填写与核对 · 下载视频

视频演示值

视频中的全零身份和密钥只用于展示字段及长度，未保存到终端；演示结束后已还原页面编辑。不要将示例值写入现场设备。

在哪里查看

连接并成功读取后，进入配置页 概览，查看 LoRaWAN 密钥信息、LoRaWAN 基础信息（射频参数）。其他网络选项可从网络卡片的 更多配置 查看，具体以设备支持项为准。

公共网络表单的离线操作示例。全零 EUI、地址和密钥只用于展示长度，不能用于现场入网；图中频段与参数也不是项目推荐值。 点击放大

公共网络表单的离线操作示例。全零 EUI、地址和密钥只用于展示长度，不能用于现场入网；图中频段与参数也不是项目推荐值。

激活模式：OTAA 与 ABP

模式	使用方式	要和平台核对的内容
OTAA	终端发起入网，成功后获得会话参数	DevEUI、JoinEUI/AppEUI、AppKey，以及平台的协议/区域配置
ABP	预置设备地址与会话密钥	DevAddr、NwkSKey、AppSKey，以及平台的计数器与设备配置

在 激活模式 选择对应模式后，字段会相应变化。OTAA 下 DevAddr 可能只读，因为它来自入网过程。不要为了填写只读地址而随意切到 ABP。

切换 ABP 后显示 AppSKey 与 NwkSKey，DevAddr 可填写。全零仅演示字段，未连接或写入设备。 点击放大

切换 ABP 后显示 AppSKey 与 NwkSKey，DevAddr 可填写。全零仅演示字段，未连接或写入设备。

ABP 没有 OTAA 的 Join 过程，因此“没有看到 Join Request”不能单独作为 ABP 未工作的证据。两种模式都需要正确的区域、信道和平台记录。

身份与密钥的长度

字段	长度	说明
DevEUI	8 字节 / 16 个 HEX 字符	终端标识，按设备分配表核对
JoinEUI / AppEUI	8 字节 / 16 个 HEX 字符	入网相关标识，名称随协议/平台习惯变化
DevAddr	4 字节 / 8 个 HEX 字符	当前会话或预置地址，不等同于 DevEUI
AppKey	16 字节 / 32 个 HEX 字符	OTAA 根密钥；按当前终端支持的协议填写
NwkSKey	16 字节 / 32 个 HEX 字符	网络会话密钥
AppSKey	16 字节 / 32 个 HEX 字符	应用会话密钥

HEX 允许 0–9、a–f，每两位为一个字节。分组显示的空格用于阅读，不能把某个十进制编号直接当成等长 HEX 身份。按平台字段说明复制展示值，不自行反转字节顺序。

注意区分根密钥、会话密钥和组播密钥；字段长度相同也不能混填。本页描述当前软件字段，不能据此假设所有 LoRaWAN 协议版本的密钥体系完全相同。

工作模式：Class A 与 Class C

模式	接收特点	选用时考虑
Class A	终端上行后安排接收窗口	常用于电池设备；下行需等待接收机会
Class C	除发送等时段外，尽可能持续接收	需要更高的接收功耗，常见于持续供电设备

只有终端固件、供电和平台均支持时才选择相应模式。上位机显示 Class C 不代表服务器已经以相同类别调度下行；保存后还需核对平台和真实下行结果。

区域、信道、SF 与功率

字段	代表什么	常见误解
区域/频段	无线区域参数计划	软件可选不代表硬件、网关或当地规则允许
起始/结束信道	可用信道编号范围	编号不是 MHz；起止范围应与网关一致
扩频因子 SF / 数据率 DR	当前区域中的数据率选项	不同区域 DR 对应关系可能不同
发射功率	终端射频发射设置	不能用“全部调最大”代替链路排查

当前“区域”可编辑下拉仅在 AS923 子带等适用条件下显示，其他区域可能隐藏，不能按本章示例强行切换到另一频段。先核对设备当前区域，再检查信道和数据率。提高 SF 通常会增加空中占用和耗电，也会降低可用容量；它不能解决区域、密钥或接线错误。

界面范围与显示条件

项目	当前界面如何填写	注意
起始/结束信道	数字框允许 0～96	这是表单范围；实际合法信道随区域变化，且起始不能晚于结束
发射功率	0～22 dBm，间隔 2 dBm 的下拉项	硬件、区域和项目要求仍有约束
SF / RX2 SF	选择当前区域的选项，可能同时标注 DR	不自行填一个列表中不存在的数字
最大入网次数	0～7 的下拉项	按终端说明解释，不把 0 擅自当成无限重试
最大发送次数	0～7 的下拉项，部分型号隐藏	字段说明包含首次发送；例如 3 表示首次 1 次、最多额外重发 2 次
消息确认	支持的型号显示开关	部分 SOS/RTU 类型隐藏，并非读取错误
RX1 / RX2 延时	500～10000 ms	不把秒数直接填成毫秒值
RX1 / RX2 等待	500～3000 ms	与“延时”是不同字段；根据终端窗口时序和网络要求填写

表单范围只说明软件允许怎样输入，不保证任意组合都能入网。示例截图中的窗口值、次数和功率仅演示字段，不是项目推荐参数。

ADR、消息确认和接收窗口

• ADR：允许网络依据链路情况调整数据率/功率等参数。开启后不要只凭某次回读的固定 SF 推断长期空中行为；应结合平台记录。
• 消息确认：确认上行需要网络下行确认，会增加下行资源使用和等待/重试开销。未收到确认不等于平台完全未收到上行。
• RX2/接收窗口参数：须与区域和网络设置匹配。上行能到平台、下行收不到时，需要单独核对接收窗口、类别、会话和网关发送条件。
• 重试/入网相关次数：按字段说明和项目要求设置，不把最大次数作为默认推荐值。

更多配置中可查看 ADR、区域和接收参数。离线演示值不是可直接套用的配置，窗口内可滚动查看。 点击放大

更多配置中可查看 ADR、区域和接收参数。离线演示值不是可直接套用的配置，窗口内可滚动查看。

组播只在项目需要时配置。普通单播正常并不能证明组播地址、密钥或接收计划已正确。

需要组播时还要检查什么

只有开启 组播 后，相关字段才显示。组号为 0～255，组播地址为 4 字节，组播应用/网络密钥各 16 字节，信道及 SF 使用当前区域选项。支持上行调度的设备还可能显示以 ms 为单位的延时，不能把该型号专属项套到其他设备。

组播参数应由项目统一分配；它们与设备单播身份/会话密钥分开管理。导入时 组播配置 默认不选，见配置管理。

扩展开关怎样处理

不同型号可能提供下列项，先保留已验证的项目值，不把“全部打开”当成优化：

项目	需要知道什么
快速发送模式	可能优先发送缓存且不等待下行窗口；依赖下行的业务先确认型号行为
热加载	OTAA 下尝试沿用已有入网信息；仍需与平台会话状态匹配
简单计数	涉及平台计数兼容方式，不用于掩盖真实计数回退问题
FCntUp 保持	目标是保持上行计数连续；重启后仍应核对平台接收情况
持续接收	增加接收时长和功耗，不单凭开关认定平台已按 Class C 调度
信道活动检测	发送前检查信道忙闲，可能增加等待，不能保证完全没有碰撞
睡眠模式	与型号的供电和业务运行有关，按终端说明使用

接收窗口字段注意界面单位（如 ms），不要把秒数直接填入毫秒框。重试次数按字段说明区分“总发送次数”和“额外重试次数”，不能混用。

网络测试与频段图谱

网络测试会发起真实操作

已连接并读取后，点击设备信息卡片上的 网络测试。当前流程打开弹窗后会自动发起 LoRaWAN 测试，不是只打开预览，也不需要再找“开始测试”按钮。

如果刚修改了参数，先保存并按提示重启；需要重新连接时再连接。没有修改就可直接使用当前已读取的配置测试，不必额外保存或重启。等待测试结果，成功时查看 RSSI（dBm）、SNR（dB）和 SF；失败时保留提示并结合网关、平台记录排查。一次成功只说明此次测试有结果，不能当作长期覆盖或所有业务均正常的证明。

设备信息卡片的网络测试入口。点击会发起真实测试，不是离线演算。 点击放大

设备信息卡片的网络测试入口。点击会发起真实测试，不是离线演算。

频段图谱需要显式开始和停止

串口配置页 更多 → 频段图谱 打开扫描窗口。蓝牙配置没有同样的图谱菜单，不能按串口截图寻找。

1. 核对当前设备区域，填写起始/结束信道和起始/结束 SF；范围越小，单轮检查更集中。
2. 点击 开始，等待轮次、结果数和图谱更新。这会向设备下发扫描操作。
3. 历史均值 开启时查看历史平均 RSSI，关闭时看最新结果；鼠标悬停格子查看对应信道/SF 的信息。
4. 测试完先点击 停止 并确认结果，再关闭窗口；关闭窗口本身不能当作停止扫描。
5. 需要整理记录时再用 清空，清空显示不会替代停止操作。

频段图谱的离线初始界面：未连接设备，开始/停止不可用，空白格不是实际扫描结果。 点击放大

频段图谱的离线初始界面：未连接设备，开始/停止不可用，空白格不是实际扫描结果。

当前图谱按 RSSI 强弱映射色阶。颜色或百分比不是实测占空比、报文成功率或链路覆盖率；无线能量也不一定来自 LoRaWAN。不要仅凭浅色格子就认定信道无干扰。

需要修改网络参数时

1. 取得该项目参数表，确认设备型号、区域和激活模式。
2. 连接、读取，核对设备身份。需要保留原值以便恢复时，可在修改前导出备份。
3. 核对区域；只有存在适用的区域选项时才按项目要求选择。再设置激活模式和 Class，检查字段变化。
4. 填写该设备自己的身份/密钥和项目公共射频参数。
5. 检查长度、起止范围和关联项，保存。
6. 按提示处理重启，完成参数配置。

可选确认： 需要核对写入值时再重新读取。需要确认实际联网效果时，OTAA 查看入网过程，ABP 查看对应设备数据帧，再观察所需的上报或下行；交付验收按项目要求执行。

网络参数编辑后点击保存，并按提示处理重启；回读属于可选确认。截图展示公共保存入口。 点击放大

网络参数编辑后点击保存，并按提示处理重启；回读属于可选确认。截图展示公共保存入口。

按现象排查

现象	先检查
平台完全看不到报文	终端供电/工作状态、区域、信道、网关是否收到实际无线帧
OTAA 发起入网但失败	身份、AppKey、协议/区域设置，以及平台拒绝原因
上行有记录但业务值不对	FPort、设备类型、载荷格式和对应固件解码规则
上行正常但下行失败	Class、接收窗口、会话、网关发送记录与终端接收状态
保存后再次读取不一致	保存结果、重启要求、是否连接了另一台设备

现场排查应保留时间和原始记录。完整无线帧用LoRaWAN 数据包解析，已解密应用载荷用设备 Payload 解析。两者输入不同。