libxr  1.0
Want to be the best embedded framework
Loading...
Searching...
No Matches
Data Structures | Public Member Functions | Private Member Functions | Private Attributes
LibXR::STM32ADC Class Reference

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

#include <stm32_adc.hpp>

Collaboration diagram for LibXR::STM32ADC:
[legend]

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
hadcADC外设 ADC device
dma_buffDMA缓冲区 DMA buffer
channels通道号 Channel number
vref参考电压 Reference voltage

Definition at line 125 of file stm32_adc.hpp.

127 : hadc_(hadc),
128 NUM_CHANNELS(NumChannels),
129 filter_size_(dma_buff.size_ / NumChannels / 2),
130 use_dma_(hadc_->DMA_Handle != nullptr),
131 dma_buffer_(dma_buff),
132 resolution_(GetADCResolution<ADC_HandleTypeDef>{}.Get(hadc)),
133 channels_(new Channel[NumChannels]),
134 vref_(vref)
135 {
136 for (uint8_t i = 0; i < NUM_CHANNELS; ++i)
137 {
138 channels_[i] = Channel(this, i, channels[i]);
139 }
140
141 use_dma_ ? HAL_ADC_Start_DMA(hadc_, reinterpret_cast<uint32_t*>(dma_buffer_.addr_),
142 NUM_CHANNELS * filter_size_)
143 : HAL_ADC_Start(hadc_);
144 }
LibXR::RawData::addr_
void * addr_
数据存储地址。 The storage address of the data.
Definition libxr_type.hpp:114

◆ ~STM32ADC()

LibXR::STM32ADC::~STM32ADC ( )
inline

Definition at line 146 of file stm32_adc.hpp.

147 {
148 use_dma_ ? HAL_ADC_Stop_DMA(hadc_) : HAL_ADC_Stop(hadc_);
149 delete[] channels_;
150 }

Member Function Documentation

◆ ConvertToVoltage()

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

Definition at line 291 of file stm32_adc.hpp.

