zstack终端请求绑定方式分析

1、ZDO终端设备绑定请求:设备能告诉协调器他们想建立绑定表格报告。该协调器将使协调并在这两个设备上创建绑定表格条目。在这里是以SerialApp例子为例。void SerialApp_HandleKeys( uint8 shift, uint8 keys )   zAddrType_t dstAddr;   if ( shift )      if ( keys & HAL_KEY_SW_1 )            i

2、f ( keys & HAL_KEY_SW_2 )            if ( keys & HAL_KEY_SW_3 )            if ( keys & HAL_KEY_SW_4 )            else      if ( keys &

3、 HAL_KEY_SW_1 )            if ( keys & HAL_KEY_SW_2 )         HalLedSet ( HAL_LED_4, HAL_LED_MODE_OFF );      /终端设备绑定请求      / Initiate an End Device Bind Reques

4、t for the mandatory endpoint      dstAddr.addrMode = Addr16Bit;      dstAddr.addr.shortAddr = 0x0000; / Coordinator      ZDP_EndDeviceBindReq( &dstAddr, NLME_GetShortAddr(),       &

5、#160;                    SerialApp_epDesc.endPoint,                         

6、0;  SERIALAPP_PROFID,                            SERIALAPP_MAX_CLUSTERS,              

7、0;             (cId_t *)SerialApp_ClusterList,                            SERIALAPP_MAX_CLUSTERS, &#

8、160;                          (cId_t *)SerialApp_ClusterList,                   

9、         FALSE );        if ( keys & HAL_KEY_SW_3 )            if ( keys & HAL_KEY_SW_4 )          HalLedSet ( HAL_LED_4, HAL_LED_MODE_OF

10、F );      /描述符匹配请求 这也是两不同匹配方式，使用的按键不同      / Initiate a Match Description Request (Service Discovery)      dstAddr.addrMode = AddrBroadcast; /广播地址      dstAddr.addr.shortAddr = NWK_BROADCAST

11、_SHORTADDR;      ZDP_MatchDescReq( &dstAddr, NWK_BROADCAST_SHORTADDR,                        SERIALAPP_PROFID,       

12、0;                SERIALAPP_MAX_CLUSTERS,                        (cId_t *)SerialApp_ClusterList,  &#

13、160;                     SERIALAPP_MAX_CLUSTERS,                        (cId_t *)Seri

14、alApp_ClusterList,                        FALSE );          说明：从上面可以看到，SW2是发送终端设备绑定请求方式，SW4是发送描述符匹配请求方式。如果按下SW1的话，使用终端设备绑定请求方式，这里是要通过终端告诉协调器他们想要建

15、立绑定表格，协调器将协调这两个请求的设备，在两个设备上建立绑定表格条目。(1)终端设备向协调器发送终端设备绑定请求  调用ZDP_EndDeviceBindReq()函数发送绑定请求。   ZDP_EndDeviceBindReq( &dstAddr, /目的地址设为0x0000；                      

16、60; NLME_GetShortAddr(),                        SerialApp_epDesc.endPoint, /EP号                 

17、;       SERIALAPP_PROFID,/Profile ID                     SERIALAPP_MAX_CLUSTERS,  /输入簇的数目             

18、60;  (cId_t *)SerialApp_ClusterList, /输入簇列表                    SERIALAPP_MAX_CLUSTERS, /输出簇数目                

19、(cId_t *)SerialApp_ClusterList,/输出簇列表                            FALSE );    该函数实际调用无线发送函数将绑定请求发送给协调器节点：默认clusterID为End_Device_Bind_req，最后通过AF_DataReq

