SuperAPI AI 工具集

developing-with-orbs

部署与运维

查看项目

更新于 10-16 07:18

技能介绍

用途:当任务需要真实 Orb 硬件而非纯本地开发时使用本技能,覆盖设备访问、部署、硬件在环与 MCU 操作。

设备访问:SSH 用 ssh worldcoin@orb-1234.local,scp 使用同一主机名(如 scp ./local-file worldcoin@orb-1234.local:/tmp/local-file,反向同理);已知 IP 时可用 IP 替代 orb-1234.local。

部署:用 cargo x d 作为 cargo x deploy 的简写。先 export ORB_IP、export WORLDCOIN_PW,再执行 cargo x d <crate-name>;ORB_IP 可为 IP 或 Avahi 主机名。该命令会为 aarch64-unknown-linux-gnu 构建、生成 .deb、复制到 Orb 并重装;若 crate 声明了 systemd 单元,安装后会自动重启对应服务。仅暂存文件时优先用原始 scp。

HIL CLI:orb-hil 为硬件在环 CLI。运行时先 AWS_PROFILE=hil aws sso login,再用 AWS_PROFILE=hil cargo run -p orb-hil -- --help。注意 orb-hil flash 需 x86 Linux 机器,reboot 与 login 需串口适配器,cmd 可用串口或网络(如 SSH/Teleport);不要把 reboot/login 当作仅 SSH 的替代。

MCU 工具:orb-mcu-util 直接在设备上运行,支持 --can-fd。可查看信息(info、info --diag)、重启目标(reboot main/security/orb,支持 --delay)、设置重启行为、image update/switch/force-switch 更新与切换固件、dump 与 stress、power-cycle 及 ui、optics 相关操作。optics polarizer stress <speed> <repeat> 使用位置参数。更多用法执行 orb-mcu-util --help 及各子命令帮助。

权威来源:命令以 xtask/src/main.rs、xtask/src/cmd/deploy.rs、docs/src/hil/cli.md、hil/src/main.rs、mcu-util/src/main.rs 为准。