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
+30
-29
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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.
|
||||
Reference in new issue
Block a user