chore: import upstream snapshot with attribution

components/esp_hal_rtc_timer/include/hal/rtc_timer_hal.h

@@ -0,0 +1,37 @@
+/*
+ * SPDX-FileCopyrightText: 2020-2025 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+#pragma once
+
+#include <stdint.h>
+#include "soc/soc_caps.h"
+#include "hal/rtc_timer_ll.h"
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+#if SOC_RTC_TIMER_SUPPORTED
+/**
+ * @brief Set wakeup timer value
+ *
+ * @param timer_id Timer ID
+ * @param ticks Timer value in RTC slow clock ticks
+ */
+#define rtc_timer_hal_set_wakeup_time(timer_id, ticks)         rtc_timer_ll_set_wakeup_time(timer_id, ticks)
+
+/**
+ * @brief Get current RTC timer cycle count
+ *
+ * @param timer_id Timer ID
+ * @return Current RTC time in RTC slow clock ticks
+ */
+#define rtc_timer_hal_get_cycle_count(timer_id)                 rtc_timer_ll_get_cycle_count(timer_id)
+#endif
+
+#ifdef __cplusplus
+}
+#endif