STM32G474xx HAL 用户手册
数据域
ADC_ChannelConfTypeDef 结构体参考

常规组的ADC通道结构定义。 更多...

#include <stm32g4xx_hal_adc.h>

数据域

uint32_t Channel
uint32_t Rank
uint32_t SamplingTime
uint32_t SingleDiff
uint32_t OffsetNumber
uint32_t Offset
uint32_t OffsetSign
FunctionalState OffsetSaturation

详细描述

常规组的ADC通道结构定义。

注意:
通过函数HAL_ADC_ConfigChannel()设置这些参数受限于ADC状态。ADC状态可以是:
  • 对于所有参数:ADC已禁用(这是唯一可以修改参数'SingleDiff'的ADC状态)
  • 对于除'SamplingTime', 'Offset', 'OffsetNumber'之外的所有参数:ADC已使能,但常规组上没有进行中的转换。
  • 对于参数'SamplingTime', 'Offset', 'OffsetNumber':ADC已使能,但常规组和注入组上都没有进行中的转换。如果ADC未处于适合修改某些参数的状态,这些参数的设置将被忽略且不会报告错误(因为这在旨在动态更新另一个满足ADC状态条件的参数时可能是预期的行为)。

定义位于文件 stm32g4xx_hal_adc.h第 267 行.


字段文档

指定要配置到ADC常规组中的通道。该参数可以是 ADC 实例 - 通道编号 中的某个值。注意:根据设备和ADC实例的不同,某些通道可能在设备封装引脚上不可用。请参考设备数据手册了解通道可用性。

定义位于文件 stm32g4xx_hal_adc.h第 269 行.

被引用者 HAL_ADC_ConfigChannel().

定义要应用于原始转换数据的偏移量。偏移量必须是一个正数。根据所选的ADC分辨率(12、10、8或6位),该参数必须是在 Min_Data = 0x000 和 Max_Data = 0xFFF、0x3FF、0xFF 或 0x3F 之间的一个数。注意:当常规组和注入组都没有进行中转换时(ADC已禁用,或ADC已使能但没有连续模式或可能启动转换的外部触发),必须修改此参数。

定义位于文件 stm32g4xx_hal_adc.h第 317 行.

被引用者 HAL_ADC_ConfigChannel().

选择偏移量编号。该参数可以是 ADC 实例 - 偏移量编号 中的某个值。注意:每个通道只允许一个偏移量。此参数将覆盖上一次的设置。

定义位于文件 stm32g4xx_hal_adc.h第 312 行.

被引用者 HAL_ADC_ConfigChannel().

定义当发生上溢或下溢时,偏移量是否应饱和。该参数值可以是 ENABLE 或 DISABLE。注意:当常规组和注入组都没有进行中转换时(ADC已禁用,或ADC已使能但没有连续模式或可能启动转换的外部触发),必须修改此参数。

定义位于文件 stm32g4xx_hal_adc.h第 332 行.

被引用者 HAL_ADC_ConfigChannel().

定义偏移量应从原始转换数据中减去(负号)还是加上(正号)。该参数可以是 ADC 扩展偏移量符号 中的某个值。注意:当常规组和注入组都没有进行中转换时(ADC已禁用,或ADC已使能但没有连续模式或可能启动转换的外部触发),必须修改此参数。

定义位于文件 stm32g4xx_hal_adc.h第 326 行.

被引用者 HAL_ADC_ConfigChannel().

指定常规组序列中的顺序。该参数可以是 ADC 组常规 - 序列顺序 中的某个值。注意:要禁用一个通道或更改转换顺序,可以使用新的通道设置覆盖包含先前通道设置的顺序(或调整转换次数参数)。

定义位于文件 stm32g4xx_hal_adc.h第 275 行.

被引用者 HAL_ADC_ConfigChannel().

要为所选通道设置的采样时间值。单位:ADC时钟周期。转换时间是采样时间和处理时间(ADC分辨率12位时为12.5个ADC时钟周期,10位时为10.5个周期,8位时为8.5个周期,6位时为6.5个周期)之和。该参数可以是 通道 - 采样时间 中的某个值。注意:此参数适用于可在常规和/或注入组中使用的通道。它将覆盖上一次的设置。注意:如果使用内部测量通道(VrefInt、Vbat等),必须遵守采样时间限制(采样时间可以根据ADC时钟频率和采样时间设置进行调整)。时序值请参考设备数据手册。

定义位于文件 stm32g4xx_hal_adc.h第 281 行.

被引用者 HAL_ADC_ConfigChannel().

选择单端或差分输入。在差分模式下:在所选通道'i'(正输入)和通道'i+1'(负输入)之间进行差分测量。只需配置通道'i',通道'i+1'会自动配置。该参数必须是 通道 - 单端或差分输入 中的某个值。注意:此参数适用于可在常规和/或注入组中使用的通道。它将覆盖上一次的设置。注意:请参考参考手册以确保所选通道在差分模式下可用。注意:当将通道'i'配置为差分模式时,通道'i+1'不能单独使用。注意:此参数必须在ADC禁用时(在ADC开始转换之前或ADC停止转换之后)进行修改。如果ADC已使能,此参数设置将被忽略且不会报告错误(因为在动态更新另一个参数时这可能是预期的行为)。

定义位于文件 stm32g4xx_hal_adc.h第 294 行.

被引用者 HAL_ADC_ConfigChannel().


该结构体的文档由以下文件生成: