通过SimpleApp例程理解绑定的流程(一).doc

通过SimpleApp例程理解绑定的流程（一） (2010-12-04 10:59) 分类： ZigBee 技术学习 有两种可用的机制配置设备的绑定（1）如果目的设备的扩展地址是已知的，则调用zb_BindDeviceRequest()函数能创建一个绑定条目（2）如果扩展地址是未知的，则通过“JoyStick”按键的辅助进行绑定操作，在这种情况下，这个目的设备首先要处于一种状态，也是就说目的设备应该是允许被绑定的状态。它将被zb_AllowBindResponse()发出一个匹配响应；然后在源设备处，zb_BindDeviceRequest()函数带着空地址发出。（1） 已知扩展地址的绑定这里可以直接调用函数zb_BindDeviceRequest()发起绑定请求void zb_BindDevice ( uint8 create, /是否创建绑定，TRUE则创建，FALSE则解除，创建和解除其实都是这个函数，只是这里传递的参数不同而已uint16 commandId, /命令ID，基于命令的绑定uint8 *pDestination );/指向扩展地址指针该函数的代码如下;void zb_BindDevice ( uint8 create, uint16 commandId, uint8 *pDestination )zAddrType_t destination;uint8 ret = ZB_ALREADY_IN_PROGRESS;if ( create ) /如果是TRUE，也就是意味着是建立绑定if (sapi_bindInProgress = 0xffff)/如果在这个命令上没有创建绑定if ( pDestination ) /已知扩展地址的绑定，即：*pDestination为非NULLdestination.addrMode = Addr64Bit;osal_cpyExtAddr( destination.addr.extAddr, pDestination );/复制扩展地址/调用APS绑定请求函数ret = APSME_BindRequest( sapi_epDesc.endPoint, /源EPcommandId, /命令ID&destination, /目的设备地址模式api_epDesc.endPoint );/目的EPif ( ret = ZSuccess )/绑定成功/ Find nwk addr 发现网络地址，得到被绑定的设备的短地址ZDP_NwkAddrReq(pDestination, ZDP_ADDR_REQTYPE_SINGLE, 0, 0 );osal_start_timerEx( ZDAppTaskID, ZDO_NWK_UPDATE_NV, 250 );else /未知扩展地址的绑定 *pDestination为NULLret = ZB_INVALID_PARAMETER;destination.addrMode = Addr16Bit; /设置16位短地址destination.addr.shortAddr = NWK_BROADCAST_SHORTADDR;/广播模式/比较输出簇commandId是否和本终端输出簇列表中有匹配项，成功匹配返回TRUEif(ZDO_AnyClusterMatches(1,&commandId,sapi_epDesc.simpleDesc-AppNumOutClusters,sapi_epDesc.simpleDesc-pAppOutClusterList ) )/ Try to match with a device in the allow bind mode 匹配一个在允许绑定模式下的设备ret = ZDP_MatchDescReq( &destination, NWK_BROADCAST_SHORTADDR,sapi_epDesc.simpleDesc-AppProfId, 1, &commandId, 0, (cId_t *)NULL, 0 );/如果commandId是输入簇，则查找本地输入簇列表中是否有匹配项else if( ZDO_AnyClusterMatches(1,&commandId, sapi_epDesc.simpleDesc-AppNumInClusters,sapi_epDesc.simpleDesc-pAppInClusterList ) ) /匹配一个在允许绑定模式的设备ret = ZDP_MatchDescReq( &destination, NWK_BROADCAST_SHORTADDR,sapi_epDesc.simpleDesc-AppProfId, 0, (cId_t *)NULL, 1, &commandId, 0 );if ( ret = ZB_SUCCESS )/如果匹配成功/ Set a timer to make sure bind completes 设置一个时间，确保绑定完成osal_start_timerEx(sapi_TaskID, ZB_BIND_TIMER, AIB_MaxBindingTime);sapi_bindInProgress = commandId; /允许基于命令的绑定过程return; / dont send cback eventSAPI_SendCback( SAPICB_BIND_CNF, ret, commandId );else /create=FALSE 解除绑定/ Remove local bindings for the commandIdBindingEntry_t *pBind;/ Loop through bindings an remove any that match the clusterwhile ( pBind = bindFind( sapi_epDesc.simpleDesc-EndPoint, commandId, 0 ) )bindRemoveEntry(pBind); /完成从绑定表格中移除绑定条目osal_start_timerEx( ZDAppTaskID, ZDO_NWK_UPDATE_NV, 250 );return;说明：（1）zAddrType_t destination; 其中的用到的数据结构typedef structunionuint16 shortAddr;ZLongAddr_t extAddr; addr;byte addrMode; zAddrType_t;enumAddrNotPresent = 0,AddrGroup = 1,Addr16Bit = 2,Addr64Bit = 3,AddrBroadcast = 15;（2)在上面调用了APS绑定函数APSME_BindRequest（），该函数描述如下：ZStatus_t APSME_BindRequest( byte SrcEndpInt, uint16 ClusterId, zAddrType_t *DstAddr, byte DstEndpInt);在两个设备上建立绑定，该函数通过PASME-BIND.confirm原语返回，而且这两者是不可分割的。这个函数好像是不开源的，在文件中没有找到该函数的源代码。如果绑定成功，则调用函数ZDP_NwkAddReq()得到目的短地址。afStatus_t ZDP_NwkAddrReq( byte *IEEEAddress, byte ReqType,byte StartIndex, byte SecurityEnable )ReqType 为想得到的相应类型，它的值可能是以下二者之一：ZDP_NWKADDR_REQTYPE_SINGLE:：返回设备的短地址和扩展地址ZDP_NWKADDR_REQTYPE_EXTENDED：返回短地址和扩展地址和所有相关的设备的短地址。调用该函数可以产生一个根据已知远程设备的IEEE地址，请求得到16位短地址的信息。并且该信息以广播方式发送到网络中的所有设备。afStatus_t ZDP_NwkAddrReq( byte *IEEEAddress, byte ReqType,byte StartIndex, byte SecurityEnable )byte *pBuf = ZDP_TmpBuf;byte len = Z_EXTADDR_LEN + 1 + 1; / IEEEAddress + ReqType + StartIndex.zAddrType_t dstAddr;if ( osal_ExtAddrEqual( saveExtAddr, IEEEAddress ) = FALSE )dstAddr.addrMode = AddrBroadcast;dstAddr.addr.shortAddr = NWK_BROADCAST_SHORTADDR;elsedstAddr.addrMode = Addr16Bit;/把得到的16位短地址赋值给dstAddr.addr.shortAddrdstAddr.addr.shortAddr = ZDAppNwkAddr.addr.shortAddr;pBuf = osal_cpyExtAddr( pBuf, IEEEAddress );*pBuf+ = ReqType;*pBuf+ = StartIndex;return fillAndSend( &ZDP_TransID, &dstAddr, NWK_addr_req, len );网络中的短地址最终是从那里得到呢？通过下面的ZDApp_RestoreNetworkState（）函数，调用NLME_GetShortAddr()函数，得到网络的短地址，该函数也是不开源的。其中，ZDApp_RestoreNetworkState（）函数，会在uint8 ZDOInitDevice( uint16 startDelay )函数中调用。uint8 ZDApp_RestoreNetworkState( void )nvStat = NLME_InitNV();if ( nvStat != NV_OPER_FAILED )if ( NLME_RestoreFromNV() )/ Are we a coordinatorZDAppNwkAddr.addr.shortAddr = NLME_GetShortAddr();if ( ZDAppNwkAddr.addr.shortAddr = 0 )ZDO_Config_Node_Descriptor.LogicalType = NODETYPE_COORDINATOR;devStartMode = MODE_RESUME; 如果网络中的状态有变化时，会从新得到网络中的短地址。void ZDO_UpdateNwkStatus( devStates_t state )/ Endpoint/Interface descriptor list.epList_t *epDesc = epList;byte bufLen = sizeof(osal_event_hdr_t);osal_event_hdr_t *msgPtr;ZDAppNwkAddr.addr.shortAddr = NLME_GetShortAddr();(void)NLME_GetExtAddr(); / Load the saveExtAddr pointer.static afStatus_t fillAndSend( uint8 *transSeq, zAddrType_t *addr, cId_t clusterID, byte len )afAddrType_t afAddr;ZADDR_TO_AFADDR( addr, afAddr );*(ZDP_TmpBuf-1) = *transSeq;/通过AF_DataRequest函数发送得到的短地址return AF_DataRequest( &afAddr, &ZDApp_epDesc, clus