LoraWan 1.0.4 终端设备认证要求(全区域 V1.6.3)

狂奔De鸵鸟

已于 2025-01-27 17:30:25 修改

阅读量410

点赞数 4

文章标签：物联网 LoraWan 嵌入式 c语言

于 2025-01-20 16:58:01 首次发布

本文链接：https://blog.csdn.net/qq_37290697/article/details/145264539

版权

修订历史

版本	作者	更新内容	日期
1.0草稿	Nisha Bhaskaran	源自终端设备认证_EU868 - _V1.6 LoRaWAN 1.0.4和区域参数RP2 1.0.1的初始版本1.0 将所有区域的认证规范合并为一个规范修正术语以与LW 1.0.4和RP2 1.0.1保持同步	2019年11月4日
版本1.0 / 1.0草稿	Nisha Bhaskaran / Derek Hunt	首次发布用于A类设备在CC67会议上批准	2020年9月28日
版本1.1	Nisha Bhaskaran / Derek Hunt	首次正式发布用于A类设备在CC70会议上批准	2020年12月16日
版本1.2 - 草稿C	Nisha Bhaskaran	更新至 - 测试说明，第2.5.8.a.i、2.5.8.c.i、2.5.11.c、2.5.12.c、2.5.14节新增第5节 - 重传关闭测试新增第6节 - 相似性认证测试	2021年5月26日
版本1.2	Nisha Bhaskaran	对第6节 - 相似性认证进行修改	2021年6月23日
版本1.3	Nisha Bhaskaran	在64 - 通道GW的回退测试中添加注释更新相似性步骤1的认证证书	2021年8月4日
版本1.4	Nisha Bhaskaran	在DevOps调用的第2.5.6、2.5.9和6节中进行更新	2021年12月3日
版本1.5	Nisha Bhaskaran	添加LR - FHSS测试，第2.5.11.e.i节和区域参数规范版本	2022年6月16日
版本1.6	Nisha Bhaskaran	更新第2.5.11.a.i节以明确仅需测试支持的DRs	2024年1月18日
版本1.6.1	Nisha Bhaskaran	- 第2.5.6节TxParamSetupReq：更新以验证RSSI的Max和Min TxPower的差值，平均10个值而不是3个值 - 第2.5.8.b.ii.2.1.1 节：更新以包括对所有已启用通道的验证第2.5.8.b.ii.3.1.1 、2.5.8.b.ii.3.2.1 、2.5.11.a.i、2.5.11.e.i.1和2.5.11.e.ii.1 节：允许对网关不支持多个LR-FHSS信道的情况进行测试 - 第2.5.8.d.iii.1 节：LR-FHSS DR衰减测试：添加LinkADRReq以仅为启用FC的设备设置信道（之前遗漏） - 第2.5.11.e.i.1和2.5.11.e.ii.1 节：在可选信道的开头添加了一个发送NewChannelReq的步骤，并在表尾删除了该步骤（之前遗漏）	2024年9月19日
1.6.3	Nisha Bhaskaran	更新通过相似性认证 - 对于命令NewChannelAns和DIChannelAns，FC信道支持DUT必须回复一个答案。这与A类测试同步。 - 第2类B类和C类测试更新 - 在A类中，信标不会连续发送，除非有要求。	2024年12月5日

词汇表

由LoRa联盟开发和维护的协议规范。

认证标志	LoRa联盟定义的徽标，可以显示在认证产品和任何关于终端设备的文件和营销信息上。
LoRa 测试室	LoRa联盟认证的进行认证测试的组织及其相应设施。
终端设备	设备提交至LoRa测试中心进行认证。

1. 引言

本文件规定了终端设备被指定为“LoRaWAN认证”的最低测试要求。LoRa联盟将确认终端设备符合LoRaWAN规范版本1.2.0.4 [1]中相应区域参数的功能要求，如LoRaWAN区域参数规范RPP v2.1.0.3 [2]中所定义。

1.1. LoRaWAN认证范围

本测试规范的范围仅限于验证LoRaWAN协议A类的合规实施。

