LNS协议¶

版本消息¶

第一站发送的消息是一个版本消息,报告对LNS的版本信息(例如,站,固件,模型),协议版本(常数2现在),和一个可选特性列表支持的网关。那就是:

{“msgtype”:“版本”“站”:字符串“固件”:字符串“包”:字符串“模型”:字符串“协议”:INT“特征”:字符串}

的特性字符串的空格分隔的列表下面的关键词:

• rmtsh车站:支持远程shell访问与LNS通过建立WebSocket连接。

• 刺激:车站是建立在生产水平,也就是说,某些测试和调试功能可能被禁用。

• 全球定位系统(gps)车站能够访问一个GPS设备。

router_config消息¶

LNS必回复版本消息,该消息带有一个router_config消息指定一个电台频道计划和定义一些基本操作模式:

{“msgtype”:“router_config”“NetID”:(INT,。。]“JoinEui”:((INT,INT),。。]/ /范围:乞讨,包容“地区”:字符串/ /可选的,如“EU868”、“US915”. .“max_eirp”:浮动/ /可选“hwspec”:字符串“freq_range”:(INT,INT]/ /分钟,马克斯(赫兹)“博士”:((INT,INT,INT),。。]/ /科幻、bw dnonly“sx1301_conf”:(SX1301CONF,。。]“bcn”::BCNCONF“nocca”:BOOL“nodc”:BOOL“nodwell”:BOOL}

的字段NetID和JoinEui用于过滤罗拉帧接收到车站。NetID是接受NetID值的列表。任何罗拉数据帧携带NetID以外的上市将会下降。JoinEui是对整数值的列表加入行编码范围。加入请求帧将下降了车站,除非该领域JoinEui在消息满足条件BegEui < = JoinEui < = EndEui至少一对[BegEui, EndEui]。

的字段nocca,nodc,nodwell只在调试版的车站。他们的目的是禁用某些监管输电约束,即clear channel评估、频宽比限制,和停留时间限制。

的地区字段中指定的区域渠道计划。它控制某些监管行为如clear channel评估、频宽比限制和停留时间限制。有效的名字是兼容常见名字LoRaWAN区域参数规范中指出。此外,为了向后兼容,除外,以下名称映射到各自的名称在括号:EU863 (EU868) US902 (US915)。如果省略该字段然后站在一个地区不可知论者模式。

的max_eirp字段指定一个maxmimum输出功率。如果没有这个字段,那么有针对性马克斯附近使用价值。在缺席的情况下区域说明符,它默认为14。如果max_eirp存在,只有通过降低区域价值。

的hwspec字段描述所需的集中器硬件操作通道计划交付router_config消息。指定字符串必须有以下形式:sx1301 / N,在那里N表示SX1301集中器芯片的数量需要操作通道计划。车站将检查这个需求对其硬件功能。

的freq_range字段定义的可用频谱的上限和下限为该地区集。车站不允许这个频率范围以外的下行传输。

的DRs通道内的字段定义了可用的数据率的计划。它必须是一个数组的16个条目。每个条目是一个数组的三(3)整数编码扩频因子(科幻小说)、带宽(BW),以及一个DNONLY国旗。科幻小说必须在7 - 12范围罗拉®,或0移频键控。BW必须的数字:125,250,500。BW移频键控的被忽略。

的sx1301_conf字段定义了如何映射到单个SX1301芯片通道计划。它的值是一个数组SX1301CONF对象。数组元素的数量必须符合的价值hwspec字段。

的布局SX1301CONF对象是这样的:

{“radio_0”:{。。}/ /与radio_1相同的结构“radio_1”:{“启用”:BOOL,“频率”:INT},“chan_FSK”:{“启用”:BOOL,“广播”:0|1,“如果”:INT},“chan_Lora_std”:{“启用”:BOOL,“广播”:0|1,“如果”:INT,“带宽”:INT,“spread_factor”:INT},“chan_multiSF_0”:{。。}/ / _0 . ._7都有相同的结构。。“chan_multiSF_7”:{“启用”:BOOL,“广播”:0|1,“如果”:INT}}

的bcn字段是没有一个或BCNCONF对象布局如下:

{“博士”:INT“布局”:(INT,INT,INT]“频率”:(INT,。。]}

