SampleApp函数.doc

Sample Application工程 一、Sample Application工程概况描述 ?????Sample Application是ZStack协议栈提供的一个非常简单的演示实例，实例中的每个设备都可以发送和接收两种信息：周期信息和闪烁信息。 周期信息---------当设备加入该网络后，所有设备每隔 5S（加上一个随机数，毫秒mS为单位）发送一个周期信息，该信息的数据载荷为发送信息的次数。 闪烁信息---------通过按下按键 SW1发送一个控制LED灯闪烁的广播信息，该广播信息只针对组 1 内的所有设备。所有设备初始化都被加入组 1，所以网络一旦建立完成便可执行LED灯闪烁实验。可以通过按下设备的 SW2 退出组 1，如果设备退出组1则不再接收来自组1的消息，其按键SW1发送的消息也不再控制组1LED灯的闪烁。通过再次按下 SW2 便可让设备再次加入到组1，从而又可以接受来自组1的消息，其SW1也可以控制组1内设备的LED灯闪烁了。 当设备接收到闪烁信息会闪烁LED灯，而当接收到周期信息时协议栈没有提供具体的实验现象，留给了用户自行处理，可以根据实际需要自行更改实验代码。 在该工程中使用了两个按键SW1和SW2。即ZStack协议栈中的HAL_KEY_SW_1和HAL_KEY_SW_2。同时工程中也定义了一个事件用来处理周期信息事件，即SAMPLEAPP_SEND_PERIODIC_MSG_EVT[SampleApp.h]。 二、一般工程说明： 在学习ZStack协议栈的时候我们要把握一个重点就是事件的产生和事件的处理。任务的初始化为事件的产生制造了“温床”，是事件产生的前提，任何工程都需要先初始化。当有事件产生OS就会调用相应的处理函数进行处理。在OS循环那一节我们可以看到在任务初始化的最后一项就是应用层的初始化，而在指向处理函数的指针数组中最后一项是对应的应用层的处理函数。应用层相关事件会由应用层处理函数进行处理。每一层都是相互对应，各司其职。 三、Sample Application工程初始化与事件的处理 3.1、Sample Application工程初始化如下： void SampleApp_Init( uint8 task_id ) { SampleApp_TaskID = task_id;// OS通过数参数的传递为每一层分发任务ID， SampleApp_NwkState = DEV_INIT;//设定设备的网络状态为“初始化” SampleApp_TransID = 0; #if defined ( SOFT_START ) /*SOFT_START 是一个编译选项，如果一个网络中没有协调 器可以让设备以协调器的形式启动*/ // 这里我们根据跳线决定设备是路由器或者是协调器，如果检测到 //跳线则为协调器否则为路由器,在设备启动提及如果定义了SOFT_START //则设备初始化时设备的类型为可选类型。当程序执行到这里就明确了具 //体是什么类型的设备 if ( readCoordinatorJumper() )//如果检测到跳线则设备为协调器 zgDeviceLogicalType = ZG_DEVICETYPE_COORDINATOR; else//如果没有检测到跳线则设备为路由器 zgDeviceLogicalType = ZG_DEVICETYPE_ROUTER; #endif // SOFT_START #if defined ( HOLD_AUTO_START ) //如果编译了 HOLD_AUTO_START则执行以下函数 ZDOInitDevice(0); #endif // 设定周期信息的地址，此地址为广播地址0xFFFF SampleApp_Periodic_DstAddr.addrMode = (afAddrMode_t)AddrBroadcast; SampleApp_Periodic_DstAddr.endPoint = SAMPLEAPP_ENDPOINT; SampleApp_Periodic_DstAddr.addr.shortAddr = 0xFFFF; //设定闪烁信息的地址，此地址为组1的地址 SampleApp_Flash_DstAddr.addrMode = (afAddrMode_t)afAddrGroup; SampleApp_Flash_DstAddr.endPoint = SAMPLEAPP_ENDPOINT; SampleApp_Flash_DstAddr.addr.shortAddr = SAMPLEAPP