Skip to content

RF Controls, DHCP Routing, ESP32-P4 Support & nRF52 Recovery

Latest

Choose a tag to compare

@yellowcooln yellowcooln released this 16 Nov 21:02
589f3f4

This release expands runtime radio management, adds DHCP-based routing support, introduces firmware support for newer ESP32-P4 silicon revisions, and improves nRF52 reliability with watchdog recovery.

It also adds Station G3 WebUI controls and strengthens USB/TCP request handling, radio-state reporting, and firmware release validation.

Highlights

  • Runtime RF Controls: Added host-protocol controls for AGC, RF front-end settings, and SX1262 RX boost.
  • DHCP Routing: Added classless static route support for remote subnet connectivity.
  • Station G3: Added persistent PA mode and external RX LNA controls to the WebUI.
  • ESP32-P4: Added support for v3.1/v3.2 silicon while preserving compatibility with older boards.
  • Automatic Firmware Selection: The companion web flasher now detects ESP32-P4 chip revisions and selects the matching firmware.
  • nRF52 Recovery: Added a 30-second main-loop watchdog and expanded reset diagnostics.
  • USB Reliability: Fixed stalled USB replies that could remain buffered until another request arrived.
  • TCP Safety: Improved request ownership to prevent disconnected clients from applying queued RF changes.
  • Firmware Automation: Improved artifact validation and generated-assets PR handling.

Runtime Radio Controls

Added new host-protocol controls and capability queries for supported radio features:

  • Automatic Gain Control (AGC)
  • RF front-end configuration
  • SX1262 RX boost

Supported RF changes can now wait for active packet reception to finish instead of immediately rejecting the request.

These controls allow compatible host software to adjust supported radio settings during operation.

Note: Host-protocol RF changes are runtime-only and are not persisted across reboot.

DHCP Classless Static Routes

ESP32 network modems now support DHCP-provided classless static routes.

  • Added DHCP option 121 support.
  • Added DHCP option 249 fallback.
  • Allows modems to return traffic to remote subnets advertised by the DHCP server.
  • Eliminates the need for reverse proxies or source NAT in supported routed deployments.
  • Added route diagnostics to the WebUI and network API.

Routing Reliability

  • Routes are tied to their accepted DHCP lease and network interface.
  • Stale return routes are removed when their associated lease or interface is no longer valid.
  • Gateway-only DHCP renewals no longer unnecessarily disconnect active modem TCP sessions.

These improvements make network modem deployments more reliable across routed VLANs and subnets.

Station G3 WebUI Controls

Added hardware-specific RF front-end controls to the Station G3 WebUI home page.

New controls include:

  • PA mode selection
  • External RX LNA control

These settings use the existing persistent configuration system.

Important: Station G3 power and RF-jumper safety requirements still apply. Review the board documentation before changing PA/LNA settings.

ESP32-P4 Production Silicon Support

Waveshare introduced a new revision of its ESP32-P4 boards, so we've added support for both v3.1 and v3.2 silicon while retaining support for older boards.

We've also confirmed that MeshSmith EtherMesh-1W boards shipping from November 2026 use the new v3.2 silicon.

The companion web flasher has been updated to detect the chip revision and automatically select the matching firmware for the chosen board.

New Firmware Targets

Added dedicated production-silicon environments:

  • ethermesh_1w_v3
  • esp32_p4_nano_v3

The existing pre-v3 firmware environments remain available for older hardware.

Firmware Compatibility Improvements

  • Uses matching SDK libraries and bootloaders for each silicon family.
  • Includes Espressif's v3.2 compatibility updates.
  • Preserves existing GPIO, Ethernet, radio, and RF front-end configurations.
  • Adds machine-readable board and silicon-profile metadata.
  • Defines supported silicon revision limits.
  • Includes firmware component offsets, sizes, and SHA-256 hashes.
  • Validates matching factory and application firmware components.
  • Verifies OTA partition compatibility during asset generation.

Important Compatibility Note

Legacy and production ESP32-P4 firmware packages are not interchangeable.

A firmware image may flash successfully but fail to boot if its SDK or bootloader is incompatible with the board's silicon revision.

The updated companion web flasher automatically detects the connected chip revision and selects the appropriate firmware for the chosen board.

Physical hardware acceptance testing remains separate from automated compilation and firmware package validation.

USB & TCP Reliability

