webserial-flasher 1.0.0

package/dist/protocol/picoboot/constants.js

@@ -0,0 +1,80 @@
+// PICOBOOT USB protocol constants for RP2040 / RP2350
+// Reference: https://github.com/raspberrypi/pico-sdk/blob/master/src/common/boot_picoboot_headers/include/boot/picoboot.h
+//            https://github.com/raspberrypi/picotool/blob/master/picoboot_connection/picoboot_connection.h
+// ── USB device identifiers ──────────────────────────────────────────────────
+/** Raspberry Pi USB Vendor ID */
+export const PICOBOOT_VID = 0x2E8A;
+/** RP2040 USBBOOT Product ID (BOOTSEL mode) */
+export const PICOBOOT_PID_RP2040 = 0x0003;
+/** RP2350 USBBOOT Product ID (BOOTSEL mode) */
+export const PICOBOOT_PID_RP2350 = 0x000F;
+// ── USB interface / endpoint layout ────────────────────────────────────────
+// Interface 0 = MSD (Mass Storage, virtual FAT drive for UF2 drag-and-drop)
+// Interface 1 = PICOBOOT (vendor class 0xFF, binary protocol)
+/** PICOBOOT interface index (interface 1) */
+export const PICOBOOT_INTERFACE = 1;
+// ── PICOBOOT command frame ──────────────────────────────────────────────────
+/** Magic number at offset 0 of every PICOBOOT command packet (little-endian) */
+export const PICOBOOT_MAGIC = 0x431FD10B;
+/** Size of a PICOBOOT command packet in bytes */
+export const PICOBOOT_CMD_SIZE = 32;
+/** Size of the PICOBOOT status response in bytes */
+export const PICOBOOT_STATUS_SIZE = 16;
+// ── PICOBOOT command IDs ────────────────────────────────────────────────────
+// Bit 7 = 1 means data flows IN (device → host). Bit 7 = 0 means OUT.
+export const PicobootCmd = {
+    EXCLUSIVE_ACCESS: 0x01, // OUT, args: 1-byte exclusive flag
+    REBOOT: 0x02, // OUT, args: [PC u32][SP u32][delayMs u32]
+    FLASH_ERASE: 0x03, // OUT, args: [addr u32][size u32], no data phase
+    READ: 0x84, // IN  (bit7 set), args: [addr u32][size u32]
+    WRITE: 0x05, // OUT, args: [addr u32][size u32]
+    EXIT_XIP: 0x06, // OUT, no args
+    ENTER_CMD_XIP: 0x07, // OUT, no args
+    EXEC: 0x08, // OUT, args: [addr u32]
+    VECTORIZE_FLASH: 0x09, // OUT, args: [addr u32]
+};
+// ── PICOBOOT status codes ───────────────────────────────────────────────────
+export const PicobootStatus = {
+    OK: 0,
+    UNKNOWN_CMD: 1,
+    BAD_CHECKSUM: 2,
+    NOT_PERMITTED: 3,
+    INVALID_ADDRESS: 4,
+    BAD_ALIGNMENT: 5,
+    INTERLEAVED: 6,
+    REBOOTING: 7,
+    UNKNOWN: 8,
+    INVALID_STATE: 9,
+};
+// ── Flash geometry ──────────────────────────────────────────────────────────
+/** Minimum erase granularity — address and size must be 4KB-aligned */
+export const FLASH_SECTOR_SIZE = 4096;
+/** Flash page write size — address and size must be 256-byte-aligned */
+export const FLASH_PAGE_SIZE = 256;
+/** XIP base address in CPU address space (flash starts here for the CPU) */
+export const RP2040_FLASH_BASE = 0x10000000;
+/**
+ * PICOBOOT uses offset-0 addressing for flash.
+ * To write to XIP address 0x10001000, pass addr = 0x00001000.
+ * Use this mask to convert: picobootAddr = xipAddr & ~RP2040_FLASH_BASE
+ */
+export const RP2040_FLASH_ADDR_MASK = 0x0FFFFFFF;
+// ── UF2 file format ─────────────────────────────────────────────────────────
+// Reference: https://github.com/microsoft/uf2
+export const UF2_MAGIC_START0 = 0x0A324655; // "UF2\n" bytes
+export const UF2_MAGIC_START1 = 0x9E5D5157;
+export const UF2_MAGIC_END = 0x0AB16F30;
+/** UF2 flag: familyID field is valid (must be set for RP2040/RP2350) */
+export const UF2_FLAG_FAMILY_ID = 0x00002000;
+/** UF2 flag: block should not be flashed (skip when flashing) */
+export const UF2_FLAG_NOT_MAIN = 0x00000001;
+/** Total size of one UF2 block (bytes) */
+export const UF2_BLOCK_SIZE = 512;
+/** Usable payload bytes per UF2 block */
+export const UF2_PAYLOAD_SIZE = 256;
+// ── UF2 family IDs ──────────────────────────────────────────────────────────
+export const UF2_FAMILY_RP2040 = 0xE48BFF56;
+export const UF2_FAMILY_RP2350_ARM = 0xE48BFF59; // Secure ARM
+export const UF2_FAMILY_RP2350_RISCV = 0xE48BFF5A;
+export const UF2_FAMILY_RP2350_ARM_NS = 0xE48BFF5B; // Non-secure ARM
+//# sourceMappingURL=constants.js.map

