STM32L486xx HAL User Manual
|
Extended IO operation functions. More...
Functions | |
HAL_StatusTypeDef | HAL_ADCEx_Calibration_Start (ADC_HandleTypeDef *hadc, uint32_t SingleDiff) |
Perform an ADC automatic self-calibration Calibration prerequisite: ADC must be disabled (execute this function before HAL_ADC_Start() or after HAL_ADC_Stop() ). | |
uint32_t | HAL_ADCEx_Calibration_GetValue (ADC_HandleTypeDef *hadc, uint32_t SingleDiff) |
Get the calibration factor. | |
HAL_StatusTypeDef | HAL_ADCEx_Calibration_SetValue (ADC_HandleTypeDef *hadc, uint32_t SingleDiff, uint32_t CalibrationFactor) |
Set the calibration factor to overwrite automatic conversion result. | |
HAL_StatusTypeDef | HAL_ADCEx_InjectedStart (ADC_HandleTypeDef *hadc) |
Enable ADC, start conversion of injected group. | |
HAL_StatusTypeDef | HAL_ADCEx_InjectedStop (ADC_HandleTypeDef *hadc) |
Stop conversion of injected channels. | |
HAL_StatusTypeDef | HAL_ADCEx_InjectedPollForConversion (ADC_HandleTypeDef *hadc, uint32_t Timeout) |
Wait for injected group conversion to be completed. | |
HAL_StatusTypeDef | HAL_ADCEx_InjectedStart_IT (ADC_HandleTypeDef *hadc) |
Enable ADC, start conversion of injected group with interruption. | |
HAL_StatusTypeDef | HAL_ADCEx_InjectedStop_IT (ADC_HandleTypeDef *hadc) |
Stop conversion of injected channels, disable interruption of end-of-conversion. | |
HAL_StatusTypeDef | HAL_ADCEx_MultiModeStart_DMA (ADC_HandleTypeDef *hadc, uint32_t *pData, uint32_t Length) |
Enable ADC, start MultiMode conversion and transfer regular results through DMA. | |
HAL_StatusTypeDef | HAL_ADCEx_MultiModeStop_DMA (ADC_HandleTypeDef *hadc) |
Stop multimode ADC conversion, disable ADC DMA transfer, disable ADC peripheral. | |
uint32_t | HAL_ADCEx_MultiModeGetValue (ADC_HandleTypeDef *hadc) |
Return the last ADC Master and Slave regular conversions results when in multimode configuration. | |
uint32_t | HAL_ADCEx_InjectedGetValue (ADC_HandleTypeDef *hadc, uint32_t InjectedRank) |
Get ADC injected group conversion result. | |
__weak void | HAL_ADCEx_InjectedConvCpltCallback (ADC_HandleTypeDef *hadc) |
Injected conversion complete callback in non-blocking mode. | |
__weak void | HAL_ADCEx_InjectedQueueOverflowCallback (ADC_HandleTypeDef *hadc) |
Injected context queue overflow callback. | |
__weak void | HAL_ADCEx_LevelOutOfWindow2Callback (ADC_HandleTypeDef *hadc) |
Analog watchdog 2 callback in non-blocking mode. | |
__weak void | HAL_ADCEx_LevelOutOfWindow3Callback (ADC_HandleTypeDef *hadc) |
Analog watchdog 3 callback in non-blocking mode. | |
__weak void | HAL_ADCEx_EndOfSamplingCallback (ADC_HandleTypeDef *hadc) |
End Of Sampling callback in non-blocking mode. | |
HAL_StatusTypeDef | HAL_ADCEx_RegularStop (ADC_HandleTypeDef *hadc) |
Stop ADC conversion of regular group (and injected channels in case of auto_injection mode), disable ADC peripheral if no conversion is on going on injected group. | |
HAL_StatusTypeDef | HAL_ADCEx_RegularStop_IT (ADC_HandleTypeDef *hadc) |
Stop ADC conversion of ADC groups regular and injected, disable interrution of end-of-conversion, disable ADC peripheral if no conversion is on going on injected group. | |
HAL_StatusTypeDef | HAL_ADCEx_RegularStop_DMA (ADC_HandleTypeDef *hadc) |
Stop ADC conversion of regular group (and injected group in case of auto_injection mode), disable ADC DMA transfer, disable ADC peripheral if no conversion is on going on injected group. | |
HAL_StatusTypeDef | HAL_ADCEx_RegularMultiModeStop_DMA (ADC_HandleTypeDef *hadc) |
Stop DMA-based multimode ADC conversion, disable ADC DMA transfer, disable ADC peripheral if no injected conversion is on-going. |
Extended IO operation functions.
=============================================================================== ##### IO operation functions ##### =============================================================================== [..] This section provides functions allowing to: (+) Perform the ADC self-calibration for single or differential ending. (+) Get calibration factors for single or differential ending. (+) Set calibration factors for single or differential ending. (+) Start conversion of ADC group injected. (+) Stop conversion of ADC group injected. (+) Poll for conversion complete on ADC group injected. (+) Get result of ADC group injected channel conversion. (+) Start conversion of ADC group injected and enable interruptions. (+) Stop conversion of ADC group injected and disable interruptions. (+) When multimode feature is available, start multimode and enable DMA transfer. (+) Stop multimode and disable ADC DMA transfer. (+) Get result of multimode conversion.
uint32_t HAL_ADCEx_Calibration_GetValue | ( | ADC_HandleTypeDef * | hadc, |
uint32_t | SingleDiff | ||
) |
Get the calibration factor.
hadc | ADC handle. |
SingleDiff | This parameter can be only:
|
Calibration | value. |
Definition at line 224 of file stm32l4xx_hal_adc_ex.c.
References ADC_CALFACT_DIFF_GET, ADC_DIFFERENTIAL_ENDED, assert_param, __ADC_HandleTypeDef::Instance, and IS_ADC_SINGLE_DIFFERENTIAL.
HAL_StatusTypeDef HAL_ADCEx_Calibration_SetValue | ( | ADC_HandleTypeDef * | hadc, |
uint32_t | SingleDiff, | ||
uint32_t | CalibrationFactor | ||
) |
Set the calibration factor to overwrite automatic conversion result.
ADC must be enabled and no conversion is ongoing.
hadc | ADC handle |
SingleDiff | This parameter can be only:
|
CalibrationFactor | Calibration factor (coded on 7 bits maximum) |
HAL | state |
Definition at line 251 of file stm32l4xx_hal_adc_ex.c.
References ADC_CALFACT_DIFF_SET, ADC_DIFFERENTIAL_ENDED, ADC_IS_CONVERSION_ONGOING_REGULAR_INJECTED, ADC_IS_ENABLE, assert_param, __ADC_HandleTypeDef::ErrorCode, HAL_ADC_ERROR_INTERNAL, HAL_ADC_STATE_ERROR_CONFIG, __ADC_HandleTypeDef::Instance, IS_ADC_CALFACT, IS_ADC_SINGLE_DIFFERENTIAL, and __ADC_HandleTypeDef::State.
HAL_StatusTypeDef HAL_ADCEx_Calibration_Start | ( | ADC_HandleTypeDef * | hadc, |
uint32_t | SingleDiff | ||
) |
Perform an ADC automatic self-calibration Calibration prerequisite: ADC must be disabled (execute this function before HAL_ADC_Start() or after HAL_ADC_Stop() ).
hadc | ADC handle |
SingleDiff | Selection of single-ended or differential input This parameter can be one of the following values:
|
HAL | status |
Definition at line 145 of file stm32l4xx_hal_adc_ex.c.
References ADC_CALIBRATION_TIMEOUT, ADC_Disable(), ADC_STATE_CLR_SET, assert_param, HAL_ADC_STATE_BUSY_INTERNAL, HAL_ADC_STATE_ERROR_INTERNAL, HAL_ADC_STATE_INJ_BUSY, HAL_ADC_STATE_READY, HAL_ADC_STATE_REG_BUSY, __ADC_HandleTypeDef::Instance, IS_ADC_SINGLE_DIFFERENTIAL, and __ADC_HandleTypeDef::State.
void HAL_ADCEx_EndOfSamplingCallback | ( | ADC_HandleTypeDef * | hadc | ) |
End Of Sampling callback in non-blocking mode.
hadc | ADC handle |
None |
Definition at line 1202 of file stm32l4xx_hal_adc_ex.c.
Referenced by HAL_ADC_Init(), HAL_ADC_IRQHandler(), and HAL_ADC_UnRegisterCallback().
void HAL_ADCEx_InjectedConvCpltCallback | ( | ADC_HandleTypeDef * | hadc | ) |
Injected conversion complete callback in non-blocking mode.
hadc | ADC handle |
None |
Definition at line 1137 of file stm32l4xx_hal_adc_ex.c.
Referenced by HAL_ADC_Init(), HAL_ADC_IRQHandler(), and HAL_ADC_UnRegisterCallback().
uint32_t HAL_ADCEx_InjectedGetValue | ( | ADC_HandleTypeDef * | hadc, |
uint32_t | InjectedRank | ||
) |
Get ADC injected group conversion result.
hadc | ADC handle |
InjectedRank | the converted ADC injected rank. This parameter can be one of the following values:
|
ADC | group injected conversion data |
Definition at line 1102 of file stm32l4xx_hal_adc_ex.c.
References ADC_INJECTED_RANK_1, ADC_INJECTED_RANK_2, ADC_INJECTED_RANK_3, ADC_INJECTED_RANK_4, assert_param, __ADC_HandleTypeDef::Instance, and IS_ADC_INJECTED_RANK.
HAL_StatusTypeDef HAL_ADCEx_InjectedPollForConversion | ( | ADC_HandleTypeDef * | hadc, |
uint32_t | Timeout | ||
) |
Wait for injected group conversion to be completed.
hadc | ADC handle |
Timeout | Timeout value in millisecond. |
HAL | status |
Definition at line 493 of file stm32l4xx_hal_adc_ex.c.
References __HAL_ADC_CLEAR_FLAG, __HAL_ADC_GET_FLAG, ADC_EOC_SEQ_CONV, ADC_FLAG_JEOC, ADC_FLAG_JEOS, ADC_INDEPENDENT_OR_NONMULTIMODEINJECTED_SLAVE, ADC_IS_SOFTWARE_START_INJECTED, ADC_IS_SOFTWARE_START_REGULAR, ADC_MASTER_REGISTER, assert_param, ADC_InitTypeDef::EOCSelection, HAL_ADC_STATE_INJ_BUSY, HAL_ADC_STATE_INJ_EOC, HAL_ADC_STATE_READY, HAL_ADC_STATE_REG_BUSY, HAL_ADC_STATE_TIMEOUT, HAL_GetTick(), __ADC_HandleTypeDef::Init, __ADC_HandleTypeDef::Instance, and __ADC_HandleTypeDef::State.
void HAL_ADCEx_InjectedQueueOverflowCallback | ( | ADC_HandleTypeDef * | hadc | ) |
Injected context queue overflow callback.
hadc | ADC handle |
None |
Definition at line 1156 of file stm32l4xx_hal_adc_ex.c.
Referenced by HAL_ADC_Init(), HAL_ADC_IRQHandler(), and HAL_ADC_UnRegisterCallback().
HAL_StatusTypeDef HAL_ADCEx_InjectedStart | ( | ADC_HandleTypeDef * | hadc | ) |
Enable ADC, start conversion of injected group.
hadc | ADC handle. |
HAL | status |
Definition at line 307 of file stm32l4xx_hal_adc_ex.c.
References __HAL_ADC_CLEAR_FLAG, ADC_CLEAR_ERRORCODE, ADC_Enable(), ADC_FLAG_JEOC, ADC_FLAG_JEOS, ADC_INDEPENDENT_OR_NONMULTIMODEINJECTED_SLAVE, ADC_IS_CONVERSION_ONGOING_INJECTED, ADC_NONMULTIMODE_OR_MULTIMODEMASTER, ADC_STATE_CLR_SET, assert_param, __ADC_HandleTypeDef::ErrorCode, HAL_ADC_ERROR_JQOVF, HAL_ADC_STATE_ERROR_CONFIG, HAL_ADC_STATE_INJ_BUSY, HAL_ADC_STATE_INJ_EOC, HAL_ADC_STATE_MULTIMODE_SLAVE, HAL_ADC_STATE_READY, HAL_ADC_STATE_REG_BUSY, __ADC_HandleTypeDef::Instance, and __ADC_HandleTypeDef::State.
HAL_StatusTypeDef HAL_ADCEx_InjectedStart_IT | ( | ADC_HandleTypeDef * | hadc | ) |
Enable ADC, start conversion of injected group with interruption.
hadc | ADC handle. |
HAL | status. |
Definition at line 614 of file stm32l4xx_hal_adc_ex.c.
References __HAL_ADC_CLEAR_FLAG, __HAL_ADC_DISABLE_IT, __HAL_ADC_ENABLE_IT, ADC_CLEAR_ERRORCODE, ADC_Enable(), ADC_EOC_SEQ_CONV, ADC_FLAG_JEOC, ADC_FLAG_JEOS, ADC_FLAG_JQOVF, ADC_INDEPENDENT_OR_NONMULTIMODEINJECTED_SLAVE, ADC_IS_CONVERSION_ONGOING_INJECTED, ADC_IT_JEOC, ADC_IT_JEOS, ADC_NONMULTIMODE_OR_MULTIMODEMASTER, ADC_STATE_CLR_SET, assert_param, ADC_InitTypeDef::EOCSelection, __ADC_HandleTypeDef::ErrorCode, HAL_ADC_ERROR_JQOVF, HAL_ADC_STATE_ERROR_CONFIG, HAL_ADC_STATE_INJ_BUSY, HAL_ADC_STATE_INJ_EOC, HAL_ADC_STATE_MULTIMODE_SLAVE, HAL_ADC_STATE_READY, HAL_ADC_STATE_REG_BUSY, __ADC_HandleTypeDef::Init, __ADC_HandleTypeDef::Instance, and __ADC_HandleTypeDef::State.
HAL_StatusTypeDef HAL_ADCEx_InjectedStop | ( | ADC_HandleTypeDef * | hadc | ) |
Stop conversion of injected channels.
Disable ADC peripheral if no regular conversion is on going.
hadc | ADC handle. |
HAL | status |
Definition at line 438 of file stm32l4xx_hal_adc_ex.c.
References ADC_ConversionStop(), ADC_Disable(), ADC_INJECTED_GROUP, ADC_IS_CONVERSION_ONGOING_REGULAR, ADC_STATE_CLR_SET, assert_param, HAL_ADC_STATE_INJ_BUSY, HAL_ADC_STATE_READY, HAL_ADC_STATE_REG_BUSY, __ADC_HandleTypeDef::Instance, and __ADC_HandleTypeDef::State.
HAL_StatusTypeDef HAL_ADCEx_InjectedStop_IT | ( | ADC_HandleTypeDef * | hadc | ) |
Stop conversion of injected channels, disable interruption of end-of-conversion.
Disable ADC peripheral if no regular conversion is on going.
hadc | ADC handle |
HAL | status |
Definition at line 767 of file stm32l4xx_hal_adc_ex.c.
References __HAL_ADC_DISABLE_IT, ADC_ConversionStop(), ADC_Disable(), ADC_FLAG_JQOVF, ADC_INJECTED_GROUP, ADC_IS_CONVERSION_ONGOING_REGULAR, ADC_IT_JEOC, ADC_IT_JEOS, ADC_STATE_CLR_SET, assert_param, HAL_ADC_STATE_INJ_BUSY, HAL_ADC_STATE_READY, HAL_ADC_STATE_REG_BUSY, __ADC_HandleTypeDef::Instance, and __ADC_HandleTypeDef::State.
void HAL_ADCEx_LevelOutOfWindow2Callback | ( | ADC_HandleTypeDef * | hadc | ) |
Analog watchdog 2 callback in non-blocking mode.
hadc | ADC handle |
None |
Definition at line 1171 of file stm32l4xx_hal_adc_ex.c.
Referenced by HAL_ADC_Init(), HAL_ADC_IRQHandler(), and HAL_ADC_UnRegisterCallback().
void HAL_ADCEx_LevelOutOfWindow3Callback | ( | ADC_HandleTypeDef * | hadc | ) |
Analog watchdog 3 callback in non-blocking mode.
hadc | ADC handle |
None |
Definition at line 1186 of file stm32l4xx_hal_adc_ex.c.
Referenced by HAL_ADC_Init(), HAL_ADC_IRQHandler(), and HAL_ADC_UnRegisterCallback().
uint32_t HAL_ADCEx_MultiModeGetValue | ( | ADC_HandleTypeDef * | hadc | ) |
Return the last ADC Master and Slave regular conversions results when in multimode configuration.
hadc | ADC handle of ADC Master (handle of ADC Slave must not be used) |
The | converted data values. |
Definition at line 1055 of file stm32l4xx_hal_adc_ex.c.
References __LL_ADC_COMMON_INSTANCE, assert_param, and __ADC_HandleTypeDef::Instance.
HAL_StatusTypeDef HAL_ADCEx_MultiModeStart_DMA | ( | ADC_HandleTypeDef * | hadc, |
uint32_t * | pData, | ||
uint32_t | Length | ||
) |
Enable ADC, start MultiMode conversion and transfer regular results through DMA.
hadc | ADC handle of ADC master (handle of ADC slave must not be used) |
pData | Destination Buffer address. |
Length | Length of data to be transferred from ADC peripheral to memory (in bytes). |
HAL | status |
Definition at line 834 of file stm32l4xx_hal_adc_ex.c.
References __HAL_ADC_CLEAR_FLAG, __HAL_ADC_ENABLE_IT, __LL_ADC_COMMON_INSTANCE, ADC_CLEAR_ERRORCODE, ADC_DMAConvCplt(), ADC_DMAError(), ADC_DMAHalfConvCplt(), ADC_Enable(), ADC_FLAG_EOC, ADC_FLAG_EOS, ADC_FLAG_OVR, ADC_IS_CONVERSION_ONGOING_REGULAR, ADC_IT_OVR, ADC_MULTI_SLAVE, ADC_STATE_CLR_SET, assert_param, ADC_InitTypeDef::ContinuousConvMode, __ADC_HandleTypeDef::DMA_Handle, ADC_InitTypeDef::DMAContinuousRequests, ADC_InitTypeDef::ExternalTrigConvEdge, HAL_ADC_STATE_ERROR_CONFIG, HAL_ADC_STATE_READY, HAL_ADC_STATE_REG_BUSY, HAL_ADC_STATE_REG_EOC, HAL_ADC_STATE_REG_EOSMP, HAL_ADC_STATE_REG_OVR, HAL_DMA_Start_IT(), __ADC_HandleTypeDef::Init, __ADC_HandleTypeDef::Instance, IS_ADC_EXTTRIG_EDGE, LL_ADC_REG_StartConversion(), __ADC_HandleTypeDef::State, __DMA_HandleTypeDef::XferCpltCallback, __DMA_HandleTypeDef::XferErrorCallback, and __DMA_HandleTypeDef::XferHalfCpltCallback.
HAL_StatusTypeDef HAL_ADCEx_MultiModeStop_DMA | ( | ADC_HandleTypeDef * | hadc | ) |
Stop multimode ADC conversion, disable ADC DMA transfer, disable ADC peripheral.
hadc | ADC handle of ADC master (handle of ADC slave must not be used) |
HAL | status |
Definition at line 949 of file stm32l4xx_hal_adc_ex.c.
References __HAL_ADC_DISABLE_IT, ADC_ConversionStop(), ADC_Disable(), ADC_IS_CONVERSION_ONGOING_REGULAR, ADC_IT_OVR, ADC_MULTI_SLAVE, ADC_REGULAR_INJECTED_GROUP, ADC_STATE_CLR_SET, ADC_STOP_CONVERSION_TIMEOUT, assert_param, __ADC_HandleTypeDef::DMA_Handle, HAL_ADC_STATE_ERROR_CONFIG, HAL_ADC_STATE_ERROR_DMA, HAL_ADC_STATE_ERROR_INTERNAL, HAL_ADC_STATE_INJ_BUSY, HAL_ADC_STATE_READY, HAL_ADC_STATE_REG_BUSY, HAL_DMA_Abort(), HAL_GetTick(), __ADC_HandleTypeDef::Instance, and __ADC_HandleTypeDef::State.
HAL_StatusTypeDef HAL_ADCEx_RegularMultiModeStop_DMA | ( | ADC_HandleTypeDef * | hadc | ) |
Stop DMA-based multimode ADC conversion, disable ADC DMA transfer, disable ADC peripheral if no injected conversion is on-going.
hadc | ADC handle of ADC master (handle of ADC slave must not be used) |
HAL | status |
Definition at line 1424 of file stm32l4xx_hal_adc_ex.c.
References __HAL_ADC_DISABLE_IT, ADC_ConversionStop(), ADC_Disable(), ADC_IS_CONVERSION_ONGOING_INJECTED, ADC_IS_CONVERSION_ONGOING_REGULAR, ADC_IT_OVR, ADC_MULTI_SLAVE, ADC_REGULAR_GROUP, ADC_STATE_CLR_SET, ADC_STOP_CONVERSION_TIMEOUT, assert_param, __ADC_HandleTypeDef::DMA_Handle, HAL_ADC_STATE_ERROR_CONFIG, HAL_ADC_STATE_ERROR_DMA, HAL_ADC_STATE_ERROR_INTERNAL, HAL_ADC_STATE_INJ_BUSY, HAL_ADC_STATE_READY, HAL_ADC_STATE_REG_BUSY, HAL_DMA_Abort(), HAL_GetTick(), __ADC_HandleTypeDef::Instance, and __ADC_HandleTypeDef::State.
HAL_StatusTypeDef HAL_ADCEx_RegularStop | ( | ADC_HandleTypeDef * | hadc | ) |
Stop ADC conversion of regular group (and injected channels in case of auto_injection mode), disable ADC peripheral if no conversion is on going on injected group.
hadc | ADC handle |
HAL | status. |
Definition at line 1219 of file stm32l4xx_hal_adc_ex.c.
References ADC_ConversionStop(), ADC_Disable(), ADC_IS_CONVERSION_ONGOING_INJECTED, ADC_REGULAR_GROUP, ADC_STATE_CLR_SET, assert_param, HAL_ADC_STATE_INJ_BUSY, HAL_ADC_STATE_READY, HAL_ADC_STATE_REG_BUSY, __ADC_HandleTypeDef::Instance, and __ADC_HandleTypeDef::State.
HAL_StatusTypeDef HAL_ADCEx_RegularStop_DMA | ( | ADC_HandleTypeDef * | hadc | ) |
Stop ADC conversion of regular group (and injected group in case of auto_injection mode), disable ADC DMA transfer, disable ADC peripheral if no conversion is on going on injected group.
hadc | ADC handle |
HAL | status. |
Definition at line 1337 of file stm32l4xx_hal_adc_ex.c.
References __HAL_ADC_DISABLE_IT, ADC_ConversionStop(), ADC_Disable(), ADC_IS_CONVERSION_ONGOING_INJECTED, ADC_IT_OVR, ADC_REGULAR_GROUP, ADC_STATE_CLR_SET, assert_param, __ADC_HandleTypeDef::DMA_Handle, HAL_ADC_STATE_ERROR_DMA, HAL_ADC_STATE_INJ_BUSY, HAL_ADC_STATE_READY, HAL_ADC_STATE_REG_BUSY, HAL_DMA_Abort(), __ADC_HandleTypeDef::Instance, and __ADC_HandleTypeDef::State.
HAL_StatusTypeDef HAL_ADCEx_RegularStop_IT | ( | ADC_HandleTypeDef * | hadc | ) |
Stop ADC conversion of ADC groups regular and injected, disable interrution of end-of-conversion, disable ADC peripheral if no conversion is on going on injected group.
hadc | ADC handle |
HAL | status. |
Definition at line 1277 of file stm32l4xx_hal_adc_ex.c.
References __HAL_ADC_DISABLE_IT, ADC_ConversionStop(), ADC_Disable(), ADC_IS_CONVERSION_ONGOING_INJECTED, ADC_IT_EOC, ADC_IT_EOS, ADC_IT_OVR, ADC_REGULAR_GROUP, ADC_STATE_CLR_SET, assert_param, HAL_ADC_STATE_INJ_BUSY, HAL_ADC_STATE_READY, HAL_ADC_STATE_REG_BUSY, __ADC_HandleTypeDef::Instance, and __ADC_HandleTypeDef::State.