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

1、【轉(zhuǎn)自小峰博客】協(xié)調(diào)器的啟動【自動模式】發(fā)布：2010-11-08 20:17 | 作者：tuzhuke | 來源：飛比”Zigbee 論壇使用的協(xié)議棧版本信息：ZigBee2006ZStack-1.4.3-1.2.1Zigbee網(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$.ToolsCC2430D

2、Bf8wCo nfig.cfg即編譯了 ZDO_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()->ZDA

3、pp_l nit() 進(jìn)入 ZDApp_Init()函數(shù)：* void ZDAppn it( byte task_id )uint8 capabilities;/ Save the task IDZDAppTaskID = task_id;/ Initialize the ZDO global device short address storageZDAppNwkAddr.addrMode = Addr16Bit;ZDAppNwkAddr.addr.shortAddr = INVALID_NODE_ADDR; /0xFFFE (void)NLME_GetExtAddr(); / Load t

4、he saveExtAddr pointer./ Check for manual"Hold Auto Start"/ 檢測到有手工設(shè)置 SW_1 則會設(shè)置 devState = 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

5、 doesn't have a Simple description, but we still need/ to register the endpoint.afRegister( (endPointDesc_t *)&ZDApp_epDesc );#if defined( ZDO_USERDESC_RESPONSE )ZDApp_InitUserDesc();#endif / ZDO_USERDESC_RESPONSE/ set broadcast address mask to support broadcast filtering NLME_GetRequest(nwk

6、CapabilityInfo, 0, &capabilities);NLME_SetBroadcastFilter( capabilities );/ Start the device?if ( devState != DEV_HOLD )ZDOInitDevice( 0 );/* 如果 devState=DEV_HOLD, 則不會調(diào)用 ZDOInitDevice() 來初始化網(wǎng)絡(luò) 即不組網(wǎng)也不進(jìn)網(wǎng) .LED4 閃爍等待應(yīng)用程序來開啟設(shè)備并初始化網(wǎng)絡(luò)*/else/ Blink LED to indicate HOLD_STARTHalLedBlink ( HAL_LED_4, 0, 5

7、0, 500 );ZDApp_RegisterCBs();*協(xié)調(diào)器沒有編譯 HOLD_AUTO_START, 也沒有手工設(shè)置 SW_1, 初始化 devState = DEV_INIT( 參 見基本問題說明 3). 因此直接在 ZDApp_Init() 中進(jìn)入 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

8、 networkStateNV = ZDO_INITDEV_NEW_NETWORK_STATE;uint16 extendedDelay = 0;devState = DEV_INIT;/ Remove the Hold state/ Initialize leave control logic/ 函數(shù)讀取 NV 項(xiàng)目 ZCD_NV_LEAVE_CTRL 的值 ,ZDApp_LeaveCtrl指向這個(gè)值ZDApp_LeaveCtrlInit();/ Check leave control reset settingsZDApp_LeaveCtrlStartup( &devState,

9、&startDelay );/ Leave may make the hold state come back/ 以上兩個(gè)函數(shù)設(shè)置了對設(shè)備離開時(shí)的控制 ,如果有延時(shí)則延時(shí) , 沒有則/ 把設(shè)備狀態(tài)設(shè)為 DEV_HOLDif ( devState = DEV_HOLD )/ZDO_INITDEV_LEAVE_NOT_STARTED: 該設(shè)備沒有在網(wǎng)絡(luò)中，下次調(diào)用才啟用 . return ( ZDO_INITDEV_LEAVE_NOT_STARTED );/ Don't join - (one time).#if defined ( NV_RESTORE )/ Get Keypad

