From e032c865c0aa820174c3bda88f6a67d448c9bed3 Mon Sep 17 00:00:00 2001 From: reubenmiller Date: Wed, 18 Nov 2026 16:13:12 +1000 Subject: [PATCH] feat: take tiny-edge 0.8.0, and set devices up with c8y tinyedge onboard tiny-edge 0.8.0 installs tedge-onboard as a go-c8y-cli extension. The README, the release notes and the bundle READMEs of the ESP-IDF and NuttX agents now give that as the way to run it, with the download as the alternative. Co-Authored-By: Claude Opus 5.5 --- README.md | 15 ++++++++++++--- apps/tedge-agent-idf/main/idf_component.yml | 2 +- scripts/release/notes.py | 4 +++- scripts/release/package_idf.py | 14 ++++++++++---- scripts/release/package_nuttx.py | 16 +++++++++++----- west.yml | 2 +- 6 files changed, 38 insertions(+), 15 deletions(-) diff --git a/README.md b/README.md index 2d8ef86..852946a 100644 --- a/README.md +++ b/README.md @@ -41,7 +41,7 @@ carries ready-to-flash images for these devices — no toolchain, no build: tenant. The images are not signed (ESP-IDF's bootloader, no MCUboot). - **nuttx** — `tedge-agent` on [NuttX](https://nuttx.apache.org/): tiny-edge's NuttX agent with every thin-edge.io feature, set up over USB with - `tedge-onboard` like `tedge-onboard` (on a DevKitC, the connector labelled + `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. @@ -433,8 +433,17 @@ into a computer with a USB data cable and run [`tedge-onboard`](https://github.com/thin-edge/tiny-edge/tree/main/tools/onboard) there. It finds the device, gives it the computer's Wi-Fi network (the one the device can see), registers it in Cumulocity through your go-c8y-cli -session, and waits until it is connected. Download it from the -[tiny-edge releases](https://github.com/thin-edge/tiny-edge/releases). +session, and waits until it is connected. Install it as a go-c8y-cli +extension and run it as `c8y tinyedge onboard`: + +```sh +c8y extensions install thin-edge/tiny-edge +c8y tinyedge onboard +``` + +or download it from the +[tiny-edge releases](https://github.com/thin-edge/tiny-edge/releases) and run +`./tedge-onboard`. A `tedge-*` device with no Wi-Fi network waits for the tool: its status LED shows the provisioning pattern (two short blinks, then a pause), and the log diff --git a/apps/tedge-agent-idf/main/idf_component.yml b/apps/tedge-agent-idf/main/idf_component.yml index 505f64f..3388db8 100644 --- a/apps/tedge-agent-idf/main/idf_component.yml +++ b/apps/tedge-agent-idf/main/idf_component.yml @@ -7,4 +7,4 @@ dependencies: tiny_edge: git: https://github.com/thin-edge/tiny-edge.git path: ports/freertos/esp-idf/tiny_edge - version: v0.7.0 + version: v0.8.0 diff --git a/scripts/release/notes.py b/scripts/release/notes.py index fa901c0..37d1815 100755 --- a/scripts/release/notes.py +++ b/scripts/release/notes.py @@ -81,7 +81,9 @@ def notes(manifest, metas, tag, repo): "The ESP-IDF (`tedge-onboard`) and NuttX (`nuttx`) agent images are " "set up over USB instead: run " "[tedge-onboard](https://github.com/thin-edge/tiny-edge/tree/main/tools/onboard) " - "on the computer the board is plugged into. It gives the device the " + "(or `c8y tinyedge onboard`, after `c8y extensions install " + "thin-edge/tiny-edge`) on the computer the board is plugged into. " + "It gives the device the " "computer's Wi-Fi network, registers it in your tenant, and passes it " "the tenant and a one-time password.", ""] diff --git a/scripts/release/package_idf.py b/scripts/release/package_idf.py index 511a96a..ae254c2 100644 --- a/scripts/release/package_idf.py +++ b/scripts/release/package_idf.py @@ -73,10 +73,16 @@ esptool --chip {chip} --before {before} write-flash {app_off} app.bin -Then set it up over USB: run tedge-onboard on the computer the board is -plugged into (https://github.com/thin-edge/tiny-edge/tree/main/tools/onboard). -It gives the device the computer's Wi-Fi network, registers it in your -Cumulocity tenant, and passes it the tenant and a one-time password. +Then set it up over USB, with the board plugged into a computer. On that +computer, install tedge-onboard as a go-c8y-cli extension and run it: + + c8y extensions install thin-edge/tiny-edge + c8y tinyedge onboard + +or download it from https://github.com/thin-edge/tiny-edge/releases and run +./tedge-onboard. It gives the device the computer's Wi-Fi network, registers +it in your Cumulocity tenant, and passes it the tenant and a one-time +password. {signing} """ diff --git a/scripts/release/package_nuttx.py b/scripts/release/package_nuttx.py index bf11d37..ba17707 100644 --- a/scripts/release/package_nuttx.py +++ b/scripts/release/package_nuttx.py @@ -76,11 +76,17 @@ esptool --chip {chip} --before {before} write-flash {app_off} app.signed.bin -Then set it up over USB: run tedge-onboard on the computer the board is -plugged into (https://github.com/thin-edge/tiny-edge/tree/main/tools/onboard), -connected to the board's USB port (on a DevKitC, the connector labelled USB). -It gives the device the computer's Wi-Fi network, registers it in your -Cumulocity tenant, and passes it the tenant and a one-time password. +Then set it up over USB, with the board's USB port (on a DevKitC, the +connector labelled USB) plugged into a computer. On that computer, install +tedge-onboard as a go-c8y-cli extension and run it: + + c8y extensions install thin-edge/tiny-edge + c8y tinyedge onboard + +or download it from https://github.com/thin-edge/tiny-edge/releases and run +./tedge-onboard. It gives the device the computer's Wi-Fi network, registers +it in your Cumulocity tenant, and passes it the tenant and a one-time +password. Updates from Cumulocity install {stem}.app.bin, which MCUboot boots once on trial: the agent confirms it once it has connected, or MCUboot goes back to diff --git a/west.yml b/west.yml index 0085a09..e1c3832 100644 --- a/west.yml +++ b/west.yml @@ -51,7 +51,7 @@ manifest: # CONFIG_TEDGE=y. Pin a release tag; move the pin to pick up a new one. - name: tiny-edge remote: thin-edge - revision: v0.7.0 + revision: v0.8.0 path: modules/lib/tiny-edge self: