LibXR::STM32ADC Class Reference

STM32ADC 类，用于处理 STM32 系统的 ADC 通道。 Provides handling for STM32 ADC channels. More...

#include <stm32_adc.hpp>

Collaboration diagram for LibXR::STM32ADC:

Data Structures
class	Channel
	STM32ADC 类，用于处理 STM32 系统的 ADC 通道。 Provides handling for STM32 ADC. More...
struct	GetADCResolution
	获取 ADC 分辨率 Get ADC resolution More...
struct	GetADCResolution< T, std::void_t< decltype(std::declval< T >().Init.Resolution)> >
	获取 ADC 分辨率 Get ADC resolution More...

Public Member Functions
template<size_t NumChannels>
	STM32ADC (ADC_HandleTypeDef *hadc, RawData dma_buff, const std::array< uint32_t, NumChannels > &channels, float vref=3.3f)
	STM32ADC 类，用于处理 STM32 系统的 ADC 通道。 Provides handling for STM32.
Channel &	GetChannel (uint8_t index)
	获取 ADC 通道对象 Get ADC channel object
float	ReadChannel (uint8_t channel)
	读取 ADC 值

Private Member Functions
float	ConvertToVoltage (float adc_value)

Private Attributes
ADC_HandleTypeDef *	hadc_
const uint8_t	NUM_CHANNELS
uint8_t	filter_size_
bool	use_dma_
RawData	dma_buffer_
float	resolution_
Channel *	channels_
float	vref_

Detailed Description

STM32ADC 类，用于处理 STM32 系统的 ADC 通道。 Provides handling for STM32 ADC channels.

Definition at line 22 of file stm32_adc.hpp.

Constructor & Destructor Documentation

STM32ADC()

template<size_t NumChannels>

LibXR::STM32ADC::STM32ADC ( ADC_HandleTypeDef *  hadc, RawData  dma_buff, const std::array< uint32_t, NumChannels > &  channels, float  vref = 3.3f  )

inline

STM32ADC 类，用于处理 STM32 系统的 ADC 通道。 Provides handling for STM32.

Template Parameters

NumChannels

通道数量 Number of channels

Parameters

hadc	ADC外设 ADC device
dma_buff	DMA缓冲区 DMA buffer
channels	通道号 Channel number
vref	参考电压 Reference voltage

Definition at line 125 of file stm32_adc.hpp.

      : hadc_(hadc),
        NUM_CHANNELS(NumChannels),
        filter_size_(dma_buff.size_ / NumChannels / 2),
        use_dma_(hadc_->DMA_Handle != nullptr),
        dma_buffer_(dma_buff),
        resolution_(GetADCResolution<ADC_HandleTypeDef>{}.Get(hadc)),
        channels_(new Channel[NumChannels]),
        vref_(vref)
  {
    for (uint8_t i = 0; i < NUM_CHANNELS; ++i)
    {
      channels_[i] = Channel(this, i, channels[i]);
    }
 
    use_dma_ ? HAL_ADC_Start_DMA(hadc_, reinterpret_cast<uint32_t*>(dma_buffer_.addr_),
                                 NUM_CHANNELS * filter_size_)
             : HAL_ADC_Start(hadc_);
  }

~STM32ADC()

LibXR::STM32ADC::~STM32ADC ( )

inline

Definition at line 146 of file stm32_adc.hpp.

  {
    use_dma_ ? HAL_ADC_Stop_DMA(hadc_) : HAL_ADC_Stop(hadc_);
    delete[] channels_;
  }

Member Function Documentation

ConvertToVoltage()

float LibXR::STM32ADC::ConvertToVoltage ( float  adc_value )

inlineprivate

Definition at line 288 of file stm32_adc.hpp.

{ return adc_value * vref_ / resolution_; }

GetChannel()

Channel & LibXR::STM32ADC::GetChannel ( uint8_t  index )

inline

获取 ADC 通道对象 Get ADC channel object

Parameters

index

通道索引 Channel index

Returns

Channel& 通道对象 Channel object

Definition at line 158 of file stm32_adc.hpp.

{ return channels_[index]; }

ReadChannel()

float LibXR::STM32ADC::ReadChannel ( uint8_t  channel )

inline

读取 ADC 值

Parameters

channel

通道号 Channel number

Returns

float

