NTP support for PortalBase

adafruit_portalbase/network.py

@@ -735,6 +735,108 @@ def process_json(self, json_data, json_path):
             values = json.dumps(json_data)
         return values
 
+    def _tz_from_env(self, default: float = 0.0) -> float:
+        tz = default
+        v = os.getenv("NTP_TZ")
+        if v:
+            try:
+                tz = float(v)
+            except ValueError:
+                pass
+        v = os.getenv("NTP_DST")
+        if v:
+            try:
+                tz += float(v)
+            except ValueError:
+                pass
+        return tz
+
+    def _socketpool_for_wifi(self):
+        """Return a SocketPool for whichever Wi-Fi backend is available.
+        Works with native ESP32-S2/S3/C6 (wifi.radio) and ESP32SPI coprocessors.
+        Some CP10 board wrappers may not expose .radio/.esp; in that case,
+        try the native wifi.radio directly.
+        """
+        wm = getattr(self, "_wifi", None)
+        radio = getattr(wm, "radio", None)
+        esp = getattr(wm, "esp", None) or getattr(wm, "_esp", None)
+
+        # CP10/MagTag fallback: wrapper didn't expose .radio/.esp -> use native radio
+        if (radio is None) and (esp is None):
+            try:
+                import wifi as _wifi_mod  # type: ignore
+
+                radio = getattr(_wifi_mod, "radio", None)
+            except Exception:
+                radio = None
+
+        target = radio if (radio is not None) else esp
+        if target is None:
+            raise RuntimeError("No WiFi radio/esp found")
+
+        # Prefer connection_manager helper, else direct SocketPool fallback
+        try:
+            from adafruit_connection_manager import get_radio_socketpool  # lazy import
+
+            return get_radio_socketpool(target)
+        except Exception:
+            import socketpool  # type: ignore
+
+            return socketpool.SocketPool(target)
+
+    def _wait_for_ready_optional(self, timeout: float = 10.0, poll: float = 0.05) -> None:
+        wm = getattr(self, "_wifi", None)
+        ready = getattr(wm, "esp32_ready", None)
+        if ready is None:
+            return
+        start = time.monotonic()
+        while time.monotonic() - start < timeout:
+            if not ready.value:
+                return
+            time.sleep(poll)
+        raise TimeoutError("ESP32 not responding")
+
+    def time_sync(self, server=None, timeout=None, retries=None, tz=None):
+        server = server or os.getenv("NTP_SERVER", "0.adafruit.pool.ntp.org")
+        retries = int(os.getenv("NTP_RETRIES", "8")) if retries is None else int(retries)
+        timeout = float(os.getenv("NTP_TIMEOUT", "5.0")) if timeout is None else float(timeout)
+        tz = self._tz_from_env() if tz is None else float(tz)
+
+        if not self.is_connected:
+            self.connect()
+
+        try:
+            self._wait_for_ready_optional()
+        except Exception:
+            pass
+
+        pool = self._socketpool_for_wifi()
+
+        last_exc = None
+        for _ in range(max(1, retries)):
+            try:
+                from adafruit_ntp import NTP  # lazy import for CI/tests
+
+                try:
+                    ntp = NTP(pool, server=server, tz=tz, socket_timeout=timeout)
+                except TypeError:
+                    ntp = NTP(pool, server=server, tz_offset=tz, socket_timeout=timeout)
+
+                setter = getattr(ntp, "set_time", None)
+                if setter:
+                    setter()
+                    return time.localtime()
+
+                now = ntp.datetime
+                if rtc:
+                    rtc.RTC().datetime = now
+                return now
+            except Exception as ex:
+                last_exc = ex
+                time.sleep(0.5)
+
+        raise last_exc or RuntimeError("NTP sync failed")
+
     @property
     def is_connected(self):
         """Return whether we are connected."""

adafruit_portalbase/wifi_coprocessor.py

@@ -25,7 +25,7 @@
 import adafruit_connection_manager
 import adafruit_requests
 import board
-from adafruit_esp32spi import adafruit_esp32spi, adafruit_esp32spi_wifimanager
+from adafruit_esp32spi import adafruit_esp32spi
 from digitalio import DigitalInOut
 
 __version__ = "0.0.0+auto.0"

examples/portalbase_time.py

@@ -0,0 +1,30 @@
+# SPDX-FileCopyrightText: 2025 Mikey Sklar for Adafruit Industries
+#
+# SPDX-License-Identifier: MIT
+
+# Uncomment ONE board setup:
+
+# --- PyPortal ---
+# from adafruit_pyportal import PyPortal
+# portal = PyPortal(status_neopixel=None)
+# net = portal.network
+
+# --- MatrixPortal M4 ---
+# from adafruit_matrixportal.matrixportal import MatrixPortal
+# portal = MatrixPortal(status_neopixel=None)
+# net = portal.network
+
+# --- MagTag (ESP32-S2 native WiFi) ---
+# from adafruit_magtag.magtag import MagTag
+# magtag = MagTag(status_neopixel=None)
+# net = magtag.network
+
+# --- Fruit Jam (wrap its WiFi) ---
+from adafruit_fruitjam import FruitJam
+
+jam = FruitJam(status_neopixel=None)
+net = jam.network
+
+
+# --- shared output ---
+print(net.time_sync())