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

zhaojun_xf

ZigBee 2007学习分享之从这里入门<一> [复制链接]

 

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

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

zhaojun_xf

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. }

复制代码

zhaojun_xf

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

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. }

复制代码

zhaojun_xf

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

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

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

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

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

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

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

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

zhaojun_xf

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

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


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

迈尔风随

期待好文

zmsxhy

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

粉尘墨事

技术大牛顶

damiaa

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

jiyuanda

不错不错

L无奈

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

zhaojun_xf

感谢夸奖。

ljj3166

真不错，板凳学习一下

wateras1

对于入门还是不错的

soso

L无奈 发表于 2015-3-24 10:40
哈哈，楼主说的这几点我也知道。但是，我不会总结。写出这么棒的东西！

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

liang007

谢谢分享

han_yelin

好文

895855647

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