ZIGBEE協(xié)調(diào)器啟動

1、【轉(zhuǎn)自小峰博客】協(xié)調(diào)器的啟動【自動模式】發(fā)布：2010-11-08 20:17 | 作者：tuzhuke | 來源：飛比”Zigbee 論壇使用的協(xié)議棧版本信息：ZigBee2006ZStack-Zigbee網(wǎng)絡(luò)設(shè)備啟動流程一協(xié)調(diào)器（自啟動模式）一以SampleApp 的協(xié)調(diào)器為例1、協(xié)調(diào)器預(yù)編譯信息可以看到協(xié)調(diào)器所帶的配置文件為:通過 project-options-c/c+compiler-extraOptions -f $PROJ_DIR$.ToolsCC2430DBf8wCoord.cfg-f $PROJ_DIR$.ToolsCC2430DBf8wCo nfig.cfg即編譯了 ZDO

2、_COORDINATOR 禾口 RTR_NWK.可以看到協(xié)調(diào)器通過 project-options-c/c+compiler-Preprocessor-Defined symbols預(yù)編譯包含了:CC2430EB; ZTOOL_P1; MT_TASK; LCD_SUPPORTED=DEBUG; MANAGED_SCAN 沒有編譯 HOLD_AUTO_START 禾口 SOFT_START.2、具體流程 mai n()-osaln it_system()-osall nitTasks()-ZDApp_l nit() 進入 ZDApp_Init()函數(shù)：* void ZDAppn it( byte

3、 task_id )uint8 capabilities;/ Save the task IDZDAppTaskID = task_id;/ Initialize the ZDO global device short address storage13ZDAppNwkAddr.addrMode = Addr16Bit;= INVALID_NODE_ADDR; /0xFFFE(void)NLME_GetExtAddr(); / Load the saveExtAddr pointer./ Check for manualHold Auto Start/ 檢測到有手工設(shè)置 SW_1 則會設(shè)置 d

4、evState = DEV_HOLD,從而避開網(wǎng)絡(luò)初始化ZDAppCheckForHoldKey();/ Initialize ZDO items and setup the device - type of device to create.ZDO_Init(); / 通過判斷預(yù)編譯來開啟一些函數(shù)功能/ Register the endpoint description with the AF/ This task doesnt have a Simple description, but we still need/ to register the endpoint.afRegister(

5、 (endPointDesc_t *)&ZDApp_epDesc );#if defined( ZDO_USERDESC_RESPONSE )ZDApp_InitUserDesc();#endif / ZDO_USERDESC_RESPONSE/ set broadcast address mask to support broadcast filteringNLME_GetRequest(nwkCapabilityInfo, 0, &capabilities);NLME_SetBroadcastFilter( capabilities );/ Start the device?if ( de

6、vState != DEV_HOLD )ZDOInitDevice( 0 );/* 如果 devState=DEV_HOLD, 則不會調(diào)用 ZDOInitDevice() 來初始化網(wǎng)絡(luò) 即不組網(wǎng)也不進網(wǎng) .LED4 閃爍等待應(yīng)用程序來開啟設(shè)備并初始化網(wǎng)絡(luò)*/else/ Blink LED to indicate HOLD_STARTHalLedBlink ( HAL_LED_4, 0, 50, 500 );ZDApp_RegisterCBs();*協(xié)調(diào)器沒有編譯 HOLD_AUTO_START, 也沒有手工設(shè)置 SW_1, 初始化 devState = DEV_INIT( 參 見基本問題說明

7、3). 因此直接在 ZDApp_Init() 中進入 ZDOInitDevice( 0 ) 開啟設(shè)備 .*uint8 ZDOInitDevice( uint16 startDelay )/ 初始化設(shè)備網(wǎng)絡(luò)狀態(tài)為 ZDO_INITDEV_NEW_NETWORK_STATE: 新的網(wǎng)絡(luò)狀態(tài) ./ 可能意味著 ZCD_NV_STARTUP_OPTION 不能恢復(fù)，或沒有任何網(wǎng)絡(luò)狀態(tài)恢復(fù)uint8 networkStateNV = ZDO_INITDEV_NEW_NETWORK_STATE;uint16 extendedDelay = 0;devState = DEV_INIT;/ Remove th

8、e Hold state/ Initialize leave control logic/ 函數(shù)讀取 NV 項目 ZCD_NV_LEAVE_CTRL 的值 ,ZDApp_LeaveCtrl指向這個值ZDApp_LeaveCtrlInit();/ Check leave control reset settingsZDApp_LeaveCtrlStartup( &devState, &startDelay );/ Leave may make the hold state come back/ 以上兩個函數(shù)設(shè)置了對設(shè)備離開時的控制 ,如果有延時則延時 , 沒有則/ 把設(shè)備狀態(tài)設(shè)為 DEV_HOL

