Arduino_AdvancedAnalog

Usage

The Arduino Advanced Analog library enables high performance DAC, ADC and I2S applications on boards based on the STM32H7 microcontrollers:

• Arduino GIGA R1 WiFi
• Arduino Portenta H7

Features

• Efficient memory management using DMA buffer pools.
• Configurable sample rate, sampling time, resolution, and number of channels.
• Samples are stored in dynamically configurable queues.
• ADC multi-channel acquisition and dual mode support.
• I2S input, output, and full-duplex mode support.
• All drivers utilize DMA in double buffer mode.
• A WAV file reader that supports loop mode.

Guides

To learn more about using the DAC & ADC on the GIGA R1 WiFi, check out the GIGA Advanced DAC/ADC Guide.

This includes examples such as audio playback from USB storage, generate sine waves and more.

Usage

ADC

To use this library for ADC applications, you must have a supported Arduino board and include the AdvancedAnalog library in your Arduino sketch. Here is a minimal example:

#include <Arduino_AdvancedAnalog.h>

AdvancedADC adc1(A0);

void setup() {
    Serial.begin(9600);

    // Initialize ADC with: resolution, sample rate, number of samples per channel, queue depth
    if (!adc1.begin(AN_RESOLUTION_16, 16000, 32, 64)) {
        Serial.println("Failed to start ADC!");
        while (1);
    }
}

void loop() {
    // Check if an ADC measurement is ready
    if (adc1.available()) {
        // Get read buffer
        SampleBuffer buf = adc1.read();

        // Print sample from read buffer
        Serial.println(buf[0]);

        // Release read buffer
        buf.release();
    }
}

ADC Multichannel (GIGA R1 WiFi)

This library supports concurrent usage of up to three ADCs (ADC1, ADC2 and ADC3). Each ADC instance can handle up to 16 channels.

Note: It’s important to be aware that certain pins cannot be used across multiple ADCs or cannot share the same ADC.

Please ensure that you refer to tables below when configuring your project to avoid conflicts in pin assignments.

Below is a table illustrating the pin mapping for each ADC in Arduino Giga R1 WiFi:

Here is a example for the Arduino GIGA R1 WiFi:

#include <Arduino_AdvancedAnalog.h>

AdvancedADC adc_a(A0, A1); 
/* Mapped to ADC1 */

AdvancedADC adc_b(A2);
/* Mapped to ADC2, because ADC1 is occupied by A0 and A1 */

void setup() {
...

ADC Multichannel (Portenta H7)

Below is a table illustrating the pin mapping for each ADC in Portenta H7:

Here is an example for the Portenta H7:

#include <Arduino_AdvancedAnalog.h>

AdvancedADC adc_c(A2, A3, A4); 
/* Mapped to ADC3 */

AdvancedADC adc_d(A5);
/* Mapped to ADC1 */

void setup() {
...

DAC

To use this library for DAC application, you must have a supported Arduino board and include the AdvancedAnalog library in your Arduino sketch. Here is a minimal example for the Arduino GIGA R1 WiFi:

#include <Arduino_AdvancedAnalog.h>

AdvancedDAC dac1(A12);

void setup() {
    Serial.begin(9600);

    // Initialize DAC with: resolution, sample rate, number of samples per channel, queue depth
    if (!dac1.begin(AN_RESOLUTION_12, 8000, 32, 64)) {
        Serial.println("Failed to start DAC!");
        while (1);
    }
}

void loop() {
    if (dac1.available()) {

        // Get a free buffer for writing
        SampleBuffer buf = dac1.dequeue();

        // Write data to buffer (Even position: 0, Odd position: 0xFFF)
        for (int i=0; i<buf.size(); i++) {
            buf.data()[i] =  (i % 2 == 0) ? 0: 0xFFF;
        }

        // Write the buffer to DAC
        dac1.write(buf);
    }
}

I2S

To use this library for I2S application, you must have a supported Arduino board and include the AdvancedAnalog library in your Arduino sketch. Here is a minimal example for the Arduino GIGA R1 WiFi:

#include <Arduino_AdvancedAnalog.h>

// WS, CK, SDI, SDO, MCK
AdvancedI2S i2s(PG_10, PG_11, PG_9, PB_5, PC_4);

void setup() {
    Serial.begin(9600);

    // Resolution, sample rate, number of samples per channel, queue depth.
    if (!i2s.begin(AN_I2S_MODE_IN, 32000, 512, 32)) {
        Serial.println("Failed to start I2S");
        while (1);
    }
}

void loop() {
    if (i2s.available()) {
      SampleBuffer buf = i2s.read();
      // process samples.
      buf.release();
    }
}

Examples

• Beginner: This folder contains full applications, like audio playback and a waveform generator.
• Advanced: This folder contains more specific examples showing advanced API configurations.

API

The API documentation can be found here.

License

This library is released under the LGPLv2.1 license.