package/dist/protocol/picoboot/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/protocol/picoboot/constants.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,0HAA0H;AAC1H,2GAA2G;AAE3G,+EAA+E;AAE/E,iCAAiC;AACjC,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAAC;AACnC,+CAA+C;AAC/C,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAC;AAC1C,+CAA+C;AAC/C,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAC;AAE1C,8EAA8E;AAC9E,4EAA4E;AAC5E,8DAA8D;AAE9D,6CAA6C;AAC7C,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC;AAEpC,+EAA+E;AAE/E,gFAAgF;AAChF,MAAM,CAAC,MAAM,cAAc,GAAG,UAAU,CAAC;AAEzC,iDAAiD;AACjD,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAEpC,oDAAoD;AACpD,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,CAAC;AAEvC,+EAA+E;AAC/E,sEAAsE;AAEtE,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,gBAAgB,EAAE,IAAI,EAAG,mCAAmC;IAC5D,MAAM,EAAY,IAAI,EAAG,2CAA2C;IACpE,WAAW,EAAO,IAAI,EAAG,iDAAiD;IAC1E,IAAI,EAAc,IAAI,EAAG,6CAA6C;IACtE,KAAK,EAAa,IAAI,EAAG,kCAAkC;IAC3D,QAAQ,EAAU,IAAI,EAAG,eAAe;IACxC,aAAa,EAAK,IAAI,EAAG,eAAe;IACxC,IAAI,EAAc,IAAI,EAAG,wBAAwB;IACjD,eAAe,EAAG,IAAI,EAAG,wBAAwB;CACzC,CAAC;AAEX,+EAA+E;AAE/E,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,EAAE,EAAe,CAAC;IAClB,WAAW,EAAM,CAAC;IAClB,YAAY,EAAK,CAAC;IAClB,aAAa,EAAI,CAAC;IAClB,eAAe,EAAE,CAAC;IAClB,aAAa,EAAI,CAAC;IAClB,WAAW,EAAM,CAAC;IAClB,SAAS,EAAQ,CAAC;IAClB,OAAO,EAAU,CAAC;IAClB,aAAa,EAAI,CAAC;CACV,CAAC;AAEX,+EAA+E;AAE/E,uEAAuE;AACvE,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,CAAC;AAEtC,wEAAwE;AACxE,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,CAAC;AAEnC,4EAA4E;AAC5E,MAAM,CAAC,MAAM,iBAAiB,GAAG,UAAU,CAAC;AAE5C;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,UAAU,CAAC;AAEjD,+EAA+E;AAC/E,8CAA8C;AAE9C,MAAM,CAAC,MAAM,gBAAgB,GAAK,UAAU,CAAC,CAAE,gBAAgB;AAC/D,MAAM,CAAC,MAAM,gBAAgB,GAAK,UAAU,CAAC;AAC7C,MAAM,CAAC,MAAM,aAAa,GAAQ,UAAU,CAAC;AAE7C,wEAAwE;AACxE,MAAM,CAAC,MAAM,kBAAkB,GAAG,UAAU,CAAC;AAC7C,iEAAiE;AACjE,MAAM,CAAC,MAAM,iBAAiB,GAAI,UAAU,CAAC;AAE7C,0CAA0C;AAC1C,MAAM,CAAC,MAAM,cAAc,GAAO,GAAG,CAAC;AACtC,yCAAyC;AACzC,MAAM,CAAC,MAAM,gBAAgB,GAAK,GAAG,CAAC;AAEtC,+EAA+E;AAE/E,MAAM,CAAC,MAAM,iBAAiB,GAAS,UAAU,CAAC;AAClD,MAAM,CAAC,MAAM,qBAAqB,GAAK,UAAU,CAAC,CAAE,aAAa;AACjE,MAAM,CAAC,MAAM,uBAAuB,GAAG,UAAU,CAAC;AAClD,MAAM,CAAC,MAAM,wBAAwB,GAAG,UAAU,CAAC,CAAC,iBAAiB"}

package/dist/protocol/picoboot/programmer.d.ts

