Dokumentacja: Quick Start bezpieczenstwo protokol HIL i RC
check / check-without-hardware (push) Canceled after 0s
check / check-without-hardware (push) Canceled after 0s
This commit is contained in:
1 parent
17d2cea3ea
commit
1fdb0c7cce
13 files changed
+1195
-664
No files matched your search
@@ -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”.
|
||||
@@ -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.
|
||||
@@ -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.
|
||||
@@ -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.
|
||||
@@ -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
@@ -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.
|
||||
@@ -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.
|
||||
@@ -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.
|
||||
Reference in new issue
Block a user