RTC Timestamp and Tamper functions. More...

Collaboration diagram for RTC Timestamp and Tamper functions:

Functions
HAL_StatusTypeDef	HAL_RTCEx_SetTimeStamp (RTC_HandleTypeDef *hrtc, uint32_t RTC_TimeStampEdge, uint32_t RTC_TimeStampPin)
	Sets Timestamp. More...

HAL_StatusTypeDef	HAL_RTCEx_SetTimeStamp_IT (RTC_HandleTypeDef *hrtc, uint32_t RTC_TimeStampEdge, uint32_t RTC_TimeStampPin)
	Sets Timestamp with Interrupt. More...

HAL_StatusTypeDef	HAL_RTCEx_DeactivateTimeStamp (RTC_HandleTypeDef *hrtc)
	Deactivates Timestamp. More...

HAL_StatusTypeDef	HAL_RTCEx_GetTimeStamp (RTC_HandleTypeDef hrtc, RTC_TimeTypeDef sTimeStamp, RTC_DateTypeDef *sTimeStampDate, uint32_t Format)
	Gets the RTC Timestamp value. More...

HAL_StatusTypeDef	HAL_RTCEx_SetTamper (RTC_HandleTypeDef hrtc, RTC_TamperTypeDef sTamper)
	Sets Tamper. More...

HAL_StatusTypeDef	HAL_RTCEx_SetTamper_IT (RTC_HandleTypeDef hrtc, RTC_TamperTypeDef sTamper)
	Sets Tamper with interrupt. More...

HAL_StatusTypeDef	HAL_RTCEx_DeactivateTamper (RTC_HandleTypeDef *hrtc, uint32_t Tamper)
	Deactivates Tamper. More...

void	HAL_RTCEx_TamperTimeStampIRQHandler (RTC_HandleTypeDef *hrtc)
	Handles Timestamp and Tamper interrupt request. More...

void	HAL_RTCEx_Tamper1EventCallback (RTC_HandleTypeDef *hrtc)
	Tamper 1 callback. More...

void	HAL_RTCEx_Tamper2EventCallback (RTC_HandleTypeDef *hrtc)
	Tamper 2 callback. More...

void	HAL_RTCEx_TimeStampEventCallback (RTC_HandleTypeDef *hrtc)
	Timestamp callback. More...

HAL_StatusTypeDef	HAL_RTCEx_PollForTimeStampEvent (RTC_HandleTypeDef *hrtc, uint32_t Timeout)
	Handles Timestamp polling request. More...

HAL_StatusTypeDef	HAL_RTCEx_PollForTamper1Event (RTC_HandleTypeDef *hrtc, uint32_t Timeout)
	Handles Tamper 1 Polling. More...

HAL_StatusTypeDef	HAL_RTCEx_PollForTamper2Event (RTC_HandleTypeDef *hrtc, uint32_t Timeout)
	Handles Tamper 2 Polling. More...

Detailed Description

RTC Timestamp and Tamper functions.

 ===============================================================================
                 ##### RTC Timestamp and Tamper functions #####
 ===============================================================================

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

Function Documentation

◆ HAL_RTCEx_DeactivateTamper()

HAL_StatusTypeDef HAL_RTCEx_DeactivateTamper	(	RTC_HandleTypeDef *	hrtc,
		uint32_t	Tamper
	)

Deactivates Tamper.

Note: The tamper global interrupt bit will remain unchanged.

Parameters

hrtc	pointer to a RTC_HandleTypeDef structure that contains the configuration information for RTC.
Tamper	Selected tamper pin. This parameter can be any combination of the following values: RTC_TAMPER_1: Tamper 1 RTC_TAMPER_2: Tamper 2

Note: RTC_TAMPER_2 is not applicable to all devices.

Return values

HAL status

Definition at line 580 of file stm32f4xx_hal_rtc_ex.c.

◆ HAL_RTCEx_DeactivateTimeStamp()

HAL_StatusTypeDef HAL_RTCEx_DeactivateTimeStamp ( RTC_HandleTypeDef * hrtc )

Deactivates Timestamp.

Parameters

hrtc	pointer to a RTC_HandleTypeDef structure that contains the configuration information for RTC.

Return values

HAL status

Definition at line 321 of file stm32f4xx_hal_rtc_ex.c.

◆ HAL_RTCEx_GetTimeStamp()

