feat(zigbee): upgrade zigbee example to v2.0

examples/zigbee/zb_common_components/example_common/include/alarm_timer.h

@@ -0,0 +1,47 @@
+/*
+ * SPDX-FileCopyrightText: 2026 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: LicenseRef-Included
+ *
+ * Alarm driver
+ *
+ * Unless required by applicable law or agreed to in writing, this
+ * software is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
+ * CONDITIONS OF ANY KIND, either express or implied.
+ */
+
+#pragma once
+
+#include <stdint.h>
+#include "esp_err.h"
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/**
+ * @brief The argument type for the alarm callback.
+ *
+ */
+typedef uintptr_t alarm_timer_arg_t;
+
+/**
+ * @brief The callback for the timer.
+ *
+ */
+typedef void (*alarm_timer_callback_t)(alarm_timer_arg_t arg);
+
+/**
+ * @brief Schedule an alarm to fire at a given time.
+ *
+ * @param cb The callback to execute when the alarm fires.
+ * @param arg The argument to pass to the callback.
+ * @param time_ms The time to fire the timer in milliseconds.
+ *
+ * @return ESP_OK on success, error code otherwise.
+ */
+esp_err_t alarm_timer_schedule(alarm_timer_callback_t cb, alarm_timer_arg_t arg, uint32_t time_ms);
+
+#ifdef __cplusplus
+}
+#endif