Examples

All examples follow the following naming convention: "scenario type"-"source"-"destination". For the scenario types we might have base (using basic api functionality), stream for examples using Streams and test for the test cases.

For the source we currently have adc for analog input devices like analog microphones, i2s for digital input devices (e.g. digital microphones), file for SD files and a2dp for input from Bluetooth A2DP (e.g. from a Mobile Phone).

For the destination we use dac for analog output (e.g. to an amplifier), i2s for digital output devices (e.g. an external DAC), file for SD files and a2dp for output to Bluetooth A2DP (e.g. a Bluetooth Speaker).

Here is the list of examples:

Here are a couple of simple test sketches to demo different output destinations:

• streams-generator-serial Displaying generated sound on the Serial Plotter
• streams-generator-i2s Output of generated sound on external DAC via I2S
• streams-generator-dac Output of generated sound on ESP32 internal DAC via I2S
• streams-generator-a2dp Output of generated sound on Bluetooth Speaker using A2DP
• streams-generator-pwm Output of generated sound with PWM
• streams-adc-serial Displaying input from analog microphone on the Serial Plotter
• streams-memory_wav-serial Decoding of WAV from Flash memory and display on the Serial Plotter

And some more useful examples:

• streams-sd_mp3-i2s - Playing an mp3 file from a SD disk and output to external DAC via I2S
• streams-url_mp3-i2s - Streaming mp3 and output to external DAC via I2S
• streams-url_mp3-analog - Streaming mp3 with analog output
• streams-memory_raw-i2s - Play music form Flash Memory via I2S to External DAC
• streams-url_raw-serial Displaying a music file from the internet on the Serial Plotter
• streams-url_raw-I2S.ino Streaming a File from the Internet to on external DAC via I2S
• streams-url_wav-i2s Text to Speach example using Rhasspy
• streams-memory_mp3-metadata Decoding Metadata from a MP3 file

... these are just a few examples, but you can combine any Input Stream with any Output Stream as you like...

Listening to the Result with a Webbrowser

I am also providing a simple webserver which can render the audio data as wav result. Here are some examples:

• streams-generator-webserver_wav A Webserver which renders some generated sound
• streams-sam-webserver_wav A Webserver which renders the result from the SAM TTS engine
• streams-tts-webserver_wav A Webserver which renders the result from the Arduino TTS engine
• streams-flite-webserver_wav A Webserver which renders the result from the Flite TTS engine

Building an executable for the Desktop

We provide some generic output which will also work on Linux, Windows and OS/X The cmake is downloading all dependencies and builds an executable from the sketch.

• generator
• mp3

Basic API

Just some examples using the basic API. Though this continues to work, we recommend that you use the Stream API because it is easier to use.

• base-adc-serial - Sample analog sound and write it to Serial
• base-adc-a2dp - Sample analog sound and write it to a A2DP Bluetooth source
• base-file_raw-serial - Read Raw File from SD card to and write it to Serial
• base-file_raw-a2dp - Read Raw File from SD card write it A2DP Bluetooth
• base-file_mp3-a2dp - Stream MP3 File from SD card to A2DP Bluetooth using the ESP8266Audio library
• base-i2s-serial - Sample digital sound and write it to Serial
• base-i2s-a2dp - Sample analog sound and write it to a A2DP Bluetooth source