docs(d1l): document admin-password recovery + upload/monitor gotchas

claude commented

2026-08-23 23:45:33 +03:00

Collaborator

Documents the admin-password recovery procedure (local serial is unauthenticated by design, no erase needed), the 15-char password buffer truncation, a transient USB port-reenumeration race during upload, and pio device monitor's TTY requirement -- all discovered during tonight's real flash+password-recovery session.

claude added 1 commit

2026-08-23 23:45:33 +03:00

docs(d1l): document admin-password recovery + upload/monitor gotchas 248edcbe05

From tonight's real flash+recovery session:
- Admin Password section in D1L_GUIDE.md: default password, the
  15-char silent-truncation limit (char password[16] in
  src/helpers/CommonCLI.h), and the actual forgot-password fix --
  `password <new>` directly over local USB serial (unauthenticated by
  design, handleCommand(0, ...) has no sender_timestamp/login check --
  no erase, no identity loss required. `erase` (full FS wipe + new
  identity) is the last-resort path, not the first one.
- Troubleshooting: a transient "port doesn't exist" esptool failure at
  erase/write (USB re-enumeration race, not a hardware fault --
  retry the same command) and `pio device monitor`'s termios error
  when run without a controlling TTY (use tools/d1l_logger.py or a
  raw pyserial read instead for scripted captures).
- README.md: one-line pointer to the full D1L_GUIDE.md walkthrough
  from the Build & flash section.

claude commented

2026-08-23 23:45:52 +03:00

Author

Collaborator

Adjudication

No Teika/council review is wired up for this repo (no .forgejo/workflows/ present, confirmed via API). This is a doc-only change (README.md + docs/hardware/D1L_GUIDE.md, no source files touched) recording facts already independently verified live tonight: the admin-password buffer size (char password[16] in src/helpers/CommonCLI.h), the unauthenticated local-serial command dispatch (examples/simple_repeater/main.cpp:187), and the transient upload-port-race + pio device monitor TTY requirement (both reproduced live this session).

No findings to adjudicate. Merging.

## Adjudication No Teika/council review is wired up for this repo (no `.forgejo/workflows/` present, confirmed via API). This is a doc-only change (README.md + docs/hardware/D1L_GUIDE.md, no source files touched) recording facts already independently verified live tonight: the admin-password buffer size (`char password[16]` in `src/helpers/CommonCLI.h`), the unauthenticated local-serial command dispatch (`examples/simple_repeater/main.cpp:187`), and the transient upload-port-race + `pio device monitor` TTY requirement (both reproduced live this session). No findings to adjudicate. Merging.

claude merged commit 920290194f into nightly

2026-08-23 23:46:18 +03:00

claude deleted branch docs/d1l-admin-password-guide

2026-08-23 23:46:19 +03:00

claude referenced this pull request from a commit

2026-08-23 23:46:21 +03:00

Merge pull request 'docs(d1l): document admin-password recovery + upload/monitor gotchas' (#54) from docs/d1l-admin-password-guide into nightly

claude referenced this pull request

2026-08-23 23:47:15 +03:00

docs(d1l): add a tool-agnostic save-your-password note #55

Rows
Columns

docs(d1l): document admin-password recovery + upload/monitor gotchas #54

Adjudication