2.1. UART - 数据自收发

本 demo 基于 UART 外设轮询发送、接收 FIFO 中断模式编写。

2.1.1. 硬件连接

本 demo 基于 BL706_IOT 开发板，连接方式如下：

GPIO function

GPIO pin

UART0_TX

GPIO14

UART0_RX

GPIO15

2.1.2. 软件实现

  • 软件代码见 examples/uart/uart_echo

1
2
#define BSP_UART_CLOCK_SOURCE  ROOT_CLOCK_SOURCE_PLL_96M
#define BSP_UART_CLOCK_DIV  0

  • 配置 UART 设备时钟源，见 bsp/board/bl706_iot/clock_config.h

1
2
#define CONFIG_GPIO14_FUNC GPIO_FUN_UART0_TX
#define CONFIG_GPIO15_FUNC GPIO_FUN_UART0_RX

  • 配置 UART 设备复用引脚，见 bsp/board/bl706_iot/pinmux_config.h

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
#define BSP_USING_UART0

#if defined(BSP_USING_UART0)
#ifndef UART0_CONFIG
#define UART0_CONFIG \
{   \
.id = 0, \
.baudrate = 2000000,\
.databits = UART_DATA_LEN_8, \
.stopbits = UART_STOP_ONE, \
.parity = UART_PAR_NONE, \
.fifo_threshold = 1, \
}
#endif
#endif

  • 使能 BSP_USING_UART0 并配置 UART 设备配置，见 bsp/board/bl706_iot/peripheral_config.h

1
bflb_platform_init();

  • 在 bflb_platform_init 函数中，我们已经注册并且打开了一个调试用的串口设备，给用户实现一个 MSG 的基本功能用作打印输出报文。具体实现如下

1
2
3
4
5
6
7
8
9
    uart_register(board_get_debug_uart_index(), "debug_log");
    struct device *uart = device_find("debug_log");

    if (uart)
    {
        device_open(uart, DEVICE_OFLAG_STREAM_TX | DEVICE_OFLAG_INT_RX);
        device_set_callback(uart, NULL);
        device_control(uart, DEVICE_CTRL_CLR_INT, (void *)(UART_RX_FIFO_IT));
    }

  • 首先调用 uart_register 函数注册 UART 设备,当前注册 UART0

  • 然后通过 find 函数找到设备对应的句柄，保存于 uart 句柄中

  • 最后使用 device_open 以轮询发送和中断接收来打开 uart 设备，默认关闭中断并且不注册接收中断回调函数

1
2
3
4
5
if (uart)
{
    device_set_callback(uart, uart_irq_callback);
    device_control(uart, DEVICE_CTRL_SET_INT, (void *)(UART_RX_FIFO_IT|UART_RTO_IT));
}

  • 通过 device_set_callback 函数，注册用户指定的``UART0`` 接收中断服务函数。通过 device_control 函数打开 RX_FIFO 和 RTO 中断

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
void uart_irq_callback(struct device *dev, void *args, uint32_t size, uint32_t state)
{
    if (state == UART_EVENT_RX_FIFO)
    {
        device_write(dev,0,(uint8_t *)args,size);
    }
    else if (state == UART_EVENT_RTO)
    {
        device_write(dev,0,(uint8_t *)args,size);
    }
}

  • 此函数是示例的中断服务函数，作用是将接受到的数据原封不动的发送出去。

    • state 会返回 UART 设备的中断类型

    • args 包含了返回数据指针

    • size 包含返回数据的长度

    • dev 为中断的 uart 设备句柄

  • 当中断产生，将会调用 device_write 函数将接受到的数据发送回去。

2.1.3. 编译和烧录

1
2
 $ cd <sdk_path>/bl_mcu_sdk
 $ make BOARD=bl706_iot APP=uart_echo

2.1.4. 实验现象

见视频展示：