adc.h

Go to the documentation of this file.

 
#pragma once
 
#include <vector>
#include <soc/gpio_num.h>
#include <esp_adc/adc_oneshot.h>
#include <esp_adc/adc_cali.h>
#include <freertos/FreeRTOS.h>
#include "include/log_sources.h"

namespace HAL::ADC {
    struct controller_config_t {
        adc_atten_t attenuation;
        adc_bitwidth_t bitwidth;
        adc_ulp_mode_t ulp_mode;
        adc_oneshot_clk_src_t clock_source;
    };

    class Controller {
    private:
        static constexpr const char* TAG = "HAL::ADC";
        static constexpr log_source LOG_SOURCE = LOG_SOURCE_HAL_ADC;
 
        mutable SemaphoreHandle_t mutex;
 
        controller_config_t config;
        bool is_configured;
 
        adc_oneshot_unit_handle_t adc_handle = nullptr;
        adc_cali_handle_t cali_handle = nullptr;
 
        std::vector<adc_channel_t> registered_channels;
 
    private:
        explicit Controller();
        ~Controller();

        static gpio_num_t adc_channel_to_gpio(const adc_channel_t adc_channel) {
            switch (adc_channel) {
                case ADC_CHANNEL_0: return GPIO_NUM_36;
                case ADC_CHANNEL_3: return GPIO_NUM_39;
                case ADC_CHANNEL_4: return GPIO_NUM_32;
                case ADC_CHANNEL_5: return GPIO_NUM_33;
                case ADC_CHANNEL_6: return GPIO_NUM_34;
                case ADC_CHANNEL_7: return GPIO_NUM_35;
                default: return GPIO_NUM_NC;
            }
        }
 
    public:
        Controller(const Controller&) = delete;
        Controller& operator=(const Controller&) = delete;

        static Controller& get_instance() {
            static Controller _instance;
            return _instance;
        }

        void configure(const controller_config_t& config);

        void shutdown();

        void add(adc_channel_t adc_channel);

        [[nodiscard]] uint16_t read_raw(adc_channel_t adc_channel, uint16_t samples = 1) const;

        [[nodiscard]] uint16_t read_millivolts(adc_channel_t adc_channel, uint16_t samples = 1) const;
    };
}