ZigBee 2007学习分享之从这里入门<一>

之前有了解过ZigBee的由于TI的ZigBee （CC2530等）采用的是8051+无线芯片的模式，导致本人一直没有太大的兴趣，主要是对51已经无大爱了。但最近有项目需要使用到ZigBee ，没办法又得重新开始
个人认为对ZigBee 的学习其实就是对TI提供的Zstack协议栈进行学习，而Zstack采用的优势OSAL的模式，所以需要对其系统进行一定的学习。虽然，本人也一直在努力写一个这样类似的架构tpOS II，但对Zstack的学习还是不容易。

Zstack的工程代码被划分为多个网络层，但实际上我们要更改的其实还是在应用程，而其他地方基本上不需要修改。

ZStack对用户开发的两个接口函数：一个是初始化，一个是触发事件。这两个任务的接口都在OSAL_SampleApp.c文件中。

1. 在tasksArr数组中添加触发事件处理函数XXX_ProcessEvent，用户需要在这个函数中实现事件的处理，例如：按键时间、网络时间、还有一些用户自定义的事件等。而调用这个函数使用的是回调的方式实现的。

1. const pTaskEventHandlerFn tasksArr[] = {
   
2. macEventLoop,
   
3. nwk_event_loop,
   
4. Hal_ProcessEvent,
   
5. #if defined( MT_TASK )
   
6. MT_ProcessEvent,
   
7. #endif
   
8. APS_event_loop,
   
9. #if defined ( ZIGBEE_FRAGMENTATION )
   
10. APSF_ProcessEvent,
    
11. #endif
    
12. ZDApp_event_loop,
    
13. #if defined ( ZIGBEE_FREQ_AGILITY ) || defined ( ZIGBEE_PANID_CONFLICT )
    
14. ZDNwkMgr_event_loop,
    
15. #endif
    
16. xxxApp_ProcessEvent
    
17. };

复制代码

2. 初始化函数放在初始化任务函数中的，还是在初始化任务后，并分配任务ID给相应的任务。

1. void osalInitTasks( void )
   
2. {
   
3. uint8 taskID = 0;
   
4. 
   
5. tasksEvents = (uint16 *)osal_mem_alloc( sizeof( uint16 ) * tasksCnt);
   
6. osal_memset( tasksEvents, 0, (sizeof( uint16 ) * tasksCnt));
   
7. 
   
8. macTaskInit( taskID++ );
   
9. nwk_init( taskID++ );
   
10. Hal_Init( taskID++ );
    
11. #if defined( MT_TASK )
    
12. MT_TaskInit( taskID++ );
    
13. #endif
    
14. APS_Init( taskID++ );
    
15. #if defined ( ZIGBEE_FRAGMENTATION )
    
16. APSF_Init( taskID++ );
    
17. #endif
    
18. ZDApp_Init( taskID++ );
    
19. #if defined ( ZIGBEE_FREQ_AGILITY ) || defined ( ZIGBEE_PANID_CONFLICT )
    
20. ZDNwkMgr_Init( taskID++ );
    
21. #endif
    
22. xxxApp_Init( taskID );
    
23. }

复制代码

完成了接口函数的添加，下面就是对接口函数的实现了，对于这两个函数的实现来说，也不是用户可以随便写的，必须按照一定的格式进行。

1.初始化函数

分配任务ID->清除网络状态->清除消息ID->周期性消息的设置[时间触发类事件通过这个设置后发出]->闪烁消息设置[按键触发类事件通过此设置发出]->APS层端点描述->端点注册->按键注册->组设置->其他设置。

1. void XXXApp_Init( uint8 task_id )
   