10、 directly to see if a reset nv is needed./ Hold down the SW_BYPASS_NV key (defined in OnBoard.h)/ while booting(引導(dǎo) ) to skip past NV Restore.if ( HalKeyRead() = SW_BYPASS_NV )/SW_BYPASS_NV 按鍵處于按下狀態(tài)時(shí) , 則避開網(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 sh

11、ould 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_ReadNetworkRestoreState();/ 如果設(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

12、();else / 如果設(shè)備的網(wǎng)絡(luò)狀態(tài)為新的網(wǎng)絡(luò)狀態(tài) , 在下面進(jìn)行處理/ Wipe out( 清除 ) the network state in NVNLME_InitNV();NLME_SetDefaultNV(); / 設(shè)置默認(rèn) 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 n

13、etwork stateextendedDelay = (uint16)(NWK_START_DELAY + startDelay)+ (osal_rand() & EXTENDED_JOINING_RANDOM_MASK);/ Initialize device securityZDApp_SecInit( networkStateNV );/ Trigger the network startZDApp_NetworkInit( extendedDelay );return ( networkStateNV );*分兩種情況 :(1) 如果協(xié)調(diào)器預(yù)編譯了 NV_RESTORE, 且

14、函數(shù) ZDApp_ReadNetworkRestoreState()返回值為ZDO_INITDEV_RESTORED_NETWORK_STATE, 則進(jìn)入 ZDApp_RestoreNetworkState() 里 設(shè)置 ZDO_Config_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) . 則進(jìn)入這個(gè)函數(shù)進(jìn)行恢復(fù)/ 先判斷如果

15、短地址為 0 則設(shè)置設(shè)備邏輯類型為協(xié)調(diào)器且 devStartMode = MODE_RESUME / 否則設(shè)置 devStartMode = MODE_RESUMEZDAppNwkAddr.addr.shortAddr = NLME_GetShortAddr();if ( ZDAppNwkAddr.addr.shortAddr = 0 ) /如果短地址是 0, 即協(xié)調(diào)器ZDO_Config_Node_Descriptor.LogicalType = NODETYPE_COORDINATOR; /!devStartMode = MODE_RESUME; /MODE_RESUME!*(2) 如果協(xié)

16、調(diào)器沒有預(yù)編譯 NV_RESTORE,networkStateNV=ZDO_INITDEV_NEW_NETWORK_STATE, 但由于協(xié)調(diào)器編譯了 ZDO_COORDINATOR 而沒 有編譯 SOFT_START, 因此 ZDAppDetermineDeviceType()不起作用 . 因此ZDO_Config_Node_Descriptor.LogicalType 和 devStartMode 這兩個(gè)關(guān)鍵參數(shù)保持初始化時(shí)的 值:ZDO_Config_Node_Descriptor.LogicalType = NODETYPE_COORDINATOR( 見基本問題說 明 6)devStar

17、tMode = MODE_HARD(見基本問題說明 4)對于協(xié)調(diào)器 , 這兩種情況最終都是確定兩個(gè)關(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 delay )if ( delay )/ Wait awhile before starti ng the deviceosal_start_timerEx( ZDAppTaskID, ZDO_NETWORK_INIT, delay );elseo

18、sal_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 ( eve nts & ZDO_NETWORK_INIT )/In itialize apps and start the n etworkdevState = DEV_INIT;ZDO_StartDevice( (ui nt8)ZDO_C o

19、n 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-08 20:18:11 可以看到調(diào)用了devStartMode,DEFZDO_StartDevice( (uint8)ZDO_Config_Node_Descriptor.LogicalType, AULT_BEACON_ORDER, D

20、EFAULT_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 logicalType, devStartModes_t startMode, byte beaconOrder, byte superframeOrder )ZStatus_t ret;ret = ZUnsupportedMode;#if def

21、ined(ZDO_COORDINATOR)if ( logicalType = NODETYPE_COORDINATOR )if ( startMode = MODE_HARD ) /MODE_HARDdevState = DEV_COORD_STARTING; /Started as Zigbee Coordinator/ 建網(wǎng)ret = NLME_NetworkFormationRequest( zgConfigPANID, zgDefaultChannelList, zgDefaultStartingScanDuration, beaconOrder, superframeOrder,

22、false );else if ( startMode = MODE_RESUME ) /MODE_RESUME/ Just start the coordinatordevState = DEV_COORD_STARTING;ret = NLME_StartRouterRequest( beaconOrder, beaconOrder, false );else / 錯(cuò)誤，未知啟動模式#if defined( LCD_SUPPORTED )/HalLcdWriteScreen( "StartDevice ERR", "MODE unknown" );C

23、learScreen();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 = NODETYPE_ROUTER | logicalType = NODETYPE_DEVICE )if ( (startMode = MO

24、DE_JOIN) | (startMode = MODE_REJOIN) )devState = DEV_NWK_DISC; /Discovering PAN's to join#if defined( MANAGED_SCAN )ZDOManagedScan_Next();ret = NLME_NetworkDiscoveryRequest( managedScanChannelMask, BEACON_ORDER_15_MSEC ); #elseret = NLME_NetworkDiscoveryRequest( zgDefaultChannelList, zgDefaultSt

25、artingScanDuration ); #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 */ scanCnf.hdr.Status = ZSUCCESS;scanCnf.ScanType = ZMAC_ORPHAN_SCAN; sc

