feature: Support NTP server for time consumption.

Author: eleonel

webscreen/build/esp32.esp32.esp32s3/webscreen.ino.bin

@@ -11,6 +11,7 @@
 #include <WiFiClientSecure.h>
 #include <ArduinoJson.h>
 #include <PubSubClient.h>  // For MQTT
+#include <time.h>
 
 #include <vector>
 #include <utility>  // for std::pair
@@ -3295,6 +3296,67 @@ static jsval_t js_get_brightness(struct js *js, jsval_t *args, int nargs) {
   return js_mknum((double)webscreen_display_get_brightness());
 }
 
+/******************************************************************************
+ * H3) NTP Time API
+ ******************************************************************************/
+
+static jsval_t js_get_hours(struct js *js, jsval_t *args, int nargs) {
+  struct tm timeinfo;
+  if (!getLocalTime(&timeinfo, 10)) return js_mknum(-1);
+  return js_mknum((double)timeinfo.tm_hour);
+}
+
+static jsval_t js_get_minutes(struct js *js, jsval_t *args, int nargs) {
+  struct tm timeinfo;
+  if (!getLocalTime(&timeinfo, 10)) return js_mknum(-1);
+  return js_mknum((double)timeinfo.tm_min);
+}
+
+static jsval_t js_get_seconds(struct js *js, jsval_t *args, int nargs) {
+  struct tm timeinfo;
+  if (!getLocalTime(&timeinfo, 10)) return js_mknum(-1);
+  return js_mknum((double)timeinfo.tm_sec);
+}
+
+static jsval_t js_get_year(struct js *js, jsval_t *args, int nargs) {
+  struct tm timeinfo;
+  if (!getLocalTime(&timeinfo, 10)) return js_mknum(-1);
+  return js_mknum((double)(timeinfo.tm_year + 1900));
+}
+
+static jsval_t js_get_month(struct js *js, jsval_t *args, int nargs) {
+  struct tm timeinfo;
+  if (!getLocalTime(&timeinfo, 10)) return js_mknum(-1);
+  return js_mknum((double)(timeinfo.tm_mon + 1));  // 1-12
+}
+
+static jsval_t js_get_day(struct js *js, jsval_t *args, int nargs) {
+  struct tm timeinfo;
+  if (!getLocalTime(&timeinfo, 10)) return js_mknum(-1);
+  return js_mknum((double)timeinfo.tm_mday);
+}
+
+static jsval_t js_get_weekday(struct js *js, jsval_t *args, int nargs) {
+  struct tm timeinfo;
+  if (!getLocalTime(&timeinfo, 10)) return js_mknum(-1);
+  return js_mknum((double)timeinfo.tm_wday);  // 0=Sunday, 6=Saturday
+}
+
+static jsval_t js_get_epoch(struct js *js, jsval_t *args, int nargs) {
+  time_t now;
+  time(&now);
+  if (now < 1609459200) return js_mknum(-1);  // Before 2021-01-01
+  return js_mknum((double)now);
+}
+
+static jsval_t js_ntp_synced(struct js *js, jsval_t *args, int nargs) {
+  struct tm timeinfo;
+  if (getLocalTime(&timeinfo, 10) && timeinfo.tm_year > (2020 - 1900)) {
+    return js_mktrue();
+  }
+  return js_mkfalse();
+}
+
 /******************************************************************************
  * I) Register All JS Functions
  ******************************************************************************/
