# Symulator TPMS Schrader EG53MA4 — ESP32-C3 SuperMini + CC1101 **Wersja 2.0.0-rc.1 — release candidate bez walidacji sprzętowej.** Urządzenie warsztatowe nadaje cztery niezależne identyfikatory TPMS profilem OOK/Manchester Schrader EG53MA4 na 433,92 MHz. Domyślnie każde koło raportuje **260 kPa (2,6 bar; bajt protokołu `0x68`)**. Docelowy scenariusz to diagnostyka Opla Astry J Sedan 1.4 LPG (2016, EU), ale **zgodność trzeba potwierdzić dla konkretnego auta**: przez VIN/wykaz serwisowy, oznaczenia fabrycznych czujników, odczyt diagnostyczny albo test odbioru. Numer OE 13506028, numery powiązane ani ogłoszenie sprzedażowe same w sobie nie potwierdzają profilu radiowego. > **Nie jest to homologowany czujnik ani zamiennik sprawnego TPMS. Nie używać > w jeździe drogowej.** Sztuczne ciśnienie może ukryć przebitą lub niedopompowaną > oponę i opóźnić ostrzeżenie. Przed i po teście sprawdź wszystkie opony > niezależnym manometrem. Zobacz [SAFETY](docs/SAFETY.md). ## Co jest gotowe, a czego nie - Gotowe: build ESP32, testy ramek/NVS/maszyny stanów, syntetyczny CU8 dekodowany przez niezależny `rtl_433`, trwała konfiguracja z konsoli, Clone IDs i LEARN. - **Niewykonane:** pomiar rzeczywistego CC1101, RTL-SDR z anteną, test z samochodem, pomiar prądu i testy automotive. Dlatego wynik jest RC, nie „validated”. - Jedyny profil podstawowy to **OOK**. Nie przełączaj na FSK „na próbę”. - ESP32 nie generuje nośnej 433 MHz — wymagany jest osobny CC1101 433 MHz. ## Schemat ideowy ```text Prototyp na biurku: USB-C ──> [ESP32-C3 SuperMini] ── SPI ──> [CC1101 433 MHz] ──> antena │ │ │ │ └── GPIO3: przycisk └── wspólna GND, tylko 3,3 V └── GPIO8: wbudowana LED (aktywna LOW) Zasilanie zewnętrzne 3,3 V: zabezpieczone VIN ──> [LF33CV] ──> 3V3 SuperMini + VCC CC1101 Konfiguracja: USB CDC 115200 → NVS → 4 × {ID, ciśnienie, temperatura} ``` Wyjście LF33CV podłącz do **3V3, nie do 5V**. Nie podłączaj 12 V do GPIO, 3V3 ani 5V. Przy zasilaniu zewnętrznym 3,3 V odłącz USB, chyba że separacja źródeł została sprawdzona w dokumentacji konkretnego egzemplarza płytki. Pełny pinout, kondensatory i zasady podłączenia „po stacyjce”: [HARDWARE](docs/HARDWARE.md). ## Quick Start ### 1. Złóż prototyp Kup elementy z [BOM](docs/HARDWARE.md#bom-prototypu-laboratoryjnego). Podłącz CC1101 i przycisk zgodnie z tabelą pinów; LED jest już na płytce SuperMini. Na biurku zasil układ przez sprawdzony kabel USB-C z danymi. Nie montuj jeszcze niczego w samochodzie. ### 2. Zainstaluj narzędzia i sprawdź projekt Wymagane: Python 3, Git, CMake, kompilator C/C++, `pkg-config` oraz nagłówki libusb i librtlsdr. Najprościej użyć Dockera: ```bash docker build -t tpms-rc . docker run --rm -v "$PWD/artifacts:/work/artifacts" tpms-rc ``` Bez Dockera skrypt utworzy `.venv` z PlatformIO, pobierze przypięty `rtl_433` i referencyjne nagrania: ```bash bash tools/check_all ``` Ostatni komunikat musi brzmieć `PASS: wszystkie testy bez sprzetu...`. To nie jest test fizycznego radia. ### 3. Skompiluj i wgraj ```bash .venv/bin/pio run -e esp32c3supermini .venv/bin/pio run -e esp32c3supermini -t upload .venv/bin/pio device monitor --baud 115200 ``` Jeżeli port nie jest wykrywany automatycznie, dodaj `--upload-port /dev/ttyACM0` (przy `run`) albo `--port /dev/ttyACM0` (przy `device monitor`). Zależnie od systemu i trybu USB może to być również `/dev/ttyUSB0`. W monitorze PlatformIO wyjście to zwykle `Ctrl+]`. Jeśli upload nie startuje, przytrzymaj **BOOT**, naciśnij i puść **RESET**, następnie puść BOOT. Po uruchomieniu wpisz `stay 300` i Enter. Masz 5 minut na konfigurację; polecenie `info` pokazuje aktywne wartości. Każda zmiana konfiguracji jest od razu zapisywana w NVS i zachowuje się po restarcie — **nie edytuj ID w kodzie**. ### 4A. Preferowane: Clone IDs Jeśli znasz oryginalne 24-bit ID (np. z wcześniejszego odczytu `rtl_433`), wpisz je w kolejności FL, FR, RR, RL. Przykład — zastąp wartości własnymi: ```text stay 300 id 1 2FC871 id 2 2EAAF9 id 3 3495AC id 4 2FC780 pressure all 260 info send ``` ID musi mieć sześć cyfr hex, być niezerowe, różne od `FFFFFF` i unikalne. Urządzenie wróci do NORMAL i będzie nadawało znane ID. **Nauka może być niepotrzebna, ale nie jest to gwarantowane.** Potwierdź odbiór diagnostycznie; nie zaczynaj od jazdy. ### 4B. Alternatywa: New IDs + LEARN 1. Wpisz `ids new`, następnie `info` i zapisz wygenerowane ID. 2. Uruchom właściwą dla swojej wersji auta procedurę nauki TPMS zgodnie z jej instrukcją serwisową. Nie zgaduj sekwencji menu/pedałów. 3. Wpisz `mode learn`. Nadaje wyłącznie FL, co 2 s. LED wskaże 1 mrugnięcie. 4. `send` wymusza bieżące koło bez zmiany. Po potwierdzeniu kroku w aucie wpisz `next`: FR → RR → RL. Krótki przycisk robi to samo; po RL wraca do NORMAL. 5. Jeśli minie 60 s na kole, LEARN przerwie się do NORMAL. Cała sesja ma limit 15 min. Po zakończeniu sprawdź ID i kody diagnostyczne. EL-50448/OEC-T5 jest aktywatorem LF 125 kHz, **nie programatorem ESP32**. Ta procedura nie wymaga go. Szczegóły: [SETUP](docs/SETUP.md). ## Sterowanie — jedna tabela LED działa tylko podczas czuwania; w deep sleep jest zgaszona. Po zmianie koła seria 1–4 mrugnięć wskazuje FL/FR/RR/RL. | Tryb | Wzorzec LED | Krótki przycisk | Długi ≥1,5 s | Bardzo długi ≥4 s | |---|---|---|---|---| | NORMAL | 1 mrugnięcie / 2 s | burst wszystkich 4 | wejście LEARN | wejście SINGLE | | LEARN | 3 mrugnięcia / 0,5 s; po zmianie numer koła | następne koło + TX; po RL koniec | wyjście NORMAL | wejście SINGLE | | SINGLE | 2 mrugnięcia / 0,5 s; po zmianie numer koła | następne koło + TX | wejście LEARN | wyjście NORMAL | W konsoli `send` w NORMAL nadaje wszystkie, a w LEARN/SINGLE tylko bieżące koło. `send 1`…`send 4` wybiera koło jawnie; `send all` nadaje cztery. SINGLE wyłącza się po 5 min. ## Najczęstsze problemy - **`BLAD: brak CC1101`**: sprawdź 3,3 V, wspólną masę oraz SCK/MISO/MOSI/CS na GPIO4/5/6/7 i GDO0 na GPIO10; nie używaj 5 V na CC1101. - **Konsola znika przed wpisaniem komend**: po restarcie od razu `stay 300`; zwykłe wybudzenie RTC celowo nie otwiera okna konsoli. - **NVS zgłasza błąd**: urządzenie używa bezpiecznych domyślnych; wpisz `info`. `factory YES` kasuje własne ID i przywraca konfigurację fabryczną. - **Auto nie odbiera**: najpierw zweryfikuj profil auta i odbiór RTL-SDR; nie zmieniaj losowo modulacji, flag ani interwałów. Zobacz [TROUBLESHOOTING](docs/TROUBLESHOOTING.md). ## Walidacja, zasilanie i release - Protokół i niewiadome: [PROTOCOL](docs/PROTOCOL.md) - Dokładne wyniki i checklista HIL: [VALIDATION](docs/VALIDATION.md) - Pobór (na razie szacunki): [POWER](docs/POWER.md) - LF33CV i zasilanie „po stacyjce”: [HARDWARE](docs/HARDWARE.md#wariant-prąd-po-stacyjce--wymagania-niezwalidowany-projekt) - Zmiany: [CHANGELOG](CHANGELOG.md) Gotowe obrazy tworzy `bash tools/package_release.sh`. Pliki i adresy opisano w [VALIDATION](docs/VALIDATION.md#artefakty-i-wgrywanie). Release candidate nie zawiera wyniku testu CC1101 ani samochodu.