对于LoRaWAN认证，并非强制要求终端设备拥有所有必要的监管批准，但在各个国家销售或运营产品之前需要这些批准。

无论如何，终端设备之间性能和射频质量的不可避免的变化性过高，难以允许标准化的、实际的评估。射频性能测量，无论是辐射的还是传导的，因此都不在此处描述的测试范围内。终端设备的射频性能将仅作为LoRaWAN认证测试的射频性能测试的一部分进行测试，这将是在授权测试机构进行的单独测试，以评估设备作为LoRaWAN认证测试一部分的射频性能。

1.2. LoRaWAN认证流程

寻求其终端设备获得LoRaWAN认证的一方必须是LoRa联盟的良好信誉会员，并且只有经LoRa联盟认可的授权测试机构才能执行本文所述的测试。

授权测试机构必须将完整结果传达给LoRa联盟。如果设备通过所有强制性测试，LoRa联盟将针对本文件的某个版本向终端设备颁发证书，并相应地更新版本 [1] 和 [2]。此外，联盟将在其网站上公布状态和测试结果摘要，以提供任何测试的可选功能。

1.3. 与LoRaWAN规范v1.0.2到LoRaWAN规范v1.0.4相比，本版本中的变更

将所有5个区域认证规范合为一个。
认证申请已被移除。所有测试都将在应用模式下完成。整个文件都进行了相应更新：

注意在测试期间设备的默认数据速率并在修改后恢复默认值。
如果之前未设置，则设置ADR位，在测试前执行LinkADRReq命令。
关闭占空比循环。

MAC命令添加：DutyCycleReq和DeviceTimeReq。
要求变更：DeviceStatusReq：SNR Margin已重命名为RadioStatus

NewChannelReq：对于固定信道规划设备，无需进行测试
TXParamSetupReq：此要求必须针对亚洲以外地区进行测试，以确认该命令被忽略
LinkADRRq：数据速率（DataRate）或TX功率（TXPower）中任一值为0xFF表示DUT（被测设备）必须忽略该字段并保持当前参数值
LinkADRRq - TXPower：当被命令设置的有效TX功率电平低于其所能达到的电平时，DUT必须以LinkADRAns响应失败，并以其先前配置的TX功率运行
LinkADRRq - TXPower：当被命令设置的有效TX功率电平高于其所能达到的电平时，DUT必须以LinkADRAns响应成功，并以其最大TX功率运行
新增部分：多个MAC命令优先级
为与LW 1.0.4测试用例映射而添加的部分
格式：
- 上行链路和相应的下行链路合并为同一步骤，以表明确切的顺序

2. LoRaWAN认证的功能测试描述

以下指定的测试列表反映了[1]中定义的A类终端设备的功能要求。测试在一个通常由以下部分组成的测试装置中进行：

一个测试控制层（TCL）
一个LoRaWAN网络服务器（NS）
一个8/16/64通道的LoRaWAN网关（GW）
被测终端设备（DUT）

注释：

一个16通道的网关设备将用于所有正式的动态信道规划设备认证测试。
一个64通道的网关设备将用于所有正式的固定信道规划设备认证测试。
一个8通道的网关设备可用于LoRaWAN成员实验室进行的非正式预测试。然而，对于正式认证测试，将不使用8通道网关设备。当使用8通道网关设备时，125kHz信道0 - 7和500kHz信道64必须在网关上进行配置

这种测试装置架构的实施预计会因各测试机构而异。测试控制层（TCL）被假定为自动化脚本和工具的框架，用于操作网络服务器（NS）以促进测试。具体而言，TCL驱动测试装置中的事件，控制应用程序以及网络控制内容的下行链路。它还解密、检查并验证被测终端设备（DUT）发送的上行链路内容。这使得测试覆盖范围包括：

加密
被测终端设备（DUT）接收窗口的定时
频率信道使用和数据速率适配
最大有效载荷处理

为简洁起见，本文档仅对测试控制层（TCL）、网络服务器（NS）、被测终端设备（DUT）进行程序性引用。