9、Dif ( devState = DEV_HOLD )/ZDO_INITDEV_LEAVE_NOT_STARTED: 該設(shè)備沒有在網(wǎng)絡(luò)中，下次調(diào)用才啟用 . return ( ZDO_INITDEV_LEAVE_NOT_STARTED );/ Dont join - (one time).#if defined ( NV_RESTORE )/ Get Keypad directly to see if a reset nv is needed./ Hold down the SW_BYPASS_NV key (defined in OnBoard.h)/ while booting(引導(dǎo) )

10、to skip past NV Restore.if ( HalKeyRead() = SW_BYPASS_NV )/SW_BYPASS_NV 按鍵處于按下狀態(tài)時 , 則避開網(wǎng)絡(luò)層的 NV 存儲networkStateNV = ZDO_INITDEV_NEW_NETWORK_STATE; /設(shè)備網(wǎng)絡(luò)狀態(tài)為新的網(wǎng)絡(luò)狀態(tài)else/ Determine if NV should be restored/ 函數(shù)返回的設(shè)備網(wǎng)絡(luò)狀態(tài)要么是新的網(wǎng)絡(luò)狀態(tài) ;要么是恢復(fù)的網(wǎng)絡(luò)狀態(tài) ; 以此/ 來確定要不要讀取 NV 里相應(yīng)條目來恢復(fù)網(wǎng)絡(luò)先前狀態(tài)networkStateNV = ZDApp_ReadNetwork

11、RestoreState();/ 如果設(shè)備的網(wǎng)絡(luò)狀態(tài)為恢復(fù)的網(wǎng)絡(luò)狀態(tài)if ( networkStateNV = ZDO_INITDEV_RESTORED_NETWORK_STATE )/ 恢復(fù)設(shè)備先前的網(wǎng)絡(luò)狀態(tài)參數(shù)并且/ 設(shè)置 devStartMode = MODE_RESUME!networkStateNV = ZDApp_RestoreNetworkState();else / 如果設(shè)備的網(wǎng)絡(luò)狀態(tài)為新的網(wǎng)絡(luò)狀態(tài) , 在下面進行處理/ Wipe out( 清除 ) the network state in NVNLME_InitNV();NLME_SetDefaultNV(); / 設(shè)置默認

12、 NV 條目#endif/ 如果設(shè)備的網(wǎng)絡(luò)狀態(tài)為新的網(wǎng)絡(luò)狀態(tài)if ( networkStateNV = ZDO_INITDEV_NEW_NETWORK_STATE )/ 根據(jù)預(yù)編譯來設(shè)置設(shè)備新的網(wǎng)絡(luò)狀態(tài)參數(shù)ZDAppDetermineDeviceType();/*!*/ Only delay if joining network - not restoring network stateextendedDelay = (uint16)(NWK_START_DELAY + startDelay)+ (osal_rand() & EXTENDED_JOINING_RANDOM_MASK);/ In

13、itialize device securityZDApp_SecInit( networkStateNV );/ Trigger the network startZDApp_NetworkInit( extendedDelay );return ( networkStateNV );*分兩種情況 :(1) 如果協(xié)調(diào)器預(yù)編譯了 NV_RESTORE, 且函數(shù) ZDApp_ReadNetworkRestoreState()返回值為ZDO_INITDEV_RESTORED_NETWORK_STATE, 則進入 ZDApp_RestoreNetworkState() 里 設(shè)置 ZDO_Config

14、_Node_Descriptor.LogicalType = NODETYPE_COORDINATOR和devStartMode = MODE_RESUME.*uint8 ZDApp_RestoreNetworkState( void )/ Are we a coordinator/ 設(shè)備的網(wǎng)絡(luò)狀態(tài)為恢復(fù)的網(wǎng)絡(luò)狀態(tài) . 則進入這個函數(shù)進行恢復(fù)/ 先判斷如果短地址為 0 則設(shè)置設(shè)備邏輯類型為協(xié)調(diào)器且 devStartMode = MODE_RESUME/ 否則設(shè)置 devStartMode = MODE_RESUME= NLME_GetShortAddr();if ( = 0 ) / 如果短地址

15、是 0, 即協(xié)調(diào)器ZDO_Config_Node_Descriptor.LogicalType = NODETYPE_COORDINATOR; /!devStartMode = MODE_RESUME; /MODE_RESUME!*(2) 如果協(xié)調(diào)器沒有預(yù)編譯 NV_RESTORE,networkStateNV=ZDO_INITDEV_NEW_NETWORK_STATE, 但由于協(xié)調(diào)器編譯了 ZDO_COORDINATOR 而沒 有編譯 SOFT_START, 因此 ZDAppDetermineDeviceType()不起作用 . 因此ZDO_Config_Node_Descriptor.Lo

