第三步初始化结束并停止应用后,在 UNO Q 的 Linux 终端中准备 Bridge、设置 Router,再启动应用。提前准备第一步设置的开发板登录密码。
4.1 打开 Duck 终端
在 App Lab 左下角点击终端按钮,打开开发板终端。提示符通常类似 arduino@xgo-duck:~$;以下命令均在 Duck 终端执行。

4.2 进入 App 目录
进入 ~/ArduinoApps/ 下实际导入的应用文件夹,例如:
cd ~/ArduinoApps/xgoduck_runtime
目录名可能不同,可输入部分名称后按 Tab 补全。若提示目录不存在,先核对实际文件夹名,不要继续执行后面的命令。

4.3 准备 Bridge
确认位于应用目录,执行下面的命令,等待完成并返回提示符:
python3 tools/prepare-bridge.py
4.4 设置 Router
继续执行:
sudo bash tools/router-2m.sh
出现密码提示时,输入开发板 Linux 登录密码并按 Enter。输入过程不显示字符或星号是正常现象。

如果输出进入底部显示 (END) 的分页界面,按小写 q 返回终端;若已直接返回提示符,则不需要按 q。


该运行时使用 2 Mbps Bridge 配置。主板库缓存被替换时需要重新准备;切换其他应用前也应核对 Router 通信要求。
4.5 启动 XGO Duck
可返回 App Lab 点击 Run,或在应用目录中通过终端启动:
arduino-app-cli app start "$PWD"
$PWD 表示当前目录,需保留大写字母和英文双引号。等待构建、上传和启动;出现 App "XGO Duck" started successfully 后继续检查 Python 初始化。

4.6 等待依赖更新与加载
回到 XGO Duck 应用,查看底部 Python 日志。首次启动可能继续创建环境并下载依赖;保持 USB 与网络连接,等待初始化完成。

若日志出现明确的下载失败或其他错误,先处理错误,再进入第五步:舵机设置与编号。
