1. 文档中心
  2. 比卜创造 Micro:bit
  3. API 参考
  4. UART

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。