跳到主要内容

Arduino 命令行工具

Arduino CLI 是一个命令行工具,它包含围绕 Arduino 生态系统轻松构建应用程序所需的一切,包括管理库、编译、验证和上传草图到 Arduino 开发板。以及执行与 Arduino 生态系统相关的其他操作,例如解析 CLI 的 JSON 输出,或者将其实现为一个在线服务,通过 gRPC 接口接受命令。

本文主要以 Ubuntu 操作系统为例,介绍 Arduino 命令行工具 arduino-cli 的安装和使用。

安装步骤

从 Arduino 官方网站下载最新的 .tar.gz 安装包

wget -qO arduino-cli.tar.gz \
https://downloads.arduino.cc/arduino-cli/arduino-cli_latest_Linux_64bit.tar.gz

将 arduino-cli 包解压缩到 /usr/local/bin 目录

sudo tar xf arduino-cli.tar.gz -C /usr/local/bin arduino-cli

这样我们就安装好了 arduino-cli 命令行工具,你可以打开任意一个终端使用它。

例如,查看版本信息

$ arduino-cli version
arduino-cli Version: 0.20.2 Commit: 13783819 Date: 2021-12-09T13:32:05Z

如果你想更新 arduino-cli 工具,只需要重复上述步骤,覆盖原来的可执行文件即可。

命令格式

arduino-cli 命令支持许多参数,其语法格式如下:

arduino-cli <命令> [参数...]

可用的命令有:

命令描述
boardArduino 开发板命令
burn-bootloader上传引导加载程序
cacheArduino 缓存命令
compile编译 Arduino 项目
completion已生成脚本
configArduino 配置命令
coreArduino 内核操作
daemon在端口 50051 上作为守护进程运行
debug调试 Arduino 项目
help显示帮助信息
libArduino 关于库的命令
monitor开启开发板的通信端口
outdated列出可以升级的内核和库
sketchArduino CLI 项目命令
update更新内核和库的索引
upgrade升级已安装的内核和库
upload上传 Arduino 项目。
version显示 Arduino CLI 的版本号

各个命令中又包含了子命令,你可以通过 -h 选项来查看具体的子命令用法,例如:

arduino-cli board -h

使用方法

查看 Arduino 板信息

如果你的电脑已经连接了 Arduino 开发板,那么可以使用 arduino-cli board list 命令查看板的信息。

$ arduino-cli board list
Port Protocol Type Board Name FQBN Core
/dev/ttyACM0 serial Serial Port (USB) Arduino MKRZERO arduino:samd:mkrzero arduino:samd

一共六个字段,分别表示端口、协议、类型、开发板名、FQBN、内核。

备注:FQBN 是 Fully Qualified Board Name 的首字母缩写。

创建草图

使用 sketch new 命令为 Arduino 项目创建一个新的草图(sketch)

arduino-cli sketch new helloworld

这样,我们就创建了一个名为 helloworld 的项目,在 helloworld 目录中包含了一个 helloworld.ino 文件。它的内容如下,你可以在这里开始编写 Arduino 代码。

void setup() {
}

void loop() {
}

上传固件

将项目 mySketch 写入 Arduino 开发板上

arduino-cli board attach serial:///dev/ttyACM0 mySketch