1、第 1 章 介绍本文档描述了 LoRaWAN 网络协议，是针对电池供电的终端设备(不管移动还是固定位置)进行优化的一套网络协议。LoRaWAN 网络通常采用星型拓扑结构，由拓扑中的网关来转发终端与后台网络服务器间的消息。网关通过标准 IP 连接来接入网络服务器 ，而终端则通过单跳的 LoRa 或者 FSK 来和一个或多个网关通讯。虽然主要传输方式是终端上行传输给网络服务器，但所有的传输通常都是双向的。终端和网关间的通讯被分散到不同的信道频点和数据速率上。数据速率的选择需要权衡距离和消息时长两个因素，使用不同数据速率的设备互不影响。LoRa 的数据速率范围可以从 0.3kbps 到 50kbps
2、。为了最大程度地延长终端的电池寿命和扩大网络容量，LoRa 网络使用速率自适应(ADR)机制来独立管理每个终端的速率和RF 输出。虽然每个设备可以在任意信道，任意时间，发送任意数据，但需要注意遵守如下规定： 终端的每次传输都使用伪随机方式来改变信道。频率的多变使得系统具有更强的抗干扰能力。 终端要遵守相应频段和本地区的无线电规定中的发射占空比要求。 终端要遵守相应频段和本地区的无线电规定中的发射时长要求。twowinter 注：发射占空比，意思是发射时长占总时长的比例。按照无线电规定，每个设备不能疯狂发射霸占信道，总得给别人一点机会。这份文档主要讲述协议细节，一些基于各地区规定的操作参数，例如
3、发射占空比和发射时长等，在另一份文档LoRaWAN 地区参数 中做具体描述。将这份文档分开，是为了加入新地区参数时不影响基础的协议规范。1.1 LoRaWAN Classes所有的 LoRaWAN 设备都必须至少实现本文档描述的 Class A 功能。另外也可以实现本文档中描述的 Class B 和 Class C 及后续将定义的可选功能。不管怎么样，设备都必须兼容 Class A。1.2 文档约定MAC 命令的格式写作 LinkCheckReq (粗斜体)，位和位域的格式写作FRMPayload (粗体) ，常量的格式写作 RECEIVE_DELAY1，变量的格式写作 N。在本文档中， 所有
4、多字节字段的字节序均采用小端模式 EUI 是 8 字节字段，采用小端模式传输 默认所有 RFU 保留位都设为 0第 2 章 LoRaWAN Classes 类型介绍LoRa 是由 Semtech 面向长距离、低功耗、低速率应用而开发的无线调制技术。本文档中，将 Class A 基础上实现了更多功能的设备称为“更高 class 终端”。2.1 LoRaWAN ClassesLoRa 网络包含基础 LoRaWAN（称之为 Class A）和可选功能（Class B，Class C）:图 1.LoRaWAN Classes 双向传输终端(Class A)： Class A 的终端在每次上行后都会紧跟
5、两个短暂的下行接收窗口，以此实现双向传输。传输时隙是由终端在有传输需要时安排，附加一定的随机延时(即 ALOHA 协议)。这种 Class A 操作是最省电的，要求应用在终端上行传输后的很短时间内进行服务器的下行传输。服务器在其他任何时间进行的下行传输都得等终端的下一次上行。 划定接收时隙的双向传输终端(Class B)： Class B 的终端会有更多的接收时隙。除了 Class A 的随机接收窗口，Class B 设备还会在指定时间打开别的接收窗口。为了让终端可以在指定时间打开接收窗口，终端需要从网关接收时间同步的信标 Beacon。这使得服务器可以知道终端正在监听。 最大化接收时隙的双向
6、传输终端(Class C)： Class C 的终端基本是一直打开着接收窗口，只在发送时短暂关闭。Class C 的终端会比 Class A 和 Class B 更加耗电，但同时从服务器下发给终端的时延也是最短的。2.2 文档范围这份 LoRaWAN 协议还描述了与 Class A 不同的其他 Class 的额外功能。更高 Class 的终端必须满足 Class A 定义的所有功能。注意：物理层帧格式，MAC 帧格式，以及协议中更高 class 和 Class A 相同的内容都写在了 Class A 部分，避免内容重复。第 3 章 PHY 帧格式LoRa 有上行消息和下行消息。3.1 上行消息
7、上行消息是由终端发出，经过一个或多个网关转发给网络服务器。上行消息使用 LoRa 射频帧的严格模式，消息中含有 PHDR 和 PHDR_CRC 。载荷有 CRC 校验来保证完整性。PHDR，PHDR_CRC 及载荷 CRC 域都通过射频收发器加入。上行 PHY:Preamble PHDR PHDR_CRC PHYPayload CRC图 2.上行 PHY 帧格式3.2 下行消息下行消息是由网络服务器发出，经过单个网关转发给单个终端。下行消息使用射频帧的严格模式，消息中包含 PHDR 和 PHDR_CRC。下行 PHY:Preamble PHDR PHDR_CRC PHYPayload图 3.下
8、行 PHY 帧格式3.3 接收窗口每个上行传输后终端都要开两个短的接收窗口。接收窗口开始时间的规定，是以传输结束时间为参考。图 4.终端接收时隙的时序图3.3.1 第一接收窗口的信道，数据速率和启动。第一接收窗口 RX1 使用的频率和上行频率有关，使用的速率和上行速率有关。RX1 是在上行调制结束后的 RECEIVE_DELAY1 秒打开。上行和 RX1 时隙下行速率的关系是按区域规定，详细描述在LoRaWAN 地区参数文件中。默认第一窗口的速率是和最后一次上行的速率相同。3.3.2 第二接收窗口的信道，数据速率和启动。第二接收窗口 RX2 使用一个固定可配置的频率和数据速率，在上行调制结束后
9、的 RECEIVE_DELAY2 秒打开。频率和数据速率可以通过 MAC 命令(见 第 5 章)。默认的频率和速率是按区域规定，详细描述在LoRaWAN 地区参数文件中。3.3.3 接收窗口的持续时间接收窗口的长度至少要让终端射频收发器有足够的时间来检测到下行的前导码。3.3.4 接收方在接收窗口期间的处理如果在任何一个接收窗口中检测到前导码，射频收发器需要继续激活，直到整个下行帧都解调完毕。如果在第一接收窗口检测到数据帧，且这个数据帧的地址和MIC 校验通过确认是给这个终端，那终端就不必开启第二个接收窗口。3.3.5 网 络发 送消息给终端如果网络想要发一个下行消息给终端，它会精确地在两个接
10、收窗口的起始点发起传输。3.3.6 接收窗口的重要事项终端在第一或第二接收窗口收到下行消息后，或者在第二接收窗口阶段，不能再发起另一个上行消息。3.3.7 其他 协议 的收发处理节点在 LoRaWAN 收发窗口阶段可以收发其他协议，只要终端能满足当地要求以及兼容 LoRaWAN 协议。2 梳理解析LoRaWAN 第 3 章，主要是讲了接收窗口这回事，只要记住张图就行。目前 RX1 一般是在上行后 1 秒开始，RX2 是在上行后 2 秒开始。3 源 码 分析3.1 源码流程在梳理这章节的对应代码时，自己手动做了张思维导图。有时是这样，代码再有层次感，也不及一个图。好，请收下。3.2 发送完成就开
11、始 RX1 和 RX2 延时static void OnRadioTxDone( void )./ Setup timersif( IsRxWindowsEnabled = true )TimerSetValue( TimerStart( if( LoRaMacDeviceClass != CLASS_C )TimerSetValue( TimerStart( if( ( LoRaMacDeviceClass = CLASS_C ) | ( NodeAckRequested = true ) )TimerSetValue( TimerStart( .3.3 接收窗口的射频处理从上面一步，我们已
12、经清晰的知道，对应的处理肯定是在OnRxWindow1TimerEvent 和 OnRxWindow2TimerEvent 中。 这两个接收窗口的处理，会对速率和信道进行设置，按照 LoRaWAN 协议中文版_配套文件 地区参数(物理层) 中对各地区的要求分别进行处理。比如这个 470 的处理，对上行信道对 48 取余得到下行信道。RxWindowSetup( LORAMAC_FIRST_RX1_CHANNEL + ( Channel % 48 ) * LORAMAC_STEPWIDTH_第 4 章 MAC 帧格式LoRa 所有上下行链路消息都会携带 PHY 载荷，PHY 载荷以 1 字节 M
13、AC 头(MHDR)开始，紧接着 MAC 载荷(MACPayload)，最后是 4 字节的 MAC 校验码(MIC)。射频 PHY 层：Preamble PHDR PHDR_CRC PHYPayload CRC图 5.射频 PHY 结构( 注意 CRC 只有上行链路消息中存在)PHY 载荷：MHDR MACPayload MIC或者MHDR Join-Request MIC或者MHDR Join-Response MIC图 6.PHY 载荷结构MAC 载荷：FHDR FPort FRMPayload图 7.MAC 载荷结构FHDR：DevAddr FCtrl FCnt FOpts图 8.帧头结构图 9.LoRa 帧格式元素 (即图 58)4.1 MAC 层(PHYPayload)Size (bytes) 1 1.M 4PHYPayload MHDR MACPayload MICMACPayload 字段的最大长度 M，在第 6 章有详细说明。4.2 MAC 头(MHDR 字段)Bit# 7.5 4.2 1.0MHDR bits MType RFU Major