20、uest()发送出去.fillAndSend( &ZDP_TransID, dstAddr, End_Device_Bind_req, len );最后通过AF_DataRequest()发送出去.AF_DataRequest( &afAddr, &ZDApp_epDesc, clusterID,               (uint16)(len+1), (uint8*)(ZDP_TmpBuf-1),  &#

21、160;         transSeq, ZDP_TxOptions,  AF_DEFAULT_RADIUS );(2) 协调器收到终端设备绑定请求End_Device_Bind_req这个信息会传送到ZDO层，在ZDO层的事件处理函数中，调用ZDApp_ProcessOSALMsg( (osal_event_hdr_t *)msg_ptr );UINT16 ZDApp_event_loop( byte task_id, UINT16 events )  uint8 *msg_ptr;

22、60; if ( events & SYS_EVENT_MSG )      while ( (msg_ptr = osal_msg_receive( ZDAppTaskID ) )          ZDApp_ProcessOSALMsg( (osal_event_hdr_t *)msg_ptr );      / Release the memory      o

23、sal_msg_deallocate( msg_ptr );        / Return unprocessed eventsreturn (events SYS_EVENT_MSG);  void ZDApp_ProcessOSALMsg( osal_event_hdr_t *msgPtr )  / Data Confirmation message fields  byte sentEP;       / This should alwa

24、ys be 0  byte sentStatus;  afDataConfirm_t *afDataConfirm;  switch ( msgPtr->event )      / Incoming ZDO Message    case AF_INCOMING_MSG_CMD:      ZDP_IncomingData( (afIncomingMSGPacket_t *)msgPtr );   

25、   break;   在ZDP_IncomingData( (afIncomingMSGPacket_t *)msgPtr );函数中void ZDP_IncomingData( afIncomingMSGPacket_t *pData )  uint8 x = 0;  uint8 handled;  zdoIncomingMsg_t inMsg;  inMsg.srcAddr.addrMode = Addr16Bit;  inMsg.srcAddr.addr.shortAddr = pData->

26、;srcAddr.addr.shortAddr;  inMsg.wasBroadcast = pData->wasBroadcast;  inMsg.clusterID = pData->clusterId;  inMsg.SecurityUse = pData->SecurityUse;   inMsg.asduLen = pData->cmd.DataLength-1;  inMsg.asdu = pData->cmd.Data+1;  inMsg.TransSeq = pData->

27、cmd.Data0;  handled = ZDO_SendMsgCBs( &inMsg ); #if defined( MT_ZDO_FUNC )  MT_ZdoRsp( &inMsg );#endif   while ( zdpMsgProcsx.clusterID != 0xFFFF )      if ( zdpMsgProcsx.clusterID = inMsg.clusterID )        

28、0; zdpMsgProcsx.pFn( &inMsg );      return;        x+;     / Handle unhandled messages  if ( !handled )    ZDApp_InMsgCB( &inMsg );    因为ZDO信息处理表zdpMsgProcs 没有对应的End_Device_Bind_req簇

29、,因此没有调用ZDO信息处理表中的处理函数,但是前面的ZDO_SendMsgCBs()会把这个终端设备绑定请求发送到登记过这个ZDO信息的任务中去。那这个登记注册的程序在哪里呢？   对于协调器来说，由于在void ZDApp_Init( byte task_id )函数中调用了ZDApp_RegisterCBs();面的函数。进行注册了终端绑定请求信息。void ZDApp_RegisterCBs( void )#if defined ( ZDO_IEEEADDR_REQUEST ) | defined ( REFLECTOR )  ZDO_RegisterFo

30、rZDOMsg( ZDAppTaskID, IEEE_addr_rsp );#endif#if defined ( ZDO_NWKADDR_REQUEST ) | defined ( REFLECTOR )  ZDO_RegisterForZDOMsg( ZDAppTaskID, NWK_addr_rsp );#endif #if defined ( ZDO_COORDINATOR )  ZDO_RegisterForZDOMsg( ZDAppTaskID, Bind_rsp );  ZDO_RegisterForZDOMsg( ZDAppTaskID,

31、 Unbind_rsp );  ZDO_RegisterForZDOMsg( ZDAppTaskID, End_Device_Bind_req );#endif#if defined ( REFLECTOR )  ZDO_RegisterForZDOMsg( ZDAppTaskID, Bind_req );  ZDO_RegisterForZDOMsg( ZDAppTaskID, Unbind_req );#endif     因此，协调器节点的 ZDApp 接收到外界输入的数据后，由于注册了 ZDO 反馈消息，即

