类 UART – 双工串行通信总线¶
UART实现标准UART / USART双工串行通信协议。在物理层面,它由2根线组成:RX和TX。 通信单元是一个字符(不要与字符串混淆),可以是8bit或9bit宽。
构建对象¶
- class machine.UART(id, ...)¶
构造UART对象
id
- 串口号:1、2
UART(id=0)
用于REPL,不能使用!from machine import UART from machine import Pin uart = UART(1, baudrate=115200, rx=Pin.P15, tx=Pin.P16, timeout=10)
方法¶
- UART.init(baudrate=9600, bits=8, parity=None, stop=1, \*, ...)¶
使用给定参数初始化UART总线
baudrate
- 波特率
bits
- 每个字符的位数,7,8或9。
parity
- 奇偶校验:0-偶数,1-奇数
rx
,tx
- UART读、写引脚
stop
- 停止位数量:1、2
timeout
- 超时时间(单位:毫秒) < timeout ≤ 0x7FFF FFFF (十进制:0 < timeout ≤ 2147483647)
txbuf
- 指定TX缓冲区的字符长度
rxbuf
- 指定RX缓冲区的字符长度Attention
所有引脚均可以作为串口的输入RX,除
P2
、P3
、P4
、P10
只能作为输入,其余所有的引脚理论上都可以作为输出TX。
GPIO 1
、GPIO 3
用于掌控板的USB串口,在初始化UART定义tx
,rx
引脚一般不使用,除非你要用到掌控板的USB接口作为串口输出。
- UART.deinit()¶
关闭UART总线。
- UART.any()¶
返回一个整数,计算可以无阻塞地读取的字符数。如果没有可用字符,它将返回0,如果有字符,则返回正数。 即使有多个可读的字符,该方法也可以返回1。
要查询更复杂的可用字符,请使用select.poll:
poll = select.poll() poll.register(uart, select.POLLIN) poll.poll(timeout)
- UART.read([nbytes])¶
读字符。如果
nbytes
指定,则最多读取多个字节,否则读取尽可能多的数据。返回值:包含读入的字节的字节对象。
None
超时时返回。
- UART.readinto(buf[, nbytes])¶
将字节读入
buf
。如果nbytes
指定,则最多读取多个字节。否则,最多读取len(buf)
字节数。返回值:读取和存储到超时
buf
或None
超时的字节数。
- UART.readline()¶
读一行,以换行符结尾。
返回值:读取行或
None
超时。
- UART.write(buf)¶
将字节缓冲区写入总线。
返回值:写入或
None
超时的字节数。
- UART.sendbreak()¶
在总线上发送中断。这使总线驱动的持续时间长于正常传输字符所需的时间。