Files
czcionka 1fdb0c7cce
check / check-without-hardware (push) Canceled after 0s
Dokumentacja: Quick Start bezpieczenstwo protokol HIL i RC
2026-10-27 18:17:25 +00:00

160 lines
6.6 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Symulator TPMS Schrader EG53MA4 — ESP32 + 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
USB 5 V (TYLKO prototyp) 3,3 V OOK 433,92 MHz
│ │ │
[ESP32 DevKit] ── SPI ───────> [CC1101 433 MHz] ── antena ────┘
│ │
├── GPIO26: przycisk └── wspólna GND
└── GPIO27: LED + 330 Ω
Konfiguracja: USB/UART 115200 → NVS → 4 × {ID, ciśnienie, temperatura}
```
Nie podłączaj 12 V do GPIO, 3V3 ani VIN DevKit. Połączenia i wariant automotive:
[HARDWARE](docs/HARDWARE.md).
## Quick Start
### 1. Złóż prototyp
Kup elementy z [BOM](docs/HARDWARE.md#bom-prototypu-laboratoryjnego). Podłącz
CC1101, przycisk i LED zgodnie z tabelą pinów. Zasil DevKit przez znany kabel USB
na biurku. Nie montuj jeszcze niczego w samochodzie.
### 2. Zainstaluj narzędzia i sprawdź projekt
Wymagane: Python 3, Git, CMake, kompilator C/C++, `pkg-config` i nagłówki libusb.
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 esp32dev
.venv/bin/pio run -e esp32dev -t upload
.venv/bin/pio device monitor --baud 115200
```
Jeżeli port nie jest wykrywany automatycznie, dodaj `--upload-port /dev/ttyUSB0`
(przy `run`) albo `--port /dev/ttyUSB0` (przy `device monitor`). W monitorze
PlatformIO wyjście to zwykle `Ctrl+]`.
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ę i sześć przewodów SPI;
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)
- Wymagania zasilania 12 V: [HARDWARE](docs/HARDWARE.md#wariant-automotive--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.