refactored to use fruitjam network module

Refactored and "works for me". I'll ask @b-blake to confirm functionality as well.

	•	Added Network.sync_time() method in network.py
	•	Uses adafruit_ntp + adafruit_connection_manager.
	•	Reads optional NTP_* keys from settings.toml.
	•	Sets rtc.RTC().datetime
	•	Added example examples/fruitjam_time_sync.py (sync once, print localtime).
	•	Added example examples/fruitjam_ntp_settings.toml

Author: mikeysklar

adafruit_fruitjam/__init__.py

@@ -245,6 +245,23 @@ def __init__(  # noqa: PLR0912,PLR0913,Too many branches,Too many arguments in f
 
         gc.collect()
 
+    def sync_time(self, **kwargs):
+        """Set the system RTC via NTP using this FruitJam's Network.
+
+        This is a convenience wrapper for ``self.network.sync_time(...)`` so
+        user code can simply call ``fruitjam.sync_time()``.
+
+        Keyword args are passed through to ``Network.sync_time``:
+          - server (str)         : NTP host (default from NTP_SERVER or pool.ntp.org)
+          - tz_offset (float)    : hours from UTC (default from NTP_TZ + NTP_DST)
+          - timeout (float)      : socket timeout seconds (default from NTP_TIMEOUT or 5.0)
+          - cache_seconds (int)  : NTP cache seconds (default from NTP_CACHE_SECONDS or 0)
+          - require_year (int)   : sanity check lower bound (default 2022)
+        Returns:
+          time.struct_time
+        """
+        return self.network.sync_time(**kwargs)
+
     def set_caption(self, caption_text, caption_position, caption_color):
         """A caption. Requires setting ``caption_font`` in init!
 

adafruit_fruitjam/network.py

@@ -25,9 +25,13 @@
 """
 
 import gc
+import os
 
+import adafruit_connection_manager as acm
+import adafruit_ntp
 import microcontroller
 import neopixel
+import rtc
 from adafruit_portalbase.network import (
     CONTENT_IMAGE,
     CONTENT_JSON,
@@ -209,3 +213,86 @@ def process_image(self, json_data, sd_card=False):  # noqa: PLR0912 Too many bra
             gc.collect()
 
         return filename, position
+
+    def sync_time(self, server=None, tz_offset=None, tuning=None):
+        """
+        Set the system RTC via NTP using this Network's Wi-Fi connection.
+
+        Reads optional settings from settings.toml:
+          NTP_SERVER         (default "pool.ntp.org")
+          NTP_TZ             (float hours from UTC, default 0)
+          NTP_DST            (additional offset, usually 0 or 1)
+          NTP_TIMEOUT        (seconds, default 5.0)
+          NTP_CACHE_SECONDS  (default 0 = always fetch fresh)
+          NTP_REQUIRE_YEAR   (minimum acceptable year, default 2022)
+
+        Keyword args:
+          server (str)        – override NTP_SERVER
+          tz_offset (float)   – override NTP_TZ (+ NTP_DST still applied)
+          tuning (dict)       – override other knobs:
+                                {"timeout": 5.0,
+                                 "cache_seconds": 0,
+                                 "require_year": 2022}
+
+        Returns:
+          time.struct_time
+        """
+        # Bring up Wi-Fi using the existing flow.
+        self.connect()
+
+        # Build a socket pool from the existing ESP interface.
+        pool = acm.get_radio_socketpool(self._wifi.esp)
+
+        # Settings with environment fallbacks.
+        server = server or os.getenv("NTP_SERVER") or "pool.ntp.org"
+
+        if tz_offset is None:
+            tz_env = os.getenv("NTP_TZ")
+            try:
+                tz_offset = float(tz_env) if tz_env not in {None, ""} else 0.0
+            except Exception:
+                tz_offset = 0.0
+
+        # Simple DST additive offset (no IANA time zone logic).
+        try:
+            dst = float(os.getenv("NTP_DST") or 0)
+        except Exception:
+            dst = 0.0
+        tz_offset += dst
+
+        # Optional tuning (env can override passed defaults).
+        t = tuning or {}
+
+        def _f(name, default):
+            v = os.getenv(name)
+            try:
+                return float(v) if v not in {None, ""} else float(default)
+            except Exception:
+                return float(default)
+
+        def _i(name, default):
+            v = os.getenv(name)
+            try:
+                return int(v) if v not in {None, ""} else int(default)
+            except Exception:
+                return int(default)
+
+        timeout = float(t.get("timeout", _f("NTP_TIMEOUT", 5.0)))
+        cache_seconds = int(t.get("cache_seconds", _i("NTP_CACHE_SECONDS", 0)))
+        require_year = int(t.get("require_year", _i("NTP_REQUIRE_YEAR", 2022)))
+
+        # Query NTP and set the system RTC.
+        ntp = adafruit_ntp.NTP(
+            pool,
+            server=server,
+            tz_offset=tz_offset,
+            socket_timeout=timeout,
+            cache_seconds=cache_seconds,
+        )
+        now = ntp.datetime  # struct_time
+
+        if now.tm_year < require_year:
+            raise RuntimeError("NTP returned an unexpected year; not setting RTC")
+
+        rtc.RTC().datetime = now
+        return now

adafruit_fruitjam/ntp.py

@@ -0,0 +1,29 @@
+# SPDX-FileCopyrightText: Copyright (c) 2025 Tim Cocks for Adafruit Industries
+#
+# SPDX-License-Identifier: MIT
+# Wi-Fi credentials
+CIRCUITPY_WIFI_SSID = "YourSSID"
+CIRCUITPY_WIFI_PASSWORD = "YourPassword"
+
+# NTP settings
+# Common UTC offsets (hours):
+#   0   UTC / Zulu
+#   1   CET  (Central Europe)
+#   2   EET  (Eastern Europe)
+#   3   FET  (Further Eastern Europe)
+#  -5   EST  (Eastern US)
+#  -6   CST  (Central US)
+#  -7   MST  (Mountain US)
+#  -8   PST  (Pacific US)
+#  -9   AKST (Alaska)
+# -10   HST  (Hawaii, no DST)
+
+NTP_SERVER   = "pool.ntp.org"   # NTP host (default pool.ntp.org)
+NTP_TZ       = -5               # timezone offset in hours
+NTP_DST      = 1                # daylight saving (0=no, 1=yes)
+NTP_INTERVAL = 3600             # re-sync interval (seconds)
+
+# Optional tuning
+NTP_TIMEOUT        = 5           # socket timeout in seconds
+NTP_CACHE_SECONDS  = 0           # cache results (0 = always fetch)
+NTP_REQUIRE_YEAR   = 2022        # sanity check minimum year

examples/fruitjam_ntp_settings.toml

@@ -1,10 +1,11 @@
 # SPDX-FileCopyrightText: Copyright (c) 2025 Tim Cocks for Adafruit Industries
 #
 # SPDX-License-Identifier: MIT
-#
-# see examples/settings.toml for NTP_ options
-#
-from adafruit_fruitjam.ntp import sync_time
+import time
+
+from adafruit_fruitjam import FruitJam
 
-now, next_sync = sync_time()
+fj = FruitJam()
+now = fj.sync_time()
 print("RTC set:", now)
+print("Localtime:", time.localtime())