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
	STM32ADC (ADC_HandleTypeDef *hadc, RawData dma_buff, std::initializer_list< uint32_t > channels, float vref)
	STM32ADC 类，用于处理 STM32 系统的 ADC 通道。 Provides handling for STM32.
	~STM32ADC ()
	析构函数 Destructor
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 24 of file stm32_adc.hpp.

Constructor & Destructor Documentation

STM32ADC()

STM32ADC::STM32ADC	(	ADC_HandleTypeDef *	hadc,
		RawData	dma_buff,
		std::initializer_list< uint32_t >	channels,
		float	vref )

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

Parameters

hadc	ADC外设 ADC device
dma_buff	DMA缓冲区 DMA buffer
channels	ADC通道列表 List of ADC channels
vref	参考电压 Reference voltage

Definition at line 14 of file stm32_adc.cpp.

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

~STM32ADC()

STM32ADC::~STM32ADC

(

)

析构函数 Destructor

Definition at line 36 of file stm32_adc.cpp.

{
  use_dma_ ? HAL_ADC_Stop_DMA(hadc_) : HAL_ADC_Stop(hadc_);
  for (uint8_t i = 0; i < NUM_CHANNELS; ++i)
  {
    delete channels_[i];
  }
  delete[] channels_;
}

Member Function Documentation

ConvertToVoltage()

float STM32ADC::ConvertToVoltage ( float adc_value )

private

Definition at line 163 of file stm32_adc.cpp.

{
  return adc_value * vref_ / resolution_;
}

GetChannel()

STM32ADC::Channel & STM32ADC::GetChannel

(

uint8_t

index

)

获取 ADC 通道对象 Get ADC channel object

Parameters

index

通道索引 Channel index

Returns

Channel& 通道对象 Channel object

Definition at line 46 of file stm32_adc.cpp.

{ return *channels_[index]; }

ReadChannel()

float STM32ADC::ReadChannel

(

uint8_t

channel

)

读取 ADC 值

Parameters

channel

通道号 Channel number

Returns

float

Definition at line 48 of file stm32_adc.cpp.

{
  if (channel >= NUM_CHANNELS)
  {
    ASSERT(false);
    return -1.0f;
  }
 
  uint16_t* buffer = reinterpret_cast<uint16_t*>(dma_buffer_.addr_);
  if (use_dma_)
  {
#if defined(__DCACHE_PRESENT) && (__DCACHE_PRESENT == 1U)
    SCB_InvalidateDCache_by_Addr(buffer, filter_size_ * NUM_CHANNELS * 2);
#endif
    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 154 of file stm32_adc.hpp.

dma_buffer_

RawData LibXR::STM32ADC::dma_buffer_

private

Definition at line 152 of file stm32_adc.hpp.

filter_size_

uint8_t LibXR::STM32ADC::filter_size_

private

Definition at line 150 of file stm32_adc.hpp.

hadc_

ADC_HandleTypeDef* LibXR::STM32ADC::hadc_

private

Definition at line 148 of file stm32_adc.hpp.

NUM_CHANNELS

const uint8_t LibXR::STM32ADC::NUM_CHANNELS

private

Definition at line 149 of file stm32_adc.hpp.

resolution_

float LibXR::STM32ADC::resolution_

private

Definition at line 153 of file stm32_adc.hpp.

use_dma_

bool LibXR::STM32ADC::use_dma_

private

Definition at line 151 of file stm32_adc.hpp.

vref_

float LibXR::STM32ADC::vref_

private

Definition at line 155 of file stm32_adc.hpp.

---

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

• driver/st/stm32_adc.hpp
• driver/st/stm32_adc.cpp