STM32F4xx_HAL_Driver  1.8.3

RTC Alarm functions. More...

+ Collaboration diagram for RTC Alarm functions:

Functions

HAL_StatusTypeDef HAL_RTC_SetAlarm (RTC_HandleTypeDef *hrtc, RTC_AlarmTypeDef *sAlarm, uint32_t Format)
 Sets the specified RTC Alarm. More...
 
HAL_StatusTypeDef HAL_RTC_SetAlarm_IT (RTC_HandleTypeDef *hrtc, RTC_AlarmTypeDef *sAlarm, uint32_t Format)
 Sets the specified RTC Alarm with Interrupt. More...
 
HAL_StatusTypeDef HAL_RTC_DeactivateAlarm (RTC_HandleTypeDef *hrtc, uint32_t Alarm)
 Deactivates the specified RTC Alarm. More...
 
HAL_StatusTypeDef HAL_RTC_GetAlarm (RTC_HandleTypeDef *hrtc, RTC_AlarmTypeDef *sAlarm, uint32_t Alarm, uint32_t Format)
 Gets the RTC Alarm value and masks. More...
 
void HAL_RTC_AlarmIRQHandler (RTC_HandleTypeDef *hrtc)
 Handles Alarm interrupt request. More...
 
HAL_StatusTypeDef HAL_RTC_PollForAlarmAEvent (RTC_HandleTypeDef *hrtc, uint32_t Timeout)
 Handles Alarm A Polling request. More...
 
void HAL_RTC_AlarmAEventCallback (RTC_HandleTypeDef *hrtc)
 Alarm A callback. More...
 

Detailed Description

RTC Alarm functions.

 ===============================================================================
                 ##### RTC Alarm functions #####
 ===============================================================================

 [..] This section provides functions allowing to configure Alarm feature

Function Documentation

◆ HAL_RTC_AlarmAEventCallback()

__weak void HAL_RTC_AlarmAEventCallback ( RTC_HandleTypeDef hrtc)

Alarm A callback.

Parameters
hrtcpointer to a RTC_HandleTypeDef structure that contains the configuration information for RTC.
Return values
None

Definition at line 1595 of file stm32f4xx_hal_rtc.c.

◆ HAL_RTC_AlarmIRQHandler()

void HAL_RTC_AlarmIRQHandler ( RTC_HandleTypeDef hrtc)

Handles Alarm interrupt request.

Parameters
hrtcpointer to a RTC_HandleTypeDef structure that contains the configuration information for RTC.
Return values
None

Definition at line 1544 of file stm32f4xx_hal_rtc.c.

◆ HAL_RTC_DeactivateAlarm()

HAL_StatusTypeDef HAL_RTC_DeactivateAlarm ( RTC_HandleTypeDef hrtc,
uint32_t  Alarm 
)

Deactivates the specified RTC Alarm.

Parameters
hrtcpointer to a RTC_HandleTypeDef structure that contains the configuration information for RTC.
AlarmSpecifies the Alarm. This parameter can be one of the following values:
  • RTC_ALARM_A: Alarm A
  • RTC_ALARM_B: Alarm B
Return values
HALstatus

Definition at line 1395 of file stm32f4xx_hal_rtc.c.

◆ HAL_RTC_GetAlarm()

HAL_StatusTypeDef HAL_RTC_GetAlarm ( RTC_HandleTypeDef hrtc,
RTC_AlarmTypeDef sAlarm,
uint32_t  Alarm,
uint32_t  Format 
)

Gets the RTC Alarm value and masks.

Parameters
hrtcpointer to a RTC_HandleTypeDef structure that contains the configuration information for RTC.
sAlarmPointer to Date structure
AlarmSpecifies the Alarm. This parameter can be one of the following values:
  • RTC_ALARM_A: Alarm A
  • RTC_ALARM_B: Alarm B
FormatSpecifies the format of the entered parameters. This parameter can be one of the following values:
  • RTC_FORMAT_BIN: Binary data format
  • RTC_FORMAT_BCD: BCD data format
Return values
HALstatus

Definition at line 1493 of file stm32f4xx_hal_rtc.c.

◆ HAL_RTC_PollForAlarmAEvent()

HAL_StatusTypeDef HAL_RTC_PollForAlarmAEvent ( RTC_HandleTypeDef hrtc,
uint32_t  Timeout 
)

Handles Alarm A Polling request.

Parameters
hrtcpointer to a RTC_HandleTypeDef structure that contains the configuration information for RTC.
TimeoutTimeout duration
Return values
HALstatus

Definition at line 1612 of file stm32f4xx_hal_rtc.c.

◆ HAL_RTC_SetAlarm()

HAL_StatusTypeDef HAL_RTC_SetAlarm ( RTC_HandleTypeDef hrtc,
RTC_AlarmTypeDef sAlarm,
uint32_t  Format 
)

Sets the specified RTC Alarm.

Parameters
hrtcpointer to a RTC_HandleTypeDef structure that contains the configuration information for RTC.
sAlarmPointer to Alarm structure
FormatSpecifies the format of the entered parameters. This parameter can be one of the following values:
  • RTC_FORMAT_BIN: Binary data format
  • RTC_FORMAT_BCD: BCD data format
Note
The Alarm register can only be written when the corresponding Alarm is disabled (Use the HAL_RTC_DeactivateAlarm()).
The HAL_RTC_SetTime() must be called before enabling the Alarm feature.
Return values
HALstatus

Definition at line 1004 of file stm32f4xx_hal_rtc.c.

◆ HAL_RTC_SetAlarm_IT()

HAL_StatusTypeDef HAL_RTC_SetAlarm_IT ( RTC_HandleTypeDef hrtc,
RTC_AlarmTypeDef sAlarm,
uint32_t  Format 
)

Sets the specified RTC Alarm with Interrupt.

Parameters
hrtcpointer to a RTC_HandleTypeDef structure that contains the configuration information for RTC.
sAlarmPointer to Alarm structure
FormatSpecifies the format of the entered parameters. This parameter can be one of the following values:
  • RTC_FORMAT_BIN: Binary data format
  • RTC_FORMAT_BCD: BCD data format
Note
The Alarm register can only be written when the corresponding Alarm is disabled (Use the HAL_RTC_DeactivateAlarm()).
The HAL_RTC_SetTime() must be called before enabling the Alarm feature.
Return values
HALstatus

Definition at line 1201 of file stm32f4xx_hal_rtc.c.