Definition at line 166 of file stm32_adc.hpp.

  {
    if (channel >= NUM_CHANNELS)
    {
      ASSERT(false);
      return -1.0f;
    }
 
    uint16_t* buffer = reinterpret_cast<uint16_t*>(dma_buffer_.addr_);
    if (use_dma_)
    {
      uint32_t sum = 0;
      for (uint8_t i = 0; i < filter_size_; ++i)
      {
        sum += buffer[channel + i * NUM_CHANNELS];
      }
      return ConvertToVoltage(static_cast<float>(sum) / static_cast<float>(filter_size_));
    }
 
    ADC_ChannelConfTypeDef config = {};
    uint32_t time = 0;
    UNUSED(time);
#if defined(ADC_SAMPLETIME_16CYCLES)
    time = ADC_SAMPLETIME_16CYCLES;
#elif defined(ADC_SAMPLETIME_16CYCLES_5)
    time = ADC_SAMPLETIME_16CYCLES_5;
#elif defined(ADC_SAMPLETIME_17CYCLES)
    time = ADC_SAMPLETIME_17CYCLES;
#elif defined(ADC_SAMPLETIME_17CYCLES_5)
    time = ADC_SAMPLETIME_17CYCLES_5;
#elif defined(ADC_SAMPLETIME_18CYCLES)
    time = ADC_SAMPLETIME_18CYCLES;
#elif defined(ADC_SAMPLETIME_18CYCLES_5)
    time = ADC_SAMPLETIME_18CYCLES_5;
#elif defined(ADC_SAMPLETIME_19CYCLES)
    time = ADC_SAMPLETIME_19CYCLES;
#elif defined(ADC_SAMPLETIME_19CYCLES_5)
    time = ADC_SAMPLETIME_19CYCLES_5;
#elif defined(ADC_SAMPLETIME_20CYCLES)
    time = ADC_SAMPLETIME_20CYCLES;
#elif defined(ADC_SAMPLETIME_20CYCLES_5)
    time = ADC_SAMPLETIME_20CYCLES_5;
#elif defined(ADC_SAMPLETIME_21CYCLES)
    time = ADC_SAMPLETIME_21CYCLES;
#elif defined(ADC_SAMPLETIME_21CYCLES_5)
    time = ADC_SAMPLETIME_21CYCLES_5;
#elif defined(ADC_SAMPLETIME_22CYCLES)
    time = ADC_SAMPLETIME_22CYCLES;
#elif defined(ADC_SAMPLETIME_22CYCLES_5)
    time = ADC_SAMPLETIME_22CYCLES_5;
#elif defined(ADC_SAMPLETIME_23CYCLES)
    time = ADC_SAMPLETIME_23CYCLES;
#elif defined(ADC_SAMPLETIME_23CYCLES_5)
    time = ADC_SAMPLETIME_23CYCLES_5;
#elif defined(ADC_SAMPLETIME_24CYCLES)
    time = ADC_SAMPLETIME_24CYCLES;
#elif defined(ADC_SAMPLETIME_24CYCLES_5)
    time = ADC_SAMPLETIME_24CYCLES_5;
#elif defined(ADC_SAMPLETIME_25CYCLES)
    time = ADC_SAMPLETIME_25CYCLES;
#elif defined(ADC_SAMPLETIME_25CYCLES_5)
    time = ADC_SAMPLETIME_25CYCLES_5;
#elif defined(ADC_SAMPLETIME_26CYCLES)
    time = ADC_SAMPLETIME_26CYCLES;
#elif defined(ADC_SAMPLETIME_26CYCLES_5)
    time = ADC_SAMPLETIME_26CYCLES_5;
#elif defined(ADC_SAMPLETIME_27CYCLES)
    time = ADC_SAMPLETIME_27CYCLES;
#elif defined(ADC_SAMPLETIME_27CYCLES_5)
    time = ADC_SAMPLETIME_27CYCLES_5;
#elif defined(ADC_SAMPLETIME_28CYCLES)
    time = ADC_SAMPLETIME_28CYCLES;
#elif defined(ADC_SAMPLETIME_28CYCLES_5)
    time = ADC_SAMPLETIME_28CYCLES_5;
#elif defined(ADC_SAMPLETIME_29CYCLES)
    time = ADC_SAMPLETIME_29CYCLES;
#elif defined(ADC_SAMPLETIME_29CYCLES_5)
    time = ADC_SAMPLETIME_29CYCLES_5;
#elif defined(ADC_SAMPLETIME_30CYCLES)
    time = ADC_SAMPLETIME_30CYCLES;
#elif defined(ADC_SAMPLETIME_30CYCLES_5)
    time = ADC_SAMPLETIME_30CYCLES_5;
#elif defined(ADC_SAMPLETIME_31CYCLES)
    time = ADC_SAMPLETIME_31CYCLES;
#elif defined(ADC_SAMPLETIME_31CYCLES_5)
    time = ADC_SAMPLETIME_31CYCLES_5;
#elif defined(ADC_SAMPLETIME_32CYCLES)
    time = ADC_SAMPLETIME_32CYCLES;
#elif defined(ADC_SAMPLETIME_32CYCLES_5)
    time = ADC_SAMPLETIME_32CYCLES_5;
#error "Unsupported sample time"
#endif
 
    config.Channel = channels_[channel].ch_;
    config.Rank = 1;
#if !defined(STM32L0)
    config.SamplingTime = time;
#endif
 
    HAL_ADC_ConfigChannel(hadc_, &config);
 
    uint32_t sum = 0;
    for (uint8_t i = 0; i < filter_size_; ++i)
    {
      HAL_ADC_Start(hadc_);
      HAL_ADC_PollForConversion(hadc_, 20);
      buffer[channel + i * NUM_CHANNELS] = HAL_ADC_GetValue(hadc_);
      sum += buffer[channel + i * NUM_CHANNELS];
    }
    return ConvertToVoltage(static_cast<float>(sum) / static_cast<float>(filter_size_));
  }

Field Documentation

channels_

Channel* LibXR::STM32ADC::channels_

private

Definition at line 285 of file stm32_adc.hpp.

dma_buffer_

RawData LibXR::STM32ADC::dma_buffer_

private

Definition at line 283 of file stm32_adc.hpp.

filter_size_

uint8_t LibXR::STM32ADC::filter_size_

private

Definition at line 281 of file stm32_adc.hpp.

hadc_

ADC_HandleTypeDef* LibXR::STM32ADC::hadc_

private

Definition at line 279 of file stm32_adc.hpp.

NUM_CHANNELS

const uint8_t LibXR::STM32ADC::NUM_CHANNELS

private

Definition at line 280 of file stm32_adc.hpp.

resolution_

float LibXR::STM32ADC::resolution_

private

Definition at line 284 of file stm32_adc.hpp.

use_dma_

bool LibXR::STM32ADC::use_dma_

private

Definition at line 282 of file stm32_adc.hpp.

vref_

float LibXR::STM32ADC::vref_

private

Definition at line 286 of file stm32_adc.hpp.

---

The documentation for this class was generated from the following file:

• driver/st/stm32_adc.hpp