Dokumentacja: Quick Start bezpieczenstwo protokol HIL i RC
check / check-without-hardware (push) Canceled after 0s

This commit is contained in:
czcionka committed 2026-10-27 18:17:25 +00:00
1 parent 17d2cea3ea
commit 1fdb0c7cce
13 files changed
+1195 -664

No files matched your search

+25
View File
@@ -0,0 +1,25 @@
# Rejestr audytu release-v2
| Priorytet | Problem początkowy | Kryterium naprawy | Stan / dowód |
|---|---|---|---|
| P0 | Zgadywany bit low battery zależny od zasilania emulatora | brak maski i sprzężenia; test flags | naprawione; grep kodu i 20/20 native |
| P0 | MCP1703 + TVS 24 V opisane jako ochrona automotive | usunąć rekomendację; wymagania i przykład z datasheet | naprawione w HARDWARE |
| P0 | Brak fizycznego dowodu zgodności z autem przedstawiany zbyt pewnie | RC, jawne HIL, weryfikacja VIN/oznaczeń | naprawiona dokumentacja; HIL nadal otwarte |
| P1 | ID/ciśnienia/RF tylko przez rekompilację | NVS z konsolą, walidacja, wersja/CRC | naprawione; test_settings i build |
| P1 | Monolit uniemożliwiał test timeoutów/ACC | przenośny state-machine, fake clock/radio | naprawione; test_app_state |
| P1 | FSK w podstawowym flow bez dowodu | tylko OOK w firmware/generatorze | naprawione |
| P1 | PARKING_SHUTDOWN bez gwarantowanego ACC wake | usunąć albo zapewnić budzenie | usunięty; każdy sen ma RTC |
| P1 | TX kończone czasem i TXBYTES, ryzyko ogona | MARCSTATE/underflow/limit | poprawione; wymaga potwierdzenia HIL |
| P1 | Wektory głównie własne | cztery prawdziwe nagrania + niezależny rtl_433 | 64/64 PASS |
| P2 | Domyślne LF bez zwalidowanego front-endu | wyłączyć domyślnie, LEARN bez LF | naprawione |
| P2 | Interwały przedstawiane jak OE | jawnie eksperymentalne | PROTOCOL/SETUP/POWER |
| P2 | Brak pełnego jednego check/build artefaktów | check_all, CI, Docker, package_release | dodane; wyniki VALIDATION |
| P2 | Okno konsoli po każdym RTC zwiększa pobór | sen od razu po cyklu RTC | poprawione; pomiar HIL otwarty |
| P2 | README niezgodne z zachowaniem | nowy Quick Start, jedna tabela UI | przepisane |
## Otwarte, wymagające sprzętu
Nie można ich zamknąć deklaracją: pomiar CC1101/ogon/moc/częstotliwość, test
RTL-SDR z anteną, pobór i brownout, zabezpieczone ACC, test Clone IDs/LEARN z
konkretną Astrą oraz projekt i test zasilania automotive. Są checklistą w
`VALIDATION.md` i blokują status „validated”.
+110
View File
@@ -0,0 +1,110 @@
# Sprzęt i montaż
## Zakres
Podstawowy release opisuje **prototyp laboratoryjny**. DevKit, przewody
prototypowe i tania przetwornica nie są gotowym zestawem do trwałego montażu
w samochodzie. Wariant automotive poniżej jest listą wymagań projektowych,
nie zwalidowanym schematem.
## BOM prototypu laboratoryjnego
| Element | Wymaganie | Uwagi |
|---|---|---|
| ESP32 DevKit z ESP32-WROOM-32 | 3,3 V, USB do flash/konsoli | tylko biurko; mostek USB i LDO zwiększają pobór |
| CC1101 | moduł **433 MHz**, SPI, 3,3 V | nie kupuj wersji 868/915 MHz |
| Antena 433 MHz | dopasowana do modułu; na biurko monopol λ/4 ≈ 17 cm | uziemienie/przeciwwaga zgodnie z konstrukcją modułu |
| Przycisk NO | monostabilny | GPIO26 do GND |
| LED + rezystor | 330 Ω | GPIO27, LED do GND |
| Kondensatory | 100 nF przy każdym module + 47–100 µF przy CC1101 | możliwie blisko pinów zasilania |
| Przewody | krótkie, wspólna masa | SPI najlepiej <10 cm |
| Zasilanie laboratoryjne | USB 5 V do DevKit albo regulowane 3,3 V z limitem prądu | nie podawaj jednocześnie rywalizujących źródeł |
Do diagnozy RF przydaje się RTL-SDR, ale nie jest częścią emulatora. Do wersji
energooszczędnej użyj gołego ESP32-WROOM-32E na własnej płytce, z poprawnym
zasilaniem, resetem, bootstrapem i złączem programowania. Sam moduł nie ma USB.
## Pinout i połączenia
| ESP32 | CC1101 / element | Zasada |
|---|---|---|
| 3V3 | CC1101 VCC | **tylko 3,3 V** |
| GND | CC1101 GND, przycisk, LED | wspólna masa |
| GPIO18 | SCK/SCLK | SPI |
| GPIO19 | MISO/SO | SPI |
| GPIO23 | MOSI/SI | SPI |
| GPIO5 | CS/CSn/SS | SPI |
| GPIO2 | GDO0 | diagnostyka biblioteki; GDO2 niepodłączony |
| GPIO26 | przycisk NO do GND | wewnętrzny pull-up; opcjonalny zewnętrzny 10 kΩ |
| GPIO27 | rezystor 330 Ω → LED → GND | aktywna wysoko |
| GPIO34 | opcjonalny ADC zasilania przez dzielnik | nigdy 12 V wprost |
| GPIO32 | opcjonalne ACC po zmianie `PIN_ACC` i zabezpieczeniu | nigdy 12 V wprost |
| GPIO25 | opcjonalny detektor LF po zmianie `PIN_LF_TRIGGER` | domyślnie wyłączone; brak gotowego front-endu w RC |
Przy zasilaniu 3,3 V z zasilacza: ustaw limit np. 0,5 A, sprawdź polaryzację,
połącz GND, wyłącz USB jako drugie źródło. Prąd szczytowy zależy od modułu i PA.
## Antena i test położenia
Nie zgadujemy położenia odbiornika TPMS w Astrze J. Test zasięgu wykonaj na
postoju, z niską mocą, porównując odczyt RTL-SDR/diagnostykę dla kilku pozycji:
konsola środkowa, okolica za schowkiem, ewentualnie bagażnik. Wynik dla jednego
egzemplarza nie jest dowodem lokalizacji odbiornika.
Urządzenie mocuj mechanicznie, z dala od poduszek powietrznych i ich wiązek,
strefy pedałów, ruchomych części, wilgoci, źródeł ciepła i metalowych ekranów.
Nie owijaj anteny wiązką, nie prowadź jej przy żarówce/rozdzielaczu LPG ani przy
przewodach zapłonowych. Obudowa prototypu powinna być nieprzewodząca; otwór i
konieczność ekranowania trzeba ocenić pomiarowo.
## Wariant automotive — wymagania, niezwalidowany projekt
Instalacja 12 V wymaga osobnego schematu, obliczeń, PCB i testów. Minimalny łańcuch:
```text
akumulator → bezpiecznik przy źródle → ochrona reverse polarity
→ ograniczenie energii + właściwie dobrany TVS
→ regulator automotive → odsprzężenie → ESP32 + CC1101
ACC → ochrona przepięciowa + dzielnik/komparator → wejście logiczne 3,3 V
```
Wymagania:
- bezpiecznik dobrany do przewodów i poboru, blisko źródła; nie zastępuje TVS;
- ochrona przed odwrotną polaryzacją i ujemnymi przepięciami;
- TVS dobrany do rzeczywistego profilu przepięć, rezystancji źródła i energii;
napięcie robocze nie może powodować upływu przy 14,4–14,8 V, a napięcie
ograniczenia musi pozostawić margines względem absolutnego maksimum regulatora;
- regulator z odpowiednim zakresem wejściowym, prądem szczytowym, niskim Iq,
stabilnością z wybranymi kondensatorami i kwalifikacją automotive;
- odsprzężenie zgodne z kartą regulatora, ESP32 i CC1101, krótkie pętle prądowe;
- ACC/ADC z ograniczeniem prądu, clampami i progiem odpornym na zakłócenia;
- obliczenia termiczne dla najwyższej temperatury, test brownout/crank/load dump,
EMC, ESD oraz pomiar snu całego urządzenia.
**MCP1703 ma Vin maks. 16 V i nie jest pełną ochroną automotive nawet z TVS 24 V.**
TVS o progu wyższym niż dopuszczalne Vin nie chroni regulatora. Nie używamy tej
rekomendacji.
Przykład do dalszego projektu, nie gotowa rekomendacja montażowa: **LM5164-Q1**,
buck 6–100 V, 1 A, typowy Iq rzędu 10 µA (wartości zależne od warunków). Sprawdzono
z kartą TI [LM5164-Q1](https://www.ti.com/lit/ds/symlink/lm5164-q1.pdf), dostęp
2026-10-27. Projekt musi uwzględnić m.in. schemat aplikacyjny, cewkę, diodę/układ
wejściowy, kondensatory, stabilność, szczyty prądu ESP32, temperaturę i ograniczenie
przepięcia poniżej dopuszczalnego Vin z marginesem. Sama nazwa „100 V” nie dowodzi
odporności całego urządzenia.
## Zasilanie bateryjne
Ogniwo 18650 w kabinie **nie jest rekomendowane**: temperatura w samochodzie może
przekraczać bezpieczne warunki ogniwa, a zainstalowane ogniwo wymaga ochrony,
właściwego ładowania i obudowy. ESP32 z radiem i okresowym czuwaniem zwykle daje
krótki czas pracy; deklaracje wieloletniej pracy byłyby nieuzasadnione. Wieloletni
wariant bateryjny wymaga innej architektury low-power i nie należy do tego release.
## Opcjonalny LF
RC działa bez EL-50448. Nie ma w nim zwalidowanego odbiornika LF. Przyszły moduł
wymaga osobnego schematu rezonansu/detekcji 125 kHz, progu komparatora, filtracji,
testu odporności na zakłócenia i udowodnionego budzenia. Sam aktywator nie wpisuje
ID do emulatora.
+56
View File
@@ -0,0 +1,56 @@
# Energia i zachowanie na postoju
## Status pomiarów
**Nie wykonano pomiarów prądu fizycznego prototypu.** Liczby poniżej są
szacunkami budżetu, nie wynikiem walidacji. DevKit nie nadaje się do deklaracji
poboru µA, ponieważ mostek USB-UART, LED i regulator mogą pobierać ok. 0,5–2 mA
lub więcej w zależności od płytki.
## Harmonogram firmware
- NORMAL po wybudzeniu RTC: inicjalizacja, burst czterech kół, wyjście z TX i deep
sleep. Nie ma 10-sekundowego okna konsoli po zwykłym budziku.
- Po power-on, przycisku lub LF: okno konsoli 10 s; `stay N` wydłuża je.
- LEARN: TX jednego koła co 2 s, bez deep sleep, maks. 60 s na koło/15 min sesji.
- SINGLE: TX jednego koła co 2 s, bez deep sleep, maks. 5 min.
- CC1101 przechodzi w SPWD przed snem; CS jest wysoki, SCK/MOSI niskie, LED off.
- Każdy sen ma budzik RTC. `PARKING_SHUTDOWN` usunięto — urządzenie nie może
pozostać uśpione do czasu wyłącznie ręcznego wybudzenia.
- ACC (opcjonalny sprzętowo) wybiera interwał ignition/parking. Nie jest potrzebne
jako jedyne źródło wybudzenia, ponieważ RTC zawsze działa.
## Szacunek ładunku dla ustawień domyślnych
Jedna ramka to 240 × 120 µs = 28,8 ms na antenie. Dla 4 kół × 3 ramki:
345,6 ms samej transmisji plus 8 × 50 ms przerw wewnątrz burstów. Do tego dochodzi
boot, konfiguracja, SPI i logi. Do obliczeń energii trzeba zmierzyć cały cykl,
a nie tylko czas OOK.
Przykładowy model (do zastąpienia pomiarem): jeżeli aktywność ESP32 wyniesie 1,0 s
przy 80 mA co 30 s, sam ESP32 uśrednia ok. 2,7 mA na 3,3 V. CC1101, boot i prąd snu
dodają kolejne składniki. Przy interwale 120 s udział aktywności spada ok. czterokrotnie,
ale stały Iq zasilacza i dzielników pozostaje. Nie są to zmierzone 2,7 mA ani
obietnica poboru z akumulatora 12 V.
## Metoda pomiaru wymagana przed „validated”
1. **Cały DevKit w sleep:** miernik µA szeregowo na wejściu, nie przez USB.
Odczekać do końca TX i zanotować minimum/stan stabilny oraz model płytki.
2. **Goły moduł + zasilacz docelowy:** powtórzyć na wejściu 12 V i na 3,3 V.
Uwzględnić Iq regulatora, TVS, dzielniki i pull-upy.
3. **Cykl NORMAL:** bocznik + oscyloskop albo logger z odpowiednim pasmem.
Zarejestrować boot, 12 ramek, przerwy, wejście w sen przez co najmniej 10 cykli.
4. **Średnia:** całkować ładunek co najmniej 15 min przy 30 s i 120 s. Podawać
warunki: napięcie, temperatura, PA, wersja płytki i firmware.
5. **LEARN/SINGLE:** osobno zmierzyć prąd ciągłego czuwania.
6. **ACC/brownout/crank:** sprawdzić restart, powrót do nadawania i integralność
NVS. Nie wykonywać na GPIO bez potwierdzonej ochrony wejścia.
## Wnioski dopuszczalne przed pomiarem
- Największy wpływ mają interwał, czas czuwania, PA i Iq całej płytki.
- Do wersji energooszczędnej potrzebny jest goły ESP32 i zasilacz o niskim Iq.
- Nie rekomendujemy 18650 w kabinie ani wieloletniej pracy bateryjnej z ESP32.
- Stały pobór emulatora trzeba uwzględnić przy długim postoju pojazdu; nie podajemy
czasu „bezpiecznego dla akumulatora” bez pomiaru całego samochodu.
+93
View File
@@ -0,0 +1,93 @@
# Protokół Schrader EG53MA4 — fakty i niewiadome
## Przypięte źródła
| Źródło | Wersja użyta do walidacji | Zakres |
|---|---|---|
| `rtl_433/src/devices/schraeder.c` | commit `406f9a33550a2b6b3d0d8a8a486417ce5b3f13ab` | dekoder i parametry slicera |
| `rtl_433_tests/tests/Schrader_EG53MA4_TPMS/01` | commit `1aa8c29d6b9383739d1aeed495dbc5069b704392` | cztery nagrania CU8 + JSON |
| PlatformIO | 6.1.18 | build/test |
| `espressif32` | 8.0.0 | toolchain/platforma ESP32 |
| SmartRC-CC1101-Driver-Lib | `de6757ef633b3e626dae5c7835cdb66ab53f9a1d` (3.0.2) | konfiguracja CC1101 |
| Praktyczna analiza odbioru | <https://milek7.pl/tpmsreceiver/> | kontekst; nie źródło pól ramki |
| Wzorzec integracji ESP32+CC1101 | <https://github.com/merbanan/rtl_433/issues/2978> | integracja, nie protokół EG53MA4 |
Nie używamy nieoznaczonego `master` jako referencji reprodukowalnej. Komercyjny
emulator <https://spooftpms.com/us-eu-gm-1-2-family-tpms-simulator/> potwierdza
jedynie istnienie takiej klasy urządzenia, nie zgodność tego projektu.
## Potwierdzony format po dekodowaniu Manchester
Dekoder wymaga dokładnie 120 bitów: 40 bitów synchronizacji i 80 bitów danych.
```text
0 40 64 72 80 88
| 40 × sync (0) | flags 4 B | ID 3 B | P 1 B | T 1 B | sum 1 B |
4C 90 00 70 2F C8 71 68 49 65
```
- `flags`: 32 bity; znaczenie pól nie jest w pełni znane.
- `ID`: 24 bity; firmware odrzuca 0, `FFFFFF` i duplikaty między kołami.
- `P`: 2,5 kPa/bit. 260 kPa daje 104 = `0x68`. Kwantyzacja jest zaokrąglana
do najbliższego kroku: `(kPa×10 + 12) / 25`.
- `T`: bajt w °F zgodnie z dekoderem, nie °C. 23 °C → 73 °F.
- `sum`: suma dziewięciu poprzednich bajtów modulo 256; to nie CRC-8.
- Wartość `4c900070` występuje we wszystkich 64 rekordach czterech nagrań.
Nie dowodzi to, że każdy czujnik/tryb auta używa zawsze tej wartości.
## Polaryzacja, preambuła i ogon
Nagrania i slicer `OOK_PULSE_MANCHESTER_ZEROBIT` potwierdzają G.E.T. Manchester:
`0 → 01`, `1 → 10`. Slicer dopisuje pierwszy zerowy bit. Bufor CC1101 zawiera:
```text
1 chip startowy + 39 komórek sync + 80 komórek danych + 1 chip OFF dopełnienia
= 240 chipów = 30 bajtów, MSB first.
```
Ostatni chip dopełnienia jest zerem OOK (cisza). Test sprawdza dokładnie tę
długość, polaryzację i odrzuca ucięty/uszkodony bufor.
## Timing i powtórzenia
- Dekoder ma `short_width=123 µs`, `reset_limit=300 µs`.
- Analiza `gfile001` pokazuje typowy okres pulse+gap ok. 236 µs, czyli chip
ok. **118 µs**; szerokości impulsów różnią się od szerokości przerw. Firmware
używa eksperymentalnie **120 µs**, co przechodzi dekodowanie niezależnym
`rtl_433`. Dokładny zegar fizycznego CC1101 wymaga pomiaru HIL.
- Każde z czterech nagrań zawiera **16 poprawnych powtórzeń**. W `gfile001`
odstępy początków dekodowań wahają się ok. 115–172 ms; nie są stałe.
- Domyślne **3 ramki, przerwa 50 ms, cykl 30 s** są eksperymentalnymi
ustawieniami emulatora, a nie potwierdzonym harmonogramem OE. Interwały
ACC/parking również nie mają statusu zgodności z OE.
## Nośna i modulacja
Podstawowy profil: **433,92 MHz, ASK/OOK**. Nagrania są zdekodowane przy tej
częstotliwości. README zestawu zawiera też dane produktu 315 MHz i wzmiankę
ASK+FSK; to nie jest dowód FSK w analizowanych plikach ani zgodności z konkretną
Astrą. FSK nie jest dostępny w podstawowym firmware/generatorze.
## CC1101 packet engine
Firmware ustawia fixed-length 30 B, normal FIFO, MSB first oraz wyłącza sprzętowe:
preambułę/sync (`SYNC_MODE=0`), Manchester, whitening, FEC, CRC, address check,
append status. Cała preambuła i suma protokołu są w naszych 30 B. Koniec TX jest
oczekiwany przez `MARCSTATE=IDLE` z limitem; `TXFIFO_UNDERFLOW` i pozostałe bajty
są błędem. To zapobiega obcięciu ogona przez samo `TXBYTES=0`.
Konfiguracja została audytowana, ale syntetyczny CU8 omija CC1101. Brak dodatkowych
bajtów i dokładny ogon trzeba jeszcze potwierdzić na logic analyzer/RTL-SDR w HIL.
## Niewiadome — nie wolno ich „dostrajać” losowo
1. Znaczenie poszczególnych bitów `flags`, w tym jakiegokolwiek bitu niskiej
baterii czujnika. **`TPMS_FLAGS_LOWBAT_MASK` nie istnieje w firmware.**
2. Zależność flags od nauki, ruchu, LF i stanu baterii oryginalnego czujnika.
3. Wymagany przez konkretne ECU interwał i minimalna liczba powtórzeń.
4. Zgodność OE 13506028/numera powiązanego z konkretnym egzemplarzem bez VIN,
oznaczeń, odczytu albo testu.
5. Fizyczna dokładność częstotliwości, moc i ogon generowanego CC1101 przed HIL.
Niskie zasilanie emulatora jest wyłącznie ostrzeżeniem w konsoli i nie zmienia
żadnego pola symulowanego czujnika.
+42
View File
@@ -0,0 +1,42 @@
# Bezpieczeństwo i ograniczenia
## Sztuczne dane mogą ukryć usterkę
To urządzenie generuje dane, których nie mierzy w oponach. Domyślne 260 kPa jest
wartością testową, nie potwierdzeniem ciśnienia. Symulator może spowodować, że
kontrolka nie ostrzeże o realnym przebiciu, utracie ciśnienia lub uszkodzeniu opony.
- Projekt wyłącznie diagnostyczno-warsztatowy, na postoju i pod kontrolą osoby
wykonującej test.
- Nie jest homologowanym czujnikiem ani zamiennikiem sprawnego TPMS.
- Nie używaj w jeździe drogowej i nie przedstawiaj jako bezpiecznego do tego celu.
- Przed i po teście sprawdź wszystkie opony niezależnym manometrem oraz ich stan.
- Po diagnozie przywróć sprawne, właściwie dobrane czujniki i wykonaj wymaganą
procedurę pojazdu.
## Radio i zgodność pojazdu
Profil EG53MA4/OOK 433,92 MHz jest hipotezą roboczą dla wskazanego pojazdu do
potwierdzenia. OE 13506028, numer powiązany lub oferta zamiennika nie wystarcza.
Użyj VIN, oznaczeń fabrycznych czujników, diagnostyki albo kontrolowanego testu.
Nie nadawaj z maksymalną mocą „dla pewności”. Zacznij od −10 dBm, ogranicz czas
transmisji i przestrzegaj lokalnych przepisów dotyczących 433 MHz oraz ingerencji
w elektronikę pojazdu. Urządzenie może być odbierane przez inne odbiorniki w pobliżu.
## Montaż
- Tylko prototyp laboratoryjny jest opisany jako gotowy do złożenia. Wersja 12 V
wymaga osobnego projektu i testów automotive.
- Nie podawaj 12 V na GPIO/ADC ani 5 V na CC1101.
- Nie umieszczaj urządzenia w strefie poduszek, pedałów, ruchomych elementów,
wilgoci, wysokiej temperatury ani przy instalacji LPG.
- Zabezpiecz obudowę i przewody przed poluzowaniem. Unikaj ekranowania anteny.
- Nie używaj 18650 jako rekomendowanego zasilania w kabinie.
## Diagnostyka bez fałszywej pewności
Poprawne dekodowanie przez rtl_433 nie dowodzi odbioru przez samochód. Zielone CI
nie zastępuje pomiaru CC1101, testu HIL ani kontroli opon. Zgaśnięcie kontrolki
również nie dowodzi, że opony są sprawne. Zapisuj pomiary i nie zmieniaj wielu
parametrów naraz. Brak potwierdzonego bitu niskiej baterii czujnika; niskie
zasilanie emulatora nie jest kodowane jako usterka symulowanego czujnika.
+102
View File
@@ -0,0 +1,102 @@
# Konfiguracja i uruchomienie
## Przed rozpoczęciem
1. Sprawdź zgodność konkretnego auta (VIN, oznaczenia czujników, diagnostyka lub
odbiór). Nie polegaj wyłącznie na numerze z ogłoszenia.
2. Zmontuj prototyp z `HARDWARE.md`, wgraj firmware i otwórz UART 115200.
3. Wpisz `stay 300`. `info` pokazuje konfigurację aktywną, nie tylko zapisaną.
4. Pracuj na postoju. Sztuczne 260 kPa nie opisuje rzeczywistych opon.
Koła: `1=FL` przód lewy, `2=FR` przód prawy, `3=RR` tył prawy, `4=RL` tył lewy.
Komendy konfiguracyjne automatycznie zapisują NVS i weryfikują odczyt. Błąd NVS
trzeba rozwiązać przed dalszym testem, nie ignorować.
## Ścieżka A — Clone IDs (preferowana)
Użyj jej, jeśli wcześniej odczytano oryginalne ID i auto nadal je zna.
1. Zapisz cztery ID w postaci sześciu cyfr hex.
2. Wpisz kolejno (przykładowe wartości zastąp własnymi):
```text
id 1 2FC871
id 2 2EAAF9
id 3 3495AC
id 4 2FC780
pressure all 260
info
```
3. Sprawdź w `info`, że wszystkie ID i przypisania kół są właściwe. Duplikat,
`000000`, `FFFFFF` lub wartość poza 24 bitami zostanie odrzucona.
4. Opcjonalnie `send` wymusi cykl wszystkich kół. W NORMAL urządzenie robi to
również automatycznie; po restarcie konfiguracja pozostaje.
5. Potwierdź odbiór zewnętrznie. Znane ID **mogą** wyeliminować naukę, ale nie
obiecujemy tego dla każdego stanu ECU.
Nie używaj przykładowych ID w pojeździe, jeśli mogą pokrywać się z innym
urządzeniem w pobliżu.
## Ścieżka B — New IDs + LEARN
### Przygotowanie
1. `ids new` generuje cztery unikalne ID. Można zamiast tego użyć czterech `id`.
2. `info` — zapisz ID na kartce.
3. Zapoznaj się z procedurą nauki dla konkretnej wersji nadwozia/wyposażenia.
Ten dokument nie zgaduje menu, sekwencji pedałów ani położenia odbiornika.
4. Rozpocznij procedurę nauki w aucie zgodnie z instrukcją serwisową.
### Nauka z konsoli
1. `mode learn` — start od FL; tylko FL nadaje co 2 s.
2. `send` — natychmiastowy burst FL, bez zmiany koła.
3. Po wykonaniu kroku dla FL: `next` — FR; LED wskaże 2 mrugnięcia.
4. Powtórz `send`, potem `next` — RR, następnie `next` — RL.
5. Po ostatnim `next` urządzenie wraca do NORMAL. Kolejność to zawsze
**FL → FR → RR → RL**.
6. Zakończ procedurę auta zgodnie z jej instrukcją i sprawdź odczyt diagnostyczny.
### Nauka jednym przyciskiem
- wejście: przytrzymaj ≥1,5 s;
- krótkie naciśnięcie: następne koło i natychmiastowy burst;
- wymuszenie bez zmiany koła: konsola `send`;
- wyjście przed końcem: ponownie ≥1,5 s albo `mode normal`.
Timeout 60 s na koło przerywa LEARN do NORMAL; limit całej sesji to 15 min.
Nie jest to automatyczny sukces nauki — trzeba zacząć od właściwego koła ponownie.
## SINGLE / diagnostyka
`mode single 2` nadaje tylko FR co 2 s. `send` wymusza FR, `next` przechodzi dalej.
`mode normal` kończy; automatyczny limit wynosi 5 min. Tryb nie zapisuje wyboru
koła w NVS i po utracie zasilania startuje bezpiecznie w NORMAL.
## Pozostałe ustawienia
| Komenda | Zakres / skutek |
|---|---|
| `pressure all 260` | 0–637,5 kPa, kwantyzacja 2,5 kPa |
| `temp all 23` | −40…85 °C; w ramce °F |
| `interval normal 30` | interwał bez ACC, 5–86400 s |
| `interval ignition 30` | z aktywnym sprzętowym ACC |
| `interval parking 120` | bez aktywnego ACC |
| `rf freq 433.92` | 433,05–434,79 MHz; zmiana wymaga uzasadnienia |
| `rf power -10` | −30, −20, −15, −10, −6, 0, 5 dBm |
| `rf burst 3` | 1–8 ramek na koło |
| `rf gap 50` | 20–500 ms między ramkami |
| `flags 4C900070` | eksperyment; znaczenie bitów nie jest znane |
| `factory YES` | kasuje własną konfigurację i przywraca domyślną |
Parametry harmonogramu są eksperymentalne. Moc zaczyna się od −10 dBm; zwiększaj
tylko po pomiarze i z uwzględnieniem przepisów. Niski poziom zasilania emulatora
nie ustawia żadnej flagi czujnika.
## Po restarcie lub brownout
Firmware ponownie czyta NVS. Poprawna wersja/CRC i zakresy są wymagane. Uszkodzony
lub niezgodny wpis powoduje komunikat i powrót do domyślnych, a nie wysyłanie
częściowo uszkodzonej konfiguracji. Każdy deep sleep ma budzik; nie ma trybu
`PARKING_SHUTDOWN`, który mógłby zostawić auto bez transmisji do ręcznego wybudzenia.
+37
View File
@@ -0,0 +1,37 @@
# Rozwiązywanie problemów
Pracuj po jednej zmianie i zapisuj pomiar. Nie przełączaj losowo OOK/FSK, flags,
ID ani interwałów. Podstawowy firmware nie ma trybu FSK.
| Objaw | Możliwa przyczyna | Pomiar / sprawdzenie | Naprawa |
|---|---|---|---|
| `BLAD: brak CC1101` | złe zasilanie, CS/SPI, moduł nie 433 MHz | 3,3 V na VCC-GND; ciągłość 18/19/23/5; oznaczenie modułu | popraw okablowanie, skróć SPI, użyj właściwego modułu |
| Reset przy TX | spadek 3,3 V, słabe przewody | napięcie przy ESP32/CC1101 podczas `send`, log brownout | popraw zasilacz i 47–100 µF przy module; nie zwiększaj PA |
| `TX-ERR` | underflow, niezakończony TX, zła konfiguracja CC1101 | log dla każdego koła; MARCSTATE/rejestry w HIL | sprawdź SPI i zasilanie; zapisz log do analizy, nie maskuj błędu |
| UART nie odpowiada | za krótkie okno konsoli, zły baud/port | 115200 8N1, reset, właściwy /dev/ttyUSB | wpisz `stay 300` od razu po starcie |
| Zmiana ID znika | błąd zapisu NVS, pełny flash | komunikat `OK: zapisano`, restart i `info` | nie kontynuuj przy błędzie NVS; sprawdź flash/zasilanie |
| ID odrzucone | duplikat, 0, FFFFFF, zła długość | sześć cyfr hex i `info` | nadaj cztery unikalne ID z 000001–FFFFFE |
| rtl_433 nic nie dekoduje | antena, częstotliwość, zły tor RF, zbyt mała moc | `send 1`; odbiornik 433,92 MHz blisko; pomiar ANT/GDO0 | popraw antenę/zasilanie; stopniowo testuj niskie moce; nie zmieniaj na FSK |
| rtl_433 widzi złe dane | stara konfiguracja, sąsiedni czujnik | `info`, `hex 1`, filtrowanie ID w odbiorniku | porównaj ID i wymuś `send 1` w izolowanym miejscu |
| Auto nie widzi znanych ID | niepotwierdzony profil, ECU wymaga nauki, zasięg | VIN/oznaczenia/DTC; odbiór RTL-SDR przy aucie | potwierdź profil; wykonaj LEARN; zmień położenie po pomiarze |
| LEARN stoi na jednym kole | użyto `send` zamiast `next` | `info` pokazuje aktywne koło | `next` po potwierdzeniu kroku; `send` tylko wymusza TX |
| LEARN wróciło do NORMAL | 60 s na kole / 15 min sesji | czas od wejścia, komunikat i LED | uruchom `mode learn 1` i powtórz świadomie od FL |
| Po RL nie ma następnego koła | sekwencja została zakończona | NORMAL w `info` | zakończ procedurę auta i sprawdź DTC |
| Kontrolka nie gaśnie mimo RTL-SDR OK | ECU nie zna ID, inny profil/flags/procedura | odczyt ID i DTC z diagnostyki, nie tylko SDR | Clone IDs albo LEARN; potwierdź profil auta; nie zgaduj flags |
| Pobór snu duży | DevKit, regulator, LED, dzielniki | pomiar całej płytki wg `POWER.md` | goły moduł i właściwy zasilacz; nie zmieniaj protokołu |
| Po postoju brak TX | brownout, zasilanie, błąd NVS/CC1101 | log po restarcie, `batt`, `info`, budzik RTC | popraw zasilanie; każdy sen ma RTC, więc nie „naprawiaj” przez PARKING_SHUTDOWN |
| ACC nie zmienia interwału | funkcja domyślnie wyłączona lub zły próg | `PIN_ACC`, napięcie na GPIO OFF/ON | zmontuj zabezpieczone wejście; nigdy 12 V na GPIO |
## Gdy brak odbioru w samochodzie
Kolejność diagnostyczna:
1. **Udowodnij lokalny TX:** `send 1` + RTL-SDR/analizator.
2. **Udowodnij właściwy profil:** VIN, oznaczenia czujników, odczyt auta.
3. **Sprawdź ID i kolejność:** `info`, Clone IDs albo jeden aktywny w LEARN.
4. **Sprawdź zasięg:** niska moc najpierw, konsola/za schowkiem, ewentualnie
bagażnik; bez demontażu poduszek i zgadywania lokalizacji ECU.
5. **Dopiero analizuj flags:** porównaj z nagraniem oryginalnego czujnika tego
samego trybu. Brak potwierdzonego bitu low battery — nie ustawiaj go.
6. Jeśli nie ma pomiaru lub danych, zatrzymaj test. Losowe zmiany tworzą nowe
zmienne i nie stanowią diagnozy.
+125
View File
@@ -0,0 +1,125 @@
# Walidacja
## Jedno polecenie bez sprzętu
```bash
bash tools/check_all
```
Skrypt wykonuje self-test Pythona, testy native, pełny build ESP32, cppcheck,
pobranie przypiętych źródeł (przy pierwszym uruchomieniu) oraz dekodowanie CU8
przez prawdziwy `rtl_433`. Logi: `artifacts/validation/`. Każdy etap ma `pipefail`,
a błąd kończy skrypt kodem niezerowym.
Alternatywa reprodukowalna:
```bash
docker build -t tpms-rc .
docker run --rm -v "$PWD/artifacts:/work/artifacts" tpms-rc
```
## Wyniki z 2026-10-27
Środowisko: Linux, Python 3.14.4 przy teście hosta; PlatformIO 6.1.18;
espressif32 8.0.0; Arduino ESP32 3.3.12; SmartRC CC1101 commit
`de6757ef633b3e626dae5c7835cdb66ab53f9a1d`; rtl_433 commit `406f9a3…`;
rtl_433_tests commit `1aa8c29…`. Pełne SHA znajdują się w `PROTOCOL.md`.
| Komenda | Wynik |
|---|---|
| `pio test -e native` | **20/20 PASS** — ramka, cztery niezależne wektory, negatywne, NVS, fake clock/radio, Clone IDs, LEARN, SINGLE, ACC, restart |
| `pio run -e esp32dev` | **PASS**, własne ostrzeżenia traktowane jako błędy (`-Werror`) |
| `pio check -e native ... --fail-on-defect=low` | **PASS**, 0 defektów po poprawce inicjalizacji struktur |
| `python3 tools/tpms_frame.py --self-test` | **PASS**, nagranie + 500 ramek |
| `tools/verify_rtl433.sh` | **PASS**, 64/64 rekordy referencyjne; 3/3 syntetyczne; 3/3 negatywne odrzucone |
| `git diff --check` | **PASS** |
| dwa czyste `tools/package_release.sh` | **PASS**, identyczne wszystkie 6 SHA-256 po ustawieniu `SOURCE_DATE_EPOCH=1761600000` |
Dane referencyjne: każdy z `gfile001`…`gfile004` dał dokładnie 16 zgodnych
rekordów, z oczekiwanym ID/flags/ciśnieniem/temperaturą. Syntetyczne ramki
2FC871/260 kPa/73 F, 3495AC/220 kPa/23 F i ABCDEE/262,5 kPa/75 F zostały
zdekodowane przez niezależny `rtl_433`. Uszkodzony Manchester, zła suma i ucięcie
nie dały rekordu EG53MA4.
## Macierz pokrycia
| Warstwa | Automatyczne | RTL-SDR fizyczny | CC1101 fizyczny | Samochód |
|---|---|---|---|---|
| pola, checksum, kwantyzacja | wykonane | niepotrzebne do pola | niepotrzebne | potwierdzenie interpretacji ECU |
| Manchester/preambuła/długość | wykonane | **niewykonane** | **niewykonane** | niewykonane |
| prawdziwe nagrania → rtl_433 | wykonane, 64/64 | nie dotyczy | nie dotyczy | nie dotyczy |
| syntetyczne CU8 → rtl_433 | wykonane | nie dotyczy | omija hardware | nie dotyczy |
| rejestry CC1101/ogon/moc/częstotliwość | audyt kodu | wymagane | **wymagane** | wymagane |
| NVS, ID, interwały, tryby | wykonane; NVS emulowane blobem | wymagany test restartu | wymagany | wymagany |
| LEARN FL→FR→RR→RL | state-machine PASS | pomocnicze | wymagane | **niewykonane** |
| pobór/brownout/ACC | state-machine ACC; brak pomiarów | nie dotyczy | wymagane | wymagane |
**Brak podstaw do oznaczenia „validated”.** Gitea Actions ma workflow, ale stan
runnera i wynik zdalnego CI należy sprawdzić; lokalny PASS nie jest udawanym CI.
## Checklista HIL — wymaga użytkownika i sprzętu
### CC1101 + analizator/RTL-SDR
- [ ] Odczytać rejestry po inicjalizacji: OOK, 433,92 MHz, fixed 30 B,
`SYNC_MODE=0`, brak CRC/Manchester/whitening/FEC/append.
- [ ] Na GDO0/ANT potwierdzić dokładnie 30 B, chip ~120 µs, pełny ostatni chip
i brak sprzętowej preambuły/sync/CRC/dodatkowych bajtów.
- [ ] Zanotować TX-ERR/underflow; przy prawidłowym torze ma ich nie być.
- [ ] Zmierzyć częstotliwość i względną moc dla −10 dBm; nie zakładać kalibracji
taniego modułu. Nie zwiększać PA bez potrzeby.
- [ ] `send 1`…`send 4`: RTL-SDR dekoduje właściwe ID, 260 kPa i flags.
- [ ] Powtórzyć po resecie i 10 cyklach deep sleep.
### NVS i wejścia
- [ ] Ustawić własne ID/ciśnienia/RF, odłączyć zasilanie na >1 min, ponownie
sprawdzić `info` i transmisję.
- [ ] Sprawdzić odrzucenie duplikatu ID, złej mocy i złego interwału.
- [ ] `factory YES` przywraca 260 kPa i domyślne RF.
- [ ] Brownout/crank na zabezpieczonym zasilaczu: brak zawieszenia i uszkodzenia
konfiguracji; zapis wykonywać tylko po stabilizacji zasilania.
- [ ] Jeśli ACC jest montowane: zmierzyć napięcie na GPIO dla OFF/ON/przepięcia,
sprawdzić interwały i samoczynne wznowienie po ACC ON. Bez ACC pominąć.
### Konkretny Opel Astra J
- [ ] Potwierdzić profil przez VIN/oznaczenia/diagnostykę przed nadawaniem.
- [ ] Clone IDs: odbiór czterech znanych ID bez zakładania, że nauka zniknie.
- [ ] New IDs: pełna nauka FL→FR→RR→RL z jednym aktywnym kołem.
- [ ] Odczyt DTC i danych TPMS przed/po; zapisać wersję ECU i procedurę.
- [ ] Test położenia: konsola środkowa/za schowkiem, ewentualnie bagażnik;
na postoju, bez zgadywania lokalizacji odbiornika.
- [ ] Kontrola manometrem wszystkich opon przed i po. Nie wykonywać testu jako
jazdy drogowej z symulatorem zamiast sprawnego TPMS.
## Artefakty i wgrywanie
```bash
bash tools/package_release.sh
```
Katalog `artifacts/release/`:
| Plik | Adres |
|---|---:|
| `bootloader.bin` | `0x1000` |
| `partitions.bin` | `0x8000` |
| `boot_app0.bin` | `0xE000` |
| `firmware.bin` | `0x10000` |
| `firmware-full.bin` | `0x0` — pełny obraz 4 MB |
| `firmware.elf` | debug/symbole, nie wgrywać jako flash |
| `SHA256SUMS`, `BUILD-INFO.txt` | kontrola integralności i wersji |
Pełny obraz kasuje poprzedni flash przy zapisie całego obszaru; NVS w partycji
może zostać utracone — zapisz ID przed aktualizacją pełnym obrazem. Aktualizacja
samej aplikacji `firmware.bin` pod `0x10000` zwykle zachowuje NVS, ale przed
release użytkownik powinien wykonać test na własnym module.
```bash
PORT=/dev/ttyUSB0 bash tools/flash_release.sh
sha256sum -c artifacts/release/SHA256SUMS
```
Nie wgrywaj obrazu z innego toolchaina na ślepo. RC nie zawiera fizycznego testu
update ani samochodu.