Docs and code: translate Polish comments, messages and documentation to English
check / check-without-hardware (push) Successful in 6m45s

- README, CHANGELOG, RELEASE_NOTES, THIRD_PARTY_NOTICES and docs/*.md
  translated to English; cross-markdown anchors updated
- C/C++/Python/shell comments and user-facing messages translated
- identifiers, protocol names, commands and literals unchanged
- native tests re-verified: 24/24 PASS; tpms_frame.py self-test PASS
This commit is contained in:
czcionka committed 2026-10-30 18:01:32 +00:00
1 parent 1563e34d05
commit e183d23950
42 files changed
+1106 -1019

No files matched your search

+30 -29
View File
@@ -1,33 +1,34 @@
# Rejestr audytu release-v2
# Release-v2 audit register
| Priorytet | Problem początkowy | Kryterium naprawy | Stan / dowód |
| Priority | Original problem | Repair criteria | Status / evidence |
|---|---|---|---|
| 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 |
| P1 | Pull-up cyfrowy przycisku/LF nie działa w deep sleep (EXT1, RTC_PERIPH off) | pociągnięcia RTC + HOLD przed snem | naprawione w power.cpp; HIL budzenia otwarte |
| P1 | `nan` przechodził walidację konsoli (cisnienie/RF) i trafiał do NVS | odrzucanie NaN/inf + testy native | naprawione; `parse` + test_parse |
| P2 | Dzielnik ADC nasycany powyżej ~11,8 V — brak odczytu 12–14,4 V | zakres do ~16 V | naprawione config.h (R2 180 kΩ); wymaga pomiaru |
| P2 | Pełny obraz release z `40m` vs nagłówek builda `80m` | zgodność parametrów flash | naprawione package_release.sh; weryfikacja headera |
| P2 | Model Pythona bez saturacji temperatury (roznica z C++) | clamp 0–255 + self-test | naprawione tpms_frame.py |
| P3 | Ujemny test checksum ćwiczył Manchester zamiast sumy | odwrócenie całej komórki | naprawione test_tpms_frame |
| P3 | Błędne offsety bitów w diagramie PROTOCOL.md | poprawne 72/96/104/112/120 | naprawione |
| P1 | Skala pola ciśnienia `P` (2,5 kPa/bit) niezweryfikowana — wszystkie nagrania mają `P=0`, auto pokazuje 284 kPa dla 260 kPa | kalibracja z wyświetlaczem auta, poprawa przelicznika i testów | naprawione; korekta skalująca 2,73 kPa/bit (`P=95` dla 260 kPa), HIL: 260 kPa → 260 kPa na wyświetlaczu; drugi punkt pomiarowy (np. 300 kPa) potwierdziłby liniowość w zakresie |
| P0 | Guessed low-battery bit dependent on the emulator supply | no mask and no coupling; flags test | fixed; code grep and 20/20 native |
| P0 | MCP1703 + 24 V TVS described as automotive protection | remove the recommendation; requirements and a datasheet example | fixed in HARDWARE |
| P0 | Lack of physical compatibility evidence with the car presented too confidently | RC, explicit HIL, VIN/marking verification | documentation fixed; HIL still open |
| P1 | IDs/pressures/RF only via recompilation | NVS with a console, validation, version/CRC | fixed; test_settings and build |
| P1 | Monolith prevented testing timeouts/ACC | portable state machine, fake clock/radio | fixed; test_app_state |
| P1 | FSK in the base flow without evidence | OOK only in firmware/generator | fixed |
| P1 | PARKING_SHUTDOWN without a guaranteed ACC wake | remove it or guarantee waking | removed; every sleep has RTC |
| P1 | TX ended on time and TXBYTES, tail risk | MARCSTATE/underflow/limit | improved; requires HIL confirmation |
| P1 | Vectors mostly self-authored | four real recordings + independent rtl_433 | 64/64 PASS |
| P2 | Default LF without a validated front end | disabled by default, LEARN without LF | fixed |
| P2 | Intervals presented as OE | explicitly experimental | PROTOCOL/SETUP/POWER |
| P2 | No full single check/build artifacts | check_all, CI, Docker, package_release | added; results in VALIDATION |
| P2 | A console window after every RTC wake raises consumption | sleep right after the RTC cycle | improved; HIL measurement open |
| P2 | README inconsistent with behaviour | new Quick Start, one UI table | rewritten |
| P1 | Digital pull-up of button/LF does not work in deep sleep (EXT1, RTC_PERIPH off) | RTC pulls + HOLD before sleep | fixed in power.cpp; HIL wake still open |
| P1 | `nan` passed console validation (pressure/RF) and reached NVS | rejecting NaN/inf + native tests | fixed; `parse` + test_parse |
| P2 | ADC divider saturating above ~11.8 V — no 12–14.4 V reading | range up to ~16 V | fixed in config.h (R2 180 kΩ); requires measurement |
| P2 | Full release image with `40m` vs build header `80m` | flash parameter consistency | fixed in package_release.sh; header verification |
| P2 | Python model without temperature saturation (discrepancy with C++) | clamp 0–255 + self-test | fixed in tpms_frame.py |
| P3 | Negative checksum test exercised Manchester instead of the sum | invert the whole cell | fixed in test_tpms_frame |
| P3 | Wrong bit offsets in the PROTOCOL.md diagram | correct 72/96/104/112/120 | fixed |
| P1 | Scale of the pressure field `P` (2.5 kPa/bit) unverified — all captures have `P=0`, the car shows 284 kPa for 260 kPa | calibrate against the car display, fix the conversion and tests | fixed; scaling correction 2.73 kPa/bit (`P=95` for 260 kPa), HIL: 260 kPa → 260 kPa on the display; a second measurement point (e.g. 300 kPa) would confirm linearity in range |
## Otwarte, wymagające sprzętu
## Open, requiring hardware
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”.
These cannot be closed by declaration: CC1101/tail/power/frequency
measurement, an RTL-SDR test with an antenna, consumption and brownout,
protected ACC, a Clone IDs/LEARN test with the specific Astra, and the design
and testing of automotive power. They are the checklist in `VALIDATION.md`
and they block the "validated" status.
+142 -131
View File
@@ -1,173 +1,184 @@
# Sprzęt i montaż
# Hardware and assembly
## Zakres
## Scope
Podstawowy release opisuje **prototyp laboratoryjny na ESP32-S2-MINI**
(ESP32-S2FN4R2). Przewody prototypowe i LM317T nie są gotowym zestawem do
trwałego montażu w samochodzie. Wariant z gniazdem zapalniczki poniżej jest
listą połączeń i wymagań projektowych, nie zwalidowanym schematem automotive.
The base release describes a **laboratory prototype on the ESP32-S2-MINI**
(ESP32-S2FN4R2). Prototype wires and the LM317T are not a ready kit for
permanent installation in a car. The cigarette-lighter socket variant below
is a list of connections and design requirements, not a validated automotive
schematic.
## BOM prototypu laboratoryjnego
## Laboratory prototype BOM
| Element | Wymaganie | Uwagi |
| Item | Requirement | Notes |
|---|---|---|
| ESP32-S2-MINI | ESP32-S2FN4R2 (4 MB flash, 2 MB PSRAM), natywne USB do flash/konsoli; płytka typu Lolin/Wemos S2 Mini, np. ARD-ESP32-S2-MINI | sprzedawana z MicroPythonem — wgrywamy własny firmware; klon trzeba sprawdzić przed zasileniem |
| CC1101 | moduł **433 MHz**, SPI, 3,3 V, ze złączem SMA i anteną, np. ARD-CC1101-ANT | nie kupuj wersji 868/915 MHz |
| Antena 433 MHz | dołączona do modułu SMA; na biurko monopol λ/4 ≈ 17 cm | uziemienie/przeciwwaga zgodnie z konstrukcją modułu |
| Przycisk NO (opcjonalny) | monostabilny | GPIO3 do GND; bez dodatkowego przycisku służy przycisk BOOT płytki (GPIO0) |
| LED | wbudowana na GPIO15 | aktywna stanem wysokim; zewnętrzna LED nie jest potrzebna |
| Ładowarka samochodowa USB | gniazdo zapalniczki → USB 5 V | wariant A zasilania; sprawdzona, z kablem USB-C z danymi |
| LM317T | TO-220 (metal), regulowany 1,25–37 V, 1,5 A | tylko dla wariantu B; nie jest potrzebny przy zasilaniu z USB |
| Rezystory LM317T | R1 = 240 Ω (VOUT–ADJ), R2 = 390 Ω (ADJ–GND) | dają ok. 3,28 V; 1% metalizowane, blisko układu |
| Kondensatory LM317T | 100 nF na wejściu i min. 1 µF na wyjściu | praktycznie 10 µF; blisko układu |
| Radiator | dla LM317T przy zasilaniu z 12–14,4 V | patrz obliczenia termiczne niżej |
| Odsprzężenie modułów | 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 albo LM317T z bezpiecznego VIN | nie podawaj jednocześnie rywalizujących źródeł 3,3 V |
| ESP32-S2-MINI | ESP32-S2FN4R2 (4 MB flash, 2 MB PSRAM), native USB for flash/console; a Lolin/Wemos S2 Mini type board, e.g. ARD-ESP32-S2-MINI | sold with MicroPython — we flash our own firmware; verify a clone before powering it |
| CC1101 | **433 MHz** module, SPI, 3.3 V, with an SMA connector and antenna, e.g. ARD-CC1101-ANT | do not buy the 868/915 MHz version |
| 433 MHz antenna | supplied with the SMA module; for a bench, a λ/4 monopole ≈ 17 cm | ground plane/counterweight per the module's design |
| NO button (optional) | momentary | GPIO3 to GND; without an extra button the board's BOOT button (GPIO0) is used |
| LED | built-in on GPIO15 | active high; an external LED is not needed |
| Car USB charger | cigarette-lighter socket → USB 5 V | power variant A; tested, with a USB-C cable that carries data |
| LM317T | TO-220 (metal), adjustable 1.25–37 V, 1.5 A | only for variant B; not needed when powering from USB |
| LM317T resistors | R1 = 240 Ω (VOUT–ADJ), R2 = 390 Ω (ADJ–GND) | give about 3.28 V; 1% metal-film, close to the device |
| LM317T capacitors | 100 nF on the input and at least 1 µF on the output | practically 10 µF; close to the device |
| Heatsink | for the LM317T when fed from 12–14.4 V | see the thermal calculations below |
| Module decoupling | 100 nF at each module + 47–100 µF at the CC1101 | as close to the supply pins as possible |
| Wires | short, common ground | SPI best under 10 cm |
| Laboratory supply | USB 5 V or the LM317T from a safe VIN | do not feed competing 3.3 V sources at the same time |
Do diagnozy RF przydaje się RTL-SDR, ale nie jest częścią emulatora. Standardowy
S2 Mini ma niebieską LED na GPIO15 i przycisk BOOT na GPIO0; przed montażem
sprawdź konkretny klon, bo nazwy handlowe bywają używane dla różnych płytek.
RTL-SDR is useful for RF diagnosis but is not part of the emulator. The
standard S2 Mini has a blue LED on GPIO15 and a BOOT button on GPIO0; before
assembly verify the specific clone, because trade names are sometimes used
for different boards.
## Pinout i połączenia
## Pinout and connections
| ESP32-S2-MINI | CC1101 / element | Zasada |
| ESP32-S2-MINI | CC1101 / item | Rule |
|---|---|---|
| 3V3 | CC1101 VCC; wyjście LM317T przy zasilaniu zewnętrznym | **tylko 3,3 V**, nigdy wyjście 5 V ani LM317T ustawionego wyżej |
| GND | CC1101 GND, przycisk, dzielnik LM317T | wspólna masa |
| 3V3 | CC1101 VCC; LM317T output when externally powered | **3.3 V only**, never the 5 V pin nor an LM317T set higher |
| GND | CC1101 GND, button, LM317T divider | common ground |
| GPIO4 | SCK/SCLK | SPI |
| GPIO5 | MISO/SO | SPI |
| GPIO6 | MOSI/SI | SPI |
| GPIO7 | CS/CSn/SS | SPI |
| GPIO10 | GDO0 | diagnostyka biblioteki; GDO2 niepodłączony |
| GPIO3 | alternatywny przycisk NO do GND (`-DPIN_BUTTON=3`) | pull-up RTC włączany przez firmware przed deep sleep (pull-up cyfrowy nie działa w deep sleep); RTC GPIO wakeup, zalecany zewnętrzny 10 kΩ |
| GPIO15 | wbudowana LED | aktywna HIGH, firmware steruje właściwą polaryzacją |
| GPIO1 | opcjonalny ADC zasilania przez dzielnik | `PIN_VBAT_ADC`, ADC1_CH0; dzielnik 1 MΩ/180 kΩ (`config.h`), zakres do ok. 16 V; nigdy 12 V wprost |
| GPIO2 | opcjonalne ACC po zmianie `PIN_ACC` i zabezpieczeniu | nigdy 12 V wprost |
| GPIO14 | opcjonalny detektor LF po zmianie `PIN_LF_TRIGGER` | aktywny LOW; RTC GPIO wakeup, domyślnie wyłączone |
| GPIO0 | przycisk BOOT płytki = przycisk sterujący i budzenie RTC (domyślne `PIN_BUTTON`) | pin strapping: trzymany przy zasilaniu/reset uruchamia bootloader zamiast firmware (potwierdzone działanie budzenia na sprzęcie); nie używać do CC1101 |
| GPIO10 | GDO0 | library diagnostics; GDO2 unconnected |
| GPIO3 | alternative NO button to GND (`-DPIN_BUTTON=3`) | RTC pull-up enabled by the firmware before deep sleep (a digital pull-up does not work in deep sleep); RTC GPIO wakeup, an external 10 kΩ recommended |
| GPIO15 | built-in LED | active HIGH; the firmware drives the correct polarity |
| GPIO1 | optional supply ADC through a divider | `PIN_VBAT_ADC`, ADC1_CH0; 1 MΩ/180 kΩ divider (`config.h`), range up to about 16 V; never 12 V directly |
| GPIO2 | optional ACC after changing `PIN_ACC` and protecting it | never 12 V directly |
| GPIO14 | optional LF detector after changing `PIN_LF_TRIGGER` | active LOW; RTC GPIO wakeup, disabled by default |
| GPIO0 | the board's BOOT button = the control button and RTC wake (default `PIN_BUTTON`) | strapping pin: held at power-up/reset it starts the bootloader instead of the firmware (wake behaviour confirmed on hardware); do not use for the CC1101 |
GPIO0, GPIO45 i GPIO46 są pinami strapping. Nie dokładaj do nich zewnętrznych
rezystorów ani układów wymuszających stan podczas resetu. GPIO19/20 obsługują
natywne USB, a GPIO26–32 w ESP32-S2FN4R2 obsługują flash i PSRAM w obudowie —
nie używaj ich. GPIO33–40 pozostają wolne; konsola korzysta z natywnego USB,
więc zewnętrzny mostek USB-UART nie jest potrzebny.
GPIO0, GPIO45 and GPIO46 are strapping pins. Do not add external resistors or
state-forcing circuits to them during reset. GPIO19/20 carry native USB, and
GPIO26–32 in the ESP32-S2FN4R2 serve the in-package flash and PSRAM — do not
use them. GPIO33–40 remain free; the console uses native USB, so an external
USB-UART bridge is not needed.
Przy laboratoryjnym zasilaniu 3,3 V przez LM317T: zacznij od VIN = 5–9 V, ustaw
limit np. 0,5 A, sprawdź polaryzację i napięcie wyjściowe bez podłączonego
S2 Mini. Połącz GND, a na czas zasilania zewnętrznego odłącz USB. Prąd
szczytowy zależy od płytki i ustawionego PA.
With a laboratory 3.3 V supply from the LM317T: start with VIN = 5–9 V, set a
limit of e.g. 0.5 A, check the polarity and output voltage without the S2
Mini connected. Join the grounds, and disconnect USB while externally powered.
Peak current depends on the board and the configured PA.
## LM317T — wyprowadzenia, dzielnik i kondensatory
## LM317T — pinout, divider, and capacitors
Dla **LM317T w TO-220**, patrząc na oznaczenia od przodu z nóżkami w dół:
For the **LM317T in TO-220**, looking at the markings from the front with the
legs pointing down:
| Nóżka | Funkcja | Połączenie |
| Leg | Function | Connection |
|---:|---|---|
| 1 | ADJ | dzielnik: R1 do VOUT, R2 do GND |
| 2 | VOUT | 3V3 S2 Mini + VCC CC1101 |
| 3 | VIN | zabezpieczone napięcie wejściowe |
| 1 | ADJ | divider: R1 to VOUT, R2 to GND |
| 2 | VOUT | 3V3 of the S2 Mini + CC1101 VCC |
| 3 | VIN | protected input voltage |
Metalowy TAB jest połączony z **VOUT** — nie z GND jak w LF33CV czy 7805.
Radiator i obudowa TAB nie mogą dotykać masy ani innych potencjałów.
**Nie stosuj schematu nóżek 7805** — tutaj kolejność to ADJ–VOUT–IN.
The metal TAB is connected to **VOUT** — not to GND as in the LF33CV or
7805. The heatsink and TAB enclosure must not touch ground or any other
potential. **Do not use the 7805 leg scheme** — the order here is
ADJ–VOUT–IN.
Napięcie wyjściowe ustawia dzielnik: `VOUT = 1,25 V × (1 + R2/R1)`. R1 = 240 Ω
między VOUT a ADJ oraz R2 = 390 Ω między ADJ a GND dają ok. **3,28 V** i
jednocześnie obciążenie ok. 5 mA, zbliżone do minimalnego prądu obciążenia
LM317 — przy większych wartościach rezystorów zmierz VOUT bez obciążenia.
Między VIN a GND daj 100 nF. Między VOUT a GND daj min. 1 µF; praktyczny
punkt startowy to 10 µF. LM317 nie wymaga szczególnego ESR jak LDO, ale
kondensatory mają być blisko układu. Dodatkowe 100 nF przy modułach
i 47–100 µF przy CC1101 pozostają potrzebne.
The output voltage is set by the divider: `VOUT = 1.25 V × (1 + R2/R1)`.
R1 = 240 Ω between VOUT and ADJ, and R2 = 390 Ω between ADJ and GND give
about **3.28 V**, while drawing about 5 mA, close to the LM317's minimum load
current — with larger resistor values measure VOUT unloaded. Place 100 nF
between VIN and GND. Place at least 1 µF between VOUT and GND; a practical
starting point is 10 µF. The LM317 does not require special ESR like an LDO,
but the capacitors should sit close to the device. An extra 100 nF at the
modules and 47–100 µF at the CC1101 remain necessary.
Nie podłączaj VOUT LM317T do pinu **5V** S2 Mini. Pin 5V zasila wbudowany
regulator płytki, natomiast zewnętrzne, stabilizowane 3,3 V należy doprowadzić
do **3V3**. Nie zasilaj jednocześnie z USB i LM317T bez sprawdzonej separacji
źródeł, ponieważ konstrukcje klonów różnią się połączeniami zasilania.
Do not connect the LM317T VOUT to the S2 Mini's **5V** pin. The 5V pin feeds
the board's built-in regulator, whereas external, regulated 3.3 V must be
brought to **3V3**. Do not power from USB and the LM317T at the same time
without verified source separation, because clone designs differ in their
power connections.
## Antena i test położenia
## Antenna and position test
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.
We do not guess the TPMS receiver location in the Astra J. Perform the range
test while parked, at low power, comparing RTL-SDR readings/diagnostics for a
few positions: centre console, near the glovebox, possibly the boot. A result
for a single unit is not proof of the receiver location.
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 na
złącze SMA i konieczność ekranowania trzeba ocenić pomiarowo.
Mount the device mechanically, away from airbags and their harnesses, the
pedal area, moving parts, moisture, heat sources, and metal shielding. Do not
wrap the antenna in a harness, do not route it near an LPG bulb/regulator or
ignition wiring. The prototype enclosure should be non-conductive; the hole
for the SMA connector and any need for shielding must be assessed by
measurement.
## Wariant „z gniazda zapalniczki” — wymagania, niezwalidowany projekt
## Cigarette lighter socket variant — requirements, unvalidated design
Docelowe zasilanie pochodzi z gniazda zapalniczki samochodowej, na dwa sposoby:
The target power comes from the car cigarette-lighter socket, in two ways:
```text
Wariant A (prostszy):
gniazdo zapalniczki → ładowarka samochodowa USB (5 V) → kabel USB-C → USB S2 Mini
Variant A (simpler):
cigarette-lighter socket → car USB charger (5 V) → USB-C cable → S2 Mini USB
Wariant B (stabilizator):
gniazdo zapalniczki 12 V → bezpiecznik przy źródle → ochrona przed odwrotną
polaryzacją → ograniczenie energii + właściwie dobrany TVS
→ VIN LM317T → VOUT 3,3 V → 3V3 S2 Mini + VCC CC1101
Variant B (regulator):
cigarette-lighter socket 12 V → fuse at the source → reverse-polarity
protection → energy limitation + properly rated TVS
→ LM317T VIN → VOUT 3.3 V → S2 Mini 3V3 + CC1101 VCC
```
W większości aut gniazdo zapalniczki jest zasilane tylko po przekręceniu
stacyjki — **zweryfikuj to w swoim pojeździe**, bo część aut ma gniazdo
zasilane na stałe. Przy gnieździe „po stacyjce” emulator nie pobiera prądu,
gdy samochód jest wyłączony. Komputer samochodowy i tak zwykle nie odczytuje
wtedy stanu TPMS, więc brak transmisji parkingowej nie ma znaczenia.
In most cars the cigarette-lighter socket is powered only after the ignition
is switched on — **verify this in your vehicle**, because some cars have a
socket powered permanently. With an ignition-switched socket the emulator
draws no current while the car is off. The car computer usually does not read
TPMS state then anyway, so the lack of parking transmission does not matter.
Samo wyjście gniazda nadal ma przepięcia i zakłócenia instalacji pojazdu.
**Nie podłączaj go wprost do VIN LM317T jako gotowej instalacji samochodowej.**
LM317T znosi różnicę VIN−VOUT do 37–40 V, więc jest odporniejszy na przepięcia
niż LF33CV (16 V), ale ochrona nadal musi ograniczać napięcie z marginesem.
TVS o progu powyżej dopuszczalnego VIN nie stanowi ochrony LM317T.
The socket output itself still has transients and noise of the vehicle
installation. **Do not connect it directly to the LM317T VIN as a finished
car installation.** The LM317T tolerates a VIN−VOUT difference up to 37–40 V,
so it is more tolerant of transients than the LF33CV (16 V), but protection
still has to limit the voltage with margin. A TVS with a threshold above the
maximum VIN provides no protection for the LM317T.
Wymagania przed montażem (wariant B):
Requirements before installation (variant B):
- bezpiecznik dobrany do przewodów i poboru, blisko źródła; nie zastępuje TVS;
- ochrona przed odwrotną polaryzacją i ujemnymi przepięciami;
- TVS i ograniczenie energii dobrane do rzeczywistego profilu przepięć, bez
przewodzenia przy normalnym 14,4–14,8 V i bez przekraczania VIN LM317T;
- kondensatory zgodne z kartą LM317, krótkie pętle prądowe;
- pomiar szczytów prądu S2 Mini + CC1101 i sprawdzenie stabilności 3,3 V;
- obliczenia termiczne dla najwyższej temperatury oraz testy brownout/crank/load
dump, EMC i ESD na docelowej płytce.
- a fuse matched to the wiring and consumption, close to the source; it does
not replace a TVS;
- reverse-polarity and negative-transient protection;
- TVS and energy limitation matched to the real transient profile, without
conducting at a normal 14.4–14.8 V and without exceeding the LM317T VIN;
- capacitors per the LM317 datasheet, short current loops;
- a measurement of the current peaks of the S2 Mini + CC1101 and a check of
3.3 V stability;
- thermal calculations for the highest temperature and tests of
brownout/crank/load dump, EMC, and ESD on the target board.
LM317T jest regulatorem liniowym: `P = (VIN − 3,3 V) × I`. Już przy 14,4 V
i 300 mA trzeba odprowadzić ok. **3,3 W**. Bez obliczenia i radiatora TO-220
może się przegrzewać; samo „do 1,5 A” z karty nie gwarantuje zasilania szczytów
ESP32-S2 w każdych warunkach. Zmierz prąd i temperaturę przy nadawaniu.
The LM317T is a linear regulator: `P = (VIN − 3.3 V) × I`. Already at 14.4 V
and 300 mA you must dissipate about **3.3 W**. Without a calculation and a
TO-220 heatsink it can overheat; the "up to 1.5 A" from the datasheet alone
does not guarantee ESP32-S2 peak supply in all conditions. Measure current
and temperature while transmitting.
**Konsekwencja zasilania wyłącznie z gniazda zapalniczki:** po wyłączeniu
zapłonu cały emulator traci zasilanie. Nie wykonuje wtedy deep sleep ani
transmisji parkingowych, RTC nie odlicza interwału, a ustawienie
`interval parking` nie ma znaczenia. Wejście `PIN_ACC` nie jest potrzebne.
Po przekręceniu stacyjki urządzenie po prostu startuje i nadaje. Jeżeli
urządzenie ma nadawać również na postoju, potrzebne jest stale zasilane,
zabezpieczone wejście oraz osobny, zabezpieczony sygnał ACC na GPIO2. Wtedy
trzeba też zmierzyć pobór całego układu: dzielnik LM317T pobiera stale ok.
5 mA, do tego S2 Mini, CC1101 i dzielniki — może być istotny przy długim
postoju.
**Consequence of powering only from the cigarette-lighter socket:** when the
ignition goes off, the whole emulator loses power. It then performs no deep
sleep or parking transmission, the RTC does not count the interval, and the
`interval parking` setting has no effect. The `PIN_ACC` input is not needed.
After the ignition is switched on, the device simply starts and transmits. If
the device is to transmit while parked too, a permanently powered, protected
input and a separate, protected ACC signal on GPIO2 are required. Then the
consumption of the whole assembly also has to be measured: the LM317T divider
draws a constant ~5 mA, plus the S2 Mini, the CC1101, and the dividers — it
may matter on a long park.
Parametry LM317T i wymagane kondensatory: karta ST
[LM317](https://www.st.com/resource/en/datasheet/lm317.pdf), schemat
typowej aplikacji i rysunek połączeń TO-220. Dostęp: 2026-10-28.
LM317T parameters and required capacitors: the ST datasheet
[LM317](https://www.st.com/resource/en/datasheet/lm317.pdf), the typical
application schematic and the TO-220 pinout drawing. Accessed 2026-10-28.
## Zasilanie bateryjne
## Battery power
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.
An 18650 cell in the cabin is **not recommended**: the temperature in a car
can exceed the cell's safe conditions, and an installed cell requires
protection, proper charging, and an enclosure. An ESP32 with a radio and
periodic duty cycling usually gives short runtime; claims of multi-year
operation would be unfounded. A multi-year battery variant requires a
different low-power architecture and is not part of this release.
## Opcjonalny LF
## Optional 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. Wyjście front-endu na
GPIO14 ma być aktywne stanem niskim i w spoczynku wysokim. Sam aktywator nie
wpisuje ID do emulatora.
The RC works without the EL-50448. It contains no validated LF receiver. A
future module requires a separate 125 kHz resonance/detection schematic, a
comparator threshold, filtering, an interference-immunity test, and proven
waking. The front-end output on GPIO14 is to be active-low and high at rest.
The activator itself does not enter IDs into the emulator.
+77 -65
View File
@@ -1,76 +1,88 @@
# Energia i zachowanie na postoju
# Energy and parking behaviour
## Status pomiarów
## Measurement status
**Nie wykonano pomiarów prądu fizycznego prototypu.** Liczby poniżej są
szacunkami budżetu, nie wynikiem walidacji. S2 Mini nie nadaje się do deklaracji
poboru µA bez pomiaru: wbudowany regulator, LED i obwody pomocnicze zwiększają
pobór. Sam LM317T obciąża zasilanie prądem dzielnika ok. 5 mA (R1 = 240 Ω)
plus prąd własny, więc zasilanie stałe wymaga osobnego bilansu energetycznego.
Docelowe zasilanie z gniazda zapalniczki „po stacyjce” zdejmuje ten problem:
przy wyłączonym zapłonie emulator nie pobiera prądu wcale.
**No current measurements of the physical prototype have been performed.**
The numbers below are budget estimates, not validated results. The S2 Mini
is not suitable for declaring µA consumption without measurement: the built-in
regulator, LED, and auxiliary circuits add consumption. The LM317T itself
loads the supply with a divider current of about 5 mA (R1 = 240 Ω) plus its
own quiescent current, so a permanent supply needs a separate energy budget.
The target supply from an ignition-switched cigarette-lighter socket removes
this problem: with the ignition off the emulator draws no current at all.
## Harmonogram firmware
## Firmware schedule
- 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.
- Mikrodrzemki: sen jest dzielony na kawałki tak, żeby dioda migała co ok. 2 s
także między wysyłkami (`NAP_PERIOD_MS` w `config.h`). Po budzeniu timera
urządzenie pokazuje jedno widoczne mignięcie i śpi resztę okresu po czasie
boot + okno (`NAP_AWAKE_MS`). Przycisk budzi natychmiast (EXT1) niezależnie
od mikrodrzemek.
- TX ramek pozostaje co interwał (domyślnie 30 s): licznik snu w pamięci RTC
zlicza przespane kawałki od ostatniego cyklu TX; `interval` wchodzi w życie
przy następnym cyklu. Po dłuższym czuwaniu (np. `stay`) pierwszy kawałek
jest pełny.
- **Mikrodrzemki zwiększają pobór** (boot co ok. 2 s zamiast jednego snu na
interwał) — liczby poniżej opisują stary model i wymagają pomiaru HIL.
- 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. Jeżeli cały układ
zasilany jest tylko z gniazda zapalniczki „po stacyjce” lub z ACC, po ACC OFF
nie ma zasilania, RTC ani transmisji — i jest to docelowy scenariusz.
- NORMAL after the RTC wake: initialisation, a burst of four wheels, exit of
TX, and deep sleep. There is no 10-second console window after a plain wake.
- Micro-naps: sleep is split into pieces so that the LED blinks about every
2 s, also between transmissions (`NAP_PERIOD_MS` in `config.h`). After a
timer wake the device shows one visible blink and sleeps the rest of the
period after boot time + window (`NAP_AWAKE_MS`). The button wakes
immediately (EXT1) regardless of the micro-naps.
- TX of frames remains on the interval (default 30 s): the sleep counter in
RTC memory counts the slept pieces since the last TX cycle; `interval`
takes effect on the next cycle. After a longer awake period (e.g. `stay`),
the first piece is a full one.
- **Micro-naps raise consumption** (a boot about every 2 s instead of one
sleep per interval) — the numbers below describe the old model and require
HIL measurement.
- After power-on, a button, or LF: a 10 s console window; `stay N` extends it.
- LEARN: TX of one wheel every 2 s, without deep sleep, max 60 s per wheel/
15 min per session.
- SINGLE: TX of one wheel every 2 s, without deep sleep, max 5 min.
- The CC1101 enters SPWD before sleep; CS is high, SCK/MOSI low, LED off.
- Every sleep has an RTC alarm. `PARKING_SHUTDOWN` was removed — the device
cannot remain asleep until a purely manual wake.
- ACC (optional in hardware) selects the ignition/parking interval. It is not
needed as the only wake source, because the RTC always runs. If the whole
assembly is powered only from an ignition-switched lighter socket or from
ACC, then with ACC off there is no power, no RTC, and no transmission —
and that is the target scenario.
## Szacunek ładunku dla ustawień domyślnych
## Charge estimate for the default settings
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.
One frame is 240 × 120 µs = 28.8 ms on air. For 4 wheels × 3 frames:
345.6 ms of transmission plus 8 × 50 ms gaps inside the bursts. On top of
that come boot, configuration, SPI, and logging. For energy calculations you
must measure the whole cycle, not just the OOK time.
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.
An example model (to be replaced by measurement): if ESP32 activity is 1.0 s
at 80 mA every 30 s, the ESP32 alone averages about 2.7 mA at 3.3 V. The
CC1101, boot, and sleep current add further terms. With a 120 s interval the
activity share falls about fourfold, but the constant Iq of the regulator and
the dividers remains. These are not measured 2.7 mA nor a promise of
consumption from a 12 V battery.
## Metoda pomiaru wymagana przed „validated”
## Measurement method required before "validated"
1. **Cały S2 Mini 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. **S2 Mini + LM317T:** powtórzyć pomiar na zabezpieczonym wejściu VIN i na
szynie 3,3 V. Uwzględnić prąd dzielnika regulatora, TVS, pozostałe 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.
1. **The whole S2 Mini in sleep:** a µA meter in series at the input, not
through USB. Wait until TX ends and record the minimum/steady state and
the board model.
2. **S2 Mini + LM317T:** repeat the measurement on the protected VIN input
and on the 3.3 V rail. Include the regulator divider current, TVS, the
other dividers, and pull-ups.
3. **NORMAL cycle:** a shunt + oscilloscope or a logger with sufficient
bandwidth. Record boot, 12 frames, gaps, and entering sleep over at least
10 cycles.
4. **Average:** integrate the charge for at least 15 min at 30 s and 120 s.
State the conditions: voltage, temperature, PA, board and firmware
version.
5. **LEARN/SINGLE:** measure the continuous-awake current separately.
6. **ACC/brownout/crank:** check restart, the return to transmission, and NVS
integrity. Do not test on GPIO without confirmed input protection.
## Wnioski dopuszczalne przed pomiarem
## Conclusions allowed before measurement
- Największy wpływ mają interwał, czas czuwania, PA i Iq całej płytki.
- Do wersji energooszczędnej trzeba zmierzyć cały S2 Mini i LM317T; przy
zasilaniu wyłącznie z gniazda zapalniczki „po stacyjce” układ nie pobiera
prądu po wyłączeniu zapłonu, ale wtedy również nie nadaje w trybie
parkingowym — co jest zgodne z założeniem, bo ECU auta wtedy nie nasłuchuje.
- 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.
- The interval, awake time, PA, and the whole board's Iq have the largest
impact.
- A power-saving version requires measuring the whole S2 Mini and LM317T;
with power only from an ignition-switched lighter socket the assembly draws
no current after the ignition goes off, but then it also transmits no
parking mode — which matches the assumption, because the car ECU does not
listen then.
- We do not recommend an 18650 in the cabin, nor multi-year battery operation
with an ESP32.
- The emulator's constant consumption must be accounted for during a long
park; we do not give a "safe for the battery" time without measuring the
whole car.
+79 -69
View File
@@ -1,99 +1,109 @@
# Protokół Schrader EG53MA4 — fakty i niewiadome
# Schrader EG53MA4 protocol — facts and unknowns
## Przypięte źródła
## Pinned sources
| Źródło | Wersja użyta do walidacji | Zakres |
| Source | Version used for validation | Scope |
|---|---|---|
| `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 |
| `rtl_433/src/devices/schraeder.c` | commit `406f9a33550a2b6b3d0d8a8a486417ce5b3f13ab` | decoder and slicer parameters |
| `rtl_433_tests/tests/Schrader_EG53MA4_TPMS/01` | commit `1aa8c29d6b9383739d1aeed495dbc5069b704392` | four CU8 recordings + 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 |
| `espressif32` | 8.0.0 | toolchain/ESP32 platform |
| SmartRC-CC1101-Driver-Lib | `de6757ef633b3e626dae5c7835cdb66ab53f9a1d` (3.0.2) | CC1101 configuration |
| Practical receiver analysis | <https://milek7.pl/tpmsreceiver/> | context; not a source of frame fields |
| ESP32+CC1101 integration pattern | <https://github.com/merbanan/rtl_433/issues/2978> | integration, not the EG53MA4 protocol |
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.
We do not use the unlabelled `master` as a reproducible reference. The
commercial emulator <https://spooftpms.com/us-eu-gm-1-2-family-tpms-simulator/>
only confirms that such a class of device exists, not this project's
compatibility.
## Potwierdzony format po dekodowaniu Manchester
## Confirmed format after Manchester decoding
Dekoder wymaga dokładnie 120 bitów: 40 bitów synchronizacji i 80 bitów danych.
The decoder requires exactly 120 bits: 40 bits of synchronisation and 80 data
bits.
```text
0 40 72 96 104 112 120
| 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
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 **wg dekodera rtl_433, ale skala nie jest potwierdzona** —
wszystkie cztery nagrania mają `P = 0`, więc żadne prawdziwe ciśnienie nie
zweryfikowało przelicznika (w źródle dekodera to „probable"). Pomiar z auta:
`P = 104` (260 kPa wg skali rtl_433) pokazuje się jako **284 kPa**, więc
firmware koryguje skalę stałą `TPMS_PRESSURE_KPA100_PER_RAW`
(`tpms_frame.h`, domyślnie 273 = 2,73 kPa/bit; `P = 95` dla 260 kPa).
Kwantyzacja: `(kPa×100 + 136) / 273`. Kalibracja potwierdzona na sprzęcie:
260 kPa → 260 kPa na wyświetlaczu auta (`AUDIT.md`).
- `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.
- `flags`: 32 bits; the field meanings are not fully known.
- `ID`: 24 bits; the firmware rejects 0, `FFFFFF`, and duplicates between
wheels.
- `P`: 2.5 kPa/bit **according to the rtl_433 decoder, but the scale is not
confirmed** — all four captures have `P = 0`, so no real pressure verified
the conversion (in the decoder source it is "probable"). A car measurement:
`P = 104` (260 kPa on the rtl_433 scale) shows up as **284 kPa**, so the
firmware corrects the scale with the constant
`TPMS_PRESSURE_KPA100_PER_RAW` (`tpms_frame.h`, default 273 = 2.73 kPa/bit;
`P = 95` for 260 kPa). Quantisation: `(kPa×100 + 136) / 273`. Calibration
confirmed on hardware: 260 kPa → 260 kPa on the car display (`AUDIT.md`).
- `T`: byte in °F per the decoder, not °C. 23 °C → 73 °F.
- `sum`: the sum of the nine preceding bytes modulo 256; it is not CRC-8.
- The value `4c900070` occurs in all 64 records of the four captures. That
does not prove that every sensor/car mode always uses this value.
## Polaryzacja, preambuła i ogon
## Polarity, preamble, and tail
Nagrania i slicer `OOK_PULSE_MANCHESTER_ZEROBIT` potwierdzają G.E.T. Manchester:
`0 → 01`, `1 → 10`. Slicer dopisuje pierwszy zerowy bit. Bufor CC1101 zawiera:
The recordings and the `OOK_PULSE_MANCHESTER_ZEROBIT` slicer confirm G.E.T.
Manchester: `0 → 01`, `1 → 10`. The slicer prepends the first zero bit. The
CC1101 buffer contains:
```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.
1 starting chip + 39 sync cells + 80 data cells + 1 OFF padding chip
= 240 chips = 30 bytes, MSB first.
```
Ostatni chip dopełnienia jest zerem OOK (cisza). Test sprawdza dokładnie tę
długość, polaryzację i odrzuca ucięty/uszkodony bufor.
The last padding chip is an OOK zero (silence). The test checks exactly this
length and polarity and rejects a truncated/corrupted buffer.
## Timing i powtórzenia
## Timing and repetitions
- 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.
- The decoder has `short_width=123 µs`, `reset_limit=300 µs`.
- Analysis of `gfile001` shows a typical pulse+gap period of about 236 µs,
i.e. a chip of about **118 µs**; pulse widths differ from gap widths. The
firmware uses **120 µs** experimentally, which decodes on an independent
`rtl_433`. The exact clock of a physical CC1101 requires an HIL measurement.
- Each of the four recordings contains **16 valid repetitions**. In
`gfile001` the gaps between decode starts vary roughly 115–172 ms; they are
not constant.
- The defaults of **3 frames, a 50 ms gap, a 30 s cycle** are experimental
emulator settings, not a confirmed OE schedule. The ACC/parking intervals
also have no OE-compatibility status.
## Nośna i modulacja
## Carrier and modulation
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.
The base profile: **433.92 MHz, ASK/OOK**. The recordings are decoded at this
frequency. The kit's README also contains 315 MHz product data and a mention
of ASK+FSK; that is no evidence of FSK in the analysed files nor of
compatibility with the specific Astra. FSK is not available in the base
firmware/generator.
## 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`.
The firmware sets fixed-length 30 B, a normal FIFO, MSB first, and disables
the hardware preamble/sync (`SYNC_MODE=0`), Manchester, whitening, FEC, CRC,
address check, and append status. The whole preamble and the protocol's sum
are inside our 30 bytes. End of TX is expected via `MARCSTATE=IDLE` with a
limit; `TXFIFO_UNDERFLOW` and leftover bytes are errors. This prevents the
tail from being truncated by `TXBYTES=0` alone.
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.
The configuration has been audited, but the synthetic CU8 bypasses the
CC1101. The absence of extra bytes and the exact tail still have to be
confirmed on a logic analyser/RTL-SDR in HIL.
## Niewiadome — nie wolno ich „dostrajać” losowo
## Unknowns — they must not be "tuned" randomly
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.
1. The meaning of individual `flags` bits, including any sensor low-battery
bit. **`TPMS_FLAGS_LOWBAT_MASK` does not exist in the firmware.**
2. The dependence of flags on learning, motion, LF, and the original sensor's
battery state.
3. The interval and minimal number of repetitions required by a specific ECU.
4. The compatibility of OE 13506028/a related part number with a specific
unit without a VIN, markings, a readout, or a test.
5. The physical accuracy of frequency, power, and the tail of the generated
CC1101 transmission before HIL.
Niskie zasilanie emulatora jest wyłącznie ostrzeżeniem w konsoli i nie zmienia
żadnego pola symulowanego czujnika.
Low emulator supply is only a console warning and does not change any field
of the simulated sensor.
+38 -33
View File
@@ -1,42 +1,47 @@
# Bezpieczeństwo i ograniczenia
# Safety and limitations
## Sztuczne dane mogą ukryć usterkę
## Synthetic data can hide a fault
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.
This device generates data it does not measure in the tyres. The default
260 kPa is a test value, not confirmation of pressure. The simulator may cause
the warning light not to alert about a real puncture, pressure loss or tyre
damage.
- 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.
- A diagnostic and workshop project only, on a parked car and under the
control of the person running the test.
- It is not a homologated sensor nor a replacement for a working TPMS.
- Do not use while driving and do not present it as safe for that purpose.
- Before and after the test, check all tyres with an independent gauge and
inspect their condition.
- After the diagnosis, restore working, correctly matched sensors and perform
the vehicle's required procedure.
## Radio i zgodność pojazdu
## Radio and vehicle compatibility
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.
The EG53MA4/OOK 433.92 MHz profile is a working hypothesis for the vehicle
indicated, to be confirmed. OE 13506028, a related part number, or a
replacement offer is not enough. Use the VIN, factory sensor markings,
diagnostics, or a controlled test. Do not transmit at maximum power "to be
sure". Start at −10 dBm, limit transmission time, and follow local 433 MHz
regulations and rules about interfering with vehicle electronics. The device
may be received by other receivers nearby.
## Montaż
## Installation
- 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.
- Only the laboratory prototype is described as ready to assemble. The 12 V
version requires a separate design and automotive tests.
- Do not apply 12 V to GPIO/ADC or 5 V to the CC1101.
- Do not place the device near airbags, pedals, moving parts, moisture, high
temperature, or the LPG installation.
- Secure the enclosure and cables against loosening. Avoid shielding the
antenna.
- Do not use an 18650 cell as the recommended power source in the cabin.
## Diagnostyka bez fałszywej pewności
## Diagnostics without false confidence
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.
Correct decoding by rtl_433 does not prove reception by the car. Green CI does
not replace a CC1101 measurement, an HIL test, or a tyre check. The warning
light going out also does not prove the tyres are sound. Record measurements
and do not change several parameters at once. There is no confirmed low
battery bit of the sensor; low emulator supply is not encoded as a fault of
the simulated sensor.
+76 -67
View File
@@ -1,23 +1,26 @@
# Konfiguracja i uruchomienie
# Configuration and startup
## Przed rozpoczęciem
## Before you start
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.
1. Verify compatibility of the specific car (VIN, sensor markings,
diagnostics, or reception). Do not rely solely on a number from a listing.
2. Assemble the prototype per `HARDWARE.md`, flash the firmware, and open a
115200 UART.
3. Type `stay 300`. `info` shows the active configuration, not just the saved
one.
4. Work on a parked car. The synthetic 260 kPa does not describe the real
tyres.
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ć.
Wheels: `1=FL` front left, `2=FR` front right, `3=RR` rear right, `4=RL` rear
left. Configuration commands save to NVS automatically and verify the read
back. An NVS error must be resolved before further testing, not ignored.
## Ścieżka A — Clone IDs (preferowana)
## Path A — Clone IDs (preferred)
Użyj jej, jeśli wcześniej odczytano oryginalne ID i auto nadal je zna.
Use it when the original IDs were read earlier and the car still knows them.
1. Zapisz cztery ID w postaci sześciu cyfr hex.
2. Wpisz kolejno (przykładowe wartości zastąp własnymi):
1. Write down four IDs as six-digit hex.
2. Enter in turn (replace the example values with your own):
```text
id 1 2FC871
@@ -28,75 +31,81 @@ Użyj jej, jeśli wcześniej odczytano oryginalne ID i auto nadal je zna.
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.
3. Check in `info` that all IDs and wheel assignments are correct. A
duplicate, `000000`, `FFFFFF`, or a value beyond 24 bits will be rejected.
4. Optionally, `send` forces a cycle of all wheels. In NORMAL the device does
it automatically as well; after a restart the configuration remains.
5. Confirm reception externally. Known IDs **may** eliminate learning, but we
do not promise that for every ECU state.
Nie używaj przykładowych ID w pojeździe, jeśli mogą pokrywać się z innym
urządzeniem w pobliżu.
Do not use the example IDs in a vehicle if they may coincide with another
device nearby.
## Ścieżka B — New IDs + LEARN
## Path B — New IDs + LEARN
### Przygotowanie
### Preparation
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ą.
1. `ids new` generates four unique IDs. You can use four `id` commands
instead.
2. `info` — write the IDs down on paper.
3. Read the learning procedure for the specific model/equipment version. This
document does not guess menus, pedal sequences, or the receiver location.
4. Start the learning procedure in the car according to its service
instructions.
### Nauka z konsoli
### Learning from the console
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
1. `mode learn` — starts at FL; only FL transmits every 2 s.
2. `send` — immediate FL burst, without changing the wheel.
3. After completing the step for FL: `next` — FR; the LED shows 2 blinks.
4. Repeat `send`, then `next` — RR, then `next` — RL.
5. After the last `next` the device returns to NORMAL. The order is always
**FL → FR → RR → RL**.
6. Zakończ procedurę auta zgodnie z jej instrukcją i sprawdź odczyt diagnostyczny.
6. Finish the car procedure according to its instructions and check the
diagnostic readout.
### Nauka jednym przyciskiem
### Learning with one button
- 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`.
- enter: hold ≥1.5 s;
- short press: next wheel and an immediate burst;
- force without changing the wheel: console `send`;
- exit before the end: hold ≥1.5 s again or `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.
A 60 s timeout per wheel aborts LEARN to NORMAL; the whole session limit is
15 min. This is not an automatic learning success — you have to start again
from the right wheel.
## SINGLE / diagnostyka
## SINGLE / diagnostics
`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.
`mode single 2` transmits only FR every 2 s. `send` forces FR, `next` moves
on. `mode normal` ends it; the automatic limit is 5 min. The mode does not
save the wheel selection in NVS and starts safely in NORMAL after a power
loss.
## Pozostałe ustawienia
## Other settings
| Komenda | Zakres / skutek |
| Command | Range / effect |
|---|---|
| `pressure all 260` | 0–637,5 kPa, krok bajtu P ≈ 2,73 kPa (kalibracja wg auta, `PROTOCOL.md`) |
| `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 |
| `pressure all 260` | 0–637.5 kPa, P byte step ≈ 2.73 kPa (calibrated per the car, `PROTOCOL.md`) |
| `temp all 23` | −40…85 °C; °F in the frame |
| `interval normal 30` | interval without ACC, 5–86400 s |
| `interval ignition 30` | with hardware ACC active |
| `interval parking 120` | without active ACC |
| `rf freq 433.92` | 433.05–434.79 MHz; changes require justification |
| `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ą |
| `rf burst 3` | 1–8 frames per wheel |
| `rf gap 50` | 20–500 ms between frames |
| `flags 4C900070` | experiment; bit meanings are unknown |
| `factory YES` | erases your configuration and restores defaults |
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.
Schedule parameters are experimental. Power starts at −10 dBm; increase it
only after a measurement and with the regulations in mind. Low emulator
supply sets no sensor flag.
## Po restarcie lub brownout
## After a restart or 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.
The firmware reads NVS again. A correct version/CRC and ranges are required.
A damaged or incompatible entry produces a message and a return to defaults,
rather than transmitting a partly corrupted configuration. Every deep sleep
has an alarm; there is no `PARKING_SHUTDOWN` mode that could leave the car
without transmission until a manual wake.
+32 -31
View File
@@ -1,37 +1,38 @@
# Rozwiązywanie problemów
# Troubleshooting
Pracuj po jednej zmianie i zapisuj pomiar. Nie przełączaj losowo OOK/FSK, flags,
ID ani interwałów. Podstawowy firmware nie ma trybu FSK.
Work one change at a time and record the measurement. Do not switch OOK/FSK,
flags, IDs, or intervals randomly. The base firmware has no FSK mode.
| Objaw | Możliwa przyczyna | Pomiar / sprawdzenie | Naprawa |
| Symptom | Possible cause | Measurement / check | Repair |
|---|---|---|---|
| `BLAD: brak CC1101` | złe zasilanie, CS/SPI, moduł nie 433 MHz | 3,3 V na VCC-GND; ciągłość SCK/MISO/MOSI/CS = 4/5/6/7; 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 |
| USB/UART nie odpowiada | za krótkie okno konsoli, zły baud/port, kabel tylko do ładowania | 115200 8N1, reset, właściwy `/dev/ttyACM*` lub `/dev/ttyUSB*` | wpisz `stay 300` od razu po starcie; użyj kabla z danymi |
| 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 | S2 Mini, LM317T, LED, dzielniki | pomiar całej płytki i regulatora wg `POWER.md` | popraw zasilanie; nie zmieniaj protokołu |
| Po postoju brak TX | zasilanie tylko z gniazda zapalniczki/ACC, brownout, błąd NVS/CC1101 | czy po wyłączeniu zapłonu zostaje 3,3 V; log po restarcie, `batt`, `info` | przy zasilaniu tylko z gniazda „po stacyjce” brak TX jest oczekiwany; w innym układzie popraw zasilanie |
| 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 |
| `ERROR: no CC1101` | poor supply, CS/SPI, module is not 433 MHz | 3.3 V across VCC-GND; continuity SCK/MISO/MOSI/CS = 4/5/6/7; module marking | fix wiring, shorten SPI, use the correct module |
| Reset during TX | 3.3 V droop, weak wires | voltage at the ESP32/CC1101 during `send`, brownout log | fix the supply and 47–100 µF at the module; do not raise the PA |
| `TX-ERR` | underflow, unfinished TX, wrong CC1101 configuration | log for each wheel; MARCSTATE/registers in HIL | check SPI and supply; save the log for analysis, do not mask the error |
| USB/UART does not respond | console window too short, wrong baud/port, charge-only cable | 115200 8N1, reset, correct `/dev/ttyACM*` or `/dev/ttyUSB*` | type `stay 300` right after startup; use a data cable |
| ID change disappears | NVS write error, full flash | `OK: saved` message, restart and `info` | do not continue on an NVS error; check flash/supply |
| ID rejected | duplicate, 0, FFFFFF, wrong length | six hex digits and `info` | transmit four unique IDs from 000001–FFFFFE |
| rtl_433 decodes nothing | antenna, frequency, wrong RF path, too little power | `send 1`; 433.92 MHz receiver close by; ANT/GDO0 measurement | fix antenna/supply; step through low powers gradually; do not switch to FSK |
| rtl_433 sees wrong data | stale configuration, neighbouring sensor | `info`, `hex 1`, ID filtering in the receiver | compare IDs and force `send 1` in an isolated spot |
| Car does not see known IDs | unconfirmed profile, ECU requires learning, range | VIN/markings/DTC; RTL-SDR reception at the car | confirm the profile; perform LEARN; change position after measuring |
| LEARN stuck on one wheel | used `send` instead of `next` | `info` shows the active wheel | `next` after confirming the step; `send` only forces TX |
| LEARN returned to NORMAL | 60 s per wheel / 15 min session | elapsed time, message and LED | run `mode learn 1` and consciously repeat from FL |
| After RL there is no next wheel | the sequence completed | NORMAL in `info` | finish the car procedure and check DTC |
| Warning light stays on although RTL-SDR is OK | ECU does not know the IDs, other profile/flags/procedure | read IDs and DTC from diagnostics, not only SDR | Clone IDs or LEARN; confirm the car profile; do not guess flags |
| High sleep consumption | S2 Mini, LM317T, LED, dividers | measure the whole board and regulator per `POWER.md` | fix the supply; do not change the protocol |
| No TX after parking | supply only from the lighter socket/ACC, brownout, NVS/CC1101 error | does 3.3 V remain after the ignition goes off; log after restart, `batt`, `info` | with an ignition-switched socket supply the lack of TX is expected; otherwise fix the supply |
| ACC does not change the interval | feature disabled by default or wrong threshold | `PIN_ACC`, voltage on GPIO OFF/ON | build a protected input; never 12 V on GPIO |
## Gdy brak odbioru w samochodzie
## When the car does not receive
Kolejność diagnostyczna:
Diagnostic sequence:
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.
1. **Prove local TX:** `send 1` + RTL-SDR/analyser.
2. **Prove the correct profile:** VIN, sensor markings, car readout.
3. **Check IDs and order:** `info`, Clone IDs, or one active wheel in LEARN.
4. **Check range:** low power first, console/behind the glovebox, possibly the
boot; without disassembling airbags or guessing the ECU location.
5. **Only then analyse flags:** compare with a recording of the original
sensor in the same mode. There is no confirmed low-battery bit — do not
set it.
6. If there is no measurement or data, stop the test. Random changes add new
variables and are not a diagnosis.
+81 -76
View File
@@ -1,125 +1,130 @@
# Walidacja
# Validation
## Jedno polecenie bez sprzętu
## One command without hardware
```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.
The script runs the Python self-test, native tests, the full ESP32 build,
cppcheck, fetching the pinned sources (on first run), and CU8 decoding by the
real `rtl_433`. Logs: `artifacts/validation/`. Every stage has `pipefail`,
and an error ends the script with a non-zero code.
Alternatywa reprodukowalna:
A reproducible alternative:
```bash
docker build -t tpms-rc .
docker run --rm -v "$PWD/artifacts:/work/artifacts" tpms-rc
```
## Wyniki z 2026-10-28
## Results from 2026-10-28
Środowisko: Linux, Python 3.14.4 przy teście hosta; PlatformIO 6.1.18;
Environment: Linux, Python 3.14.4 on the host test; 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`.
rtl_433_tests commit `1aa8c29…`. Full SHAs are in `PROTOCOL.md`.
| Komenda | Wynik |
| Command | Result |
|---|---|
| `pio test -e native` | **24/24 PASS** — ramka, cztery niezależne wektory, negatywne, NVS, parsowanie konsoli (NaN/zakresy), fake clock/radio, Clone IDs, LEARN, SINGLE, ACC, restart |
| `pio run -e esp32s2mini` | **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 |
| `pio test -e native` | **24/24 PASS** — frame, four independent vectors, negative tests, NVS, console parsing (NaN/ranges), fake clock/radio, Clone IDs, LEARN, SINGLE, ACC, restart |
| `pio run -e esp32s2mini` | **PASS**, own warnings treated as errors (`-Werror`) |
| `pio check -e native ... --fail-on-defect=low` | **PASS**, 0 defects after the struct initialisation fix |
| `python3 tools/tpms_frame.py --self-test` | **PASS**, capture + 500 frames |
| `tools/verify_rtl433.sh` | **PASS**, 64/64 reference records; 3/3 synthetic; 3/3 negative rejected |
| `git diff --check` | **PASS** |
| `bash tools/package_release.sh` | **PASS**, obraz ESP32-S2 z bootloaderem od `0x1000` i manifestem SHA-256 |
| `bash tools/package_release.sh` | **PASS**, ESP32-S2 image with the bootloader at `0x1000` and a SHA-256 manifest |
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.
Reference data: each of `gfile001`…`gfile004` produced exactly 16 matching
records, with the expected ID/flags/pressure/temperature. The synthetic frames
2FC871/260 kPa/73 F, 3495AC/220 kPa/23 F and ABCDEE/262.5 kPa/75 F were
decoded by an independent `rtl_433`. Damaged Manchester, a wrong sum, and
truncation produced no EG53MA4 record.
## Macierz pokrycia
## Coverage matrix
| Warstwa | Automatyczne | RTL-SDR fizyczny | CC1101 fizyczny | Samochód |
| Layer | Automated | Physical RTL-SDR | Physical CC1101 | Car |
|---|---|---|---|---|
| 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 |
| fields, checksum, quantisation | done | not needed for the field | not needed | confirmation of ECU interpretation |
| Manchester/preamble/length | done | **not done** | **not done** | not done |
| real recordings → rtl_433 | done, 64/64 | n/a | n/a | n/a |
| synthetic CU8 → rtl_433 | done | n/a | bypasses hardware | n/a |
| CC1101 registers/tail/power/frequency | code audit | required | **required** | required |
| NVS, IDs, intervals, modes | done; NVS emulated with a blob | a restart test is required | required | required |
| LEARN FL→FR→RR→RL | state machine PASS | auxiliary | required | **not done** |
| consumption/brownout/ACC | ACC in the state machine; no measurements | n/a | required | required |
**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.
**There is no basis for a "validated" label.** Gitea Actions has a workflow,
but the runner state and the remote CI result must be checked; a local PASS
is not pretend CI.
## Checklista HIL — wymaga użytkownika i sprzętu
## HIL checklist — requires a user and hardware
### CC1101 + analizator/RTL-SDR
### CC1101 + analyser/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.
- [ ] Read the registers after initialisation: OOK, 433.92 MHz, fixed 30 B,
`SYNC_MODE=0`, no CRC/Manchester/whitening/FEC/append.
- [ ] On GDO0/ANT confirm exactly 30 B, a ~120 µs chip, a full last chip, and
no hardware preamble/sync/CRC/extra bytes.
- [ ] Record TX-ERR/underflow; there should be none on a correct RF path.
- [ ] Measure the frequency and relative power at −10 dBm; do not assume the
calibration of a cheap module. Do not raise the PA unnecessarily.
- [ ] `send 1`…`send 4`: RTL-SDR decodes the correct IDs, 260 kPa and flags.
- [ ] Repeat after a reset and 10 deep sleep cycles.
### NVS i wejścia
### NVS and inputs
- [ ] 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ąć.
- [ ] Set your own IDs/pressures/RF, disconnect power for >1 min, and re-check
`info` and transmission.
- [ ] Verify rejection of a duplicate ID, a bad power, and a bad interval.
- [ ] `factory YES` restores 260 kPa and the default RF.
- [ ] Brownout/crank on a protected supply: no hang or configuration damage;
write settings only after the supply stabilises.
- [ ] If ACC is installed: measure the GPIO voltage for OFF/ON/transients,
check the intervals and automatic resumption after ACC ON. Skip without
ACC.
### Konkretny Opel Astra J
### The specific 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.
- [ ] Confirm the profile via VIN/markings/diagnostics before transmitting.
- [ ] Clone IDs: reception of the four known IDs without assuming learning
will vanish.
- [ ] New IDs: full learning FL→FR→RR→RL with one active wheel.
- [ ] DTC and TPMS data read before/after; record the ECU version and
procedure.
- [ ] Position test: centre console/behind the glovebox, possibly the boot;
while parked, without guessing the receiver location.
- [ ] A tyre gauge check of all wheels before and after. Do not perform the
test as a road drive with the simulator in place of a working TPMS.
## Artefakty i wgrywanie
## Artifacts and flashing
```bash
bash tools/package_release.sh
```
Katalog `artifacts/release/`:
The `artifacts/release/` directory:
| Plik | Adres |
| File | Address |
|---|---:|
| `bootloader.bin` | `0x1000` — adres dla ESP32-S2, nie `0x0` jak w ESP32-C3 |
| `bootloader.bin` | `0x1000` — the address for ESP32-S2, not `0x0` as in ESP32-C3 |
| `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 |
| `firmware-full.bin` | `0x0` — the full 4 MB image |
| `firmware.elf` | debug/symbols, do not flash it |
| `SHA256SUMS`, `BUILD-INFO.txt` | integrity and version check |
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.
The full image erases the previous flash while writing the whole area; NVS in
that partition may be lost — write down your IDs before updating with the
full image. Updating only the application `firmware.bin` at `0x10000`
usually preserves NVS, but before a release the user should test it on their
own module.
```bash
PORT=/dev/ttyACM0 bash tools/flash_release.sh
(cd artifacts/release && sha256sum -c SHA256SUMS)
```
Nie wgrywaj obrazu z innego toolchaina na ślepo. RC nie zawiera fizycznego testu
update ani samochodu.
Do not flash an image from another toolchain blindly. The RC contains no
physical update test or car test.