pyb — 与板子相关的函数

pyb 模块包含与板子相关的特定函数。

与时间相关函数

pyb.delay(ms)

延迟给定的毫秒数。

pyb.udelay(us)

延迟给定的微秒数。

pyb.millis()

返回自上次重置板子以来的毫秒数。

结果始终为 MicroPython 的小整数（31位有符号数），因此在 2^30毫秒（约12.4天）后，此函数将开始返回负数。

请注意，如果发出 pyb.stop() 命令，则支持此函数的硬件计数器将在“休眠”状态的持续时间内暂停。这会影响 pyb.elapsed_millis() 的结果。

pyb.micros()

返回自上次重置板子以来的微秒数。

结果始终为 MicroPython 的小整数（31 位有符号数），因此在 2^30 微秒（约 17.8 分钟）后，此函数将开始返回负数。

请注意，如果发出 pyb.stop() 命令，则支持此函数的硬件计数器将在“休眠”状态的持续时间内暂停。这会影响 pyb.elapsed_micros() 的结果。

pyb.elapsed_millis(start)

返回自 start 以来经过的毫秒数。

此函数会处理计数器溢出，并始终返回正数。这意味着它可用于测量长达约 12.4 天的时间段。

例子:

start = pyb.millis()
while pyb.elapsed_millis(start) < 1000:
    # Perform some operation

pyb.elapsed_micros(start)

返回自 start 以来经过的微秒数。

此函数会处理计数器溢出，并始终返回正数。这意味着它可用于测量长达约 17.8 分钟的时间段。

例子:

start = pyb.micros()
while pyb.elapsed_micros(start) < 1000:
    # Perform some operation
    pass

与重置相关的函数

pyb.hard_reset()

以类似于按下外部 RESET 按钮的方式重置 OpenMV Cam。

pyb.bootloader()

激活引导加载程序，而无需 BOOT* 引脚。

pyb.fault_debug(value)

启用或禁用硬件故障调试。当底层系统出现致命错误，如无效内存访问时，会发生硬件故障。

如果 value 参数为 False，则如果出现硬件故障，则板子将自动复位。

如果 value 为 True，则当板子发生硬件故障时，它将打印寄存器和堆栈跟踪，然后无限循环 LED。

默认值为禁用，即自动复位。

与中断相关的函数

pyb.disable_irq()

禁用中断请求。返回先前的IRQ状态：对于禁用的/启用的IRQ，分别返回 False/True。此返回值可传递给enable_irq以恢复IRQ到其原始状态。

pyb.enable_irq(state=True)

启用中断请求。如果 state 为 True （默认值），则启用IRQ。如果 state 为 False，则禁用IRQ。这个函数的最常见用法是将 disable_irq 返回的值传递给它，以退出临界区。

与电源相关的函数

pyb.wfi()

等待内部或外部中断。

这会执行一个 wfi 指令，该指令会降低MCU的功耗，直到发生任何中断（无论是内部还是外部），此时执行会继续。请注意，系统滴答中断每毫秒发生一次（1000Hz），因此此函数最多会阻塞1ms。

pyb.stop()

将OpenMV Cam置于“休眠”状态。

这将使功耗降低到低于500微安。要从此睡眠状态唤醒，需要外部中断或一个实时时钟事件。唤醒后，执行会在之前离开的地方继续。

有关配置实时时钟唤醒事件，请参阅 rtc.wakeup()。

pyb.standby()

将 OpenMV Cam 置于“深度睡眠”状态。

这将使功耗降低到低于 50 微安。要从此睡眠状态唤醒，需要一个实时时钟事件。唤醒后，系统会执行硬复位。

有关配置实时时钟唤醒事件，请参阅 rtc.wakeup()。

杂项函数

pyb.have_cdc()

如果USB连接为串行设备，则返回True，否则返回False。

备注

此函数已被弃用。请改用 pyb.USB_VCP().isconnected() instead。

pyb.hid((buttons, x, y, z))

获取一个4元组（或列表）并将其发送到USB主机（PC）以发送HID鼠标移动事件。

备注

此函数已被弃用。请改用 pyb.USB_HID.send()。

pyb.info([dump_alloc_table])

打印关于板子的大量信息。

pyb.main(filename)

将主脚本的文件名设置为在 boot.py 完成后运行。如果未调用此函数，则将执行默认文件 main.py。

