implement a One-Second interrupt on stm32 MCUs

[FRASTM]

This Enhancement is adding a interrupt on each second for the stm32xx MCUs

for the stm32F1 : the RTC One-Second flag interrupt is asserted on each RTC Core 1Hz clock cycle
for other MCUS the RTC WakeUP feature is programmed to interrupt each second
depending on the stm32 serie, this interrupt channel is a global or a specific one.
In the the stm32F0xx serie, other than STM32F071xB, STM32F072xB, STM32F078xx, STM32F091xC, STM32F098xx, STM32F070xB, STM32F030xC do not support the WakeUp capability.

A simple example RTC_Seconds demonstrating the feature with a basic callback function that toggle a bit each second
This test is passed on stm32F1 (nucleo f103rb), stm32G4 (nucleo g474re), stm32L4 (nucleo l476rg), stm32WB (nucleo wb55rg), stm32L1 (nucleo l152re), stm32F7 (nucleo 144 f767zi)

This PR is inspired by the #42

Signed-off-by: Francois Ramu francois.ramu@st.com

[FRASTM]

The stm32 MCUs have different name/ position for the wakeUp interrupt to be used as the one-second interrupt ; defining single ONESECOND_IRQn depending on the soc serie

[FRASTM]

The stm32 MCUs have different name/ position for the wakeUp interrupt to be used as the one-second interrupt ; defining single ONESECOND_IRQn depending on the soc serie
Adapt for stm32 mcus with "Wakeup auto-reload output clear value" where the HAL_RTCEx_SetWakeUpTimer_IT differs.

[FRASTM]

Note that STM32F030x4/6, STM32F070x6 and STM32F030x8 devices do not have WakeUp feature in their RTC and only one Alarm

[FRASTM]

Ada a #error when a device which does not support the feature, is choosen for the sketch or driver

[fpistm]

First please rebase on top of the main to avoid to have the get/set prescaler commits.
Fix the build issues raised by the STM32RTC Continuous Integration / Library compilation, example:

/github/home/Arduino/libraries/workspace/src/rtc.c: In function 'attachSecondsIrqCallback':
/github/home/Arduino/libraries/workspace/src/rtc.c:757:46: error: 'RTC_WAKEUPCLOCK_CK_SPRE_16BITS' undeclared (first use in this function); did you mean 'LL_RTC_WAKEUPCLOCK_CKSPRE_WUT'?
  757 |   HAL_RTCEx_SetWakeUpTimer_IT(&RtcHandle, 0, RTC_WAKEUPCLOCK_CK_SPRE_16BITS);
      |                                              ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
      |                                              LL_RTC_WAKEUPCLOCK_CKSPRE_WUT
/github/home/Arduino/libraries/workspace/src/rtc.c:757:46: note: each undeclared identifier is reported only once for each function it appears in

Error during build: exit status 1


|   2/45   | NUCLEO_F031K6                              |   failed   |  4.82 s |
/github/home/Arduino/libraries/workspace/src/rtc.c: In function 'attachSecondsIrqCallback':
/github/home/Arduino/libraries/workspace/src/rtc.c:757:46: error: 'RTC_WAKEUPCLOCK_CK_SPRE_16BITS' undeclared (first use in this function); did you mean 'LL_RTC_WAKEUPCLOCK_CKSPRE_WUT'?
  757 |   HAL_RTCEx_SetWakeUpTimer_IT(&RtcHandle, 0, RTC_WAKEUPCLOCK_CK_SPRE_16BITS);
      |                                              ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
      |                                              LL_RTC_WAKEUPCLOCK_CKSPRE_WUT
/github/home/Arduino/libraries/workspace/src/rtc.c:757:46: note: each undeclared identifier is reported only once for each function it appears in

Error during build: exit status 1


|   3/45   | NUCLEO_F042K6                              |   failed   |  5.20 s |

[FRASTM]

rebase
Raise a compilation error on the sketch when the feature is not supported on the MCU

[fpistm]

Think to update the README.md

[FRASTM]

The code added for this feature is under #ifdef ONESECOND_IRQn
In the attachSecondsIrqCallback, the ONESECOND_IRQn is enabled
In the detachSecondsIrqCallback, the except for the stm32F1, the ONESECOND_IRQn is not disabled. becasue it could be used elsewhere. The callback is reset though.

[FRASTM]

updates the README.md