ggwave-arduino

Tiny data-over-sound library for microcontrollers

Main repo: ggwave

Tested microcontrollers:

• Arduino Nano RP2040 Connect
• NodeMCU-32S, ESP32
• Teensy 4.0 board
• Arduino Uno Rev3 (Tx only)

The easiest way to send and receive audio data is via the Waver application. It is freely available for Android, iOS and can also run directly in the browser: https://waver.ggerganov.com

The following settings will allow you to test the provided examples without having to modify any of the parameters in the sketches:

Img. Using the Waver app. Left: settings for fixed-length transmission. Center: Enable DSS option. Right: Transmit messages

Short demonstration of ggwave

Using with Arduino IDE

Install the ggwave library via Tools -> Manage Libraries and select one of the available examples from File -> Examples -> ggwave:

See the examples folder for sample circuits. Feel free to report any problems or feedback by opening an issue in this repo.

ggwave-cli

Another way to communicate with the microcontrollers is via the ggwave-cli command line tool, available in the main ggwave repository. For example, run the following command to transmit a 16-byte fixed-length message, using Direct Sequence Spread (DSS) with [MT] Fastest protocol:

$ ./bin/ggwave-cli -l16 -s -t11

When sending and receiving messages, make sure that both the sender and the receiver have the fixed-length option enabled and that the number of bytes for payloadLength is the same. Also note that microcontrollers currently support only the mono-tone [MT] and dual-tone [DT] transmission protocols.