STM32F37 Standard Peripheral bibliotheek  1.0
ST Microelectronics bibliotheek documentatie voor de STM32F37 Standard Peripheral Library
 All Data Structures Files Functions Variables Enumerations Enumerator Groups
Interrupts and flags management functions

Interrupts and flags management functions. More...

Functions

void ADC_ITConfig (ADC_TypeDef *ADCx, uint16_t ADC_IT, FunctionalState NewState)
 Enables or disables the specified ADC interrupts. More...
 
FlagStatus ADC_GetFlagStatus (ADC_TypeDef *ADCx, uint8_t ADC_FLAG)
 Checks whether the specified ADC flag is set or not. More...
 
void ADC_ClearFlag (ADC_TypeDef *ADCx, uint8_t ADC_FLAG)
 Clears the ADCx's pending flags. More...
 
ITStatus ADC_GetITStatus (ADC_TypeDef *ADCx, uint16_t ADC_IT)
 Checks whether the specified ADC interrupt has occurred or not. More...
 
void ADC_ClearITPendingBit (ADC_TypeDef *ADCx, uint16_t ADC_IT)
 Clears the ADCx's interrupt pending bits. More...
 
FlagStatus ADC_GetCalibrationStatus (ADC_TypeDef *ADCx)
 Gets the selected ADC calibration status. More...
 
FlagStatus ADC_GetResetCalibrationStatus (ADC_TypeDef *ADCx)
 Gets the selected ADC reset calibration registers status. More...
 

Detailed Description

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). 

Function Documentation

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
None
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
None
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
Thenew 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
Thenew 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
Thenew 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
Thenew 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
None