ZigBee2006协议栈使用指南.pdf-资料库

通往无线的桥梁无线世界的先锋目录 1.认识协议栈....................................................................................................................................2 2.建立自己的项目............................................................................................................................3 2.1 功能分析.............................................................................................................................3 2.2 添加一个任务....................................................................................................................3 2.2.1 任务初始化函数.....................................................................................................4 2.2.2 任务处理函数..........................................................................................................5 2.2.3 按键子函数.............................................................................................................7 2.2.4 接收处理函数.........................................................................................................7 2.2.5 发送函数.................................................................................................................8 2.2 完成任务的添加..............................................................................................................10 2.3 其他定义...........................................................................................................................10 3.小结 .............................................................................................................................................11 成都无线龙通讯科技有限公司 2008 年 8 月地址：成都市武成大街 2 号莱茵春天大厦 902 室网址：http://www.c51rf.com www.rfmcu.cn 电话：028-86786586 传真：028-86617556 Email: info@c511rf.com 成都无线龙通讯科技有限公司

通往无线的桥梁无线世界的先锋说明：本说明书介绍的是基于成都无线龙通讯科技有限公司的 ZigBee 无线网络开发系统 C51RF-3 系列(C51RF-3-PK/CS/JKS/LPK/WSN)所配置的 ZigBee2006 协议栈。 1.认识协议栈打开协议栈，在工程文件的左边 Workspace 中可以看到整个协议栈的构架，如图所示， APP：应用层目录，这是用户创建各种不同工程的区域，在这个目录中包含了应用层的内容和这个项目的主要内容，在协议栈里面一般是以操作系统的任务实现的。 HAL：硬件层目录，包含有与硬件相关的配置和驱动及操作函数。 MAC：MAC 层目录，包含了 MAC 层的参数配置文件及其 MAC 的 LIB 库的函数接口文件。 MT：实现通过串口可控各层，于各层进行直接交互。 NWK：网络层目录，含网络层配置参数文件及网络层库的函数接口文件，APS 层库的函数接口 OSAL：协议栈的操作系统。 Profile：AF 层目录，包含 AF 层处理函数文件。 Security：安全层目录，安全层处理函数，比如加密函数等。地址：成都市武成大街 2 号莱茵春天大厦 902 室网址：http://www.c51rf.com www.rfmcu.cn 电话：028-86786586 传真：028-86617556 Email: info@c511rf.com 成都无线龙通讯科技有限公司

