Application Object)存在的地方,它是为实现一个设备描述而定义的一组群集
端点0 :用于整个ZigBee设备的配置和管理
端点255:用于向所有的端点进行广播
端点241~254:保留端点
其他端点:映射应用对象,并使得应用程序可以跟ZigBee堆栈其他层进行通信。
电灯的控制:开灯、关灯等),这个规范即成为簇(cluster)
这个项目的主要内容,在协议中一般是以操作系统的任务实现的
HAL:硬件层目录,包含有与硬件相关的配置和驱动及操作函数
MAC:MAC层目录,包含了MAC层的参数配置文件及其MAC的LIB库的函数接口文件
MT:实现通过串口可控制各层,并与各层进行直接交互
NWK:网络层目录,包含网络层配置参数文件网络层库的函数接口文件及APS层库的函数接口
OSAL:协议栈的操作系统
Profile:AF(Application framework应用框架)层目录
Security:安全层目录,包含安全层处理函数,比如加密函数等
Services:地址处理函数目录,包括地址模式的定义及地址处理函数
Tools: 工程配置目录,包括空间划分及Z-Stack相关配置信息
ZDO:ZDO目录
ZMac:MAC层目录,包括MAC层参数配置及MAC层LIB库函数回调处理函数
ZMain:主函数目录,包括入口函数及硬件配置文件
Output:输出文件目录,由IAR IDE自动生成
根据上图,执行完自定义事件
SampleApp_ProcessEvent()函数(注:这里的自定义事件是自己根据需求定义的,不明白的话先不用理会)后
并不代表主函数结束,程序将会一
直待在osal_start_system()进行
任务轮询
Zigbee组网流程:
协调器的组网,终端设备和路由设备发现网络以及加入网络
1. Z-Stack 由 main()函数开始执行
2. osal_init_system()函数,执行操作系统初始化
3. 进入osalInitTasks()函数,执行操作系统任务初始化
4. ZDApp层,初始化 ,执行ZDApp_init函数后,如果是协调器将建立网络
,如果是终端设备将加入网络。
5. 执行ZDOInitDevice()函数,执行设备初始化
6. 执行ZDApp_NetworkInit函数,完成网络初始化
7. ZDApp_event_loop()函数
8. 执行ZDO_StartDevice()函数,启动设备
协调器和路由器组建网络
if ( ZG_BUILD_COORDINATOR_TYPE && logicalType ==
NODETYPE_COORDINATOR ) //当设备作为协调器时,执行这个
条件语句。
执行NLME_NetworkFormationRequest()向网络层发送网络形成
请求,当网络层建立网络后,将给予 ZDO层反馈信息;
接着去执行ZDApp层的 ZDO_NetworkFormationConfirmCB()
函数
if ( ZG_BUILD_JOINING_TYPE && (logicalType ==
NODETYPE_ROUTER || logicalType == NODETYPE_DEVICE) )
//当为终端设备或路由时,执行这个条件语句,发出加入网络请求,
// 继而转到ZDO_NetworkDiscoveryConfirmCB()函数
向操作系统分配任务事件片函数
uint8 osal_start_timerEx( uint8 taskID, uint16 event_id,
uint16 timeout_value )
这个定时器只是为发送周期信息开启的,设备启动初始化后从
这里开始触发第一个周期信息的发送,然后周而复始下去
Zigbee数据通信
Zigbee发送数据时调用函数AF_DataRequest()
若Zigbee接收到数据,则进入自定义事件
SampleApp_ProcessEvent()后,会触发能接收及处理数
据包的函数SampleApp_MessageMSGCB()
afStatus_t AF_DataRequest(
afAddrType_t *dstAddr,//发送目的地址+端点地址和传送模式
endPointDesc_t *srcEP,//源终端的描述(如:操作系统任务ID)
uint16 cID, //用于接收器识别的标号(簇ID)
uint16 len, //发送数据长度
uint8 *buf, //发送数据缓冲区(即发送的数据)
uint8 *transID, //任务ID号
uint8 options, //有效位掩码的发送选项
uint8 radius //最大传送跳数
);
typedef struct {
osal_event_hdr_t hdr; /* OSAL Message header */
uint16 groupId; /*组号(若未设置则为0)*/
uint16 clusterId; /*用于识别的标号(簇ID),应该与数据发送函数中的簇ID一致*/
afAddrType_t srcAddr;
uint16 macDestAddr; /* MAC header destination short address */
uint8 endPoint; /*端点号*/
uint8 wasBroadcast; /*判断是否为广播地址,若是返回TRUE*/
uint8 LinkQuality; /* The link quality of the received data frame */
uint8 correlation; /* The raw correlation value of the received data frame */
int8 rssi; /* 接收到的射频功率单位dBm */
uint8 SecurityUse; /* deprecated */
uint32 timestamp; /* receipt timestamp from MAC */
afMSGCommandFormat_t cmd; /* 接收到的数据 */
} afIncomingMSGPacket_t;
在SampleApp.c添加头文件
#include "MT_UART.h"
#include "MT_APP.h"
#include "MT.h"
在SampleApp_Init()函数开始部分编写如下代码:
/***********串口初始化************/
MT_UartInit();//初始化
MT_UartRegisterTaskID(task_id);//登记任务号
HalUARTWrite(0,"Hello World\n",12);
进入MT_UartInit()函数,修改MT_UART_DEFAULT_BAUDRATE为
HAL_UART_BR_115200
MT_UART_DEFAULT_OVERFLOW 为FALSE
工程名->右键->Options->C/C++ Compiler->Preprocessor->Defined
symbols:
修改为ZTOOL_P1 xMT_TASK xMT_SYS_FUNC xMT_ZDO_FUNC
xLCD_SUPPORTED=DEBUG
接通串口调试助手,进行串口测试
主要有三种:广播、点播、组播
广播就是网络中任意一节点设备发出广播数据,网络中其它的任
意节点都能收到
点播(也叫点对点)就是网络中任意一节点对另一个已知网络地
址(即短地址)的节点进行数据发送的过程
组播(也叫组网)就是网络中所有节点设备被分组后,网络中任
意组的任意一节点都可以对某一已知组号(包扩自身所属的组号)
的组进行数据发送的过程
注:以下代码都需要进行粘贴(在SampleApp.c中)
文件开头定义 afAddrType_t Point_To_Point_DstAddr;
SampleApp_Init中添加参数配置
Point_To_Point_DstAddr.addrMode = (afAddrMode_t)Addr16Bit; //点播
Point_To_Point_DstAddr.endPoint = SAMPLEAPP_ENDPOINT;
Point_To_Point_DstAddr.addr.shortAddr = 0x0000; //发给协调器
文件后面添加:
void SampleApp_SendPointToPointMessage( void )
{
uint8 data[10]={0,1,2,3,4,5,6,7,8,9};
if ( AF_DataRequest( &Point_To_Point_DstAddr, &SampleApp_epDesc,
SAMPLEAPP_Point_To_Point_CLUSTERID,
10,
data,
&SampleApp_TransID,
AF_DISCV_ROUTE,
AF_DEFAULT_RADIUS ) == afStatus_SUCCESS )
{
}
else
{
// Error occurred in request to send.
}
}
在SampleApp.h中,添加 #define SAMPLEAPP_Point_To_Point_CLUSTERID 5
SampleApp_ClusterList列表里面添加SAMPLEAPP_Point_To_Point_CLUSTERID,如:
const cId_t SampleApp_ClusterList[SAMPLEAPP_MAX_CLUSTERS] =
{
SAMPLEAPP_PERIODIC_CLUSTERID,
SAMPLEAPP_FLASH_CLUSTERID,
SAMPLEAPP_Point_To_Point_CLUSTERID
};
修改SAMPLEAPP_MAX_CLUSTERS 值为 3
(该部分修改内容可选)
在if ( events & SAMPLEAPP_SEND_PERIODIC_MSG_EVT )中,替换
SampleApp_SendPeriodicMessage()为
SampleApp_SendPointToPointMessage(),后面添加“LED1 闪烁提示”代码
HalLedBlink( HAL_LED_1, 2,50, 500 );
修改SampleApp_MessageMSGCB中簇ID为
SAMPLEAPP_Point_To_Point_CLUSTERID,并添加如下代码:
HalUARTWrite(0,"I get data\n",11); //提示接收到数据
for(i=0;i<10;i++)
HalUARTWrite(0,&asc_16[pkt->cmd.Data[i]],1);//ASCII码发给PC机
HalUARTWrite(0,"\n",1); // 回车换行
定义变量:
uint8 asc_16[16]={'0','1','2','3','4','5','6','7','8','9','A','B','C','D','E','F'},i;
修改参数
屏蔽掉(SampleApp_NwkState == DEV_ZB_COORD),如:
if ( /*(SampleApp_NwkState == DEV_ZB_COORD)|| */(SampleApp_NwkState ==
DEV_ROUTER) || (SampleApp_NwkState == DEV_END_DEVICE) )
找到SampleApp_MessageMSGCB( MSGpkt );
后面添加“LED1 闪烁提示”代码 HalLedBlink( HAL_LED_1, 2,50, 500 );
在文件开头声明void SampleApp_SendPointToPointMessage(void);
分别以协调器、终端或路由器的方式下载到2-3个设备中,连接串口
注:HalLedBlink( HAL_LED_1, 2,50, 500 ); //LED1 闪烁提示 进行指示
单播通信时,收发双方的端点号必须相同。到这里单播通信方式就实现了。
首先打开hal_board_cfg.h文件,确定有以下语句:
/* Set to TRUE enable DMA usage, FALSE disable it */
#ifndef HAL_DMA
#define HAL_DMA TRUE
#endif
这段语句定义了编译器编译有关DMA的函数
Zigbee协议栈已经把使用串口的条件准备好了,从应用角度讲,利用协议栈现有平台即ZStack自带的MT包来实现自己的串口应用,只需对协议栈做一些修改就可以实现URAT发送与接收的功能。
关键函数的解析
MT_UartInit () ①
这是为UART串口传输数据而初始化的MT函数包,在其中定义了串口的波特率,最大接收发送数据量,传输模式等相关配置。在这里的各项参数不需要改变,保持系统默认即可。
MT_UartProcessZToolData() ②
这是MT程序包中URAT接收数据的代码,在这里面需要修改的地方是,在数据接收完毕后需要添加一个回车,便于我们区分不同传输数据,具体的代码为UartRxBuf.RxBuf[count]='\n';此段代码需要添加在count++;后,这里注意一下count,一会还会用到。
hal_board_cfg.h ③
首先说明一下,串口接收发送数据的方式有两种:一种是中断模式,另一种是DMA模式,这里是使用中断模式。而在hal_board_cfg.h中,DMA模式的优先级要高于中断模式的,这里最简单的解决方案就是将DMA的那段预编译注释掉,即仅留一种模式——中断。
void Sampleapp_Init ④
这是应用层函数初始化,即对我们自己的具体应用进行初始化,在这里面需要添加两段代码 MT_UartInit() 和 MT_UartRegisterTaskID(SampleApp_TaskID);这两端代码要添加在Sampl Init()中。
MT_UartInit()
MT_UartRegisterTaskID(SampleApp_TaskID); ⑤
Sampleapp_ProcessEvent ⑥
case SPI_INCOMING_ZTOOL_PORT UartRxComCallBack()
代码功能及执行流程
至此,串口发送接受数据的已经全部修改完毕,可以将程序下载到板子上,利用PC机上的程序调试助手向2530发送数据,在程序调试助手和板子上的液晶屏上分别显示。我们在回顾一下代码的执行顺序
首先进行各种初始化,这里就不再详解
程序进去osal_start_system,开始进行轮询有没有要处理的事件
这时如果从串口发送一个数据,发生中断,(这里我们利用的中断模式)
在OSAL框架中,Hal_ProcessPoll()函数是在一个死循环中,所以每过一定的时间就会执行到。在Z-Stack OSAL中这个时种节奏定义是1ms,Hal_ProcessPoll()的作用是检测中断标志位,由于串口已经接收到数据,所以进入中断处理,具体处理过程如下HalUARTPoll(); ( HalUARTPollISR(); ( static uint16 HalUARTRxAvailISR(void)
(然后就进入了MT_UartProcessZToolData;(详解如下) (数据接收完毕后又进入轮询,由于sampleapp中已经不为空了,所以就会执行sampleapp中的操作,在Sampleapp中的
case SPI_INCOMING_ZTOOL_PORT:
UartRxComCallBack();
break;
这段代码将被执行,UartRxComCallBack();中的代码如上述红字表示,完成我们设定的相应功能。
实验数据
利用程序调试助手测试一下程序的收发速率(波特率为115200)
附:涉及的代码:
① void MT_UartInit ()
{
halUARTCfg_t uartConfig;
/* Initialize APP ID */
App_TaskID = 0;
/* UART Configuration */
uartConfig.configured = TRUE;
uartConfig.baudRate = MT_UART_DEFAULT_BAUDRATE;
uartConfig.flowControl = FALSE;
uartConfig.flowControlThreshold = MT_UART_DEFAULT_THRESHOLD;
uartConfig.rx.maxBufSize = MT_UART_DEFAULT_MAX_RX_BUFF;
uartConfig.tx.maxBufSize = MT_UART_DEFAULT_MAX_TX_BUFF;
uartConfig.idleTimeout = MT_UART_DEFAULT_IDLE_TIMEOUT;
uartConfig.intEnable = TRUE;
#if defined (ZTOOL_P1) || defined (ZTOOL_P2)
uartConfig.callBackFunc = MT_UartProcessZToolData;
#elif defined (ZAPP_P1) || defined (ZAPP_P2)
uartConfig.callBackFunc = MT_UartProcessZAppData;
#else
uartConfig.callBackFunc = NULL;
#endif
/* Start UART */
#if defined (MT_UART_DEFAULT_PORT)
HalUARTOpen (MT_UART_DEFAULT_PORT, uartConfig);
#else
/* Silence IAR compiler warning */
(void)uartConfig;
#endif
/* Initialize for ZApp */
#if defined (ZAPP_P1) || defined (ZAPP_P2)
/* Default max bytes that ZAPP can take */
MT_UartMaxZAppBufLen = 1;
MT_UartZAppRxStatus = MT_UART_ZAPP_RX_READY;
#endif
}
②
void MT_UartProcessZToolData ( uint8 port, uint8 event )
{
osal_event_hdr_t *msg_ptr;
uint8 ch;
count = 35;
(void)event; // Intentionally unreferenced parameter
while (Hal_UART_RxBufLen(port))
{
HalUARTRead (port, ch, 1);
if((ch == ' ') (count 31))//帧头
{
UartRxBuf.RxBuf[0] = ch;
count = 1;
}
else if((ch == '*') || (count == 31))//帧尾
{
UartRxBuf.RxBuf[count] = ch;
count++;
UartRxBuf.RxBuf[count]='/n';
msg_ptr = (osal_event_hdr_t *)osal_msg_allocate( 50 );
msg_ptr- event = SPI_INCOMING_ZTOOL_PORT;// 这里会在以后的case中用到,作为一个事件的标致
msg_ptr- status = (byte)state;
osal_msg_send( App_TaskID, (uint8 *)msg_ptr );
这几句是关键,在接收数据完毕后,为时间消息分配缓存,设置事件标志,保存状态,最后一句最重要,将包含该消息的指针发送到App_TaskID任务ID中,使得在下一次轮询时能够检测到此状态的变化,执行相应的后续操作。
}
else if(count 31)//否则接收数据
{
UartRxBuf.RxBuf[count] = ch;
count++;
}
else
{
count++;
}
}
}
③
//#if HAL_UART
// Always prefer to use DMA over ISR.
/* #if HAL_DMA
#ifndef HAL_UART_DMA
#if (defined ZAPP_P1) || (defined ZTOOL_P1)
#define HAL_UART_DMA 1
#elif (defined ZAPP_P2) || (defined ZTOOL_P2)
#define HAL_UART_DMA 2
#else
#define HAL_UART_DMA 1
#endif
#endif
#define HAL_UART_ISR 0
#else */
// #ifndef HAL_UART_ISR 被注释掉的部分蓝色显示
#if (defined ZAPP_P1) || (defined ZTOOL_P1)
#define HAL_UART_ISR 1
#elif (defined ZAPP_P2) || (defined ZTOOL_P2)
#define HAL_UART_ISR 2
#else
#define HAL_UART_ISR 1
#endif
// #endif
#define HAL_UART_DMA 0
// #endif
// Used to set P2 priority - USART0 over USART1 if both are defined.
#if ((HAL_UART_DMA == 1) || (HAL_UART_ISR == 1))
#define HAL_UART_PRIPO 0x00
#else
#define HAL_UART_PRIPO 0x40
#endif
#else
#define HAL_UART_DMA 0
//#define HAL_UART_ISR 0
#endif
④ void Sampleapp_Init( uint8 task_id )
{
……
……
MT_UartInit(); //added by kennan
MT_UartRegisterTaskID(widget_TaskID) ; //自己添加
}
⑤ void MT_UartRegisterTaskID( byte taskID )
{
App_TaskID = taskID;
}
⑥ uint16 Sampleapp_ProcessEvent( uint8 task_id, uint16 events )
{
……
……
while ( MSGpkt )
{
switch ( MSGpkt- hdr.event )
{
……
case SPI_INCOMING_ZTOOL_PORT:
UartRxComCallBack();
……
}
}
}
⑦ UartRxComCallBack();
{
static uint8 y=0;
P1DIR |= 0x03; // P10、P11定义为输出
RLED = 0;// 这里是红灯和黄灯,如果此处编译有错误的话,在头文件里填
YLED = 0; // 加两个宏定义既可 。
ClearScreen();// 这 是清屏程序,作用是将液晶屏上的所有内容全部删除。
HalUARTWrite(HAL_UART_PORT_0,UartRxBuf.RxBuf,count+1); // 串口显示
Print(y%8, 0,UartRxBuf.RxBuf, 1);// 液晶屏幕显示
y+=2; 液晶可以换行显示
memset(UartRxBuf.RxBuf,NULL,count+1);// 清空UartRxBuf.RxBuf
} 注:在Sampleapp.c文件中还需要在前面添加一个extern uint16 count;外部变量,以便此段程序能够调用。(前面也提到过)