2. {
   
3. XXXApp_TaskID = task_id;
   
4. XXXApp_NwkState = DEV_INIT;
   
5. XXXApp_TransID = 0;
   
6. 
   
7. // 初始化用户使用到的硬件资源
   
8. 
   
9. // Device hardware initialization can be added here or in main() (Zmain.c).
   
10. // If the hardware is application specific - add it here.
    
11. // If the hardware is other parts of the device add it in main().
    
12. 
    
13. #if defined ( BUILD_ALL_DEVICES )
    
14. // The "Demo" target is setup to have BUILD_ALL_DEVICES and HOLD_AUTO_START
    
15. // We are looking at a jumper (defined in SampleAppHw.c) to be jumpered
    
16. // together - if they are - we will start up a coordinator. Otherwise,
    
17. // the device will start as a router.
    
18. if ( readCoordinatorJumper() )
    
19. zgDeviceLogicalType = ZG_DEVICETYPE_COORDINATOR;
    
20. else
    
21. zgDeviceLogicalType = ZG_DEVICETYPE_ROUTER;
    
22. #endif // BUILD_ALL_DEVICES
    
23. 
    
24. #if defined ( HOLD_AUTO_START )
    
25. // HOLD_AUTO_START is a compile option that will surpress ZDApp
    
26. // from starting the device and wait for the application to
    
27. // start the device.
    
28. ZDOInitDevice(0);
    
29. #endif
    
30. 
    
31. // Setup for the periodic message's destination address
    
32. // Broadcast to everyone
    
33. XXXApp_Periodic_DstAddr.addrMode = (afAddrMode_t)AddrBroadcast;
    
34. XXXApp_Periodic_DstAddr.endPoint = SAMPLEAPP_ENDPOINT;
    
35. XXXApp_Periodic_DstAddr.addr.shortAddr = 0xFFFF;
    
36. 
    
37. // Setup for the flash command's destination address - Group 1
    
38. XXXApp_Flash_DstAddr.addrMode = (afAddrMode_t)afAddrGroup;
    
39. XXXApp_Flash_DstAddr.endPoint = SAMPLEAPP_ENDPOINT;
    
40. XXXApp_Flash_DstAddr.addr.shortAddr = SAMPLEAPP_FLASH_GROUP;
    
41. 
    
42. // Fill out the endpoint description.
    
43. XXXApp_epDesc.endPoint = SAMPLEAPP_ENDPOINT;
    
44. XXXApp_epDesc.task_id = &SampleApp_TaskID;
    
45. XXXApp_epDesc.simpleDesc
    
46. = (SimpleDescriptionFormat_t *)&XXXApp_SimpleDesc;
    
47. XXXApp_epDesc.latencyReq = noLatencyReqs;
    
48. 
    
49. // Register the endpoint description with the AF
    
50. afRegister( &XXXApp_epDesc );
    
51. 
    
52. // Register for all key events - This app will handle all key events
    
53. RegisterForKeys( XXXApp_TaskID );
    
54. 
    
55. // By default, all devices start out in Group 1
    
56. XXXApp_Group.ID = 0x0001;
    
57. osal_memcpy( XXXApp_Group.name, "Group 1", 7 );
    
58. aps_AddGroup( XXX_ENDPOINT, &XXXApp_Group );
    
59. 
    
60. #if defined ( LCD_SUPPORTED )
    
61. HalLcdWriteString( "SampleApp", HAL_LCD_LINE_1 );
    
62. #endif
    
63. }

复制代码

2. 事件处理

事件的处理需要注意，这里的处理事件有两种：一种是系统时间（switch里边处理的就是），一种是用户事件(switch后面处理的事件)。

AF_INCOMING_MSG_CMD事件中，用于对网络消息的处理，例如发送消息就是在这个事件中进行的。
ZDO_STATE_CHANGE事件中，用于对网络变化的处理，例如启动周期性的事件，就是在这里进行的。
最后用户可以添加自己的事件，这些事件可以是各种各样的，例如周期性的事件就需要网络变化事件的启动，后面用户周期的处理共同实现的。

1. uint16 XXXApp_ProcessEvent( uint8 task_id, uint16 events )
   
