端口编辑器
端口编辑器用于配置 MotioForge Studio 向硬件发送命令所使用的串行通信通道。 在启动窗口的端口选项卡中点击编辑按钮即可打开。
列表结构
上方区域显示已配置端口的列表。每一行代表一个端口，包括名称、类型、协议和物理地址。 选中某一行即可在下方面板中编辑；点击添加可新增端口。
配置字段
| 字段 | 描述 |
|---|---|
| 逻辑名称 | 端口的内部标识符（例如「主端口」、「头部」）。在域内必须唯一。 |
| 端口类型 | 在当前版本的 MotioForge Studio 中始终为串行端口（USB/COM）。 |
| 协议 | 所连接硬件使用的通信协议。参见下方的协议表。 |
| 控制板 | 在此端口上运行 DEIMOS 的控制板（例如 Arduino Mega 2560）。它决定哪些引脚存在、哪些被保留：参见控制板和保留引脚。旧版本创建的端口使用 Arduino Mega 2560。 |
| 串行设备（COM/tty） | 设备实际连接的端口，例如 Windows 上的 COM3 或 Linux 上的 /dev/ttyUSB0。 |
| 波特率 | 串行通信速度。使用 D4C 协议时固定为 115200，不能修改。 |
| 描述 | 关于端口的自由备注。可选。 |
可用协议
| 协议 | 典型用途 |
|---|---|
| D4C | DEIMOS 控制板（运行 DEIMOS 固件的 Arduino Mega）。在同一端口上控制总线舵机（ST3215 及同类产品）、直接引脚或 PCA9685（I2C）扩展板上的 PWM 舵机，以及开关输出。这是当前版本中唯一启用的协议。 |
查找正确的 COM 端口
在 Windows 上：打开设备管理器 → 端口 (COM 和 LPT)。 连接 USB 线后，控制器的名称就会出现在这里。 记下 COM 编号（例如 COM5），并填入「串行设备」字段。
保存和删除
- 保存：将更改应用到所选端口。
- 删除：删除所选端口。已分配到此端口的元素将失去连接。
- 保存并退出：保存所有待处理的更改并关闭编辑器。
开始播放前，MotioForge Studio 会自动打开域中配置的所有端口。
如果某个 COM 端口不可用，控制台中会显示警告。
控制板和保留引脚
为开关、PWM 舵机、触发按钮、导出到 DEIMOS SD 卡中的按钮或 参数化动画的传感器分配引脚时，ARES 会根据端口所连控制板的配置检查该引脚：
- 禁止使用：控制板上不存在该引脚、DEIMOS 自身占用、同一控制板上的其他元件已使用，或试图用仅输入引脚驱动输出；
- 需确认：可以谨慎使用（例如状态指示灯）。
Arduino Mega 2560（DEIMOS 2.0）
| 引脚 | 用途 | 结果 |
|---|---|---|
| 0、1 | 与电脑的 USB 连接（Serial0） | 禁止 |
| 16、17 | 串行舵机总线（Serial2） | 禁止 |
| 20、21 | I2C 总线（PCA9685） | 禁止 |
| 50、51、52、53 | SD 读卡器 | 禁止 |
| 13 | 状态指示灯（播放时点亮） | 需确认 |
| A0–A15（54–69） | 传感器用模拟输入 | 可用 |
ESP32 WROOM-32（临时配置）
ESP32 版 DEIMOS 固件尚不存在：外设暂按模块的标准引脚分配，待固件推出后确认。模拟输入读数为 0–4095：固件会将其换算为 0–1023。
| GPIO | 用途 | 结果 |
|---|---|---|
| 1、3 | 与电脑的 USB 连接 | 禁止 |
| 6–11 | 内部闪存 | 禁止 |
| 16、17 | 串行舵机总线 | 禁止 |
| 21、22 | I2C 总线 | 禁止 |
| 5、18、19、23 | SD 读卡器 | 禁止 |
| 2 | 状态指示灯 | 需确认 |
| 0、12、15 | 启动引脚：外接电路可能导致无法启动 | 需确认 |
| 34–39 | 仅输入，无内部上拉 | 不能用作输出；用作按钮需外接电阻 |
| 36、39、32、33、34、35 | 开启 Wi-Fi 时可用的模拟输入 | 用于传感器 |
使用 DEIMOS 2.0 或更高版本时，控制板会在启动时报告自身型号（board=mega2560）：如果与端口的控制板字段不符，
ARES 会在运行动画时提示。