XGO-DuckWiki 首页
Wiki 首页/XGO-Duck/开发者图文指南
XGO-Duck 知识库开发者图文指南

第四步:终端配置与启动

适用版本XGO-Duck 基础版

第三步初始化结束并停止应用后,在 UNO Q 的 Linux 终端中准备 Bridge、设置 Router,再启动应用。提前准备第一步设置的开发板登录密码。

4.1 打开 Duck 终端

在 App Lab 左下角点击终端按钮,打开开发板终端。提示符通常类似 arduino@xgo-duck:~$;以下命令均在 Duck 终端执行。

点击 App Lab 左下角的终端按钮,打开 arduino@xgo-duck 终端
点击 App Lab 左下角的终端按钮,打开 arduino@xgo-duck 终端

4.2 进入 App 目录

进入 ~/ArduinoApps/ 下实际导入的应用文件夹,例如:

cd ~/ArduinoApps/xgoduck_runtime

目录名可能不同,可输入部分名称后按 Tab 补全。若提示目录不存在,先核对实际文件夹名,不要继续执行后面的命令。

进入 ArduinoApps 下的应用目录,截图使用 xgoduck_app 作为目录名称
进入 ArduinoApps 下的应用目录,截图使用 xgoduck_app 作为目录名称

4.3 准备 Bridge

确认位于应用目录,执行下面的命令,等待完成并返回提示符:

python3 tools/prepare-bridge.py

4.4 设置 Router

继续执行:

sudo bash tools/router-2m.sh

出现密码提示时,输入开发板 Linux 登录密码并按 Enter。输入过程不显示字符或星号是正常现象。

依次执行 prepare-bridge.py 和 router-2m.sh,终端提示输入 arduino 的密码
依次执行 prepare-bridge.py 和 router-2m.sh,终端提示输入 arduino 的密码

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

Router 设置输出进入分页界面,底部出现 END 时按 q
Router 设置输出进入分页界面,底部出现 END 时按 q
按 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 初始化。

终端显示进度 100% 和 App XGO Duck started successfully
终端显示进度 100% 和 App XGO Duck started successfully

4.6 等待依赖更新与加载

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

XGO Duck 已运行,Python 日志中继续下载应用所需依赖
XGO Duck 已运行,Python 日志中继续下载应用所需依赖

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

返回 XGO-Duck 知识库目录