Interrupts and flags management functions.
More...
Interrupts and flags management functions.
===============================================================================
##### Interrupts and flags management functions #####
===============================================================================
[..] This section provides functions allowing to configure the ADC Interrupts,
get the status and clear flags and Interrupts pending bits.
[..] The ADC provide 4 Interrupts sources and 9 Flags which can be divided
into 3 groups:
*** Flags and Interrupts for ADC regular channels ***
=====================================================
[..]
(+)Flags :
(##) ADC_FLAG_EOC : Regular channel end of conversion to indicate
the end of sequence of regular GROUP conversions
(##) ADC_FLAG_STRT: Regular channel start to indicate when regular
CHANNEL conversion starts.
(+)Interrupts :
(##) ADC_IT_EOC : specifies the interrupt source for Regular channel
end of conversion event.
*** Flags and Interrupts for ADC Injected channels ***
======================================================
[..]
(+)Flags :
(##) ADC_FLAG_JEOC : Injected channel end of conversion to indicate
at the end of injected GROUP conversion
(##) ADC_FLAG_JSTRT : Injected channel start to indicate when injected
GROUP conversion starts.
(+)Interrupts :
(##) ADC_IT_JEOC : specifies the interrupt source for Injected channel
end of conversion event.
*** General Flags and Interrupts for the ADC ***
================================================
[..]
(+)Flags :
(##) ADC_FLAG_AWD : Analog watchdog + to indicate if the converted voltage
crosses the programmed thresholds values.
(+)Interrupts :
(##) ADC_IT_AWD : specifies the interrupt source for Analog watchdog event.
[..] The user should identify which mode will be used in his application to
manage the ADC controller events: Polling mode or Interrupt mode.
[..] In the Polling Mode it is advised to use the following functions:
(+) ADC_GetFlagStatus() : to check if flags events occur.
(+) ADC_ClearFlag() : to clear the flags events.
[..] In the Interrupt Mode it is advised to use the following functions:
(+) ADC_ITConfig() : to enable or disable the interrupt source.
(+) ADC_GetITStatus() : to check if Interrupt occurs.
(+) ADC_ClearITPendingBit() : to clear the Interrupt pending Bit
(corresponding Flag).
void ADC_ClearFlag |
( |
ADC_TypeDef * |
ADCx, |
|
|
uint8_t |
ADC_FLAG |
|
) |
| |
Clears the ADCx's pending flags.
- Parameters
-
ADCx,: | where x can be 1 to select the ADC peripheral. |
ADC_FLAG,: | specifies the flag to clear. This parameter can be any combination of the following values:
- ADC_FLAG_AWD: Analog watchdog flag
- ADC_FLAG_EOC: End of conversion flag
- ADC_FLAG_JEOC: End of injected group conversion flag
- ADC_FLAG_JSTRT: Start of injected group conversion flag
- ADC_FLAG_STRT: Start of regular group conversion flag
|
- Return values
-
void ADC_ClearITPendingBit |
( |
ADC_TypeDef * |
ADCx, |
|
|
uint16_t |
ADC_IT |
|
) |
| |
Clears the ADCx's interrupt pending bits.
- Parameters
-
ADCx,: | where x can be 1 to select the ADC peripheral. |
ADC_IT,: | specifies the ADC interrupt pending bit to clear. This parameter can be any combination of the following values:
- ADC_IT_EOC: End of conversion interrupt mask
- ADC_IT_AWD: Analog watchdog interrupt mask
- ADC_IT_JEOC: End of injected conversion interrupt mask
|
- Return values
-
FlagStatus ADC_GetCalibrationStatus |
( |
ADC_TypeDef * |
ADCx | ) |
|
Gets the selected ADC calibration status.
- Parameters
-
ADCx,: | where x can be 1 to select the ADC peripheral. |
- Return values
-
The | new state of ADC calibration (SET or RESET). |
FlagStatus ADC_GetFlagStatus |
( |
ADC_TypeDef * |
ADCx, |
|
|
uint8_t |
ADC_FLAG |
|
) |
| |
Checks whether the specified ADC flag is set or not.
- Parameters
-
ADCx,: | where x can be 1 to select the ADC peripheral. |
ADC_FLAG,: | specifies the flag to check. This parameter can be one of the following values:
- ADC_FLAG_AWD: Analog watchdog flag
- ADC_FLAG_EOC: End of conversion flag
- ADC_FLAG_JEOC: End of injected group conversion flag
- ADC_FLAG_JSTRT: Start of injected group conversion flag
- ADC_FLAG_STRT: Start of regular group conversion flag
|
- Return values
-
The | new state of ADC_FLAG (SET or RESET). |
ITStatus ADC_GetITStatus |
( |
ADC_TypeDef * |
ADCx, |
|
|
uint16_t |
ADC_IT |
|
) |
| |
Checks whether the specified ADC interrupt has occurred or not.
- Parameters
-
ADCx,: | where x can be 1 to select the ADC peripheral. |
ADC_IT,: | specifies the ADC interrupt source to check. This parameter can be one of the following values:
- ADC_IT_EOC: End of conversion interrupt mask
- ADC_IT_AWD: Analog watchdog interrupt mask
- ADC_IT_JEOC: End of injected conversion interrupt mask
|
- Return values
-
The | new state of ADC_IT (SET or RESET). |
FlagStatus ADC_GetResetCalibrationStatus |
( |
ADC_TypeDef * |
ADCx | ) |
|
Gets the selected ADC reset calibration registers status.
- Parameters
-
ADCx,: | where x can be 1 to select the ADC peripheral. |
- Return values
-
The | new state of ADC reset calibration registers (SET or RESET). |
void ADC_ITConfig |
( |
ADC_TypeDef * |
ADCx, |
|
|
uint16_t |
ADC_IT, |
|
|
FunctionalState |
NewState |
|
) |
| |
Enables or disables the specified ADC interrupts.
- Parameters
-
ADCx,: | where x can be 1 to select the ADC peripheral. |
ADC_IT,: | specifies the ADC interrupt sources to be enabled or disabled. This parameter can be any combination of the following values:
- ADC_IT_EOC: End of conversion interrupt mask
- ADC_IT_AWD: Analog watchdog interrupt mask
- ADC_IT_JEOC: End of injected conversion interrupt mask
|
NewState,: | new state of the specified ADC interrupts. This parameter can be: ENABLE or DISABLE. |
- Return values
-