Skip to content

feat: name every image <app>-<os>-<set>-<device> - #35

Merged
reubenmiller merged 3 commits into
mainfrom
feat/image-names-by-os
Nov 19, 2026
Merged

reubenmiller merged 3 commits into
mainfrom
feat/image-names-by-os

Conversation

@reubenmiller

Copy link
Copy Markdown
Contributor

Builds on #34 (the S3 NuttX agent). Its base switches to main once #34 merges.

Release images only sometimes said which operating system they run. Zephyr images never did (modbus-server-tedge-full-…), the ESP-IDF image did through its app name (tedge-agent-idf-tedge-onboard-…), and the NuttX image through its variant (tedge-agent-nuttx-…). Now every image is <app>-<os>-<set>-<device>:

Zephyr ESP-IDF NuttX
device agent, C6 tedge-agent-zephyr-full-esp32c6-devkitc tedge-agent-idf-full-esp32c6-devkitc tedge-agent-nuttx-full-esp32c6-devkitc
  • What the name covers: the release files, the firmware name the device reports, and its firmware entry in Cumulocity.
  • <os>: zephyr, idf (ESP-IDF, with FreeRTOS) or nuttx.
  • <set>: standalone, full or ota, which drops today's tedge- prefix.
  • Length: the longest names (the C6 and S3 DevKitC zephyr-standalone images) are exactly 47 characters, the most a device can store.

Changes

  • release/devices.yml:
    • The variants are renamed zephyr-standalone, zephyr-full, zephyr-ota, idf-full and nuttx-full, each with a new set field.
    • A new apps: section names apps/tedge-agent-idf tedge-agent.
  • matrix.py:
    • Rejects a variant whose name isn't <os>-<set> for its framework, and two builds with the same firmware name.
    • CI jobs are named <app>-<os>-<device>.
    • New tests: 53 pass.
  • Packaging and release notes: they use the app's name. The notes' table has separate OS and Set columns.
  • release/size-baseline.json: re-keyed. The sizes are unchanged.
  • README:
    • The introduction, which still described "Phase 1 OPC-UA server firmware (Zephyr RTOS)", now covers the protocol servers, the device agent and the three operating systems.
    • Status and Targets are condensed into a Boards section.
    • The device table is regenerated, the naming scheme is explained, and examples use the new names.
    • New section: "Moving a device to the new names".
  • DEVICES.md: a note maps the old names, which the past measurements keep, to the new ones.
  • OpenSpec change consistent-image-names, which modifies the firmware-release spec. It is valid.

Devices already in Cumulocity
Each device needs one update from the firmware entry with the new name. The device installs any firmware name, and from then on reports the new one. The old firmware entries stay until someone deletes them.

The next release is 0.17.0. The commit is a plain feat, because a feat! would make release-please choose 1.0.0.

🤖 Generated with Claude Code

reubenmiller and others added 2 commits November 19, 2026 09:17
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 <noreply@anthropic.com>
Every release image, the firmware name it reports and its firmware entry
in Cumulocity now say the operating system: zephyr, idf (ESP-IDF) or
nuttx. The variants are zephyr-standalone, zephyr-full, zephyr-ota,
idf-full and nuttx-full, and the ESP-IDF agent is named tedge-agent, so
the same app's images sit side by side:

  tedge-agent-zephyr-full-esp32c6-devkitc
  tedge-agent-idf-full-esp32c6-devkitc
  tedge-agent-nuttx-full-esp32c6-devkitc

The manifest rejects a variant whose name does not match its framework
and set, and two builds with the same name. The README's introduction,
which still described the first OPC-UA phase, now covers the protocol
servers, the device agent and the three operating systems.

Devices running an image with an old name update once from the entry
with the new name; the README's "Moving a device to the new names" has
the table of old and new names.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@reubenmiller
reubenmiller changed the base branch from feat/nuttx-agent-s3 to main November 18, 2026 23:46
# Conflicts:
#	README.md
#	release/devices.yml
@reubenmiller
reubenmiller merged commit 5962e0b into main Nov 19, 2026
25 checks passed
@reubenmiller
reubenmiller deleted the feat/image-names-by-os branch November 19, 2026 00:24
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant