本页带你完成一个最小闭环：新建项目、添加 Sense 输入、添加逻辑、添加 Act 输出、配置硬件端口、验证代码并上传到开发板。
- 已安装 Aether Workshop。
- 准备 Aether Hub、Arduino Uno、Mega 2560、ESP-32 或 ESP8266 等兼容开发板。
- 用 USB 连接开发板，并准备传感器和执行器。
- 第一次上传前，请先到安装与配置安装 Arduino CLI。
- 打开 Aether Workshop。
- 在 Home 点击 New Project。
- 按提示保存项目。Aether Workshop 会把项目保存为
.aew包。 - 进入 Project 标签页。
- 从画布上的
Start节点开始。 - 按
Cmd+/打开快速搜索，或从节点连接点拖出打开 Node Picker。 - 添加一个 Sense 组件，例如 Light 或 Click。
- 添加逻辑节点，例如
if、else if、else、switch、case、default、delay或function。 - 添加一个 Act 组件，例如 RGB LED、Servo、Motor、Buzzer 或 LED Ring。
- 按执行顺序连接节点。
- 选中每个 Sense 或 Act 节点。
- 选择端口或手动引脚。
- 如果使用 Aether Hub，优先使用标准端口。
- 只有自定义接线时才切换到手动引脚模式。
完整映射见硬件与端口。
- 打开 Setting > Hardware，确认 Arduino CLI 已安装。
- 选择目标开发板。
- 在 Project 顶部工具栏选择串口。
- 打开 Code Preview 检查生成的 sketch。
- 点击 Verify 只编译不上传。
- 点击 Upload 编译并上传。
- 代码可以编译。
- 上传命令使用了正确的开发板和串口。
- Arduino 串口以
9600波特率输出 ready 信息。 - Act 组件按图逻辑响应。
Arduino CLI 缺失。 到 Setting > Hardware 安装。应用会把官方 Arduino CLI 下载到 Application Support。
找不到串口。 重新连接开发板，检查 USB 线，macOS 上优先选择 /dev/cu.*。
提示缺少硬件配置。 选中对应节点并配置端口或手动引脚。
提示缺少库。 到 Setting > Dependence 检查第三方库、内置库和自定义源代码库。