bloedebleidd/embedded

嵌入式系统持续集成Docker镜像

镜像概述

该镜像专为嵌入式系统持续集成(CI)设计，集成了丰富的工具链、编译器、调试工具、代码分析工具及开发 utilities，支持Linux amd64宿主环境及Cortex-M、ESP32、ESP8266、AVR 8位等多种微控制器平台，可简化嵌入式项目的构建、测试、调试及部署流程。

核心功能与特性

支持平台

• 宿主环境：Linux amd64
• 目标平台：ARM Cortex-M系列、ESP32、ESP8266（Xtensa架构）、AVR 8位微控制器

标签版本信息

镜像提供以下标签版本，包含不同工具链及依赖版本：

compact-1.1.0（推荐）

• 大小：3.99GB

• 嵌入式系统工具链与SDK：

  • ARM GNU Toolchain：14.2.1
  • Xtensa ESP Toolchain：14.2.0_20241119
  • ESP-IDF：v5.4.1
  • AVR Toolchain：GCC 7.3.0、Binutils 2.26、Libc 2.0.0
  • avrdude：7.1

• 本地编译器与构建系统：

  • gcc/g++：13.2.0
  • make：4.3、cmake：3.28.3、ninja：1.11.1
  • scons：4.5.2、flex：2.6.4、bison：3.8.2
  • gperf：3.1、ccache：4.9.1、lcov：2.0

• MCU操作与调试工具：

  • xPack OpenOCD：0.12.0
  • ST-Link Tools：1.8.0
  • pyocd：0.36.0（Python）、pyserial：3.5（Python）

• 静态与动态分析工具：

  • cppcheck：2.13.0、flawfinder：2.0.19、vera++：1.2.1
  • clang-tidy：18.0、clang-format：18.0、valgrind：3.22.0

• 额外开发库与工具：

  • git：2.43.0、wget：1.21.4、curl：8.5.0
  • python：3.12.3、pip：24.0、virtualenv：20.31.2
  • libusb：1.0.27、gcovr：8.3、py***dome：3.23.0

compact-1.0.0_ubuntu-20.4（旧版本）

• 大小：3.83GB

• 工具链与编译器：

  • gcc/g++：10.3.0、arm-none-eabi（GCC 10.2.1）、avr8-gnu-toolchain（GCC 5.4.0）
  • xtensa-esp32/xtensa-lx106（ESP 2020r3，GCC 8.4.0）、ESP-IDF：v4.3

• 调试与构建工具：

  • openocd ESP32：v0.11.0-esp32-20211220、xPack OpenOCD：0.11.0-3
  • st-link：1.7.0、avrdude：6.3-20171130
  • cmake：3.16.3、scons：3.1.2、ninja：1.10.0

• 分析工具：

  • clang-tidy：10.0.0、cppcheck：1.90、flawfinder：2.0.10
  • lcov：1.14、vera++：1.2.1

• Python包：

  • python3：3.8.10、pip：20.0.2、esptool：3.2
  • gcovr：5.0、pyelftools：0.28、anybadge：1.8.0

使用场景

• 嵌入式项目的CI/CD自动化流程（如构建、测试、代码质量检查）
• 多平台嵌入式软件开发（统一开发环境配置）
• 微控制器固件调试与分析（集成OpenOCD、ST-Link等调试工具）
• 代码静态分析与动态测试（支持cppcheck、valgrind、clang-tidy等）

使用方法

获取镜像

bash
# 拉取最新推荐版本
docker pull [镜像仓库地址]/embedded-docker:compact-1.1.0

# 拉取旧版本（Ubuntu 20.04基础）
docker pull [镜像仓库地址]/embedded-docker:compact-1.0.0_ubuntu-20.4

运行容器

bash
# 交互式运行（进入容器终端）
docker run -it --rm [镜像仓库地址]/embedded-docker:compact-1.1.0 /bin/bash

# 挂载本地项目目录（示例：当前目录挂载到容器内/project）
docker run -it --rm -v $(pwd):/project [镜像仓库地址]/embedded-docker:compact-1.1.0 /bin/bash

# 在CI流程中使用（示例：GitLab CI配置）
build_job:
  image: [镜像仓库地址]/embedded-docker:compact-1.1.0
  script:
    - cd /project
    - make clean && make  # 执行项目构建
    - cppcheck src/       # 代码静态分析

版本选择建议

• compact-1.1.0：适用于新项目，包含最新工具链（如ARM 14.2.1、ESP-IDF v5.4.1）和编译器（gcc 13.2.0）。
• compact-1.0.0_ubuntu-20.4：适用于依赖Ubuntu 20.04环境或旧版工具链（如ESP-IDF v4.3）的遗留项目。