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