Docs and code: translate Polish comments, messages and documentation to English
check / check-without-hardware (push) Successful in 6m45s
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:
1 parent
1563e34d05
commit
e183d23950
42 files changed
+1106
-1019
No files matched your search
+79
-69
@@ -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.
|
||||
Reference in new issue
Block a user