应用框架(AF)
应用框架层是应用道APS层的OTA数据接口。此层也接收数据消息的终端多路复用器。AF为应用提供以下功能:
·
·
哈哈,这里的函数应该就是我们经常要用到的函数了。
终端管理
每个设备都是Zigbee中的节点,每个节点有长地址和短地址,短地址被其他设备用来发送数据。每个节点又241个终端(0保留,1-240可分配给应用)。每个终端可以独立设置地址;当设备发送数据时必须指定目标设备的短地址和接收终端。一个应用必须注册一个或多个终端用来接收或者发送数据。
简单描述符-Simp LED escriptionFormat_t
每个终端都必须有一个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