MicroPython 库 警告 本节重要摘要 MicroPython 提供了反映 Python 标准库功能的内置模块(例如os, time),以及 MicroPython 特定的模块(例如bluetooth, machine)。 大多数标准库模块实现了等效 Python 模块的功能子集,并在少数情况下提供了一些特定于 MicroPython 的扩展(例如array, os) 由于资源限制或其他限制,某些端口或固件版本可能不包括此处记录的所有功能。 为了实现可扩展性,内置模块可以从加载到设备上的 Python 代码进行扩展。
% d& B* x$ Z5 i- b x6 X7 t " c: c: p, i; ]& q6 z! n5 f8 }" o
本章介绍 MicroPython 中内置的模块(函数和类库)。本文档通常希望描述在 MicroPython 项目中实现的所有模块和函数/类。但是,MicroPython 是高度可配置的,并且特定板/嵌入式系统的每个端口可能仅包含可用 MicroPython 库的一个子集。 考虑到这一点,请注意本文档中描述的模块(甚至整个模块)中的某些函数/类在 特定系统上的特定 MicroPython 版本中可能不可用 。查找特定功能的可用性/不可用性的一般信息的最佳位置是“一般信息”部分,其中包含与特定MicroPython 端口相关的信息。 在某些端口上,您可以通过在 REPL输入以下内容来发现可用的内置库: help('modules')
9 n: N; i3 @% Y _# F
5 J. G9 A' S" J: o5 n, Y除了本文档中描述的内置库之外,还可以在micropython-lib中找到 Python 标准库中的更多模块以及对它的进一步 MicroPython 扩展。 Python 标准库和微型库以下标准 Python 库已被“微化”以符合 MicroPython 的理念。它们提供该模块的核心功能,旨在替代标准 Python 库。
1 Y# z3 S3 a" } }8 m" y( Z' T' x: F1 m! W2 ?" m- P! F" j
MicroPython 特定的库以下库中提供了特定于 MicroPython 实现的功能。
8 {6 I# {( Y1 @. \& g1 g( |
. I( B) s( E$ p$ \特定于端口的库在某些情况下,以下特定于端口/板的库具有与库中的功能或类类似的功能或类machine 。在发生这种情况时,端口特定库中的条目公开了该平台独有的硬件功能。 要编写可移植代码,请使用machine 模块中的函数和类。要访问特定于平台的硬件,请使用适当的库,例如pyb 在 Pyboard 的情况下。 特定于 pyboard 的库以下库特定于 pyboard。
& @% S6 l7 O9 p1 \6 |' u8 H- R1 o
特定于 WiPy 的库以下库和类特定于 WiPy。 $ b4 S" z5 A( M. Q o2 [" ?4 W0 F
5 R7 A4 e5 b5 \特定于 ESP8266 和 ESP32 的库以下库特定于 ESP8266 和 ESP32。
! p3 H! v& c3 ~2 Y) |1 ?0 G7 U M2 T
1 G! p9 L, `8 a, ]6 I) S0 q特定于 RP2040 的库以下库特定于 RP2040,在 Raspberry Pi Pico 中使用。 5 U/ r( G- G8 h4 G- r. E$ x7 e' }
" Y- b7 Y u& u! |& y
Zephyr 特有的库以下库特定于 Zephyr 端口。 9 B% u0 L) Q5 i4 i' f& d+ U. [) H
J: m- L- p: ]' r% _ G" m8 Q
( C8 @3 M' {6 K从 Python 扩展内置库在大多数情况下,上述模块实际上是命名umodule 而不是 module,但 MicroPython 会将任何以 u 为前缀的模块作为非u 版本的别名。然而,名为的文件(或 f冻结模块) module.py 将优先于该别名。 这允许用户提供内置库的扩展实现(可能是为了提供额外的 CPython 兼容性)。用户提供的模块 (in module.py) 仍然可以通过umodule直接导入来使用内置功能 。这在 micropython-lib中被广泛使用。有关详细信息,请参阅 分发包、包管理和部署应用程序 。 这适用于Python标准库(如 os, time等),也有MicroPython库太(如 machine, bluetooth等)。主要的例外是端口专用库(pyb, esp等)。 除了当您特别想强制使用内置模块时,我们建议始终使用“import module”而不是“import umodule”。 / [3 \- c j: o6 z
5 ~- t$ v5 S' I; d% l! S |