26、anCnf.UnscannedChannels = 0;scanCnf.ResultListSize = 0; nwk_ScanJoiningOrphan(&scanCnf);ret = ZSuccess;elsedevState = DEV_NWK_ORPHAN; / 孤兒ret = NLME_OrphanJoinRequest( zgDefaultChannelList, zgDefaultStartingScanDuration );else#if defined( LCD_SUPPORTED )/ HalLcdWriteScreen( "StartDevice ERR

27、", "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_Net

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

29、DO_COORDINATOR)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

30、HOLD_AUTO_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 的

31、 ZDO_NETWORK_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ò)建立成功/ Succes

32、sfully started 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_SCA

33、N_INCREMENT ) < 0xff )NLME_SetEnergyThreshold( (uint8)(NLME_GetEnergyThreshold() + ENERGY_SCAN_INCREMENT) ); osal_set_event( ZDAppTaskID, ZDO_NETWORK_INIT ); /重新初始化建立網(wǎng)絡(luò)else/ Failed to start network. Enter a dormant state (until user intervenes)devState = DEV_INIT;osal_set_event( ZDAppTaskID, ZDO_

34、STATE_CHANGE_EVT );*如果協(xié)調(diào)器建立網(wǎng)絡(luò)成功 ,則觸發(fā) ZDAppTaskID 的 ZDO_STATE_CHANGE_EVT事件. 看下對ZDO_STATE_CHANGE_EVT 的處理 :*if ( events & ZDO_STATE_CHANGE_EVT )ZDO_UpdateNwkStatus( devState );/ Return unprocessed eventsreturn (events A ZDO_STATE_CHANGE_EVT);*調(diào)用了 ZDO_UpdateNwkStatus( devState ), 網(wǎng)絡(luò)狀態(tài)改變 ,這個(gè)函數(shù)會更新和發(fā)送信

35、息通知每個(gè)注冊登記過的應(yīng)用 終端.*void ZDO_UpdateNwkStatus( devStates_t state )/ Endpoint/Interface descriptor list.epList_t *epDesc = epList;byte bufLen = sizeof(osal_event_hdr_t);osal_event_hdr_t *msgPtr;ZDAppNwkAddr.addr.shortAddr = NLME_GetShortAddr();(void)NLME_GetExtAddr(); / Load the saveExtAddr pointer.whil

36、e ( epDesc )if ( epDesc->epDesc->endPoint != ZDO_EP )msgPtr = (osal_event_hdr_t *)osal_msg_allocate( bufLen );if ( msgPtr )msgPtr->event = ZDO_STATE_CHANGE; / Command ID msgPtr->status = (byte)state;osal_msg_send( *(epDesc->epDesc->task_id), (byte *)msgPtr ); /發(fā)往應(yīng)用任務(wù)epDesc = epDesc

37、->nextDesc;*對 SampleApp 的協(xié)調(diào)器來說，這里觸發(fā)應(yīng)用任務(wù) SampleApp_TaskID 的 ZDO_STATE_CHANGE 事件, 看下對 ZDO_STATE_CHANGE 的處理 :*case ZDO_STATE_CHANGE:SampleApp_NwkState = (devStates_t)(MSGpkt->hdr.status); /獲取設(shè)備當(dāng)前狀態(tài)if ( (SampleApp_NwkState = DEV_ZB_COORD)| (SampleApp_NwkState = DEV_ROUTER)| (SampleApp_NwkState = DEV_END_DEVICE) )/ Start send