feat: 实现时间同步、NVS稳定性修复和ESP-IDF v6.0兼容性改进

main/time_sync/time_sync.h

@@ -0,0 +1,50 @@
+#pragma once
+
+#include "esp_err.h"
+
+/**
+ * Initialize SNTP time synchronization.
+ * Should be called after WiFi is connected.
+ * Automatically applies timezone from NVS and loads custom NTP server from NVS.
+ */
+esp_err_t time_sync_init(void);
+
+/**
+ * Get current SNTP sync status.
+ * @return true if time has been synchronized, false otherwise
+ */
+bool time_sync_is_synced(void);
+
+/**
+ * Get a human-readable sync status string.
+ * @return "synced", "syncing", or "not_synced"
+ */
+const char *time_sync_status_str(void);
+
+/**
+ * Get the last synchronized time as a formatted string.
+ * @param out buffer to write the formatted time string
+ * @param out_size size of the output buffer
+ * @return true if a sync time is recorded, false otherwise
+ */
+bool time_sync_get_last_synced(char *out, size_t out_size);
+
+/**
+ * Get the current NTP server (custom from NVS or default).
+ * @return NTP server hostname
+ */
+const char *time_sync_get_server(void);
+
+/**
+ * Set a custom NTP server and save to NVS.
+ * Takes effect on next time_sync_init() or time_sync_restart().
+ * @param server NTP server hostname
+ * @return ESP_OK on success
+ */
+esp_err_t time_sync_set_server(const char *server);
+
+/**
+ * Restart SNTP with the current server configuration.
+ * Useful for applying a newly set NTP server without rebooting.
+ */
+esp_err_t time_sync_restart(void);