16、gicalType 和 devStartMode 這兩個關(guān)鍵參數(shù)保持初始化時的 值:ZDO_Config_Node_Descriptor.LogicalType = NODETYPE_COORDINATOR( 見基本問題說 明 6)devStartMode = MODE_HARD(見基本問題說明 4)對于協(xié)調(diào)器 , 這兩種情況最終都是確定兩個關(guān)鍵設(shè)備網(wǎng)絡(luò)狀態(tài)參數(shù)的值 .對本例的 SampleApp 的協(xié)調(diào) 器, 沒有編譯 NV_RESTORE, 因此屬于情況 (2).然后調(diào)用 ZDApp_NetworkInit() 啟動網(wǎng)絡(luò) :*void ZDApp_NetworkInit( uint16 d

17、elay )if ( delay )/ Wait awhile before starti ng the deviceosal_start_timerEx( ZDAppTaskID, ZDO_NETWORK_INIT, delay );elseosal_set_eve nt( ZDAppTaskID, ZDO_NETWORK_INIT );*事件通過觸發(fā) ZDAppTaskID 的 ZDO_NETWORK_INIT事件.來看下對 ZDO_NETWORK_INIT的處理：*UINT16 ZDApp_eve nt_loop( byte task_id, UINT16 eve nts )if ( e

18、ve nts & ZDO_NETWORK_INIT )/In itialize apps and start the n etworkdevState = DEV_INIT;ZDO_StartDevice( (ui nt8)ZDO_C on fig_Node_Descriptor.LogicalType, devStartMode, DEFAULT_BEACON_ORDER, DEFAULT_SUPERFRAME_ORDER );/ Retur n un processed eve ntsretur n (eve nts A ZDO_NETWORK_INIT);*tuzhuke2010-11-

19、08 20:18:11 可以看到調(diào)用了devStartMode,DEFZDO_StartDevice( (uint8)ZDO_Config_Node_Descriptor.LogicalType, AULT_BEACON_ORDER, DEFAULT_SUPERFRAME_ORDER ); 這里設(shè)備網(wǎng)絡(luò)狀態(tài)參數(shù) :ZDO_Config_Node_Descriptor.LogicalType = NODETYPE_COORDINATOR devStartMode = MODE_HARD且協(xié)調(diào)器編譯了 ZDO_COORDINATOR*void ZDO_StartDevice( byte logic

20、alType, devStartModes_t startMode, byte beaconOrder, byte superframeOrder )ZStatus_t ret;ret = ZUnsupportedMode;#if defined(ZDO_COORDINATOR)if ( logicalType = NODETYPE_COORDINATOR )if ( startMode = MODE_HARD ) /MODE_HARDdevState = DEV_COORD_STARTING; /Started as Zigbee Coordinator/ 建網(wǎng)ret = NLME_Netw

21、orkFormationRequest( zgConfigPANID, zgDefaultChannelList, zgDefaultStartingScanDuration, beaconOrder, superframeOrder, false );else if ( startMode = MODE_RESUME ) /MODE_RESUME/ Just start the coordinatordevState = DEV_COORD_STARTING;ret = NLME_StartRouterRequest( beaconOrder, beaconOrder, false );el

22、se / 錯誤，未知啟動模式#if defined( LCD_SUPPORTED )/HalLcdWriteScreen( StartDevice ERR, MODE unknown );ClearScreen();Print8(HAL_LCD_LINE_1,10,StartDevice ERR,1); Print8(HAL_LCD_LINE_2,10,MODE unknown,1);#endif#endif / !ZDO_COORDINATOR/#if !defined ( ZDO_COORDINATOR ) | defined( SOFT_START )if ( logicalType =

23、 NODETYPE_ROUTER | logicalType = NODETYPE_DEVICE )if ( (startMode = MODE_JOIN) | (startMode = MODE_REJOIN) )devState = DEV_NWK_DISC; /Discovering PANs to join#if defined( MANAGED_SCAN )ZDOManagedScan_Next();ret = NLME_NetworkDiscoveryRequest( managedScanChannelMask, BEACON_ORDER_15_MSEC ); #elseret

24、= NLME_NetworkDiscoveryRequest( zgDefaultChannelList, zgDefaultStartingScanDuration ); #endifelse if ( startMode = MODE_RESUME ) /MODE_RESUME 恢復(fù)if ( logicalType = NODETYPE_ROUTER )ZMacScanCnf_t scanCnf;devState = DEV_NWK_ORPHAN;/* if router and nvram is available, fake successful orphan scan */= ZSU

