Zigbee2006使用入门指南

Zigbee2006使用入门指南 收藏

1.认识协议栈

打开协议栈，在工程文件的左边Workspace中可以看到整个协议栈的构架，如图所示，



APP：应用层目录，这是用户创建各种不同工程的区域，在这个目录中包含了应用层的内容和这个项目的主要内容，在协议栈里面一般是以操作系统的任务实现的。
HAL：硬件层目录，包含有与硬件相关的配置和驱动及操作函数。
MAC：MAC层目录，包含了MAC层的参数配置文件及其MAC的LIB库的函数接口文件。
MT：实现通过串口可控各层，于各层进行直接交互。
NWK：网络层目录，含网络层配置参数文件及网络层库的函数接口文件，APS层库的函数接口
OSAL：协议栈的操作系统。
Profile：AF层目录，包含AF层处理函数文件。
Security：安全层目录，安全层处理函数，比如加密函数等。
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 );
osalTaskAdd( APS_Init, APS_event_loop, 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;
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:
//按键处理函数
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.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
*
* @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,
4,
buffer,
&WXL_SampleApp_TransID,
AF_DISCV_ROUTE,
AF_DEFAULT_RADIUS ) == afStatus_SUCCESS )
{
}
else
{
// Error occurred in request to send.
}
}

//**********************************************************************
//**以短地址方式发送数据
//buf ::发送的数据
//addr::目的地址
//Leng::数据长度
//********************************************************************
void WXL_SampleApp_SendData(uint8 *buf, uint16 addr, uint8 Leng)
{
WXL_SampleApp_Single_DstAddr.addr.shortAddr = addr;
if ( AF_DataRequest( &WXL_SampleApp_Single_DstAddr, //发送的地址和模式
&WXL_SampleApp_epDesc, //终端（比如操作系统中任务ID等）
WXL_SAMPLEAPP_CLUSTERID1,//发送串ID
Leng,
buf,
&WXL_SampleApp_TransID,
AF_DISCV_ROUTE,
// AF_ACK_REQUEST,
AF_DEFAULT_RADIUS ) == afStatus_SUCCESS )
{

}
else
{

}
}
发送数据只是掉用一个函数，在这里不多做解释。

2.2 完成任务的添加

这时候回到2.2节中将建立的任务添加在列表中。
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 );
osalTaskAdd( APS_Init, APS_event_loop, OSAL_TASK_PRIORITY_LOW );
osalTaskAdd( ZDApp_Init, ZDApp_event_loop, OSAL_TASK_PRIORITY_LOW );
osalTaskAdd( WXL_SampleApp_Init, WXL_SampleApp_ProcessEvent, OSAL_TASK_PRIORITY_LOW );
}

2.3其他定义

const cId_t WXL_SampleApp_ClusterList[WXL_SAMPLEAPP_MAX_CLUSTERS] =
{
WXL_SAMPLEAPP_CLUSTERID1,
WXL_SAMPLEAPP_CLUSTERID2
};

const SimpleDescriptionFormat_t WXL_SampleApp_SimpleDesc =
{
WXL_SAMPLEAPP_ENDPOINT, // int Endpoint;
WXL_SAMPLEAPP_PROFID, // uint16 AppProfId[2];
WXL_SAMPLEAPP_DEVICEID, // uint16 AppDeviceId[2];
WXL_SAMPLEAPP_DEVICE_VERSION, // int AppDevVer:4;
WXL_SAMPLEAPP_FLAGS, // int AppFlags:4;
WXL_SAMPLEAPP_MAX_CLUSTERS, // uint8 AppNumInClusters;
(cId_t *)WXL_SampleApp_ClusterList, // uint8 *pAppInClusterList;
WXL_SAMPLEAPP_MAX_CLUSTERS, // uint8 AppNumInClusters;
(cId_t *)WXL_SampleApp_ClusterList // uint8 *pAppInClusterList;
};

endPointDesc_t WXL_SampleApp_epDesc;

/******************************** 变量申明*************************************/
uint8 WXL_SampleApp_TaskID; // 内部的任务 ID，它的值在SampleApp_Init（）中获得

devStates_t WXL_SampleApp_NwkState; //网络状态

uint8 WXL_SampleApp_TransID; // 这是唯一的一个消息ID(计数器)

afAddrType_t WXL_SampleApp_All_DstAddr; //广播的方式
afAddrType_t WXL_SampleApp_Single_DstAddr; //短地址单播的方式
/************************************end***************************************/

#define WXL_SAMPLEAPP_ENDPOINT 20

#define WXL_SAMPLEAPP_PROFID 0x0F08
#define WXL_SAMPLEAPP_DEVICEID 0x0001
#define WXL_SAMPLEAPP_DEVICE_VERSION 0
#define WXL_SAMPLEAPP_FLAGS 0

#define WXL_SAMPLEAPP_MAX_CLUSTERS 2
#define WXL_SAMPLEAPP_CLUSTERID1 1
#define WXL_SAMPLEAPP_CLUSTERID2 2

3.小结

通过上面的介绍，可以知道协议栈的一个简单的使用流程，由于整个协议栈已经将数据通讯的代码做好，我们只需要调用里面的函数就可以了，所以就没有具体介绍网络层里面的东西。完成任务添加后，在编译下载，就可以运行协议栈了，下载后，按协调器按键1（对应无线龙扩展板UP键），会发送一个数据给路由器，路由器红灯闪烁，然后路由器也会发送一个数据回来，导致协调器红灯闪烁。

作者：hxl，如有转载请保证文章的完整行，支持原创。相应代码文档下载地址http://group.ednchina.com/1147/17116.aspx