pyb — 与董事会相关的职能

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

杂项功能

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是文件系统根目录中用于挂载设备的位置。它必须以正斜杠开头。

如果 readonlyTrue,则设备以只读方式挂载,否则以读写方式挂载。

如果 mkfsTrue, 那么如果一个新的文件系统不存在,则创建一个新的文件系统。

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模式如果硬件支持。