pyb — 与董事会相关的职能

该 pyb 模块包含与板相关的特定功能。

时间相关功能

pyb.delay(ms)

延迟给定的毫秒数。

pyb.udelay(us)

延迟给定的微秒数。

pyb.millis()

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

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

请注意，如果pyb.stop()发出支持此功能的硬件计数器将在“睡眠”状态期间暂停。这将影响 的结果pyb.elapsed_millis()。

pyb.micros()

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

结果始终是 MicroPython smallint（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 按钮的方式重置 pyboard。

pyb.bootloader()

在没有 BOOT* 引脚的情况下激活引导加载程序。

pyb.fault_debug(value)

启用或禁用硬故障调试。硬故障是指底层系统中存在致命错误，例如无效的内存访问。

如果value参数是，False 则板将在出现硬故障时自动重置。

如果value是True ，当板出现硬故障时，它将打印寄存器和堆栈跟踪，然后无限期地循环 LED。

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

中断相关函数

pyb.disable_irq()

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

pyb.enable_irq(state=True)

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

电源相关功能

pyb.freq([sysclk[, hclk[, pclk1[, pclk2]]]])

如果没有给定参数，则返回一个时钟频率元组：（sysclk、hclk、pclk1、pclk2）。这些对应于：

• sysclk：CPU 频率

• hclk：AHB 总线、核心内存和 DMA 的频率

• pclk1：APB1总线的频率

• pclk2：APB2总线的频率

如果给出任何参数，则该函数设置 CPU 的频率，如果给出附加参数，则设置总线。频率以Hz为单位给出。例如 freq(120000000) 将 sysclk（CPU 频率）设置为 120MHz。请注意，并非所有值都受支持，将选择不大于给定值的最大支持频率。

支持的 sysclk 频率为（以 MHz 为单位）：8、16、24、30、32、36、40、42、48、54、56、60、64、72、84、96、108、120、144、168。

hclk 的最大频率为 168MHz，pclk1 的最大频率为 42MHz，pclk2 的最大频率为 84MHz。确保不要将频率设置为高于这些值。

hclk、pclk1 和 pclk2 频率是使用预分频器（分频器）从 sysclk 频率导出的。hclk 支持的预分频器为：1、2、4、8、16、64、128、256、512。pclk1 和 pclk2 支持的预分频器为：1、2、4、8。将选择一个预分频器以最佳匹配请求频率。

8MHz 的 sysclk 频率直接使用 HSE（外部晶振），16MHz 直接使用 HSI（内部振荡器）。较高的频率使用 HSE 驱动 PLL（锁相环），然后使用 PLL 的输出。

请注意，如果在启用 USB 时更改频率，则 USB 可能变得不可靠。最好在启动 USB 外设之前更改 boot.py 中的频率。另请注意，低于 36MHz 的 sysclk 频率不允许 USB 正常工作。

pyb.wfi()

等待内部或外部中断。

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

pyb.stop()

将 pyboard 置于“睡眠”状态。

这将功耗降低到 500 uA 以下。要从该睡眠状态唤醒需要外部中断或实时时钟事件。醒来后，执行从停止的地方继续。

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

pyb.standby()

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

这将功耗降低到 50 uA 以下。要从此睡眠状态唤醒，需要实时时钟事件，或 X1 (PA0=WKUP) 或 X18 (PC13=TAMP1) 上的外部中断。唤醒后系统会进行硬重置。

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

杂项功能

pyb.have_cdc()

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

笔记

此功能已弃用。改用 pyb.USB_VCP().isconnected() 。

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)

笔记

此功能已弃用。安装和卸载设备应由uos.mount() 和 uos.umount()代替。

挂载块设备并使其作为文件系统的一部分可用。 device必须是提供块协议的对象。（以下内容也已弃用。有关uos.AbstractBlockDev for the 创建块设备的正确方法，请参阅。）

• readblocks(self, blocknum, buf)

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

• count(self)

• sync(self) （可选的）

readblocks并且 writeblocks 应该 buf 在块设备之间复制数据，从 blocknum 设备上的块号开始。 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 的情况下调用，则尝试配置 U​​SB 模式。理解modestr的以下值：

• None: 禁用 USB

• 'VCP': 使用 VCP (Virtual COM Port) 接口启用

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

• 'VCP+MSC': 使用 VCP 和 MSC 启用

• 'VCP+HID': 使用 VCP 和 HID（人机接口设备）启用

• 'VCP+MSC+HID': 启用 VCP、MSC 和 HID（仅在 PYBD 板上可用）

为了向后兼容，'CDC'应理解为意指 'VCP' （以及类似地为 'CDC+MSC' 和 'CDC+HID')。

的端口参数应该是一个整数（0,1，...）和选择哪个USB端口的使用，如果该板支持多个端口。值 -1 使用默认或自动选择的端口。

该VID和PID参数允许您指定的VID（供应商ID）和PID（产品ID）。甲PID值-1将选择基于的值的PID modestr。

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

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

该high_speed参数，当设置为True, 使USB HS模式如果硬件支持。

班级

• Accel 类 – 加速度计控制
• 类 ADC – 模数转换
• CAN类——控制器局域网通信总线
• 类 DAC – 数模转换
• 类 ExtInt – 配置 I/O 引脚以在外部事件上中断
• class Flash – 访问内置闪存
• I2C 类 – 一种两线串行协议
• LCD 类 – LCD 触摸传感器 pyskin 的 LCD 控制
• LED 类 – LED 对象
• 引脚类 – 控制 I/O 引脚
• PinAF 类 – 引脚交替功能
• RTC 类 – 实时时钟
• 伺服类 – 3 线业余伺服驱动器
• SPI 类——主驱动串行协议
• 类 Switch – 开关对象
• 类 Timer – 控制内部定时器
• 类 TimerChannel — 为计时器设置通道
• UART 类——双工串行通信总线
• USB_HID 类 – USB 人机接口设备 (HID)
• USB_VCP 类 – USB 虚拟通信端口