HAL_StatusTypeDef HAL_RTCEx_GetTimeStamp	(	RTC_HandleTypeDef *	hrtc,
		RTC_TimeTypeDef *	sTimeStamp,
		RTC_DateTypeDef *	sTimeStampDate,
		uint32_t	Format
	)

Gets the RTC Timestamp value.

Parameters

hrtc	pointer to a RTC_HandleTypeDef structure that contains the configuration information for RTC.
sTimeStamp	Pointer to Time structure
sTimeStampDate	Pointer to Date structure
Format	specifies 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

HAL status

Definition at line 365 of file stm32f4xx_hal_rtc_ex.c.

◆ HAL_RTCEx_PollForTamper1Event()

HAL_StatusTypeDef HAL_RTCEx_PollForTamper1Event	(	RTC_HandleTypeDef *	hrtc,
		uint32_t	Timeout
	)

Handles Tamper 1 Polling.

Parameters

hrtc	pointer to a RTC_HandleTypeDef structure that contains the configuration information for RTC.
Timeout	Timeout duration

Return values

HAL status

Definition at line 772 of file stm32f4xx_hal_rtc_ex.c.

◆ HAL_RTCEx_PollForTamper2Event()

HAL_StatusTypeDef HAL_RTCEx_PollForTamper2Event	(	RTC_HandleTypeDef *	hrtc,
		uint32_t	Timeout
	)

Handles Tamper 2 Polling.

Parameters

hrtc	pointer to a RTC_HandleTypeDef structure that contains the configuration information for RTC.
Timeout	Timeout duration

Return values

HAL status

Definition at line 809 of file stm32f4xx_hal_rtc_ex.c.

◆ HAL_RTCEx_PollForTimeStampEvent()

HAL_StatusTypeDef HAL_RTCEx_PollForTimeStampEvent	(	RTC_HandleTypeDef *	hrtc,
		uint32_t	Timeout
	)

Handles Timestamp polling request.

Parameters

hrtc	pointer to a RTC_HandleTypeDef structure that contains the configuration information for RTC.
Timeout	Timeout duration

Return values

HAL status

Definition at line 729 of file stm32f4xx_hal_rtc_ex.c.

◆ HAL_RTCEx_SetTamper()

HAL_StatusTypeDef HAL_RTCEx_SetTamper	(	RTC_HandleTypeDef *	hrtc,
		RTC_TamperTypeDef *	sTamper
	)

Sets Tamper.

Note: By calling this API the tamper global interrupt will be disabled.

Parameters

hrtc	pointer to a RTC_HandleTypeDef structure that contains the configuration information for RTC.
sTamper	Pointer to Tamper Structure.

Return values

HAL status

Definition at line 418 of file stm32f4xx_hal_rtc_ex.c.

◆ HAL_RTCEx_SetTamper_IT()

HAL_StatusTypeDef HAL_RTCEx_SetTamper_IT	(	RTC_HandleTypeDef *	hrtc,
		RTC_TamperTypeDef *	sTamper
	)

Sets Tamper with interrupt.

Note: By calling this API the tamper global interrupt will be enabled.

Parameters

hrtc	pointer to a RTC_HandleTypeDef structure that contains the configuration information for RTC.
sTamper	Pointer to RTC Tamper.

Return values

HAL status

Definition at line 495 of file stm32f4xx_hal_rtc_ex.c.

◆ HAL_RTCEx_SetTimeStamp()

HAL_StatusTypeDef HAL_RTCEx_SetTimeStamp	(	RTC_HandleTypeDef *	hrtc,
		uint32_t	RTC_TimeStampEdge,
		uint32_t	RTC_TimeStampPin
	)

Sets Timestamp.

Note: This API must be called before enabling the Timestamp feature.

Parameters

hrtc	pointer to a RTC_HandleTypeDef structure that contains the configuration information for RTC.
RTC_TimeStampEdge	Specifies the pin edge on which the Timestamp is activated. This parameter can be one of the following values: RTC_TIMESTAMPEDGE_RISING: the Timestamp event occurs on the rising edge of the related pin. RTC_TIMESTAMPEDGE_FALLING: the Timestamp event occurs on the falling edge of the related pin.
RTC_TimeStampPin	Specifies the RTC Timestamp Pin. This parameter can be one of the following values: RTC_TIMESTAMPPIN_DEFAULT: PC13 is selected as RTC Timestamp Pin. RTC_TIMESTAMPPIN_POS1: PI8 is selected as RTC Timestamp Pin.

