rasmus/MTGcompanion
1
0
Fork 0
Code Issues 1 Pull Requests 1 Actions Packages Projects Releases 1 Wiki Activity

docs: note display-unplug-during-flash workaround and MFRC522 glitch diagnostics in README

Browse Source
This commit is contained in:
Rasmus
2026-09-10 06:29:50 +02:00
parent 3f230283da
commit aff5d1477f
1 changed files with 2 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
README.md
View File

@@ -312,6 +312,8 @@ time (`littlefs_create_partition_image`), so a fresh flash already contains
| Wi-Fi never connects | Re-run `idf.py menuconfig`, confirm you replaced the `YOUR_...` placeholders | | Wi-Fi never connects | Re-run `idf.py menuconfig`, confirm you replaced the `YOUR_...` placeholders |
| Scryfall autocomplete shows nothing | The AP has no internet passthrough — the phone needs its own mobile data connection, or type the card name manually | | Scryfall autocomplete shows nothing | The AP has no internet passthrough — the phone needs its own mobile data connection, or type the card name manually |
| Can't reach 192.168.4.1 | Ensure your phone joined `MTG-Companion`, not a cached network | | Can't reach 192.168.4.1 | Ensure your phone joined `MTG-Companion`, not a cached network |
| Flash fails: `Serial data stream stopped` / must unplug the display to flash | Disconnect the ST7789 (or power it down) during `idf.py flash`: this board's display shares strapping pins GPIO2/GPIO15 and the panel can pull the 3.3V rail / strap pins at reset, corrupting the serial link mid-write. Flash, then reconnect the display. |
| RFID step of boot log: `Buffers content missmatch`, buffer2 = `13 33 37` | The reader now answers (SPI OK) but glitches on the write/read race. `RC522_SPI_CLK_HZ` is already 2 MHz; lower further to `1000000` in `rfid_manager.c`, or check the MFRC522's separate power header gets a clean 3.3V and confirm MISO=GPIO19 is actually connected |
| Card renders but no art | Card not cached yet — check `scryfall` log lines; art downloads are best-effort | | Card renders but no art | Card not cached yet — check `scryfall` log lines; art downloads are best-effort |
| App grows near 2MB | mbedTLS + HTTP pulls are large; if needed, enable `CONFIG_MBEDTLS_CERTIFICATE_BUNDLE` (smaller) | | App grows near 2MB | mbedTLS + HTTP pulls are large; if needed, enable `CONFIG_MBEDTLS_CERTIFICATE_BUNDLE` (smaller) |