Toilville/oplsdt
Watch
5
0
Fork
You've already forked oplsdt
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

docs: Move boot chain, partitions, MCU firmware, recovery and .swu install #14

Merged
peterswimm merged 1 commit from docs/move-boot-chain-and-swu into main 2026-10-05 01:01:47 +00:00
Conversation 0 Commits 1 Files changed 1 +157 -1
peterswimm commented 2026-10-05 01:01:36 +00:00
Owner
Copy link

Scope

Docs only: extends docs/rnbo-move-architecture.md with findings from reading Ableton's recovery image (Move-Image-2.1.1.img) and the RNBO Takeover package (rnbo-move-1.4.5-alpha.0.swu) offline. Nothing else is in this PR.

New sections:

  • Boot chain: pre-boot menu, Pi firmware, U-Boot 2022.01, A/B failover via bootcount, second-stage script, kernel
  • Partition layout (p1–p4) and how swupdate writes the inactive slot
  • Microcontrollers and firmware (XMOS, PMC, MHC, imagery), with the imagery bitmap format
  • Recovery via rpiboot, summarised from Ableton's PDF
  • How the Takeover .swu installs, and why third parties can't ship one (signature verified against /etc/swupdate/move-dev_publickey.pem)
  • Adding native apps through control-startup.json apps, and its catches
  • Relationship to Cycling74's pi-gen RNBO branches
  • How to repeat the teardown, plus new on-device diagnostics

Edits to existing text: the hardware intro now says CM4 and "several MCUs"; the approaches table gets a one-line pointer to the startup-app route.

Testing

Docs only, no behavior tests. Every new claim comes from files I read out of the image or the package. The one inference (Recovery holds nRPIBOOT low) is marked as unverified. The new diagnostics commands have not been run on a unit yet.

Impact Statement

  • Existing features: No expected impact
  • Public APIs / contracts: No expected impact
  • Schemas: No expected impact
  • Data / artifacts: No expected impact
  • Integrations: No expected impact
  • Mappings: No expected impact
  • Backward compatibility: No expected impact

Docs

This PR is the docs change.

<!-- BEGIN ORG-POLICY (managed by .spel/bin/forge-policy-sync.sh — do not hand-edit; source: core.contributor_review_policy, policy_key=org_contributor_review) --> ## Scope Docs only: extends `docs/rnbo-move-architecture.md` with findings from reading Ableton's recovery image (`Move-Image-2.1.1.img`) and the RNBO Takeover package (`rnbo-move-1.4.5-alpha.0.swu`) offline. Nothing else is in this PR. New sections: - Boot chain: pre-boot menu, Pi firmware, U-Boot 2022.01, A/B failover via `bootcount`, second-stage script, kernel - Partition layout (p1–p4) and how `swupdate` writes the inactive slot - Microcontrollers and firmware (XMOS, PMC, MHC, imagery), with the imagery bitmap format - Recovery via rpiboot, summarised from Ableton's PDF - How the Takeover `.swu` installs, and why third parties can't ship one (signature verified against `/etc/swupdate/move-dev_publickey.pem`) - Adding native apps through `control-startup.json` `apps`, and its catches - Relationship to Cycling74's `pi-gen` RNBO branches - How to repeat the teardown, plus new on-device diagnostics Edits to existing text: the hardware intro now says CM4 and "several MCUs"; the approaches table gets a one-line pointer to the startup-app route. ## Testing Docs only, no behavior tests. Every new claim comes from files I read out of the image or the package. The one inference (Recovery holds `nRPIBOOT` low) is marked as unverified. The new diagnostics commands have not been run on a unit yet. ## Impact Statement - Existing features: No expected impact - Public APIs / contracts: No expected impact - Schemas: No expected impact - Data / artifacts: No expected impact - Integrations: No expected impact - Mappings: No expected impact - Backward compatibility: No expected impact ## Docs This PR is the docs change. <!-- END ORG-POLICY -->
docs: Move boot chain, partitions, MCU firmware, recovery and .swu install
All checks were successful
PR policy check / policy-gate (pull_request) Successful in 0s
Details
ci / codebox (pull_request) Successful in 7s
Details
ci / max-lint (pull_request) Successful in 22s
Details
ci / compiler (pull_request) Successful in 28s
Details
1ca25115a2 
Adds findings from an offline teardown of Move-Image-2.1.1.img and
rnbo-move-1.4.5-alpha.0.swu: U-Boot A/B failover, partition layout,
XMOS/PMC/MHC/imagery firmware, rpiboot recovery, how the Takeover .swu
installs and why third parties can't sign one, and adding native apps
through control-startup.json.

Co-Authored-By: Claude <noreply@anthropic.com>
peterswimm deleted branch docs/move-boot-chain-and-swu 2026-10-05 01:01:47 +00:00
Sign in to join this conversation.
Reviewers
No reviewers
Labels
Clear labels
  
bug
Something is not working

  
duplicate
This issue or pull request already exists

  
enhancement
New feature

  
help wanted
Need some help

  
invalid
Something is wrong

  
question
More information is needed

  
wontfix
This won't be fixed

No labels
bug
duplicate
enhancement
help wanted
invalid
question
wontfix
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
1 participant
Notifications
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
Toilville/oplsdt!14
No description provided.