Note: RTC_TIMESTAMPPIN_POS1 corresponds to pin PA0 in the case of STM32F446xx devices.; RTC_TIMESTAMPPIN_POS1 is not applicable to the following list of devices: STM32F412xx, STM32F413xx and STM32F423xx.

Return values

HAL status

Definition at line 186 of file stm32f4xx_hal_rtc_ex.c.

◆ HAL_RTCEx_SetTimeStamp_IT()

HAL_StatusTypeDef HAL_RTCEx_SetTimeStamp_IT	(	RTC_HandleTypeDef *	hrtc,
		uint32_t	RTC_TimeStampEdge,
		uint32_t	RTC_TimeStampPin
	)

Sets Timestamp with Interrupt.

Parameters

hrtc	pointer to a RTC_HandleTypeDef structure that contains the configuration information for RTC.

Note: This API must be called before enabling the Timestamp feature.

Parameters

RTC_TimeStampEdge	Specifies the pin edge on which the Timestamp is activated. This parameter can be one of the following values: RTC_TIMESTAMPEDGE_RISING: the Timestamp event occurs on the rising edge of the related pin. RTC_TIMESTAMPEDGE_FALLING: the Timestamp event occurs on the falling edge of the related pin.
RTC_TimeStampPin	Specifies the RTC Timestamp Pin. This parameter can be one of the following values: RTC_TIMESTAMPPIN_DEFAULT: PC13 is selected as RTC Timestamp Pin. RTC_TIMESTAMPPIN_POS1: PI8 is selected as RTC Timestamp Pin.

Note: RTC_TIMESTAMPPIN_POS1 corresponds to pin PA0 in the case of STM32F446xx devices.; RTC_TIMESTAMPPIN_POS1 is not applicable to the following list of devices: STM32F412xx, STM32F413xx and STM32F423xx.

Return values

HAL status

Definition at line 258 of file stm32f4xx_hal_rtc_ex.c.

◆ HAL_RTCEx_Tamper1EventCallback()

__weak void HAL_RTCEx_Tamper1EventCallback ( RTC_HandleTypeDef * hrtc )

Tamper 1 callback.

Parameters

hrtc	pointer to a RTC_HandleTypeDef structure that contains the configuration information for RTC.

Return values

None

Definition at line 694 of file stm32f4xx_hal_rtc_ex.c.

◆ HAL_RTCEx_Tamper2EventCallback()

__weak void HAL_RTCEx_Tamper2EventCallback ( RTC_HandleTypeDef * hrtc )

Tamper 2 callback.

Parameters

hrtc	pointer to a RTC_HandleTypeDef structure that contains the configuration information for RTC.

Return values

None

Definition at line 711 of file stm32f4xx_hal_rtc_ex.c.

◆ HAL_RTCEx_TamperTimeStampIRQHandler()

void HAL_RTCEx_TamperTimeStampIRQHandler ( RTC_HandleTypeDef * hrtc )

Handles Timestamp and Tamper interrupt request.

Parameters

hrtc	pointer to a RTC_HandleTypeDef structure that contains the configuration information for RTC.

Return values

None

Definition at line 606 of file stm32f4xx_hal_rtc_ex.c.

◆ HAL_RTCEx_TimeStampEventCallback()

__weak void HAL_RTCEx_TimeStampEventCallback ( RTC_HandleTypeDef * hrtc )

Timestamp callback.

Parameters

hrtc	pointer to a RTC_HandleTypeDef structure that contains the configuration information for RTC.

Return values

None

Definition at line 678 of file stm32f4xx_hal_rtc_ex.c.

Functions

Detailed Description

Function Documentation

◆ HAL_RTCEx_DeactivateTamper()

◆ HAL_RTCEx_DeactivateTimeStamp()

◆ HAL_RTCEx_GetTimeStamp()

◆ HAL_RTCEx_PollForTamper1Event()

◆ HAL_RTCEx_PollForTamper2Event()

◆ HAL_RTCEx_PollForTimeStampEvent()

◆ HAL_RTCEx_SetTamper()

◆ HAL_RTCEx_SetTamper_IT()

◆ HAL_RTCEx_SetTimeStamp()

◆ HAL_RTCEx_SetTimeStamp_IT()

◆ HAL_RTCEx_Tamper1EventCallback()

◆ HAL_RTCEx_Tamper2EventCallback()

◆ HAL_RTCEx_TamperTimeStampIRQHandler()

◆ HAL_RTCEx_TimeStampEventCallback()