仅在 boot.py 中调用此函数才有意义。

pyb.mount(device, mountpoint, *, readonly=False, mkfs=False)

备注

此函数已被弃用。设备的挂载和卸载应通过 vfs.mount() 和 vfs.umount() 来执行。

挂载一个块设备并将其作为文件系统的一部分使其可用。device 必须是一个提供块协议的对象。（以下内容也已弃用。请参见 vfs.AbstractBlockDev 了解正确的块设备创建方式。）

• readblocks(self, blocknum, buf)

• writeblocks(self, blocknum, buf) （可选）

• count(self)

• sync(self) (可选)

readblocks 和 writeblocks 应该在设备上从块号 blocknum 开始将数据复制到 buf 和设备之间。buf 将是一个长度为 512 的倍数的字节数组。如果未定义 writeblocks，则将只读方式挂载设备。这两个函数的返回值将被忽略。

count 应该返回设备上可用的块数。sync，如果实现了，应该同步设备上的数据。

参数 mountpoint 是文件系统根目录中挂载设备的位置。它必须以斜杠开头。

如果 readonly 为 True，则以只读方式挂载设备，否则以读写方式挂载。

如果 mkfs 为 True，则如果不存在文件系统，则创建一个新的文件系统。

pyb.repl_uart(uart)

获取或设置 REPL 重复的 UART 对象。

pyb.rng()

返回一个 30 位硬件生成的随机数。

pyb.sync()

同步所有文件系统。

pyb.unique_id()

返回一个长度为 12 字节（96 位）的字符串，该字符串是 MCU 的唯一 ID。

pyb.usb_mode([modestr, ]port=-1, vid=0xf055, pid=-1, msc=(), hid=pyb.hid_mouse, high_speed=False)

如果不带参数调用，则以字符串形式返回当前USB模式。

如果在提供了 modestr*的情况下调用，则尝试配置 USB 模式。*modestr 的以下值被理解：

• None：禁用 USB

• 'VCP'：启用 VCP（虚拟串口）接口

• 'MSC'：启用 MSC（大容量存储设备类）接口

• 'VCP+MSC'：启用 VCP 和 MSC

• 'VCP+HID'：启用 VCP 和 HID（人机界面设备）

• 'VCP+MSC+HID'：启用 VCP、MSC 和 HID（仅适用于 PYBD 板）

为了向后兼容，'CDC' 被理解为 'VCP'``（’CDC+MSC’`` 和 'CDC+HID' 也类似）。

port 参数应为整数（0、1、…），并选择要在板支持多个端口的情况下使用的 USB 端口。值为 -1 会使用默认或自动选择的端口。

vid 和 pid 参数允许您指定 VID（供应商 ID）和 PID（产品 ID）。 pid 值为 -1 将根据 modestr 的值选择 PID。

如果启用 MSC 模式，则 msc 参数可用于指定要在大容量存储接口上公开的 SCSI LUN 列表。例如 msc=(pyb.Flash(), pyb.SDCard())。

如果启用 HID 模式，还可以通过传递 hid 关键字参数来指定 HID 的详细信息。它接受一个元组（子类、协议、最大数据包长度、轮询间隔、报告描述符）。默认情况下，它将设置 USB 鼠标的适当值。还有一个 pyb.hid_keyboard 常量，它是 USB 键盘的适当元组。

当将 high_speed 参数设置为 True 时，如果硬件支持，则启用 USB HS 模式。

常量

pyb.hid_mouse

pyb.hid_keyboard

为 USB 鼠标或键盘设置适当值的元组（子类、协议、最大数据包长度、轮询间隔、报告描述符）。

类

• class ADC – 模拟到数字转换
• class CAN – 控制器局域网通信总线
• class DAC – 数字模拟转换
• class ExtInt – 配置 I/O 引脚以在外部事件上触发中断
• class Flash – 访问内置闪存存储
• class I2C – 一种两线串行协议
• class LED – LED对象
• class Pin – 控制I/O引脚
• class PinAF – 引脚替代功能
• class RTC – 实时时钟
• class Servo – 3线航模伺服驱动器
• class SPI – 由控制器驱动的串行协议
• class Timer – 控制内部定时器
• class TimerChannel — 为定时器设置通道
• class UART – 双工串行通信总线
• class USB_HID – USB人机接口设备（HID）
• class USB_VCP – USB虚拟通讯端口