Dinamical modification of hour format

[slavendam]

In RTC_StartAlarm function

STM32RTC/src/rtc.c

Line 801 in 90414bc

void RTC_StartAlarm(alarm_t name, uint8_t day, uint8_t hours, uint8_t minutes, uint8_t seconds, uint32_t subSeconds, hourAM_PM_t period, uint8_t mask)

it is implemented that user can send 12h hours format, together with AM or PM flag, but that will not be used if 24h format is hardcoded.

If for example user wants to send 14:00h time in 12h format he will send:
RTC_StartAlarm(RTC_ALARM_B, 0, 2, 0, 0, 0, HOUR_PM, 31UL); // old

If 24h format is hardcoded alarm will be set at 2:00 AM and user will not have feedback.

From UX side it would be the best to add additional value to hourAM_PM_t enum:

STM32RTC/src/rtc.h

Line 67 in 90414bc

} hourAM_PM_t;

typedef enum {
  HOUR_AM,
  HOUR_PM,
  HOUR_24H
} hourAM_PM_t;

Modifiying code wherever new hourAM_PM_t is used, will enable user to dinamically set hour format he wants.

[FRASTM]

A proposal could be introduce a rtc.getFormat (or so) that will return HOUR_12 or HOUR_24
So that you can check the format 12 or 24 hours before setting the Alarm (or Time)
Of course when format is 24 hours, HOUR_AM or HOUR_PM are useless