SDD V1.6 · 2026-07-18

MRRC FT-710
软件设计说明书

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

SDD 范围

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

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

V1.6 变更重点

RX 零音频看门狗

服务端检测到位精确全零的 RX 音频(静噪开启下持续 ≥20 秒)即在状态栏亮出"无声"警告并写日志——电台 USB 音频卡死再也无法躲在 CBR 码率指示后面装正常。

鉴权失效自动跳登录

过期 token 的 WebSocket 握手被 HTTP 403 拒绝(浏览器只收到 1006,永远不是 4001)。控制通道现在先查 /api/auth/check,确认失效后跳转登录页,不再拿着死 token 无限重试。

死载波修复

TX 音频属主连接在发射中断开时,服务端现在强制 TX0——关闭了此前只能等控制通道断开的无调制载波窗口。

TX 音频文档归真

文档与运行时对齐:TX Opus 实为 64kbps CBR complexity=5;AD-011 重写——48kHz 编解码域经帧对齐桥接(960↔882)到 FT-710 原生 44.1kHz USB 音频。

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 抢占