【产出】 > 不打开 Arduino IDE,用 Arduino CLI 在命令行完成装开发板支持包、编译、上传、装库和串口监视,并能写进脚本或 CI 里批量编译。
【版本】 > 按 Arduino CLI 1.x 官方入门文档编写,Windows、macOS、Linux 命令相同。
一、为什么用命令行
Arduino IDE 适合写单个小程序。下面这些场景用 Arduino CLI 更合适:
- 习惯用 VS Code、Vim 等编辑器写代码,只想用 Arduino 的编译和上传能力。
- 一份代码要给多种开发板编译,想写个脚本一次跑完。
- 在 GitLab CI / GitHub Actions 里自动编译,检查提交的代码能不能通过。
- 在树莓派、服务器这类没有图形界面的机器上给开发板烧录。
二、安装
从 Arduino CLI 官方发布页下载对应系统的压缩包,解压后把 arduino-cli 可执行文件放到 PATH 里的目录(如 Linux 的 ~/.local/bin)。确认安装成功:
arduino-cli version
三、初始化与更新索引
arduino-cli config init # 生成配置文件 arduino-cli.yaml
arduino-cli core update-index # 下载最新的开发板支持包索引
config init 会打印配置文件路径,Linux 默认在 ~/.arduino15/arduino-cli.yaml。
四、识别开发板
插上开发板后执行:
arduino-cli board list
输出会列出端口、开发板名称、FQBN 和所需的核心。FQBN(完整开发板名)的格式是 厂商:架构:型号,后面编译和上传都要用到它:
| 开发板 | FQBN |
|---|---|
| Arduino UNO | arduino:avr:uno |
| Arduino Nano | arduino:avr:nano |
| Arduino Mega 2560 | arduino:avr:mega |
| Arduino MKR WiFi 1010 | arduino:samd:mkrwifi1010 |
【提示】 > 国产 CH340 串口芯片的 UNO / Nano 兼容板,
board list往往只能识别出端口、识别不出型号,这是正常的。直接按板子型号填 FQBN 即可。不知道型号的 FQBN 时,用arduino-cli board listall 关键词搜索。
五、安装开发板支持包(核心)
arduino-cli core install arduino:avr # UNO、Nano、Mega 等 AVR 板
arduino-cli core list # 查看已安装的核心
第三方开发板(如 ESP32):先在配置文件里加上开发板管理器地址:
board_manager:
additional_urls:
- https://espressif.github.io/arduino-esp32/package_esp32_index.json
然后更新索引并安装:
arduino-cli core update-index
arduino-cli core install esp32:esp32
也可以不改配置文件,在每条命令后加 --additional-urls 地址。但官方文档提醒,这种方式需要在每一条涉及该核心的命令上都加这个参数,容易漏,建议写进配置文件。
六、新建、编译、上传
arduino-cli sketch new Blink
这会创建 Blink/Blink.ino,里面是空的 setup() 和 loop()。写入代码:
void setup() {
pinMode(LED_BUILTIN, OUTPUT);
}
void loop() {
digitalWrite(LED_BUILTIN, HIGH);
delay(500);
digitalWrite(LED_BUILTIN, LOW);
delay(500);
}
编译和上传:
arduino-cli compile --fqbn arduino:avr:uno Blink
arduino-cli upload -p /dev/ttyUSB0 --fqbn arduino:avr:uno Blink
端口填 board list 实际显示的那个:Windows 是 COM3 这种形式,macOS 是 /dev/cu.usbserial-xxxx。
【注意】 > 部分老款或兼容 Nano 板烧的是旧版引导程序,按
arduino:avr:nano上传会一直卡住失败。这时改用旧引导程序选项:--fqbn arduino:avr:nano:cpu=atmega328old。
七、库管理
arduino-cli lib search DHT # 搜索库
arduino-cli lib install "DHT sensor library"
arduino-cli lib list # 查看已安装的库
库名含空格时要加引号。
八、串口监视器
arduino-cli monitor -p /dev/ttyUSB0 -c baudrate=115200
波特率要和代码里 Serial.begin() 的值一致。按 Ctrl+C 退出。上传前要先退出监视器,否则端口被占用,上传会失败。
九、写成脚本批量编译
一份代码检查能否在多块板上编译通过:
#!/usr/bin/env bash
set -e
for fqbn in arduino:avr:uno arduino:avr:mega esp32:esp32:esp32; do
echo "== $fqbn"
arduino-cli compile --fqbn "$fqbn" Blink
done
放进 CI 时,先执行 core update-index 和 core install,再跑编译。
参考资料
- Arduino CLI 官方入门:https://arduino.github.io/arduino-cli/latest/getting-started/
- Arduino CLI 命令参考:https://arduino.github.io/arduino-cli/latest/commands/arduino-cli/
评价 (0)