# Symulator TPMS Schrader EG53MA4 — ESP32-S2-MINI + 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-S2-MINI] ── SPI ──> [CC1101 433 MHz] ──> antena SMA │ │ │ │ └── GPIO0: przycisk (BOOT) └── wspólna GND, tylko 3,3 V └── GPIO15: wbudowana LED (aktywna HIGH) Zasilanie docelowe z gniazda zapalniczki samochodowej: wariant A: gniazdo ──> [ładowarka samochodowa USB] ──> USB-C płytki wariant B: gniazdo ──> bezpiecznik/TVS ──> [LM317T 3,3 V] ──> 3V3 + VCC CC1101 Konfiguracja: USB CDC 115200 → NVS → 4 × {ID, ciśnienie, temperatura} ``` Wyjście LM317T ustaw dzielnikiem na **3,3 V i 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. Gniazdo zapalniczki w większości aut jest zasilane tylko po przekręceniu stacyjki — **sprawdź to w swoim aucie**. Wtedy emulator nie pobiera prądu na postoju; komputer samochodowy i tak nie odczytuje stanu TPMS przy wyłączonym zapłonie, więc brak nadawania parkingowego nie ma znaczenia. Pełny pinout, dzielnik LM317T i kondensatory: [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 S2 Mini. 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 esp32s2mini .venv/bin/pio run -e esp32s2mini -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) - LM317T i zasilanie z gniazda zapalniczki: [HARDWARE](docs/HARDWARE.md#wariant-z-gniazda-zapalniczki--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.