32、ZDO_CB_MSG，ZDApp 层任务事件处理函数将进行处理：也就是调用下面的程序。UINT16 ZDApp_event_loop( byte task_id, UINT16 events )  uint8 *msg_ptr;  if ( events & SYS_EVENT_MSG )      while ( (msg_ptr = osal_msg_receive( ZDAppTaskID ) )          ZDApp_Process

33、OSALMsg( (osal_event_hdr_t *)msg_ptr );      / Release the memory      osal_msg_deallocate( msg_ptr );        / Return unprocessed eventsreturn (events SYS_EVENT_MSG);       在这里调用函数ZDApp_ProcessO

34、SALMsg( (osal_event_hdr_t *)msg_ptr );在这个函数中我们可以看到对ZDO_CB_MSG事件的处理void ZDApp_ProcessOSALMsg( osal_event_hdr_t *msgPtr )  / Data Confirmation message fields  byte sentEP;       / This should always be 0  byte sentStatus;  afDataConfirm_t *afDataConfir

35、m;  switch ( msgPtr->event )      / Incoming ZDO Message    case AF_INCOMING_MSG_CMD:      ZDP_IncomingData( (afIncomingMSGPacket_t *)msgPtr );      break;     case ZDO_CB_MSG: 

36、     ZDApp_ProcessMsgCBs( (zdoIncomingMsg_t *)msgPtr );      break;    调用ZDApp_ProcessMsgCBs（）函数。在这个函数中根据ClusterID（这里是 End_Device_Bind_req）选择相对应的匹配描述符处理函数，void ZDApp_ProcessMsgCBs( zdoIncomingMsg_t *inMsg )  switch ( inMsg->clusterI

37、D )  #if defined ( ZDO_NWKADDR_REQUEST ) | defined ( ZDO_IEEEADDR_REQUEST ) | defined ( REFLECTOR )    case NWK_addr_rsp:    case IEEE_addr_rsp:              ZDO_NwkIEEEAddrResp_t *pAddrRsp;  

38、60;     pAddrRsp = ZDO_ParseAddrRsp( inMsg );        if ( pAddrRsp )                  if ( pAddrRsp->status = ZSuccess )       

39、               ZDO_UpdateAddrManager( pAddrRsp->nwkAddr, pAddrRsp->extAddr );                    osal_mem_free( pAddrRsp );  

40、0;                 break;#endif     #if defined ( REFLECTOR )    case Bind_req:    case Unbind_req:              ZD

41、O_BindUnbindReq_t bindReq;        ZDO_ParseBindUnbindReq( inMsg, &bindReq );        ZDO_ProcessBindUnbindReq( inMsg, &bindReq );            break;#endif   &#

42、160;      #if defined ( ZDO_COORDINATOR )    case Bind_rsp:    case Unbind_rsp:      if ( matchED )              ZDMatchSendState(    &

43、#160;        (uint8)(inMsg->clusterID = Bind_rsp) ? ZDMATCH_REASON_BIND_RSP : ZDMATCH_REASON_UNBIND_RSP),             ZDO_ParseBindRsp(inMsg), inMsg->TransSeq );       &

44、#160;    break;         case End_Device_Bind_req:              ZDEndDeviceBind_t bindReq;        ZDO_ParseEndDeviceBindReq( inMsg, &bindReq );/解析绑

45、定请求信息      /然后向发送绑定请求的节点发送绑定响应消息：        ZDO_MatchEndDeviceBind( &bindReq );             / Freeing the cluster lists - if allocated.        i

46、f ( bindReq.numInClusters )          osal_mem_free( bindReq.inClusters );        if ( bindReq.numOutClusters )          osal_mem_free( bindReq.outClusters );   

47、         break;#endif       下面是ZDO_MatchEndDeviceBind（）函数的源代码void ZDO_MatchEndDeviceBind( ZDEndDeviceBind_t *bindReq )  zAddrType_t dstAddr;  uint8 sendRsp = FALSE;  uint8 status;  / Is this the first request? 接收到的是

48、第一个绑定请求  if ( matchED = NULL )      / Create match info structure 创建匹配信息结构体    matchED = (ZDMatchEndDeviceBind_t *)osal_mem_alloc( sizeof ( ZDMatchEndDeviceBind_t ) ); /分配空间    if ( matchED )        &

49、#160; / Clear the structure 先进行清除操作      osal_memset( (uint8 *)matchED, 0, sizeof ( ZDMatchEndDeviceBind_t ) );      / Copy the first request's information 复制第一个请求信息    if ( !ZDO_CopyMatchInfo( &(matchED->ed1), bin

50、dReq ) ) /复制不成功后              status = ZDP_NO_ENTRY;        sendRsp = TRUE;              else /分配空间不成功       &

