如何零基础用 ggwave 让两台设备用声音传数据完整实操指南【免费下载链接】ggwaveTiny>项目地址: https://gitcode.com/GitHub_Trending/gg/ggwave没有网、没有线、没有蓝牙一台电脑怎么把一小段数据交给旁边的 ESP32ggwave 声波传输库就是干这个的发送端把数据编码成一段声波从扬声器播出去接收端用麦克风录下这段声音做频谱分析后还原成数据。它基于 FSK 频移键控调制传输速率 8-16 字节/秒Python 几行代码就能跑起来Arduino、ESP32 这类小单片机也带得动。 它是什么、凭什么工作一句话ggwave 把数据变成一个声学二维码。发送时数据被切成 4-bit 小块用 6 个同时播放的音调承载落在一段 4.5kHz 宽的频率带里可听声协议基频 1875Hz超声波协议 15kHz原始数据先经过 Reed-Solomon 纠错编码接收端有轻微误码也能自行修复接收端先监听专门的起止标记声确认传输边界后再对录音做 FFT 频谱分析逐帧还原出数据库本身只负责数据 ↔ 原始波形这一层音频设备ALSA、PortAudio、Web Audio由你自己接所有协议常量和参数含义都在 include/ggwave/ggwave.h 的注释里读一遍就清楚每个字段的用途。能力全景先选对调再动手库内置 4 组、共 12 个预置协议加 10 个可自定义的空位协议族常量示例每块字节数特点适合场景可听声GGWAVE_PROTOCOL_AUDIBLE_NORMAL/_FAST/_FASTEST3人耳可闻基频 1875Hz档位越高速率越高、抗噪越差演示、近距离传文件超声波GGWAVE_PROTOCOL_ULTRASOUND_NORMAL/_FAST/_FASTEST3基频 15kHz 起人听不见、不扰人自动配对、后台静默传输DT 多音GGWAVE_PROTOCOL_DT_NORMAL/_FAST/_FASTEST1多音调直传速率最慢但更稳信道条件差的远距离MT 单音GGWAVE_PROTOCOL_MT_NORMAL/_FAST/_FASTEST1单音调、内存占用最低只有无源蜂鸣器的 Arduino 等 MCU怎么选记住三条就够要听得见、能演示AUDIBLE_FAST要听不见、不碍事ULTRASOUND_NORMAL设备只有一个蜂鸣器MT 族 GGWAVE_OPERATING_MODE_TX_ONLY_TONES只生成音调列表不合成完整波形省内存 从零跑起来三步收到第一句话步骤 1获取代码并构建git clone https://gitcode.com/GitHub_Trending/gg/ggwave --recursive cd ggwave mkdir build cd build cmake .. make如果不想编译 C 代码也可以直接pip install ggwave装 Python 包配合 PortAudio 就能收发。步骤 2最小发送示例import ggwave, pyaudio p pyaudio.PyAudio() waveform ggwave.encode(hello ggwave, protocolId1, volume20) # 1AUDIBLE_FAST stream p.open(formatpyaudio.paFloat32, channels1, rate48000, outputTrue, frames_per_buffer4096) stream.write(waveform, len(waveform)//4) # 扬声器播放这段声波 stream.stop_stream(); stream.close(); p.terminate()步骤 3另一台机器上接收import ggwave, pyaudio p pyaudio.PyAudio() inst ggwave.init() # 默认参数48kHz、1024 帧 stream p.open(formatpyaudio.paFloat32, channels1, rate48000, inputTrue, frames_per_buffer1024) while True: data stream.read(1024, exception_on_overflowFalse) res ggwave.decode(inst, data) # 每帧喂一次收到才返回内容 if res is not None: print(Received:, res.decode(utf-8)); break跑通这两段你手里就是一个空气传数据的收发系统了。硬件准备接单片机时用 Arduino 当发送端的话硬件极简无源蜂鸣器接数字引脚示例用 10两个按键控制发送内容5V 供电即可对应代码在examples/arduino-tx/arduino-tx.ino接收侧的 ESP32 / RP2040 接麦克风电路在examples/esp32-rx/和examples/rp2040-rx/。两个真实用法演示场景 1给 IoT 设备配网手机或电脑把 WiFi 的 SSID密码用声音播出去ESP32 用模拟麦克风MAX9814、KY-037 等听音解码拿到凭据直接连网省掉串口手输的步骤uint8_t buf[256]; int n ggwave_decode(inst, micData, nBytes, buf); // 麦克风音频喂进去 if (n 0) { buf[n] \0; // 解码结果不带结束符手动补 connectWiFi((char*)buf); // 解析 SSID/密码并连接 }价值在于设备出厂不用预置任何配置靠近手机听一下就完成了配网且凭据走的是人耳听不太懂的超声波频段。场景 2浏览器之间传小文件把 ggwave 编译成 WebAssemblyexamples/ggwave-wasm/两个网页各开一个标签页一个用 Web Audio API 播放波形、一个用麦克风解码中间没有任何服务器和插件char payload[256]; while (running) { // 接收标签页的主循环 int n ggwave_decode(inst, micBuf, nBytes, payload); if (n 0) { payload[n] 0; saveToFile(payload); } // 文件还原 }几百字节的文件、密钥片段、剪贴板内容播个一两秒就过去了。 调优与避坑4 个常见状况的处理发了没反应多半是背景噪声太大或音量太小。把 volume 保持在 15-30头文件注释建议 25别超过 50协议从 FAST 档退回 NORMAL 档或开启 DSS 直接序列扩展模式提升鲁棒性。ggwave_decode频繁返回 -1表示解码失败通常就是噪声。缩短设备间距、避开大音量声源另外确认麦克风的采样率设置sampleRateInp与实际一致不一致时库会自动重采样但误差太大照样解不出。Arduino Uno 蜂鸣器发不出声无源蜂鸣器在 1-2kHz 低段可能物理发不出来。用 MT 单音协议并用ggwave_txProtocolSetFreqStart把基频上移arduino-tx 示例移了 48 个 bin ≈ 2250Hz接收端记得移相同的量。数据超过 140 字节发不出去变长载荷上限 140 字节、固定长度模式上限 64 字节。大文件要自己分片加序号、逐片发送、接收端重组失败重传。❓ 常见疑问Q一次到底能发多少数据 A变长模式每包最大 140 字节固定长度模式 64 字节更大的数据靠分片。Q采样率必须是 48000Hz 吗 A默认工作速率 48kHz。设备实际采样率不同时把sampleRateInp/sampleRateOut设成设备值ggwave 会内部重采样。Q接收端要不要全协议都开着 A默认全部启用。收发协议已知时用ggwave_rxToggleProtocol只留目标协议误报更少、内存更省。Q笔记本自带的扬声器和麦克风能用吗 A能。examples/r2t2/甚至演示了直接用 PC 板载喇叭发数据。延伸资源examples/ggwave-py/send.py 与 examples/ggwave-py/receive.pyPython 收发对的最小实现逐行对应本文步骤 2/3examples/arduino-tx/arduino-tx.inoMCU 上用蜂鸣器发文本的完整示例含频率偏移处理src/ggwave.cpp调制、Reed-Solomon 编解码与频谱分析的完整实现想深挖协议细节看这里【免费下载链接】ggwaveTiny>项目地址: https://gitcode.com/GitHub_Trending/gg/ggwave创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考