ZigBee学习之10——MAC层API解读

回调函数事件

呵呵，名字很恐怖，其实就是用来应答请求函数的函数调用而已，不要想的太深奥哦！

MAC_MLME_ASSOCIATE_IND

当MAC从其他器件接收到关联请求时发送给应有。应用在接收到这个事件后必须调用 MAC_MlmeAssociateRsp()，这个事件只发送给FFD应用，且这个FFD的PIB属性MAC_ASSOCIATION_PERMIT为真。

MAC_MLME_ASSOCIATE_CNF

作为对MAC_MlmeAssociateReq()的回应，MAC发送这个事件到应用，此事件指示了关联的状态，如果关联成功且请求了短地址，则短地址将被包含在事件中，否则短地址参数不可用。

MAC_MLME_DISASSOCIATE_IND

指示器件已经解关联

MAC_MLME_DISASSOCIATE_CNF

作为MAC_MlmeDisassociateReq()的回应发送给应用，此事件指示解关联操作的状态。

MAC_MLME_BEACON_NOTIFY_IND

当MAC接收到一个信标帧并且信标帧包含负载数据或者MAC_AUTO_REQUEST属性为FALSE时发送次事件到应有，此事件也包含LQI测量值、信标帧接收时间。

MAC_MLME_ORPHAN_IND

MAC_MLME_SCAN_CNF

MAC_MLME_START_CNF

MAC_MLME_SYNC_LOSS_IND

MAC_MLME_POLL_CNF

MAC_MLME_COMM_STATUS_IND

发送这个事件的原因有多种，比如指示MAC_MlmeAssociateRsp()和MAC_MlmeOrphanRsp()的状态，也可以指示MAC接收到安全帧，但是安全处理出错。

MAC_MLME_POLL_IND

只有在MAC用一系列间接数据配置，设置macCfg.appPendingQueue为真，才能发送这个事件。当从其他设备接收到数据请求命令帧时发送此事件，应用应该调用MAC_McpsDataReq()来发送数据到那个设备，并且配置TX属性为MAC_TXOPTION_NO_RETRANS设置。

扩展接口

提供了一些非802.15.4协议定义的函数，比如电源管理。

通用常量和数据结构

电源模式

MAC_PWR_ON      MAC和无线电电源打开

MAC_PWR_SLEEP_LITE  MAC和无线电部分电源关闭

MAC_PWR_SLEEP_DEEP  MAC和无线电完全电源关闭

uint8 MAC_PwrOffReq(uint8 mode)

请求MAC关闭无线电硬件电源并进入睡眠模式，

返回值：

MAC_SUCCESS     操作成功

MAC_DENIED      MAC不能关闭电源

void MAC_PwrOnReq(void)

请求MAC打开无线电硬件电源并唤醒设备

uint8 MAC_PwrMode(void)

返回MAC当前电源模式

uint32 MAC_PwrNextTimeout(void)

返回下一次MAC定时器超时，如果没有定时器运行则返回0

uint8 MAC_RandomByte(void)

从MAC随机数产生器返回一个随机字节

回调接口

void MAC_CbackEvent(macCbackEvent_t *pData)

发送MAC事件到应用，这个函数的执行需要分配一个OSAL消息，然后将事件参数拷贝到消息，然后将消息发送到应用OSAL事件处理函数。这个函数必须从任务或者是中断上下文执行，所以它是可重入的。

参数：

typedef struct

{

  uint8   event;

  uint8   status;

} macEventHdr_t;

 

typedef union

{

  macEventHdr_t            hdr;

  macMlmeAssociateInd_t    associateInd;

  macMlmeAssociateCnf_t    associateCnf;

  macMlmeDisassociateInd_t disassociateInd;

  macMlmeDisassociateCnf_t disassociateCnf;

  macMlmeBeaconNotifyInd_t beaconNotifyInd;

  macMlmeOrphanInd_t       orphanInd;

  macMlmeScanCnf_t         scanCnf;

  macMlmeStartCnf_t        startCnf;   

  macMlmeSyncLossInd_t     syncLossInd;

  macMlmePollCnf_t         pollCnf;

  macMlmeCommStatusInd_t   commStatusInd;

  macMlmePollInd_t         pollInd;

  macMcpsDataCnf_t         dataCnf;

  macMcpsDataInd_t         dataInd;

  macMcpsPurgeCnf_t        purgeCnf;

} macCbackEvent_t;

hdr.event域为下面一些值

MAC_MLME_ASSOCIATE_IND  Associate indication.

MAC_MLME_ASSOCIATE_CNF  Associate confirm.

MAC_MLME_DISASSOCIATE_IND  Disassociate indication.

MAC_MLME_DISASSOCIATE_CNF  Disassociate confirm.

MAC_MLME_BEACON_NOTIFY_IND  Beacon notify indication.

MAC_MLME_ORPHAN_IND  Orphan indication.

MAC_MLME_SCAN_CNF  Scan confirm.

MAC_MLME_START_CNF  Start confirm.

MAC_MLME_SYNC_LOSS_IND  Sync loss indication.

MAC_MLME_POLL_CNF  Poll confirm.

MAC_MLME_COMM_STATUS_IND  Communication status indication.

MAC_MLME_POLL_IND  Poll indication.

MAC_MCPS_DATA_CNF  Data confirm.

MAC_MCPS_DATA_IND  Data indication.

MAC_MCPS_PURGE_CNF  Purge confirm.

MAC_PWR_ON_CNF  Power on confirm.

uint8 MAC_CbackCheckPending(void)

返回应用中的间接消息队列

配置

配置常量

MAC用数据结构来包含多种用户配置参数。这个数据结构叫macCfg在mac_cfg.c中定义

typedef struct

{

  uint8   txDataMax;

  uint8   txMax;

  uint8   rxMax;

  uint8   dataIndOffset;

  bool    appPendingQueue;

} macCfg_t;

txDataMax   传输数据队列中的最大数据帧队列数目，范围：1-255，默认值：   2

txMax       传输数据队列中的最大帧队列数目，范围：1-255，默认值：  5

rxMax       接收数据队列中的数据帧队列数目，范围：1-255，默认值：  2

dataIndOffset   为应用定义的头发配额外的数据字节，范围：0-127，默认值： 0

appPendingQueue当设置为真时，在从其他设备接收到数据请求帧将发送MAC_MLME_POLL_IND，默认值为FALSE

编译时配置

MAC源码有一些编译时配置的参数。

MAC_NO_PARAM_CHECK      设置为FALSE，则会检测API函数的参数是否符合IEEE规范。设置为TRUE则可以减少代码量，默认为FALSE

MACNODEBUG          如果定义了这个宏，则允许MAC_ASSERT()进行运行时检测。不定义这个宏可以优化代码量

MAC_RX_ONOFF_DEBUG_LED  如果为TRUE，LED将会随着接收的开关而开关。

在文档的最后画出了如果用API函数构建网络，进行通信的梯形图，呵呵早知道有这个，就直接看这个了，不细心阿！不过看来这个文档之后对ZigBee的组网方式有了一定的了解，起码心里有个底了，知道网络是如何建立的，一个新设备如何加入到一个网络中。