25、CCESS;scanCnf.ScanType = ZMAC_ORPHAN_SCAN; scanCnf.UnscannedChannels = 0;scanCnf.ResultListSize = 0; nwk_ScanJoiningOrphan(&scanCnf);ret = ZSuccess;elsedevState = DEV_NWK_ORPHAN; / 孤兒ret = NLME_OrphanJoinRequest( zgDefaultChannelList, zgDefaultStartingScanDuration );else#if defined( LCD_SUPPORTED )/

26、 HalLcdWriteScreen( StartDevice ERR, MODE unknown ); Print8(HAL_LCD_LINE_1,10,StartDevice ERR,1);Print8(HAL_LCD_LINE_2,10,MODE unknown,1);#endif/#endif /!ZDO COORDINATOR | SOFT_STARTif ( ret != ZSuccess )osal_start_timerEx(ZDAppTaskID, ZDO_NETWORK_INIT, NWK_RETRY_DELAY );*通過參數(shù)可知協(xié)調(diào)器調(diào)用 NLME_NetworkFor

27、mationRequest( zgConfigPANID, zgDefaultChannelList,zgDefaultStartingScanDuration, beaconOrder, superframeOrder, false )進行網(wǎng)絡(luò)的組建 .而對 NLME_NetworkFormationRequest() 的調(diào)用會產(chǎn)生一個回調(diào)函數(shù) ZDO_NetworkFormationConfirmCB()( 見 主要函數(shù)說明 3), 來看下：*void ZDO_NetworkFormationConfirmCB( ZStatus_t Status )#if defined(ZDO_COOR

28、DINATOR)nwkStatus = (byte)Status;if ( Status = ZSUCCESS )/ LED on shows Coordinator startedHalLedSet ( HAL_LED_3, HAL_LED_MODE_ON );/ LED off forgets HOLD_AUTO_STARTHalLedSet (HAL_LED_4, HAL_LED_MODE_OFF);#if defined ( ZBIT )SIM_SetColor(0xd0ffd0);#endifif ( devState = DEV_HOLD )/ Began with HOLD_AU

29、TO_STARTdevState = DEV_COORD_STARTING;#if defined(BLINK_LEDS)elseHalLedSet ( HAL_LED_3, HAL_LED_MODE_FLASH ); / Flash LED to show failure#endifosal_set_event( ZDAppTaskID, ZDO_NETWORK_START );#endif /ZDO_COORDINATOR*如果 Status 返回 ZSUCCESS, 建立網(wǎng)絡(luò)成功 ,通過一些燈亮來來指示 ; 不成功則通過閃爍燈來指示 .最后觸發(fā)任務(wù)ZDAppTaskID 的 ZDO_NE

30、TWORK_START 事件,看下對 ZDO_NETWORK_START 的處理 :*#if defined (RTR_NWK)if ( events & ZDO_NETWORK_START )ZDApp_NetworkStartEvt();/ Return unprocessed eventsreturn (events A ZDO_NETWORK_START);*調(diào)用了 ZDApp_NetworkStartEvt()*void ZDApp_NetworkStartEvt( void )if ( nwkStatus = ZSuccess )/網(wǎng)絡(luò)建立成功/ Successfully star

31、ted a ZigBee networkif ( devState = DEV_COORD_STARTING )devState = DEV_ZB_COORD;osal_pwrmgr_device( PWRMGR_ALWAYS_ON );osal_set_event( ZDAppTaskID, ZDO_STATE_CHANGE_EVT );else / 網(wǎng)絡(luò)建立不成功 ,則增加能量閥值重新建網(wǎng) ./ Try again with a higher energy threshold !if ( ( NLME_GetEnergyThreshold() + ENERGY_SCAN_INCREMENT

32、 ) epDesc-endPoint != ZDO_EP )msgPtr = (osal_event_hdr_t *)osal_msg_allocate( bufLen );if ( msgPtr )msgPtr-event = ZDO_STATE_CHANGE; / Command IDmsgPtr-status = (byte)state;osal_msg_send( *(epDesc-epDesc-task_id), (byte *)msgPtr ); /發(fā)往應(yīng)用任務(wù)epDesc = epDesc-nextDesc;*對 SampleApp 的協(xié)調(diào)器來說，這里觸發(fā)應(yīng)用任務(wù) SampleA

33、pp_TaskID 的 ZDO_STATE_CHANGE 事件, 看下對 ZDO_STATE_CHANGE 的處理 :*case ZDO_STATE_CHANGE:SampleApp_NwkState = (devStates_t)(MSGpkt-hdr.status); /獲取設(shè)備當前狀態(tài)if ( (SampleApp_NwkState = DEV_ZB_COORD)| (SampleApp_NwkState = DEV_ROUTER)| (SampleApp_NwkState = DEV_END_DEVICE) )/ Start sending the periodic message in a regular interval.osal_start_timerEx( Samp