有两种可用的机制配置设备的绑定
(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为非NULL
{
destination.addrMode = Addr64Bit;
osal_cpyExtAddr( destination.addr.extAddr, pDestination );//复制扩展地址
//调用APS绑定请求函数
ret = APSME_BindRequest( sapi_epDesc.endPoint, //源EP
commandId, //命令ID
&destination, //目的设备地址模式
api_epDesc.endPoint );//目的EP
if ( 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为NULL
{
ret = ZB_INVALID_PARAMETER;
destination.addrMode = Addr16Bit; //设置16位短地址
destination.addr.shortAddr = NWK_BROADCAST_SHORTADDR;//广播模式
//比较输出簇commandId是否和本终端输出簇列表中有匹配项,成功匹配返回TRUE
if(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 event
}
}
}
SAPI_SendCback( SAPICB_BIND_CNF, ret, commandId );
}
else //create=FALSE 解除绑定
{
// Remove local bindings for the commandId
BindingEntry_t *pBind;
// Loop through bindings an remove any that match the cluster
while ( 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 struct
{
union
{
uint16 shortAddr;
ZLongAddr_t extAddr;
} addr;
byte addrMode;
} zAddrType_t;
enum
{
AddrNotPresent = 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;
}
else
{
dstAddr.addrMode = Addr16Bit;
//把得到的16位短地址赋值给dstAddr.addr.shortAddr
dstAddr.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 coordinator
ZDAppNwkAddr.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, clusterID,
(uint16)(len+1), (uint8*)(ZDP_TmpBuf-1),
transSeq, ZDP_TxOptions, AF_DEFAULT_RADIUS );
}
(3)sapi_bindInProgress == 0xffff,变量,在void SAPI_Init( byte task_id )函数中,首先被初始化0xffff。在void zb_BindDevice ( uint8 create, uint16 commandId, uint8 *pDestination )
函数中被赋值为commandId