2. {
   
3. afIncomingMSGPacket_t *MSGpkt;
   
4. (void)task_id; // Intentionally unreferenced parameter
   
5. 
   
6. if ( events & SYS_EVENT_MSG )
   
7. {
   
8. MSGpkt = (afIncomingMSGPacket_t *)osal_msg_receive( XXXApp_TaskID );
   
9. while ( MSGpkt )
   
10. {
    
11. switch ( MSGpkt->hdr.event )
    
12. {
    
13. // Received when a key is pressed
    
14. case KEY_CHANGE:
    
15. XXXApp_HandleKeys( ((keyChange_t *)MSGpkt)->state, ((keyChange_t *)MSGpkt)->keys );
    
16. break;
    
17. 
    
18. // Received when a messages is received (OTA) for this endpoint
    
19. case AF_INCOMING_MSG_CMD:
    
20. XXXApp_MessageMSGCB( MSGpkt );
    
21. break;
    
22. 
    
23. // Received whenever the device changes state in the network
    
24. case ZDO_STATE_CHANGE:
    
25. XXXApp_NwkState = (devStates_t)(MSGpkt->hdr.status);
    
26. if ( //(XXXApp_NwkState == DEV_ZB_COORD) ||
    
27. (XXXApp_NwkState == DEV_ROUTER)
    
28. || (XXXApp_NwkState == DEV_END_DEVICE) )
    
29. {
    
30. // Start sending the periodic message in a regular interval.
    
31. osal_start_timerEx( XXXApp_TaskID,
    
32. XXXAPP_SEND_PERIODIC_MSG_EVT,
    
33. XXXAPP_SEND_PERIODIC_MSG_TIMEOUT );
    
34. }
    
35. else
    
36. {
    
37. // Device is no longer in the network
    
38. }
    
39. break;
    
40. 
    
41. default:
    
42. break;
    
43. }
    
44. 
    
45. // Release the memory
    
46. osal_msg_deallocate( (uint8 *)MSGpkt );
    
47. 
    
48. // Next - if one is available
    
49. MSGpkt = (afIncomingMSGPacket_t *)osal_msg_receive( XXXApp_TaskID );
    
50. }
    
51. 
    
52. // return unprocessed events
    
53. return (events ^ SYS_EVENT_MSG);
    
54. }
    
55. 
    
56. // Send a message out - This event is generated by a timer
    
57. // (setup in XXXApp_Init()).
    
58. if ( events & XXXAPP_SEND_PERIODIC_MSG_EVT )
    
59. {
    
60. // Send the periodic message
    
61. XXXApp_SendPeriodicMessage();
    
62. 
    
63. // Setup to send message again in normal period (+ a little jitter)
    
64. osal_start_timerEx( XXXApp_TaskID, XXXAPP_SEND_PERIODIC_MSG_EVT,
    
65. (XXXAPP_SEND_PERIODIC_MSG_TIMEOUT + (osal_rand() & 0x00FF)) );
    
66. 
    
67. // return unprocessed events
    
68. return (events ^ XXXAPP_SEND_PERIODIC_MSG_EVT);
    
69. }
    
70. 
    
71. // Discard unknown events
    
72. return 0;
    
73. }

复制代码

通过前面的几贴，原则上已经完成了是zigbee入门编程了。下面我们简单总结一下：
设备在初始化的时候，可以设置设备类型：协调器（一个网络只能有一个），路由器（可以有多个，用于端点数据的转发功能），终端节点（用于数据的采集）。一般来说，一个网络都会有这3种设备，所以，我们需要三个工程编写三个代码。但是为了管理，TI在新建工程的时候，把这三个工程新建在一起，通过在Workspace下面进行选择。

在编辑什么设备时，我们需要选择到相应的工程，对于这种管理方式我们为TI点个赞吧。同时问一下，你会现在这样的工程吗?说实话，我之前不会，看来这个工程后会了，又学了一招，不错吧。

那么如何实现了，其实很简单：

点击菜单Project->Eidt Configurations...，在弹出的对话框中添加，删除，确定等即可。

在新建的工程中，会包含之前的工作中的所有内容，但不同的工程可能有不同的文件，所以，可以按照下面的步骤包含不同的文件。

在需要删除或者添加的文件上右键选择Optiongs...，在弹出的对话框中，勾选Exclude from buid选项将在工程中删除，此时，在工程中看见的是文件前面有个叉，如果没有勾选，则文件在工程中是有效的。

TI的工作就是通过这样的方式实现了三种设备的宏定义。

包含的文件不一样：Router 包含f8wRouter.cfg,EndDevice包含f8wEndev.cfg,Coordinator包含f8wCoord.cfg

在完成以上三个工程后，我们需要对不同的工程进行不同的宏定义，而不是通过代码进行修改，因为如果通过代码进行宏编译的修改，会影响到其他工程，因为这三个工程使用了很多相同的文件。为此我们只能通过设置进行宏编译设置。


这种设置在IAR和KEIL里边都有，很都人都不习惯，但为了方便工程的管理，一定要习惯这种设置。还记得刚几年前准备学习zigbee的时候，就是应为TI提供的工程是IAR编写的，而之前只习惯用keil所以，一直不习惯，就没有学习。通过这几年的使用，居然不喜欢用keil了，还是IAR用起来方面，要不你也试试。

宏编译设置，其实很简单，点击要设置的工程，点击右键，选择设置，在后面的红框中写入相应的宏即可。

期待好文

楼主的技术帖一直很有内容，看起来很感觉，支持楼主，加油！！

技术大牛顶

不错不错，这几个点都说透了。

不错不错

哈哈，楼主说的这几点我也知道。但是，我不会总结。写出这么棒的东西！

感谢夸奖。

真不错，板凳学习一下

对于入门还是不错的

学习学习尝试写下，也许几篇过后就的心用手了，我们小编写文章也是这个，开始觉得写个文章，难呀，但是几篇过后，觉得越来越如鱼得水了

谢谢分享

好文

谢谢大牛的乐于奉献和帮助