UART 异步串口

uart 模块可以让你使用一个串行接口与连接到主板的一个设备进行对话。

函数

microbit.uart.init(baudrate=9600, bits=8, parity=None, stop=1, *, tx=None, rx=None)

使用特定参数在特定 txrx 引脚初始化串行通信。请注意,为了正确的通信,在两个通信设备上的参数必须相同。

警告

初始化外部引脚上的UART将导致USB上的Python控制台变得无法访问,因为它使用相同的硬件。 恢复控制台必须重新初始化UART而不需要传送任何 txrx (或将 None 传送给这些参数)。意即调用 uart.init(115200) 就足以恢复Python控制台。

baudrate 定义了通信速度。 常用波特率(计算机信息传输的速率单位)包括:

  • 9600
  • 14400
  • 19200
  • 28800
  • 38400
  • 57600
  • 115200

bits 定义了正在传输的字节的大小,电路板只支持8位。 parity 参数定义如何进行奇偶校验, 它可以是 Nonemicrobit.uart.ODDmicrobit.uart.EVENstop 参数表示停止位的数值,并且此电路板必须为1。

如果没有指定 txrx ,则使用micro:bit上与USB串行转换器相连的内部USB-UART TX / RX引脚, 即可把UART连接到PC端。 通过将所需的引脚对象传递给 txrx 参数你可以指定任何其他引脚。

注解

连接设备时,确保电线“交叉”,电路板上的TX引脚需要和设备上的RX引脚相连, 电路板上的RX引脚需要和设备上的TX引脚相连。同时还要确保两个设备的接地引脚连接在一起。

uart.any()

如果有任何字符显示,返回 True ,否则返回 False

uart.read([nbytes])

读取字符。如果指定了 nbytes ,则最多可读取n字节。

uart.readall()

尽可能多的读取数据。

Return value: a bytes object or None on timeout.

返回值:字节对象或超时时 None

uart.readinto(buf[, nbytes])

将字节读入 buf 。 如果指定了 nbytes ,那么最多可以读取 n字节。 否则,最多只能读取 len(buf) 字节。

返回值:在超时时读取并存储到 bufNone 中的字节数。

uart.readline()

读取一行,在新的一行字符处结束。

返回值:读取的行或超时时的 None。换行符是包含在返回的字节中。

uart.write(buf)

将字节的缓冲写入总线。

返回值:所写字节数或超时时的 None