@@ -0,0 +1,73 @@
+import type { IPicobootTransport } from '../../transport/IPicobootTransport.js';
+import type { BootloadProgressCallback, STK500Options } from '../../core/types.js';
+export declare class PicoBoot {
+    private readonly transport;
+    private readonly log;
+    private token;
+    constructor(transport: IPicobootTransport, opts?: STK500Options);
+    /**
+     * Flash firmware to the RP2040 / RP2350.
+     *
+     * Accepts either a UF2 file (detected by magic bytes) or a raw binary.
+     * Raw binaries are assumed to start at XIP base 0x10000000 unless
+     * `opts.baseAddr` is specified.
+     *
+     * @param data      UF2 file or raw binary as Uint8Array
+     * @param progress  Optional progress callback (status, 0–100)
+     * @param opts      Optional: baseAddr (for raw binary), verify (default: true)
+     */
+    bootload(data: Uint8Array, progress?: BootloadProgressCallback, opts?: {
+        baseAddr?: number;
+        verify?: boolean;
+    }): Promise<void>;
+    /** EXCLUSIVE_ACCESS — take or release exclusive control (disables/enables MSD) */
+    exclusiveAccess(exclusive: boolean): Promise<void>;
+    /** EXIT_XIP — exit execute-in-place mode (required before erase or write) */
+    exitXip(): Promise<void>;
+    /** ENTER_CMD_XIP — re-enter XIP mode (optional, called after programming) */
+    enterCmdXip(): Promise<void>;
+    /**
+     * FLASH_ERASE — erase flash sectors.
+     * @param addr  Flash offset (0-based, 4KB-aligned)
+     * @param size  Number of bytes to erase (must be a multiple of 4096)
+     */
+    flashErase(addr: number, size: number): Promise<void>;
+    /**
+     * WRITE — write a flash page (256 bytes).
+     * @param addr  Flash offset (0-based, 256-byte-aligned)
+     * @param data  Exactly 256 bytes of payload
+     */
+    flashWrite(addr: number, data: Uint8Array): Promise<void>;
+    /**
+     * READ — read bytes from flash.
+     * @param addr  Flash offset (0-based)
+     * @param size  Number of bytes to read
+     */
+    flashRead(addr: number, size: number): Promise<Uint8Array>;
+    /**
+     * REBOOT — reboot the device.
+     * @param pc        Program counter (0 = boot from flash)
+     * @param sp        Stack pointer (0 = use default)
+     * @param delayMs   Milliseconds before reboot (allows USB ACK to complete)
+     */
+    reboot(pc?: number, sp?: number, delayMs?: number): Promise<void>;
+    /**
+     * Convert a raw binary to UF2 format.
+     * Convenience wrapper around the standalone `binaryToUf2` utility.
+     */
+    binaryToUf2(binary: Uint8Array, baseAddr?: number, familyId?: number): Uint8Array;
+    /**
+     * Execute a PICOBOOT command and (optionally) transfer data.
+     *
+     * Flow for OUT commands (no data):   CMD→ | STATUS←
+     * Flow for OUT commands (write):     CMD→ | DATA→ | STATUS←
+     * Flow for IN commands (read):       CMD→ | DATA← | STATUS←
+     *
+     * @returns Received data for IN commands, or throws on error status
+     */
+    private execCmd;
+    /** Build a 32-byte PICOBOOT command packet */
+    private buildCmd;
+    private statusName;
+}
+//# sourceMappingURL=programmer.d.ts.map

package/dist/protocol/picoboot/programmer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"programmer.d.ts","sourceRoot":"","sources":["../../../src/protocol/picoboot/programmer.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAChF,OAAO,KAAK,EAAE,wBAAwB,EAAE,aAAa,EAAU,MAAM,qBAAqB,CAAC;AAY3F,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;IAC/C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,KAAK,CAAK;gBAEN,SAAS,EAAE,kBAAkB,EAAE,IAAI,CAAC,EAAE,aAAa;IAa/D;;;;;;;;;;OAUG;IACG,QAAQ,CACZ,IAAI,EAAM,UAAU,EACpB,QAAQ,CAAC,EAAE,wBAAwB,EACnC,IAAI,CAAC,EAAK;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,GAChD,OAAO,CAAC,IAAI,CAAC;IA+FhB,kFAAkF;IAC5E,eAAe,CAAC,SAAS,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAKxD,6EAA6E;IACvE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAI9B,6EAA6E;IACvE,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAIlC;;;;OAIG;IACG,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAe3D;;;;OAIG;IACG,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAe/D;;;;OAIG;IACG,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAKhE;;;;;OAKG;IACG,MAAM,CAAC,EAAE,SAAI,EAAE,EAAE,SAAI,EAAE,OAAO,SAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAW1D;;;OAGG;IACH,WAAW,CACT,MAAM,EAAI,UAAU,EACpB,QAAQ,GAAE,MAA0B,EACpC,QAAQ,CAAC,EAAE,MAAM,GAChB,UAAU;IAMb;;;;;;;;OAQG;YACW,OAAO;IAyCrB,8CAA8C;IAC9C,OAAO,CAAC,QAAQ;IAahB,OAAO,CAAC,UAAU;CAQnB"}

package/dist/protocol/picoboot/programmer.js

