一、前言FT_SCServo_Debug_Qt 是一款基于 Qt 开发的飞特 Feetech SCS/STS 系列总线舵机专用调试上位机专为 LinuxUbuntu平台设计完美适配嵌入式开发、机器人舵机调试场景。官方提供 AMD64 / ARM64 预编译 deb 安装包理论上可一键安装但在实际 Ubuntu22.04 安装过程中会遇到APT 沙盒权限警告、安装成功但命令找不到、deb 包安装残缺、程序本体缺失等一系列隐性BUG。本文结合真实踩坑经历整理两套可用安装方案快速源码编译修复版deb安装彻底解决所有安装报错零基础可直接复刻操作。适配环境系统Ubuntu 22.04AMD64 / ARM64 通用开发依赖Qt5.14 / Qt5.15硬件适配飞特 SCS/STS 全系列串行总线舵机必备硬件驱动CH340 串口驱动已知软件限制v1.1.0 最新版当前版本暂未开发以下功能无对应操作入口固件升级Upgrade标签及功能PWM 调节标签及相关功能二、前置必备配置所有安装方式必做舵机调试核心依赖串口通信Ubuntu 默认普通用户无串口权限不配置会导致软件识别不到设备、通信失败。1. 配置串口权限# 将当前用户加入串口拨号组sudousermod-aGdialout$USER# 权限即时生效无需注销重启newgrp dialout2. 验证串口设备插入 CH340 舵机调试板执行以下命令正常会输出 ttyUSB 设备ls/dev/ttyUSB*三、踩坑复盘重点官方deb安装通病很多用户按照官方文档安装 deb 包后会出现以下现象也是本文核心解决的问题安装过程无报错显示成功配置软件终端提示无法被用户_apt访问已脱离沙盒并提权权限警告输入启动命令提示未找到命令系统仅保留 dpkg 安装记录无任何程序本体文件软链接失效故障根源在家目录/home/xxx下执行 deb 安装APT 沙盒用户_apt无读取权限导致安装流程虚假完成仅注册记录未解压程序文件最终软件无法启动。四、方案一源码编译安装推荐稳定无BUG彻底规避 deb 打包缺陷无权限报错、无文件缺失问题适合长期使用、二次开发优先推荐。步骤1安装全套编译依赖sudoaptupdatesudoaptinstall-ylibqt5serialport5 libqt5serialport5-dev qt5-qmake g cmakegit步骤2拉取官方源码仓库gitclone https://github.com/Kotakku/FT_SCServo_Debug_Qt.gitcdFT_SCServo_Debug_Qt步骤3Qt 编译构建# 生成编译配置文件qmake.# 多线程编译加速编译过程make-j$(nproc)步骤4启动软件两种方式方式1目录内直接启动默认./FT_SCServo_Debug_Qt方式2配置全局命令任意终端可启动# 复制程序到系统全局目录sudocp./FT_SCServo_Debug_Qt /usr/local/bin/ft-scservo-debug-qt# 全局启动ft-scservo-debug-qt五、方案二修复版 deb 包一键安装官方方案改良保留官方一键安装的便捷性修复沙盒权限报错问题适合不想编译源码的用户。步骤1彻底清理残缺旧安装# 彻底卸载残留安装记录sudoaptpurge-yft-scservo-debug-qt# 清理无用依赖sudoaptautoremove-y步骤2临时目录重新安装规避权限BUG核心修复将 deb 包放入无权限限制的 /tmp 目录安装彻底解决沙盒访问失败问题。# 进入临时目录cd/tmp# AMD64 台式机/笔记本 执行wgethttps://github.com/Kotakku/FT_SCServo_Debug_Qt/releases/download/v1.1.0/ft-scservo-debug-qt_1.1.0_amd64.debsudoaptinstall./ft-scservo-debug-qt_1.1.0_amd64.deb# ARM64 树莓派/飞腾开发板 执行# wget https://github.com/Kotakku/FT_SCServo_Debug_Qt/releases/download/v1.1.0/ft-scservo-debug-qt_1.1.0_arm64.deb# sudo apt install ./ft-scservo-debug-qt_1.1.0_arm64.deb步骤3验证并配置全局启动# 查看程序是否安装成功ls/opt/ft-scservo-debug-qt/# 创建全局软链接sudoln-s/opt/ft-scservo-debug-qt/ft-scservo-debug-qt /usr/local/bin/ft-scservo-debug-qt# 启动软件ft-scservo-debug-qt六、Docker 自行打包deb开发者专用如需自行编译生成适配本机架构的 deb 安装包可使用官方 Docker 打包脚本普通用户无需操作gitclone https://github.com/Kotakku/FT_SCServo_Debug_Qt.gitcdFT_SCServo_Debug_Qt/debbashcreate_deb.bash执行完成后deb 安装包将生成在 deb 目录下可按照方案二方式安装。七、常见问题终极排查1. 命令未找到、软链接失效原因deb 安装残缺程序本体缺失。解决卸载残留记录改用源码编译方案。2. 软件打开无串口解决重新执行串口权限配置命令或注销用户重新登录。3. apt 沙盒权限警告解决不要在 /home 家目录安装 deb必须放入 /tmp 临时目录执行安装。4. 编译提示 qmake 命令不存在解决重新执行依赖安装命令补全 qt5-qmake 组件。
一、前言FT_SCServo_Debug_Qt 是一款基于 Qt 开发的飞特 Feetech SCS/STS 系列总线舵机专用调试上位机专为 LinuxUbuntu平台设计完美适配嵌入式开发、机器人舵机调试场景。官方提供 AMD64 / ARM64 预编译 deb 安装包理论上可一键安装但在实际 Ubuntu22.04 安装过程中会遇到APT 沙盒权限警告、安装成功但命令找不到、deb 包安装残缺、程序本体缺失等一系列隐性BUG。本文结合真实踩坑经历整理两套可用安装方案快速源码编译修复版deb安装彻底解决所有安装报错零基础可直接复刻操作。适配环境系统Ubuntu 22.04AMD64 / ARM64 通用开发依赖Qt5.14 / Qt5.15硬件适配飞特 SCS/STS 全系列串行总线舵机必备硬件驱动CH340 串口驱动已知软件限制v1.1.0 最新版当前版本暂未开发以下功能无对应操作入口固件升级Upgrade标签及功能PWM 调节标签及相关功能二、前置必备配置所有安装方式必做舵机调试核心依赖串口通信Ubuntu 默认普通用户无串口权限不配置会导致软件识别不到设备、通信失败。1. 配置串口权限# 将当前用户加入串口拨号组sudousermod-aGdialout$USER# 权限即时生效无需注销重启newgrp dialout2. 验证串口设备插入 CH340 舵机调试板执行以下命令正常会输出 ttyUSB 设备ls/dev/ttyUSB*三、踩坑复盘重点官方deb安装通病很多用户按照官方文档安装 deb 包后会出现以下现象也是本文核心解决的问题安装过程无报错显示成功配置软件终端提示无法被用户_apt访问已脱离沙盒并提权权限警告输入启动命令提示未找到命令系统仅保留 dpkg 安装记录无任何程序本体文件软链接失效故障根源在家目录/home/xxx下执行 deb 安装APT 沙盒用户_apt无读取权限导致安装流程虚假完成仅注册记录未解压程序文件最终软件无法启动。四、方案一源码编译安装推荐稳定无BUG彻底规避 deb 打包缺陷无权限报错、无文件缺失问题适合长期使用、二次开发优先推荐。步骤1安装全套编译依赖sudoaptupdatesudoaptinstall-ylibqt5serialport5 libqt5serialport5-dev qt5-qmake g cmakegit步骤2拉取官方源码仓库gitclone https://github.com/Kotakku/FT_SCServo_Debug_Qt.gitcdFT_SCServo_Debug_Qt步骤3Qt 编译构建# 生成编译配置文件qmake.# 多线程编译加速编译过程make-j$(nproc)步骤4启动软件两种方式方式1目录内直接启动默认./FT_SCServo_Debug_Qt方式2配置全局命令任意终端可启动# 复制程序到系统全局目录sudocp./FT_SCServo_Debug_Qt /usr/local/bin/ft-scservo-debug-qt# 全局启动ft-scservo-debug-qt五、方案二修复版 deb 包一键安装官方方案改良保留官方一键安装的便捷性修复沙盒权限报错问题适合不想编译源码的用户。步骤1彻底清理残缺旧安装# 彻底卸载残留安装记录sudoaptpurge-yft-scservo-debug-qt# 清理无用依赖sudoaptautoremove-y步骤2临时目录重新安装规避权限BUG核心修复将 deb 包放入无权限限制的 /tmp 目录安装彻底解决沙盒访问失败问题。# 进入临时目录cd/tmp# AMD64 台式机/笔记本 执行wgethttps://github.com/Kotakku/FT_SCServo_Debug_Qt/releases/download/v1.1.0/ft-scservo-debug-qt_1.1.0_amd64.debsudoaptinstall./ft-scservo-debug-qt_1.1.0_amd64.deb# ARM64 树莓派/飞腾开发板 执行# wget https://github.com/Kotakku/FT_SCServo_Debug_Qt/releases/download/v1.1.0/ft-scservo-debug-qt_1.1.0_arm64.deb# sudo apt install ./ft-scservo-debug-qt_1.1.0_arm64.deb步骤3验证并配置全局启动# 查看程序是否安装成功ls/opt/ft-scservo-debug-qt/# 创建全局软链接sudoln-s/opt/ft-scservo-debug-qt/ft-scservo-debug-qt /usr/local/bin/ft-scservo-debug-qt# 启动软件ft-scservo-debug-qt六、Docker 自行打包deb开发者专用如需自行编译生成适配本机架构的 deb 安装包可使用官方 Docker 打包脚本普通用户无需操作gitclone https://github.com/Kotakku/FT_SCServo_Debug_Qt.gitcdFT_SCServo_Debug_Qt/debbashcreate_deb.bash执行完成后deb 安装包将生成在 deb 目录下可按照方案二方式安装。七、常见问题终极排查1. 命令未找到、软链接失效原因deb 安装残缺程序本体缺失。解决卸载残留记录改用源码编译方案。2. 软件打开无串口解决重新执行串口权限配置命令或注销用户重新登录。3. apt 沙盒权限警告解决不要在 /home 家目录安装 deb必须放入 /tmp 临时目录执行安装。4. 编译提示 qmake 命令不存在解决重新执行依赖安装命令补全 qt5-qmake 组件。
![[具身智能-181]：PC+服务器+具身机器人：构建具身智能从仿真到量产的闭环迭代混合架构](http://pic.xiahunao.cn/yaotu/[具身智能-181]：PC+服务器+具身机器人：构建具身智能从仿真到量产的闭环迭代混合架构)
