一、硬件连接
| 串口 | 引脚 |
|---|---|
| TXD | DIO_2 |
| RXD | DIO_3 |
二、移植文件
链接：https://pan.baidu.com/s/1fE8XWgvdzYiF1bdUzTDxUg 提取码：r5s2
将 uart.c 和 uart.h 两个文件拖拽至CCS工程的Application文件夹下
添加文件过程中，选项选择如下
2.1 uart.c
/*********************************************************************
* INCLUDES
*/
#include <xdc/runtime/Assert.h>
#include <xdc/runtime/Types.h>
#include <xdc/runtime/Log.h>
#include <ti/sysbios/BIOS.h>
#include <ti/drivers/power/PowerCC26XX.h>
#include <ti/drivers/uart/UARTCC26XX.h>
#include "board.h"
#include "util.h"
#include "board_uart.h"
/******************************************************************************
* DEFINITIONS
*/
#define UART_RX IOID_2 // 接收引脚
#define UART_TX IOID_3 // 发送引脚
/*********************************************************************
* LOCAL VARIABLES
*/
// 串口号
typedef enum{
UART0 = 0,
UARTCOUNT
} UARTName;
// 流控制所需的配置
static const UARTCC26XX_HWAttrsV2 s_UART_CC26XXHWAttrs[UARTCOUNT] = {
{
.baseAddr = UART0_BASE,
.powerMngrId = PowerCC26XX_PERIPH_UART0,
.intNum = INT_UART0_COMB,
.intPriority = ~0,
.swiPriority = 0,
.txPin = UART_TX,
.rxPin = UART_RX,
.ctsPin = PIN_UNASSIGNED,
.rtsPin = PIN_UNASSIGNED
}
};
// 串口目标
static UARTCC26XX_Object s_UART_CC26XXObject[UARTCOUNT];
static const UART_Config s_UART_Config[UARTCOUNT] = {
{
.fxnTablePtr = &UARTCC26XX_fxnTable,
.object = &s_UART_CC26XXObject[UART0],
.hwAttrs = &s_UART_CC26XXHWAttrs[UART0]
},
};
// 串口句柄
static UART_Handle s_UART_Handle;
// 串口参数
static UART_Params s_UART_Params;
/*********************************************************************
* GLOBAL VARIABLES
*/
uint8_t g_UART_RxBuf[UART_MAX_NUM_RX_BYTES] = {0};
uint8_t g_UART_TxBuf[UART_MAX_NUM_TX_BYTES] = {0};
uint32_t g_UART_WantedRxBytes;
uint8_t g_UART_Size;
// 串口定时器
Clock_Struct g_UART_Clock;
/*********************************************************************
* PUBLIC FUNCTIONS
*/
/**
@brief 串口驱动初始化
@param none
@return none
*/
void UART_Init(UART_Callback UART_ReadCallback)
{
// 初始化为默认值
UART_Params_init(&s_UART_Params);
// 参数设置
s_UART_Params.baudRate = 115200;
s_UART_Params.writeDataMode = UART_DATA_BINARY;
s_UART_Params.readMode = UART_MODE_CALLBACK;
s_UART_Params.readDataMode = UART_DATA_BINARY;
s_UART_Params.readCallback = UART_ReadCallback;
// 打开串口
s_UART_Handle = s_UART_Config[0].fxnTablePtr->openFxn((UART_Handle)&s_UART_Config[0], &s_UART_Params);
// 启动串口局部返回功能，为了能在串口接收到数据时及时进回调函数。如果没有这条语句，将会在缓冲区满时才进入。
s_UART_Config[0].fxnTablePtr->controlFxn(s_UART_Handle, UARTCC26XX_CMD_RETURN_PARTIAL_ENABLE, NULL);
// 开始第一次的读取等待
g_UART_WantedRxBytes = UART_MAX_NUM_RX_BYTES;
UART_Receive(g_UART_RxBuf, g_UART_WantedRxBytes);
}
/**
@brief 串口的写数据的函数
@param pUART_TxBuf 写缓冲区
@param UART_Len 数据长度
@return none
*/
void UART_Send(uint8_t* pUART_TxBuf, uint8_t UART_Len)
{
s_UART_Config[0].fxnTablePtr->writeFxn(s_UART_Handle, pUART_TxBuf, UART_Len);
}
/**
@brief 串口的读数据的函数
@param pUART_RxBuf 读缓冲区
@param UART_Len 数据长度
@return none
*/
void UART_Receive(uint8_t* pUART_RxBuf, uint8_t UART_Len)
{
s_UART_Config[0].fxnTablePtr->readFxn(s_UART_Handle, pUART_RxBuf, UART_Len);
}
/**
@brief 串口的读数据回调函数
@param UART_Handle 串口句柄
@param pUART_RxBuf 接收缓冲区
@param UART_Size：接收数据大小
@return none
*/
void UART_ReadCallback(UART_Handle UART_Handle, void *pUART_RxBuf, size_t UART_Size)
{
// 保存数据
g_UART_Size = UART_Size;
memcpy(g_UART_RxBuf, pUART_RxBuf, g_UART_Size);
// 启动定时器
Util_startClock(&g_UART_Clock);
}
/*************************************END OF FILE*************************************/
2.2 uart.h
#ifndef _BOARD_UART_H_
#define _BOARD_UART_H_
/*********************************************************************
* INCLUDES
*/
#include <ti/drivers/UART.h>
#include <ti/sysbios/knl/Clock.h>
/******************************************************************************
* DEFINITIONS
*/
#define UART_MAX_NUM_RX_BYTES 60 // 最大接收字节
#define UART_MAX_NUM_TX_BYTES 60 // 最大发送字节
/*********************************************************************
* EXTERNAL VARIABLES
*/
extern uint8_t g_UART_RxBuf[UART_MAX_NUM_RX_BYTES];
extern uint8_t g_UART_TxBuf[UART_MAX_NUM_TX_BYTES];
extern uint32_t g_UART_WantedRxBytes;
extern uint8_t g_UART_Size;
extern Clock_Struct g_UART_Clock; // 串口定时器
/*********************************************************************
* TYPEDEFS
*/
typedef void (*UART_Callback) (UART_Handle handle, void *pBuf, size_t count);
/*********************************************************************
* API FUNCTIONS
*/
void UART_Init(UART_Callback UART_ReadCallback);
void UART_Send(uint8_t* npUART_TxBuf, uint8_t nUART_Len);
void UART_Receive(uint8_t* npUART_RxBuf, uint8_t nUART_Len);
void UART_ReadCallback(UART_Handle UART_Handle, void *pUART_RxBuf, size_t UART_Size);
#endif /* _BOARD_UART_H_ */
三、API调用
需包含头文件 uart.h
UART_Init
| 功能 | 初始化串口驱动 |
|---|---|
| 函数定义 | void UART_Init(UART_Callback UART_ReadCallback) |
| 参数 | UART回调函数 |
| 返回 | 无 |
UART_Send
| 功能 | 串口的写数据的函数 |
|---|---|
| 函数定义 | void UART_Send(uint8_t* pUART_TxBuf, uint8_t UART_Len) |
| 参数1 | pUART_TxBuf：写缓冲区 |
| 参数2 | UART_Len：数据长度 |
| 返回 | 无 |
UART_Receive
| 功能 | 串口的读数据的函数 |
|---|---|
| 函数定义 | void UART_Receive(uint8_t* pUART_RxBuf, uint8_t UART_Len) |
| 参数1 | pUART_RxBuf：读缓冲区 |
| 参数2 | UART_Len：数据长度 |
| 返回 | 无 |
四、流程
① 串口收到数据
② 从底层发送数据到应用层的回调函数UART_ReadCallback中
③ 在回调函数UART_ReadCallback中保存数据
④ 启动串口处理事件的定时器
⑤ 在uart_performTask函数中做自定义串口数据处理
注：如果直接在串口回调函数中做处理，会导致“收发一段时间后无法发出数据”的现象。
五、使用例子
1）添加头文件（例multi_role.c中）
#include "uart.h"
2）添加初始化代码（multi_role.c的multi_role_init函数末尾中）
初始化时传入应用层的串口回调函数，以便串口接收到数据时能传到应用层中。
// 串口初始化
UART_Init(UART_ReadCallback);
UART_Send("TEST\r\n", 6);
// 串口处理定时器初始化
Util_constructClock(&g_UART_Clock, multi_role_clockHandler, 0, 0, false, UART_EVT);
3）修改串口处理事件的宏
以multi_role工程为例，在multi_role.c的CONSTANTS常量定义中，加入UART_EVT，id号递增。
// Internal Events for RTOS application
#define MR_ICALL_EVT ICALL_MSG_EVENT_ID // Event_Id_31
#define MR_QUEUE_EVT UTIL_QUEUE_EVENT_ID // Event_Id_30
#define MR_STATE_CHANGE_EVT Event_Id_00
#define MR_CHAR_CHANGE_EVT Event_Id_01
#define MR_CONN_EVT_END_EVT Event_Id_02
#define MR_KEY_CHANGE_EVT Event_Id_03
#define MR_PAIRING_STATE_EVT Event_Id_04
#define MR_PASSCODE_NEEDED_EVT Event_Id_05
#define MR_PERIODIC_EVT Event_Id_06
#define UART_EVT Event_Id_07 // 串口事件
在MR_ALL_EVENTS事件集合定义中，加入刚刚的自定义串口事件。
#define MR_ALL_EVENTS (MR_ICALL_EVT | \
MR_QUEUE_EVT | \
MR_STATE_CHANGE_EVT | \
MR_CHAR_CHANGE_EVT | \
MR_CONN_EVT_END_EVT | \
MR_KEY_CHANGE_EVT | \
MR_PAIRING_STATE_EVT | \
MR_PERIODIC_EVT | \
MR_PASSCODE_NEEDED_EVT | \
UART_EVT)
4）添加串口处理事件的处理
在multi_role.c的multi_role_taskFxn函数中尾部加入。
/*----------------- 串口处理事件 ------------------*/
if (events & UART_EVT)
{
// 串口处理函数
uart_performTask();
}
5）添加串口事件处理函数
在multi_role.c尾部添加
/*********************************************************************
* @fn uart_performTask
*
* @brief 串口事件的处理函数，在此函数自定义串口处理功能
*
* @param none
*
* @return none
*/
static void uart_performTask(void)
{
// 发送数据
UART_Send(g_UART_RxBuf, g_UART_Size);
// 开始新一轮的读取等待
UART_Receive(g_UART_RxBuf, g_UART_WantedRxBytes);
}
6）声明串口事件处理函数
在multi_role.c的LOCAL FUNCTIONS局部函数中加入
static void uart_performTask(void);
7）修改配置中的预编译
默认 BOARD_DISPLAY_USE_UART 和 BOARD_DISPLAY_USE_UART_ANSI 两个宏是为1的，本来TI工程的串口使用，现在要把这两个宏修改为0。
• 由 Leung 写于 2019 年 3 月 7 日
