架构设计

本模块是 MicroPython 在 ESP32 上的 port，以 Makefile 为构建入口，通过 BOARD=mpython|labplus-experiment-box-2024|labplus_1956|... 选择板型，每个板型目录含 main.c、mpconfigboard.h、mpconfigboard.mk 及可选 modules/。

内部分层清晰：

• mpconfigport.h 集中定义 MicroPython 编译开关（VFS、BLE、uSSL、machine 系列等），并通过 MICROPY_PORT_BUILTIN_MODULES 宏注册 C 层内置模块；qstrdefsport.h 管理 qstr。

• builtins/ 存放编译进固件的 C 扩展（modmachine.c、modmusic.c、modcodec.c、modrfid.c、esp32_nvs.c 等），通过 BUILTIN_C 变量加入链接，暴露 machine、music、audio、radio、NVS 等 Python 接口。

• drivers/ 提供底层外设驱动：codec/（Helix MP3 + libmad + ES8388 音频编解码）、mpu6050/（Invensense eMPL/DMP 姿态解算）、rgbLED5x5/（5×5 RGB 点阵图形库）、rfid/mfrc522、startup/（OLED 启动画面、I2C master）。

• file_system/ 作为 VFS 根文件系统镜像内容，由 make_lfs.py 打包成 LFS2 镜像，main.py 为开机脚本，lib/、modules/ 下为运行时加载的 Python 扩展（siot、yeelight、xunfei、smartcamera、microbit、blynklib 等第三方集成）。

• boards/ 下各板型通过 mpconfigboard.mk 叠加 sdkconfig.base、sdkconfig.ble、sdkconfig.spiram 等片段配置 IDF Kconfig，并可选择性包含自身 modules/ 中的 Python 包（如 mpython/modules/mpython/educore、v81、k210）。

• 依赖方向自顶向下：boards/* → builtins/* → drivers/* → ESP-IDF components；Python 层仅通过 import 调用 C 暴露的模块或同层 .py 文件，不反向依赖 C。

• 构建产物经 release.py 合并 bootloader.bin、partitions.bin、application.bin、vfs.bin 生成完整固件镜像，deploy 目标通过 esptool 烧录至 0x1000 偏移。