51、#160;  status = ZDP_NO_ENTRY;      sendRsp = TRUE;         if ( !sendRsp ) /分配空间成功 ，复制数据结构成功          / Set into the correct state 设置正确的设备状态      matchED->st

52、ate = ZDMATCH_WAIT_REQ;      / Setup the timeout     设置计时时间APS_SetEndDeviceBindTimeout(AIB_MaxBindingTime,                        ZDO_E

53、ndDeviceBindMatchTimeoutCB );        else /接收到的不是第一个绑定请求        matchED->state = ZDMATCH_SENDING_BINDS; /状态为绑定中  / Copy the 2nd request's information 拷贝第2个请求信息结构      if ( !ZDO_CopyMatchInfo( &

54、amp;(matchED->ed2), bindReq ) ) /拷贝不成功              status = ZDP_NO_ENTRY;        sendRsp = TRUE;            / Make a source match for ed1 

55、60;  /对ed1的输出簇ID与ed2的输入簇ID进行比较，如果有符合的则会返回，相匹配的簇的数目      matchED->ed1numMatched = ZDO_CompareClusterLists(                  matchED->ed1.numOutClusters, matchED->ed1.outClusters

56、,                  matchED->ed2.numInClusters, matchED->ed2.inClusters,  ZDOBuildBuf );      if ( matchED->ed1numMatched ) /如果有返回ed1相匹配的簇     

