「ZigBee模块」协议栈-Z-Stack协议栈基础和数据传输实验

  1 int main( void )
  2 
  3 {
  4 
  5   // Turn off interrupts 
  6 
  7   //关闭所有中断
  8 
  9   osal_int_disable( INTS_ALL );
 10 
 11  
 12 
 13   // Initialization for board related stuff such as LEDs 
 14 
 15   //初始化系统时钟
 16 
 17   HAL_BOARD_INIT();
 18 
 19  
 20 
 21   // Make sure supply voltage is high enough to run 
 22 
 23   //检测芯片电压是否正常
 24 
 25   zmain_vdd_check();
 26 
 27  
 28 
 29   // Initialize board I/O
 30 
 31   //初始化外设
 32 
 33   InitBoard( OB_COLD );
 34 
 35  
 36 
 37   // Initialze HAL drivers
 38 
 39   //初始化芯片各硬件模块
 40 
 41   HalDriverInit();
 42 
 43  
 44 
 45   // Initialize NV System
 46 
 47   //初始化flash存储器
 48 
 49   osal_nv_init( NULL );
 50 
 51  
 52 
 53   // Initialize the MAC
 54 
 55   //初始化MAC层
 56 
 57   ZMacInit();
 58 
 59  
 60 
 61   // Determine the extended address
 62 
 63   //确定IEEE 64位地址
 64 
 65   zmain_ext_addr();
 66 
 67  
 68 
 69 #if defined ZCL_KEY_ESTABLISH
 70 
 71   //Initialize the Certicom certificate information.
 72 
 73   zmain_cert_init();
 74 
 75 #endif
 76 
 77  
 78 
 79   // Initialize basic NV items
 80 
 81   //初始化非易失变量
 82 
 83   zgInit();
 84 
 85  
 86 
 87 #ifndef NONWK
 88 
 89   // Since the AF isn‘t a task, call it‘s initialization routine
 90 
 91   afInit();
 92 
 93 #endif
 94 
 95  
 96 
 97   // Initialize the operating system
 98 
 99   //初始化操作系统***********************************初始化重点
100 
101   osal_init_system();
102 
103  
104 
105   // Allow interrupts
106 
107   //允许中断使能
108 
109   osal_int_enable( INTS_ALL );
110 
111  
112 
113   // Final board initialization
114 
115   //初始化按键
116 
117   InitBoard( OB_READY );
118 
119  
120 
121   // Display information about this device
122 
123   //显示设备信息
124 
125   zmain_dev_info();
126 
127  
128 
129   /* Display the device info on the LCD */
130 
131 #ifdef LCD_SUPPORTED
132 
133   zmain_lcd_init();
134 
135 #endif
136 
137  
138 
139 #ifdef WDT_IN_PM1
140 
141   /* If WDT is used, this is a good place to enable it. */
142 
143   WatchDogEnable( WDTIMX );
144 
145 #endif
146 
147  
148 
149   // No Return from here 
150 
151   // 执行操作系统，进去后不会返回************************运行重点
152 
153   osal_start_system(); 
154 
155  
156 
157   return 0;  // Shouldn‘t get here.
158 
159 } 

 1 uint8 osal_init_system( void )
 2 
 3 {
 4 
 5   // Initialize the Memory Allocation System
 6 
 7   // 初始化内存分配系统
 8 
 9   osal_mem_init();
10 
11  
12 
13   // Initialize the message queue
14 
15   // 初始化消息队列
16 
17   osal_qHead = NULL;
18 
19  
20 
21   // Initialize the timers
22 
23   // 初始化定时器
24 
25   osalTimerInit();
26 
27  
28 
29   // Initialize the Power Management System
30 
31   // 初始化电源管理系统
32 
33   osal_pwrmgr_init();
34 
35  
36 
37   // Initialize the system tasks.
38 
39   // 初始化系统任务**********************************重点
40 
41   osalInitTasks();
42 
43  
44 
45   // Setup efficient search for the first free block of heap.
46 
47   osal_mem_kick();
48 
49  
50 
51   return ( SUCCESS );
52 
53 }

 1 void osalInitTasks( void )
 2 
 3 {
 4 
 5   uint8 taskID = 0;
 6 
 7  
 8 
 9   //分配缓冲区内存，返回指针
10 
11   tasksEvents = (uint16 *)osal_mem_alloc( sizeof( uint16 ) * tasksCnt);
12 
13   //设置所分配的内存空间单元值为0
14 
15   osal_memset( tasksEvents, 0, (sizeof( uint16 ) * tasksCnt));
16 
17  
18 
19   // 任务优先级由高到低依次排列，高优先级对应taskID小
20 
21   macTaskInit( taskID++ );  //0 不用考虑
22 
23   nwk_init( taskID++ );     //1 |
24 
25   Hal_Init( taskID++ );     //2 |
26 
27 #if defined( MT_TASK )
28 
29   MT_TaskInit( taskID++ );
30 
31 #endif
32 
33   APS_Init( taskID++ );     //3 |
34 
35 #if defined ( ZIGBEE_FRAGMENTATION )
36 
37   APSF_Init( taskID++ );
38 
39 #endif
40 
41   ZDApp_Init( taskID++ );   //4 需要考虑
42 
43 #if defined ( ZIGBEE_FREQ_AGILITY ) || defined ( ZIGBEE_PANID_CONFLICT )
44 
45   ZDNwkMgr_Init( taskID++ );
46 
47 #endif
48 
49   SampleApp_Init( taskID ); //5 需要考虑*************************重点
50 
51                             //通常在这里初始化自己的东西
52 
53 }

 1 void osal_start_system( void )
 2 
 3 {
 4 
 5 #if !defined ( ZBIT ) && !defined ( UBIT )
 6 
 7   for(;;)  // Forever Loop
 8 
 9 #endif
10 
11   {
12 
13     osal_run_system();
14 
15   }
16 
17 }

 1 void osal_run_system( void )
 2 
 3 {
 4 
 5   uint8 idx = 0;
 6 
 7  
 8 
 9   osalTimeUpdate();        //扫描哪个事件被触发了，置相应标志位
10 
11   Hal_ProcessPoll();
12 
13  
14 
15   //从0（最高优先级）开始检索是否有任务需要处理
16 
17   //有则立即跳出循环，没有等到检索完再跳出循环
18 
19   do {
20 
21     if (tasksEvents[idx])  // Task is highest priority that is ready.
22 
23     {
24 
25       break;
26 
27     }
28 
29   } while (++idx < tasksCnt);
30 
31  
32 
33   //分析索引号，对任务进行处理，没有任务就跳过
34 
35   if (idx < tasksCnt)
36 
37   {
38 
39     uint16 events;
40 
41     halIntState_t intState;
42 
43  
44 
45     HAL_ENTER_CRITICAL_SECTION(intState);    //进入临界区，保护
46 
47     events = tasksEvents[idx];               //提取任务
48 
49     tasksEvents[idx] = 0;  // Clear the Events for this task.清除任务
50 
51     HAL_EXIT_CRITICAL_SECTION(intState);     //退出临界区
52 
53  
54 
55     activeTaskID = idx;
56 
57     events = (tasksArr[idx])( idx, events ); //通过指针调用任务处理函数********重点
58 
59     activeTaskID = TASK_NO_TASK;
60 
61  
62 
63     HAL_ENTER_CRITICAL_SECTION(intState);    //进入临界区
64 
65     tasksEvents[idx] |= events;  // Add back unprocessed events to the current task.
66 
67                                              //保存未处理事件
68 
69     HAL_EXIT_CRITICAL_SECTION(intState);     //退出临界区
70 
71   }
72 
73 #if defined( POWER_SAVING )
74 
75   else  // Complete pass through all task events with no activity?
76 
77   {
78 
79     osal_pwrmgr_powerconserve();  // Put the processor/system into sleep
80 
81   }
82 
83 #endif
84 
85  
86 
87   /* Yield in case cooperative scheduling is being used. */
88 
89 #if defined (configUSE_PREEMPTION) && (configUSE_PREEMPTION == 0)
90 
91   {
92 
93     osal_task_yield();
94 
95   }
96 
97 #endif
98 
99 }

 1 const pTaskEventHandlerFn tasksArr[] = {
 2 
 3   macEventLoop,
 4 
 5   nwk_event_loop,
 6 
 7   Hal_ProcessEvent,
 8 
 9 #if defined( MT_TASK )
10 
11   MT_ProcessEvent,
12 
13 #endif
14 
15   APS_event_loop,
16 
17 #if defined ( ZIGBEE_FRAGMENTATION )
18 
19   APSF_ProcessEvent,
20 
21 #endif
22 
23   ZDApp_event_loop,
24 
25 #if defined ( ZIGBEE_FREQ_AGILITY ) || defined ( ZIGBEE_PANID_CONFLICT )
26 
27   ZDNwkMgr_event_loop,
28 
29 #endif
30 
31   SampleApp_ProcessEvent
32 
33 };

 1 typedef struct
 2 
 3 {
 4 
 5   osal_event_hdr_t hdr;     /* OSAL Message header */
 6 
 7   uint16 groupId;           /* Message‘s group ID - 0 if not set */
 8 
 9   uint16 clusterId;         /* Message‘s cluster ID */
10 
11   afAddrType_t srcAddr;     /* Source Address, if endpoint is STUBAPS_INTER_PAN_EP,
12 
13                                it‘s an InterPAN message */
14 
15   uint16 macDestAddr;       /* MAC header destination short address */
16 
17   uint8 endPoint;           /* destination endpoint */
18 
19   uint8 wasBroadcast;       /* TRUE if network destination was a broadcast address */
20 
21   uint8 LinkQuality;        /* The link quality of the received data frame */
22 
23   uint8 correlation;        /* The raw correlation value of the received data frame */
24 
25   int8  rssi;               /* The received RF power in units dBm */
26 
27   uint8 SecurityUse;        /* deprecated */
28 
29   uint32 timestamp;         /* receipt timestamp from MAC */
30 
31   uint8 nwkSeqNum;          /* network header frame sequence number */
32 
33   afMSGCommandFormat_t cmd; /* Application Data */
34 
35 } afIncomingMSGPacket_t;

typedef struct

{

  uint8   TransSeqNumber;

  uint16  DataLength;              // Number of bytes in TransData

  uint8  *Data;

} afMSGCommandFormat_t;