这些字段的值可以从区域中提取目的规范LoRaWAN标准。的博士字段定义了数据率用于灯塔。的布局消息的字段指定插入的八位字节偏移量字段时间和GwSpecific,其次是beacom PDU的长度。的频率字段定义了广播的频率信号。一个典型的设置将{“博士”:3,“布局”:[2,8,17],“频率”:为区域EU868 [869525000]。

电台的元数据¶

以下字段的所有消息编码LoRaWAN广播帧。这些字段反映任何附带的元数据和时间信息广播帧:

{…“博士”:INT,“频率”:INT,“upinfo”:{“rctx”:INT64,“xtime”:INT64,“gpstime”:INT64,“rssi”:浮动,“信噪比”:浮动}}

的博士字段是数据帧接收速率;可能的值是整数的范围从0到15。的频率在赫兹编码接收频率。可能的值的博士和频率取决于当前频道的计划。

的upinfo对象包含一些站所需的上下文来处理后续匹配下行帧。的字段rctx和xtime通过LNS传递,必须添加到下行消息匹配的类。

的gpstime字段是接收帧的时间戳,表达了GPS时代以来微秒。如果车站没有访问PPS GPS时间同步,这个字段的值是0。

LoRaWAN加入请求¶

加入请求帧解析和各个部分返回字段,如下所示。这种类型的消息也字段中讨论电台的元数据。

{“msgtype”:“jreq”,“MHdr”:使用UINT,“JoinEui”:行,,“DevEui”:行,,“DevNonce”:使用UINT,“麦克风”:INT32,。。}

LoRaWAN数据帧¶

数据帧解析和各个部分返回字段,如下所示。这种类型的消息也领域讨论的部分电台的元数据。

{“msgtype”:“updf”,“MHdr”:使用UINT,“DevAddr”:INT32,“FCtrl”:使用UINT,“FCnt”,:使用UINT,“录像”:“六角”,“FPort”:INT(- - - - - -1 . . 255),“FRMPayload”:“六角”,“麦克风”:INT32,。。}

如果帧不包含一个港口,字段的值FPort是1。如果不带选项或数据帧,字段的值录像或FRMPayload分别将空字符串。否则这些字段包含十六进制字符的字符串。

LoRaWAN专有的帧¶

帧标记为私有转发以下形式,即整个帧载荷沿粗略的传递。这种类型的消息也领域讨论的电台的元数据的话题。

{“msgtype”:“propdf”,“FRMPayload”:“六角”,。。}

发送确认¶

车站承认LNS的传输请求消息的类型dntxed。这个消息只发送一帧被实况转播的。没有反馈LNS如果不能发送一帧(例如,因为它已经太迟了,有一个冲突不断传播,或网关的工作周期是耗尽)。总结了这些条件在健康状态信息,不引发个体的反应。

{“msgtype”:“dntxed”,“也”发誓:INT64,“DevEui”:“行,”,“rctx”:INT64,“xtime”:INT64,“txtime”:浮动,“gpstime”:INT64}

的diid字段是一个副本diid字段dnmsg消息。它能够识别一个特定的设备交互和使用LNS引用一些内部状态。它是传递不变的车站。

的rctx字段指定用于传输的天线,xtime场的内部时间帧时将实况转播的。

单帧下行¶

站支持下行的A类、B和c三个类,使用相同的消息类型,但不同领域需要礼物。

一个类一下行框架是一个回应此前发送的上行。类的布局需要以下字段:

{“msgtype”:“dnmsg”,“DevEui”:“行,”,“直流”:0,/ /类“也”发誓:INT64,“pdu”:“六角”,“RxDelay”:INT(15 0 . .),“RX1DR”:INT(15 0 . .),“RX1Freq”:INT,“RX2DR”:INT(15 0 . .),“RX2Freq”:INT,“优先”:INT(255年0 . .),“xtime”:INT64,“rctx”:INT64}

的diid字段是一个数字发行的LNS识别一个特定的设备交互。这两个,diid和DevEui站的传递吗dntxed消息。DevEui的情况下可以使用LNS维护吗diid作为一个特定于设备的标识符。同时,知道了DevEUI特定的下行所属可以有利于检查网关日志。LNS可以选择集DevEUI任何非零值。的pdu字段是广播帧,因为它将实况转播的。

车站会选择RX1或RX2传输参数,在RX1优先。如果帧到达太晚,或者传输阻塞,它将尝试RX2。力决定,LNS可以省略RX1或RX2参数。在任何情况下,RxDelay之间的延迟是年底RX1开始上行传输和接收设备的窗口。准确的结束时间是隐式地编码在传播xtime。RxDelay应该有相同的价值吗RxDelay在加入接受消息。站会自动推断RX2延迟增加1秒。

的优先级字段是遇到冲突时使用的传输请求。LNS可以更高的优先级帧携带确认或一些重要的MAC命令。如果两个帧冲突,越高优先级值是首选。

的xtime和rctx字段包含的值来自相应的上行消息。这些值必须被LNS传递而不被改变。他们使用的车站管理适当的传输时间和处理天线关联。

一个C类下行框架回答一个上行和旨在RX1,看起来几乎相同的类dnmsg消息。唯一的区别是直流声明一个C类交互。如果传输不能使RX1机会,车站就会切换到RX2参数和选择一个方便的时间发送帧。有一个最长时间站将推迟之前传输帧将被丢弃。自从RX2下行机会为C类设备是任意的,RxDelay只是用来计算RX1机会在这种情况下。

{“msgtype”:“dnmsg”,“DevEui”:“行,”,“直流”:2,/ / C类“也”发誓:INT64,“pdu”:“六角”,“RxDelay”:INT(15 0 . .),“RX1DR”:INT(15 0 . .),“RX1Freq”:INT,“RX2DR”:INT(15 0 . .),“RX2Freq”:INT,“优先”:INT(255年0 . .),“xtime”:INT64,“rctx”:INT64}

一个C类下行不回答一个上行帧必须在下面的例子中显示的字段。传输将推迟到车站发现一个方便的时间段。如果没有这样的机会,框架将下降后可配置的时间;默认是一个(1)。

虽然rctx字段是可选的,它可以用来选择天线的偏好。LNS可以复制这个领域从先前的a类上行和指导车站使用相同的天线收到该类上行。

{“msgtype”:“dnmsg”,“DevEui”:“行,”,“直流”:2,/ / C类“也”发誓:INT64,“pdu”:“六角”,“RX2DR”:INT(15 0 . .),“RX2Freq”:INT,“优先”:INT(255年0 . .),“rctx”:INT64}

一个B类下行框架需要以下字段:

{“msgtype”:“dnmsg”,“DevEui”:“行,”,“直流”:1,/ / B类“也”发誓:INT64,“pdu”:“六角”,“博士”:INT(15 0 . .),“频率”:INT,“优先”:INT(255年0 . .),“gpstime”:INT64,“rctx”:INT64}

类B帧的传输要求LNS提供GPS-aligned时间。GPS时代以来的值是用毫秒表示。

可选rctx字段可以用来选择天线的偏好。LNS可能复制这类字段从先前的上行和指导车站使用相同的天线收到该类上行。

多播的时间表¶

消息的类型dnsched可以用来安排一组多播消息。每个消息的元素需要指定一个GPS时间应当被发送。这种类型的传输不会生成dntxed从车站的反应。

{“msgtype”:“dnsched”,“安排”:({“pdu”:“六角”,“博士”:INT(15 0 . .),“频率”:INT,“优先”:INT(255年0 . .),“gpstime”:INT64,“rctx”:INT64},…]}

可选rctx字段可以用来选择天线的偏好。LNS可能复制这类字段从先前的上行和指导车站使用相同的天线收到该类上行。

PPS GPS时间同步¶

如果一个站访问PPS一致的GPS秒,它会推断出GPS时间同步与LNS通过运行一个协议。推断出正确的GPS时间标签对于给定的PPS脉冲,车站将继续发送timesync上行消息LNS下游应及时回答timesync消息。

格式的上游信息:

{“msgtype”:“timesync”“txtime”:INT64,}

下游反应后应立即由LNS发送接收相应的上游timesync。LNS将插入gpstime场和通过txtime场,收到站,txtime一些当地未指定的时间到车站。

这个领域gpstime标志着当时LNS的即时处理timesync消息。它的值是GPS时代以来的时间以微秒为单位。

{“msgtype”:“timesync”“txtime”:INT64,“gpstime”:INT64}

将GPS时间¶

LNS应当定期发送以下信息传输GPS时间到车站。

{“msgtype”:“timesync”“xtime”:INT64,“gpstime”:INT64}

这个领域xtime特定的车站和GPS时间推断从上游帧到达LNS重叠。