Arduino CLI 入门指南：从安装到项目开发全流程

Arduino CLI 入门指南：从安装到项目开发全流程

arduino-cli Arduino command line tool 项目地址: https://gitcode.com/gh_mirrors/ar/arduino-cli

什么是Arduino CLI

Arduino CLI是一个命令行工具，它提供了与Arduino IDE相同的功能集，但通过命令行界面进行操作。这个工具非常适合开发者、自动化场景以及那些更喜欢使用文本编辑器或IDE而不是图形界面的用户。

基础准备工作

命令结构理解

Arduino CLI采用模块化命令结构，每个功能模块都有自己独立的命令集。要查看核心功能相关的命令，可以运行：

arduino-cli help core

这个命令会显示所有与核心功能相关的子命令，包括：

• 核心安装(install)
• 核心列表(list)
• 核心搜索(search)
• 核心更新(update-index)
• 核心升级(upgrade)

配置文件创建

虽然Arduino CLI可以不使用配置文件运行，但创建配置文件能显著提升工作效率：

arduino-cli config init

生成的配置文件通常位于用户目录下的.arduino15文件夹中，包含了所有可配置选项及其默认值。

创建第一个项目

新建Sketch

Sketch是Arduino项目的基本单位，包含源代码和相关资源。创建一个新Sketch：

arduino-cli sketch new MyFirstSketch

这会创建一个包含基础模板代码的.ino文件：

void setup() {
}

void loop() {
}

编写示例代码

我们可以修改这个模板代码，添加一个简单的LED闪烁功能：

void setup() {
    pinMode(LED_BUILTIN, OUTPUT);
}

void loop() {
    digitalWrite(LED_BUILTIN, HIGH);
    delay(1000);
    digitalWrite(LED_BUILTIN, LOW);
    delay(1000);
}

硬件连接与配置

更新核心索引

在开始使用前，需要更新可用的开发板核心索引：

arduino-cli core update-index

识别开发板

连接开发板后，使用以下命令查看已连接的开发板：

arduino-cli board list

如果开发板未被正确识别，可以列出所有支持的开发板：

arduino-cli board listall

安装核心平台

根据开发板型号安装对应的核心平台，例如对于SAMD架构的开发板：

arduino-cli core install arduino:samd

安装完成后，验证已安装的核心：

arduino-cli core list

添加第三方核心

某些开发板需要第三方核心支持，可以通过修改配置文件添加：

board_manager:
  additional_urls:
    - https://arduino.esp8266.com/stable/package_esp8266com_index.json
    - file:///path/to/local/package_index.json

更新索引后即可使用这些核心：

arduino-cli core update-index
arduino-cli core search esp8266

编译与上传

编译Sketch

使用FQBN(完全限定开发板名称)编译Sketch：

arduino-cli compile --fqbn arduino:samd:mkr1000 MyFirstSketch

上传到开发板

指定串口和FQBN上传程序：

arduino-cli upload -p /dev/ttyACM0 --fqbn arduino:samd:mkr1000 MyFirstSketch

库管理

搜索库

Arduino生态系统有丰富的库资源，可以搜索特定功能的库：

arduino-cli lib search debouncer

安装库

安装选定的库：

arduino-cli lib install FTDebouncer

高级功能：守护进程模式

Arduino CLI可以以守护进程模式运行，提供gRPC接口：

arduino-cli daemon

此模式下，CLI会：

1. 启动gRPC服务器
2. 提供Prometheus监控端点(默认:9090端口)
3. 支持远程调用所有功能

总结

通过本指南，我们学习了Arduino CLI的完整工作流程：

1. 基础配置与命令结构
2. 项目创建与管理
3. 开发板识别与核心安装
4. 程序编译与上传
5. 库管理
6. 高级守护进程模式

Arduino CLI为开发者提供了强大的命令行工具链，特别适合自动化构建、持续集成等场景，同时也为喜欢命令行工作流的开发者提供了高效的选择。

arduino-cli Arduino command line tool 项目地址: https://gitcode.com/gh_mirrors/ar/arduino-cli