ggwave-arduino
Tiny data-over-sound library for microcontrollers
Main repo: ggwave
Tested microcontrollers:
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.