Hardware Example 04 — Online Services — Live Weather

Device Console: After flashing, use MONITOR for complete Wi-Fi, HTTPS, weather, time, and memory output. Explicit WiFi, IP, SD, heap, and RSSI lines can populate corresponding read-only I/O sections; weather values themselves are not currently interpreted there.

Status: PROVEN / CLOSED on the stock Waveshare ESP32-P4-WIFI6-Touch-LCD-7B with its stock onboard ESP32-C6.

This example proves ForgeUI Online Services through a live Weather implementation. In Studio, Load Example loads the editable project and Guide summarizes service behavior and testing; it is not a wiring guide. The current example is configured for Tauranga. Automatic location detection is not implemented or claimed.

Physical proof

The real Studio Build & Flash path passed with ESP-IDF 5.5.4, esp_hosted 1.4.7 and esp_wifi_remote 0.14.5. The proven transport is four-bit 40 MHz SDIO with streaming RX and Tx/Rx queues of 20/20. Startup performs an explicit esp_wifi_connect().

Physical evidence covers association, DHCP, DNS, the complete certificate record, certificate validation, HTTPS, HTTP 200, Open-Meteo current and forecast data, SNTP-synchronized Tauranga local time, live current/apparent temperature, humidity, wind, rain, UV, weather code and day/night values, forecast days/highs/lows, intended Fi icons, dynamic local backgrounds and stable runtime operation. It does not claim that every possible weather-code/background transition was physically observed. Minor visual cleanup may remain without changing this proof status.

Weather presentation

The project uses six intentional icon instances. The normal icon pipeline deduplicates their conversions to one 136x136 FiSun, one 40x40 FiSun and one 40x40 FiCloudRain asset. These hash-named generated C files are ephemeral: export preparation must materialize or verify them after any cleanup and before strict validation. A genuinely unresolved icon remains an export error. The intentional system_gear_icon Settings launcher remains separate.

Weather presentation selects ten runtime-reachable backgrounds from the reusable seventeen-background pack. Selection uses Open-Meteo weather_code plus is_day, changes the source on the existing LVGL background object, suppresses unchanged assignments and performs no extra request. See ForgeUI Weather Background Pack.

Lifecycle and authority

The supported route is:

normal Hardware Example loader -> icon/background materialization -> applicable cleanup -> dependency collection -> source existence verification -> strict export validation -> generation -> build -> explicit flash

assets/... means a path relative to firmware/ForgeUI-One/main; standalone exports preserve that structure. Permanent Weather PNG and RGB565 assets survive cleanup. Generated Fi conversions follow the normal icon lifecycle and are guaranteed at validation time, not accepted as placeholders. Networking ownership and evidence remain authoritative in ForgeUI ESP32-P4 Hosted Wi-Fi Architecture.