AutoAnalogAudio.h

Go to the documentation of this file.

/*
AutoAnalogAudio streaming via DAC & ADC by TMRh20
Copyright (C) 2016-2024  TMRh20 - tmrh20@gmail.com, github.com/TMRh20
 
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
 
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.
 
You should have received a copy of the GNU General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>.
*/
#ifndef __AUTO_ANALOG_H__
    #define __AUTO_ANALOG_H__
 
    #include "AutoAnalog_config.h"
    #if defined(ESP32)
        #include "driver/i2s.h"
    #endif
 
    #define AAA_CHANNEL0    0
    #define AAA_CHANNEL1    1
    #define AAA_MODE_STEREO 2
 
class AutoAnalog
{
 
public:
 
    AutoAnalog();
 
    void begin(uint8_t enADC, uint8_t enDAC, uint8_t _useI2S = 0);
 
    void triggerADC();
 
    void getADC(uint32_t samples = MAX_BUFFER_SIZE);
 
    void feedDAC(uint8_t dacChannel = 0, uint32_t samples = MAX_BUFFER_SIZE, bool startInterrupts = false);
 
    #if !defined ARDUINO_ARCH_RENESAS
    uint8_t dacBuffer[MAX_BUFFER_SIZE];
    #else
    static uint8_t dacBuffer[MAX_BUFFER_SIZE]; 
    #endif
    #if !defined(ARDUINO_ARCH_NRF52840) && !defined(ARDUINO_ARCH_NRF52) && !defined ARDUINO_NRF52840_FEATHER && !defined ARDUINO_NRF54L15 && !defined ARDUINO_ARCH_RENESAS
    uint8_t adcBuffer[MAX_BUFFER_SIZE];
    #elif defined __MBED__
    inline static uint8_t adcBuffer[MAX_BUFFER_SIZE];
    #else
    static uint8_t adcBuffer[MAX_BUFFER_SIZE];
    #endif
 
    uint16_t dacBuffer16[MAX_BUFFER_SIZE];
 
    #if !defined(ARDUINO_ARCH_NRF52840) && !defined(ARDUINO_ARCH_NRF52) && !defined ARDUINO_NRF52840_FEATHER && !defined ARDUINO_NRF54L15 && !defined ARDUINO_ARCH_RENESAS
    uint16_t adcBuffer16[MAX_BUFFER_SIZE];
    #elif defined __MBED__
    inline static uint16_t adcBuffer16[MAX_BUFFER_SIZE];
    #else
    static uint16_t adcBuffer16[MAX_BUFFER_SIZE];
    #endif
 
    void setSampleRate(uint32_t sampRate = 0, bool stereo = false);
 
    void dacHandler(void);
 
    bool autoAdjust;
 
    #if !defined(ARDUINO_ARCH_NRF52840) && !defined(ARDUINO_ARCH_NRF52) && !defined ARDUINO_NRF52840_FEATHER && !defined ARDUINO_NRF54L15 && !defined ARDUINO_ARCH_RENESAS
    uint8_t adcBitsPerSample;
    #elif defined __MBED__
    inline static uint8_t adcBitsPerSample;
    #else
    static uint8_t adcBitsPerSample;
    #endif
 
    uint8_t dacBitsPerSample;
 
    void enableAdcChannel(uint8_t pinAx);
 
    void disableAdcChannel(uint8_t pinAx);
 
    void disableDAC(bool withinTask = false);
 
    void adcInterrupts(bool enabled = true);
 
    void dacInterrupts(bool enabled = true, bool withinTask = false);
 
    #if defined(ESP32) || defined(DOXYGEN_FORCED)
    void rampOut(uint8_t sample);
    void rampIn(uint8_t sample);
    TaskHandle_t dacTaskHandle;
    #endif
 
    #if defined(ARDUINO_ARCH_NRF52840) || defined(ARDUINO_ARCH_NRF52) && !defined ARDUINO_NRF52840_FEATHER && defined __MBED__
    inline static uint8_t aCtr;
    inline static uint32_t aSize;
    inline static uint16_t* adcBuf0 = NULL;
    inline static uint16_t* adcBuf1 = NULL;
    inline static void (*_onReceive)(uint16_t* buf, uint32_t buf_len) = NULL;
    inline static void adcCallback(uint16_t* buf, uint32_t buf_len);
    inline static void set_callback(void (*function)(uint16_t* buf, uint32_t buf_len));
    inline static bool adcReady;
    inline static uint16_t* dacBuf0;
    inline static uint16_t* dacBuf1;
    inline static uint32_t sampleCounter;
    uint8_t enableADC;
    uint8_t enableDAC;
    bool whichBuf;
    inline static bool adcWhichBuf;
 
