ZigBee學(xué)習(xí)之17—ZStack API解讀5.doc

#1樓主：【原創(chuàng)】ZigBee學(xué)習(xí)之17ZStack API解讀5文章發(fā)表于：2010-02-07 10:43網(wǎng)絡(luò)層（NWK）網(wǎng)絡(luò)層為高層提供下面函數(shù)功能： 網(wǎng)絡(luò)管理 地址管理 網(wǎng)絡(luò)變量和效能函數(shù)除了管理功能外，NWK還提供數(shù)據(jù)服務(wù)，只是應(yīng)用不能訪問數(shù)據(jù)服務(wù)。應(yīng)用需要通過AF數(shù)據(jù)接口AF_DataRequest()來發(fā)送數(shù)據(jù)。網(wǎng)絡(luò)管理ZStatus_t NLME_NetworkDiscoveryRequest( uint32 ScanChannels,byte ScanDuration ); 用來請(qǐng)求網(wǎng)絡(luò)層發(fā)現(xiàn)鄰居路由器。在加入操作執(zhí)行網(wǎng)絡(luò)掃描前應(yīng)該調(diào)用此函數(shù)。掃描確認(rèn)（結(jié)果）將以回調(diào)函數(shù)ZDO_NetworkDiscoveryConfirmCB()返回。推薦用戶使用ZDO_StartDevice()來代替此函數(shù)。（除非你清楚的知道網(wǎng)絡(luò)加入過程）ScanChannels -執(zhí)行發(fā)現(xiàn)的通道，2.4GHz條件下只能使用通道11-26（0x07FFF800）ScanDuration -新網(wǎng)絡(luò)啟動(dòng)前，每個(gè)通道被其他網(wǎng)絡(luò)掃描的時(shí)間 BEACON_ORDER_15_MSEC 0 15.36 milliseconds BEACON_ORDER_30_MSEC 1 30.72 milliseconds BEACON_ORDER_60_MSEC 2 61.44 milliseconds BEACON_ORDER_120_MSEC 3 122.88 milliseconds BEACON_ORDER_240_MSEC 4 245.76 milliseconds BEACON_ORDER_480_MSEC 5 491.52 milliseconds BEACON_ORDER_1_SECOND 6 983.04 milliseconds BEACON_ORDER_2_SECONDS 7 1966.08 milliseconds BEACON_ORDER_4_SECONDS 8 3932.16 milliseconds BEACON_ORDER_7_5_SECONDS 9 7864.32 milliseconds BEACON_ORDER_15_SECONDS 10 15728.64 milliseconds BEACON_ORDER_31_SECONDS 11 31457.28 milliseconds BEACON_ORDER_1_MINUTE 12 62914.58 milliseconds BEACON_ORDER_2_MINUTES 13 125829.12 milliseconds BEACON_ORDER_4_MINUTES 14 251658.24 milliseconds BEACON_ORDER_NO_BEACONS 15 No Beacons transmitted 返回值：ZStatus_t -ZComDef.h中定義的狀態(tài)值ZStatus_t NLME_NwkDiscReq2( NLME_ScanFields_t* fields ); 用來請(qǐng)求網(wǎng)絡(luò)層發(fā)現(xiàn)鄰居路由器。用此函數(shù)來執(zhí)行一個(gè)網(wǎng)絡(luò)掃描，但是不加入網(wǎng)絡(luò)。掃描確認(rèn)（結(jié)果）將以回調(diào)函數(shù)ZDO_NetworkDiscoveryConfirmCB()返回?；卣{(diào)函數(shù)執(zhí)行以后通過調(diào)用NLME_NwkDiscTerm()清除此活動(dòng)。fields 掃描結(jié)構(gòu)體typedef struct uint32 channels; uint8 duration; NLME_ScanFields_t;void NLME_NwkDiscTerm( void ); ZStatus_t NLME_NetworkFormationRequest( uint16 PanId, uint32 ScanChannels, byte ScanDuration, byte BeaconOrder, byte SupeRFrameOrder, byte BatteryLifeExtension );函數(shù)允許上層請(qǐng)求設(shè)備構(gòu)成網(wǎng)絡(luò)并成為網(wǎng)絡(luò)中的協(xié)調(diào)器。執(zhí)行結(jié)果返回回調(diào)函數(shù)ZDO_NetworkFormationConfirmCB()。推薦用戶使用ZDO_StartDevice()來代替此函數(shù)。PanId -此設(shè)備建立網(wǎng)絡(luò)所使用的ID，值范圍：00x3FFF。如果0xFFFF被使用，則網(wǎng)絡(luò)層將為網(wǎng)絡(luò)選擇此PanID。如果發(fā)現(xiàn)網(wǎng)絡(luò)的PAN ID相同，則增加PAN ID直到其唯一。BeaconOrder Zigbee 2006中此參數(shù)為：BEACON_ORDER_NO_BEACONS.SuperframeOrder Zigbee 2006中此參數(shù)為：BEACON_ORDER_NO_BEACONS. BatteryLifeExtension -為TRUE則請(qǐng)求協(xié)調(diào)器支持電池壽命擴(kuò)展模式ZStatus_t NLME_StartRouterRequest( byte BeaconOrder, byte SuperframeOrder, byte BatteryLifeExtension );函數(shù)允許上層請(qǐng)求設(shè)備以路由器功能啟動(dòng)。執(zhí)行結(jié)果返回回調(diào)函數(shù) ZDO_StartRouterConfirmCB()。推薦用戶使用ZDO_StartDevice()來代替此函數(shù)。BeaconOrder Zigbee 2006中此參數(shù)為：BEACON_ORDER_NO_BEACONS.SuperframeOrder Zigbee 2006中此參數(shù)為：BEACON_ORDER_NO_BEACONS. BatteryLifeExtension -為TRUE則請(qǐng)求協(xié)調(diào)器支持電池壽命擴(kuò)展模式ZStatus_t NLME_JoinRequest( uint8 *ExtendedPANID, uint16 PanId, byte Channel, byte CapabilityInfo ); 函數(shù)允許上層發(fā)送設(shè)備加入網(wǎng)絡(luò)的請(qǐng)求。執(zhí)行結(jié)果返回回調(diào)函數(shù) ZDO_JoinConfirmCB()。推薦用戶使用ZDO_StartDevice()來代替此函數(shù)。ExtendedPANID -想要加入的網(wǎng)絡(luò)的擴(kuò)展PAN IDCapabilityInfo -加入設(shè)備的操作性能 CAPINFO_ALTPANCOORD 0x01 CAPINFO_DEVICETYPE_FFD 0x02 CAPINFO_Power_AC 0x04 CAPINFO_RCVR_ON_IDLE 0x08 CAPINFO_SECURITY_CAPABLE 0x40 CAPINFO_ALLOC_ADDR 0x80ZStatus_t NLME_ReJoinRequest( void );已加入設(shè)備的重新加入。執(zhí)行結(jié)果返回到回調(diào)函數(shù)ZDO_JoinConfirmCB()ZStatus_t NLME_OrphanJoinRequest( uint32 ScanChannels, byte ScanDuration ); 請(qǐng)求網(wǎng)絡(luò)層孤兒節(jié)點(diǎn)的加入。此函數(shù)是一個(gè)暗含加入的掃描。執(zhí)行結(jié)果返回到回調(diào)函數(shù)ZDO_JoinConfirmCB()。推薦用戶使用ZDO_StartDevice()來代替此函數(shù)。以上的幾個(gè)函數(shù)基本上是被ZDO_StartDevice()的執(zhí)行所取代了，呵呵！ZStatus_t NLME_PermitJoiningRequest( byte PermitDuration );定義了協(xié)調(diào)器或路由器在一個(gè)固定的周期內(nèi)如何允許設(shè)備加入。PermitDuration -在這個(gè)指定的時(shí)間（單位為秒）內(nèi)允許設(shè)備關(guān)聯(lián)。0x00和0xff表示分別禁止或允許設(shè)備關(guān)聯(lián)。ZStatus_t NLME_DirectJoinRequest( byte *DevExtAddress, byte capInfo );請(qǐng)求協(xié)調(diào)器或路由器設(shè)備的網(wǎng)絡(luò)層加入一個(gè)設(shè)備作為其子設(shè)備。DevExtAddress -指向設(shè)備的IEEE地址ZStatus_t NLME_LeaveReq( NLME_LeaveReq_t* req );請(qǐng)求自己或者其他設(shè)備脫離網(wǎng)絡(luò)，執(zhí)行此函數(shù)不會(huì)導(dǎo)致其父節(jié)點(diǎn)重新分配設(shè)備地址。req 脫離請(qǐng)求數(shù)據(jù)結(jié)構(gòu): typedef struct uint8* extAddr; uint8 removeChildren; uint8 rejoin; uint8 silent; NLME_LeaveReq_t; extAddr -要脫離的設(shè)備的擴(kuò)展地址removeChildren -true 子設(shè)備也脫離，false只脫離當(dāng)前設(shè)備。目前只能用falserejoin -true 允許設(shè)備重新加入網(wǎng)絡(luò)，false 不允許設(shè)備重新加入網(wǎng)絡(luò)silent true will. false if the。void NLME_RemoveChild( uint8* extAddr, uint8 dealloc ); dealloc true will. false if the.ZMacStatus_t NwkPollReq( byte securityEnable );手動(dòng)發(fā)送一個(gè)MAC數(shù)據(jù)請(qǐng)求（此函數(shù)只適用于終設(shè)備（end devices）。正常情況下終設(shè)備的數(shù)據(jù)檢測(cè)（poll）由網(wǎng)絡(luò)層自動(dòng)處理，應(yīng)用可以通過調(diào)用NLME_SetPollRate()來改變速率，如果速率設(shè)為0則可以調(diào)用此函數(shù)來手動(dòng)推送數(shù)據(jù)。securityEnable 設(shè)為false. 返回值：ZMacStatus_t is the same as ZStatus_t status values defined in ZComDef.hvoid NLME_SetPollRate( uint16 newRate );（此函數(shù)只適用于終設(shè)備（end devices）newRate -單位為ms，數(shù)據(jù)推送到父設(shè)備的時(shí)間。void NLME_SetQueuedPollRate( uint16 newRate );設(shè)置/改變隊(duì)列推送（poll）速率。（此函數(shù)只適用于終設(shè)備（end devices），如果一個(gè)數(shù)據(jù)推送產(chǎn)生了數(shù)據(jù)消息，則數(shù)據(jù)推送率馬上設(shè)置到 Queued Poll Rate以排空父設(shè)備的隊(duì)列數(shù)據(jù)。newRate -有效值為：0x01-0xff，0為禁止隊(duì)列推送。void NLME_SetResponseRate( uint16 newRate );設(shè)置/改變應(yīng)答推送（poll）速率。（此函數(shù)只適用于終設(shè)備（end devices），我們可以讓應(yīng)答快一些。newRate -有效值為：0x01-0xff，0為禁止隊(duì)列推送。地址管理地址管理模塊提供底層的地址管理，用戶不能直接訪問這個(gè)模塊。APSME_LookupExtAddr和APSME_LookupNwkAddr提供本地地址查找，ZDP_IEEEAddrReq和ZDP_NwkAddrReq提供遠(yuǎn)程地址查找。byte *NLME_GetExtAddr( void ); 返回指向設(shè)備64位IEEE地址的指針。uint16 NLME_GetShortAddr( void ); 返回設(shè)備的16位網(wǎng)絡(luò)地址（短地址）。uint16 NLME_GetCoordShortAddr( void );返回設(shè)備父親的網(wǎng)絡(luò)地址（16位短地址），注意這個(gè)地址不是Zigbee協(xié)調(diào)器的短地址（總為0x0000）void NLME_GetCoordExtAddr( byte *buf );返回設(shè)備父親的IEEE地址（64位），注意這個(gè)地址不是Zigbee協(xié)調(diào)器的擴(kuò)展地址ZStatus_t NLME_SetRequest( ZNwkAttributes_t NIBAttribute, uint16 Index, void *Value );設(shè)置NIB屬性的值。NIBAttribute -只支持nwkProtocolVersion屬性ZStatus_t NLME_GetRequest( ZNwkAttributes_t NIBAttribute, uint16 Index, void *Value ); NIBAttribute -只支持如下屬性： nwkCapabilityInfo nwkNumNeighborTableEntries nwkNeighborTable nwkNumRoutingTableEntries nwkRoutingTableaddr_filter_t NLME_IsAddressBroADCast(uint16 shortAddress);基于設(shè)備性能，這個(gè)函數(shù)評(píng)估參數(shù)中提供的地址，決定是否是廣播地址shortAddress -要測(cè)試的地址addr_filter_t - ADDR_NOT_BCAST 不是一個(gè)廣播地址 ADDR_BCAST_FOR_ME 是一個(gè)廣播地址，且這個(gè)設(shè)備是正確的設(shè)備類型 ADDR_BCAST_NOT_ME 是一個(gè)廣播地址，這個(gè)設(shè)備是不是正確的目標(biāo)byte NLME_GetProtocolVersion(); 獲得NIB中的協(xié)議版本返回值： ZB_PROT_V1_0 1 ZB_PROT_V1_1 2 void NLME_SetBroadcastFilter(byte capabilities); 基于設(shè)備的性能設(shè)置位掩碼，用來處理有效的廣播地址capabilities -用來決定設(shè)備能處理哪些廣播