拓冰网站定制 
Serial Studio FFT 音频导出把频谱分析器看到的时域信号录制为 WAV 的完整实现解读【免费下载链接】Serial-StudioOpen-source telemetry dashboard. Supports UART, BLE, MQTT, Modbus, CAN Bus and more.项目地址: https://gitcode.com/GitHub_Trending/se/Serial-StudioFFT以及 Waterfall频谱组件是 Serial Studio 中最重要的信号随时间变化媒体组件之一但它一直缺少与 ImageView 视频导出对等的产物用户实时观察振动、声学或生物医学信号的频谱会话一结束底层时域信号就消失了。Spec 0024 为 FFT/Waterfall 组件新增了音频录制输出能力——把喂给频谱分析的时域样本流原样写为 WAVPCM文件并针对 FFT 采样率远低于可听范围这一关键约束附带生成可听化倍速伴生文件。读完本文你将掌握该特性的需求边界、后台 WAV 写入架构、幅度映射规则、伴生文件算法以及它在 Serial Studio 中完整的 Pro 授权与热路径约束。本文以 spec.mdSpec 0024 第 1 阶段WHAT 与 WHY为骨架以 plan.md第 2 阶段技术设计及 AudioExport.cpp 等真实源码为佐证展开。背景与动机频谱看得见、留不下在 Serial Studio 中ImageView 组件可以把输入图像流通过一个工具栏开关直接导出为视频文件为 Pro 用户留下可分享的观察记录。而 FFT 组件——另一个信号随时间变化的媒体组件——却没有对等能力用户在实时分析振动、声学或生物医学信号时可以看到频谱但会话结束的那一刻底层时域信号就丢失了除非手工从 CSV 重建。这带来的实际痛点非常具体无法把坏轴承的声音直接交给同事听无法把捕获的信号导入 Audacity / MATLAB 作为音频处理每个 FFT 数据集其实已经声明了音频文件所需的两个事实——每窗口样本数与采样率项目可配置默认 100 Hz数据模型本就支持缺的只是输出路径。Spec 0024 由此立项。决定性的约束是FFT 采样率由用户选择且经常远低于可听/编码器支持范围因此导出必须在保留真实配置采样率保证分析正确性的同时产出一个常见工具都能打开的音频文件。范围界定做什么、不做什么目标Goals用户在任意 FFT 或 Waterfall 组件的工具栏上可以像 ImageView 切换视频导出一样一键开启/关闭音频录制录制期间喂给该组件的时域样本按到达顺序写入音频文件文件声明的采样率等于数据集配置的 FFT 采样率生成的文件能在常见音频工具Audacity、VLC、MATLAB/Python 读取器中打开采样率落在平台可播放范围内时可直接播放当配置采样率低于可听范围时额外生成一个可听预览伴生文件标准播放器以正常音量、加速播放即可聆听亚音频振动信号录制文件落在用户工作区目录树中按项目/按分组、时间戳文件名并提供工具栏快捷方式显示输出目录——与视频录制的 UX 契约一致该功能为 Pro 能力与 ImageView 视频导出采用相同的构建期与许可证门控。非目标Non-Goals不做声化或频谱重合成输出是录制的时域输入信号不是从 FFT 频点生成的音频不做真正的重采样或变调可听预览是纯加速同一批样本以更快的时钟重新解释不是插值重渲染录制期间不做实时监听/回放仅输出文件v1不提供压缩格式M4A/AAC仅 WAVPCM不改变FFT/Waterfall 的分析行为、窗函数或渲染回放文件/会话回放期间不录制——仅实时流与视频导出一致。需求体系R1–R10 分层解读Spec 0024 用 10 条需求精确定义了行为契约编号需求要点关键细节R1每个 FFT/Waterfall 组件在仪表盘工具栏显示录制开关与打开输出目录按钮可见/可用条件与 ImageView 导出控件一致商业构建 有效 Pro 许可证R2录制开启且数据实时流动时每个新时域样本按到达顺序、无间隙无重复地追加到每个组件每次录制会话恰一个文件文件数 组件数 × 会话数R3主音频文件为 WAVPCM头部采样率等于数据集配置的 FFT 采样率无论配置值是多少都不重采样R4样本幅度映射确定数据集声明 min/max 范围时值从该范围线性映射到满幅否则用运行峰值归一化保证录制永不削波R5配置采样率低于可听范围时结束录制额外生成一个可听WAV同一批样本乘以整数倍速因子使播放速率落入标准可听范围因子从文件名可见速率已可听的则不生成伴生文件R6关闭录制、暂停或断开设备时干净地终结文件有效头部、正确长度捕获到零样本的会话不留下文件R7再次开始录制则开启新的时间戳文件多个组件含绑定同一数据集的 FFT 与 Waterfall可同时录制互不干扰会话键互斥R8文件写入工作区目录树Audio Recordings/ 项目标题 / 分组标题 / 时间戳文件名工具栏快捷键在系统文件管理器中显示该目录与视频录制相同的工作区契约R9录制关闭时该特性对帧流水线零开销开启时不影响仪表盘渲染与解析吞吐文件 I/O 在 GUI 线程之外关闭态成本最多是一个缓存标志位检查R10GPL非商业构建不含该功能的任何痕迹无开关、无死 UI、无行为变化编译期剔除验收标准AC1–AC10 如何证明需求达成每个需求都有对应的可验证验收标准规格中全部标记为已完成[x]AC1实时会话如 rocket 演示或正弦波 TCP 源中FFT 组件开启录制并流约 10 秒产生 WAV 文件其样本数 ≈ 配置采样率 × 经过秒数±1 帧窗口用 Audacity 或 Pythonwave读取器验证R2/R3AC2WAV 头部的采样率字段等于数据集的fftSamplingRate至少验证两种配置速率如 100 Hz 与 8000 HzR3AC3向声明了 min/max 范围的数据集喂满幅正弦录得的波形满幅且不削波同一信号在无 min/max 时得到不削波、峰值归一化的波形R4AC4100 Hz 录制结束生成可听伴生 WAV其声明速率落在标准可听范围内、样本数等于主文件8 kHz 录制不生成伴生文件R5AC5录制中途断开设备留下的文件 Audacity 打开无修复提示无数据时开关切换不留下文件R6AC6FFT 与 Waterfall 同时录制同一数据集产生相互独立的文件各自匹配数据集采样率与自身经过样本数R1/R7AC7文件出现在工作区 Audio Recordings 树中工具栏按钮可显示该目录R8AC8--benchmark-hotpath在功能编译进且关闭状态下通过R9AC9打开 CSV/会话回放且录制开启时不产生文件非目标 / 与视频导出对齐AC10GPL 构建编译通过且 FFT/Waterfall 工具栏不显示录制控件R10。技术设计源码级的HOWplan.md 将整体方案概括为一句话一个新的商业专用Widgets::AudioExport单例在结构上镜像Widgets::ImageExportDataModel::FrameConsumer 工作线程但在工作线程通过QFile直接写普通 WAVfloat32 PCM而不是走 Qt Multimedia——因为WAV 是唯一能接受默认 100 Hz FFT 采样率的容器且顺带消灭了编码器依赖问题。采集点选择ingest-tap摄入点取样样本在唯一无间隙的位置被捕获Dashboard::updateFftSeries/updateWaterfallSeries的摄入点。plan.md 对比了三种方案方案缺陷Widget-delta每 UI tick 读环形缓冲尾当帧数/UI tick 超过环形容量时静默丢样本fftSamples默认25660 Hz 刷新下约 15 kHz 就会溢出Builder-tapFrameBuilder数据集钩子位于解析热路径本体上无收益Ingest-tap采纳在p.buf-push(*p.value)的同一位置每个SeriesPush携带商业编译保护的record标志 sessionKeyarmed 时调用AudioExport::enqueueSample(key, value)要点关闭态成本只是每个 push 条目一次bool测试标志就在已遍历的SeriesPush结构里无新查找、无 map、无信号跳转armed 态成本是一次 8 字节 POD 的try_enqueue进入预分配的 moodycamel SPSC 队列——无分配、无锁、无 Frame 拷贝。后台写入FrameConsumer 脊梁 工作线程AudioExport继承自DataModel::FrameConsumerAudioExportItem, DataModel::IBlockSinkAudioExport.h其单例构造时配置队列{queueCapacity 65536, flushThreshold 4096, timerIntervalMs 33}AudioExport.cpp并启动AudioExportWorker工作线程。数据流为FrameBuilder → Dashboard::hotpathRxFrame → updateDashboardData → updateFftSeries / updateWaterfallSeries └─ 每个 SeriesPush: p.buf-push(*p.value); 若 p.record AudioExport::enqueueSample(p.sessionKey, *p.value) ← 无锁 SPSC 入队 ↓ moodycamel 队列FrameConsumer 脊梁 AudioExportWorker::processItems [工作线程, 33 ms / 4096 项批量排空] └─ 每个会话: 追加 float32 → 会话 QFile closeSession → finalize: 补丁 WAV 头部; 若峰值归一化则一次重缩放; 若速率 8000 Hz 则生成伴生 WAV同数据块, 头部速率 速率 × 因子; 零样本文件删除其中AudioExportItem是仅 8 字节的 POD{float value; quint32 sessionKey;}AudioExport.h。队列容量 65536 可以吸收 48 kHz × 40 秒的工作线程停滞溢出采用计数 警告而非阻塞生产者阻塞 GUI 线程于磁盘 I/O 是被禁止的。WAV 写入细节float32 PCM 与占位头部工作线程的 WAV 写出逻辑非常直白且稳健AudioExport.cpp格式单声道channels1、32 位bits32、format tag 3IEEE float、blockAlign4、byteRate sampleRate × 4打开即写 44 字节占位头部RIFF size 与 data size 先填 0随后每次 flush 批次就地补丁RIFF/data 大小RIFF size 偏移 4、data size 偏移 40——即使异常中断留下的文件也能被 Audacity 直接打开finalize 做权威补丁并写回文件末尾位置。选择 float32 PCM 而非 int16 的理由确定性映射无需抖动/量化决策Audacity/MATLAB/Python 原生支持finalize 重缩放精确无误差且 4 字节/样本在这些速率下开销可忽略。幅度映射R4scale 模式与运行峰值归一化processItems中每个样本先做幅度映射AudioExport.cppscale 模式数据集声明 min/max即useScaletruenorm (value - center) / halfRange再clamp(norm, -1.0, 1.0)——满幅正弦映射为满幅且不削波回退模式无 min/max样本以原始 float32 落盘同时维护runningPeakfinalize 时做一次确定性重缩放增益为kHeadroomFullScale / runningPeak其中kHeadroomFullScale 0.891250938f即10^(-1/20)约 1 dB headroom。选择finalize 一次性重缩放而非流式运行增益的关键原因流式增益会把响度斜坡烘焙进文件非确定性且违反 R4而对最多几分钟的 float32 数据做一遍线性遍历在关闭时刻成本可忽略。可听化伴生文件R5纯整数倍速当sampleRate kAudibleFloorHz8000 Hz时finalize 会生成伴生文件AudioExport.cpp倍速因子factor ceil(8000 / sampleRate)100 Hz → 80x8 kHz 恰好不需伴生伴生文件路径为主文件基名-audible-因子x.wav因子从文件名直接可见伴生文件头部采样率 sampleRate × factor数据块与主文件完全共享逐块拷贝因此样本数相同、时长缩短 factor 倍。这不是重采样也不是变调而是同一批样本在更快的时钟上重新解释——纯加速保证了分析正确性与可听性两全。会话生命周期与自动停止FFTPlot 暴露audioRecordingEnabled属性商业编译保护setter 的启用路径为FFTPlot.cpp运行时检查Core::License::activated()Pro 许可未激活直接拒绝用构造函数已解析的m_samplingRate、m_scaleIsValid、m_center、m_halfRange及数据集/项目标题组装AudioSessionConfigAudioExport::openSession(kind, index, cfg)经Qt::QueuedConnection把配置投递到工作线程复用setSnapshotIntervalMs先例Dashboard::setFftAudioTap(index, true, sessionKey)armed 摄入点关闭路径则先 disarm 再 closeSession。会话键为(kind 16) | index的 32 位打包值AudioExport.cpp因此同一数据集上的 FFT 与 Waterfall 可各自独立录制AC6。setupExternalConnectionsAudioExport.cpp把以下外部条件全部接入closeAllSessions()ConnectionManager::connectedChanged断开连接与pausedChanged暂停CSV / MDF4 / Sessions 三个播放器的openChanged回放开始LicenseStateChanged许可证失效。回放必须提前 disarm 的原因回放帧会重新进入hotpathRxFrame而逐样本轮询播放器是否打开违反缓存标志规则必须由会话关闭信号一次性解决。组件析构也会关闭会话仪表盘重建销毁组件时不会留下指向重索引组件的悬挂 tap。输出路径与工作区树R8输出路径由audioPath()解析AudioExport.cppWorkspaceManager.path(Audio Recordings) / sanitize(项目标题) / sanitize(数据集标题) / yyyy-MM-dd_HH-mm-ss-zzz-kindindex.wav其中kind取fft/waterfall之一AudioExport.cpp避免同标题 tab 之间文件名冲突。QML 侧打开输出目录按钮调用Cpp_Audio_Export.audioPath(...)FFTPlot 的recordingsFolder()会实时用当前数据集标题解析目录因此数据集重命名后仍能定位正确的录制文件夹FFTPlot.cpp。许可证门控R10双重剔除该特性遵循与 ImageView 视频导出完全一致的双门控构建期AudioExport位于ModuleManager的BUILD_COMMERCIAL块GPL 构建不编译相关源码、不注册Cpp_Audio_Export上下文属性运行时C setter 检查Core::License::activated()QML 按钮checked: Cpp_CommercialBuild root.model.audioRecordingEnabled且可见性受Cpp_CommercialBuild约束见 FFTPlot.qml 与 Waterfall.qml。因此 GPL 构建中工具栏不渲染任何控件、无死 UI、无符号残留。约束与不变量Pro-only构建期商业构建 运行时有效许可证双门控包括晚激活/离线激活的重新推导零新第三方依赖视频导出与音频 I/O 已就绪的媒体/输出基础设施必须够用不回归 256 kHz 热路径 CI 门槛关闭态对帧流水线的成本最多是一次缓存标志检查GUI 线程禁止文件 I/O 与编码仪表盘帧路径零新增分配录制生命周期跟随视频导出先例断开/暂停自动停止播放器/回放会话打开时保持惰性项目模式边界开关是运行时控件除视频导出开关已持久化的范围外不写入项目状态。如何验证与实测规格给出了可复现的实测路径速率正确性AC1/AC2用 rocket 演示或正弦波 TCP 源在 FFT 组件开启录制约 10 秒用 Pythonwave或 Audacity 检查样本数 ≈ 采样率 × 秒数、头部速率等于fftSamplingRate分别验证 100 Hz 与 8000 Hz幅度映射AC3向声明了 min/max 的数据集喂满幅正弦检查满幅不削波对无范围数据集检查峰值归一化峰值 ≈ 0.891即 1 dB headroom伴生文件AC4100 Hz 录制结束应得到-audible-80x.wav头部速率 8000 Hz、样本数同主文件8 kHz 录制无伴生生命周期AC5–AC7中途断连后文件可被 Audacity 直接打开无数据开关切换不落盘FFT Waterfall 同数据集并行录制产出两个独立文件文件出现在工作区 Audio Recordings 树中且按钮可显示目录性能与门控AC8–AC10--benchmark-hotpath通过录制关闭态回放开启录制不产文件GPL 构建编译通过且工具栏无录制控件。小结Spec 0024 解决的是一类非常典型的产品空白分析能力已就绪、数据模型已声明必要参数唯独缺一条把观察变成可分享产物的输出路径。它的设计决策值得借鉴——用 WAV float32 PCM 规避编码器对低采样率的限制用 ingest-tap 在保证无间隙采样的同时把热路径成本压到一次布尔检查用同一数据块换头部速率的伴生文件在不做重采样的前提下让亚音频信号可以被耳朵验证再用双门控保证免费版零残留。从 spec.md 的需求定义到 plan.md 的技术设计与 AudioExport.cpp 的落地实现这套WHAT → HOW → 源码的链条清晰完整也可作为理解 Serial Studio 视频导出ImageView.cpp与工作区产物管理WorkspaceManager.cpp的参照入口。【免费下载链接】Serial-StudioOpen-source telemetry dashboard. Supports UART, BLE, MQTT, Modbus, CAN Bus and more.项目地址: https://gitcode.com/GitHub_Trending/se/Serial-Studio创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Serial Studio FFT 音频导出：把频谱分析器看到的时域信号录制为 WAV 的完整实现解读
Serial Studio FFT 音频导出把频谱分析器看到的时域信号录制为 WAV 的完整实现解读【免费下载链接】Serial-StudioOpen-source telemetry dashboard. Supports UART, BLE, MQTT, Modbus, CAN Bus and more.项目地址: https://gitcode.com/GitHub_Trending/se/Serial-StudioFFT以及 Waterfall频谱组件是 Serial Studio 中最重要的信号随时间变化媒体组件之一但它一直缺少与 ImageView 视频导出对等的产物用户实时观察振动、声学或生物医学信号的频谱会话一结束底层时域信号就消失了。Spec 0024 为 FFT/Waterfall 组件新增了音频录制输出能力——把喂给频谱分析的时域样本流原样写为 WAVPCM文件并针对 FFT 采样率远低于可听范围这一关键约束附带生成可听化倍速伴生文件。读完本文你将掌握该特性的需求边界、后台 WAV 写入架构、幅度映射规则、伴生文件算法以及它在 Serial Studio 中完整的 Pro 授权与热路径约束。本文以 spec.mdSpec 0024 第 1 阶段WHAT 与 WHY为骨架以 plan.md第 2 阶段技术设计及 AudioExport.cpp 等真实源码为佐证展开。背景与动机频谱看得见、留不下在 Serial Studio 中ImageView 组件可以把输入图像流通过一个工具栏开关直接导出为视频文件为 Pro 用户留下可分享的观察记录。而 FFT 组件——另一个信号随时间变化的媒体组件——却没有对等能力用户在实时分析振动、声学或生物医学信号时可以看到频谱但会话结束的那一刻底层时域信号就丢失了除非手工从 CSV 重建。这带来的实际痛点非常具体无法把坏轴承的声音直接交给同事听无法把捕获的信号导入 Audacity / MATLAB 作为音频处理每个 FFT 数据集其实已经声明了音频文件所需的两个事实——每窗口样本数与采样率项目可配置默认 100 Hz数据模型本就支持缺的只是输出路径。Spec 0024 由此立项。决定性的约束是FFT 采样率由用户选择且经常远低于可听/编码器支持范围因此导出必须在保留真实配置采样率保证分析正确性的同时产出一个常见工具都能打开的音频文件。范围界定做什么、不做什么目标Goals用户在任意 FFT 或 Waterfall 组件的工具栏上可以像 ImageView 切换视频导出一样一键开启/关闭音频录制录制期间喂给该组件的时域样本按到达顺序写入音频文件文件声明的采样率等于数据集配置的 FFT 采样率生成的文件能在常见音频工具Audacity、VLC、MATLAB/Python 读取器中打开采样率落在平台可播放范围内时可直接播放当配置采样率低于可听范围时额外生成一个可听预览伴生文件标准播放器以正常音量、加速播放即可聆听亚音频振动信号录制文件落在用户工作区目录树中按项目/按分组、时间戳文件名并提供工具栏快捷方式显示输出目录——与视频录制的 UX 契约一致该功能为 Pro 能力与 ImageView 视频导出采用相同的构建期与许可证门控。非目标Non-Goals不做声化或频谱重合成输出是录制的时域输入信号不是从 FFT 频点生成的音频不做真正的重采样或变调可听预览是纯加速同一批样本以更快的时钟重新解释不是插值重渲染录制期间不做实时监听/回放仅输出文件v1不提供压缩格式M4A/AAC仅 WAVPCM不改变FFT/Waterfall 的分析行为、窗函数或渲染回放文件/会话回放期间不录制——仅实时流与视频导出一致。需求体系R1–R10 分层解读Spec 0024 用 10 条需求精确定义了行为契约编号需求要点关键细节R1每个 FFT/Waterfall 组件在仪表盘工具栏显示录制开关与打开输出目录按钮可见/可用条件与 ImageView 导出控件一致商业构建 有效 Pro 许可证R2录制开启且数据实时流动时每个新时域样本按到达顺序、无间隙无重复地追加到每个组件每次录制会话恰一个文件文件数 组件数 × 会话数R3主音频文件为 WAVPCM头部采样率等于数据集配置的 FFT 采样率无论配置值是多少都不重采样R4样本幅度映射确定数据集声明 min/max 范围时值从该范围线性映射到满幅否则用运行峰值归一化保证录制永不削波R5配置采样率低于可听范围时结束录制额外生成一个可听WAV同一批样本乘以整数倍速因子使播放速率落入标准可听范围因子从文件名可见速率已可听的则不生成伴生文件R6关闭录制、暂停或断开设备时干净地终结文件有效头部、正确长度捕获到零样本的会话不留下文件R7再次开始录制则开启新的时间戳文件多个组件含绑定同一数据集的 FFT 与 Waterfall可同时录制互不干扰会话键互斥R8文件写入工作区目录树Audio Recordings/ 项目标题 / 分组标题 / 时间戳文件名工具栏快捷键在系统文件管理器中显示该目录与视频录制相同的工作区契约R9录制关闭时该特性对帧流水线零开销开启时不影响仪表盘渲染与解析吞吐文件 I/O 在 GUI 线程之外关闭态成本最多是一个缓存标志位检查R10GPL非商业构建不含该功能的任何痕迹无开关、无死 UI、无行为变化编译期剔除验收标准AC1–AC10 如何证明需求达成每个需求都有对应的可验证验收标准规格中全部标记为已完成[x]AC1实时会话如 rocket 演示或正弦波 TCP 源中FFT 组件开启录制并流约 10 秒产生 WAV 文件其样本数 ≈ 配置采样率 × 经过秒数±1 帧窗口用 Audacity 或 Pythonwave读取器验证R2/R3AC2WAV 头部的采样率字段等于数据集的fftSamplingRate至少验证两种配置速率如 100 Hz 与 8000 HzR3AC3向声明了 min/max 范围的数据集喂满幅正弦录得的波形满幅且不削波同一信号在无 min/max 时得到不削波、峰值归一化的波形R4AC4100 Hz 录制结束生成可听伴生 WAV其声明速率落在标准可听范围内、样本数等于主文件8 kHz 录制不生成伴生文件R5AC5录制中途断开设备留下的文件 Audacity 打开无修复提示无数据时开关切换不留下文件R6AC6FFT 与 Waterfall 同时录制同一数据集产生相互独立的文件各自匹配数据集采样率与自身经过样本数R1/R7AC7文件出现在工作区 Audio Recordings 树中工具栏按钮可显示该目录R8AC8--benchmark-hotpath在功能编译进且关闭状态下通过R9AC9打开 CSV/会话回放且录制开启时不产生文件非目标 / 与视频导出对齐AC10GPL 构建编译通过且 FFT/Waterfall 工具栏不显示录制控件R10。技术设计源码级的HOWplan.md 将整体方案概括为一句话一个新的商业专用Widgets::AudioExport单例在结构上镜像Widgets::ImageExportDataModel::FrameConsumer 工作线程但在工作线程通过QFile直接写普通 WAVfloat32 PCM而不是走 Qt Multimedia——因为WAV 是唯一能接受默认 100 Hz FFT 采样率的容器且顺带消灭了编码器依赖问题。采集点选择ingest-tap摄入点取样样本在唯一无间隙的位置被捕获Dashboard::updateFftSeries/updateWaterfallSeries的摄入点。plan.md 对比了三种方案方案缺陷Widget-delta每 UI tick 读环形缓冲尾当帧数/UI tick 超过环形容量时静默丢样本fftSamples默认25660 Hz 刷新下约 15 kHz 就会溢出Builder-tapFrameBuilder数据集钩子位于解析热路径本体上无收益Ingest-tap采纳在p.buf-push(*p.value)的同一位置每个SeriesPush携带商业编译保护的record标志 sessionKeyarmed 时调用AudioExport::enqueueSample(key, value)要点关闭态成本只是每个 push 条目一次bool测试标志就在已遍历的SeriesPush结构里无新查找、无 map、无信号跳转armed 态成本是一次 8 字节 POD 的try_enqueue进入预分配的 moodycamel SPSC 队列——无分配、无锁、无 Frame 拷贝。后台写入FrameConsumer 脊梁 工作线程AudioExport继承自DataModel::FrameConsumerAudioExportItem, DataModel::IBlockSinkAudioExport.h其单例构造时配置队列{queueCapacity 65536, flushThreshold 4096, timerIntervalMs 33}AudioExport.cpp并启动AudioExportWorker工作线程。数据流为FrameBuilder → Dashboard::hotpathRxFrame → updateDashboardData → updateFftSeries / updateWaterfallSeries └─ 每个 SeriesPush: p.buf-push(*p.value); 若 p.record AudioExport::enqueueSample(p.sessionKey, *p.value) ← 无锁 SPSC 入队 ↓ moodycamel 队列FrameConsumer 脊梁 AudioExportWorker::processItems [工作线程, 33 ms / 4096 项批量排空] └─ 每个会话: 追加 float32 → 会话 QFile closeSession → finalize: 补丁 WAV 头部; 若峰值归一化则一次重缩放; 若速率 8000 Hz 则生成伴生 WAV同数据块, 头部速率 速率 × 因子; 零样本文件删除其中AudioExportItem是仅 8 字节的 POD{float value; quint32 sessionKey;}AudioExport.h。队列容量 65536 可以吸收 48 kHz × 40 秒的工作线程停滞溢出采用计数 警告而非阻塞生产者阻塞 GUI 线程于磁盘 I/O 是被禁止的。WAV 写入细节float32 PCM 与占位头部工作线程的 WAV 写出逻辑非常直白且稳健AudioExport.cpp格式单声道channels1、32 位bits32、format tag 3IEEE float、blockAlign4、byteRate sampleRate × 4打开即写 44 字节占位头部RIFF size 与 data size 先填 0随后每次 flush 批次就地补丁RIFF/data 大小RIFF size 偏移 4、data size 偏移 40——即使异常中断留下的文件也能被 Audacity 直接打开finalize 做权威补丁并写回文件末尾位置。选择 float32 PCM 而非 int16 的理由确定性映射无需抖动/量化决策Audacity/MATLAB/Python 原生支持finalize 重缩放精确无误差且 4 字节/样本在这些速率下开销可忽略。幅度映射R4scale 模式与运行峰值归一化processItems中每个样本先做幅度映射AudioExport.cppscale 模式数据集声明 min/max即useScaletruenorm (value - center) / halfRange再clamp(norm, -1.0, 1.0)——满幅正弦映射为满幅且不削波回退模式无 min/max样本以原始 float32 落盘同时维护runningPeakfinalize 时做一次确定性重缩放增益为kHeadroomFullScale / runningPeak其中kHeadroomFullScale 0.891250938f即10^(-1/20)约 1 dB headroom。选择finalize 一次性重缩放而非流式运行增益的关键原因流式增益会把响度斜坡烘焙进文件非确定性且违反 R4而对最多几分钟的 float32 数据做一遍线性遍历在关闭时刻成本可忽略。可听化伴生文件R5纯整数倍速当sampleRate kAudibleFloorHz8000 Hz时finalize 会生成伴生文件AudioExport.cpp倍速因子factor ceil(8000 / sampleRate)100 Hz → 80x8 kHz 恰好不需伴生伴生文件路径为主文件基名-audible-因子x.wav因子从文件名直接可见伴生文件头部采样率 sampleRate × factor数据块与主文件完全共享逐块拷贝因此样本数相同、时长缩短 factor 倍。这不是重采样也不是变调而是同一批样本在更快的时钟上重新解释——纯加速保证了分析正确性与可听性两全。会话生命周期与自动停止FFTPlot 暴露audioRecordingEnabled属性商业编译保护setter 的启用路径为FFTPlot.cpp运行时检查Core::License::activated()Pro 许可未激活直接拒绝用构造函数已解析的m_samplingRate、m_scaleIsValid、m_center、m_halfRange及数据集/项目标题组装AudioSessionConfigAudioExport::openSession(kind, index, cfg)经Qt::QueuedConnection把配置投递到工作线程复用setSnapshotIntervalMs先例Dashboard::setFftAudioTap(index, true, sessionKey)armed 摄入点关闭路径则先 disarm 再 closeSession。会话键为(kind 16) | index的 32 位打包值AudioExport.cpp因此同一数据集上的 FFT 与 Waterfall 可各自独立录制AC6。setupExternalConnectionsAudioExport.cpp把以下外部条件全部接入closeAllSessions()ConnectionManager::connectedChanged断开连接与pausedChanged暂停CSV / MDF4 / Sessions 三个播放器的openChanged回放开始LicenseStateChanged许可证失效。回放必须提前 disarm 的原因回放帧会重新进入hotpathRxFrame而逐样本轮询播放器是否打开违反缓存标志规则必须由会话关闭信号一次性解决。组件析构也会关闭会话仪表盘重建销毁组件时不会留下指向重索引组件的悬挂 tap。输出路径与工作区树R8输出路径由audioPath()解析AudioExport.cppWorkspaceManager.path(Audio Recordings) / sanitize(项目标题) / sanitize(数据集标题) / yyyy-MM-dd_HH-mm-ss-zzz-kindindex.wav其中kind取fft/waterfall之一AudioExport.cpp避免同标题 tab 之间文件名冲突。QML 侧打开输出目录按钮调用Cpp_Audio_Export.audioPath(...)FFTPlot 的recordingsFolder()会实时用当前数据集标题解析目录因此数据集重命名后仍能定位正确的录制文件夹FFTPlot.cpp。许可证门控R10双重剔除该特性遵循与 ImageView 视频导出完全一致的双门控构建期AudioExport位于ModuleManager的BUILD_COMMERCIAL块GPL 构建不编译相关源码、不注册Cpp_Audio_Export上下文属性运行时C setter 检查Core::License::activated()QML 按钮checked: Cpp_CommercialBuild root.model.audioRecordingEnabled且可见性受Cpp_CommercialBuild约束见 FFTPlot.qml 与 Waterfall.qml。因此 GPL 构建中工具栏不渲染任何控件、无死 UI、无符号残留。约束与不变量Pro-only构建期商业构建 运行时有效许可证双门控包括晚激活/离线激活的重新推导零新第三方依赖视频导出与音频 I/O 已就绪的媒体/输出基础设施必须够用不回归 256 kHz 热路径 CI 门槛关闭态对帧流水线的成本最多是一次缓存标志检查GUI 线程禁止文件 I/O 与编码仪表盘帧路径零新增分配录制生命周期跟随视频导出先例断开/暂停自动停止播放器/回放会话打开时保持惰性项目模式边界开关是运行时控件除视频导出开关已持久化的范围外不写入项目状态。如何验证与实测规格给出了可复现的实测路径速率正确性AC1/AC2用 rocket 演示或正弦波 TCP 源在 FFT 组件开启录制约 10 秒用 Pythonwave或 Audacity 检查样本数 ≈ 采样率 × 秒数、头部速率等于fftSamplingRate分别验证 100 Hz 与 8000 Hz幅度映射AC3向声明了 min/max 的数据集喂满幅正弦检查满幅不削波对无范围数据集检查峰值归一化峰值 ≈ 0.891即 1 dB headroom伴生文件AC4100 Hz 录制结束应得到-audible-80x.wav头部速率 8000 Hz、样本数同主文件8 kHz 录制无伴生生命周期AC5–AC7中途断连后文件可被 Audacity 直接打开无数据开关切换不落盘FFT Waterfall 同数据集并行录制产出两个独立文件文件出现在工作区 Audio Recordings 树中且按钮可显示目录性能与门控AC8–AC10--benchmark-hotpath通过录制关闭态回放开启录制不产文件GPL 构建编译通过且工具栏无录制控件。小结Spec 0024 解决的是一类非常典型的产品空白分析能力已就绪、数据模型已声明必要参数唯独缺一条把观察变成可分享产物的输出路径。它的设计决策值得借鉴——用 WAV float32 PCM 规避编码器对低采样率的限制用 ingest-tap 在保证无间隙采样的同时把热路径成本压到一次布尔检查用同一数据块换头部速率的伴生文件在不做重采样的前提下让亚音频信号可以被耳朵验证再用双门控保证免费版零残留。从 spec.md 的需求定义到 plan.md 的技术设计与 AudioExport.cpp 的落地实现这套WHAT → HOW → 源码的链条清晰完整也可作为理解 Serial Studio 视频导出ImageView.cpp与工作区产物管理WorkspaceManager.cpp的参照入口。【免费下载链接】Serial-StudioOpen-source telemetry dashboard. Supports UART, BLE, MQTT, Modbus, CAN Bus and more.项目地址: https://gitcode.com/GitHub_Trending/se/Serial-Studio创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考