sys/ztimer: add ZTIMER_SEC

wire up ZTIMER_SEC to the existing RTC backend, or RTT backend, or periph_timer
backend (in this order of preference).

Update sys/ztimer/auto_init.c

Co-authored-by: Leandro Lanzieri <leandro.lanzieri@haw-hamburg.de>

sys/include/ztimer.h

@@ -595,6 +595,11 @@ extern ztimer_clock_t *const ZTIMER_USEC;
  */
 extern ztimer_clock_t *const ZTIMER_MSEC;
 
+/**
+ * @brief   Default ztimer second clock
+ */
+extern ztimer_clock_t *const ZTIMER_SEC;
+
 /**
  * @brief   Base ztimer for the microsecond clock (ZTIMER_USEC)
  *

sys/ztimer/Makefile.dep

@@ -66,6 +66,10 @@ ifneq (,$(filter ztimer_periph_timer,$(USEMODULE)))
   FEATURES_REQUIRED += periph_timer
 endif
 
+ifneq (,$(filter ztimer_periph_rtc,$(USEMODULE)))
+  FEATURES_REQUIRED += periph_rtc
+endif
+
 ifneq (,$(filter ztimer_periph_rtt,$(USEMODULE)))
   FEATURES_REQUIRED += periph_rtt
 endif

sys/ztimer/auto_init.c

@@ -43,6 +43,7 @@
 #include "ztimer/convert_muldiv64.h"
 #include "ztimer/periph_timer.h"
 #include "ztimer/periph_rtt.h"
+#include "ztimer/periph_rtc.h"
 #include "ztimer/config.h"
 
 #include "log.h"
@@ -52,6 +53,7 @@
 #define FREQ_1MHZ       1000000LU
 #define FREQ_250KHZ     250000LU
 #define FREQ_1KHZ       1000LU
+#define FREQ_1HZ        1LU
 
 #if MODULE_ZTIMER_USEC
 #  if CONFIG_ZTIMER_USEC_TYPE_PERIPH_TIMER
@@ -74,18 +76,23 @@ ztimer_clock_t *const ZTIMER_USEC = &_ztimer_convert_frac_usec.super.super;
 #  endif
 #endif
 
+/* use RTT for ZTIMER_MSEC, if used. Use RTT also for ZTIMER_USEC,
+   unless module ztimer_periph_rtc is explicitly used by application */
+#if MODULE_ZTIMER_PERIPH_RTT && (MODULE_ZTIMER_MSEC || (MODULE_ZTIMER_SEC && !MODULE_ZTIMER_PERIPH_RTC))
+static ztimer_periph_rtt_t _ztimer_periph_timer_rtt_msec_sec;
+#  define ZTIMER_RTT_INIT (&_ztimer_periph_timer_rtt_msec_sec)
+#endif
+
 #if MODULE_ZTIMER_MSEC
 #  if MODULE_ZTIMER_PERIPH_RTT
-static ztimer_periph_rtt_t _ztimer_periph_timer_rtt_msec;
+ztimer_clock_t *const ZTIMER_MSEC_BASE = &_ztimer_periph_timer_rtt_msec_sec;
-ztimer_clock_t *const ZTIMER_MSEC_BASE = &_ztimer_periph_timer_rtt_msec;
-#  define ZTIMER_RTT_INIT (ZTIMER_MSEC_BASE)
 #    if RTT_FREQUENCY != FREQ_1KHZ
 static ztimer_convert_frac_t _ztimer_convert_frac_msec;
-ztimer_clock_t *const ZTIMER_MSEC = &_ztimer_convert_frac_msec.super.super;
+ztimer_clock_t *const ZTIMER_MSEC = &_ztimer_convert_frac_msec_sec.super.super;
 #  define ZTIMER_MSEC_CONVERT_LOWER_FREQ    RTT_FREQUENCY
-#  define ZTIMER_MSEC_CONVERT_LOWER         (&_ztimer_periph_timer_rtt_msec)
+#  define ZTIMER_MSEC_CONVERT_LOWER         (&_ztimer_periph_timer_rtt_msec_sec)
 #    else
-ztimer_clock_t *const ZTIMER_MSEC = &_ztimer_periph_timer_rtt_msec;
+ztimer_clock_t *const ZTIMER_MSEC = &_ztimer_periph_timer_rtt_msec_sec;
 #    endif
 #  elif MODULE_ZTIMER_USEC
 static ztimer_convert_frac_t _ztimer_convert_frac_msec;
@@ -98,6 +105,27 @@ ztimer_clock_t *const ZTIMER_MSEC_BASE = &_ztimer_periph_timer_usec.super;
 #  endif
 #endif
 
+#if MODULE_ZTIMER_SEC
+#  if MODULE_ZTIMER_PERIPH_RTC
+static ztimer_periph_rtc_t _ztimer_periph_timer_rtc_sec;
+ztimer_clock_t *const ZTIMER_SEC = &_ztimer_periph_timer_rtc_sec;
+#  elif MODULE_ZTIMER_PERIPH_RTT
+static ztimer_convert_frac_t _ztimer_convert_frac_sec;
+ztimer_clock_t *const ZTIMER_SEC = &_ztimer_convert_frac_sec.super.super;
+ztimer_clock_t *const ZTIMER_SEC_BASE = &_ztimer_periph_timer_msec_sec.super;
+#    define ZTIMER_SEC_CONVERT_LOWER        (&_ztimer_periph_timer_rtt_msec_sec)
+#    define ZTIMER_SEC_CONVERT_LOWER_FREQ   RTT_FREQUENCY
+#  elif MODULE_ZTIMER_USEC
+static ztimer_convert_frac_t _ztimer_convert_frac_sec;
+ztimer_clock_t *const ZTIMER_SEC = &_ztimer_convert_frac_sec.super.super;
+ztimer_clock_t *const ZTIMER_SEC_BASE = &_ztimer_periph_timer_usec.super;
+#    define ZTIMER_SEC_CONVERT_LOWER        ZTIMER_USEC_BASE
+#    define ZTIMER_SEC_CONVERT_LOWER_FREQ   CONFIG_ZTIMER_USEC_BASE_FREQ
+#  else
+#  error No suitable ZTIMER_SEC config. Maybe add USEMODULE += ztimer_usec?
+#  endif
+#endif
+
 void ztimer_init(void)
 {
 #if MODULE_ZTIMER_USEC
@@ -166,4 +194,17 @@ void ztimer_init(void)
     ZTIMER_MSEC->required_pm_mode = CONFIG_ZTIMER_MSEC_REQUIRED_PM_MODE;
 #  endif
 #endif
+
+#if MODULE_ZTIMER_SEC
+#  if MODULE_ZTIMER_PERIPH_RTC
+    LOG_DEBUG("ztimer_init(): initializing rtc\n");
+    ztimer_periph_rtc_init(&_ztimer_periph_timer_rtc_sec);
+#  else
+    LOG_DEBUG("ztimer_init(): ZTIMER_SEC convert_frac from %lu to 1000\n",
+              (long unsigned)ZTIMER_SEC_CONVERT_LOWER_FREQ);
+    ztimer_convert_frac_init(&_ztimer_convert_frac_sec,
+                             ZTIMER_SEC_CONVERT_LOWER,
+                             FREQ_1HZ, ZTIMER_SEC_CONVERT_LOWER_FREQ);
+#  endif
+#endif
 }