AF_DataRequest详解

最新推荐文章于 2021-04-25 15:52:40 发布

linuxheik

最新推荐文章于 2021-04-25 15:52:40 发布

阅读量1.3k

点赞数

分类专栏： zigbee

zigbee 专栏收录该内容

16 篇文章

订阅专栏

本文解析了ZigBee协议栈中AF_DataRequest函数的作用及参数意义，详细介绍了如何通过该函数实现数据包的发送，并对关键参数进行了深入解读。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

/*********************************************************************
* @fn    AF_DataRequest

[size=10.8333px]    *dstAddr--发送目的地址＋端点地址（端点号）和传送模式
   *srcEP --源(答复或确认)终端的描述（比如操作系统中任务ID等）源EP
   cID    --被Profile指定的有效的集群号
   len    --发送数据长度
   *buf    --发送数据缓冲区
   *transID --任务ID号
   options  --有效位掩码的发送选项
   radius --传送跳数，通常设置为AF_DEFAULT_RADIUS

[size=10.8333px] */
uint8 AF_DataRequestDiscoverRoute = TRUE;
afStatus_t AF_DataRequest( afAddrType_t *dstAddr, endPointDesc_t *srcEP,
                        uint16 cID, uint16 len, uint8 *buf, uint8 *transID,
                        uint8 options, uint8 radius )
{
  pDescCB pfnDescCB;
  ZStatus_t stat;
  APSDE_DataReq_t req;
  afDataReqMTU_t mtu;

  // Verify source end point
  if ( srcEP == NULL )
  {
return afStatus_INVALID_PARAMETER;
  }

#if !defined( REFLECTOR )
  if ( dstAddr->addrMode == afAddrNotPresent )
  {
return afStatus_INVALID_PARAMETER;
  }
#endif

  // Validate broadcasting
  if ( ( dstAddr->addrMode == afAddr16Bit    ) ||
   ( dstAddr->addrMode == afAddrBroadcast ) )
  {
// Check for valid broadcast values
if( ADDR_NOT_BCAST != NLME_IsAddressBroadcast( dstAddr->addr.shortAddr )  )
{
   // Force mode to broadcast
   dstAddr->addrMode = afAddrBroadcast;
}
else
{
   // Address is not a valid broadcast type
   if ( dstAddr->addrMode == afAddrBroadcast )
   {
      return afStatus_INVALID_PARAMETER;
   }
}
  }
  else if ( dstAddr->addrMode != afAddr64Bit &&
         dstAddr->addrMode != afAddrGroup &&
         dstAddr->addrMode != afAddrNotPresent )
  {
return afStatus_INVALID_PARAMETER;
  }

  // Set destination address
  req.dstAddr.addrMode = dstAddr->addrMode;
  if ( dstAddr->addrMode == afAddr64Bit )
osal_cpyExtAddr( req.dstAddr.addr.extAddr, dstAddr->addr.extAddr );
  else
req.dstAddr.addr.shortAddr = dstAddr->addr.shortAddr;

  req.profileID = ZDO_PROFILE_ID;

  if ( (pfnDescCB = afGetDescCB( srcEP )) )
  {
uint16 *pID = (uint16 *)(pfnDescCB(
                              AF_DESCRIPTOR_PROFILE_ID, srcEP->endPoint ));
if ( pID )
{
   req.profileID = *pID;
   osal_mem_free( pID );
}
  }
  else if ( srcEP->simpleDesc )
  {
req.profileID = srcEP->simpleDesc->AppProfId;
  }

  req.txOptions = 0;

  if ( ( options & AF_ACK_REQUEST             ) &&
   ( req.dstAddr.addrMode != AddrBroadcast ) &&
   ( req.dstAddr.addrMode != AddrGroup    ) )
  {
req.txOptions |=  APS_TX_OPTIONS_ACK;
  }

  if ( options & AF_SKIP_ROUTING )
  {
req.txOptions |=  APS_TX_OPTIONS_SKIP_ROUTING;
  }

  if ( options & AF_EN_SECURITY )
  {
req.txOptions |= APS_TX_OPTIONS_SECURITY_ENABLE;
mtu.aps.secure = TRUE;
  }
  else
  {
mtu.aps.secure = FALSE;
  }

  mtu.kvp = FALSE;

  req.transID    = *transID;
  req.srcEP       = srcEP->endPoint;
  req.dstEP       = dstAddr->endPoint;
  req.clusterID    = cID;
  req.asduLen    = len;
  req.asdu       = buf;
  req.discoverRoute = AF_DataRequestDiscoverRoute;//(uint8)((options & AF_DISCV_ROUTE) ? 1 : 0);
  req.radiusCounter = radius;
#if defined ( INTER_PAN )
  req.dstPanId    = dstAddr->panId;

  if ( StubAPS_InterPan( dstAddr->panId, dstAddr->endPoint ) )
  {
if ( len > INTERP_DataReqMTU() )
{
   stat = afStatus_INVALID_PARAMETER;
}
else
{
   stat = INTERP_DataReq( &req );
}
  }
  else
#endif // INTER_PAN
  {
if (len > afDataReqMTU( &mtu ) )
{
   if (apsfSendFragmented)
   {
      stat = (*apsfSendFragmented)( &req );
   }
   else
   {
      stat = afStatus_INVALID_PARAMETER;
   }
}
else
{
   stat = APSDE_DataReq( &req );
}
  }

参数详解如下：

   其中

1、afAddrType_t *dstAddr
   af地址类型
typedefstruct
{
  union
  {
   uint16 shortAddr;          //短地址
  }addr;
  afAddrMode_t addrMode;  //传送模式
  byte    endPoint;                //端点号
}afAddrType_t;

2、endPointDesc_t  *srcEP
   端点描述
typedefstruct
{
  byteendPoint;    //端点号
  byte*task_id;    //那一个任务的端点号（调用任务的ID）
  SimpleDescriptionFormat_t       *simpleDesc;  //简单的端点描述
  afNetworkLatencyReq_tlatencyReq;
}endPointDesc_t;

3、SimpleDescriptionFormat_t
   简单描述格式
typedefstruct
{
  byte          EndPoint;                //EP
  uint16       AppProfId;                //应用规范ID
  uint16       AppDeviceId;             //特定规范ID的设备类型
  byte          AppDevVer:4;             //特定规范ID的设备的版本
  byte          Reserved:4;                //AF_V1_SUPPORTusesforAppFlags:4.
  byte          AppNumInClusters;    //输入簇ID的个数

  cId_t       *pAppInClusterList;    //输入簇ID的列表
  byte          AppNumOutClusters;       //输出簇ID的个数
  cId_t       *pAppOutClusterList;    //输出簇ID的列表
}SimpleDescriptionFormat_t;

4、uint16 cID

ClusterID--具体应用串ID

5、uint8          options

发送模式选项有如下选项
#defineAF_FRAGMENTED                               0x01
#defineAF_ACK_REQUEST                            0x10
#defineAF_DISCV_ROUTE                            0x20
#defineAF_EN_SECURITY                            0x40
#defineAF_SKIP_ROUTING                            0x80
其中AF_ACK_REQUEST为发送后需要接收方的确认

6、uint8    radius

传输跳数或传输半径，默认值为10

AF_DataRequest( &SampleApp_Flash_DstAddr, zigbee地址 Nwk Addr+End Point
&SampleApp_epDesc,End Point Descr
SAMPLEAPP_FLASH_CLUSTERID,cluster ID
3,  len
buffer,  *buf
&SampleApp_TransID,*transID
AF_DISCV_ROUTE,
AF_DEFAULT_RADIUS ) == afStatus_SUCCESS )

关键参数说明：

SampleApp_Flash_DstAddr ：目的地址，你要把数据发到哪里肯定要先知道他的地址吧，就像你要给人写信，总得先知道对方的地址吧，这里也是一样的，描述了目的设备的地址

End Point Descr ：对于这个参数，我的理解，就是一个更精确的地址，因为一个node可以有多个Endpoint，就像你写信到底给那个人一样。目的地址标识了，他在那，而这个参数就是说这个人到底是谁了。

cluster ID ：关于这个参数，可以这样理解。……呃……这样吧，就是大的包裹，还是纸质的普通信封，还是……总之你要根据这个采取不同的措施，例如，比如是个大的包裹，你需要一把剪刀来打开，如果是一个普通的纸质信封，直接撕开就好，如果是一份加密信函……总之，你会根据这个参数的不同采取不同的措施

len ：数据的长度，可以理解为信的内容有几页

*buf：数据内容。可以理解为信的内容

*transID：序列号：可以理解为邮戳的日期

……那两个就不说了，是路由相关啦……

呵呵……自己说都有点绕……