MicroPython 模块

!!! abstract "摘要"

- MicroPython 提供丰富的模块，每个模块提供特定的功能。了解开发的过程中一些常用的模块的使用方式，可以让你很好的使用 MicroPython 的功能。

- 这些模块可以通过 env 工具的 menuconfig 功能来开启和关闭，如果你需要使用特定的模块，在 menuconfig 中选中模块名，保存退出后，重新编译运行即可。

1. MicroPython 模块的类别

MicroPython 的模块（函数和类库）有以下几类 :

内置模块：标准 Python 功能的子集，用户不能扩展。
扩展模块：实现了 Python 功能的一个子集，并提供用户扩展（通过Python代码）。
扩展模块：实现 micropython 的 Python 标准库。
硬件驱动模块: 特定端口或者硬件驱动的模块，因此不可移植。

Note about the availability of modules and their contents: This documentation in general aspires to describe all modules and functions/classes which are implemented in MicroPython. However, MicroPython is highly configurable, and each port to a particular board/embedded system makes available only a subset of MicroPython libraries. For officially supported ports, there is an effort to either filter out non-applicable items, or mark individual descriptions with "Availability:" clauses describing which ports provide a given feature. With that in mind, please still be warned that some functions/classes in a module (or even the entire module) described in this documentation may be unavailable in a particular build of MicroPython on a particular board. The best place to find general information of the availability/non-availability of a particular feature is the "General Information" section which contains information pertaining to a specific port.

Beyond the built-in libraries described in this documentation, many more modules from the Python standard library, as well as further MicroPython extensions to it, can be found in the micropython-lib repository.

2. Python 标准库和微型库

标准的 Python 库被 “微型化”后，就是 micropython 标准库。它们仅仅提供了该模块的核心功能。一些模块没有直接使用标准的 Python 的名字，而是冠以"u"，例如ujson代替json。也就是说 micropython 标准库（=微型库），只实现了一部分模块功能。通过他们的名字不同，用户有选择的去写一个 Python 级模块扩展功能，也是为实现更好的兼容性。

在嵌入式平台上，可添加 Python 级别封装库从而实现命名兼容 CPython，微模块即可调用他们的 u-name，也可以调用 non-u-name。根据 non-u-name 包路径的文件可重写。

例如，import json的话，首先搜索一个json.py文件或json目录进行加载。如果没有找到，它回退到加载内置ujson模块。

3. RT-Thread MicroPython 模块列表

1、系统模块

rtthread – RT-Thread 系统相关函数
utime – 时间相关函数
sys – 系统特有功能函数
math – 数学函数
uio – 输入/输出流
ucollections – 收集和容器类型
ustruct – 打包和解包原始数据类型
array – 数字数据数组
gc – 控制垃圾回收

2、硬件模块

machine – 与硬件相关的功能
machine.Pin
machine.I2C
machine.SPI
machine.UART

3、系统模块

uos – 基本的 “操作系统” 服务
select – 等待流事件
uctypes – 以结构化的方式访问二进制数据
uerrno – 系统错误码模块
_thread – 多线程支持

4、工具模块

cmath – 复数的数学函数
ubinascii – 二进制/ ASCII转换
uhashlib – 哈希算法
uheapq – 堆排序算法
ujson – JSON编码与解码
ure – 正则表达式
uzlib – zlib 解压缩
urandom – 随机数生成模块

5、网络模块

usocket – 套接字模块

03-MicroPython_libraries.md 5.1 KB Historik Rå