@@ -0,0 +1,278 @@
+// PICOBOOT programmer for Raspberry Pi Pico (RP2040) and Pico 2 (RP2350).
+//
+// Protocol reference:
+//   https://github.com/raspberrypi/picotool/blob/master/picoboot_connection/picoboot_connection.c
+//   https://github.com/raspberrypi/pico-sdk/blob/master/src/common/boot_picoboot_headers/include/boot/picoboot.h
+//
+// Flash sequence:
+//   1. EXCLUSIVE_ACCESS(1)  — take exclusive control, disable MSD drive
+//   2. EXIT_XIP             — exit execute-in-place mode (required before erase/write)
+//   3. FLASH_ERASE(addr, size)  — erase sectors (4KB-aligned)
+//   4. WRITE(addr, data)        — write pages (256-byte-aligned)
+//   5. REBOOT(0, 0, 500)        — reboot from flash
+//
+// Addressing: PICOBOOT uses offset-0 flash addressing.
+//   XIP 0x10001000 → PICOBOOT addr 0x00001000
+import { STK500ProtocolError, STK500VerifyError } from '../../core/errors.js';
+import { PICOBOOT_MAGIC, PICOBOOT_CMD_SIZE, PICOBOOT_STATUS_SIZE, PicobootCmd, PicobootStatus, FLASH_SECTOR_SIZE, FLASH_PAGE_SIZE, RP2040_FLASH_BASE, RP2040_FLASH_ADDR_MASK, } from './constants.js';
+import { parseUf2, binaryToUf2, isUf2 } from './uf2.js';
+// ── PicoBoot class ──────────────────────────────────────────────────────────
+export class PicoBoot {
+    constructor(transport, opts) {
+        this.token = 1;
+        this.transport = transport;
+        if (opts?.quiet) {
+            this.log = () => { };
+        }
+        else if (opts?.logger) {
+            this.log = opts.logger;
+        }
+        else {
+            this.log = (level, msg) => console.log(`[webserial-flasher:picoboot] [${level}] ${msg}`);
+        }
+    }
+    // ── Public API ─────────────────────────────────────────────────────────────
+    /**
+     * Flash firmware to the RP2040 / RP2350.
+     *
+     * Accepts either a UF2 file (detected by magic bytes) or a raw binary.
+     * Raw binaries are assumed to start at XIP base 0x10000000 unless
+     * `opts.baseAddr` is specified.
+     *
+     * @param data      UF2 file or raw binary as Uint8Array
+     * @param progress  Optional progress callback (status, 0–100)
+     * @param opts      Optional: baseAddr (for raw binary), verify (default: true)
+     */
+    async bootload(data, progress, opts) {
+        const report = (status, pct) => {
+            this.log('info', `${status} (${pct}%)`);
+            progress?.(status, pct);
+        };
+        // ── 1. Parse input ────────────────────────────────────────────────────────
+        report('Parsing firmware', 0);
+        let binary;
+        let baseAddr;
+        if (isUf2(data)) {
+            this.log('debug', 'Input detected as UF2 file');
+            const parsed = parseUf2(data);
+            binary = parsed.binary;
+            baseAddr = parsed.baseAddr;
+            this.log('debug', `UF2: ${parsed.blocks.length} blocks, baseAddr=0x${baseAddr.toString(16)}, familyId=0x${parsed.familyId.toString(16)}`);
+        }
+        else {
+            this.log('debug', 'Input detected as raw binary');
+            binary = data;
+            baseAddr = opts?.baseAddr ?? RP2040_FLASH_BASE;
+        }
+        // Convert XIP address to PICOBOOT offset address
+        const flashOffset = baseAddr & RP2040_FLASH_ADDR_MASK;
+        const doVerify = opts?.verify !== false;
+        // ── 2. Reset interface ────────────────────────────────────────────────────
+        report('Connecting to device', 2);
+        try {
+            await this.transport.resetInterface();
+        }
+        catch {
+            this.log('debug', 'resetInterface failed (non-fatal, continuing)');
+        }
+        // ── 3. Exclusive access ───────────────────────────────────────────────────
+        report('Taking exclusive access', 5);
+        await this.exclusiveAccess(true);
+        // ── 4. Exit XIP mode ──────────────────────────────────────────────────────
+        report('Exiting XIP mode', 8);
+        await this.exitXip();
+        // ── 5. Erase flash ────────────────────────────────────────────────────────
+        report('Erasing flash', 10);
+        const eraseSize = alignUp(binary.length, FLASH_SECTOR_SIZE);
+        await this.flashErase(flashOffset, eraseSize);
+        this.log('debug', `Erased ${eraseSize} bytes at offset 0x${flashOffset.toString(16)}`);
+        // ── 6. Write pages ────────────────────────────────────────────────────────
+        const padded = padToAlignment(binary, FLASH_PAGE_SIZE);
+        const numPages = padded.length / FLASH_PAGE_SIZE;
+        report('Uploading', 15);
+        for (let i = 0; i < numPages; i++) {
+            const pageOff = flashOffset + i * FLASH_PAGE_SIZE;
+            const page = padded.slice(i * FLASH_PAGE_SIZE, (i + 1) * FLASH_PAGE_SIZE);
+            await this.flashWrite(pageOff, page);
+            const pct = 15 + Math.round((i + 1) / numPages * 55);
+            progress?.('Uploading', pct);
+        }
+        report('Uploading', 70);
+        this.log('debug', `Wrote ${padded.length} bytes (${numPages} pages)`);
+        // ── 7. Verify ─────────────────────────────────────────────────────────────
+        if (doVerify) {
+            report('Verifying', 72);
+            const readBack = await this.flashRead(flashOffset, padded.length);
+            for (let i = 0; i < binary.length; i++) {
+                if (readBack[i] !== binary[i]) {
+                    throw new STK500VerifyError(baseAddr + i, binary[i], readBack[i]);
+                }
+                if (i % (FLASH_PAGE_SIZE * 8) === 0) {
+                    const pct = 72 + Math.round(i / binary.length * 20);
+                    progress?.('Verifying', pct);
+                }
+            }
+            report('Verifying', 92);
+        }
+        // ── 8. Reboot ─────────────────────────────────────────────────────────────
+        report('Rebooting device', 95);
+        await this.reboot(0, 0, 500);
+        report('Complete', 100);
+    }
+    // ── PICOBOOT commands ──────────────────────────────────────────────────────
+    /** EXCLUSIVE_ACCESS — take or release exclusive control (disables/enables MSD) */
+    async exclusiveAccess(exclusive) {
+        const args = new Uint8Array([exclusive ? 1 : 0]);
+        await this.execCmd(PicobootCmd.EXCLUSIVE_ACCESS, args);
+    }
+    /** EXIT_XIP — exit execute-in-place mode (required before erase or write) */
+    async exitXip() {
+        await this.execCmd(PicobootCmd.EXIT_XIP, new Uint8Array(0));
+    }
+    /** ENTER_CMD_XIP — re-enter XIP mode (optional, called after programming) */
+    async enterCmdXip() {
+        await this.execCmd(PicobootCmd.ENTER_CMD_XIP, new Uint8Array(0));
+    }
+    /**
+     * FLASH_ERASE — erase flash sectors.
+     * @param addr  Flash offset (0-based, 4KB-aligned)
+     * @param size  Number of bytes to erase (must be a multiple of 4096)
+     */
+    async flashErase(addr, size) {
+        if (addr % FLASH_SECTOR_SIZE !== 0) {
+            throw new STK500ProtocolError(`FLASH_ERASE: addr 0x${addr.toString(16)} is not 4KB-aligned`);
+        }
+        if (size % FLASH_SECTOR_SIZE !== 0) {
+            throw new STK500ProtocolError(`FLASH_ERASE: size ${size} is not a multiple of 4096`);
+        }
+        const args = buildRangeArgs(addr, size);
+        await this.execCmd(PicobootCmd.FLASH_ERASE, args);
+    }
+    /**
+     * WRITE — write a flash page (256 bytes).
+     * @param addr  Flash offset (0-based, 256-byte-aligned)
+     * @param data  Exactly 256 bytes of payload
+     */
+    async flashWrite(addr, data) {
+        if (addr % FLASH_PAGE_SIZE !== 0) {
+            throw new STK500ProtocolError(`WRITE: addr 0x${addr.toString(16)} is not 256-byte-aligned`);
+        }
+        if (data.length !== FLASH_PAGE_SIZE) {
+            throw new STK500ProtocolError(`WRITE: data must be exactly ${FLASH_PAGE_SIZE} bytes (got ${data.length})`);
+        }
+        const args = buildRangeArgs(addr, data.length);
+        await this.execCmd(PicobootCmd.WRITE, args, data);
+    }
+    /**
+     * READ — read bytes from flash.
+     * @param addr  Flash offset (0-based)
+     * @param size  Number of bytes to read
+     */
+    async flashRead(addr, size) {
+        const args = buildRangeArgs(addr, size);
+        return this.execCmd(PicobootCmd.READ, args, undefined, size);
+    }
+    /**
+     * REBOOT — reboot the device.
+     * @param pc        Program counter (0 = boot from flash)
+     * @param sp        Stack pointer (0 = use default)
+     * @param delayMs   Milliseconds before reboot (allows USB ACK to complete)
+     */
+    async reboot(pc = 0, sp = 0, delayMs = 500) {
+        const args = new Uint8Array(12);
+        const view = new DataView(args.buffer);
+        view.setUint32(0, pc, true);
+        view.setUint32(4, sp, true);
+        view.setUint32(8, delayMs, true);
+        await this.execCmd(PicobootCmd.REBOOT, args);
+    }
+    // ── UF2 helpers ────────────────────────────────────────────────────────────
+    /**
+     * Convert a raw binary to UF2 format.
+     * Convenience wrapper around the standalone `binaryToUf2` utility.
+     */
+    binaryToUf2(binary, baseAddr = RP2040_FLASH_BASE, familyId) {
+        return binaryToUf2(binary, baseAddr, familyId);
+    }
+    // ── Private protocol helpers ───────────────────────────────────────────────
+    /**
+     * Execute a PICOBOOT command and (optionally) transfer data.
+     *
+     * Flow for OUT commands (no data):   CMD→ | STATUS←
+     * Flow for OUT commands (write):     CMD→ | DATA→ | STATUS←
+     * Flow for IN commands (read):       CMD→ | DATA← | STATUS←
+     *
+     * @returns Received data for IN commands, or throws on error status
+     */
+    async execCmd(cmdId, args, outData, inLength = 0) {
+        const isInCmd = (cmdId & 0x80) !== 0;
+        const transferLength = isInCmd ? inLength : (outData?.length ?? 0);
+        const cmd = this.buildCmd(cmdId, args, transferLength);
+        await this.transport.sendCommand(cmd);
+        // Data phase: OUT (write) or IN (read)
+        let readData = null;
+        if (isInCmd && inLength > 0) {
+            readData = await this.transport.receiveBytes(inLength);
+        }
+        else if (outData && outData.length > 0) {
+            await this.transport.sendBytes(outData);
+        }
+        // Status phase — read up to PICOBOOT_STATUS_SIZE bytes from IN endpoint.
+        // The device sends a 16-byte picoboot_cmd_status struct:
+        //   [dToken u32][dStatusCode u32][bCmdId u8][bInProgress u8][6-byte pad]
+        const status = await this.transport.receiveBytes(PICOBOOT_STATUS_SIZE);
+        if (status.length >= 8) {
+            const statusCode = new DataView(status.buffer, status.byteOffset, status.byteLength).getUint32(4, true);
+            if (statusCode !== PicobootStatus.OK) {
+                const name = this.statusName(statusCode);
+                throw new STK500ProtocolError(`PICOBOOT cmd 0x${cmdId.toString(16)} failed: ${name} (code ${statusCode})`);
+            }
+        }
+        // If status.length < 8, assume ZLP (zero-length packet) = OK
+        return readData;
+    }
+    /** Build a 32-byte PICOBOOT command packet */
+    buildCmd(cmdId, args, transferLength) {
+        const buf = new Uint8Array(PICOBOOT_CMD_SIZE);
+        const view = new DataView(buf.buffer);
+        view.setUint32(0, PICOBOOT_MAGIC, true); // dMagic
+        view.setUint32(4, this.token++, true); // dToken
+        buf[8] = cmdId; // bCmdId
+        buf[9] = args.length & 0xFF; // bCmdSize
+        // bytes 10-11: _unused = 0
+        view.setUint32(12, transferLength, true); // dTransferLength
+        buf.set(args.slice(0, Math.min(args.length, 16)), 16); // args (max 16 bytes)
+        return buf;
+    }
+    statusName(code) {
+        const names = {
+            0: 'OK', 1: 'UNKNOWN_CMD', 2: 'BAD_CHECKSUM', 3: 'NOT_PERMITTED',
+            4: 'INVALID_ADDRESS', 5: 'BAD_ALIGNMENT', 6: 'INTERLEAVED',
+            7: 'REBOOTING', 8: 'UNKNOWN', 9: 'INVALID_STATE',
+        };
+        return names[code] ?? `status_${code}`;
+    }
+}
+// ── Private utilities ────────────────────────────────────────────────────────
+/** Build the 8-byte range args struct: [addr u32][size u32] (little-endian) */
+function buildRangeArgs(addr, size) {
+    const args = new Uint8Array(8);
+    const view = new DataView(args.buffer);
+    view.setUint32(0, addr, true);
+    view.setUint32(4, size, true);
+    return args;
+}
+/** Round `n` up to the nearest multiple of `alignment` */
+function alignUp(n, alignment) {
+    return Math.ceil(n / alignment) * alignment;
+}
+/** Pad `data` to a multiple of `alignment` with 0xFF */
+function padToAlignment(data, alignment) {
+    const padded = alignUp(data.length, alignment);
+    if (padded === data.length)
+        return data;
+    const out = new Uint8Array(padded).fill(0xFF);
+    out.set(data);
+    return out;
+}
+//# sourceMappingURL=programmer.js.map

