suculent/arduino-docker-build Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

Arduino Docker Build

![Docker Pulls]([] ![Docker Stars]([] ![License]([] ![CircleCI]([]

在Docker容器中运行Arduino命令行构建器，将Arduino项目编译为二进制文件，随后可将其刷写到ESP8266/ESP32。

目标受众

• 应用开发者
  只需现成固件的开发者。

• 偶尔的固件开发者
  无需完全控制工具链，且不想搭建Linux虚拟机构建环境的开发者。

此镜像为THiNX开源IoT管理平台开发。

用法

安装Docker

按照[***]

快速启动

进入任意Arduino项目仓库根目录（构建器需要包含构建配置的thinx.yml文件，参见THINX设备API文档中的示例）。运行以下命令编译项目：

bash
docker run --rm -t -v `pwd`:/opt/workspace suculent/arduino-docker-build

使用Docker运行镜像

准备工作

1. 安装并运行socat以隧道化X11：

   bash
   $ brew install socat
   $ socat TCP-LISTEN:6000,reuseaddr,fork UNIX-CLIENT:\"$DISPLAY\"
   

2. 插入IP地址以通过X11/socat显示Arduino IDE：

   bash
   docker run --rm -ti -e DISPLAY=127.0.0.1:0 -v `pwd`:/opt/workspace suculent/arduino-docker-build
   

3. 打开终端，切换到包含.ino文件的Arduino项目仓库，运行：

   bash
   docker run --rm -ti -v `pwd`:/opt/workspace suculent/arduino-docker-build
   

   编译时间取决于系统性能，通常为1-3分钟。首次运行需更长时间，因为Docker需下载镜像并创建容器。

⚠️ 如果您之前已拉取过此Docker镜像（例如通过上述命令），应定期更新镜像以获取最新修复：

bash
docker pull suculent/arduino-docker-build

Windows用户注意事项

Windows路径处理略有不同，命令格式如下（c对应C盘，即c:）：

bash
docker run --rm -it -v //c/Users/<user>/<arduino-builder>:/opt/arduino-builder suculent/arduino-docker-build

若路径包含空格，需用引号包裹：

bash
docker run --rm -it -v "//c/Users/monster tune/<arduino-builder>"/opt/arduino-builder suculent/arduino-docker-build

用户库

若.ino文件旁存在lib文件夹，该文件夹会被复制到构建路径。

输出

固件文件生成在项目根目录的bin子文件夹中，同时生成同名.map后缀的映射文件。

选项

可通过docker run -e "<参数>=值" -e ...传递以下可选参数：

• WORKDIR：参数化示例，可能用于额外库，未来可能弃用。

环境支持

构建器可从environment.json重新生成指定的environment.h（文件名需在thinx.yml中定义），用于自定义项目变量。

若需通过环境变量修改GCC CFLAGS，自0.8.0版本起可使用cflags变量，该变量会传递给Arduino构建器。

刷写构建的二进制文件

有多种工具可将固件刷写到ESP8266/ESP32。若使用esptool，命令如下：

bash
esptool.py --port <serial-port> write_flash 0x00000 firmware.bin

支持

请勿在Docker Hub留下支持请求类评论：首先，Docker Hub不会通知我；其次，无法正常回复；最后，此类评论长期保留意义不大。建议在StackOverflow提问，并添加arduino和docker标签。

对于错误报告和改进建议，请在[***]

致谢

感谢Marcel Stoer，其在[***]

作者

Matěj Sychra @ THiNX