Add features to Fruit Jam library

[b-blake]

Hello,

Would it be possible to add these features for Fruit Jam's library?

fruitjam.ping,
fruitjam.firmware_version,
fruitjam.MAC_address

Thanks,
Bruce

[mikeysklar]

@ladyada if it's alright I can dd these to the network.py module by exposing a pass-thru to the radio. This would be in a similar fashion to how the PyPortal and MatrixPortal M4 use ESP_SPIControl.

[ladyada]

please add this, ntp, etc to portalbase. i dont like specialized code that is not hardware dep :/

[mikeysklar]

https://github.com/adafruit/Adafruit_CircuitPython_PortalBase makes sense. I'll add it there.

[mikeysklar]

FruitJam plays nice with PortalBase. I've not ported NTP over yet, but I will next.

Example that runs now on FruitJam using PortalBase for mac address and ping check. Then FJ for NTP and fetch.

# code.py — FruitJam network diag (no display)

import time
from adafruit_fruitjam import FruitJam

def fmt_mac(mac_like):
    return ":".join(f"{b:02X}" for b in mac_like)

fj = FruitJam(debug=False)

# sync time
try:
    t = fj.sync_time()
    print("RTC set to:", t)
except Exception as e:
    print("NTP sync skipped:", e)

# airlift handle
wm = getattr(fj.network, "_wifi", None)
esp = getattr(wm, "esp", None) or getattr(wm, "_esp", None)
if not esp:
    raise RuntimeError("No ESP32SPI handle found")

# firmware + mac
fw = esp.firmware_version
fw_str = fw.decode("utf-8", "ignore") if isinstance(fw, (bytes, bytearray)) else str(fw)
mac = esp.MAC_address
print("Backend : AirLift (ESP32SPI coprocessor)")
print("Firmware:", fw_str)
print("MAC     :", fmt_mac(mac))

# ping test
try:
    rtt = esp.ping([8, 8, 8, 8])
    print("Ping 8.8.8.8:", "fail" if rtt in (None, 0xFFFF) else f"{rtt} ms")
except Exception as e:
    print("Ping error:", e)

# http timing
try:
    t0 = time.monotonic()
    r = fj.network.fetch("https://httpbin.org/get", timeout=5)
    r.close()
    print(f"HTTP round-trip: {(time.monotonic() - t0) * 1000:.0f} ms")
except Exception as e:
    print("HTTP timing error:", e)

output:

[NTP] === sync_time start ===
[NTP] ensuring Wi-Fi connectivity…
Connecting to AP foreverrun
[NTP] server=pool.ntp.org, tz=-4.0
[NTP] timeout=1.0s, cache=0, require_year>=2022
[NTP] retries=8, delay=1.5s
[NTP] attempt 1/8 …
[NTP] attempt 1 OK in 0.08s
[NTP] SUCCESS: struct_time(tm_year=2025, tm_mon=8, tm_mday=27, tm_hour=11, tm_min=21, tm_sec=51, tm_wday=2, tm_yday=239, tm_isdst=-1)
[NTP] setting rtc.RTC().datetime (total 0.09s)
RTC set to: struct_time(tm_year=2025, tm_mon=8, tm_mday=27, tm_hour=11, tm_min=21, tm_sec=51, tm_wday=2, tm_yday=239, tm_isdst=-1)
Backend : AirLift (ESP32SPI coprocessor)
Firmware: 3.1.0
MAC     : 7C:2C:67:5B:1E:B4
Ping 8.8.8.8: 33 ms
Retrieving data...HTTP round-trip: 3928 ms

[b-blake]

Mikey,

Can the IP address for ping be changed from comma separated to dot separated?

rtt = esp.ping([8, 8, 8, 8])

TIA,
Bruce

[mikeysklar]

Swap the square brackets for double quotes and commas for dots.

# ping test
try:
    rtt = esp.ping("8.8.8.8")  # dotted string instead of [8,8,8,8]
    print("Ping 8.8.8.8:", "fail" if rtt in (None, 0xFFFF) else f"{rtt} ms")
except Exception as e:
    print("Ping error:", e)

the above was just an example to show it won't take much to let Fruit Jam use PortalBase.

[b-blake]

I apologize for my nearsightedness. Thanks.