From 5ff4747105697cd031a7a70d2e526f5446bf0af7 Mon Sep 17 00:00:00 2001 From: mikecarper Date: Sun, 11 Oct 2026 13:29:08 -0700 Subject: [PATCH] Document automatic pinned USB migration utility downloads --- docs/esp32_wifi_partition_migration.md | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/docs/esp32_wifi_partition_migration.md b/docs/esp32_wifi_partition_migration.md index 061956341..85384c204 100644 --- a/docs/esp32_wifi_partition_migration.md +++ b/docs/esp32_wifi_partition_migration.md @@ -145,9 +145,13 @@ and LoRa artifacts remain unchanged. Exact new board/role migration packages also include their matching `usb-bridge.bin`. A host can pair this standalone set with an older, exact Full migration ZIP; -the Full image retains its original release/source identity. For meshfirmware, -set `MESHFIRMWARE_USB_MIGRATION_SET` to the local set ZIP, or place it beside -the flasher at `tools/meshcore-usb-partition-bridges.zip`. The original Full +the Full image retains its original release/source identity. Meshfirmware +downloads a versioned, checksum-pinned published USB set when a qualified +older package has no USB bridge. It does not use an untested `latest` bridge, +and an ordinary update that fits does not download migration utilities. +For an offline or explicitly selected set, use `MESHFIRMWARE_USB_MIGRATION_SET`, +or place the ZIP beside the flasher at `tools/meshcore-usb-partition-bridges.zip`. +The original Full package must still match the selected final image and prove the target layout. No app-only upload or manual partition-table write substitutes for that proof.