UART
uart 模块让你通过串行接口与连接到 micro:bit 的设备通信。
函数
init(baudrate=9600, bits=8, parity=None, stop=1, *, tx=None, rx=None)
在指定 tx 和 rx 引脚上以给定参数初始化串行通信。注意:正确通信时,双方参数必须一致。
baudrate 定义通信速度。常用波特率包括:
- 9600
- 14400
- 19200
- 28800
- 38400
- 57600
- 115200
bits 定义传输字节大小,本板仅支持 8。parity 参数定义奇偶校验方式,可为 None、bibo.uart.ODD 或 bibo.uart.EVEN。stop 参数指定停止位数,本板必须为 1。
若未指定 tx 和 rx,则使用内部 USB-UART TX/RX 引脚,连接到 micro:bit 上的 USB 串口转换器,从而将 UART 连接到电脑。也可通过向 tx 和 rx 传入所需引脚对象指定其他引脚。
any()
若有数据等待读取返回 True,否则返回 False。
read([nbytes])
读取字节。若指定 nbytes,则最多读取该字节数,否则尽可能多读。
返回值: 字节对象,或超时时为 None。
字节对象包含字节序列。由于 ASCII 字符可放入单字节,此类型常用于表示简单文本,并提供相应操作方法,例如可用 print() 显示文本。
也可将此对象转换为字符串;若存在非 ASCII 字符,可指定编码:
msg_bytes = uart.read()
msg_str = str(msg, 'UTF-8')
readall()
自 1.0 版起已移除。
请改用不带参数的 read(),将尽可能读取所有数据。
readinto(buf[, nbytes])
将字节读入 buf。若指定 nbytes,则最多读取该字节数;否则最多读取 len(buf) 字节。
返回值: 读入并存储到 buf 的字节数,或超时时为 None。
readline()
读取一行,以换行符结束。
返回值: 读取的行,或超时时为 None。返回的字节中包含换行符。
write(buf)
将缓冲区写入总线,可为字节对象或字符串:
uart.write('hello world')
uart.write(b'hello world')
uart.write(bytes([1, 2, 3]))
返回值: 写入的字节数,或超时时为 None。