LoRaWAN网关（GW）和DUT（被测设备）在一个射频隔离环境中协同工作，该环境旨在确保可靠的双向通信。不过，不能期望GW接收每个用于接收的帧。TCL（测试控制语言）应尽力应对这种不可避免的情况。上述射频隔离环境应尽量减少任何潜在的干扰。

测试需对每个受支持的激活方法（即空中激活（OTAA）、基于个性化的激活（ABP）等）对DUT进行验证。

TCL必须在本测试套件的整个过程中验证以下内容：

DUT的上行链路大小必须根据所使用的数据速率来设定最大允许的上行链路大小。
基于预期内容的DUT上行链路长度，需确保不包含无关和不必要的内容。

当TCL重新启动时，DUT必须设置为出厂复位模式。

一般说明

TCL必须像真实网络服务器一样处理LoRaWAN协议，除非测试中另有规定。

在整个测试过程中，DUT可能会发送MAC命令和上行链路帧，TCL必须做出适当响应，具体如下：

如果DUT随时发送一个确认（Confirmed）帧，TCL必须以确认（Acknowledgement）响应。
如果DUT发送一个设备时间请求（DeviceTimeReq）MAC命令或任何其他触发DUT的MAC命令，TCL必须以设备时间应答（DeviceTimeAns）MAC应答或相应的MAC应答立即响应。

测试说明

默认数据速率：本文档中所有LinkADRReq MAC命令必须将数据速率设置为Max125kHzDR，除非另有规定。
MIC检查：当工具遇到无效的MIC（消息完整性码）时，它必须使正在进行的特定测试失败。
下行链路FPort：DUT发送的所有MAC命令都将通过FPort 0发送，除非本文档中的序列图另有规定。
丢失MAC或认证协议命令：在测试期间，如果MAC或认证协议命令被DUT丢失，该命令必须由TCL重新发送，最多再发送两次，然后测试才判定为失败。
丢失RxAppCntReq命令：当从TCL向DUT发送RxAppCntReq命令时，如果DUT未收到响应，该命令必须由TCL重新发送，最多再发送两次。
发送需要响应的MAC命令后下载链路：除非另有规定，对于所有需要从TCL（即，RX参数设置应答、RX定时设置应答、离散信道应答）得到响应的MAC响应命令，TCL必须在接收到此MAC响应命令后立即进行下载链路操作。

信道掩码配置用于LinkADRReq MAC命令以在使用8信道网关进行预测试时为固定信道计划设备做准备

对于固定信道计划设备，当设备使用8信道网关进行预测试时，需要由TCL发送MAC - CMD LinkADRReq，序列表中的LinkADRReq必须替换为以下提到的LinkADRReq命令。LinkADRReq必须首先禁用所有125kHz信道，仅启用64 - 500kHz信道，然后启用信道0 - 7并再次发送LinkADRReq。

MAC - CMD LinkADRReq
- ChMaskCntl = 7
- ChMask = [0x]001
MAC - CMD LinkADRReq
- ChMaskCntl = 0
- ChMask = [0x]0FF
- Payload = [0x]3XXXXXXX[0x]3XXXXXXX

如果使用64信道网关进行测试，则LinkADRReq必须与序列表中提到的相同。

B类和C类测试

B类： DUT必须对所有A类测试进行测试，然后必须执行B类测试。默认情况下，在测试B类设备时，TCL在执行A类测试时不得连续发送信标。

如果设备是永久的B类设备，则TCL在执行A类测试时必须连续发送信标。

C类： DUT必须对所有A类测试进行测试，然后必须执行C类测试。例外情况 - 当设备是永久的C类设备，第2.5.11.c节中的RX1和RX2同时帧将被跳过

2.1. 激活预测试

第2.1.1节 - DUT预条件激活测试 - 必须作为所有测试中第一次测试执行，无论是单项测试还是多项测试。

注意：除非在测试用例序列中另有规定，否则对于所有测试，TCL仅在DUT的前一帧的RX2窗口发送帧。

