ZigBee學習之15—ZStackAPI解讀3分析

1、#1樓主：ZigBee學習之15ZStack API解讀3文章發(fā)表于：2010-02-07 02:19應用框架（AF）應用框架層是應用道APS層的OTA數據接口。此層也接收數據消息的終端多路復用器。AF為應用提供以下功能：· 終端（Endpoint）管理· 發(fā)送和接收數據哈哈，這里的函數應該就是我們經常要用到的函數了。終端管理每個設備都是Zigbee中的節(jié)點，每個節(jié)點有長地址和短地址，短地址被其他設備用來發(fā)送數據。每個節(jié)點又241個終端（0保留，1-240 可分配給應用）。每個終端可以獨立設置地址；當設備發(fā)送數據時必須指定目標設備的短地址和接收終端。一個應用必須注冊一個或多

2、個終端用來接收或者發(fā)送數據。簡單描述符-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; b

3、yte AppNumOutClusters; cId_t *pAppOutClusterList; SimpleDescriptionFormat_t;EndPoint 終端號：1-240 這是節(jié)點的子地址，用來接收數據AppProfId 定義了這個終端上支持的Profile ID（剖面ID）， ID最好遵循由ZigBee聯盟的分配。AppDeviceId 終端支持的設備ID，ID最好遵循ZigBee聯盟的分配。AppDevVer 此終端上設備執(zhí)行的設備描述的版本：0x00為Version 1.0. Reserved 保留 AppNumInClusters 終端支持的輸入簇數目 pAppInC

4、lusterList 指向輸入Cluster ID列表的指針 AppNumOutClusters 終端支持的輸出簇數目 pAppOutClusterList 指向輸出Cluster ID列表的指針終端描述符-endPointDesc_t 節(jié)點中的每一個終端都必須有一個終端描述符typedef struct byte endPoint; byte *task_id; / Pointer to location of the Application task ID. SimpleDescriptionFormat_t *simpleDesc; afNetworkLatencyReq_t laten

5、cyReq; endPointDesc_t; task_id -任務ID指針，當接收到消息時，此任務ID將指示消息傳遞目的。接收到的消息是以OSAL消息形式包裝的，將發(fā)送到一個任務simpleDesc -指向這個終端的ZigBee簡單描述latencyReq -必須用noLatencyReqs來填充afStatus_t afRegister( endPointDesc_t *epDesc );為設備注冊一個新的終端epDesc -指向終端描述符返回值：afStatus_t -若成功則返回ZSuccess，否則返回ZComDef.h中定義的錯誤epList_t *afRegisterExtend

6、ed( endPointDesc_t *epDesc, pDescCB descFn );在上面函數功能的基礎上增加了回調函數，當終端的簡單描述符被查詢時將調用此回調函數。這樣應有就可以動態(tài)改變簡單描述符而不用RAM/ROM來儲存描述符了。descFn -回調函數指針。相關函數必須為簡單描述符分配足夠的空間，填充簡單描述符，然后返回指向簡單描述符的指針，調用者將釋放為描述符分配空間。epList -指向終端列表元件的指針，如果失敗則為NULLendPointDesc_t *afFindEndPointDesc( byte endPoint );從一個終端找到終端描述符endPoint -要尋找

7、的終端描述符的終端號endPointDesc_t -指向終端描述符的指針，若失敗則為NULLbyte afFindSimpleDesc( SimpleDescriptionFormat_t *ppDesc, byte EP );從一個終端找到終端描述符。若返回值非零則必須調用osal_mem_free()來釋放描述符的內存占用。ppDesc -指向指向簡單描述符的指針。EP 終端簡單描述符需要uint8 afGetMatch( uint8 ep );默認情況下，設備將響應ZDO匹配描述符請求。用這個函數來獲得ZDO匹配描述符應答的設置。ep -用來獲得ZDO匹配描述符響應行為的終端返回值：TR

8、UE-允許響應，FALSE-不允許或者終端未找到uint8 afSetMatch( uint8 ep, uint8 action );默認情況下，設備將響應ZDO匹配描述符?？梢杂眠@個函數來改變這個行為，比如ep為1，action為FALSE，ZDO將不響應終端1的ZDO匹配面述符請求。ep -用來獲得ZDO匹配描述符響應行為的終端action -TRUE-允許響應，FALSE-不允許或者終端未找到返回值：TRUE-成功，FALSE-失敗或者終端未找到byte afNumEndPoints( void );查找已注冊的終端數目，返回此設備上已注冊的終端數目，包括終端0void afEndPoi

9、nts( byte *epBuf, byte skipZDO );返回包含已注冊的終端的一個數組。epBuf 指向存放終端的數組，每個終端占一個字節(jié) skipZDO -設置為TRUE，則不包含ZDO終端（終端0）發(fā)送數據afStatus_t AF_DataRequest( afAddrType_t *dstAddr, endPointDesc_t *srcEP, uint16 cID, uint16 len, uint8 *buf, uint8 *transID, uint8 options, uint8 radius );dstAddr -目標地址指針。 afAddrNotPresent 由

10、反射器（邦定源，也即路由器或者協調器）指定 afAddrGroup 發(fā)送到組 afAddrBroADCast 發(fā)送廣播消息 afAddr16Bit 直接發(fā)送到節(jié)點（單播）srcEP -發(fā)送終端的終端描述符指針cID -簇ID，cluster ID如同消息ID，并且在剖面（profile）中各不相同len -要發(fā)送的字節(jié)數buf -指向要發(fā)送的數據緩存的指針transID -事務序列號指針。如果消息緩存發(fā)送，這個函數將增加這個數字options -發(fā)送選項，可以由下面一項，或幾項相或得到 AF_ACK_REQUEST 0x10 要求APS應答，這是應用層的應答，支在直接發(fā)送（單播）時使用。 AF

11、_DISCV_ROUTE 0x20 總要包含這個選項 AF_SKIP_ROUTING 0x80 設置這個選項將導致設備跳過路由而直接發(fā)送消息。終點設備將不向其父親發(fā)送消息。在直接發(fā)送（單播）和廣播消息時很好用。radius 最大的跳數，用默認值AF_DEFAULT_RADIUSafStatus_t 成功則為ZSuccess(defined in ZComDef.h). 否則 Errors（defined in ZComDef.h）uint8 afDataReqMTU( afDataReqMTU_t* fields ); 找出基于輸入參數的最大可發(fā)送字節(jié)數，返回能發(fā)送的最大字節(jié)數fields -要發(fā)送