package/dist/protocol/picoboot/programmer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"programmer.js","sourceRoot":"","sources":["../../../src/protocol/picoboot/programmer.ts"],"names":[],"mappings":"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"}

package/dist/protocol/picoboot/uf2.d.ts

@@ -0,0 +1,51 @@
+export interface UF2Block {
+    /** UF2 flags field */
+    flags: number;
+    /** Target XIP address for this block */
+    targetAddr: number;
+    /** Number of payload bytes in this block (always 256 for RP2040) */
+    payloadSize: number;
+    /** Sequential block index (0-based) */
+    blockNo: number;
+    /** Total block count in file */
+    numBlocks: number;
+    /** Family ID (e.g. UF2_FAMILY_RP2040) */
+    familyId: number;
+    /** Firmware payload — payloadSize bytes */
+    data: Uint8Array;
+}
+export interface UF2ParseResult {
+    /** All flashable blocks, sorted by target address */
+    blocks: UF2Block[];
+    /** Lowest XIP target address found */
+    baseAddr: number;
+    /** Contiguous binary assembled from all blocks (0xFF-padded for gaps) */
+    binary: Uint8Array;
+    /** Family ID from the first flashable block */
+    familyId: number;
+}
+/**
+ * Returns true if `data` starts with UF2 magic bytes.
+ * Use this to distinguish a UF2 file from a raw binary.
+ */
+export declare function isUf2(data: Uint8Array): boolean;
+/**
+ * Parse a UF2 file into individual blocks and a contiguous binary image.
+ *
+ * - Skips blocks with the NOT_MAIN flag set.
+ * - Sorts blocks by target address before assembling.
+ * - Fills gaps between blocks with 0xFF.
+ *
+ * @throws STK500InvalidHexError if the file is structurally invalid.
+ */
+export declare function parseUf2(data: Uint8Array): UF2ParseResult;
+/**
+ * Convert a raw binary into a UF2 file.
+ *
+ * @param binary    Raw firmware bytes
+ * @param baseAddr  XIP start address (default: 0x10000000 for RP2040)
+ * @param familyId  UF2 family ID (default: RP2040)
+ * @returns         UF2 file as Uint8Array (numBlocks × 512 bytes)
+ */
+export declare function binaryToUf2(binary: Uint8Array, baseAddr?: number, familyId?: number): Uint8Array;
+//# sourceMappingURL=uf2.d.ts.map