DUT必须支持通过空中（OTA）激活或通过个性化（ABP）激活，或两者皆支持。如果设备同时支持OTA和ABP，设备供应商必须为授权测试屋（ATH）提供2个独立的设备，一个支持OTA，另一个支持ABP方式的激活。ATH将针对每种激活方式使用相应的设备进行测试。在设备同时支持OTA和ABP且固件版本相同的情况下，ATH将针对ABP设备运行完整的测试周期，然后仅针对OTA设备运行特定测试。

2.1.1. DUT预条件激活

在初始上电及激活后，如果DUT支持OTA而非ABP - DUT必须尽快（建议在10秒内）发送一个上行链路数据包。

此“我还活着”数据包的内容不重要。

TCL会对此数据包回复一个包含0x0601帧的下行链路负载，发送到端口224，将上行链路周期值设置为5秒。在设置上行链路周期值后，DUT必须尝试每5秒发送一个未确认/已确认的上行链路。

如果上行链路是由DUT发送的确认帧，TCL会向DUT发送一个TxFramesCtrlReq命令以发送更多未确认帧。

然后TCL检查DUT的ADR位设置，如果禁用，它会使用AdrBitChannelReq命令启用ADR位。

TCL接着将数据速率设置为Max125kHzDR，参考[2]，使用LinkADRReq命令。

TCL最后向DUT发送DutVersionsReq命令以获取设备的版本。

验证以下内容：

DUT在复位时递增DevNonce
DUT上行链路周期设置为5秒
DUT发送未确认的上行链路帧
DUT启用其ADR位
DUT将数据速率设置为Max125kHzDR
DUT发送DutVersionsAns响应中的版本信息。TCL必须存储此版本号以便在最终测试报告和证书中显示。

有关认证协议实现的更多详细信息，请参阅认证协议规范。[3].

2.1.1.a. 试验程序框架序列图

步骤	过程	帧序列		测试目的
步骤	过程	终端设备TCL	数据帧格式	测试目的
1	如果DUT（被测设备）= OTDA设备，DUT发送一个连接请求帧如果DUT = ABP设备，跳过步骤1。	→	数据速率（DR）= 任何允许的DR，参考[2] 注意DevNonce
1	TCL发送一个连接接受帧	←
2	如果DUT = OTDA设备，DUT发送一个连接请求帧如果DUT = ABP设备，跳过步骤3。	→	如果DUT是ABP设备且ADR位被设置，则DataRate（DR）= DUT允许的最小DR，参见[2]
2	TCL在RX1窗口发送连接接受响应	←	如果DUT发送确认上行链路帧，TCL必须确认 CP-CMD DutResetReq FPort = 224 有效载荷 = 【0x】01	对于ABP FC计划设备，如果使用8通道网关进行预测试，必须跳过步骤2和步骤3。
3	如果DUT = OTDA设备，DUT发送一个连接请求帧如果DUT = ABP设备，跳过步骤3	→	DevNonce大于之前JR的DevNonce
3	TCL在RX1窗口发送连接接受响应	←
4	DUT发送已确认或未确认帧 FCntUp = m 对于OTAA设备，m = 0或1 对于ABP设备，m > n	→	如果DUT是ABP设备，且ADR位被设置，则DataRate（DR）= DUT允许的最小DR，参见[2]
4	TCL发送未确认帧	←	CP-CMD TxPeriodicityChangeReq FPort = 224 周期 = 5 秒有效载荷 = 【0x】0601 如果DUT发送确认上行链路帧，TCL必须确认	Uplin 周期性设置
5	DUT发送已确认或未确认帧 FCntUp = m + 1	→	FPort = 除224以外的任何端口
5	如果DUT发送了确认帧，则TCL发送未确认帧。否则，必须跳过此步骤。	←	CP - CMD TxFramesCtrlReq FPort = 224 帧类型 = 未确认有效载荷 = [0x0701] 如果收到确认的上行链路帧，TLC必须确认
6	DUT 发送 Unconfirmed frame FCntUp = m + 2	→
6	如果FCtrl ADR位为false，则TCL发送未确认的帧，否则跳过此步骤	←	CP - CMD AdrBitChangeReq FPort = 224 有效载荷 = [0x0401]
7	DUT sends Unconfirmed frame FCntUp = m + 3	→	FCtrl ADR bit = true	打开 ADR 位
7	The TCL sends Unconfirmed frame	←	MAC-CMD LinkADRReq DataRate = Max125kHzDR, refer [2] Payload = [0x]03XXXXXXXX ChMaskCntl: DC = 0, FC = 6 ChMask: DC - Enable only default channels FC = [0x]00FF	对于使用8通道网关的FC设备，请参见第2节中的ChMask设置
8	DUT sends Unconfirmed frame in 5 seconds FCntUp = m + 4	→	MAC-CMD LinkADRAns Payload = [0x]0307	将DR更改为Max125kHz DR
8	The TCL sends Unconfirmed frame	←	CP-CMD DutVersionsReq FPort = 224 Payload = [0x]7F
9	DUT sends Unconfirmed frame FCntUp = m + 5		CP-CMD DutVersionsAns FPort = 224 Payload = [0x]7FXXXXXXXXXXXXXXX XXX	获取并存储DUT版本以备将来使用

