LoRaWAN协议解析 第5章 MAC命令

1 前言

我正在陆续对《LoRaWAN102》即LoRaWAN协议规范 V1.0.2 版本(2016年7月定稿)协议的各个章节进行翻译。译文之外还对LoRaWAN协议和源码进行了解析，可点此查看帖子LoRa学习笔记_汇总。

欢迎同行朋友们留言交流。

本文作者twowinter，转载请注明作者：http://blog.csdn.net/iotisan/

2 梳理解析

从LoRaWAN第4章的帧格式可以得到如下信息：MAC命令，要么使用FPort0来单独传输，要么使用非零的FPort来和数据一起传输。

LoRaWAN第5章，LoRaWAN出于网络管理需要，提出了9条MAC命令，这个章节是对9条命令进行具体的描述。

说个题外话，CLAA(中国LoRa应用联盟)在9条命令以外还扩充了一些MAC命令。现阶段协议还不能公开，所以我就不多说了。中兴目前作为LoRa联盟董事会成员，也许以后会把这些拓展MAC命令引入到LoRaWAN协议也说不准，大家暂且当个课外知识了解下就好。

3 代码位置

MAC命令枚举

/*!
* LoRaMAC mote MAC commands
*
* LoRaWAN Specification V1.0.1, chapter 5, table 4
*/
typedef enum eLoRaMacMoteCmd
{
/*!
* LinkCheckReq
*/
MOTE_MAC_LINK_CHECK_REQ          = 0x02,
/*!
* LinkADRAns
*/
MOTE_MAC_LINK_ADR_ANS            = 0x03,
/*!
* DutyCycleAns
*/
MOTE_MAC_DUTY_CYCLE_ANS          = 0x04,
/*!
* RXParamSetupAns
*/
MOTE_MAC_RX_PARAM_SETUP_ANS      = 0x05,
/*!
* DevStatusAns
*/
MOTE_MAC_DEV_STATUS_ANS          = 0x06,
/*!
* NewChannelAns
*/
MOTE_MAC_NEW_CHANNEL_ANS         = 0x07,
/*!
* RXTimingSetupAns
*/
MOTE_MAC_RX_TIMING_SETUP_ANS     = 0x08,
}LoRaMacMoteCmd_t;

/*!
* LoRaMAC server MAC commands
*
* LoRaWAN Specification V1.0.1 chapter 5, table 4
*/
typedef enum eLoRaMacSrvCmd
{
/*!
* LinkCheckAns
*/
SRV_MAC_LINK_CHECK_ANS           = 0x02,
/*!
* LinkADRReq
*/
SRV_MAC_LINK_ADR_REQ             = 0x03,
/*!
* DutyCycleReq
*/
SRV_MAC_DUTY_CYCLE_REQ           = 0x04,
/*!
* RXParamSetupReq
*/
SRV_MAC_RX_PARAM_SETUP_REQ       = 0x05,
/*!
* DevStatusReq
*/
SRV_MAC_DEV_STATUS_REQ           = 0x06,
/*!
* NewChannelReq
*/
SRV_MAC_NEW_CHANNEL_REQ          = 0x07,
/*!
* RXTimingSetupReq
*/
SRV_MAC_RX_TIMING_SETUP_REQ      = 0x08,
}LoRaMacSrvCmd_t;

MAC命令的接收处理

OnRadioRxDone()携带着MAC帧进来，经过层层筛选，最终到达ProcessMacCommands()来处理MAC命令。

这里代码中涉及的两种处理方式，可以跟协议对应起来：port = 0时，MAC命令放在FRMPayload中，需要先解密再处理；port非零时，MAC命令放在fopts中。

if( port == 0 )
{
if( fCtrl.Bits.FOptsLen == 0 )
{
LoRaMacPayloadDecrypt( payload + appPayloadStartIndex,
frameLen,
nwkSKey,
address,
DOWN_LINK,
downLinkCounter,
LoRaMacRxPayload );

// Decode frame payload MAC commands
ProcessMacCommands( LoRaMacRxPayload, 0, frameLen, snr );
}
} else {
if( fCtrl.Bits.FOptsLen > 0 )
{
// Decode Options field MAC commands. Omit the fPort.
ProcessMacCommands( payload, 8, appPayloadStartIndex - 1, snr );
}
}

MAC命令的发送及回复

MAC命令的发送及回复处理都在这个函数中，AddMacCommand()。

协议栈对MAC命令发送的处理还是比较简单的，都是放在Fopts中来传输，都在这个15字节的MacCommandsBuffer中。

End

That’s all.