machine.UART

uart模块主要用于驱动开发板上的异步串口，可以自由对uart进行配置。k210一共有3个uart，每个uart可以进行自由的引脚映射。

1. 构造

1.1. 引脚映射

在使用uart前，我们需要使用fm来对芯片引脚进行映射和管理。如下所示，将PIN10设置为uart2的发送引脚，PIN11设置为uart2的接收引脚

fm.register(board_info.PIN10,fm.fpioa.UART2_TX)
fm.register(board_info.PIN11,fm.fpioa.UART2_RX)

1.2. 构造函数

uart = machine.UART(uart,baudrate,bits,parity,stop,timeout, read_buf_len)

通过指定的参数新建一个 UART 对象

参数

uart UART号，使用指定的UART，可以通过 machine.UART. 按tab键来补全
baudrate: UART 波特率
bits: UART 数据宽度，支持 5/6/7/8 (默认的 REPL 使用的串口（UARTHS）只支持 8 位模式)，默认 8
parity: 奇偶校验位，支持 None, machine.UART.PARITY_ODD, machine.UART.PARITY_EVEN （默认的 REPL 使用的串口（UARTHS）只支持 None），默认 None
stop: 停止位，支持 1， 1.5, 2，默认 1
timeout: 串口接收超时时间
read_buf_len：串口接收缓冲，串口通过中断来接收数据，如果缓冲满了，将自动停止数据接收

返回值

UART对象

2. 方法

2.1. init

用于初始化uart，一般在构造对象时已经初始化，这里用在重新初始化uart

uart.init(baudrate,bits,parity,stop,timeout, read_buf_len)

参数

同构造函数，但不需要第一个UART号

返回值

无

2.2. read

用于读取串口缓冲中的数据

uart.read(num)

参数

num: 读取字节的数量，一般填入缓冲大小，如果缓冲中数据的数量没有 num 大，那么将只返回缓冲中剩余的数据

返回值

bytes类型的数据

2.3. readline

用于读取串口缓冲数据的一航

uart.readline(num)

num: 读取行的数量

返回值

*bytes类型的数据

2.4. write

用于使用串口发送数据

uart.write(buf)

参数

buf: 需要发送到数据

返回值

写入的数据量

2.5. deinit

注销 UART 硬件，释放占用的资源

UART.deinit()

参数

无

返回值

无

2.6. repl_uart()

获取用于 REPL 的串口对象

返回值

用于 REPL 的串口对象，默认初始化位 115200 8 N 1

3. 例程

3.1. 例程 1

在运行里程之前，请确认 PIN15 已经连接到 PIN10， PIN17 已经连接到 PIN9

运行程序后，可以在终端看到 baudrate:115200 bits:8 parity:0 stop:0 ---check Successfully 的打印信息

from fpioa_manager import fm
from machine import UART
fm.register(board_info.PIN15,fm.fpioa.UART1_TX)
fm.register(board_info.PIN17,fm.fpioa.UART1_RX)
fm.register(board_info.PIN9,fm.fpioa.UART2_TX)
fm.register(board_info.PIN10,fm.fpioa.UART2_RX)
uart_A = UART(UART.UART1, 115200, 8, None, 1, timeout=1000, read_buf_len=4096)
uart_B = UART(UART.UART2, 115200, 8, None, 1, timeout=1000, read_buf_len=4096)
write_str = 'hello world'
for i in range(20):
    uart_A.write(write_str)
    read_data = uart_B.read()
    read_str = read_data.decode('utf-8')
    print("string = ",read_str)
    if read_str == write_str:
        print("baudrate:115200 bits:8 parity:None stop:1 ---check Successfully")
uart_A.deinit()
uart_B.deinit()
del uart_A
del uart_B

3.2. 例程 2

AT模块串口

fm.register(board_info.WIFI_RX,fm.fpioa.UART2_TX)
fm.register(board_info.WIFI_TX,fm.fpioa.UART2_RX)
uart = machine.UART(machine.UART.UART2,115200,timeout=1000, read_buf_len=4096)

3.3. 例程 3

修改 REPL 串口波特率

from machine import UART
repl = UART.repl_uart()
repl.init(1500000, 8, None, 1, read_buf_len=2048)

3.4. 例程 3

修改 REPL 串口

from machine import UART

fm.register(board_info.PIN15,fm.fpioa.UART1_TX)
fm.register(board_info.PIN17,fm.fpioa.UART1_RX)
uart = machine.UART(UART.UART1, 115200)
UART.set_repl_uart(uart)

UART