Firmware Updates #53

Merged

rob merged 241 commits from feat/firmware-updates into main 2026-09-21 05:53:39 +00:00

Conversation 0 Commits 241 Files changed 97 +12616 -2348

rob commented 2026-09-19 07:30:30 +00:00

Owner

Copy link

No description provided.

rob added 5 commits 2026-09-19 07:30:30 +00:00

Commit the Raspberry Pi setup notes as drafted ad6dd5098b

Document the host network prerequisites for updates d1d39da365

Take the review: say what the check should show, and cut it back 1d32cd160d

Narrow the check to unmanaged, and fix two nicks a8ac5d2610

Merge pull request 'Document the host network prerequisites for updates' (#50) from docs/update-host-prereqs into feat/firmware-updates 150e413208

Claude added 3 commits 2026-09-19 07:38:43 +00:00

Add the updater service beside Home Assistant ... 44b6fc2e49

It starts, logs and waits; the radio, the cache and the OTA conversation
land in CCS-UHA-2 onwards. No privileged flag and no capability: the
privileged work is NetworkManager's, over D-Bus.

Take the review: pin the token line, and stop overclaiming 0815f0202c

Merge pull request 'Add the updater service beside Home Assistant' (#51) from feat/updater-service into feat/firmware-updates 1c823e8d5c

Claude added 8 commits 2026-09-19 07:54:32 +00:00

Carry the update server in SYS_WIFI_CONTROL action 3 e61738049c

Add the BULK session credential set, content type 2 c14fa808b0

Address BULK_END to the sender: the receiver sends it d08569f59e

Record the update session as a frame bench example f66d3c7d6e

Decide a conditional field on the number, not the name 321847a58a

Read an empty choice box as no choice, not as nought ce01cdcdae

Narrow a bench field to a choice before reading its values 3f61406325

Merge pull request 'Bring the protocol library and frame_bench up to the merged spec' (#52) from feat/spec-pull-model-update into feat/firmware-updates f00711385e

Claude added 5 commits 2026-09-19 08:11:31 +00:00

Cache the firmware repository's released images on disk 4e5f1d3172

Take the review: keep the poll alive, and pin the token to one host 5656cc25d8

Keep the token off a plain-HTTP redirect on the same host 02676cf9cf

Drop an import nothing uses any more 4a340baeba

Merge pull request 'Cache the firmware repository's released images on disk' (#55) from feat/firmware-cache into feat/firmware-updates cf140c4546

Claude added 7 commits 2026-09-19 08:25:33 +00:00

Raise the update hotspot, and always put the network back d224f60bcb

Take the review: restore on every path, and unblock the radio 369dcf8125

Take the review: lock the restore, and note the uplink on disk c45dc24412

Take the review: owe the uplink sooner, and keep the note 1e56a7f34d

Keep the service test off the real uplink note e752d50c6d

Merge remote-tracking branch 'origin/feat/firmware-updates' into feat/networkmanager-hotspot ... 365e39525e

# Conflicts:
#	compose.yaml
#	updater/service.py

Merge pull request 'Raise the update hotspot, and always put the network back' (#54) from feat/networkmanager-hotspot into feat/firmware-updates c3ebfceaf3

Claude added 6 commits 2026-09-19 08:49:19 +00:00

Serve the manifest and cached images to the nodes 00b65ba421

Take the review: stop cleanly, and log a request that died da1c5ca2ad

Log the stack with a request that died, not just its type 4b20336cef

Merge feat/firmware-updates into feat/node-file-server f1b880923e

Cover the file server and the radio sharing one way out 8dec99e0ea

Merge pull request 'Serve the manifest and cached images to the nodes' (#56) from feat/node-file-server into feat/firmware-updates c2ce639a0c

Claude added 6 commits 2026-09-19 09:01:55 +00:00

Answer a loopback control API for the integration to drive a94b838904

Merge remote-tracking branch 'origin/feat/firmware-updates' into feat/updater-control-api ... 629f32c3ad

# Conflicts:
#	updater/service.py

Take the review: one check at a time, and steady the connection ... 190520ee70

A check now holds a lock the poll shares, and reports whether it reached the
registry. An update request carries a `reason` token beside its prose.

Take the review: name what a check could not fetch ... 8b33bb6725

A check that reached the registry and downloaded nothing now says which
images it could not fetch, rather than reading as up to date.

Merge remote-tracking branch 'origin/feat/firmware-updates' into feat/updater-control-api ... 1630ca8a58

# Conflicts:
#	README.md
#	tests/conftest.py
#	tests/fakes.py
#	updater/config.py
#	updater/service.py

Merge pull request 'Answer a loopback control API for the integration to drive' (#57) from feat/updater-control-api into feat/firmware-updates 39b97b791f

Claude added 9 commits 2026-09-19 09:18:49 +00:00

Keep the wire format importable without python-can 2b597f7414

Give the updater its own SocketCAN transport c1215a51e1

Run an update session with one node over CAN 3ee88d0566

Take an announce as a return only after the node has flashed a72fd4ebd3

Hand the network back when the hotspot will not rise 7b23995966

Refuse a second session while one is running d1f15b3946

Clear the running session even when the restore is cancelled 56f23f421a

Merge remote-tracking branch 'origin/feat/firmware-updates' into feat/ota-can-session ... 03861caba4

# Conflicts:
#	updater/config.py

Merge pull request 'Drive the OTA conversation over CAN from the updater' (#58) from feat/ota-can-session into feat/firmware-updates e9622c18ca

Claude added 8 commits 2026-09-19 12:42:57 +00:00

Show each node's firmware, and what the updater has for it 3f5738d892

Take the review: end a transfer on the announce, and wait for a label c105ef3759

Take the review: end a transfer on a new image, not on any announce abd2964363

Take the review: end a transfer when a rolled-back node goes quiet fa2417f61f

Merge feat/firmware-updates into feat/update-entity c9a6568264

Take the review: say in the README what the firmware entity shows 069f3f8d5d

Take the review: one device per node, in the README's words too e19096f3a6

Merge pull request 'Show each node's firmware, and what the updater has for it' (#59) from feat/update-entity into feat/firmware-updates 2121ff8d30

Claude added 5 commits 2026-09-19 13:13:23 +00:00

Ask the updater to check for firmware from a button fd668eaa26

Take the review: name what a check missed, and drop the category 1986674a2a

Take the review: prove the check's timeout reaches the request 4bfe52aa2d

Take the review: pin the absent category and tidy two comments 718f0a7d82

Merge pull request 'Ask the updater to check for firmware from a button' (#60) from feat/check-for-updates-button into feat/firmware-updates 11b3fa738a

Claude added 3 commits 2026-09-19 19:54:56 +00:00

Serve the manifest at the path and shape section 11.1 fixes 478b341d15

Take the review: prove the length, fold the key tests 78f838deab

Merge pull request 'Serve the manifest at the path and shape section 11.1 fixes' (#61) from fix/manifest-for-the-spec into feat/firmware-updates e06dbc7aa6

Claude added 6 commits 2026-09-19 20:09:27 +00:00

Stop a firmware download when the service is stopping 2f6494bf71

Take the review: a stop is not a fetch that failed 0f5f19af60

Take the review: drop a clear the service never reaches twice 329c1f8e4d

Take the review: hand the stopped fetch its chunks by hand 2de8d32020

Merge remote-tracking branch 'origin/feat/firmware-updates' into fix/stop-a-download-on-shutdown 9c9fc54853

Merge pull request 'Stop a firmware download when the service is stopping' (#63) from fix/stop-a-download-on-shutdown into feat/firmware-updates adcfebc210

Claude added 10 commits 2026-09-19 20:35:21 +00:00

Take the refreshed vectors and the names and lengths they pin f08f616023

Stop padding the session credentials to whole frames 54604466c4

Name BULK_END result 4 and SYS_WIFI_STATUS state 6 5d60f67512

Cap a session credential set at the 98 bytes a node takes 695582aa62

Take the review: pin the short frame on both sides and split the cap 404b4da10c

Merge feat/firmware-updates into feat/shared-bulk-vectors 15cbb2ef34

Refresh the vectors from the branch they were taken from 839085086f

Take the review: hold main to the firmware's main for vectors b516505012

Take the review: pin the CI variable to the step that uses it 76ad114ed6

Merge pull request 'Take the new shared vectors, and stop padding BULK transfers' (#62) from feat/shared-bulk-vectors into feat/firmware-updates 24c08e9755

Claude added 4 commits 2026-09-19 20:58:09 +00:00

Show a fetch the node says failed on its update entity 4b16754e9c

Take the review: clear a failure when another update is asked for a104c4b9c9

Take the review: a fresh request does not stop a transfer 1f9518d107

Merge pull request 'Show a fetch the node says failed on its update entity' (#64) from feat/failed-fetch-on-update-entity into feat/firmware-updates b6cdbeb0f8

Claude added 8 commits 2026-09-19 21:05:12 +00:00

End a session on the states section 11 makes terminal 4263270df2

Hold the update deadline to the node's own patience 90ae5453ac

Never hand a node the radio timeout that never fires 6b75d3c62b

Report a node that never brings its radio up as lost a0098e3766

Take the review: count the join the deadline starts before aa2d747c92

Take the review: tighten the tests the clamp made loose bf9d57068c

Merge feat/firmware-updates into feat/session-lifecycle f7fb0e9f8c

Merge pull request 'Follow the session lifecycle section 11 now fixes' (#65) from feat/session-lifecycle into feat/firmware-updates c266dc34f5

Claude added 4 commits 2026-09-19 21:25:07 +00:00

Judge a node's return by its build identifier 65dd9e8024

Pin the build as what a reflash shows on the entity e9ed2c929e

Take the review: one log line, one name, one version test a34a53142b

Merge pull request 'Tell a finished update by its build identifier' (#66) from feat/build-id-confirms-update into feat/firmware-updates 09942df285

Claude added 5 commits 2026-09-19 22:09:32 +00:00

Run an update session from the control API 416064c1a1

Let an install wait for the session and report a rollback 89e568ebc7

Take the review: a build of zero judges nothing, and shutdown lets go 701bbb2153

Take the review: pin the two guards the tests walked past 7fac9accc7

Merge pull request 'Wire the update session into the control API' (#67) from feat/node-link-runs-sessions into feat/firmware-updates 3665ca6ba6

Claude added 8 commits 2026-09-19 23:25:14 +00:00

Report which uplink case the Pi is in on the control API e44f8132f3

Show what an install costs the connection on the bridge a5156862aa

Take the review: a cost left unsaid is unknown, not free 80e6ec3243

Take the review: pin the two cases the tests walked past 8cbf7309d3

Take the review: ask before a node has ever announced 52b600f748

Take the review: setting up must not wait on the updater 4029a0e038

Take the review: pin the scheduling, and name what it mirrors f864e59da8

Merge pull request 'Surface which uplink case the Pi is in before an install' (#68) from feat/uplink-before-an-install into feat/firmware-updates 0b84e91f1b

Claude added 6 commits 2026-09-20 06:24:11 +00:00

Cut the vectors guard comments to their reason 0e0320d782

Cut the bench's conditional field comments to their reason 502c333db3

Let the frame length read itself, and cut its docstring eaeaa44464

Cut the bench test comments to their reason 97b00fdd56

Take the review: a cut that loses the reason is a cut too far 87dd2cceb7

Merge pull request 'Cut the frame bench and vectors guard comments to their reason' (#72) from docs/frame-bench-comments into feat/firmware-updates 0212445b71

Claude added 6 commits 2026-09-20 06:31:38 +00:00

Cut the updater's comments to the reasons they carry 77a4cc02e5

Cut the compose and image comments to one line each ce26c3b00e

Cut the updater tests' comments to what the names miss a22ade62a2

Take the review: keep the reasons the compression dropped 970c318b92

Merge remote-tracking branch 'origin/feat/firmware-updates' into docs/updater-comments 055a22a65a

Merge pull request 'Cut the updater's comments to the reasons they carry' (#70) from docs/updater-comments into feat/firmware-updates ab2864506a

Claude added 7 commits 2026-09-20 06:37:09 +00:00

Cut the updater's cache, file server and API comments back f66abd762d

Cut the updater cache, file server and API test comments back 67ba206789

Take the review: keep the stop's invariant, drop private restatement cce505681f

Take the review: the traversal warning belongs at the lookup 79081e035c

Merge feat/firmware-updates into docs/updater-cache-and-api-comments 8ab4fc5d7e

Merge feat/firmware-updates into docs/updater-cache-and-api-comments 3fb0fff2b2

Merge pull request 'Cut the updater's cache, file server and API comments back' (#69) from docs/updater-cache-and-api-comments into feat/firmware-updates 1c867a7aab

Claude added 7 commits 2026-09-20 06:43:45 +00:00

Cut the firmware update path's comments to what they carry 8f02896881

Cut the update tests' docstrings to what the names do not carry 829db7d3c2

Take the review: restore the reasons the trimming lost 5e617dd733

Take the review: name what the updater lacks, and cite in full 119f253f02

Take the review: keep the kiosk note, and stop a stale claim spreading 7783ec3a6a

Merge feat/firmware-updates into docs/integration-comments df602acb04

Merge pull request 'Cut the integration's update comments to what they carry' (#73) from docs/integration-comments into feat/firmware-updates 856454d8cc

Claude added 10 commits 2026-09-20 06:52:09 +00:00

Cut the session's comments back to what they have to say 454affa3c5

Cut the link and bus comments back, and name the build-of-zero rule 918cb58e37

Cut the updater test docstrings back to the reason each test exists 0fa0a969f4

Take the review: put back a citation and finish a sentence e3e2df3cd2

Take the review: a clamp is not a claim that both ends reach zero 8042ac2f2b

Take the review: the padding pads an integer, not a frame 570a8e9503

Merge feat/firmware-updates into docs/updater-session-comments d67c342e14

Merge feat/firmware-updates into docs/updater-session-comments 843a04860e

Merge feat/firmware-updates into docs/updater-session-comments 2b4b3cec92

Merge pull request 'Cut the updater session's comments back to what they have to say' (#71) from docs/updater-session-comments into feat/firmware-updates 1ff253b552

Claude added 3 commits 2026-09-20 07:06:07 +00:00

Cut the test fixtures' and fakes' comments to their reasons 238d603e5c

Take the review: fix a dropped verb, a wrong claim and two repeats 9e14307b12

Merge pull request 'Cut the test fixtures' and fakes' comments to their reasons' (#74) from docs/test-fixture-comments into feat/firmware-updates 83903bd9b8

Claude added 6 commits 2026-09-20 08:27:34 +00:00

Let Home Assistant name the updater's CAN interface a09d0b45c1

Tell the updater which interface the entry is on 2c959b9497

Say where the updater's CAN interface comes from 3e7b94cc74

Take the review: log the first answer, and agree on the interface 641633b7e9

Take the review: close the fake bus the way the real one closes 709f904ffa

Merge pull request 'Let Home Assistant name the updater's CAN interface' (#75) from fix/updater-can-interface into feat/firmware-updates b8ec7121e7

Claude added 3 commits 2026-09-20 09:20:05 +00:00

Serve firmware images at a path a node can accept 0189074499

Take the review: warn once, and say what a long path really breaks 7f884b44d4

Merge pull request 'Serve firmware images at a path a node can accept' (#76) from fix/short-firmware-image-paths into feat/firmware-updates a9d70dc490

Claude added 7 commits 2026-09-20 11:02:57 +00:00

Take the firmware repository endpoint from the environment 3d5a235dbc

Take the review: keep the token off a plain HTTP endpoint d92a5f0d5d

Name the concrete release source the type check knows 8acaf4fb92

Take the review: prove the token reaches a mirror ea2a1502a4

Take the review: read a hand-typed endpoint forgivingly e9e39286d4

Take the review: survive an endpoint with no host, and say its shape 223ce4033c

Merge pull request 'Take the firmware repository endpoint from the environment' (#77) from feat/firmware-repository-setting into feat/firmware-updates c411079fe0

Claude referenced this pull request 2026-09-20 12:25:31 +00:00

Decode the packed CalVer firmware version, and order on it #78

Claude added 5 commits 2026-09-20 12:53:18 +00:00

Take the vectors from the firmware's main again 4b56e2ddef

Decode the packed CalVer firmware version, and order on it 4bf7707e09

Take the review: honour the packing on the bridge's own announce 627a5e0732

Take the review: say what the padding test really guards 224e6d39c9

Merge pull request 'Decode the packed CalVer firmware version, and order on it' (#78) from feat/calver-firmware-version into feat/firmware-updates 8b854f2799

rob added 71 commits 2026-09-21 05:48:35 +00:00

Stop requiring a docstring on every name f265584a0a

Subscribe to a listener list in one place 83e2b465da

Call a listener list in one place f228c69754

Hold the entity availability plumbing in one base 4507f18192

Subscribe a redraw directly instead of wrapping it d2049785b0

Test an entity's own key once, then hand off to a hook 9ca9ac3f2c

Cache the shape an endpoint's description asks for c8ebea4b86

Read a kind and a semantic class the one way e1e0f3e1d1

Keep alarms under the endpoint that raised them a3cc031525

Sort the inventory's nodes when one moves, not on every read 46760200e3

Decode a frame's route once for every listener cb35f57299

Ask the store directly where nothing needs the coordinator 30b888b0f0

Inline four one-use wrappers and a hand-rolled round-up e45c5abe80

Cut the setup and discovery docstrings to their reasons 9036791e51

Cut the entity and reading docstrings to their reasons 0f32f9742a

Cut the bus module docstrings to their reasons 7fccf91540

Cut the platform modules' docstrings to their reasons cf11dfe306

Drop a comment that was wrong and one that was long c358af8f70

Drop two docstrings the brief marked for the cull 69d9ad9af9

Drop the protocol package's dead re-export layer 6faaf0f231

Import the catalogue's quantities by name 7433a03949

Fold the catalogue's three one-use helpers into their callers b71645ed69

Look a sentinel up rather than scanning for it 8866bb0281

Let int.from_bytes do the sign extension a1ac34c1f5

Inline two one-use wrappers in the firmware store 367b46a279

Take the shared subscribe, notify and route in the OTA store 808fe157d7

Cut the firmware and update docstrings to their reasons e598e6231f

Cut the catalogue and codec docstrings to their reasons 14d22d10ec

Cut the remaining protocol docstrings to their reasons dda1705618

Build the node manifest offers once per request 58e1ff43d1

Keep the newest image per node in one place f66e31c2bf

Cut the session constants to their spec cites 5fb91d914c

Serve both HTTP servers through one coroutine 37b69c4eb8

Cut the docstrings off the API's link and radio seams 03722d5826

Report a hotspot and a bus failure the same way bb47125833

Reach the control API by a cast, as the file server does 59e8d8cb60

Check the two credential lengths outright f872a528e5

Drop the updater's empty requirements file 3ce90dea67

Sift frames on the raw identifier before decoding 95557fcfc9

Cut the docstrings across the API, bus and config b44db1ed37

Cut the file server and firmware cache docstrings 2ecf1c074a

Cut the bus link and radio docstrings 565f352ddb

Cut the update session and service docstrings bc91222443

Declare the bench's fields positionally 03c53fa5e1

Render a bench field from its own dataclass fields 23360673fe

Stop rendering rules the browser never reads b043e2c4fc

Take a bench field's scale from the quantity table 8081d0ba8a

Default a message's priority to its class c6f8ce87b0

Fall back to a field's own default when none is typed 8eb067d8f3

Parse an address with the standard library fed5875d85

Work out the carried fields once per build 857d541331

Wait on the stop event itself between steps 236f60b7b7

Guess a static file's type from its name 99e7e4c557

Build the catalogue once 6aa95bb395

Cut the bench catalogue's docstrings 6d9fc2ca10

Cut the bench encoder's docstrings b70e8c7792

Cut the bench server and sequence docstrings 821810969f

Cut the release scripts' module docstrings c8f369c01a

Keep sentinel_at answering for every field shape 6ed11df976

Follow the endpoint key when an endpoint is redescribed 74d46b9892

Put back three reasons the trim should have kept 99c7e4788b

Drop two docstrings that said nothing new 692b20c032

Cite the section that actually raises a hold b042b9adbb

Still require a docstring on a module and a class ce33dbcde6

Explain a blank refusal rather than raise it bbe970220f

Make a bench field state its offset adc2c46d67

Name the manifest argument and the round-up 2c9729d131

Say what three comments meant to say bac9afe328

Merge feat/firmware-updates into refactor/trim-verbosity dfd0bbc9a9

Trim the prose the CalVer decode arrived with b21af58599

Merge pull request 'Trim verbosity across the codebase' (#79) from refactor/trim-verbosity into feat/firmware-updates ... 2d37c0cc60

Reviewed-on: #79

rob changed title from WIP: Firmware Updates to Firmware Updates 2026-09-21 05:49:06 +00:00

rob merged commit 02f124895d into main 2026-09-21 05:53:39 +00:00

rob deleted branch feat/firmware-updates 2026-09-21 05:53:39 +00:00

rob referenced this pull request from a commit 2026-09-21 05:53:40 +00:00

Merge pull request 'Firmware Updates' (#53) from feat/firmware-updates into main

Claude referenced this pull request 2026-09-21 06:04:04 +00:00

Catch CLAUDE.md up with the firmware-updates merge #80

Sign in to join this conversation.

Reviewers

No reviewers

Labels

Clear labels

No items

No labels

Milestone

Clear milestone

No items

No milestone

Projects

Clear projects

No items

No project

Assignees

Clear assignees

No assignees

2 participants

Notifications

Subscribe

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference

rob/CampervanHomeAssistant!53

No description provided.