arduino-audio-tools/README.md

58 lines
1.8 KiB
Markdown
Raw Normal View History

2021-04-28 06:06:15 +00:00
# Arduino Audio Tools
2021-04-28 09:45:38 +00:00
Some basic C++ classes that can be used for Audio Processing privided as Arduino Library
2021-04-28 06:06:15 +00:00
2021-04-29 09:52:46 +00:00
- Additinal Stream implementations: MemoryStream, UrlStream [ESP32 only]
2021-04-28 06:40:17 +00:00
- a simple I2S class (to read and write to the internal I2S) [ESP32 only]
- a simple ADC class (to read analog data with the help of I2S) [ESP32 only]
2021-04-28 06:06:15 +00:00
- Converters
2021-04-29 09:52:46 +00:00
- Musical Notes (with Frequencies of notes)
2021-04-28 06:06:15 +00:00
- SineWaveGenerator (to generate some sine tone)
2021-04-28 06:40:17 +00:00
- NBuffer (Multi buffer for writing and reading of (sound) data)
2021-04-28 06:06:15 +00:00
- TimerAlarmRepeating (e.g. for sampling sound data using exact times) [ESP32 only]
2021-04-29 09:52:46 +00:00
- A Wav Encoder and Decoder
2021-04-28 06:06:15 +00:00
This functionality provides the glue which makes different sound processing components and libraries work together.
2021-04-28 09:01:34 +00:00
We also provide plenty of examples that demonstrate how to implement the different scenarios.
2021-04-28 06:06:15 +00:00
## Optional Libraries
- SD Library
- A2DP Library
- arduino-fdk-aac
- ESP8266Audio
2021-04-28 09:01:34 +00:00
## Examples
All examples can be found in the [examples folder](https://github.com/pschatzmann/arduino-sound-tools/tree/main/examples)
2021-04-28 16:15:42 +00:00
## Installation
You can download the library as zip and call include Library -> zip library. Or you can git clone this project into the Arduino libraries folder e.g. with
```
cd ~/Documents/Arduino/libraries
git clone pschatzmann/arduino-sound-tools.git
```
2021-04-28 09:01:34 +00:00
## Documentation
2021-04-28 06:11:01 +00:00
2021-04-28 06:40:17 +00:00
Here is the generated [Class documentation](https://pschatzmann.github.io/arduino-sound-tools/html/annotated.html)
2021-04-28 06:11:01 +00:00
2021-04-28 06:06:15 +00:00
## Project Status
2021-04-28 06:11:01 +00:00
2021-04-29 09:52:46 +00:00
This is currently work in progress:
| Functionality | Status
|-----------------------------------
| Analog input - ADC | tested
| I2S | tested
| Files | open
| Streams | open
| WAV encoding/deconding | open
| AAC encoding/deconding | open
| int24_t | open
2021-04-28 06:06:15 +00:00