ADC_InjectionConfTypeDef 结构体参考

ADC 注入组及分配给 ADC 注入组的 ADC 通道的结构体定义。 更多...

#include <stm32g4xx_hal_adc_ex.h>

数据字段
uint32_t	InjectedChannel
uint32_t	InjectedRank
uint32_t	InjectedSamplingTime
uint32_t	InjectedSingleDiff
uint32_t	InjectedOffsetNumber
uint32_t	InjectedOffset
uint32_t	InjectedOffsetSign
FunctionalState	InjectedOffsetSaturation
uint32_t	InjectedNbrOfConversion
FunctionalState	InjectedDiscontinuousConvMode
FunctionalState	AutoInjectedConv
FunctionalState	QueueInjectedContext
uint32_t	ExternalTrigInjecConv
uint32_t	ExternalTrigInjecConvEdge
FunctionalState	InjecOversamplingMode
ADC_InjOversamplingTypeDef	InjecOversampling

---

详细描述

ADC 注入组及分配给 ADC 注入组的 ADC 通道的结构体定义。

注意：

此结构体的参数在 2 个作用域内共享：

• 通道作用域：InjectedChannel、InjectedRank、InjectedSamplingTime、InjectedSingleDiff、InjectedOffsetNumber、InjectedOffset、InjectedOffsetSign、InjectedOffsetSaturation
• ADC 注入组作用域（影响注入组的所有通道）：InjectedNbrOfConversion、InjectedDiscontinuousConvMode、AutoInjectedConv、QueueInjectedContext、ExternalTrigInjecConv、ExternalTrigInjecConvEdge、InjecOversamplingMode、InjecOversampling。

通过函数 HAL_ADCEx_InjectedConfigChannel() 设置这些参数受 ADC 状态限制。ADC 状态可以是：

• 对于所有参数：ADC 已禁用（这是修改参数 'InjectedSingleDiff' 的唯一可能 ADC 状态）
• 对于参数 'InjectedDiscontinuousConvMode'、'QueueInjectedContext'、'InjecOversampling'：ADC 已启用且注入组上没有正在进行的转换。
• 对于参数 'InjectedSamplingTime'、'InjectedOffset'、'InjectedOffsetNumber'、'InjectedOffsetSign'、'InjectedOffsetSaturation'、'AutoInjectedConv'：ADC 已启用且常规组和注入组上都没有正在进行的转换。
• 对于参数 'InjectedChannel'、'InjectedRank'、'InjectedNbrOfConversion'、'ExternalTrigInjecConv'、'ExternalTrigInjecConvEdge'：ADC 已启用且在 ADC 常规组和注入组上正在进行转换。如果 ADC 不处于适当的状态以修改某些参数，则这些参数设置将被跳过，不报告错误（因为在预期操作中，可能需要在运行时更新另一个参数（满足 ADC 状态条件））。

定义位于文件 stm32g4xx_hal_adc_ex.h 的第 80 行。

---

字段文档

FunctionalState ADC_InjectionConfTypeDef::AutoInjectedConv

启用或禁用所选 ADC 注入组在常规转换之后的自动转换。此参数可设置为 ENABLE 或 DISABLE。注意：要使用自动注入转换，必须禁用非连续模式（'DiscontinuousConvMode' 和 'InjectedDiscontinuousConvMode' 设置为 DISABLE）。注意：要使用自动注入转换，必须禁用注入组外部触发（'ExternalTrigInjecConv' 设置为 ADC_INJECTED_SOFTWARE_START）。注意：在常规组使用 DMA 的情况下：如果 DMA 配置为正常模式（单次传输），则在 DMA 传输完成时 JAUTO 将停止。要始终保持 JAUTO 启用，必须将 DMA 配置为循环模式。注意：此设置影响整个注入组。因此，调用 HAL_ADCEx_InjectedConfigChannel() 配置注入组上的通道可能会影响先前设置的其他通道的配置。

定义位于文件 stm32g4xx_hal_adc_ex.h 的第 182 行。

由 HAL_ADCEx_InjectedConfigChannel() 引用。

uint32_t ADC_InjectionConfTypeDef::ExternalTrigInjecConv

选择用于触发注入组转换开始的外部事件。如果设置为 ADC_INJECTED_SOFTWARE_START，则禁用外部触发，改用软件触发。此参数可以是 ADC 注入组触发源 的值。注意：此设置影响整个注入组。因此，调用 HAL_ADCEx_InjectedConfigChannel() 配置注入组上的通道可能会影响先前设置的其他通道的配置。

