Audio

.gitignore

@@ -3,3 +3,4 @@
 .idea
 platformio.ini
 .pio/
+.vscode/

README.md

@@ -16,6 +16,7 @@ Supported device class drivers are:
 - Mass Storage Class (MSC): with multiple LUNs
 - Musical Instrument Digital Interface (MIDI)
 - Video (UVC): work in progress
+- Audio (UAC): work in progress
 - WebUSB with vendor specific class
 
 ### Host Stack

examples/Audio/audio_headset/audio_headset.ino

@@ -0,0 +1,78 @@
+/*********************************************************************
+ Adafruit invests time and resources providing this open source code,
+ please support Adafruit and open-source hardware by purchasing
+ products from Adafruit!
+
+ MIT license, check LICENSE for more information
+ Copyright (c) 2024 Phl Schatzmann
+
+ A combination of a microphone and headset at the same time.
+ Unfortunately it will only work when Serial output is not active
+
+*********************************************************************/
+
+#include "Adafruit_TinyUSB.h"
+
+Adafruit_USBD_Audio usb;
+size_t sample_count_mic = 0;
+size_t sample_count_spk = 0;
+
+// Microphone: generate data for USB
+size_t readCB(uint8_t* data, size_t len, Adafruit_USBD_Audio& ref) {
+  int16_t* data16 = (int16_t*)data;
+  size_t samples = len / sizeof(int16_t);
+  size_t result = 0;
+  // generate random stereo data
+  for (int j = 0; j < samples; j+=2) {
+    data16[j] = random(-32000, 32000);
+    data16[j+1] = random(-32000, 32000);;
+    result += sizeof(int16_t)*2;
+    sample_count_mic += 2;
+  }
+  return result;
+}
+
+// Speaker: receive data from USB and write them to the final destination
+size_t writeCB(const uint8_t* data, size_t len, Adafruit_USBD_Audio& ref) {
+  int16_t* data16 = (int16_t*)data;
+  size_t samples = len / sizeof(int16_t);
+  sample_count_spk += samples;
+  return len;
+}
+
+void setup() {
+    // Manual begin() is required on core without built-in support e.g. mbed rp2040
+  if (!TinyUSBDevice.isInitialized()) {
+    TinyUSBDevice.begin(0);
+  }
+
+  Serial.begin(115200);
+
+  // Start USB device as both Audio Source and Sink
+  usb.setReadCallback(readCB);
+  usb.setWriteCallback(writeCB);
+  usb.begin(44100, 2, 16);
+
+  // If already enumerated, additional class driver begin() e.g msc, hid, midi won't take effect until re-enumeration
+  if (TinyUSBDevice.mounted()) {
+    TinyUSBDevice.detach();
+    delay(10);
+    TinyUSBDevice.attach();
+  }
+}
+
+void loop() {
+  #ifdef TINYUSB_NEED_POLLING_TASK
+  // Manual call tud_task since it isn't called by Core's background
+  TinyUSBDevice.task();
+  #endif
+  // use LED do display status
+  if (usb.updateLED()){
+    Serial.print("Total Microphone samples: ");
+    Serial.print(sample_count_mic);
+    Serial.print(" / Speaker samples: ");
+    Serial.print(sample_count_spk);
+    Serial.print(" / Sample rate: ");
+    Serial.println(usb.rate());
+  }
+}

examples/Audio/audio_microphone/audio_microphone.ino

@@ -0,0 +1,64 @@
+/*********************************************************************
+ Adafruit invests time and resources providing this open source code,
+ please support Adafruit and open-source hardware by purchasing
+ products from Adafruit!
+
+ MIT license, check LICENSE for more information
+ Copyright (c) 2024 Phl Schatzmann
+
+ This example generates white noise that you can output on your PC
+
+*********************************************************************/
+
+#include "Adafruit_TinyUSB.h"
+
+Adafruit_USBD_Audio usb;
+size_t sample_count = 0;
+
+size_t readCB(uint8_t* data, size_t len, Adafruit_USBD_Audio& ref) {
+  int16_t* data16 = (int16_t*)data;
+  size_t samples = len / sizeof(int16_t);
+  size_t result = 0;
+  // generate random data
+  for (int j = 0; j < samples; j++) {
+    data16[j] = random(-32000, 32000);
+    result += sizeof(int16_t);
+  }
+  return result;
+}
+
+void setup() {
+  // Manual begin() is required on core without built-in support e.g. mbed rp2040
+  if (!TinyUSBDevice.isInitialized()) {
+    TinyUSBDevice.begin(0);
+  }
+
+  Serial.begin(115200);
+  //while(!Serial);  // wait for serial
+
+  // Start USB device as Audio Source
+  usb.setReadCallback(readCB);
+  usb.begin(44100, 2, 16);
+
+  // If already enumerated, additional class driverr begin() e.g msc, hid, midi won't take effect until re-enumeration
+  if (TinyUSBDevice.mounted()) {
+    TinyUSBDevice.detach();
+    delay(10);
+    TinyUSBDevice.attach();
+  }
+
+}
+
+void loop() {
+  #ifdef TINYUSB_NEED_POLLING_TASK
+  // Manual call tud_task since it isn't called by Core's background
+  TinyUSBDevice.task();
+  #endif
+  // use LED do display status
+  if (usb.updateLED()){
+    Serial.print("Total samples: ");
+    Serial.print(sample_count);
+    Serial.print(" / Sample rate: ");
+    Serial.println(usb.rate());
+  }
+}

examples/Audio/audio_microphone_stream/audio_microphone_stream.ino

@@ -0,0 +1,56 @@
+/*********************************************************************
+ Adafruit invests time and resources providing this open source code,
+ please support Adafruit and open-source hardware by purchasing
+ products from Adafruit!
+
+ MIT license, check LICENSE for more information
+ Copyright (c) 2024 Phl Schatzmann
+
+ This example generates a sawtooth that you can output on your PC
+ We use the AudioTools to generate the data input.
+
+ We could use the callback function here as well, but we demo how
+ to integrate with a (fast) Arduino Stream.
+
+*********************************************************************/
+
+#include "Adafruit_TinyUSB.h"
+#include "AudioTools.h"  // https://github.com/pschatzmann/arduino-audio-tools
+
+Adafruit_USBD_Audio usb;
+AudioInfo info(44100, 2, 16);
+SawToothGenerator<int16_t> sawtooth;               
+GeneratedSoundStream<int16_t> sawthooth_stream(sawtooth);
+
+void setup() {
+  // Manual begin() is required on core without built-in support e.g. mbed rp2040
+  if (!TinyUSBDevice.isInitialized()) {
+    TinyUSBDevice.begin(0);
+  }
+
+  Serial.begin(115200);
+  //while(!Serial);  // wait for serial
+
+  // generate 493 hz (note B4)
+  sawtooth.begin(info, 493.0f);
+
+  // Start USB device as Audio Source
+  usb.setInput(sawthooth_stream);
+  usb.begin(info.sample_rate, info.channels, info.bits_per_sample);
+
+  // If already enumerated, additional class driverr begin() e.g msc, hid, midi won't take effect until re-enumeration
+  if (TinyUSBDevice.mounted()) {
+    TinyUSBDevice.detach();
+    delay(10);
+    TinyUSBDevice.attach();
+  }
+}
+
+void loop() {
+  #ifdef TINYUSB_NEED_POLLING_TASK
+  // Manual call tud_task since it isn't called by Core's background
+  TinyUSBDevice.task();
+  #endif
+  // optional: use LED do display status
+  usb.updateLED();
+}

examples/Audio/audio_speaker/audio_speaker.ino

@@ -0,0 +1,61 @@
+/*********************************************************************
+ Adafruit invests time and resources providing this open source code,
+ please support Adafruit and open-source hardware by purchasing
+ products from Adafruit!
+
+ MIT license, check LICENSE for more information
+ Copyright (c) 2024 Phl Schatzmann
+
+ This example counts the 'received' samples and prints them on
+ Serial (via CDC)
+
+*********************************************************************/
+
+#include "Adafruit_TinyUSB.h"
+
+Adafruit_USBD_Audio usb;
+size_t sample_count = 0;
+
+size_t writeCB(const uint8_t* data, size_t len, Adafruit_USBD_Audio& ref) {
+  int16_t* data16 = (int16_t*)data;
+  size_t samples = len / sizeof(int16_t);
+  sample_count += samples;
+  return len;
+}
+
+void setup() {
+  // Manual begin() is required on core without built-in support e.g. mbed rp2040
+  if (!TinyUSBDevice.isInitialized()) {
+    TinyUSBDevice.begin(0);
+  }
+
+  Serial.begin(115200);
+  //while(!Serial);  // wait for serial
+
+  // Start USB device as Audio Sink
+  usb.setWriteCallback(writeCB);
+  usb.begin(44100, 2, 16);
+
+  // If already enumerated, additional class driverr begin() e.g msc, hid, midi won't take effect until re-enumeration
+  if (TinyUSBDevice.mounted()) {
+    TinyUSBDevice.detach();
+    delay(10);
+    TinyUSBDevice.attach();
+  }
+
+}
+
+void loop() {
+  #ifdef TINYUSB_NEED_POLLING_TASK
+  // Manual call tud_task since it isn't called by Core's background
+  TinyUSBDevice.task();
+  #endif
+
+  // use LED do display status
+  if (usb.updateLED()){
+    Serial.print("Total samples: ");
+    Serial.print(sample_count);
+    Serial.print(" / Sample rate: ");
+    Serial.println(usb.rate());
+  }
+}

