//ZDApp.c
 1 void ZDApp_Init( uint8 task_id )
 2 {
 3   // Save the task ID
 4   ZDAppTaskID = task_id;
 5 
 6   // Initialize the ZDO global device short address storage
 7   ZDAppNwkAddr.addrMode = Addr16Bit;
 8   ZDAppNwkAddr.addr.shortAddr = INVALID_NODE_ADDR;//0xFFFE
 9   (void)NLME_GetExtAddr();  // Load the saveExtAddr pointer.
10 
11   // Check for manual "Hold Auto Start"
12   ZDAppCheckForHoldKey();检测到有手工置位SW_1则会设置devState = DEV_HOLD,从而避开网络初始化
13 
14   // Initialize ZDO items and setup the device - type of device to create.
15   ZDO_Init();//通过判断预编译来开启一些函数功能
16 
17   // Register the endpoint description with the AF
18   // This task doesn‘t have a Simple description, but we still need
19   // to register the endpoint.
20   afRegister( (endPointDesc_t *)&ZDApp_epDesc );
21 
22 #if defined( ZDO_USERDESC_RESPONSE )
23   ZDApp_InitUserDesc();
24 #endif // ZDO_USERDESC_RESPONSE
25 
26   // Start the device?
27   if ( devState != DEV_HOLD ) //devState 初值为DEV_INIT ， 所以在初始化ZDA层时，就执行该条件语句
   /*如果devState=DEV_HOLD,则不会调用ZDOInitDevice()来初始化网络
    即不组网也不入网.LED4闪烁等待应用程序来开启设备并初始化网络
  */
28   {
29     ZDOInitDevice( 0 );
30   }
31   else
32   {
33     ZDOInitDevice( ZDO_INIT_HOLD_NWK_START );
34     // Blink LED to indicate HOLD_START
35     HalLedBlink ( HAL_LED_4, 0, 50, 500 );
36   }
37 
38   // Initialize the ZDO callback function pointers zdoCBFunc[]
39   ZDApp_InitZdoCBFunc();
40 
41   ZDApp_RegisterCBs();
42 } /* ZDApp_Init() */

 //ZDApp.c
 1 uint8 ZDOInitDevice( uint16 startDelay )
 2 {
 3   uint8 networkStateNV = ZDO_INITDEV_NEW_NETWORK_STATE;
 4   uint16 extendedDelay = 0;
 5 
 6   if ( devState == DEV_HOLD )
 7   {
 8     // Initialize the RAM items table, in case an NV item has been updated.
 9     zgInitItems( FALSE );
10   }
11 
12   ZDConfig_InitDescriptors();
13   //devtag.071807.todo - fix this temporary solution
14   _NIB.CapabilityFlags = ZDO_Config_Node_Descriptor.CapabilityFlags;
15 
16 #if defined ( NV_RESTORE )
17   // Get Keypad directly to see if a reset nv is needed.
18   // Hold down the SW_BYPASS_NV key (defined in OnBoard.h)
19   // while booting to skip past NV Restore.
20   if ( HalKeyRead() == SW_BYPASS_NV )
21     networkStateNV = ZDO_INITDEV_NEW_NETWORK_STATE;
22   else
23   {
24     // Determine if NV should be restored
25     networkStateNV = ZDApp_ReadNetworkRestoreState();
26   }
27 
28   if ( networkStateNV == ZDO_INITDEV_RESTORED_NETWORK_STATE )
29   {
30     networkStateNV = ZDApp_RestoreNetworkState();
31   }
32   else
33   {
34     // Wipe out the network state in NV
35     NLME_InitNV();
36     NLME_SetDefaultNV();
37     // clear NWK key values
38     ZDSecMgrClearNVKeyValues();
39   }
40 #endif
41 
42   if ( networkStateNV == ZDO_INITDEV_NEW_NETWORK_STATE )
43   {
44     ZDAppDetermineDeviceType();
45 
46     // Only delay if joining network - not restoring network state
47     extendedDelay = (uint16)((NWK_START_DELAY + startDelay)
48               + (osal_rand() & EXTENDED_JOINING_RANDOM_MASK));
49   }
50 
51   // Initialize the security for type of device
52   ZDApp_SecInit( networkStateNV );
53 
54   if( ZDO_INIT_HOLD_NWK_START != startDelay )
55   {
56     devState = DEV_INIT;    // Remove the Hold state
57 
58     // Initialize leave control logic
59     ZDApp_LeaveCtrlInit();
60 
61     // Check leave control reset settings
62     ZDApp_LeaveCtrlStartup( &devState, &startDelay );
63 
64     // Leave may make the hold state come back
65     if ( devState == DEV_HOLD )
66     {
67       // Set the NV startup option to force a "new" join.
68       zgWriteStartupOptions( ZG_STARTUP_SET, ZCD_STARTOPT_DEFAULT_NETWORK_STATE );
69 
70       // Notify the applications
71       osal_set_event( ZDAppTaskID, ZDO_STATE_CHANGE_EVT );
72 
73       return ( ZDO_INITDEV_LEAVE_NOT_STARTED );   // Don‘t join - (one time).
74     }
75 
76     // Trigger the network start
77     ZDApp_NetworkInit( extendedDelay ); //网络初始化，跳到相应的函数里头
78   }
79 
80   // set broadcast address mask to support broadcast filtering
81   NLME_SetBroadcastFilter( ZDO_Config_Node_Descriptor.CapabilityFlags );
82 
83   return ( networkStateNV );
84 }

 1 void ZDApp_NetworkInit( uint16 delay )
 2 {
 3   if ( delay )
 4   {
 5     // Wait awhile before starting the device
 6     osal_start_timerEx( ZDAppTaskID, ZDO_NETWORK_INIT, delay );
 7     //发送ZDO_NETWORK_INIT（网络初始化）消息到 ZDApp层，转到                                                                                                                  //ZDApp层，执行The fifth step  ， ZDApp_event_loop() 函数

 8   }
 9   else
10   {
11     osal_set_event( ZDAppTaskID, ZDO_NETWORK_INIT );
12   }
13 }

  1 UINT16 ZDApp_event_loop( uint8 task_id, UINT16 events )
  2 {
  3   uint8 *msg_ptr;
  4 
  5   if ( events & SYS_EVENT_MSG )
  6   {
  7     while ( (msg_ptr = osal_msg_receive( ZDAppTaskID )) )
  8     {
  9       ZDApp_ProcessOSALMsg( (osal_event_hdr_t *)msg_ptr );
 10 
 11       // Release the memory
 12       osal_msg_deallocate( msg_ptr );
 13     }
 14 
 15     // Return unprocessed events
 16     return (events ^ SYS_EVENT_MSG);
 17   }
 18 
 19   if ( events & ZDO_NETWORK_INIT )//网络初始化事件处理
 20   {
 21     // Initialize apps and start the network
 22     devState = DEV_INIT;
 23     osal_set_event( ZDAppTaskID, ZDO_STATE_CHANGE_EVT );
 24 
 25     ZDO_StartDevice( (uint8)ZDO_Config_Node_Descriptor.LogicalType, devStartMode,
 26                      DEFAULT_BEACON_ORDER, DEFAULT_SUPERFRAME_ORDER );
 27 //设备逻辑类型，启动模式，信标时间，超帧长度，去启动设备
 28     // Return unprocessed events
 29     return (events ^ ZDO_NETWORK_INIT);
 30   }
 31 
 32   if ( ZSTACK_ROUTER_BUILD )
 33   {
 34     if ( events & ZDO_NETWORK_START )
 35     {
 36       ZDApp_NetworkStartEvt();
 37 
 38       // Return unprocessed events
 39       return (events ^ ZDO_NETWORK_START);
 40     }
 41 
 42     if ( events & ZDO_ROUTER_START )
 43     {
 44       if ( nwkStatus == ZSuccess )
 45       {
 46         if ( devState == DEV_END_DEVICE )
 47           devState = DEV_ROUTER;
 48 
 49         osal_pwrmgr_device( PWRMGR_ALWAYS_ON );
 50       }
 51       else
 52       {
 53         // remain as end device!!
 54       }
 55       osal_set_event( ZDAppTaskID, ZDO_STATE_CHANGE_EVT );
 56 
 57       // Return unprocessed events
 58       return (events ^ ZDO_ROUTER_START);
 59     }
 60   }
 61 
 62   if ( events & ZDO_STATE_CHANGE_EVT )
 63   {
 64     ZDO_UpdateNwkStatus( devState );
 65 
 66     // At start up, do one MTO route discovery if the device is a concentrator
 67     if ( zgConcentratorEnable == TRUE )
 68     {
 69       // Start next event
 70       osal_start_timerEx( NWK_TaskID, NWK_MTO_RTG_REQ_EVT, 100 );
 71     }
 72 
 73     // Return unprocessed events
 74     return (events ^ ZDO_STATE_CHANGE_EVT);
 75   }
 76 
 77   if ( events & ZDO_COMMAND_CNF )
 78   {
 79     // User defined logic
 80 
 81     // Return unprocessed events
 82     return (events ^ ZDO_COMMAND_CNF);
 83   }
 84 
 85   if ( events & ZDO_NWK_UPDATE_NV )
 86   {
 87     ZDApp_SaveNetworkStateEvt();
 88 
 89     // Return unprocessed events
 90     return (events ^ ZDO_NWK_UPDATE_NV);
 91   }
 92 
 93   if ( events & ZDO_DEVICE_RESET )
 94   {
 95 #ifdef ZBA_FALLBACK_NWKKEY
 96     if ( devState == DEV_END_DEVICE_UNAUTH )
 97     {
 98       ZDSecMgrFallbackNwkKey();
 99     }
100     else
101 #endif
102     {
103       // Set the NV startup option to force a "new" join.
104       zgWriteStartupOptions( ZG_STARTUP_SET, ZCD_STARTOPT_DEFAULT_NETWORK_STATE );
105 
106       // The device has been in the UNAUTH state, so reset
107       // Note: there will be no return from this call
108       SystemResetSoft();
109     }
110   }
111 
112   if ( ZG_SECURE_ENABLED )
113   {
114     return ( ZDApp_ProcessSecEvent( task_id, events ) );
115   }
116   else
117   {
118     // Discard or make more handlers
119     return 0;
120   }
121 }

  //ZDObject.c
  1 void ZDO_StartDevice( byte logicalType, devStartModes_t startMode, byte beaconOrder, byte superframeOrder )
  2 {
  3   ZStatus_t ret;
  4 #if defined ( ZIGBEE_FREQ_AGILITY )
  5   static uint8 discRetries = 0;
  6 #endif
  7 #if defined ( ZIGBEE_COMMISSIONING )
  8   static uint8 scanCnt = 0;
  9 #endif
 10 
 11   ret = ZUnsupportedMode;
 12 
 13   if ( ZG_BUILD_COORDINATOR_TYPE && logicalType == NODETYPE_COORDINATOR )//当设备作为协调器时，执行这个条件语句。
 14   {
 15     if ( startMode == MODE_HARD )
 16     {
 17       devState = DEV_COORD_STARTING;
 18       ret = NLME_NetworkFormationRequest( zgConfigPANID, zgApsUseExtendedPANID, zgDefaultChannelList,
 19                                           zgDefaultStartingScanDuration, beaconOrder,
 20                                           superframeOrder, false );

      //向网络层发送网络形成请求。当网络层执行 NLME_NetworkFormationRequest（）建立网络后，将给予 ZDO层反馈信息。

      // 接着去执行ZDApp层的 ZDO_NetworkFormationConfirmCB（）函数

 21     }
 22     else if ( startMode == MODE_RESUME )
 23     {
 24       // Just start the coordinator
 25       devState = DEV_COORD_STARTING;
 26       ret = NLME_StartRouterRequest( beaconOrder, beaconOrder, false );
 27     }
 28     else
 29     {
 30 #if defined( LCD_SUPPORTED )
 31       HalLcdWriteScreen( "StartDevice ERR", "MODE unknown" );
 32 #endif
 33     }
 34   }
 35 
 36   if ( ZG_BUILD_JOINING_TYPE && (logicalType == NODETYPE_ROUTER || logicalType == NODETYPE_DEVICE) )//当为终端设备或路由时
 37   {
 38     if ( (startMode == MODE_JOIN) || (startMode == MODE_REJOIN) )
 39     {
 40       devState = DEV_NWK_DISC;
 41

       //zgDefaultChannelList与协调器形成网络的通道号匹配。 网络发现请求。

      // 继而转到ZDO_NetworkDiscoveryConfirmCB（）函数

 42   #if defined( MANAGED_SCAN )
 43       ZDOManagedScan_Next();
 44       ret = NLME_NetworkDiscoveryRequest( managedScanChannelMask, BEACON_ORDER_15_MSEC );
 45   #else
 46       ret = NLME_NetworkDiscoveryRequest( zgDefaultChannelList, zgDefaultStartingScanDuration );
 47     #if defined ( ZIGBEE_FREQ_AGILITY )
 48       if ( !( ZDO_Config_Node_Descriptor.CapabilityFlags & CAPINFO_RCVR_ON_IDLE ) &&
 49             ( ret == ZSuccess ) && ( ++discRetries == 4 ) )
 50       {
 51         // For devices with RxOnWhenIdle equals to FALSE, any network channel
 52         // change will not be recieved. On these devices or routers that have
 53         // lost the network, an active scan shall be conducted on the Default
 54         // Channel list using the extended PANID to find the network. If the
 55         // extended PANID isn‘t found using the Default Channel list, an scan
 56         // should be completed using all channels.
 57         zgDefaultChannelList = MAX_CHANNELS_24GHZ;
 58       }
 59     #endif // ZIGBEE_FREQ_AGILITY
 60     #if defined ( ZIGBEE_COMMISSIONING )
 61       if (startMode == MODE_REJOIN && scanCnt++ >= 5 )
 62       {
 63         // When ApsUseExtendedPanID is commissioned to a non zero value via
 64         // application specific means, the device shall conduct an active scan
 65         // on the Default Channel list and join the PAN with the same
 66         // ExtendedPanID. If the PAN is not found, an scan should be completed
 67         // on all channels.
 68         // When devices rejoin the network and the PAN is not found from
 69         zgDefaultChannelList = MAX_CHANNELS_24GHZ;
 70       }
 71     #endif // ZIGBEE_COMMISSIONING
 72   #endif
 73     }
 74     else if ( startMode == MODE_RESUME )
 75     {
 76       if ( logicalType == NODETYPE_ROUTER )
 77       {
 78         ZMacScanCnf_t scanCnf;
 79         devState = DEV_NWK_ORPHAN;
 80 
 81         /* if router and nvram is available, fake successful orphan scan */
 82         scanCnf.hdr.Status = ZSUCCESS;
 83         scanCnf.ScanType = ZMAC_ORPHAN_SCAN;
 84         scanCnf.UnscannedChannels = 0;
 85         scanCnf.ResultListSize = 0;
 86         nwk_ScanJoiningOrphan(&scanCnf);
 87 
 88         ret = ZSuccess;
 89       }
 90       else
 91       {
 92         devState = DEV_NWK_ORPHAN;
 93         ret = NLME_OrphanJoinRequest( zgDefaultChannelList,
 94                                       zgDefaultStartingScanDuration );
 95       }
 96     }
 97     else
 98     {
 99 #if defined( LCD_SUPPORTED )
100       HalLcdWriteScreen( "StartDevice ERR", "MODE unknown" );
101 #endif
102     }
103   }
104 
105   if ( ret != ZSuccess )
106   {
107     osal_start_timerEx(ZDAppTaskID, ZDO_NETWORK_INIT, NWK_RETRY_DELAY );
108   }
109 }

void ZDO_NetworkFormationConfirmCB( ZStatus_t Status )