    #elif defined(ARDUINO_ARCH_NRF52840) || defined(ARDUINO_ARCH_NRF52) || defined ARDUINO_NRF54L15 || defined(ARDUINO_NRF52840_FEATHER) && !defined __MBED__
    uint16_t* dacBuf0;
    uint16_t* dacBuf1;
    static uint8_t aCtr;
    static uint32_t aSize;
    static uint16_t* adcBuf0;
    static uint16_t* adcBuf1;
    static void (*_onReceive)(uint16_t* buf, uint32_t buf_len);
    static void adcCallback(uint16_t* buf, uint32_t buf_len);
    void set_callback(void (*function)(uint16_t* buf, uint32_t buf_len));
    static bool adcReady;
    uint32_t sampleCounter;
    uint8_t enableADC;
    uint8_t enableDAC;
    bool whichBuf;
    static bool adcWhichBuf;
    
    #elif defined ARDUINO_ARCH_RENESAS
    static volatile uint16_t* dacBuf0;
    static volatile uint16_t* dacBuf1;
    volatile static uint8_t aCtr;
    static volatile uint32_t aSize;
    static uint16_t* adcBuf0;
    static uint16_t* adcBuf1;
    static void (*_onReceive)(uint16_t* buf, uint32_t buf_len);
    static void adcCallback(uint16_t* buf, uint32_t buf_len);
    void set_callback(void (*function)(uint16_t* buf, uint32_t buf_len));
    static volatile bool adcReady;
    static volatile uint32_t sampleCounter;
    uint8_t enableADC;
    uint8_t enableDAC;
    bool whichBuf;
    static volatile bool adcWhichBuf;
    static volatile uint32_t sCounter;
    bool dacDisabled;
    static volatile uint8_t analogChannel;
    #endif
 
    #if defined(ARDUINO_ARCH_NRF52840) || defined(ARDUINO_ARCH_NRF52) || defined ARDUINO_NRF54L15 || defined ARDUINO_ARCH_RENESAS || defined(DOXYGEN_FORCED)
    int pwrPin;
 
    int dinPin;
 
    int clkPin;
 
    int8_t gain;
 
    uint16_t I2S_PIN_MCK;
    uint8_t I2S_PORT_MCK;
    uint16_t I2S_PIN_SCK;
    uint8_t I2S_PORT_SCK;
    uint16_t I2S_PIN_LRCK;
    uint8_t I2S_PORT_LRCK;
    uint16_t I2S_PIN_SDOUT;
    uint8_t I2S_PORT_SDOUT;
    uint16_t I2S_PIN_SDIN;
    uint8_t I2S_PORT_SDIN;
 
    uint32_t maxBufferSize;
 
    bool manualI2S;
 
private:
    bool adcBuffersAllocated;
    bool dacBuffersAllocated;
    void startPwmI2sTimers();
    #endif
 
private:
    #if defined(ARDUINO_ARCH_SAM)
    bool whichDma = 0;
    bool whichDac;
    bool dacChan;
 
    uint8_t aCtr = 0;                  /* Internal counter for ADC data */
    uint16_t realBuf[MAX_BUFFER_SIZE]; /* Internal DAC buffer */
    uint16_t adcDma[MAX_BUFFER_SIZE];  /* Buffers for ADC DMA transfers */
    uint16_t dataReady;                /* Internal indicator for DAC data */
 
    uint32_t dataTimer;     /* Internal timer tracks timing of incoming data */
    uint32_t sampleCount;   /* Internal counter for delaying analysis of timing */
    uint32_t tcTicks;       /* Stores the current TC0 Ch0 counter value */
    uint32_t tcTicks2;      /* Stores the current TC0 Ch1 counter value */
    uint32_t adjustDivider; /* Internal variables for adjusting timers on-the-fly */
 
    uint32_t dacNumSamples; /* Internal variable for number of samples sent to the DAC */
    uint32_t adcNumSamples;
    uint16_t adjustCtr;  /* Internal variables for adjusting timers on-the-fly */
    uint16_t adjustCtr2; /* Internal variables for adjusting timers on-the-fly */
    uint32_t adcLastAdjust;
    #endif
    void adcSetup(void); /* Enable the ADC */
    void dacSetup(void); /* Enable the DAC */
 
    void dacBufferStereo(uint8_t dacChannel);
 
    void tcSetup(uint32_t sampRate = 0);  /* Sets up Timer TC0 Channel 0 */
    void tc2Setup(uint32_t sampRate = 0); /* Sets up Timer TC0 Channel 1 */
 
    uint32_t frequencyToTimerCount(uint32_t Frequency); /* Function to calculate timer counters */
 
    #if defined ESP32
 
    uint32_t sampleRate;
    i2s_config_t i2s_cfg;
 
    bool i2sStopped;
    adc1_channel_t adcChannel;
 
    bool taskCreated;
 
    bool dacEnabled;
    uint8_t lastDacSample;
    i2s_event_t myI2SQueue[5];
    //void dacTask(void *args);
 
    bool adcTaskCreated;
    bool adcDisabled;
 
        #define DELAY_250MS (250 / portTICK_PERIOD_MS)
 
    #endif
};
 
#endif