AF_DataRequest()函数说明

78 阅读 0 评论 52 点赞

我是靠谱客的博主繁荣眼神，最近开发中收集的这篇文章主要介绍AF_DataRequest()函数说明，觉得挺不错的，现在分享给大家，希望可以做个参考。

概述

原型：

  afStatus_t AF_DataRequest( afAddrType_t *dstAddr, endPointDesc_t *srcEP,
                             uint16 cID, uint16 len, uint8 *buf, uint8 *transID,
                             uint8 options, uint8 radius );

参数说明：

*dstAddr ：发送目的地址＋端点地址（端点号）和传送模式

*srcEP ：源(答复或确认)终端的描述（比如操作系统中任务ID等）源EP

cID ：被Profile指定的有效的集群号

len ：发送数据长度

*buf ：发送数据缓冲区

*transID ：任务ID号

options ：有效位掩码的发送选项

radius ：传送跳数，通常设置为AF_DEFAULT_RADIUS

其中

1、afAddrType_t *dstAddr af地址类型

typedef struct
{
  union
  {
    uint16      shortAddr;//短地址
    ZLongAddr_t extAddr;
  } addr;
  afAddrMode_t addrMode;//传送模式 <wbr>
  uint8 endPoint;//端点号 <wbr>
  uint16 panId;  // used for the INTER_PAN feature
} afAddrType_t;</wbr></wbr>

2、endPointDesc_t *srcEP 端点描述

typedef struct
{
  uint8 endPoint;//端点号
  uint8 *task_id;  // Pointer to location of the Application task ID.（调用任务的ID）
  SimpleDescriptionFormat_t *simpleDesc;//简单的端点描述
  afNetworkLatencyReq_t latencyReq;
} endPointDesc_t;

3、SimpleDescriptionFormat_t 简单描述格式

typedef struct  
{  
	byte          EndPoint;       //端口号  
	uint16        AppProfId;      //应用规范ID  
	uint16        AppDeviceId;    //应用设备ID  
	uint8         AppDevVer:4;    //应用设备版本号  4bit 这里使用的是位域  
	uint8         Reserved:4;             // AF_V1_SUPPORT uses for AppFlags:4.  
	uint8         AppNumInClusters;    //输入簇包含的命令个数  
	cId_t        *pAppInClusterList;  //输入簇列表  可有<span style='line-height: 18px; font-family: Consolas,"Courier New",Courier,mono,serif; background-color: rgb(248, 248, 248);'>GENERICAPP_MAX_CLUSTERS个输入命令</span>  
	uint8         AppNumOutClusters;   //输出簇包含的命令个数  
	cId_t        *pAppOutClusterList;//输出簇列表  可有<span style='line-height: 18px; font-family: Consolas,"Courier New",Courier,mono,serif; background-color: rgb(248, 248, 248);'>GENERICAPP_MAX_CLUSTERS个输出命令</span>  
} SimpleDescriptionFormat_t;

4、uint16 cID

ClusterID--具体应用串ID

5、uint8 options

发送模式选项有如下选项

#define AF_PREPROCESS                      0x04   // Will force APS to callback to preprocess before calling NWK layer
#define AF_LIMIT_CONCENTRATOR              0x08
#define AF_ACK_REQUEST                     0x10
#define AF_DISCV_ROUTE                     0x20   // This option is no longer used, and will be taken out later
#define AF_EN_SECURITY                     0x40
#define AF_SKIP_ROUTING                    0x80

6、uint8 radius

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

对于非广播消息，有两种基本的消息重试类型：端到端的确认(APS ACK)和单级确认(single hop acknowledgement)(MAC ACK)。MAC ACK默认情况下是一直打开的，通常能够充分保证网络的高可靠性。为了提供附加的可靠性，同时使发送设备能够得到数据包已经被发送到目的地的确认，可以使用APS ACK。

APS acknowledgement在APS层完成，是从目标设备到源设备的一个消息确认系统。源设备将保留这个消息知道目标设备发送一个APS ACK消息表明它已经收到了消息。对于每个发出的消息可以通过调用函数AF_DataRequest()的选项来使能/禁止来禁止这个功能。这个选项区域是一个位映射选项，对于将要发送的消息的选项区域或上(OR)AF_ACK_REQUEST就可以使能APS ACK。消息重试(如果APS ACK消息没有收到)的次数和重试之间的时间间隔的配置项在f8wConfig.cfg文件中。APSC_MAX_FRAME_RETRIES是APS层在放弃发送数据之前，没有收到APS ACK确认重新发送消息的次数。APSC_ACK_WAIT_DURATION_POLLED是重新发送之间的时间间隔。

APS ACK 数据确认命令在应用层event-loop函数中，通过AF_DATA_CONFIRM_CMD进行处理，原始AF层函数为afDataConfirm( uint8 endPoint, uint8 transID, ZStatus_t status )。

转自： http://blog.sina.com.cn/s/blog_690878d501011cmp.html