291{ 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.

158{ 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.

167 {
168 if (channel >= NUM_CHANNELS)
169 {
170 ASSERT(false);
171 return -1.0f;
172 }
173
174 uint16_t* buffer = reinterpret_cast<uint16_t*>(dma_buffer_.addr_);
175 if (use_dma_)
176 {
177#if __DCACHE_PRESENT
178 SCB_InvalidateDCache_by_Addr(buffer, filter_size_ * NUM_CHANNELS * 2);
179#endif
180 uint32_t sum = 0;
181 for (uint8_t i = 0; i < filter_size_; ++i)
182 {
183 sum += buffer[channel + i * NUM_CHANNELS];
184 }
185 return ConvertToVoltage(static_cast<float>(sum) / static_cast<float>(filter_size_));
186 }
187
188 ADC_ChannelConfTypeDef config = {};
189 uint32_t time = 0;
190 UNUSED(time);
191#if defined(ADC_SAMPLETIME_16CYCLES)
192 time = ADC_SAMPLETIME_16CYCLES;
193#elif defined(ADC_SAMPLETIME_16CYCLES_5)
194 time = ADC_SAMPLETIME_16CYCLES_5;
195#elif defined(ADC_SAMPLETIME_17CYCLES)
196 time = ADC_SAMPLETIME_17CYCLES;
197#elif defined(ADC_SAMPLETIME_17CYCLES_5)
198 time = ADC_SAMPLETIME_17CYCLES_5;
199#elif defined(ADC_SAMPLETIME_18CYCLES)
200 time = ADC_SAMPLETIME_18CYCLES;
201#elif defined(ADC_SAMPLETIME_18CYCLES_5)
202 time = ADC_SAMPLETIME_18CYCLES_5;
203#elif defined(ADC_SAMPLETIME_19CYCLES)
204 time = ADC_SAMPLETIME_19CYCLES;
205#elif defined(ADC_SAMPLETIME_19CYCLES_5)
206 time = ADC_SAMPLETIME_19CYCLES_5;
207#elif defined(ADC_SAMPLETIME_20CYCLES)
208 time = ADC_SAMPLETIME_20CYCLES;
209#elif defined(ADC_SAMPLETIME_20CYCLES_5)
210 time = ADC_SAMPLETIME_20CYCLES_5;
211#elif defined(ADC_SAMPLETIME_21CYCLES)
212 time = ADC_SAMPLETIME_21CYCLES;
213#elif defined(ADC_SAMPLETIME_21CYCLES_5)
214 time = ADC_SAMPLETIME_21CYCLES_5;
215#elif defined(ADC_SAMPLETIME_22CYCLES)
216 time = ADC_SAMPLETIME_22CYCLES;
217#elif defined(ADC_SAMPLETIME_22CYCLES_5)
218 time = ADC_SAMPLETIME_22CYCLES_5;
219#elif defined(ADC_SAMPLETIME_23CYCLES)
220 time = ADC_SAMPLETIME_23CYCLES;
221#elif defined(ADC_SAMPLETIME_23CYCLES_5)
222 time = ADC_SAMPLETIME_23CYCLES_5;
223#elif defined(ADC_SAMPLETIME_24CYCLES)
224 time = ADC_SAMPLETIME_24CYCLES;
225#elif defined(ADC_SAMPLETIME_24CYCLES_5)
226 time = ADC_SAMPLETIME_24CYCLES_5;
227#elif defined(ADC_SAMPLETIME_25CYCLES)
228 time = ADC_SAMPLETIME_25CYCLES;
229#elif defined(ADC_SAMPLETIME_25CYCLES_5)
230 time = ADC_SAMPLETIME_25CYCLES_5;
231#elif defined(ADC_SAMPLETIME_26CYCLES)
232 time = ADC_SAMPLETIME_26CYCLES;
233#elif defined(ADC_SAMPLETIME_26CYCLES_5)
234 time = ADC_SAMPLETIME_26CYCLES_5;
235#elif defined(ADC_SAMPLETIME_27CYCLES)
236 time = ADC_SAMPLETIME_27CYCLES;
237#elif defined(ADC_SAMPLETIME_27CYCLES_5)
238 time = ADC_SAMPLETIME_27CYCLES_5;
239#elif defined(ADC_SAMPLETIME_28CYCLES)
240 time = ADC_SAMPLETIME_28CYCLES;
241#elif defined(ADC_SAMPLETIME_28CYCLES_5)
242 time = ADC_SAMPLETIME_28CYCLES_5;
243#elif defined(ADC_SAMPLETIME_29CYCLES)
244 time = ADC_SAMPLETIME_29CYCLES;
245#elif defined(ADC_SAMPLETIME_29CYCLES_5)
246 time = ADC_SAMPLETIME_29CYCLES_5;
247#elif defined(ADC_SAMPLETIME_30CYCLES)
248 time = ADC_SAMPLETIME_30CYCLES;
249#elif defined(ADC_SAMPLETIME_30CYCLES_5)
250 time = ADC_SAMPLETIME_30CYCLES_5;
251#elif defined(ADC_SAMPLETIME_31CYCLES)
252 time = ADC_SAMPLETIME_31CYCLES;
253#elif defined(ADC_SAMPLETIME_31CYCLES_5)
254 time = ADC_SAMPLETIME_31CYCLES_5;
255#elif defined(ADC_SAMPLETIME_32CYCLES)
256 time = ADC_SAMPLETIME_32CYCLES;
257#elif defined(ADC_SAMPLETIME_32CYCLES_5)
258 time = ADC_SAMPLETIME_32CYCLES_5;
259#error "Unsupported sample time"
260#endif
261
262 config.Channel = channels_[channel].ch_;
263 config.Rank = 1;
264#if !defined(STM32L0)
265 config.SamplingTime = time;
266#endif
267
268 HAL_ADC_ConfigChannel(hadc_, &config);
269
270 uint32_t sum = 0;
271 for (uint8_t i = 0; i < filter_size_; ++i)
272 {
273 HAL_ADC_Start(hadc_);
274 HAL_ADC_PollForConversion(hadc_, 20);
275 buffer[channel + i * NUM_CHANNELS] = HAL_ADC_GetValue(hadc_);
276 sum += buffer[channel + i * NUM_CHANNELS];
277 }
278 return ConvertToVoltage(static_cast<float>(sum) / static_cast<float>(filter_size_));
279 }

Field Documentation

◆ channels_

Channel* LibXR::STM32ADC::channels_
private

Definition at line 288 of file stm32_adc.hpp.

◆ dma_buffer_

RawData LibXR::STM32ADC::dma_buffer_
private

Definition at line 286 of file stm32_adc.hpp.

◆ filter_size_

uint8_t LibXR::STM32ADC::filter_size_
private

Definition at line 284 of file stm32_adc.hpp.

◆ hadc_

ADC_HandleTypeDef* LibXR::STM32ADC::hadc_
private

Definition at line 282 of file stm32_adc.hpp.

◆ NUM_CHANNELS

const uint8_t LibXR::STM32ADC::NUM_CHANNELS
private

Definition at line 283 of file stm32_adc.hpp.

◆ resolution_

float LibXR::STM32ADC::resolution_
private

Definition at line 287 of file stm32_adc.hpp.

◆ use_dma_

bool LibXR::STM32ADC::use_dma_
private

Definition at line 285 of file stm32_adc.hpp.

◆ vref_

float LibXR::STM32ADC::vref_
private

Definition at line 289 of file stm32_adc.hpp.

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