micropython/build-micropython-arm

镜像概述

该Docker镜像提供了基于Arm架构的MicroPython端口构建环境，专为Arm微控制器的MicroPython固件开发设计。当前支持的MicroPython端口包括：mimxrt、nrf、renesas-ra、rp2、samd、stm32、teensy。

核心功能与特性

• 预装开发工具链：包含gcc-arm-none-eabi交叉编译器，支持Arm微控制器的代码编译
• 基础构建工具：集成build-essential（含make等）和cmake，满足复杂项目构建需求
• 开发环境依赖：预装git版本控制工具和python3，支持MicroPython源码获取与构建脚本执行
• 轻量级基础镜像：基于debian:bullseye-slim，保持镜像体积小巧，同时提供稳定的开发环境

使用场景

适用于需要为Arm架构微控制器（如STM32、RP2040、nRF系列等）开发或编译MicroPython固件的开发者，可快速搭建一致的跨平台构建环境，避免本地环境配置差异导致的构建问题。

使用方法与配置说明

拉取镜像

可通过以下命令拉取镜像（假设镜像名称为micropython-arm-buildenv）：

bash
docker pull docker.xuanyuan.run/micropython-arm-buildenv

运行容器

运行容器并挂载本地MicroPython源码目录，以进行固件构建：

bash
docker run -it --rm -v /path/to/micropython/source:/workspace docker.xuanyuan.run/micropython-arm-buildenv

• -v /path/to/micropython/source:/workspace：将本地MicroPython源码目录挂载到容器内的/workspace目录
• --rm：容器退出后自动删除，避免残留容器文件
• -it：以交互模式运行，便于执行构建命令

构建示例

在容器内，进入对应端口目录并执行构建命令。以rp2端口为例：

bash
cd /workspace/ports/rp2
make

Dockerfile参考

该镜像基于以下Dockerfile构建：

dockerfile
FROM debian:bullseye-slim

RUN apt update && \
    apt install -y gcc-arm-none-eabi \
    build-essential \
    git \
    python3 \
    cmake