定义位于文件 stm32g4xx_hal_adc_ex.h 的第 220 行。

由 HAL_ADCEx_InjectedConfigChannel() 引用。

uint32_t ADC_InjectionConfTypeDef::ExternalTrigInjecConvEdge

选择注入组的外部触发边沿。此参数可以是 ADC 注入组触发边沿（当选择外部触发时） 的值。如果触发源设置为 ADC_INJECTED_SOFTWARE_START，则忽略此参数。注意：此设置影响整个注入组。因此，调用 HAL_ADCEx_InjectedConfigChannel() 配置注入组上的通道可能会影响先前设置的其他通道的配置。

定义位于文件 stm32g4xx_hal_adc_ex.h 的第 231 行。

由 HAL_ADCEx_InjectedConfigChannel() 引用。

ADC_InjOversamplingTypeDef ADC_InjectionConfTypeDef::InjecOversampling

指定过采样参数。注意：如果过采样已启用，此设置将覆盖先前的过采样配置。注意：此参数只能在没有转换正在进行时修改（ADSTART 和 JADSTART 均已清除）。

定义位于文件 stm32g4xx_hal_adc_ex.h 的第 245 行。

由 HAL_ADCEx_InjectedConfigChannel() 引用。

FunctionalState ADC_InjectionConfTypeDef::InjecOversamplingMode

指定过采样功能是启用还是禁用。此参数可设置为 ENABLE 或 DISABLE。注意：此参数只能在没有转换正在进行时修改（ADSTART 和 JADSTART 均已清除）。

定义位于文件 stm32g4xx_hal_adc_ex.h 的第 240 行。

由 HAL_ADCEx_InjectedConfigChannel() 引用。

uint32_t ADC_InjectionConfTypeDef::InjectedChannel

指定要配置到 ADC 注入组的通道。此参数可以是 ADC 实例 - 通道号 的值。注意：根据设备和 ADC 实例，某些通道可能在设备封装引脚上不可用。请参阅设备数据手册了解通道可用性。

定义位于文件 stm32g4xx_hal_adc_ex.h 的第 82 行。

由 HAL_ADCEx_InjectedConfigChannel() 引用。

FunctionalState ADC_InjectionConfTypeDef::InjectedDiscontinuousConvMode

指定 ADC 注入组的转换序列是以完整序列/非连续序列（主序列细分为连续部分）执行。非连续模式仅在序列器启用时使用（参数 'ScanConvMode'）。如果序列器禁用，则忽略此参数。非连续模式只能在连续模式禁用时启用。此参数可设置为 ENABLE 或 DISABLE。注意：此参数必须在 ADC 禁用时修改（在 ADC 开始转换之前或 ADC 停止转换之后）。注意：对于注入组，非连续模式逐通道转换序列（非连续长度固定为 1 个排名）。注意：此设置影响整个注入组。因此，调用 HAL_ADCEx_InjectedConfigChannel() 配置注入组上的通道可能会影响先前设置的其他通道的配置。

定义位于文件 stm32g4xx_hal_adc_ex.h 的第 166 行。

由 HAL_ADCEx_InjectedConfigChannel() 引用。

uint32_t ADC_InjectionConfTypeDef::InjectedNbrOfConversion

指定将在 ADC 注入组序列器内转换的排名数量。要使用注入组序列器并转换多个排名，必须启用参数 'ScanConvMode'。此参数必须是介于 Min_Data = 1 和 Max_Data = 4 之间的数字。注意：此设置影响整个注入组。因此，调用 HAL_ADCEx_InjectedConfigChannel() 配置注入组上的通道可能会影响先前设置的其他通道的配置。

定义位于文件 stm32g4xx_hal_adc_ex.h 的第 156 行。

由 HAL_ADCEx_InjectedConfigChannel() 引用。

uint32_t ADC_InjectionConfTypeDef::InjectedOffset

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

定义位于文件 stm32g4xx_hal_adc_ex.h 的第 132 行。

由 HAL_ADCEx_InjectedConfigChannel() 引用。

uint32_t ADC_InjectionConfTypeDef::InjectedOffsetNumber

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

定义位于文件 stm32g4xx_hal_adc_ex.h 的第 127 行。

由 HAL_ADCEx_InjectedConfigChannel() 引用。