Chip Audette
1711468630
|
8 years ago | |
---|---|---|
examples/BasicGain_Float | 8 years ago | |
.gitattributes | 8 years ago | |
.gitignore | 8 years ago | |
AudioControlSGTL5000_Extended.h | 8 years ago | |
AudioConvert_F32.h | 8 years ago | |
AudioEffectGain_F32.cpp | 8 years ago | |
AudioEffectGain_F32.h | 8 years ago | |
AudioStream_F32.cpp | 8 years ago | |
AudioStream_F32.h | 8 years ago | |
OpenAudio_ArduinoLibrary.h | 8 years ago | |
keywords.txt | 8 years ago | |
readme.md | 8 years ago |
readme.md
OpenAudio Library for Teensy
Purpose: The purpose of this library is to build upon the Teensy Audio Library to enable new functionality for real-time audio processing.
Approach: I am attempting to follow the structure and approach of the Teensy Audio Library so that coding techniques, style, and structure that works for the Teensy Audio Library will also work with my library.
Send Help!: While I'm hoping to follow the pattern of the Teensy Audio Library, I am not a well trained programmer, so I have difficulty chosing the right path. If you see ways to make my code better aligned with the Teensy Audio Library, send a pull request!
Contents
As I said, the goal of this library is to extend the functionality of the Teensy Audio Library. My extensions are focused in these areas:
Floating Point Audio Processing: The Teensy Audio Library processes the audio data as fixed-point Int16 values. While very fast for the Teensy 3.0-3.2, it is unnecessarily constraining (IMO) for the Teensy 3.5 and 3.6, which both have floating-point units. To enable floating-point audio processing, I have created:
- **AudioStream_F3288: Following the model of Teensy's
AudioStream
class. In addition to the newAudioStream_F32
, this file includes a newaudio_block_f32_t
in place ofaudio_block_t
, as well as a newAudioConnection_F32
in place ofAudioConnection
. - New Audio Processing Blocks: Using this new floating-point capability, I've written some new audio processing blocks that operate using floating-point audio values instead of fixed-point values. As I'm just starting to build these blocks, I've only got
AudioEffectGain_F32
right now. More will be added over time. - New Hardware Controls: The Teensy Audio Library does a great job of wrapping up the complicated control of hardware elements (such as the SGTL5000 audio codec) into a nice easy-to-use classes. But, sometimes, certain features of the hardware were not exposed in those classes. Here, I've extended the default classes to expose the extra features that I want. See
AudioControlSGTL5000_Extended
as an example.
After installing this library into your Arduino->Libraries direction, you can have access to any of these capabilities simply by including the following command in your Arduino sketch: #include <OpenAudio_ArduinoLibrary.h>
.
Installation
Download (and unzip) this library into the Arduino libraries directory on your computer. On my computer, that means I put it here:
C:\Users\chipaudette\Documents\Arduino\libraries\OpenAudio_ArduinoLibrary
Restart your Arduino IDE and you should now see this libraries example sketches under File->Examples->OpenAudio_ArduinoLibrary
Dependencies
This library extends the functionality of the Teensy Audio Library, so you'll need to install it per its instructions.