通往无线的桥梁无线世界的先锋 Services：地址处理函数目录，包括着地址模式的定义及地址处理函数。 Tools：工程配置目录，包括空间划分及 ZStack 相关配置信息。 ZDO：ZDO 目录。 ZMac： MAC 层目录，包括 MAC 层参数配置及 MAC 层 LIB 库函数回调处理函数。 ZMain：主函数目录，包括入口函数及硬件配置文件。 Output：输出文件目录，这个 EW8051 IDE 自动生成的。从上面的描述中可以看出，整个协议栈中，对于 ZigBee 的功能已经全部体现，在次基础上建立一个项目的方法主要是改动应用层，下面，我们以一个简单的例子，协调器用按键控制发送一组数据，通过这组数据控制路由器设备的小灯闪烁，来讲解整个协议栈的使用。我们将这个项目的名字设置为 WXL_example 2.建立自己的项目 2.1 功能分析项目的功能一共有按键检测、发送数据、接收数据、小灯控制四种，在协议栈中已经将 CC2430 的底层驱动全部固化在协议栈中，我们直接调用就可以了。 2.2 添加一个任务整个协议栈是以一个 OS 贯穿的，我们要加入自己的应用，就要添加一个任务，（具体关于操作系统的介绍，请参考 OSAL API_F8W-2003-0002_.pdf 文档），在任务中执行，与协议栈实现无缝连接。在协议栈中的 OSAL.c 文件中，byte osal_init_system( void )函数的功能是初始化 OS、添加任务到 OS 任务表中。在这个函数中通过调用 osalAddTasks()函数来定制项目所需要应用的任务，该函数属于应用层和 OS 之间的接口函数，一般项目的建立需要根据系统的需要自己编写改函数，并将函数放到应用层。osalAddTasks()函数是通过 osalTaskAdd()函数完成任务添加。首先，将支持协议栈功能需要的任务加载到该函数中， void osalAddTasks( void ) { osalTaskAdd (Hal_Init, Hal_ProcessEvent, OSAL_TASK_PRIORITY_LOW); #if defined( ZMAC_F8W ) osalTaskAdd( macTaskInit, macEventLoop, OSAL_TASK_PRIORITY_HIGH ); #endif #if defined( MT_TASK ) osalTaskAdd( MT_TaskInit, MT_ProcessEvent, OSAL_TASK_PRIORITY_LOW ); #endif osalTaskAdd( nwk_init, nwk_event_loop, OSAL_TASK_PRIORITY_MED ); 地址：成都市武成大街 2 号莱茵春天大厦 902 室网址：http://www.c51rf.com www.rfmcu.cn 电话：028-86786586 传真：028-86617556 Email: info@c511rf.com 成都无线龙通讯科技有限公司

通往无线的桥梁无线世界的先锋 APS_event_loop, osalTaskAdd( APS_Init, OSAL_TASK_PRIORITY_LOW ); osalTaskAdd( ZDApp_Init, ZDApp_event_loop, OSAL_TASK_PRIORITY_LOW ); } 这些任务是协议栈运行的先决条件，为了更好的使用协议栈，建议将这些任务都添加到任务列表中。这些函数的参数条件在协议栈中已经定义好，可以直接使用。从上面加载的函数中可以发现，要建立一个单独的任务，必须先将 osalTaskAdd()函数所需要的参数条件定义好，这些参数分别是初始化函数 WXL_example_Init，任务处理函数 WXL_example_event_loop 和任务优先级。 2.2.1 任务初始化函数任务初始化函数的功能是将该任务需要完成的功能的功能部件初始化，在每一个任务的初始化函数中，必须完成的功能是要得到设置任务的任务 ID。 void WXL_ SampleApp _Init ( uint8 task_id ) { } 由于在这个任务中还有其他的功能，所以，我们对其他功能也需要做一定的初始化， WXL_ SampleApp _Init = task_id; 包括对发送数据的设置，按键的设置等。实现的函数为： void WXL_SampleApp_Init ( uint8 task_id ) { WXL_SampleApp_TaskID = task_id; //任务 ID /**********************************************************/ /* 通讯需要的参数 */ /**********************************************************/ WXL_SampleApp_NwkState = DEV_INIT; //网络类型 WXL_SampleApp_TransID = 0; // 设置发送数据的方式和目的地址 // 广播到所有的设备 WXL_SampleApp_All_DstAddr.addrMode = (afAddrMode_t)AddrBroadcast; WXL_SampleApp_All_DstAddr.endPoint = WXL_SAMPLEAPP_ENDPOINT; WXL_SampleApp_All_DstAddr.addr.shortAddr = 0xFFFF; // 单播到一个设备 WXL_SampleApp_Single_DstAddr.addrMode = (afAddrMode_t)afAddrGroup; WXL_SampleApp_Single_DstAddr.endPoint = WXL_SAMPLEAPP_ENDPOINT; // 设置 endpoint description. WXL_SampleApp_epDesc.endPoint = WXL_SAMPLEAPP_ENDPOINT; WXL_SampleApp_epDesc.task_id = &WXL_SampleApp_TaskID; 地址：成都市武成大街 2 号莱茵春天大厦 902 室网址：http://www.c51rf.com www.rfmcu.cn 电话：028-86786586 传真：028-86617556 Email: info@c511rf.com 成都无线龙通讯科技有限公司

通往无线的桥梁无线世界的先锋 WXL_SampleApp_epDesc.simpleDesc = (SimpleDescriptionFormat_t *)&WXL_SampleApp_SimpleDesc; WXL_SampleApp_epDesc.latencyReq = noLatencyReqs; // 登记 endpoint description 到 AF afRegister( &WXL_SampleApp_epDesc ); // 登记所有的按键事件 RegisterForKeys( WXL_SampleApp_TaskID ); } 2.2.2 任务处理函数任务处理函数是对任务发生后的事件进行处理，在这个项目中主要完成的功能是通过协调器上的按键发送一个数据，控制路由器的小灯。所以里面就应该设计到按键的事件处理，网络状态的判断（判断设备的类型，是协调器还是路由器或者是终端设备）和接收到信息后的处理。处理函数为： /********************************************************************* * @函数名 WXL_SampleApp_ProcessEvent * * 函数功能: 一般应用任务事件处理，这个函数是处理所有的事件到任务，事件包括 * 时间片、消息和所有其他使用者定义过的时间。 * * @参数： task_id - OS 分配的任务 ID. 这个 ID 将用于发送数据和设置时间片. * events - 处理的事件 * * @return none */ uint16 WXL_SampleApp_ProcessEvent( uint8 task_id, uint16 events ) { afIncomingMSGPacket_t *MSGpkt; if ( events & SYS_EVENT_MSG ) //系统信息， { MSGpkt = (afIncomingMSGPacket_t *)osal_msg_receive( WXL_SampleApp_TaskID ); //OS 发送过来的信息 while ( MSGpkt ) { switch ( MSGpkt->hdr.event ) { // 按键事件 case KEY_CHANGE: 地址：成都市武成大街 2 号莱茵春天大厦 902 室网址：http://www.c51rf.com www.rfmcu.cn 电话：028-86786586 传真：028-86617556 Email: info@c511rf.com 成都无线龙通讯科技有限公司

通往无线的桥梁无线世界的先锋 //按键处理函数 WXL_SampleApp_HandleKeys( ((keyChange_t *)MSGpkt)->keys ); break; // 接收数据事件 case AF_INCOMING_MSG_CMD: //接收数据的处理函数 WXL_SampleApp_MessageMSGCB( MSGpkt ); break; // 网络状态发生变化时间 case ZDO_STATE_CHANGE: WXL_SampleApp_NwkState = (devStates_t)(MSGpkt->hdr.status); //获取网络状态 if ( (WXL_SampleApp_NwkState == DEV_ZB_COORD) //判断网络类型 || (WXL_SampleApp_NwkState == DEV_ROUTER) || (WXL_SampleApp_NwkState == DEV_END_DEVICE) ) { } else { // 设备不属于这个网络 } break; default: break; } // 释放存储器 osal_msg_deallocate( (uint8 *)MSGpkt ); // Next - 如果有一个空闲的任务 MSGpkt = (afIncomingMSGPacket_t *)osal_msg_receive( WXL_SampleApp_TaskID ); } // 返回未处理的任务 return (events ^ SYS_EVENT_MSG); } return 0; } 地址：成都市武成大街 2 号莱茵春天大厦 902 室网址：http://www.c51rf.com www.rfmcu.cn 电话：028-86786586 传真：028-86617556 Email: info@c511rf.com 成都无线龙通讯科技有限公司

通往无线的桥梁无线世界的先锋 2.2.3 按键子函数按键子函数的功能是处理所有的按键事件，在这里需要特别申明的是，本程序只实用与无线龙通讯科技有限公司的硬件。按键的底层驱动函数在 Hal_key.c 中，我们在这里按键需要完成的任务是，当协调器按键 1 被按下后，以广播的方式发送数据去让路由器小灯闪烁。 /********************************************************************* * @函数名 WXL_SampleApp_HandleKeys * * @函数功能：处理所有的按键事件 * * @参数： keys - 返回的按键值 * * * @return none */ void WXL_SampleApp_HandleKeys(uint8 keys ) { if ( keys & HAL_KEY_SW_1 ) { if(WXL_SampleApp_NwkState == DEV_ZB_COORD) //如果是协调器 WXL_SampleApp_SendFlashMessage( WXL_SAMPLEAPP_FLASH_DURATION ); //发送数据 else { } } } 2.2.4 接收处理函数接收处理函数的功能有两部分，一是路由器的接收函数，二是协调器的接收处理函数。在这个项目里面，我们将这两种设备的处理函数都固化在了一个函数里面，用串 ID 来判断他们的设备类型。当路由器接收到数据后，先判断该信息的串 ID，然后判断命令，如果命令正确，则小灯闪烁，然后单播发送确认信号给协调器，协调器收到信号后，同样先判断串 ID，然后确认命令后小灯闪烁示意。 /********************************************************************* * @函数名： SampleApp_MessageMSGCB * * @函数功能：接收的数据处理量.根据不同的串 ID 实现不同的功能。 * * @param none * 地址：成都市武成大街 2 号莱茵春天大厦 902 室网址：http://www.c51rf.com www.rfmcu.cn 电话：028-86786586 传真：028-86617556 Email: info@c511rf.com 成都无线龙通讯科技有限公司

通往无线的桥梁无线世界的先锋 * @return none */ void WXL_SampleApp_MessageMSGCB( afIncomingMSGPacket_t *pkt ) { unsigned char Rx_Buf[4]; switch ( pkt->clusterId ) { case WXL_SAMPLEAPP_CLUSTERID1: memcpy(Rx_Buf,pkt->cmd.Data,3); if((Rx_Buf[0] == 'Y') && (Rx_Buf[1] == 'E') && (Rx_Buf[2] == 'S')) { HalLedBlink( HAL_LED_4, 4, 50, 250); //小灯闪烁四次 } break; case WXL_SAMPLEAPP_CLUSTERID2: memcpy(Rx_Buf,pkt->cmd.Data,4); if((Rx_Buf[0] == 'O') && (Rx_Buf[1] == 'P') && (Rx_Buf[2] == 'E') && (Rx_Buf[3] == 'N')) { HalLedBlink( HAL_LED_4, 4, 50, 250); //小灯闪烁四次 SendData("YES",pkt->srcAddr.addr.shortAddr,3); //以单播的方式回复信号 } break; } } 2.2.5 发送函数 /********************************************************************* * @函数名： SampleApp_SendFlashMessage * * @函数功能：广播发送一串数据。 * * @param none * * @return none */ void WXL_SampleApp_SendFlashMessage( uint8 *buffer ) { if ( AF_DataRequest( &WXL_SampleApp_All_DstAddr, &WXL_SampleApp_epDesc, WXL_SAMPLEAPP_CLUSTERID2, 地址：成都市武成大街 2 号莱茵春天大厦 902 室网址：http://www.c51rf.com www.rfmcu.cn 电话：028-86786586 传真：028-86617556 Email: info@c511rf.com 成都无线龙通讯科技有限公司

资料库

ZigBee2006协议栈使用指南.pdf

相关推荐

最新资料