注意：FCntUp值可以从0或1开始。一些安全元件实现会验证计数器值在执行加密操作之前严格大于之前的值。因此，在OTAA模式下将计数器值重置为0时，第一次执行加密操作时计数器会递增。在其他实现中，计数器值初始化为最大32位无符号值0xFFFFFFFF，该值在执行加密操作之前加1就变为0。

2.2. 空中激活

如果被测设备（DUT）支持空中激活，则必须执行此测试。测试验证了空中激活的正确功能。此外，还测试了Join-Accept框架中用于修改数据速率和接收窗口定时的字段（DLSettings 和 RXDelay），以验证合规性。

2.2.1 预加入行为

2.2.1.a 针对动态信道（DC）计划设备

TCL命令re-join，而DUT必须以加入请求帧响应。TCL会忽略这个Join-Request数据帧，直到DUT在所有默认信道上都作出响应，参考[2]。此后，TCL以Join_Accept帧响应。TCL最多等待（默认信道数量 * 3）个加入请求帧Join-Request，然后才以Join-Accept帧响应。

验证

DUT持续发送加入请求帧，直到TCL以加入接受帧响应。
所有默认信道必须在这些请求中至少使用一次。
记录初始加入请求的数据速率。
加入请求帧之间的持续时间大于JOIN_ACCEPT_DELAY2（即6秒）。
检查MAC报头中的主版本是否正确且RFU位设置为0。
DUT在加入请求中发送的DevNonce值必须在每个加入请求中递增。
DUT成功加入网络。

JoinNonce检查

TCL必须触发两次加入请求。第二次加入接受帧的加入Nonce值必须与第一次加入接受帧的相同。

TCL必须再次触发加入请求并发送具有不同加入Nonce值的加入接受帧。

验证

DUT接受第一个加入接受帧。
DUT拒绝第二个加入接受帧。
DUT在拒绝第二个加入接受帧后重新发送加入请求。
DUT在TCL发送具有不同加入Nonce值的加入接受帧后加入网络。

2.2.1.a.i 测试程序帧序列图

2.2.1.b. 对于固定信道（FC）规划设备

在TCL命令re-join重新加入之后，DUT通过DR-X和DR-Y信道（分别）以允许的最低数据率在125kHz和500kHz信道上发送加入请求帧Join_Request[2]。在信道从125kHz变为500kHz或反之被TCL识别之前，这会被忽略。最后一个加入请求消息表明信道改变已处理，服务器以加入接受响应。

验证

