suculent/arduino-docker-build

Arduino Docker Build

https://img.shields.io/docker/pulls/suculent/arduino-docker-build.svg](https://hub.docker.com/r/suculent/arduino-docker-build/) https://img.shields.io/docker/stars/suculent/arduino-docker-build.svg](https://hub.docker.com/r/suculent/arduino-docker-build/) https://img.shields.io/badge/license-MIT-blue.svg?style=flat](https://github.com/suculent/arduino-docker-build/blob/master/LICENSE) https://circleci.com/gh/suculent/arduino-docker-build/tree/master.svg?style=svg](https://circleci.com/gh/suculent/arduino-docker-build/tree/master)

在Docker容器中运行Arduino命令行构建器，将Arduino项目编译为二进制文件，随后可将其http://nodemcu.readthedocs.org/en/dev/en/flash/%E3%80%82

目标受众

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

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

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

用法

安装Docker

按照https://docs.docker.com/get-started/%E7%9A%84%E8%AF%B4%E6%98%8E%E5%AE%89%E8%A3%85%E3%80%82

快速启动

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

bash
docker run --rm -t -v `pwd`:/opt/workspace docker.xuanyuan.run/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 docker.xuanyuan.run/suculent/arduino-docker-build
   

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

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

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

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

bash
docker pull docker.xuanyuan.run/suculent/arduino-docker-build

Windows用户注意事项

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

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

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

bash
docker run --rm -it -v "//c/Users/monster tune/<arduino-builder>"/opt/arduino-builder docker.xuanyuan.run/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构建器。

刷写构建的二进制文件

有多种http://nodemcu.readthedocs.org/en/dev/en/flash/%E3%80%82%E8%8B%A5%E4%BD%BF%E7%94%A8https://github.com/themadinventor/esptool%EF%BC%8C%E5%91%BD%E4%BB%A4%E5%A6%82%E4%B8%8B%EF%BC%9A

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

支持

请勿在Docker Hub留下支持请求类评论：首先，Docker Hub不会通知我；其次，无法正常回复；最后，此类评论长期保留意义不大。建议在http://stackoverflow.com/%E6%8F%90%E9%97%AE%EF%BC%8C%E5%B9%B6%E6%B7%BB%E5%8A%A0%60arduino%60%E5%92%8C%60docker%60%E6%A0%87%E7%AD%BE%E3%80%82

对于错误报告和改进建议，请在https://github.com/suculent/arduino-docker-build/issues%E5%88%9B%E5%BB%BAissue%E3%80%82

致谢

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

作者

Matěj Sychra @ THiNX