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

+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.