guachat-debug
/guachat-debug
Diagnozuje pętle rozruchu, paniki, zniekształcenia ekranu oraz błędy I2C, SD, radia i dźwięku na płytce GUACHAT.
Ocena i bezpieczeństwo
- Pliki w paczce
- 2
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 28.10.2026, bez odwołań do wycofanych modeli i API.
GPL-3.0, otwarta.
Co robi i kiedy
Diagnozuje pętle rozruchu, paniki, zniekształcenia ekranu oraz błędy I2C, SD, radia i dźwięku na płytce GUACHAT.
Oryginalny opis (EN)
Diagnose GUACHAT boot loops, panics, display corruption, I2C/SD failures, and radio/audio problems. Use when the device misbehaves or a build boots incorrectly.
Jak działa
- When to use
- First: get the boot log
- Match the ELF before decoding addresses
- Decision table
- Rules
- Fallbacks
Podgląd SKILL.md
---
name: guachat-debug
description: Diagnose GUACHAT boot loops, panics, display corruption, I2C/SD failures, and radio/audio problems. Use when the device misbehaves or a build boots incorrectly.
---
# GUACHAT debug
## When to use
- Reboot loop, `TG0WDT_SYS_RST`, Guru Meditation, panic.
- Black screen, snow, stripes, touch not working.
- I2C devices disappear; SD card crashes; LoRa/audio fails.
- A merged image behaves differently from a `pio upload`.
## First: get the boot log
1. Open the serial port first (the firmware uses `Serial.setTxTimeoutMs(0)`).
2. Toggle DTR/RTS to reset.
3. Capture 15–30 seconds.
4. Look for:
- `rst:0x...` and `mode:DIO` / `mode:QIO`
- `Saved PC:`
- the last `[BSP] ...` line before silence
- `[BSP] hardware init done`
## Match the ELF before decoding addresses
1. Read `build/guachat-dev-full.manifest.json` and confirm the flashed image's
SHA256 matches `merged_image.sha256`.
If the artifact came from a release archive, verify it first:
```bash
python tools/archive_firmware.py verify dist/firmware/<sha256>
```
This re-checks every file, the source manifest, and the embedded ELF SHA256.
2. Use `.pio/build/guachat_dev/firmware.elf` only if its SHA256 matches
`artifacts.elf.sha256` in the same manifest.
3. Decode with the matching file:
```bash
~/.platformio/packages/toolchain-xtensa-esp32s3/bin/xtensa-esp32s3-elf-addr2line \
-pfiaC -e .pio/build/guachat_dev/firmware.elf <addresses>
```
4. If no matching ELF exists, report only what the log establishes and list the
missing artifact in `Unverified`. Do not rebuild the current source and
pretend it matches the old firmware.
## Decision table
| Symptom | Likely cause | Action |
| --- | --- | --- |
| Repeated ROM log, no app | merged image forced QIO | re-merge without `--flash_mode`; `verify_firmware.py` should reject it |
| `verify_firmware.py` fails | stale/mixed build or tampered image | rebuild and re-merge; do not flash until it passes |
| Boot loop after a code change | crash in init/task | read PC, bisect init order |
| Black screen, serial OK | backlight / TCA9535 / LVGL buffer | check logs, `bsp_backlight_set` |
| Snow/stripes | LoRa on SPI2 | move LoRa to SPI3 |
| Random assert in LVGL | non-UI task calls `lv_*` | queue/`lv_async_call` |
| UI stutters on USB | periodic `Serial` in `uiTask` | remove logging |
| I2C all dead | direct `Wire` or stuck bus | use Manager / `i2cBusLock` |
| TF card crash | missing `SdLockGuard` | add lock around file access |
| `QMC5883P NOT FOUND` | hardware missing / address | scan I2C, check power/solder |
| BMP581 `10.2 hPa` | hPa/Pa mix-up | BSP should multiply by 100 |
| LoRa RX never fires | RX not re-armed | call `bsp_radio_start_rx()` after read/TX |
## Rules
- Do not "fix" a failure by deleting checks or disabling the watchdog first.
- Do not change RF power/frequency unless the user asks; if you do, report it.
- Keep a minimal reproduction; remove one variable at a time.
## Fallbacks
- `docs/troubleshooting.md`
- `docs/concurrency.md`
- `docs/build-and-flash.md`
- `docs/testing.md`
Pliki w paczce (2)
- SKILL.md 3 KB
- SKILL.zh_CN.md 3 KB
Wersje
W bazie nie ma innych skilli o nazwie guachat-debug.
Migawka bazy z 13.11.2026 · wersja paczki fecc438d4be8 (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 100guachat-device-test
Wgrywa firmware GUACHAT na prawdziwy sprzęt po wyraźnym potwierdzeniu, zbiera logi szeregowe i sprawdza czujniki, radio oraz dźwięk. - 100guachat-setup
Przygotowuje czysty komputer do budowania firmware GUACHAT: PlatformIO, Python, toolchainy i pierwszą kompilację.