Przejdź do treści
Biblioteka skilli
Programowanie · Analiza

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.

Repozytorium
guachat ↗
Licencja
GPL-3.0
Ostatnia zmiana repozytorium
28.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
2
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 28.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

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

  1. When to use
  2. First: get the boot log
  3. Match the ELF before decoding addresses
  4. Decision table
  5. Rules
  6. Fallbacks
Sekcje z nagłówków SKILL.md, w oryginale · 71 linii, 455 słów
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ę.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.