examples/Audio/audio_speaker_rp2040_i2s/audio_speaker_rp2040_i2s.ino

@@ -0,0 +1,70 @@
+/*********************************************************************
+ Adafruit invests time and resources providing this open source code,
+ please support Adafruit and open-source hardware by purchasing
+ products from Adafruit!
+
+ MIT license, check LICENSE for more information
+ Copyright (c) 2024 Phl Schatzmann
+
+ This example uses a Rasperry Pico to send the output to i2s. To prevent
+ any underruns or overruns we take care of the feedback ourself. 
+
+*********************************************************************/
+#include "Adafruit_TinyUSB.h"
+#include "AudioTools.h"
+#include "AudioTools/Concurrency/RP2040.h"
+
+AudioInfo info(44100, 2, 16);
+Adafruit_USBD_Audio usb;
+BufferRP2040 buffer(256, 20); 
+QueueStream queue(buffer);
+I2SStream i2s;
+StreamCopy copier(i2s, queue);
+
+size_t writeCB(const uint8_t* data, size_t len, Adafruit_USBD_Audio& ref) {
+  usb.setFeedbackPercent(buffer.size()*100 / buffer.available());
+  return queue.write(data, len);
+}
+
+void setup() {  
+  Serial.begin(115200);
+  AudioToolsLogger.begin(Serial, AudioToolsLogLevel::Warning);
+  //while(!Serial);  // wait for serial
+  delay(1000);
+  Serial.println("starting...");
+  // start queue
+  queue.begin(80);
+
+  // Start USB device as Audio Sink w/o automatic feedback
+  usb.setFeedbackMethod(AUDIO_FEEDBACK_METHOD_DISABLED);
+  usb.setWriteCallback(writeCB);
+  if (!usb.begin(info.sample_rate, info.channels, info.bits_per_sample)){
+    Serial.println("USB error");
+  }
+
+  // If already enumerated, additional class driverr begin() e.g msc, hid, midi won't take effect until re-enumeration
+  if (TinyUSBDevice.mounted()) {
+    TinyUSBDevice.detach();
+    delay(10);
+    TinyUSBDevice.attach();
+  }
+}
+
+void loop() {
+  usb.updateLED();
+}
+
+void setup1(){
+  //start i2s
+  auto cfg = i2s.defaultConfig(TX_MODE);
+  cfg.copyFrom(info);
+  cfg.buffer_size = 256;
+  cfg.buffer_count = 3;
+  if (!i2s.begin(cfg)){
+    Serial.print("i2s error");
+  }
+}
+
+void loop1() {
+  copier.copy();
+}

src/Adafruit_TinyUSB.h

@@ -61,6 +61,10 @@
 #include "arduino/video/Adafruit_USBD_Video.h"
 #endif
 
+#if CFG_TUD_AUDIO
+#include "arduino/audio/Adafruit_USBD_Audio.h"
+#endif
+
 // Initialize device hardware, stack, also Serial as CDC
 // Wrapper for TinyUSBDevice.begin(rhport)
 void TinyUSB_Device_Init(uint8_t rhport);

src/arduino/Adafruit_TinyUSB_API.cpp

@@ -98,4 +98,4 @@ __attribute__((used)) int CFG_TUSB_DEBUG_PRINTF(const char *__restrict format,
 
 } // extern C
 
-#endif // CFG_TUD_ENABLED || CFG_TUH_ENABLED
+#endif // CFG_TUD_ENABLED || CFG_TUH_ENABLED