尧图网络 高端网站定制 · 原创设计
免费咨询热线
400-888-6620
免费获取方案
Ubuntu 完美安装 FT_SCServo_Debug_Qt 飞特SCS_STS舵机调试工具
一、前言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 组件。
RELATED

相关推荐

为什么你的通义千问-菜鸟集成总在预发环境崩溃?12类高频异常日志对照表+阿里云SRE团队应急checklist(2024最新版)

为什么你的通义千问-菜鸟集成总在预发环境崩溃?12类高频异常日志对照表+阿里云SRE团队应急checklist(2024最新版)

更多请点击: https://kaifayun.com 第一章:为什么你的通义千问-菜鸟集成总在预发环境崩溃? 预发环境作为生产前的最后一道防线,本应高度模拟线上行为,但大量团队反馈通义千问(Qwen)与菜鸟系统集…

📅 2026/9/8 18:46:52
Seedance2.0动态光影重绘实战:规避API兼容性三大陷阱

Seedance2.0动态光影重绘实战:规避API兼容性三大陷阱

1. 项目概述:当动态光影重绘遇上API兼容的“暗礁”最近在几个技术社区和项目复盘会上,一个现象被反复提及:尽管Seedance2.0动态光影重绘算法在技术演示和独立测试中表现惊艳,宣称能带来更真实、更高效的光影效果,但实际…

📅 2026/8/24 12:51:31
Cadence Allegro SPB 17.4 Visibility View:PCB设计效率提升与图层管理实战

Cadence Allegro SPB 17.4 Visibility View:PCB设计效率提升与图层管理实战

1. 项目概述:为什么我们需要Visibility View在Cadence Allegro SPB 17.4里画板子,最让人头疼的瞬间之一,可能就是面对一个密密麻麻、所有元素都堆叠在一起的PCB设计界面。你想检查一下电源层的铺铜形状,但顶层丝印、底层走线、过孔…

📅 2026/8/24 12:51:31
MORE NEWS

更多资讯

📰

7大类免费Blender资源去哪找?awesome-blender资源列表实战指南

7大类免费Blender资源去哪找?awesome-blender资源列表实战指南 【免费下载链接】awesome-blender 🪐 A curated list of awesome Blender addons, tools, tutorials; and 3D resources for everyone. 项目地址: https://gitcode.com/GitHub_Trending/a…

📰

GitAgent安全合规实战:密码保护、审计日志与SOC2/GDPR配置全解析

GitAgent安全合规实战:密码保护、审计日志与SOC2/GDPR配置全解析 【免费下载链接】opengap A framework-agnostic, git-native standard for defining AI agents 项目地址: https://gitcode.com/gh_mirrors/git/opengap GitAgent 是一个 git 原生的 AI Agent…

📰

PhotoPrism API 包开发指南:Gin 路由、鉴权、审计日志与上传安全的最佳实践

后端前端图像处理人工智能AI 应用 【免费下载链接】photoprism AI-Powered Photos App 🌈💎✨ 项目地址: https://gitcode.com/gh_mirrors/ph/photoprism 点击查看 免费下载 本文基于 PhotoPrism 仓库中 internal/api 包的 API 开发指南&…

📰

Pixelle-Video 快速上手指南:只输入一个主题,5 分钟生成完整 AI 短视频

Pixelle-Video 快速上手指南:只输入一个主题,5 分钟生成完整 AI 短视频 【免费下载链接】Pixelle-Video 🚀 AI 全自动短视频引擎 | AI Fully Automated Short Video Engine 项目地址: https://gitcode.com/GitHub_Trending/pi/Pixelle-Vide…

📰

G-Helper:一个EXE替代华硕奥创的轻量笔记本控制工具

G-Helper:一个EXE替代华硕奥创的轻量笔记本控制工具 【免费下载链接】g-helper Lightweight Armoury Crate alternative for Asus laptops with nearly the same functionality. Works with ROG Zephyrus, Flow, TUF, Strix, Scar, ProArt, Vivobook, Zenbook, Expe…

📰

大模型开发框架的演进趋势:从胶水层到标准化基础设施

大模型开发框架的演进趋势:从胶水层到标准化基础设施在大模型(LLM)与生成式 AI 应用爆发的初期,以 LangChain、LlamaIndex 为代表的开源开发框架迅速风靡全球。 在那个百家争鸣的探索阶段,这些框架的核心价值在于充当*…

TODAY

今日更新

THIS WEEK

本周精选

THIS MONTH

本月热门

读完文章,想聊聊您的网站?

告诉我们您的行业与需求,资深顾问一对一梳理方案与报价,全程免费。

📞 💬