Tiny data-over-sound library for microcontrollers
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
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.
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.