pyb --- 开发板关联功能函数

pyb 模块的主要功能与函数

时间相关函数

pyb.delay(ms)

延时函数，参数的单位为毫秒。

pyb.udelay(us)

延时函数，参数的单位为微秒。

pyb.millis()

返回自上次重置电路以来的毫秒数， 结果是一个31位有符号整数，在2**30（约12.4天）后开始返回负数。

注意 如果调用:meth:pyb.stop() 经停止硬件计数器，因此 "sleeping" 将计数。他也会影响 pyb.elapsed_millis()。

pyb.micros()

返回自上次重置电路以来的微秒数。结果是一个31位有符号整数，在2**30微秒（约17.8分钟）后开始返回负数。

Note that if pyb.stop() is issued the hardware counter supporting this function will pause for the duration of the "sleeping" state. This will affect the outcome of 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)

返回已经过去的微秒数 负责计数器换行，并且始终返回正数。这意味着它可以用于测量高达约17.8分钟的时间段。

例如:

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

重置相关函数

pyb.hard_reset()

重置开发板，相当于开发板上的复位键

pyb.bootloader()

启动Bootloader而不使用BOOT *引脚。

pyb.fault_debug(value)

启用或禁用硬故障调试。硬盘故障是在底层系统发生致命错误时，如无效内存访问。

如果值参数为`False`，那么如果存在硬故障，则主板将自动重置。

如果值参数为`True`，当主板有硬件故障，它会打印的寄存器和堆栈跟踪，并无限期地然后循环的指示灯。

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

中断相关函数

pyb.disable_irq()

禁用中断请求。 返回上一个IRQ状态： False / True 分别为禁用/启用的IRQ。该返回值可以传递给enable_irq将IRQ恢复到原始状态。

pyb.enable_irq(state=True)

启用中断请求 如果 state 是 True (默认值) 启用中断状态。 如果 state 是 False 禁用中断状态。 这个函数的最常见的用法是传递返回的值``disable_irq``来退出临界区。

电源相关功能

其他功能

pyb.main(filename)

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

在boot.py中调用此函数。

pyb.repl_uart(uart)

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

pyb.sync()

同步所有文件系统。

pyb.usb_mode([modestr, ]vid=0xf055, pid=0x9801, hid=pyb.hid_mouse)

如果没有参数调用，则返回当前的USB模式作为字符串。 如果被``modestr``提供，则尝试设置USB模式。这只有在从调用``boot.py``之前调用时才能:meth:`pyb.main()`完成。 以下值``modestr``被理解为：

  • None：禁用USB
  • 'VCP'：使用VCP（虚拟COM端口）接口
  • 'VCP+MSC'：使能VCP和MSC（大容量存储设备类）
  • 'VCP+HID'：使能VCP和HID（人机界面设备）

为了向后兼容，'CDC'``被理解为是 ``'VCP'``（并且对于'CDC+MSC'和'CDC+HID'``）。

该参数``vid``和``pid``参数允许您指定VID（供应商ID）和PID（产品ID）。

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