Skip to content

Add the Pico flasher id to the hand-off protocol #2859

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
bdraco merged 1 commit into from
Sep 27, 2026
Merged

Add the Pico flasher id to the hand-off protocol #2859

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 7 additions & 6 deletions flasher/src/protocol.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -69,17 +69,18 @@ export interface FirmwareMessage {
// ready-frame gate is the only guard on the receivers already deployed.
// A receiver refuses a frame whose flasher it did not list, and the id may
// be one a newer opener knows and the receiver does not.
// For 'rtl-ambz2' the parts are the LibreTiny UF2 as one part at address
// 0, which the receiver parses into flash runs itself.
// For 'rtl-ambz2' and 'rp2-picoboot' the parts are the UF2 as one part at
// address 0, which the receiver parses into flash runs itself.
flasher?: HandoffFlasher;
parts: FlashPart[];
}

// The flasher a hand-off is for, by an id both apps share: 'esp' is esptool
// (ESP32 / ESP8266), 'rtl-ambz2' the RTL8720C ROM downloader. Named after the
// flasher, not the platform: rtl87xx covers the RTL8710B too, whose ROM speaks
// another protocol and gets its own id when it lands.
export type HandoffFlasher = "esp" | "rtl-ambz2";
// (ESP32 / ESP8266), 'rtl-ambz2' the RTL8720C ROM downloader, 'rp2-picoboot'
// PICOBOOT for the RP2040. Named after the flasher, not the platform: rtl87xx
// covers the RTL8710B too, whose ROM speaks another protocol and gets its own
// id when it lands.
export type HandoffFlasher = "esp" | "rtl-ambz2" | "rp2-picoboot";

export type FlashState =
| "connecting"
Expand Down
Loading