57、60;       / Save the match list 申请空间保存相匹配的簇列表        matchED->ed1Matched= osal_mem_alloc( (short)(matchED->ed1numMatched * sizeof ( uint16 ) );        if ( matchED->ed1Matched ) /分配成功

58、60;       /保存相匹配的簇列表          osal_memcpy(matchED->ed1Matched,ZDOBuildBuf, (matchED->ed1numMatched * sizeof ( uint16 ) );                else /内

59、存空间分配不成功                  / Allocation error, stop          status = ZDP_NO_ENTRY;          sendRsp = TRUE;    

60、;                / Make a source match for ed2 以ed2为源    /对ed2的终端匹配请求和ed1的簇列表相比较，返回相相匹配的簇的数目      matchED->ed2numMatched = ZDO_CompareClusterLists(       

61、60;          matchED->ed2.numOutClusters, matchED->ed2.outClusters,                  matchED->ed1.numInClusters, matchED->ed1.inClusters, ZDOBuildBuf );&

62、#160;     if ( matchED->ed2numMatched )/如果匹配成功              / Save the match list 保存匹配的簇列表        matchED->ed2Matched = osal_mem_alloc( (short)(matchED->ed2numMatched * sizeof

63、( uint16 ) );        if ( matchED->ed2Matched )                  osal_memcpy( matchED->ed2Matched, ZDOBuildBuf, (matchED->ed2numMatched * sizeof ( uint16 ) );   

64、             else                  / Allocation error, stop          status = ZDP_NO_ENTRY;     

65、;     sendRsp = TRUE;                /如果两个相请求的终端设备，有相匹配的簇，并且保存成功      if ( (sendRsp = FALSE) && (matchED->ed1numMatched | matchED->ed2numMatched) )     

66、;         / Do the first unbind/bind state 发送响应信息给两个设备        ZDMatchSendState( ZDMATCH_REASON_START, ZDP_SUCCESS, 0 );            else       

67、60;      status = ZDP_NO_MATCH;        sendRsp = TRUE;          if ( sendRsp ) /如果没有相匹配的或匹配不成功      / send response to this requester 发送匹配请求响应    dstAddr.addrMo

68、de = Addr16Bit; /设置目的地址是16位的短地址dstAddr.addr.shortAddr = bindReq->srcAddr;/发送绑定终端响应函数status = ZDP_NO_MATCH;    ZDP_EndDeviceBindRsp( bindReq->TransSeq, &dstAddr, status, bindReq->SecurityUse );    if ( matchED->state = ZDMATCH_SENDING_BINDS ) &#

69、160;        / send response to first requester      dstAddr.addrMode = Addr16Bit;      dstAddr.addr.shortAddr = matchED->ed1.srcAddr;      ZDP_EndDeviceBindRsp( matchED->ed1.TransSeq, &

70、dstAddr, status, matchED->ed1.SecurityUse );        / Process ended - release memory used    ZDO_RemoveMatchMemory();        ZDO_MatchEndDeviceBind()函数,如果协调器接收到接收到第一个绑定请求，则分配内存空间进行保存并计时，如果不是第一个绑定请求，则分别以第一个和第二个绑定请求为源绑定

71、，进行比较匹配，如果比较匹配成功则发送匹配成功的信息End_Device_Bind_rsp给两个请求终端。因为在ZDMatchSendState()函数中也是调用了ZDP_EndDeviceBindRsp()函数，对匹配请求响应进行了发送。如果匹配不成功则发送匹配失败的信息给两个终端。uint8 ZDMatchSendState( uint8 reason, uint8 status, uint8 TransSeq )else      / Send the response messages to requesting devices 

72、60;  / send response to first requester 发送响应信息给第一个请求终端，    dstAddr.addr.shortAddr = matchED->ed1.srcAddr;    ZDP_EndDeviceBindRsp( matchED->ed1.TransSeq, &dstAddr, rspStatus, matchED->ed1.SecurityUse );    / send response to second

73、requester 发送响应信息给第二请求终端    if ( matchED->state = ZDMATCH_SENDING_BINDS )          dstAddr.addr.shortAddr = matchED->ed2.srcAddr;      ZDP_EndDeviceBindRsp( matchED->ed2.TransSeq, &dstAddr, rspStatus, matchED

74、->ed2.SecurityUse );        / Process ended - release memory used    ZDO_RemoveMatchMemory();    return ( TRUE );（3）终端结点的响应     由于终端节点在 SerialApp.c 中层注册过 End_Device_Bind_rsp 消息，因此当接收到协调器节点发来的绑定响应消息将交由 SerialApp 任务事件处理函数处理：

75、UINT16 SerialApp_ProcessEvent( uint8 task_id, UINT16 events )  if ( events & SYS_EVENT_MSG )      afIncomingMSGPacket_t *MSGpkt;    while ( (MSGpkt = (afIncomingMSGPacket_t *)osal_msg_receive(          

76、0;                                 SerialApp_TaskID ) )          switch ( MSGpkt->hdr.event )              case ZDO_CB_MSG:          SerialApp_ProcessZDOMsgs( (zdoIncom