package/dist/protocol/picoboot/uf2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uf2.d.ts","sourceRoot":"","sources":["../../../src/protocol/picoboot/uf2.ts"],"names":[],"mappings":"AAiBA,MAAM,WAAW,QAAQ;IACvB,sBAAsB;IACtB,KAAK,EAAQ,MAAM,CAAC;IACpB,wCAAwC;IACxC,UAAU,EAAG,MAAM,CAAC;IACpB,oEAAoE;IACpE,WAAW,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,OAAO,EAAM,MAAM,CAAC;IACpB,gCAAgC;IAChC,SAAS,EAAI,MAAM,CAAC;IACpB,yCAAyC;IACzC,QAAQ,EAAK,MAAM,CAAC;IACpB,2CAA2C;IAC3C,IAAI,EAAS,UAAU,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,qDAAqD;IACrD,MAAM,EAAI,QAAQ,EAAE,CAAC;IACrB,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,yEAAyE;IACzE,MAAM,EAAI,UAAU,CAAC;IACrB,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,CAAC;CAClB;AAID;;;GAGG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAI/C;AAID;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,cAAc,CA2EzD;AAID;;;;;;;GAOG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAI,UAAU,EACpB,QAAQ,GAAE,MAA0B,EACpC,QAAQ,GAAE,MAA0B,GACnC,UAAU,CAsBZ"}

