Skip to content

Commit 140ec42

Browse files
committed
docs: record the CURRENT.UF2 restore gotcha found during hardware testing
Real RAK4631 hardware testing for this branch (see PR #19) hit this: restoring an app via ghostfat's live CURRENT.UF2 dump left the device hung on boot even though the bytes matched what was there before. A normal release UF2 or OTA-DFU flash both worked fine immediately after. Recording it so it doesn't get mistaken for a regression from this PR's actual change (nrfx/tinyusb) next time someone hits it.
1 parent 7748ba4 commit 140ec42

1 file changed

Lines changed: 11 additions & 0 deletions

File tree

AGENTS.md

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -158,3 +158,14 @@ itself; a human has to edit it too.
158158
upgrade support with no board here yet (issues #4, #5) — bringing up a
159159
new board needs real hardware to get `UF2_BOARD_ID`/VID-PID/pin defs
160160
right; don't fabricate a `board.h` without one.
161+
- **`CURRENT.UF2` (the UF2-drive file `ghostfat.c` generates live from the
162+
already-flashed app region) does not round-trip cleanly.** Copying it off
163+
as a backup works fine, but copying it straight back to "restore" the app
164+
it came from can leave the device booting into a hung app (frozen
165+
display, no LED activity) even though the bytes are identical to what
166+
was there before — something about bootloader-settings/app-valid state
167+
isn't fully reconciled by that path. Confirmed on real RAK4631 hardware
168+
during the nrfx/tinyusb bump testing (PR #19). A real release UF2 or a
169+
normal OTA-DFU flash both round-trip fine; only the raw dump-and-rewrite
170+
doesn't. Untriaged — if you hit this, a fresh release UF2 is the
171+
workaround, not a bootloader-settings-format bug hunt mid-task.

0 commit comments

Comments
 (0)