@@ -3311,6 +3373,18 @@ void register_js_functions() {
   js_set(js, global, "delay", js_mkfun(js_delay));
   js_set(js, global, "set_brightness", js_mkfun(js_set_brightness));
   js_set(js, global, "get_brightness", js_mkfun(js_get_brightness));
+
+  // NTP Time functions
+  js_set(js, global, "get_hours", js_mkfun(js_get_hours));
+  js_set(js, global, "get_minutes", js_mkfun(js_get_minutes));
+  js_set(js, global, "get_seconds", js_mkfun(js_get_seconds));
+  js_set(js, global, "get_year", js_mkfun(js_get_year));
+  js_set(js, global, "get_month", js_mkfun(js_get_month));
+  js_set(js, global, "get_day", js_mkfun(js_get_day));
+  js_set(js, global, "get_weekday", js_mkfun(js_get_weekday));
+  js_set(js, global, "get_epoch", js_mkfun(js_get_epoch));
+  js_set(js, global, "ntp_synced", js_mkfun(js_ntp_synced));
+
   js_set(js, global, "create_timer", js_mkfun(js_create_timer));
   js_set(js, global, "toNumber", js_mkfun(js_to_number));
   js_set(js, global, "numberToString", js_mkfun(js_number_to_string));

webscreen/build/esp32.esp32.esp32s3/webscreen.ino.elf

@@ -3,6 +3,8 @@
 #include "webscreen_config.h"
 #include "webscreen_hardware.h"
 #include <WiFi.h>
+#include <time.h>
+#include <sys/time.h>
 #include <esp_system.h>
 #include <freertos/FreeRTOS.h>
 #include <freertos/task.h>
@@ -89,6 +91,12 @@ void SerialCommands::processCommand(const String& command) {
   else if (baseCmd == "brightness") {
     setBrightness(args);
   }
+  else if (baseCmd == "time") {
+    showTime();
+  }
+  else if (baseCmd == "settime") {
+    setTime(args);
+  }
   else {
     printError("Unknown command: " + baseCmd + ". Type /help for available commands.");
   }
@@ -114,6 +122,8 @@ void SerialCommands::showHelp() {
   Serial.println("/backup [save|restore]   - Backup/restore configuration");
   Serial.println("/monitor [cpu|mem|net]   - Live system monitoring");
   Serial.println("/brightness <0-255>     - Set display brightness");
+  Serial.println("/time                    - Show current device time");
+  Serial.println("/settime <epoch> [tz]    - Set device time from epoch");
   Serial.println("/reboot                  - Restart the device");
   Serial.println("\nExamples:");
   Serial.println("/write hello.js");
@@ -1055,4 +1065,57 @@ void SerialCommands::setBrightness(const String& args) {
 
   webscreen_display_set_brightness((uint8_t)brightness);
   printSuccess("Brightness set to " + String(brightness));
+}
+
+void SerialCommands::showTime() {
+  struct tm timeinfo;
+  if (!getLocalTime(&timeinfo, 100)) {
+    printError("Time not available (NTP not synced)");
+    return;
+  }
+
+  Serial.printf("Current time: %04d-%02d-%02d %02d:%02d:%02d\n",
+                timeinfo.tm_year + 1900, timeinfo.tm_mon + 1, timeinfo.tm_mday,
+                timeinfo.tm_hour, timeinfo.tm_min, timeinfo.tm_sec);
+  Serial.printf("Epoch: %lu\n", (unsigned long)mktime(&timeinfo));
+  Serial.printf("Day of week: %d (0=Sun)\n", timeinfo.tm_wday);
+}
+
+void SerialCommands::setTime(const String& args) {
+  String val = args;
+  val.trim();
+
+  if (val.length() == 0) {
+    printError("Usage: /settime <epoch> [timezone]");
+    return;
+  }
+
+  int spaceIndex = val.indexOf(' ');
+  String epochStr = (spaceIndex > 0) ? val.substring(0, spaceIndex) : val;
+  String tz = (spaceIndex > 0) ? val.substring(spaceIndex + 1) : "";
+  tz.trim();
+
+  unsigned long epoch = strtoul(epochStr.c_str(), NULL, 10);
+  if (epoch < 1609459200) {  // Before 2021-01-01
+    printError("Invalid epoch value");
+    return;
+  }
+
+  struct timeval tv;
+  tv.tv_sec = epoch;
+  tv.tv_usec = 0;
+  settimeofday(&tv, NULL);
+
+  if (tz.length() > 0) {
+    setenv("TZ", tz.c_str(), 1);
+    tzset();
+  }
+
+  struct tm timeinfo;
+  getLocalTime(&timeinfo);
+
+  Serial.printf("Time set: %04d-%02d-%02d %02d:%02d:%02d\n",
+                timeinfo.tm_year + 1900, timeinfo.tm_mon + 1, timeinfo.tm_mday,
+                timeinfo.tm_hour, timeinfo.tm_min, timeinfo.tm_sec);
+  printSuccess("Device time synchronized");
 }

webscreen/build/esp32.esp32.esp32s3/webscreen.ino.map

@@ -29,6 +29,8 @@ class SerialCommands {
   static void backup(const String& args);
   static void monitor(const String& args);
   static void setBrightness(const String& args);
+  static void showTime();
+  static void setTime(const String& args);
 
   static void printPrompt();
   static String formatBytes(size_t bytes);

webscreen/build/esp32.esp32.esp32s3/webscreen.ino.merged.bin

@@ -57,6 +57,7 @@ void setup() {
       // Don't return here - continue to check if script exists
     } else {
       LOG("Wi-Fi connected successfully.");
+      webscreen_ntp_setup_from_config();
     }
   } else {
     LOG("No WiFi configured, running in offline mode.");

webscreen/lvgl_elk.h

@@ -16,7 +16,7 @@
 #define WEBSCREEN_VERSION_MAJOR 2
 #define WEBSCREEN_VERSION_MINOR 0
 #define WEBSCREEN_VERSION_PATCH 0
-#define WEBSCREEN_VERSION_STRING "2.0.6"
+#define WEBSCREEN_VERSION_STRING "2.0.7"
 
 // ============================================================================
 // HARDWARE CONFIGURATION
@@ -82,6 +82,10 @@
 #define WEBSCREEN_MQTT_KEEPALIVE_SEC 60
 #define WEBSCREEN_MQTT_MAX_PACKET_SIZE 1024
 
+// NTP Configuration
+#define WEBSCREEN_NTP_SERVER_DEFAULT "pool.ntp.org"
+#define WEBSCREEN_NTP_SYNC_TIMEOUT_MS 10000
+
 // ============================================================================
 // SYSTEM CONFIGURATION
 // ============================================================================

webscreen/serial_commands.cpp

@@ -31,7 +31,7 @@ webscreen_config_t g_webscreen_config = { .wifi = {
                                             .auto_reconnect = true },
                                           .mqtt = { .broker = "", .port = 1883, .username = "", .password = "", .client_id = "webscreen_001", .enabled = false, .keepalive = WEBSCREEN_MQTT_KEEPALIVE_SEC },
                                           .display = { .brightness = 200, .rotation = WEBSCREEN_DISPLAY_ROTATION, .background_color = 0x000000, .foreground_color = 0xFFFFFF, .auto_brightness = false, .screen_timeout = 0 },
-                                          .system = { .device_name = "WebScreen", .timezone = "UTC", .log_level = 2, .performance_mode = false, .watchdog_timeout = WEBSCREEN_WATCHDOG_TIMEOUT_SEC * 1000 },
+                                          .system = { .device_name = "WebScreen", .timezone = "UTC", .ntp_server = "pool.ntp.org", .log_level = 2, .performance_mode = false, .watchdog_timeout = WEBSCREEN_WATCHDOG_TIMEOUT_SEC * 1000 },
                                           .script_file = "/app.js",
                                           .config_version = 2,
                                           .last_modified = 0 };
@@ -186,6 +186,23 @@ static bool load_configuration(void) {
   WEBSCREEN_DEBUG_PRINTF("Config: display.brightness = %d\n", g_webscreen_config.display.brightness);
   g_webscreen_config.system.log_level = doc["system"]["log_level"] | g_webscreen_config.system.log_level;
 
+  // Load timezone (check both system.timezone and top-level timezone for backward compat)
+  if (doc["system"]["timezone"]) {
+    WEBSCREEN_STR_COPY(g_webscreen_config.system.timezone,
+                       doc["system"]["timezone"], sizeof(g_webscreen_config.system.timezone));
+  } else if (doc["timezone"]) {
+    WEBSCREEN_STR_COPY(g_webscreen_config.system.timezone,
+                       doc["timezone"], sizeof(g_webscreen_config.system.timezone));
+  }
+
+  // Load NTP server
+  if (doc["system"]["ntp_server"]) {
+    WEBSCREEN_STR_COPY(g_webscreen_config.system.ntp_server,
+                       doc["system"]["ntp_server"], sizeof(g_webscreen_config.system.ntp_server));
+  }
+  WEBSCREEN_DEBUG_PRINTF("Config: timezone=%s, ntp_server=%s\n",
+                         g_webscreen_config.system.timezone, g_webscreen_config.system.ntp_server);
+
   if (doc["script_file"]) {
     WEBSCREEN_STR_COPY(g_webscreen_config.script_file,
                        doc["script_file"], sizeof(g_webscreen_config.script_file));
@@ -326,9 +343,23 @@ bool webscreen_load_config(const char *path,
 
   // Load display brightness into global config so init_lvgl_display() can apply it
   g_webscreen_config.display.brightness = doc["display"]["brightness"] | g_webscreen_config.display.brightness;
-  WEBSCREEN_DEBUG_PRINTF("Config loaded - SSID: %s, Script: %s, MQTT: %s, Brightness: %d\n",
+
+  // Load timezone (check top-level first, then system.timezone)
+  const char* tz = doc["timezone"] | (const char*)nullptr;
+  if (!tz) tz = doc["system"]["timezone"] | (const char*)nullptr;
+  if (tz) {
+    WEBSCREEN_STR_COPY(g_webscreen_config.system.timezone, tz, sizeof(g_webscreen_config.system.timezone));
+  }
+
+  // Load NTP server
+  const char* ntp = doc["system"]["ntp_server"] | (const char*)nullptr;
+  if (ntp) {
+    WEBSCREEN_STR_COPY(g_webscreen_config.system.ntp_server, ntp, sizeof(g_webscreen_config.system.ntp_server));
+  }
+
+  WEBSCREEN_DEBUG_PRINTF("Config loaded - SSID: %s, Script: %s, MQTT: %s, Brightness: %d, TZ: %s\n",
                          outSSID.c_str(), outScript.c_str(), outMqttEnabled ? "enabled" : "disabled",
-                         g_webscreen_config.display.brightness);
+                         g_webscreen_config.display.brightness, g_webscreen_config.system.timezone);
 
   return true;
 }