From 218ed7e348f02f1ad1be379ea227b74eb2f26814 Mon Sep 17 00:00:00 2001 From: reubenmiller Date: Thu, 19 Nov 2026 09:17:15 +1000 Subject: [PATCH] feat: release tiny-edge's NuttX agent for the ESP32-S3-DevKitC tedge-agent-nuttx-esp32s3-devkitc: tiny-edge's esp32s3-devkit NuttX configuration with the module's octal PSRAM as a second heap region, which every feature needs. DEVICES.md records its run on an N16R8 board. Co-Authored-By: Claude Opus 5.5 --- DEVICES.md | 23 +++++++++++++++++++++++ README.md | 6 ++++-- release/devices.yml | 8 ++++++++ 3 files changed, 35 insertions(+), 2 deletions(-) diff --git a/DEVICES.md b/DEVICES.md index 52e4d27..e7c4c62 100644 --- a/DEVICES.md +++ b/DEVICES.md @@ -366,6 +366,29 @@ reading the USB port, from tiny-edge's NuttX change (`ports/nuttx/REPORT.md`): - **30 minutes** with telemetry and 52 tunnels: no gap in the measurements, free heap steady at about 96 KB, at most 63 % of any thread's stack. +### NuttX agent on the ESP32-S3 (2026-11-17) + +The same agent for the ESP32-S3-DevKitC-1 (N16R8): tiny-edge's +`esp32s3-devkit` NuttX configuration, with the module's 8 MB of octal PSRAM +as a second heap region (tiny-edge's +`ports/nuttx/configs/esp32s3-psram-octal.conf`). Its update image is +1,159,720 B, 75 % of its 1.5 MB slot, in the same 4 MB layout as the C6 +(the rest of the 16 MB flash is not used). dram0 holds 230,280 of +270,336 B. The image does not start on a module without PSRAM. + +On an ESP32-S3-DevKitC-1 N16R8 (eu-latest, device 5160686774), from +tiny-edge's NuttX change (`ports/nuttx/REPORT.md`, findings 32 and 33): + +- **Set-up:** with `tedge-onboard` over the board's USB port (the connector + labelled USB), a wrong password included. +- **Without PSRAM** the heap is 192 KB: its high-water mark reached 191 KB, + and log upload failed, with no room for a second TLS session. This is why + the release build always uses the PSRAM settings. +- **With PSRAM**, internal RAM keeps 135 KB free. Log upload works, and + parameters keep their values across a restart. A firmware update from + Cumulocity downloaded 1.16 MB in about 2.5 minutes, restarted, and + confirmed the image. + ### Identify measured (2026-10-06) `device-identify` adds `tedge identify [seconds]` (cloud shell) and the sw0 diff --git a/README.md b/README.md index 852946a..8c9ce68 100644 --- a/README.md +++ b/README.md @@ -18,7 +18,7 @@ carries ready-to-flash images for these devices — no toolchain, no build: | Device | Zephyr board | standalone | tedge-full | tedge-ota | tedge-onboard | nuttx | |---|---|---|---|---|---|---| | ESP32-C6-DevKitC-1 (N4) | `esp32c6_devkitc/esp32c6/hpcore` | `modbus-server`, `opcua-server`, `snmp-agent` | `modbus-server`, `snmp-agent`, `tedge-agent` | `modbus-server`, `snmp-agent`, `tedge-agent` | `tedge-agent-idf` | `tedge-agent` | -| ESP32-S3-DevKitC-1 (N16R8) | `esp32s3_devkitc/esp32s3/procpu` | `modbus-server`, `opcua-server`, `snmp-agent` | `modbus-server`, `snmp-agent`, `tedge-agent` | `modbus-server`, `snmp-agent`, `tedge-agent` | — | — | +| ESP32-S3-DevKitC-1 (N16R8) | `esp32s3_devkitc/esp32s3/procpu` | `modbus-server`, `opcua-server`, `snmp-agent` | `modbus-server`, `snmp-agent`, `tedge-agent` | `modbus-server`, `snmp-agent`, `tedge-agent` | — | `tedge-agent` | | Adafruit QT Py ESP32-S3 (N4R2) | `adafruit_qt_py_esp32s3/esp32s3/procpu` | `modbus-server`, `opcua-server`, `snmp-agent` | `modbus-server`, `snmp-agent`, `tedge-agent` | `modbus-server`, `opcua-server`, `snmp-agent`, `tedge-agent` | — | — | | ESP32-WROOM-32 DevKitC | `esp32_devkitc/esp32/procpu` | `modbus-server`, `opcua-server`, `snmp-agent` | — | `modbus-server`, `tedge-agent` | — | — | | ESP32-CAM (ESP32 + 4 MB PSRAM) | `esp32_devkitc/esp32/procpu` | — | — | `snmp-agent`, `modbus-server`, `tedge-agent` | — | — | @@ -44,7 +44,9 @@ carries ready-to-flash images for these devices — no toolchain, no build: `tedge-onboard` like the `tedge-onboard` images (on a DevKitC, the connector labelled USB). It boots through MCUboot, so a firmware update that cannot connect is rolled back. The images are not signed with a key: MCUboot checks their - hash. + hash. The ESP32-S3 image needs the module's 8 MB of octal PSRAM (an + `N16R8` module, as on the ESP32-S3-DevKitC-1 listed) and does not start + on a module without PSRAM. Each image comes as `---` with: diff --git a/release/devices.yml b/release/devices.yml index a63690d..8f5b7b9 100644 --- a/release/devices.yml +++ b/release/devices.yml @@ -115,6 +115,7 @@ devices: flash_size: 16MB esptool_before: default-reset tedge_board_conf: "{tiny-edge}/ports/zephyr/profiles/boards/esp32s3-devkitc.conf" + nuttx_board: esp32s3-devkit builds: - { app: modbus-server, variant: standalone } - { app: opcua-server, variant: standalone, pr: true } @@ -141,6 +142,13 @@ devices: - app: tedge-agent variant: tedge-ota measured: DEVICES.md#release-builds-measured-on-the-boards-2026-09-21 + # Every feature needs the module's 8 MB of octal PSRAM for the mbedTLS + # heap; the image does not start on a module without PSRAM. + - app: tedge-agent + variant: nuttx + pr: true + extra_conf: ["{tiny-edge}/ports/nuttx/configs/esp32s3-psram-octal.conf"] + measured: DEVICES.md#nuttx-agent-on-the-esp32-s3-2026-11-17 - id: qtpy-esp32s3 name: Adafruit QT Py ESP32-S3 (N4R2)