USB Reply Recovery

Fixed an issue where USB replies could remain buffered until another request arrived.

A bounded HWCDC stalled-output watchdog now detects and releases affected replies.

  • Applies to supported USB Serial/JTAG configurations.
  • Prevents indefinitely buffered responses.
  • TinyUSB targets retain their existing behavior.

Deferred RF Request Safety

Improved handling of RF requests queued by TCP clients.

  • Queued requests are associated with the connection that submitted them.
  • Requests from disconnected or invalidated sessions are discarded.
  • Stale requests cannot modify radio state after their originating connection closes.
  • Old responses cannot be delivered to replacement connections.
  • W5100S queue processing respects its single-response capacity.

These changes prevent stale client requests from interfering with active modem sessions.

Radio-State Reliability

Improved error handling and state reporting for radio operations.

Failures involving:

  • RX boost rollback
  • AGC maintenance
  • Receive-mode restart

are now reported instead of leaving the host with misleading cached healthy-state information.

This provides more accurate diagnostics when radio configuration or recovery operations fail.

nRF52 Watchdog Recovery

Added a main-loop watchdog for nRF52 modem targets.

  • Default watchdog timeout: 30 seconds
  • Provides automatic recovery from stalled firmware execution.
  • Improves reliability for unattended and battery-backed deployments.

Expanded Boot Diagnostics

Boot diagnostics now report:

  • Captured reset flags
  • Observed watchdog timeout
  • Watchdog reload channels
  • Sleep configuration
  • Debug configuration
  • Settings inherited across software resets

Note: The watchdog provides a recovery mechanism but does not establish the underlying cause of previously reported stalls. Additional hardware testing and long-duration validation remain important.

Firmware Build & Release Automation

Improved the automated firmware asset workflow.

  • Uses a dedicated credential for generated-assets pull requests.
  • Reports missing credentials explicitly.
  • Reports PR-creation failures instead of silently continuing.
  • Expands validation for ESP32-P4 firmware artifacts.
  • Verifies matching firmware components and OTA partition compatibility.

Testing & Documentation

Expanded regression coverage for:

  • Runtime RF controls
  • Deferred request ownership
  • DHCP route lifecycle
  • USB HWCDC recovery
  • ESP32-P4 firmware artifact compatibility
  • nRF52 watchdog behavior
  • Boot diagnostics
  • Radio-state failure reporting

Updated documentation includes:

  • README
  • Installation instructions
  • API reference
  • ESP32-P4 silicon compatibility guidance

Compatibility & Upgrade Notes

Existing Installations

Existing modem transports and hardware profiles remain supported.

  • Runtime RF settings are not persisted across reboot.
  • Existing pre-v3 ESP32-P4 firmware environments remain available.
  • Station G3 persistent RF settings retain their existing behavior.

ESP32-P4 Users

The companion web flasher now automatically detects the ESP32-P4 silicon revision and selects the matching firmware for the chosen board.

For manual flashing, ensure you select the correct firmware target for your hardware revision.

Do not interchange legacy and production-silicon firmware bundles.

nRF52 Users

The new watchdog provides automatic recovery from firmware stalls, but affected-device soak testing is still recommended.

Hardware Validation

Physical ESP32-P4 acceptance testing and long-duration nRF52 recovery testing remain separate from automated compilation and firmware packaging validation.

Contributors

Special thanks to everyone who contributed improvements, hardware support, testing, and review.

  • @agessaman — AGC/FEM/RX-boost host controls and HWCDC USB reply recovery. (#81, #82)
  • @thfree — DHCP classless static routes and return-routing support. (#86)
  • @jram0421 — Station G3 RF front-end controls in the WebUI. (#89)
  • @efiten — nRF52 main-loop watchdog recovery. (#91)
  • @yellowcooln — ESP32-P4 production-silicon profiles and artifact validation, connection-owned RF requests, DHCP lease/interface integration, expanded nRF52 diagnostics, regression testing, documentation, and release/flasher coordination. (#81, #86, #88, #91, #94)

v1.4.2 improves openHop Modem reliability across USB, TCP, Ethernet, and nRF52 deployments while expanding runtime RF controls and supporting both legacy and newer ESP32-P4 hardware.

Thanks to everyone who contributed code, hardware reports, and testing!


Full Changelog: v1.4.0...v1.4.2