MRRC FT-710
软件设计说明书

用于记录 FT-710 网页控制系统的架构、接口、运行模型与版本演进, 作为实现与设计的一致性基线文档。

浏览 SDD 章节 返回产品页面

SDD 范围

IBM TeamSD 对齐,15 章,内容基于实际代码状态。

属性
文档 IDSDD-MRRC-FT710-2026-001
版本V2.18
基线日期2026-08-16
后端运行时Python 3.12+, FastAPI, Uvicorn, PyAudio, NumPy
前端技术HTML5, CSS3, 原生 JavaScript, Web Audio API
核心接口4 路 WebSocket + 串口 CAT + FT4222 SPI + USB 音频

V2.18 变更重点

原生 Android 客户端

新增 FT710Android/ 子项目(Kotlin + Jetpack Compose,minSdk 26):4+1 路 WebSocket,NDK 构建 libopus,DataStore + Keystore 凭据——功能全量对齐 Web 前端(控制、RX/TX 音频、频谱、仪表、记忆频道、可选 ATR1000)。

PTT 安全原生设计

纯 Kotlin PTTManager 状态机:仅连接就绪时按下,手势 finally 释放,500ms 看门狗 + onStuckTX,生命周期 onStop 强制释放——iOS P0 竞态在设计层规避而非事后修补。

Web 界面精简

瀑布/FFT 画布紧凑化(移动端 45/22px,桌面 80/40px);页面随内容滚动(移除固定视口);RF Gain 滑杆从主控制区移入菜单「设置」。

Android 验证

33 个 JVM 单测全绿;./gradlew test assembleDebug lintDebug 通过;APK 内置 NDK libopus。设计文档与 19 任务计划标记完成;真机验收待用户设备。

SDD 15 章

AD-001 ... AD-015

AD-001 FastAPI/Uvicorn AD-002 直连 CAT AD-003 脏字段广播 AD-004 Opus/PCM 标签流 AD-005 scope_pipe 隔离 AD-006 双模式频谱 AD-007 PTT 安全流程 AD-008 音频设备自动检测 AD-009 7 任务轮询 AD-010 JSON 记忆信道 AD-011 48kHz 编解码 + 44.1kHz 桥接 AD-012 Active-VFO 跟踪 AD-013 表头校准 AD-014 CAT 勘误处理 AD-015 优先级 CAT 抢占