package/dist/protocol/picoboot/uf2.js

@@ -0,0 +1,119 @@
+// UF2 file format parser and generator for RP2040 / RP2350 firmware.
+// Reference: https://github.com/microsoft/uf2
+//
+// A UF2 file is a sequence of 512-byte blocks. Each block carries 256 bytes
+// of firmware payload plus metadata. The Raspberry Pi Pico bootloader accepts
+// UF2 files via USB drag-and-drop (MSD) or via the PICOBOOT protocol.
+import { UF2_MAGIC_START0, UF2_MAGIC_START1, UF2_MAGIC_END, UF2_FLAG_FAMILY_ID, UF2_FLAG_NOT_MAIN, UF2_BLOCK_SIZE, UF2_PAYLOAD_SIZE, UF2_FAMILY_RP2040, RP2040_FLASH_BASE, } from './constants.js';
+import { STK500InvalidHexError } from '../../core/errors.js';
+// ── Detection ───────────────────────────────────────────────────────────────
+/**
+ * Returns true if `data` starts with UF2 magic bytes.
+ * Use this to distinguish a UF2 file from a raw binary.
+ */
+export function isUf2(data) {
+    if (data.length < 4)
+        return false;
+    const view = new DataView(data.buffer, data.byteOffset, data.byteLength);
+    return view.getUint32(0, true) === UF2_MAGIC_START0;
+}
+// ── Parser ──────────────────────────────────────────────────────────────────
+/**
+ * Parse a UF2 file into individual blocks and a contiguous binary image.
+ *
+ * - Skips blocks with the NOT_MAIN flag set.
+ * - Sorts blocks by target address before assembling.
+ * - Fills gaps between blocks with 0xFF.
+ *
+ * @throws STK500InvalidHexError if the file is structurally invalid.
+ */
+export function parseUf2(data) {
+    if (data.length === 0) {
+        throw new STK500InvalidHexError('UF2 data is empty');
+    }
+    if (data.length % UF2_BLOCK_SIZE !== 0) {
+        throw new STK500InvalidHexError(`UF2 file size (${data.length} bytes) is not a multiple of 512`);
+    }
+    const view = new DataView(data.buffer, data.byteOffset, data.byteLength);
+    const blocks = [];
+    const total = data.length / UF2_BLOCK_SIZE;
+    for (let i = 0; i < total; i++) {
+        const off = i * UF2_BLOCK_SIZE;
+        const magic0 = view.getUint32(off + 0, true);
+        const magic1 = view.getUint32(off + 4, true);
+        const magicEnd = view.getUint32(off + 508, true);
+        if (magic0 !== UF2_MAGIC_START0 || magic1 !== UF2_MAGIC_START1 || magicEnd !== UF2_MAGIC_END) {
+            throw new STK500InvalidHexError(`UF2 block ${i}: invalid magic bytes`);
+        }
+        const flags = view.getUint32(off + 8, true);
+        const targetAddr = view.getUint32(off + 12, true);
+        const payloadSize = view.getUint32(off + 16, true);
+        const blockNo = view.getUint32(off + 20, true);
+        const numBlocks = view.getUint32(off + 24, true);
+        const familyId = view.getUint32(off + 28, true);
+        // Skip blocks not intended for main flash
+        if (flags & UF2_FLAG_NOT_MAIN)
+            continue;
+        if (payloadSize > UF2_PAYLOAD_SIZE) {
+            throw new STK500InvalidHexError(`UF2 block ${i}: payloadSize ${payloadSize} exceeds maximum ${UF2_PAYLOAD_SIZE}`);
+        }
+        blocks.push({
+            flags,
+            targetAddr,
+            payloadSize,
+            blockNo,
+            numBlocks,
+            familyId,
+            data: data.slice(off + 32, off + 32 + payloadSize),
+        });
+    }
+    if (blocks.length === 0) {
+        throw new STK500InvalidHexError('UF2 file contains no flashable blocks');
+    }
+    // Sort ascending by target address
+    blocks.sort((a, b) => a.targetAddr - b.targetAddr);
+    const baseAddr = blocks[0].targetAddr;
+    const lastBlock = blocks[blocks.length - 1];
+    const totalBytes = lastBlock.targetAddr - baseAddr + lastBlock.payloadSize;
+    const binary = new Uint8Array(totalBytes).fill(0xFF);
+    for (const block of blocks) {
+        const offset = block.targetAddr - baseAddr;
+        binary.set(block.data.subarray(0, block.payloadSize), offset);
+    }
+    return {
+        blocks,
+        baseAddr,
+        binary,
+        familyId: blocks[0].familyId,
+    };
+}
+// ── Generator ───────────────────────────────────────────────────────────────
+/**
+ * Convert a raw binary into a UF2 file.
+ *
+ * @param binary    Raw firmware bytes
+ * @param baseAddr  XIP start address (default: 0x10000000 for RP2040)
+ * @param familyId  UF2 family ID (default: RP2040)
+ * @returns         UF2 file as Uint8Array (numBlocks × 512 bytes)
+ */
+export function binaryToUf2(binary, baseAddr = RP2040_FLASH_BASE, familyId = UF2_FAMILY_RP2040) {
+    const numBlocks = Math.ceil(binary.length / UF2_PAYLOAD_SIZE);
+    const out = new Uint8Array(numBlocks * UF2_BLOCK_SIZE);
+    const view = new DataView(out.buffer);
+    for (let i = 0; i < numBlocks; i++) {
+        const off = i * UF2_BLOCK_SIZE;
+        const addr = baseAddr + i * UF2_PAYLOAD_SIZE;
+        view.setUint32(off + 0, UF2_MAGIC_START0, true);
+        view.setUint32(off + 4, UF2_MAGIC_START1, true);
+        view.setUint32(off + 8, UF2_FLAG_FAMILY_ID, true);
+        view.setUint32(off + 12, addr, true);
+        view.setUint32(off + 16, UF2_PAYLOAD_SIZE, true);
+        view.setUint32(off + 20, i, true);
+        view.setUint32(off + 24, numBlocks, true);
+        view.setUint32(off + 28, familyId, true);
+        out.set(binary.slice(i * UF2_PAYLOAD_SIZE, (i + 1) * UF2_PAYLOAD_SIZE), off + 32);
+        view.setUint32(off + 508, UF2_MAGIC_END, true);
+    }
+    return out;
+}
+//# sourceMappingURL=uf2.js.map

package/dist/protocol/picoboot/uf2.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uf2.js","sourceRoot":"","sources":["../../../src/protocol/picoboot/uf2.ts"],"names":[],"mappings":"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"}