文章发表于:2010-02-07 02:19 应用框架(AF) 应用框架层是应用道APS层的OTA数据接口。此层也接收数据消息的终端多路复用器。AF为应用提供以下功能: · · 哈哈,这里的函数应该就是我们经常要用到的函数了。 终端管理 每个设备都是Zigbee中的节点,每个节点有长地址和短地址,短地址被其他设备用来发送数据。每个节点又241个终端(0保留,1-240 可分配给应用)。每个终端可以独立设置地址;当设备发送数据时必须指定目标设备的短地址和接收终端。一个应用必须注册一个或多个终端用来接收或者发送数据。 简单描述符-Simp 每个终端都必须有一个Zigbee简单描述。这些描述对Zigbee网络刻画了这个终端,其他设备可以询问这个终端以知道这个设备的类型。 typedef struct { } SimpleDescriptionFormat_t; EndPoint – 终端号:1-240 这是节点的子地址,用来接收数据 AppProfId – 定义了这个终端上支持的Profile ID(剖面ID), ID最好遵循由ZigBee联盟的分配。 AppDeviceId –终端支持的设备ID,ID最好遵循ZigBee联盟的分配。 AppDevVer –此终端上设备执行的设备描述的版本:0x00为Version 1.0. Reserved – 保留 AppNumInClusters – 终端支持的输入簇数目 pAppInClusterList – 指向输入Cluster ID列表的指针 AppNumOutClusters – 终端支持的输出簇数目 pAppOutClusterList – 指向输出Cluster ID列表的指针 终端描述符-endPointDesc_t 节点中的每一个终端都必须有一个终端描述符 typedef struct { } endPointDesc_t; task_id -任务ID指针,当接收到消息时,此任务ID将指示消息传递目的。接收到的消息是以OSAL消息形式包装的,将发送到一个任务 simpleDesc latencyReq afStatus_t afRegister( endPointDesc_t *epDesc ); 为设备注册一个新的终端 epDesc 返回值:afStatus_t epList_t *afRegisterExtended( endPointDesc_t *epDesc, pDescCB descFn ); 在上面函数功能的基础上增加了回调函数,当终端的简单描述符被查询时将调用此回调函数。这样应有就可以动态改变简单描述符而不用RAM/ROM来储存描述符了。 descFn epList endPointDesc_t *afFindEndPointDesc( byte endPoint ); 从一个终端找到终端描述符 endPoint endPointDesc_t -指向终端描述符的指针,若失败则为NULL byte afFindSimpleDesc( SimpleDescriptionFormat_t **ppDesc, byte EP ); 从一个终端找到终端描述符。若返回值非零则必须调用osal_mem_free()来释放描述符的内存占用。 ppDesc EP –终端简单描述符需要 uint8 afGetMatch( uint8 ep ); 默认情况下,设备将响应ZDO匹配描述符请求。用这个函数来获得ZDO匹配描述符应答的设置。 ep 返回值:TRUE-允许响应,FALSE-不允许或者终端未找到 uint8 afSetMatch( uint8 ep, uint8 action ); 默认情况下,设备将响应ZDO匹配描述符。可以用这个函数来改变这个行为,比如ep为1,action为FALSE,ZDO将不响应终端1的ZDO匹配面述符请求。 ep action 返回值:TRUE-成功,FALSE-失败或者终端未找到 byte afNumEndPoints( void ); 查找已注册的终端数目,返回此设备上已注册的终端数目,包括终端0 void afEndPoints( byte *epBuf, byte skipZDO ); 返回包含已注册的终端的一个数组。 epBuf – 指向存放终端的数组,每个终端占一个字节 skipZDO -设置为TRUE,则不包含ZDO终端(终端0) 发送数据 afStatus_t AF_DataRequest( afAddrType_t *dstAddr, endPointDesc_t *srcEP, dstAddr -目标地址指针。 srcEP cID len buf transID -事务序列号指针。如果消息缓存发送,这个函数将增加这个数字 options radius – 最大的跳数,用默认值AF_DEFAULT_RADIUS afStatus_t – 成功则为ZSuccess(defined in ZComDef.h). 否则 Errors(defined in ZComDef.h) uint8 afDataReqMTU( afDataReqMTU_t* fields ); 找出基于输入参数的最大可发送字节数,返回能发送的最大字节数 fields |
|