【配套源码、文档、软件、硬件等资源,入口见文末】
这一节,基于《ZigBee CC2530 Z-Stack 06 创建基于Z-Stack的全新工程》一节中创建的全新工程ProjectApp进行进一步实验,实现调用Z-Stack中现成的串口驱动函数实现串口发送功能,具体效果为系统一上电CC2530芯片即通过串口0打印出“hello world !\r\n”。
CC2530芯片的所有片上外设中,总共有2个串口,分别称为串口0和串口1。在实际项目开发当中,一般我们会将串口0用作“调试串口”,用于打印一些提示信息;而将串口1用于与外围硬件设备对接,实现实际的项目需求。本节中我们将通过串口0实现字符串打印功能。
ProjectApp创建成功后,仅是通过编译测试了工程创建是否成功,实际上并没有做任何实质性的更改。因此我们实际现在才算是真正基于Z-Stack进行开发!为了使用Z-Stack中自带的串口驱动程序,实现串口发送功能,具体操作步骤如下:
1、协议栈中MT层相关的代码全都是基于CC2530的串口写的,所以我们在写串口程序时,最好的办法就是参考MT层对应代码来写我们自己的串口程序;具体是参考MT_UART.c中的MT_UartInit( )函数代码和MT_UART.h中相关的宏定义,来实现我们的uart0.c和uart0.h两个文件,两个文件具体代码如下:
文件uart0.c中代码:
#include "uart0.h"
#include "hal_uart.h"
void Uart0_Init(uint8 baudRate)
{
halUARTCfg_t uartConfig;
uartConfig.configured = TRUE;
uartConfig.baudRate = baudRate;
uartConfig.flowControl = FALSE;
uartConfig.flowControlThreshold = UART0_THRESHOLD;
uartConfig.rx.maxBufSize = UART0_RX_BUFF_MAX;
uartConfig.tx.maxBufSize = UART0_TX_BUFF_MAX;
uartConfig.idleTimeout = UART0_IDLE_TIMEOUT;
uartConfig.intEnable = TRUE;
uartConfig.callBackFunc = NULL;
HalUARTOpen (HAL_UART_PORT_0, &uartConfig);
}
文件uart0.h中代码:
#ifndef UART0_H
#define UART0_H
#ifdef __cplusplus
extern "C"
{
#endif
#include "hal_types.h"
#define UART0_RX_BUFF_MAX 60
#define UART0_TX_BUFF_MAX 60
#define UART0_THRESHOLD (UART0_RX_BUFF_MAX / 2)
#define UART0_IDLE_TIMEOUT 6
void Uart0_Init(uint8 baudRate);
#ifdef __cplusplus
}
#endif
#endif /* UART0_H */
其中:
uartConfig.callBackFunc = NULL;
关于这句代码,由于本节暂不实现串口接收处理数据的功能,所以此处的串口回调函数为NULL(空)!
关于具体为何uart0.c和uart0.h两个文件的格式如此,是嵌入式C语言模块化编程的基础,参考协议栈中类似的文件依葫芦画瓢即可,此处就不再赘述~
2、往工程中APP分组下添加我们参考MT_UART.c和MT_UART.h写成的uart0.c和uart0.h两个文件:将uart0.c和uart0.h两个文件放到C:\Texas Instruments\ZStack-CC2530-2.5.1a\Projects\zstack\Samples\ProjectApp\Source目录下,然后按照下图所示将两个文件添加到APP分组下即可;
3、由于协议栈中MT的相关代码全都是基于串口写的,而我们又是参考MT_UART相关代码写的,所以需要将协议栈中原本与MT层相关的代码全部注释掉。具体操作如下图所示:
右击工程名,进入“Options”选项后,找到如下图中所示的“Defined symbols”,其中总共有5个预编译选项,依次为:ZTOOL_P1、MT_TASK、MT_SYS_FUNC、MT_ZDO_FUNC、LCD_SUPPORTED=DEBUG;
前4个均与MT层相关,所以均需注释掉,在需要注释的预编译选项前面加上“x”即可;
第5个预编译选项是与LCD液晶有关的,由于我们一般不使用TI原装的LCD,所以一般也会将这个注释掉,则工程中相关的代码都不会被编译!
4、此外,协议栈中还有一个名为hal_board_cfg.h的文件,里面定义了与协议栈相关的大多数硬件的使能宏定义,这边我们暂时只关心HAL_LCD和HAL_UART,我们想屏蔽LCD相关的所有代码,并使能与UART相关的底层驱动程序,文件所处位置及需修改位置如下图所示,需要将HAL_LCD和HAL_UART的宏定义分别修改为FALSE和TRUE;
5、至此,基于Z-Stack协议栈的串口驱动程序的发送部分就基本全部完成,就差最后来检验一下串口是否能够正常发送了!
双击打开ProjectApp.c文件,在ProjectApp_Init( )函数中最后的位置加入如下两行代码:
Uart0_Init(HAL_UART_BR_115200);
HalUARTWrite(HAL_UART_PORT_0,"hello world !\r\n",sizeof("hello world !\r\n")-1);
我们既然在ProjectApp.c文件中调用了uart0.c文件中的函数,则一定要在ProjectApp.c中加入对应的头文件——uart0.h!
具体实现代码如下:
#include "uart0.h"
最后点击“编译”图标,完成对整个工程的编译,顺利的话,肯定是 0 error(s), 0 warning(s)!
点击IAR界面上方“Download and Deubug”图标,将程序下载到CC2530芯片中(下载之前,请保证下载器、串口线和电脑三者已经连接正确!),如下图所示:
并自动进入调试界面,如下图所示:
连上串口调试助手,选择正确的串口配置后打开串口,点击上图中所示“全速运行”图标后,就可以看到串口调试助手收到了来自CC2530串口0打印的数据,正好15个字节!如下图所示:
【配套源码、文档、软件、硬件等资源,入口见文末】