5 步跑通 ino：Arduino 命令行开发工具入门指南

5 步跑通 ino：Arduino 命令行开发工具入门指南

【免费下载链接】slintSlint is an open-source declarative GUI toolkit to build native user interfaces for Rust, C++, JavaScript, or Python apps.项目地址: https://gitcode.com/GitHub_Trending/sl/slint

ino 是一个面向 Arduino 的命令行工具，把建项目、编译、上传固件、串口监控合并进同一套命令，让 Arduino 脱离 IDE 开发成为可能。适合习惯终端、想把构建流程交给脚本的嵌入式新手。

它解决什么问题

IDE 里点按钮的每一步，ino 都换成一条命令：初始化项目、生成 Makefile、编译出firmware.hex、驱动 avrdude 写片、挂上 picocom 看串口。好处是流程可复现、可写进 CI 和 Makefile，中间产物统一放进.build/，源码目录保持干净。

3 分钟完成 ino 安装与验证

先装 ino 本身：

pip install ino

从源码安装也可以：

git clone https://gitcode.com/GitHub_Trending/sl/slint ino-src cd ino-src && make install

ino 依赖本机已装好的 Arduino IDE（用来找boards.txt、核心和工具链）以及picocom（串口监视器）。装完用一条命令确认环境能被识别：

ino list-models

能列出uno、mega2560等板型，说明 Arduino 路径和工具链都找到了，可以开工。

用 ino 创建项目并上传第一个固件

创建项目

mkdir echo-led cd echo-led ino init -t empty

生成的骨架：

echo-led/ ├── lib/ └── src/ └── sketch.ino

-t blink会带一个 LED 闪烁模板；这里用空模板，自己写一段串口回显加按键计数的代码。

写代码

编辑src/sketch.ino：

const int BTN_PIN = 2; uint32_t count = 0; void setup() { Serial.begin(115200); pinMode(BTN_PIN, INPUT_PULLUP); Serial.println("ino echo ready"); }

void loop() { if (digitalRead(BTN_PIN) == LOW) { count++; Serial.println("count: " + String(count)); delay(50); } if (Serial.available()) { Serial.write(Serial.read()); } }

按一下接在 2 号引脚的按键就计数一行，串口控制台里敲字会被原样回显。

构建与烧录

ino build ino upload

build会依次定位boards.txt、Arduino 核心和 avr-gcc 工具链，编译结果落在.build/firmware.hex；upload调用 avrdude 把固件写进 Flash 并校验。

观察输出

ino serial

picocom 接管串口，应该看到ino echo ready，之后每按一次按键多一行计数。Ctrl+A后按Ctrl+X退出。非 Uno 板型或非常规串口，在命令上追加参数：

ino upload -m mega2560 -p /dev/ttyACM1 ino serial -p /dev/ttyACM1

用 ino.ini 固化默认参数

重复输入板型和串口很烦，在项目根目录放一个ino.ini：

board-model = mega2560 serial-port = /dev/ttyACM1

也可以按命令分节覆盖，例如[build]、[upload]、[serial]各自指定。取值优先级从高到低：命令行参数 > 项目级ino.ini> 用户级~/.inorc> 系统级/etc/ino.ini。换一台开发机，只需改一行配置文件。

排错地图

现象：找不到 Arduino 安装目录。原因：ino 自动探测失败。修复：

export ARDUINO_DIR=/path/to/arduino

现象：打开串口报权限错误（Linux）。原因：当前用户不在 dialout 组。修复：

sudo usermod -a -G dialout $USER

执行后重新登录会话生效。

现象：ino serial提示缺少 picocom。原因：串口监视器未安装。修复：

sudo apt-get install picocom

延伸命令与资源

• ino build --verbose：展开完整编译日志
• ino list-models：列出全部受支持板型
• ino preproc：查看草图预处理结果（包括自动生成的函数原型）
• ino clean：清掉.build/重来
• 官方文档：完整参数与模板列表

源码结构里最值得看的是命令实现目录（ino/commands/）和模板目录（ino/templates/），读一遍就能明白每条命令背后做了什么。

开始动手

ino 把 Arduino 的完整开发生命周期收敛成四个动词：init、build、upload、serial，学会它们就等于掌握了 Arduino 脱离 IDE 开发的整条链路。现在就可以动手：接上板子，跑一遍ino init -t empty，把上面 20 行代码敲进去，看着串口里滚出自己的计数——第一次烧录成功，后面的路就顺了。

【免费下载链接】slintSlint is an open-source declarative GUI toolkit to build native user interfaces for Rust, C++, JavaScript, or Python apps.项目地址: https://gitcode.com/GitHub_Trending/sl/slint