简介MMSSTV源码包是一款面向业余无线电爱好者与软件开发者的开源项目专注于慢扫描电视SSTV静态图像无线电传输技术。源码完整呈现了从图片压缩编码到调制解调、再到接收解码的整套流程涉及JPEG有损压缩、离散余弦变换、锁相环与鉴频器、CRC校验及前向纠错等关键实现。压缩包共554个文件以bmp图像素材、h/cpp/c源代码、dfm窗体定义及txt说明文档为主另含工程配置与图标资源整体仅5.52MB结构紧凑。已有633人参与学习下载。除源码外还附带说明.txt涵盖安装指南、使用方法和开发者注释。通过剖析该项目读者可深入理解无线电图像传输的底层机制并为开发更高效、更稳健的SSTV方案提供参考。1. MMSSTV源码能干什么一张图从短波频谱里“挤”出来当你拧开一台短波电台在一个固定频点上听到“哔——哔——嘀嘀嘀——呲——”像老传真机又像外星人对话的声音时大概率就是有人在发SSTV图片。MMSSTV就是无线电圈子里存活了二十多年的经典SSTV收发软件它的源码到今天依然值得打开不是因为怀旧而是因为它把“图像—音频—射频”整条链路压缩在一个很小的程序里结构清晰、协议完整非常适合拿来落地。这篇文章不讲科普沿着马尔斯定义的“标题带源码”这条路把MMSSTV的编码链拆开告诉你源码里哪些文件值得看、本机怎么编译、电台怎么接线、电平怎么调再给你几条实打实的避坑记录。2. MMSSTV源码核心从像素到声波的编码链2.1 先算带宽账为什么传一张图要一分钟SSTV全称是慢扫描电视慢是它最反直觉的地方。普通电视一秒钟送25帧画面SSTV一帧要送几十秒。原因很简单短波单边带语音信道的可用带宽只有2.7kHz左右而一张图片哪怕只按320像素宽来算也需要一条线一条线地送每条线对应一段音频信号。带宽不够就只能拿时间换。具体到源码实现SSTV的发送端做的是“像素点—音频频率”的映射一行像素按顺序变成一串持续几百毫秒的音频频率变化。MMSSTV源码里每种模式本质上就是一组参数多少行、一行用多长时间、同步频率是多少、像素用什么顺序送。这些参数被常驻内存的模式表管理解码端收到音频后按同一张表反向还原所以模式表是整个源码里最早值得读的段落。为什么频率要选1500Hz到2300Hz这个区间这是故意对准语音通带的。2.4kHz的音频通带刚好容纳这个范围频率太高会被电台的窄带滤波切掉太低则容易和电源底噪混在一起。明白了这个约束你就知道为什么SSTV不能像普通数字通信那样跑得很“快”能跑通本身已经是把窄带信道榨干了。2.2 同步头、VIS码与行同步解码首先要找的骨架SSTV信号听着乱实际上帧结构非常规整。每一帧开始是一段1900Hz的长音叫leader tone相当于“我要开始了”。紧接着是一串FSK脉冲叫VIS码用来告诉接收端“下面这张图是Robot 36还是Martin M1”。再往后每条扫描线开头还有一个1200Hz的同步脉冲告诉解码器“新的一行来了”。这一整套结构在任何一款SSTV的解码器源码里都存在只是命名方式不同。MMSSTV或同类开源SSTV实现源码里模式表一般长成这样typedef struct { int vis; // VIS编码协议识别的模式ID const char *name; // 模式名如 Robot 36 int width; // 图像宽度单位像素 int height; // 图像高度单位像素 double line_ms; // 每条扫描线周期单位毫秒 int sync_hz; // 行同步脉冲频率 } sstv_mode_t;这段结构体几乎是所有SSTV解码器约定俗成的写法。vis字段就是上一段说的VIS码解码器先把这串FSK脉冲恢复成一个整数再到模式表里做线性查找找到对应的分辨率、行周期、同步频率后续解码全部按这个结构体的参数来走。const sstv_mode_t* find_mode(int vis_code) { for (int i 0; i g_mode_count; i) { if (g_modes[i].vis vis_code) { return g_modes[i]; } } return NULL; // 找不到就返回空指针上层提示“未知模式” }这段代码逻辑平庸但它是整个解码流程的分岔路口。注意一个关键行为VIS码如果解错整张图基本就废了所以很多实现会做“连续两次拿到相同VIS码才确认”的防抖处理代价是解码启动慢几百毫秒换来的是噪声环境下更小的误判率。参数调优时这个确认次数就是一个可以改的旋钮一般取2到3次设成1则更容易在强噪声里翻车。2.3 从频偏到像素解码端怎么把“滋滋”声变回图片发送端把像素值映射成了音频频率接收端就得把这个映射倒回去。解码器拿到声卡采样的PCM数据后先做带通滤波把1500Hz以下和2300Hz以上的噪声切掉然后通过Hilbert变换或锁相环提取瞬时频率这一步是“声音变像素”的关键。具体到流程一行扫描线持续几百毫秒。解码器在这一段时间里持续计算当前音频的瞬时频率把每个频率值映射回亮度或色度值再落到内存中一幅位图的对应像素位置上。彩色SSTV常见做法是亮度信号和色差信号分批发送先送一整行亮度再送一行R-Y、B-Y色差接收端最后做颜色矩阵运算合成RGB。这里有个容易被忽略的坑行同步脉冲之间的时间长度是固定的但声卡采样率会有微小误差长时间解码下来累积误差会把图像“拉斜”。所以稍微成熟一点的源码都会在每行同步脉冲时做一个时间校准把本行实际耗时和期望耗时之间的误差吃掉。这个机制决定了你用48kHz声卡和用44.1kHz声卡解码同一段信号后者的图像更不容易歪斜因为设备时钟更接近标准参考时间。3. 本机跑通MMSSTV源码依赖、编译与回环自测3.1 拿到源码先翻这三个位置模式表、音频IO、界面线程一个SSTV程序说复杂也复杂说简单也就三个部分。第一是模式定义文件通常是一张大数组或结构体表前面已经讲过。第二是音频输入输出模块负责从声卡读PCM、往声卡写PCM以及和电台之间的PTT控制。第三是主界面和解码线程负责把解码出的图像刷到窗口上同时主线程保持界面响应。如果你打开的是某种镜像站打包的mmsstv-源码master我一般会先按这三个模块去翻而不是从main函数一路读下去。因为模式表和音频IO是纯算法逻辑没有界面纠缠最容易独立理解界面线程和消息循环则往往是老代码里最乱的部分牵涉到窗口句柄、定时器、线程同步留着最后看反而轻松。另一个值得先看的位置是版本说明或README。很多老项目的中文或日文版说明里作者会写下依赖的编译器版本、声卡类型、甚至“推荐用什么声卡芯片”。这个信息比任何教程都准确因为它直接对应着源码里实际调用的API。3.2 Windows下编译MinGW与MSVC两条路线MMSSTV这类老牌Windows程序源码包最常见的构建方式有三种Visual Studio工程文件、MinGW的Makefile、以及后人补的CMakeLists。拿到源码后先不要急着敲命令用文件管理器或命令行看一眼根目录有哪些构建文件再做决定。# 在MSYS2环境下用MinGW-w64工具链编译 pacman -Syu pacman -S --needed mingw-w64-x86_64-gcc mingw-w64-x86_64-cmake make cd mmsstv-master mkdir -p build cd build cmake .. -DCMAKE_BUILD_TYPERelease make -j$(nproc)cmake生成的是Release版本优化选项全开适合实际使用。如果源码包里没有CMakeLists那就直接看有没有.sln后缀的Visual Studio工程文件用Studio打开后选择“生成解决方案”即可。编译目标建议选Win32如果项目本意是32位程序强行编成64位可能碰上一堆类型转换警告。编译过程中最常见的报错集中在两类一是老代码用了已经被新编译器移除的语法二是缺少Windows SDK头文件。遇到这类问题不要慌先看报错的具体文件和行号通常改成现代等价写法就能过。如果只是简单玩一玩而不是二次开发也可以考虑直接把源码编译出一个能出音频的解码器界面随便什么版本都能跑核心逻辑一致。3.3 没有电台也能自测虚拟声卡回环与WAV文件验证设备不在手边不代表不能测试。常见做法是给Windows装一个虚拟声卡驱动把MMSSTV的音频输出指向虚拟声卡A通道再把录音端指向同一个虚拟声卡的B通道这样就实现了“本机自发自收”。这个方法不需要电台、不需要天线验证编码解码链路是否完整非常好用。更进一步你还可以用一段现成的SSTV音频文件来测解码器。这时候最关键的问题是怎么确认手里的wav文件“确实是SSTV而不是一段杂音”。一个很朴素的办法是用Python读文件、算频谱看1900Hz附近有没有明显能量峰值import wave import numpy as np with wave.open(unknown.wav, rb) as w: sr w.getframerate() data np.frombuffer(w.readframes(w.getnframes()), dtypenp.int16).astype(np.float32) # 取整段信号做FFT观察频谱能量分布 freqs np.fft.rfftfreq(len(data), d1.0 / sr) amps np.abs(np.fft.rfft(data)) # 找出1900Hz附近的能量峰值也就领先导音的频率 mask (freqs 1850) (freqs 1950) leader_energy np.sum(amps[mask] ** 2) total_energy np.sum(amps ** 2) print(leader energy ratio:, leader_energy / total_energy)这段脚本的逻辑很简单SSTV帧头一定有几百毫秒的1900Hz单音这一段能量占总能量的比例会异常突出。如果你测出来的比值明显高于杂乱语音文件就说明文件里大概率含SSTV信号可以放心丢给MMSSTV解码。注意这个方法是粗略筛查不是精确检测但对“我下载的这段音频到底能不能用来测软件”已经足够。自测通过后再接电台能省下大量排查时间。我见过太多人一上来就把声卡、电台、电脑连成一串结果图片花屏最后发现是软件本身解码有问题跟电台一点关系都没有。4. 接上电台发图音频线、电平与波段选择4.1 电脑到电台的音频链路接口、阻抗与隔离SSTV本质上是把声卡输出的音频信号送进电台调制发射出去所以电脑和电台之间的音频链路是最先要搞对的物理环节。多数电台后面板会有数据口提供数据输入和数据输出两个接口有些老电台只有MIC口和耳机口那就得自己改线。常见的接法是电脑声卡的耳机输出口通过一根立体声转单声道线接到电台的数据输入或MIC口电台北的输出或耳机口接到电脑的线路输入口。这中间最容易被忽视的是地线回路——电脑和电台如果插在不同电源插座上地电位差会在音频线上形成嗡嗡声严重时解码不出任何图像。我一般会建议在音频线中间串一只600欧对600欧的音频隔离变压器成本不高但能把地环路问题彻底隔断。接线时还有两个细节。第一电脑端输出音量不要拉满先放到50%左右后面靠电台ALC表细调。第二确认使用立体声转单声道时左右声道合并正确有些线材会把音频信号和地线搞混导致发射出去的是“降调”的SSTV。判断信号是否正常可以在发射时监听一下自己电台的侧音如果听到的频率比预期低或高先检查线材。4.2 发射电平怎么调看ALC别信峰值表SSTV信号对发射电平比语音敏感得多。语音失真还能听懂数据信号一旦削波解码端就是一片花屏。所以发射电平不能靠耳朵也不能看电脑的播放音量条要看电台的ALC表。检查项 期望状态 过高现象 过低现象 ALC指示 指针轻微动作不超过一格 发射音被打散、带宽变宽 解调信噪比低 音频静噪 不触发 误触发静噪 信号断断续续 解码端接收 SNR保持在12dB以上 解码花屏 图像噪点密集调试步骤很简单功率先降到最低然后对着一台接收机或另一台电脑发一段测试图边发边调电脑输出音量直到ALC表刚好有轻微摆动的临界点再往回调一点留出余量。这个位置就是最佳发射电平。很多人习惯把电脑音量拉到80%以上结果ALC顶表发射出去的信号严重失真对方解码出来的图跟抽象画一样——这在圈内属于经典翻车现场。另外注意模式选择也会影响电平的观感。低速模式如Robot 36、Martin M1这类扫描线时间长的模式对电平误差容忍度稍高高速模式比如一些每线只有几十毫秒的模式电平稍有不对就崩。新手刚开始玩建议锁定在Robot 36或Martin M1上测试等链路稳定后再挑战高速模式。4.3 频点与呼叫惯例守听、呼叫与通联流程既然做的是无线电图片传送光在电脑上自发自收不算闭环得上电台。SSTV有一个不成文的“活动频点”习惯很多爱好者约定在短波的固定频率附近呼叫。常见的做法是在20米波段和40米波段各找一个USB/LSB频点发一段“CQ SSTV测试图片”再附一张测试图。完整的通联流程一般是先在约定频率守听如果听到有人发图保持静默等对方发完如果对方呼叫“CQ SSTV”你可以稍等几秒然后用语音回答或者直接也回一张图。业余无线电圈子有很强的通联礼仪不要在一张图发到一半时插进去呼叫那会把别人的图搅花属于最不招人待见的行为。频点选址上注意尽量避开强干扰的广播频段边缘。短波频段环境复杂晚上和白天的最佳频率也不一样白天高波段好夜里低波段好这是电波传播的基本规律。对新手来说固定在一个本地噪声较小的频点比频繁换频率更容易稳定收到别人的图片。5. 避坑指南SSTV收发最常见的翻车现场5.1 花屏、错位、颜色偏同步头没抓到还是噪声太强现象解码出来的图像要么整体向右倾斜要么某几条线颜色不对甚至半张图是灰白的。原因最常见的是接收端信噪比不足解码器在弱信号下误判了行同步脉冲。整张图倾斜则说明声卡采样率不准或者发送端的声卡和接收端声卡之间存在明显的时钟偏差。解决先看频谱瀑布图如果信号强度明显低于底噪先把天线和接收链路优化一遍再说如果信号本身很强但还是花屏把MMSSTV的输入采样率固定为48kHz试一下避开Windows声卡重采样的干扰。5.2 发了图对方说没收到模式、频率与电平三连错现象语音通联对方听得清清楚楚但你发出去的SSTV对方就是解不出来要么提示未知模式要么全是噪点。原因常见有三。一是发射电平过高导致音频削波信号带外辐射一大堆杂散对方解码器同步头被杂散淹没。二是频率偏移你的电台如果实际发射频率偏了上百Hz对方解码器对不上同步频率。三是模式选择过于冷门对方软件没内置这个模式。解决把模式固定为Robot 36这是所有SSTV软件都支持的“普通话”发射前先看ALC把电平压到一格以下再检查电台的频偏设置有条件的话用另一台接收机确认实际发射频率。5.3 声音输出正常但软件没反应采样率与缓冲区问题现象播放SSTV音频文件时扬声器能听到“滋滋”的调制声但解码区一片空白连同步头都没抓到。原因MMSSTV用的是声卡驱动层接口不是高级音频库。如果系统默认录音设备采样率设成8kHz或16kHz而SSTV信号频率在1900Hz以上高次谐波全被抗混叠滤波器切掉解码器当然什么都收不到。解决把Windows声音控制面板里录音设备的“默认格式”改成48kHz或44.1kHz立体声16位。改了之后重启MMSSTV再回放一次测试文件大部分情况立刻就正常了。如果改了还不行检查声卡驱动是否有“音频增强”选项把这些后处理全部关掉。5.4 图像上下斜切声卡时钟漂移的玄学现象数据本身能解出来但图像从中间某一行开始整体错位像一刀切下去上面的图是好的下面全错到左边去了。原因这是SSTV圈子里最玄学的问题之一。表面原因是声卡采样率和实际值差了一点点比如标称48000Hz实际只有47980Hz发送端和接收端累计误差达到大约一行的时间时行同步就会跳到前一行的位置。解决把音频设备换成外置USB声卡尤其是带晶振的标准声卡芯片的型号。内置声卡和主板集成的声卡时钟精度差长期解码就会积累偏移。另外在很多SSTV软件里有一个“时钟校正”或“同步偏差”的选项把校正值调高可以缓解但根因还是换硬件。这个坑不亲身踩一次很难有体感属于那种“看着是小问题排查要一下午”的隐患。5.5 一按发射电脑音箱就啸叫音频地环路与PTT串扰现象按下PTT发射的瞬间电脑扬声器发出刺耳的啸叫同时解码窗口出现大面积噪声条纹。原因电脑耳机口输出的音频信号通过地线和音箱形成环路加上电台发射时的射频能量耦合回电脑音频线形成正反馈。这在笔记本上尤其常见因为笔记本地线往往接地不良。解决优先用耳机代替外接音箱音频线绞合短一些不要绕成长圈有条件的话加隔离变压器或共模磁环。记住一个原则SSTV发射时任何非必要的音频设备都该静音或断电省掉的啸叫会让你少很多白头发。6. 进阶玩法给MMSSTV源码加一个自动SSTV应答机走到这一步基础的收发你已经能跑通了。接下来值得做的事是把MMSSTV从一个“手动点按钮”的工具改造成一个“无人值守应答机”。这并不需要改动源码核心常见做法是让MMSSTV把解码成功的图片自动保存到固定目录然后你在外部用一个很小的脚本持续监视这个目录一旦出现新图就自动回一张预先准备好的图片再触发PTT发射。import os import time import subprocess WATCH_DIR decoded_images REPLY_WAV reply.wav # 预先用MMSSTV生成好的应答图片音频 KNOWN set() while True: files set(os.listdir(WATCH_DIR)) new_files files - KNOWN for f in sorted(new_files): if f.lower().endswith((.png, .jpg, .bmp)): print(new image:, f) # 触发PTT并播放应答音频具体命令按你的外围PTT设备而定 subprocess.run([ptt_control.exe, on]) subprocess.run([play, REPLY_WAV], shellTrue) subprocess.run([ptt_control.exe, off]) KNOWN files time.sleep(3)这个脚本的思路是做一个文件系统级别的监听不侵入MMSSTV自身逻辑。注意WATCH_DIR要指向MMSSTV“自动保存解码图片”的目录这个目录一般在设置里可以配置。PTT控制是另一个坑大多数电台的PTT可以用串口RTS线拉动或者用USB转RS232模块加一个光耦电路脚本里调用一个小工具实现开和关就能完成发射控制。这套玩意的价值不只是“炫技”。很多无线电爱好者会用它做无人值守的中继测试你架一台接收机连续监听某个频点每收到别人发来的SSTV就自动回一张带有你呼号和参数的图片这样对方能确认链路质量你也能积累大量信号样本。我之前搭过一个类似的系统连续跑了几个晚上记录下不同时段的信噪比变化比手动守着电台等图省力得多。如果还想再深一层可以把解码后的图片文件名做成带时间戳的格式脚本里再按小时分目录归档。这样每周复盘时可以直接看出哪几个时段传播条件最好、哪些频率值得长期守听。这种数据比任何传播预测表都贴近你的实际环境算是玩SSTV附带的一项“信号勘察”收益。我最后的习惯是每次修改完脚本或电平设置后一定用虚拟声卡回环先跑一遍确认链路没断再上电台。这个习惯帮我挡住了至少十次“以为改好了结果全白干”的尴尬。SSTV这个方向看着老但它把模拟调制、数字信号处理、音频处理和自动化串在一起做完一套下来你会对“窄带信道传图片”这件事有非常直观的体感。希望帮到你。本文还有配套的精品资源点击获取