DUT通过DR-X信道在125kHz信道上以及通过DR-Y信道在500kHz信道上发送加入请求帧。例如：对于US902 - 928区域，加入请求必须在DR0上的随机125kHz信道和DR4上的500kHz信道上发送。
- 加入请求帧之间的持续时间大于JOIN_ACCEPT_DELAY2（即6秒）。
- 检查MAC报头中的主版本是否正确且RFU位设置为0。
- DUT在加入请求中发送的DevNonce值在每个加入请求中必须递增。
DUT成功重新加入网络。 TCL再次命令重新加入，DUT通过DR-X信道在125kHz信道上以及通过DR-Y信道在500kHz信道上发送加入请求消息。TCL不会对与上一次测试中相同的DR的请求作出响应。它仅对备用DR的加入请求作出响应。

验证

DUT通过向之前未响应的DR发送加入请求而成功加入。

JoinNonce检查

TCL必须触发两次加入请求。第二个加入接受帧中的DevNonce值必须与第一个加入接受帧中的相同。

TCL必须再次触发一个加入请求（Join-Request），并发送一个带有正确JoinNonce值的加入接受（Join-Accept）帧。

验证：

被测设备（DUT）接受第一个加入接受帧。
被测设备拒绝第二个加入接受帧。
被测设备在拒绝第二个加入接受帧后重新发送加入请求。
被测设备在TCL发送带有正确JoinNonce值的加入接受帧后加入网络。

2.2.1.b.i测试程序帧序列图

2.2.1.b 针对前向信道（FC）计划设备

在TLC发出重新加入命令后，DUT会分别通过125kHz和500kHz信道发送加入请求帧，这些信道的最低数据速率分别适用于这些信道（DR-X和DR-Y），参见[2]。在信道改变被TLC识别之前，服务器会忽略此操作，即从125kHz的DR-X信道或500kHz的DR-Y信道改变为另一个信道。最后一个加入请求消息表明信道改变已处理，服务器会以加入接受消息作为响应。

验证

DUT通过125kHz信道使用DR-X以及500kHz信道使用DR-Y发送加入请求帧。例如：对于US902 - 928区域，加入请求必须在D0的随机125kHz信道上发送，并且在D4的随机500kHz信道上发送。
加入请求帧之间的持续时间大于JOIN_ACCEPT_DELAY2（6秒）。
检查MAC报头中的主版本号以及射频单元（RFU）位是否设置为0。
DUT在每个加入请求中发送的DevNonce值必须递增。
DUT成功加入网络。

TLC再次发出重新加入命令，DUT通过125kHz信道使用DR-X以及500kHz信道使用DR-Y发送加入请求消息。TLC不会响应与之前测试中相同DR的请求。它仅响应具有备用DR的加入请求。

验证

DUT通过向之前未响应的DR发送加入请求而成功加入。

JoinNonce检查

TLC必须触发两次加入请求。第二个加入接受帧中的DevNonce值必须与第一个加入接受帧中的相同。

2.2.2. 加入接受（Join-Accept）与下行链路设置（DLSettings）

在TCL触发加入请求（Join-Request）后，被测设备（DUT）开始通过空中接口（over-the-air）执行加入过程以进行激活。TCL使用包含RX1DRoffset=2和RX2DataRate=任何适用数据率（除[21]中定义的默认RX2DataRate外）的加入接受（Join-Accept）帧进行响应。加入过程成功后，TCL向RX1窗口发送一个回声（echo）命令，被测设备（DUT）必须正确响应。接下来，TCL向RX2窗口发送一个回声命令，被测设备（DUT）也必须正确响应。

验证：

被测设备（DUT）成功加入网络。
被测设备（DUT）在处理加入接受（Join-Accept）后正确实现了RX1DRoffset设置。

2.2.2.a. 测试程序框架序列图

2.2.3. 带延迟设置的加入接受（Join-Accept）

在TCL触发JoinRequest之后，被测设备（DUT）开始进行上述空中激活的加入过程。TCL用一个包含RX2窗口延迟设置的Join-Accept帧进行响应，使得RX1以及随后的RX2定时增加（建议至少增加2秒）。TCL向RX1发送一个回显命令，DUT必须正确响应。TCL针对RX2重复相同的下行链路测试，DUT也必须正确响应。

验证