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

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

No files matched your search

+77 -65
View File
@@ -1,76 +1,88 @@
# Energia i zachowanie na postoju
# Energy and parking behaviour
## Status pomiarów
## Measurement status
**Nie wykonano pomiarów prądu fizycznego prototypu.** Liczby poniżej są
szacunkami budżetu, nie wynikiem walidacji. S2 Mini nie nadaje się do deklaracji
poboru µA bez pomiaru: wbudowany regulator, LED i obwody pomocnicze zwiększają
pobór. Sam LM317T obciąża zasilanie prądem dzielnika ok. 5 mA (R1 = 240 Ω)
plus prąd własny, więc zasilanie stałe wymaga osobnego bilansu energetycznego.
Docelowe zasilanie z gniazda zapalniczki „po stacyjce” zdejmuje ten problem:
przy wyłączonym zapłonie emulator nie pobiera prądu wcale.
**No current measurements of the physical prototype have been performed.**
The numbers below are budget estimates, not validated results. The S2 Mini
is not suitable for declaring µA consumption without measurement: the built-in
regulator, LED, and auxiliary circuits add consumption. The LM317T itself
loads the supply with a divider current of about 5 mA (R1 = 240 Ω) plus its
own quiescent current, so a permanent supply needs a separate energy budget.
The target supply from an ignition-switched cigarette-lighter socket removes
this problem: with the ignition off the emulator draws no current at all.
## Harmonogram firmware
## Firmware schedule
- NORMAL po wybudzeniu RTC: inicjalizacja, burst czterech kół, wyjście z TX i deep
sleep. Nie ma 10-sekundowego okna konsoli po zwykłym budziku.
- Mikrodrzemki: sen jest dzielony na kawałki tak, żeby dioda migała co ok. 2 s
także między wysyłkami (`NAP_PERIOD_MS` w `config.h`). Po budzeniu timera
urządzenie pokazuje jedno widoczne mignięcie i śpi resztę okresu po czasie
boot + okno (`NAP_AWAKE_MS`). Przycisk budzi natychmiast (EXT1) niezależnie
od mikrodrzemek.
- TX ramek pozostaje co interwał (domyślnie 30 s): licznik snu w pamięci RTC
zlicza przespane kawałki od ostatniego cyklu TX; `interval` wchodzi w życie
przy następnym cyklu. Po dłuższym czuwaniu (np. `stay`) pierwszy kawałek
jest pełny.
- **Mikrodrzemki zwiększają pobór** (boot co ok. 2 s zamiast jednego snu na
interwał) — liczby poniżej opisują stary model i wymagają pomiaru HIL.
- Po power-on, przycisku lub LF: okno konsoli 10 s; `stay N` wydłuża je.
- LEARN: TX jednego koła co 2 s, bez deep sleep, maks. 60 s na koło/15 min sesji.
- SINGLE: TX jednego koła co 2 s, bez deep sleep, maks. 5 min.
- CC1101 przechodzi w SPWD przed snem; CS jest wysoki, SCK/MOSI niskie, LED off.
- Każdy sen ma budzik RTC. `PARKING_SHUTDOWN` usunięto — urządzenie nie może
pozostać uśpione do czasu wyłącznie ręcznego wybudzenia.
- ACC (opcjonalny sprzętowo) wybiera interwał ignition/parking. Nie jest potrzebne
jako jedyne źródło wybudzenia, ponieważ RTC zawsze działa. Jeżeli cały układ
zasilany jest tylko z gniazda zapalniczki „po stacyjce” lub z ACC, po ACC OFF
nie ma zasilania, RTC ani transmisji — i jest to docelowy scenariusz.
- NORMAL after the RTC wake: initialisation, a burst of four wheels, exit of
TX, and deep sleep. There is no 10-second console window after a plain wake.
- Micro-naps: sleep is split into pieces so that the LED blinks about every
2 s, also between transmissions (`NAP_PERIOD_MS` in `config.h`). After a
timer wake the device shows one visible blink and sleeps the rest of the
period after boot time + window (`NAP_AWAKE_MS`). The button wakes
immediately (EXT1) regardless of the micro-naps.
- TX of frames remains on the interval (default 30 s): the sleep counter in
RTC memory counts the slept pieces since the last TX cycle; `interval`
takes effect on the next cycle. After a longer awake period (e.g. `stay`),
the first piece is a full one.
- **Micro-naps raise consumption** (a boot about every 2 s instead of one
sleep per interval) — the numbers below describe the old model and require
HIL measurement.
- After power-on, a button, or LF: a 10 s console window; `stay N` extends it.
- LEARN: TX of one wheel every 2 s, without deep sleep, max 60 s per wheel/
15 min per session.
- SINGLE: TX of one wheel every 2 s, without deep sleep, max 5 min.
- The CC1101 enters SPWD before sleep; CS is high, SCK/MOSI low, LED off.
- Every sleep has an RTC alarm. `PARKING_SHUTDOWN` was removed — the device
cannot remain asleep until a purely manual wake.
- ACC (optional in hardware) selects the ignition/parking interval. It is not
needed as the only wake source, because the RTC always runs. If the whole
assembly is powered only from an ignition-switched lighter socket or from
ACC, then with ACC off there is no power, no RTC, and no transmission —
and that is the target scenario.
## Szacunek ładunku dla ustawień domyślnych
## Charge estimate for the default settings
Jedna ramka to 240 × 120 µs = 28,8 ms na antenie. Dla 4 kół × 3 ramki:
345,6 ms samej transmisji plus 8 × 50 ms przerw wewnątrz burstów. Do tego dochodzi
boot, konfiguracja, SPI i logi. Do obliczeń energii trzeba zmierzyć cały cykl,
a nie tylko czas OOK.
One frame is 240 × 120 µs = 28.8 ms on air. For 4 wheels × 3 frames:
345.6 ms of transmission plus 8 × 50 ms gaps inside the bursts. On top of
that come boot, configuration, SPI, and logging. For energy calculations you
must measure the whole cycle, not just the OOK time.
Przykładowy model (do zastąpienia pomiarem): jeżeli aktywność ESP32 wyniesie 1,0 s
przy 80 mA co 30 s, sam ESP32 uśrednia ok. 2,7 mA na 3,3 V. CC1101, boot i prąd snu
dodają kolejne składniki. Przy interwale 120 s udział aktywności spada ok. czterokrotnie,
ale stały Iq zasilacza i dzielników pozostaje. Nie są to zmierzone 2,7 mA ani
obietnica poboru z akumulatora 12 V.
An example model (to be replaced by measurement): if ESP32 activity is 1.0 s
at 80 mA every 30 s, the ESP32 alone averages about 2.7 mA at 3.3 V. The
CC1101, boot, and sleep current add further terms. With a 120 s interval the
activity share falls about fourfold, but the constant Iq of the regulator and
the dividers remains. These are not measured 2.7 mA nor a promise of
consumption from a 12 V battery.
## Metoda pomiaru wymagana przed „validated”
## Measurement method required before "validated"
1. **Cały S2 Mini w sleep:** miernik µA szeregowo na wejściu, nie przez USB.
Odczekać do końca TX i zanotować minimum/stan stabilny oraz model płytki.
2. **S2 Mini + LM317T:** powtórzyć pomiar na zabezpieczonym wejściu VIN i na
szynie 3,3 V. Uwzględnić prąd dzielnika regulatora, TVS, pozostałe dzielniki
i pull-upy.
3. **Cykl NORMAL:** bocznik + oscyloskop albo logger z odpowiednim pasmem.
Zarejestrować boot, 12 ramek, przerwy, wejście w sen przez co najmniej 10 cykli.
4. **Średnia:** całkować ładunek co najmniej 15 min przy 30 s i 120 s. Podawać
warunki: napięcie, temperatura, PA, wersja płytki i firmware.
5. **LEARN/SINGLE:** osobno zmierzyć prąd ciągłego czuwania.
6. **ACC/brownout/crank:** sprawdzić restart, powrót do nadawania i integralność
NVS. Nie wykonywać na GPIO bez potwierdzonej ochrony wejścia.
1. **The whole S2 Mini in sleep:** a µA meter in series at the input, not
through USB. Wait until TX ends and record the minimum/steady state and
the board model.
2. **S2 Mini + LM317T:** repeat the measurement on the protected VIN input
and on the 3.3 V rail. Include the regulator divider current, TVS, the
other dividers, and pull-ups.
3. **NORMAL cycle:** a shunt + oscilloscope or a logger with sufficient
bandwidth. Record boot, 12 frames, gaps, and entering sleep over at least
10 cycles.
4. **Average:** integrate the charge for at least 15 min at 30 s and 120 s.
State the conditions: voltage, temperature, PA, board and firmware
version.
5. **LEARN/SINGLE:** measure the continuous-awake current separately.
6. **ACC/brownout/crank:** check restart, the return to transmission, and NVS
integrity. Do not test on GPIO without confirmed input protection.
## Wnioski dopuszczalne przed pomiarem
## Conclusions allowed before measurement
- Największy wpływ mają interwał, czas czuwania, PA i Iq całej płytki.
- Do wersji energooszczędnej trzeba zmierzyć cały S2 Mini i LM317T; przy
zasilaniu wyłącznie z gniazda zapalniczki „po stacyjce” układ nie pobiera
prądu po wyłączeniu zapłonu, ale wtedy również nie nadaje w trybie
parkingowym — co jest zgodne z założeniem, bo ECU auta wtedy nie nasłuchuje.
- Nie rekomendujemy 18650 w kabinie ani wieloletniej pracy bateryjnej z ESP32.
- Stały pobór emulatora trzeba uwzględnić przy długim postoju pojazdu; nie podajemy
czasu „bezpiecznego dla akumulatora” bez pomiaru całego samochodu.
- The interval, awake time, PA, and the whole board's Iq have the largest
impact.
- A power-saving version requires measuring the whole S2 Mini and LM317T;
with power only from an ignition-switched lighter socket the assembly draws
no current after the ignition goes off, but then it also transmits no
parking mode — which matches the assumption, because the car ECU does not
listen then.
- We do not recommend an 18650 in the cabin, nor multi-year battery operation
with an ESP32.
- The emulator's constant consumption must be accounted for during a long
park; we do not give a "safe for the battery" time without measuring the
whole car.