ZigBee学习之15—ZStackAPI3概念.docVIP

#1楼主：ZigBee学习之15——ZStack API解读3 文章发表于：2010-02-07 02:19 应用框架（AF） 应用框架层是应用道APS层的OTA数据接口。此层也接收数据消息的终端多路复用器。AF为应用提供以下功能： · 终端（Endpoint）管理 · 发送和接收数据 哈哈，这里的函数应该就是我们经常要用到的函数了。 终端管理 每个设备都是Zigbee中的节点，每个节点有长地址和短地址，短地址被其他设备用来发送数据。每个节点又241个终端（0保留，1-240 可分配给应用）。每个终端可以独立设置地址；当设备发送数据时必须指定目标设备的短地址和接收终端。一个应用必须注册一个或多个终端用来接收或者发送数据。 简单描述符-SimpleDescriptionFormat_t 每个终端都必须有一个Zigbee简单描述。这些描述对Zigbee网络刻画了这个终端，其他设备可以询问这个终端以知道这个设备的类型。 typedef struct { byte EndPoint; uint16 AppProfId; uint16 AppDeviceId; byte AppDevVer:4; byte Reserved:4; // AF_V1_SUPPORT uses for AppFlags:4. byte AppNumInClusters; cId_t *pAppInClusterList; byte AppNumOutClusters; cId_t *pAppOutClusterList; } SimpleDescriptionFormat_t; EndPoint ?s终端号：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 { byte endPoint; byte *task_id; // Pointer to location of the Application task ID. SimpleDescriptionFormat_t *simpleDesc; afNetworkLatencyReq_t latencyReq; } endPointDesc_t; task_id -任务ID指针，当接收到消息时，此任务ID将指示消息传递目的。接收到的消息是以OSAL消息形式包装的，将发送到一个任务 simpleDesc -指向这个终端的ZigBee简单描述 latencyReq -必须用noLatencyReqs来填充 afStatus_t afRegister( endPointDesc_t *epDesc ); 为设备注册一个新的终端 epDesc -指向终端描述符 返回值：afStatus_t -若成功则返回ZSuccess，否则返回ZComDef.h中定义的错误 epList_t *afRegisterExtended( endPointDesc_t *epDesc, pDescCB descFn ); 在上面函数功能的基础上增加了回调函数，当终端的简单描述符被查询时将调用此回调函数。这样应有就可以动态改变简单描述符而不用RAM/ROM来储存描述符了。 descFn -回调函数指针。相关函数必须为简单描述符分配足够的空间，填充简单描述符，然后返回指向简单描述符的指针，调用者将释放为描述符分配空间。 epList -指向终端列表元件的指针，如果失败则为NULL endPointDesc_t *afFindEndPointDesc