一、硬件连接

串口	引脚
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 日

• 参考：【CC2640R2F】香瓜CC2640R2F之串口