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: 停止位, 支持 11.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 已经连接到 PIN10PIN17 已经连接到 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)
powered by GitbookFile Modify: 2020-11-26 20:02:14

results matching ""

    No results matching ""