Sprzet: ESP32-C3 SuperMini i zasilanie LF33CV
check / check-without-hardware (push) Canceled after 0s

This commit is contained in:
czcionka committed 2026-10-27 22:35:46 +00:00
1 parent 84078a914f
commit 40c152afca
17 files changed
+223 -142

No files matched your search

+1 -1
View File
@@ -13,7 +13,7 @@ jobs:
- name: Install build dependencies
run: |
apt-get update
apt-get install -y --no-install-recommends build-essential cmake git libusb-1.0-0-dev pkg-config ca-certificates
apt-get install -y --no-install-recommends build-essential cmake git libusb-1.0-0-dev librtlsdr-dev pkg-config ca-certificates
- name: Install pinned Python tools
run: pip install --no-cache-dir --disable-pip-version-check -r tools/requirements.txt
- name: All tests without hardware
+9
View File
@@ -1,5 +1,14 @@
# Changelog
## Zmiany robocze po 2.0.0-rc.1
- Sprzęt docelowy zmieniono na ESP32-C3 SuperMini; zaktualizowano target
PlatformIO, natywne USB CDC, pinout SPI/przycisku/ADC i polaryzację wbudowanej LED.
- Dodano zasilanie zewnętrzne przez LF33CV, jego właściwy pinout OUT–GND–IN,
kondensatory oraz wymagania ochrony i termiki dla zasilania z ACC.
- Obrazy release dla ESP32-C3 używają `esptool --chip esp32c3` i bootloadera od
adresu `0x0`; stare obrazy dla ESP32-WROOM nie są kompatybilne.
## 2.0.0-rc.1 — 2026-10-27
Release candidate bez testu fizycznego CC1101 i samochodu.
+1 -1
View File
@@ -1,7 +1,7 @@
FROM python:3.12.12-slim-bookworm
RUN apt-get update && apt-get install -y --no-install-recommends \
build-essential cmake git libusb-1.0-0-dev pkg-config ca-certificates \
build-essential cmake git libusb-1.0-0-dev librtlsdr-dev pkg-config ca-certificates \
&& rm -rf /var/lib/apt/lists/*
WORKDIR /work
COPY tools/requirements.txt tools/requirements.txt
+29 -21
View File
@@ -1,4 +1,4 @@
# Symulator TPMS Schrader EG53MA4 — ESP32 + CC1101
# Symulator TPMS Schrader EG53MA4 — ESP32-C3 SuperMini + CC1101
**Wersja 2.0.0-rc.1 — release candidate bez walidacji sprzętowej.**
@@ -27,30 +27,36 @@ ogłoszenie sprzedażowe same w sobie nie potwierdzają profilu radiowego.
## Schemat ideowy
```text
USB 5 V (TYLKO prototyp) 3,3 V OOK 433,92 MHz
│ │ │
[ESP32 DevKit] ── SPI ───────> [CC1101 433 MHz] ── antena ────┘
│ │
├── GPIO26: przycisk └── wspólna GND
└── GPIO27: LED + 330 Ω
Prototyp na biurku:
USB-C ──> [ESP32-C3 SuperMini] ── SPI ──> [CC1101 433 MHz] ──> antena
│ │ │
│ └── GPIO3: przycisk └── wspólna GND, tylko 3,3 V
└── GPIO8: wbudowana LED (aktywna LOW)
Konfiguracja: USB/UART 115200 → NVS → 4 × {ID, ciśnienie, temperatura}
Zasilanie zewnętrzne 3,3 V:
zabezpieczone VIN ──> [LF33CV] ──> 3V3 SuperMini + VCC CC1101
Konfiguracja: USB CDC 115200 → NVS → 4 × {ID, ciśnienie, temperatura}
```
Nie podłączaj 12 V do GPIO, 3V3 ani VIN DevKit. Połączenia i wariant automotive:
[HARDWARE](docs/HARDWARE.md).
Wyjście LF33CV podłącz do **3V3, nie do 5V**. Nie podłączaj 12 V do GPIO, 3V3
ani 5V. Przy zasilaniu zewnętrznym 3,3 V odłącz USB, chyba że separacja źródeł
została sprawdzona w dokumentacji konkretnego egzemplarza płytki. Pełny pinout,
kondensatory i zasady podłączenia „po stacyjce”: [HARDWARE](docs/HARDWARE.md).
## Quick Start
### 1. Złóż prototyp
Kup elementy z [BOM](docs/HARDWARE.md#bom-prototypu-laboratoryjnego). Podłącz
CC1101, przycisk i LED zgodnie z tabelą pinów. Zasil DevKit przez znany kabel USB
na biurku. Nie montuj jeszcze niczego w samochodzie.
CC1101 i przycisk zgodnie z tabelą pinów; LED jest już na płytce SuperMini.
Na biurku zasil układ przez sprawdzony kabel USB-C z danymi. Nie montuj jeszcze
niczego w samochodzie.
### 2. Zainstaluj narzędzia i sprawdź projekt
Wymagane: Python 3, Git, CMake, kompilator C/C++, `pkg-config` i nagłówki libusb.
Wymagane: Python 3, Git, CMake, kompilator C/C++, `pkg-config` oraz nagłówki
libusb i librtlsdr.
Najprościej użyć Dockera:
```bash
@@ -71,14 +77,16 @@ To nie jest test fizycznego radia.
### 3. Skompiluj i wgraj
```bash
.venv/bin/pio run -e esp32dev
.venv/bin/pio run -e esp32dev -t upload
.venv/bin/pio run -e esp32c3supermini
.venv/bin/pio run -e esp32c3supermini -t upload
.venv/bin/pio device monitor --baud 115200
```
Jeżeli port nie jest wykrywany automatycznie, dodaj `--upload-port /dev/ttyUSB0`
(przy `run`) albo `--port /dev/ttyUSB0` (przy `device monitor`). W monitorze
PlatformIO wyjście to zwykle `Ctrl+]`.
Jeżeli port nie jest wykrywany automatycznie, dodaj `--upload-port /dev/ttyACM0`
(przy `run`) albo `--port /dev/ttyACM0` (przy `device monitor`). Zależnie od
systemu i trybu USB może to być również `/dev/ttyUSB0`. W monitorze PlatformIO
wyjście to zwykle `Ctrl+]`. Jeśli upload nie startuje, przytrzymaj **BOOT**,
naciśnij i puść **RESET**, następnie puść BOOT.
Po uruchomieniu wpisz `stay 300` i Enter. Masz 5 minut na konfigurację; polecenie
`info` pokazuje aktywne wartości. Każda zmiana konfiguracji jest od razu zapisywana
@@ -136,8 +144,8 @@ się po 5 min.
## Najczęstsze problemy
- **`BLAD: brak CC1101`**: sprawdź 3,3 V, wspólną masę i sześć przewodów SPI;
nie używaj 5 V na CC1101.
- **`BLAD: brak CC1101`**: sprawdź 3,3 V, wspólną masę oraz SCK/MISO/MOSI/CS
na GPIO4/5/6/7 i GDO0 na GPIO10; nie używaj 5 V na CC1101.
- **Konsola znika przed wpisaniem komend**: po restarcie od razu `stay 300`;
zwykłe wybudzenie RTC celowo nie otwiera okna konsoli.
- **NVS zgłasza błąd**: urządzenie używa bezpiecznych domyślnych; wpisz `info`.
@@ -151,7 +159,7 @@ się po 5 min.
- Protokół i niewiadome: [PROTOCOL](docs/PROTOCOL.md)
- Dokładne wyniki i checklista HIL: [VALIDATION](docs/VALIDATION.md)
- Pobór (na razie szacunki): [POWER](docs/POWER.md)
- Wymagania zasilania 12 V: [HARDWARE](docs/HARDWARE.md#wariant-automotive--wymagania-niezwalidowany-projekt)
- LF33CV i zasilanie „po stacyjce”: [HARDWARE](docs/HARDWARE.md#wariant-prąd-po-stacyjce--wymagania-niezwalidowany-projekt)
- Zmiany: [CHANGELOG](CHANGELOG.md)
Gotowe obrazy tworzy `bash tools/package_release.sh`. Pliki i adresy opisano w
+11 -7
View File
@@ -2,8 +2,8 @@
**Release candidate — 2026-10-27. Nie jest to release „validated”.**
Diagnostyczny symulator czterech czujników Schrader EG53MA4 dla ESP32-WROOM-32 /
DevKit + CC1101 433 MHz. Profil docelowy obejmuje testy z Oplem Astra J Sedan 2016,
Diagnostyczny symulator czterech czujników Schrader EG53MA4 dla ESP32-C3
SuperMini + CC1101 433 MHz. Profil docelowy obejmuje testy z Oplem Astra J Sedan 2016,
ale zgodność konkretnego auta trzeba potwierdzić. Sztuczne dane mogą ukryć usterkę
opony; nie używać w jeździe drogowej.
@@ -18,13 +18,16 @@ opony; nie używać w jeździe drogowej.
## Wymagany sprzęt
ESP32 DevKit z WROOM-32 do prototypu, CC1101 **433 MHz** 3,3 V, antena, przycisk,
LED + 330 Ω, odsprzężenie i zasilanie laboratoryjne. Pełny BOM/pinout: HARDWARE.
DevKit ani tania przetwornica nie są zwalidowanym rozwiązaniem automotive.
ESP32-C3 SuperMini, CC1101 **433 MHz** 3,3 V, antena, przycisk i odsprzężenie.
LED jest wbudowana. Do zasilania zewnętrznego przewidziano LF33CV z właściwymi
kondensatorami; wariant 12 V wymaga ochrony wejścia i testów. Pełny BOM/pinout:
HARDWARE. SuperMini ani LF33CV nie są samodzielnym, zwalidowanym rozwiązaniem
automotive.
## Instalacja i aktualizacja
Nowa instalacja: `bash tools/check_all`, potem `pio run -e esp32dev -t upload`.
Nowa instalacja: `bash tools/check_all`, potem
`pio run -e esp32c3supermini -t upload`.
Gotowe obrazy: `bash tools/package_release.sh`; adresy i flash opisano w VALIDATION.
Przed pełnym flashem zapisz ID — partycja NVS może zostać skasowana. Konfigurację
sprawdź po restarcie przez `info`. Migracji z wersji 1.0 bez NVS nie ma; należy
@@ -47,7 +50,8 @@ Dokładne komendy i przypięte commity: VALIDATION/PROTOCOL.
konkretnego VIN.
- Znaczenie wszystkich flags pozostaje nieznane; brak zgadywanego low battery.
- Harmonogram jest eksperymentalny, nie potwierdzony OE.
- Wymagania zasilania 12 V nie są zwalidowanym projektem automotive.
- LF33CV i zasilanie z ACC nie są zwalidowanym projektem automotive; przy
zasilaniu wyłącznie z ACC nie ma transmisji po wyłączeniu zapłonu.
- Gitea Actions wymaga działającego runnera; lokalne wyniki nie oznaczają CI PASS.
Do czasu odhaczenia HIL w VALIDATION wynik pozostaje release candidate.
+97 -54
View File
@@ -2,47 +2,79 @@
## Zakres
Podstawowy release opisuje **prototyp laboratoryjny**. DevKit, przewody
prototypowe i tania przetwornica nie są gotowym zestawem do trwałego montażu
w samochodzie. Wariant automotive poniżej jest listą wymagań projektowych,
nie zwalidowanym schematem.
Podstawowy release opisuje **prototyp laboratoryjny na ESP32-C3 SuperMini**.
Przewody prototypowe i LF33CV nie są gotowym zestawem do trwałego montażu
w samochodzie. Wariant „po stacyjce” poniżej jest listą połączeń i wymagań
projektowych, nie zwalidowanym schematem automotive.
## BOM prototypu laboratoryjnego
| Element | Wymaganie | Uwagi |
|---|---|---|
| ESP32 DevKit z ESP32-WROOM-32 | 3,3 V, USB do flash/konsoli | tylko biurko; mostek USB i LDO zwiększają pobór |
| ESP32-C3 SuperMini | ESP32-C3, natywne USB-C do flash/konsoli | nie ESP32-WROOM DevKit; klon trzeba sprawdzić przed zasileniem |
| CC1101 | moduł **433 MHz**, SPI, 3,3 V | nie kupuj wersji 868/915 MHz |
| Antena 433 MHz | dopasowana do modułu; na biurko monopol λ/4 ≈ 17 cm | uziemienie/przeciwwaga zgodnie z konstrukcją modułu |
| Przycisk NO | monostabilny | GPIO26 do GND |
| LED + rezystor | 330 Ω | GPIO27, LED do GND |
| Kondensatory | 100 nF przy każdym module + 47–100 µF przy CC1101 | możliwie blisko pinów zasilania |
| Przycisk NO | monostabilny | GPIO3 do GND |
| LED | wbudowana na GPIO8 | aktywna stanem niskim; zewnętrzna LED nie jest potrzebna |
| LF33CV | TO-220, stałe 3,3 V | tylko przy zasilaniu zewnętrznym; nie jest potrzebny przy USB |
| Kondensatory LF33CV | 100 nF na wejściu i min. 2,2 µF na wyjściu | praktycznie 10 µF elektrolityczny o ESR zgodnym z kartą; blisko układu |
| 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 do DevKit albo regulowane 3,3 V z limitem prądu | nie podawaj jednocześnie rywalizujących źródeł |
| Zasilanie laboratoryjne | USB-C 5 V albo LF33CV z bezpiecznego VIN | nie podawaj jednocześnie rywalizujących źródeł 3,3 V |
Do diagnozy RF przydaje się RTL-SDR, ale nie jest częścią emulatora. Do wersji
energooszczędnej użyj gołego ESP32-WROOM-32E na własnej płytce, z poprawnym
zasilaniem, resetem, bootstrapem i złączem programowania. Sam moduł nie ma USB.
Do diagnozy RF przydaje się RTL-SDR, ale nie jest częścią emulatora. Standardowy
SuperMini ma niebieską LED GPIO8 i przycisk BOOT GPIO9; przed montażem sprawdź
konkretny klon, bo nazwy handlowe bywają używane dla różnych płytek.
## Pinout i połączenia
| ESP32 | CC1101 / element | Zasada |
| ESP32-C3 SuperMini | CC1101 / element | Zasada |
|---|---|---|
| 3V3 | CC1101 VCC | **tylko 3,3 V** |
| GND | CC1101 GND, przycisk, LED | wspólna masa |
| GPIO18 | SCK/SCLK | SPI |
| GPIO19 | MISO/SO | SPI |
| GPIO23 | MOSI/SI | SPI |
| GPIO5 | CS/CSn/SS | SPI |
| GPIO2 | GDO0 | diagnostyka biblioteki; GDO2 niepodłączony |
| GPIO26 | przycisk NO do GND | wewnętrzny pull-up; opcjonalny zewnętrzny 10 kΩ |
| GPIO27 | rezystor 330 Ω → LED → GND | aktywna wysoko |
| GPIO34 | opcjonalny ADC zasilania przez dzielnik | nigdy 12 V wprost |
| GPIO32 | opcjonalne ACC po zmianie `PIN_ACC` i zabezpieczeniu | nigdy 12 V wprost |
| GPIO25 | opcjonalny detektor LF po zmianie `PIN_LF_TRIGGER` | domyślnie wyłączone; brak gotowego front-endu w RC |
| 3V3 | CC1101 VCC; wyjście LF33CV przy zasilaniu zewnętrznym | **tylko 3,3 V**, nigdy wyjście 5 V |
| GND | CC1101 GND, przycisk, LF33CV GND | wspólna masa |
| 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 | przycisk NO do GND | wewnętrzny pull-up; RTC GPIO wakeup, opcjonalny zewnętrzny 10 kΩ |
| GPIO8 | wbudowana LED | aktywna LOW, firmware steruje właściwą polaryzacją |
| GPIO0 | opcjonalny ADC zasilania przez dzielnik | `PIN_VBAT_ADC`; nigdy 12 V wprost |
| GPIO2 | opcjonalne ACC po zmianie `PIN_ACC` i zabezpieczeniu | pin strapping; nigdy 12 V wprost |
| GPIO1 | opcjonalny detektor LF po zmianie `PIN_LF_TRIGGER` | aktywny LOW; RTC GPIO wakeup, domyślnie wyłączone |
| GPIO9 | przycisk BOOT płytki | nie używać do CC1101 ani przycisku sterującego |
Przy zasilaniu 3,3 V z zasilacza: ustaw limit np. 0,5 A, sprawdź polaryzację,
połącz GND, wyłącz USB jako drugie źródło. Prąd szczytowy zależy od modułu i PA.
GPIO2, GPIO8 i GPIO9 są pinami strapping. Nie dokładaj do nich zewnętrznych
rezystorów ani układów wymuszających stan podczas resetu. GPIO20/21 pozostają
wolne; konsola korzysta z natywnego USB-C, więc zewnętrzny mostek USB-UART nie
jest potrzebny.
Przy laboratoryjnym zasilaniu 3,3 V przez LF33CV: zacznij od VIN = 5 V, ustaw
limit np. 0,5 A, sprawdź polaryzację i napięcie wyjściowe bez podłączonego
SuperMini. Połącz GND, a na czas zasilania zewnętrznego odłącz USB. Prąd
szczytowy zależy od płytki i ustawionego PA.
## LF33CV — wyprowadzenia i kondensatory
Dla **LF33CV w TO-220**, patrząc na oznaczenia od przodu z nóżkami w dół:
| Nóżka | Funkcja | Połączenie |
|---:|---|---|
| 1 | VOUT | 3V3 SuperMini + VCC CC1101 |
| 2 | GND | wspólna masa |
| 3 | VIN | zabezpieczone napięcie wejściowe |
Metalowy TAB jest połączony z GND. **Nie stosuj schematu nóżek 7805** — tutaj
kolejność to OUT–GND–IN. Między VIN a GND daj 100 nF. Między VOUT a GND daj
kondensator min. 2,2 µF; karta LF33C podaje zakres ESR 0,1–10 Ω. Praktyczny
punkt startowy to 10 µF elektrolityczny zgodny z tym wymaganiem, a nie przypadkowy
sam kondensator ceramiczny o bardzo niskim ESR. Dodatkowe 100 nF przy modułach
i 47–100 µF przy CC1101 pozostają potrzebne.
Nie podłączaj VOUT LF33CV do pinu **5V** SuperMini. 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 LF33CV bez sprawdzonej separacji
źródeł, ponieważ konstrukcje klonów różnią się połączeniami zasilania.
## Antena i test położenia
@@ -57,42 +89,52 @@ Nie owijaj anteny wiązką, nie prowadź jej przy żarówce/rozdzielaczu LPG ani
przewodach zapłonowych. Obudowa prototypu powinna być nieprzewodząca; otwór i
konieczność ekranowania trzeba ocenić pomiarowo.
## Wariant automotive — wymagania, niezwalidowany projekt
## Wariant „prąd po stacyjce” — wymagania, niezwalidowany projekt
Instalacja 12 V wymaga osobnego schematu, obliczeń, PCB i testów. Minimalny łańcuch:
Docelowy tor zasilania z ACC:
```text
akumulator → bezpiecznik przy źródle → ochrona reverse polarity
→ ograniczenie energii + właściwie dobrany TVS
→ regulator automotive → odsprzężenie → ESP32 + CC1101
ACC → ochrona przepięciowa + dzielnik/komparator → wejście logiczne 3,3 V
ACC 12 V → bezpiecznik przy źródle → ochrona przed odwrotną polaryzacją
→ ograniczenie energii + właściwie dobrany TVS
→ VIN LF33CV → VOUT 3,3 V → 3V3 SuperMini + VCC CC1101
```
Wymagania:
Samo wyjście „po stacyjce” nadal ma przepięcia i zakłócenia instalacji pojazdu.
**Nie podłączaj go wprost do VIN LF33CV jako gotowej instalacji samochodowej.**
Zakres roboczego VIN LF33CV kończy się przy 16 V; fakt, że spoczynkowe 12–14,8 V
mieści się w tym zakresie, nie oznacza odporności na crank/load dump ani przepięcia.
Ochrona musi ograniczać napięcie z marginesem poniżej dopuszczalnego VIN regulatora.
TVS o progu powyżej tego VIN nie stanowi ochrony LF33CV.
Wymagania przed montażem:
- bezpiecznik dobrany do przewodów i poboru, blisko źródła; nie zastępuje TVS;
- ochrona przed odwrotną polaryzacją i ujemnymi przepięciami;
- TVS dobrany do rzeczywistego profilu przepięć, rezystancji źródła i energii;
napięcie robocze nie może powodować upływu przy 14,4–14,8 V, a napięcie
ograniczenia musi pozostawić margines względem absolutnego maksimum regulatora;
- regulator z odpowiednim zakresem wejściowym, prądem szczytowym, niskim Iq,
stabilnością z wybranymi kondensatorami i kwalifikacją automotive;
- odsprzężenie zgodne z kartą regulatora, ESP32 i CC1101, krótkie pętle prądowe;
- TVS i ograniczenie energii dobrane do rzeczywistego profilu przepięć, bez
przewodzenia przy normalnym 14,4–14,8 V i bez przekraczania VIN LF33CV;
- kondensatory i ESR zgodne z kartą LF33CV, krótkie pętle prądowe;
- pomiar szczytów prądu SuperMini + CC1101 i sprawdzenie stabilności 3,3 V;
- ACC/ADC z ograniczeniem prądu, clampami i progiem odpornym na zakłócenia;
- obliczenia termiczne dla najwyższej temperatury, test brownout/crank/load dump,
EMC, ESD oraz pomiar snu całego urządzenia.
- obliczenia termiczne dla najwyższej temperatury oraz testy brownout/crank/load
dump, EMC i ESD na docelowej płytce.
**MCP1703 ma Vin maks. 16 V i nie jest pełną ochroną automotive nawet z TVS 24 V.**
TVS o progu wyższym niż dopuszczalne Vin nie chroni regulatora. Nie używamy tej
rekomendacji.
LF33CV jest regulatorem liniowym: `P = (VIN − 3,3 V) × I`. Już przy 14,4 V
i 200 mA trzeba odprowadzić ok. **2,22 W**. Bez obliczenia i radiatora TO-220
może się przegrzewać; samo „do 500 mA” z karty nie gwarantuje zasilania szczytów
ESP32-C3 w każdych warunkach. Zmierz prąd i temperaturę przy nadawaniu.
Przykład do dalszego projektu, nie gotowa rekomendacja montażowa: **LM5164-Q1**,
buck 6–100 V, 1 A, typowy Iq rzędu 10 µA (wartości zależne od warunków). Sprawdzono
z kartą TI [LM5164-Q1](https://www.ti.com/lit/ds/symlink/lm5164-q1.pdf), dostęp
2026-10-27. Projekt musi uwzględnić m.in. schemat aplikacyjny, cewkę, diodę/układ
wejściowy, kondensatory, stabilność, szczyty prądu ESP32, temperaturę i ograniczenie
przepięcia poniżej dopuszczalnego Vin z marginesem. Sama nazwa „100 V” nie dowodzi
odporności całego urządzenia.
**Konsekwencja zasilania wyłącznie z ACC:** 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. Samo
zasilanie z ACC nie jest wejściem `PIN_ACC`, więc firmware używa `interval normal`.
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: typowo 0,5 mA samego LF33CV plus SuperMini,
CC1101 i dzielniki może być istotny przy długim postoju.
Parametry LF33CV i wymagane kondensatory: karta ST
[LFxxAB/LFxxC](https://www.st.com/resource/en/datasheet/lfxx.pdf), tabele LF33C
i rysunek połączeń TO-220. Dostęp: 2026-10-27.
## Zasilanie bateryjne
@@ -106,5 +148,6 @@ wariant bateryjny wymaga innej architektury low-power i nie należy do tego rele
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. Sam aktywator nie wpisuje
ID do emulatora.
testu odporności na zakłócenia i udowodnionego budzenia. Wyjście front-endu na
GPIO1 ma być aktywne stanem niskim i w spoczynku wysokim. Sam aktywator nie
wpisuje ID do emulatora.
+12 -8
View File
@@ -3,9 +3,10 @@
## Status pomiarów
**Nie wykonano pomiarów prądu fizycznego prototypu.** Liczby poniżej są
szacunkami budżetu, nie wynikiem walidacji. DevKit nie nadaje się do deklaracji
poboru µA, ponieważ mostek USB-UART, LED i regulator mogą pobierać ok. 0,5–2 mA
lub więcej w zależności od płytki.
szacunkami budżetu, nie wynikiem walidacji. SuperMini nie nadaje się do deklaracji
poboru µA bez pomiaru: wbudowany regulator, LED i obwody pomocnicze zwiększają
pobór. Sam LF33CV ma w stanie ON typowo ok. 0,5 mA prądu własnego (maks. 1 mA
przy braku obciążenia), więc zasilanie stałe wymaga osobnego bilansu energetycznego.
## Harmonogram firmware
@@ -18,7 +19,8 @@ lub więcej w zależności od płytki.
- 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.
jako jedyne źródło wybudzenia, ponieważ RTC zawsze działa. Jeżeli cały układ
zasilany jest tylko z ACC, po ACC OFF nie ma zasilania, RTC ani transmisji.
## Szacunek ładunku dla ustawień domyślnych
@@ -35,10 +37,10 @@ obietnica poboru z akumulatora 12 V.
## Metoda pomiaru wymagana przed „validated”
1. **Cały DevKit w sleep:** miernik µA szeregowo na wejściu, nie przez USB.
1. **Cały SuperMini 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. **Goły moduł + zasilacz docelowy:** powtórzyć na wejściu 12 V i na 3,3 V.
Uwzględnić Iq regulatora, TVS, dzielniki i pull-upy.
2. **SuperMini + LF33CV:** powtórzyć pomiar na zabezpieczonym wejściu VIN i na
szynie 3,3 V. Uwzględnić Iq regulatora, TVS, 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ć
@@ -50,7 +52,9 @@ obietnica poboru z akumulatora 12 V.
## Wnioski dopuszczalne przed pomiarem
- Największy wpływ mają interwał, czas czuwania, PA i Iq całej płytki.
- Do wersji energooszczędnej potrzebny jest goły ESP32 i zasilacz o niskim Iq.
- Do wersji energooszczędnej trzeba zmierzyć cały SuperMini i LF33CV; przy
zasilaniu wyłącznie z ACC układ nie pobiera prądu po wyłączeniu zapłonu, ale
wtedy również nie nadaje w trybie parkingowym.
- 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.
+4 -4
View File
@@ -5,10 +5,10 @@ ID ani interwałów. Podstawowy firmware nie ma trybu FSK.
| Objaw | Możliwa przyczyna | Pomiar / sprawdzenie | Naprawa |
|---|---|---|---|
| `BLAD: brak CC1101` | złe zasilanie, CS/SPI, moduł nie 433 MHz | 3,3 V na VCC-GND; ciągłość 18/19/23/5; oznaczenie modułu | popraw okablowanie, skróć SPI, użyj właściwego modułu |
| `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 |
| UART nie odpowiada | za krótkie okno konsoli, zły baud/port | 115200 8N1, reset, właściwy /dev/ttyUSB | wpisz `stay 300` od razu po starcie |
| 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 |
@@ -18,8 +18,8 @@ ID ani interwałów. Podstawowy firmware nie ma trybu FSK.
| 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 | DevKit, regulator, LED, dzielniki | pomiar całej płytki wg `POWER.md` | goły moduł i właściwy zasilacz; nie zmieniaj protokołu |
| Po postoju brak TX | brownout, zasilanie, błąd NVS/CC1101 | log po restarcie, `batt`, `info`, budzik RTC | popraw zasilanie; każdy sen ma RTC, więc nie „naprawiaj” przez PARKING_SHUTDOWN |
| Pobór snu duży | SuperMini, LF33CV, 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 ACC, brownout, błąd NVS/CC1101 | czy po ACC OFF zostaje 3,3 V; log po restarcie, `batt`, `info` | przy zasilaniu tylko z ACC 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 |
## Gdy brak odbioru w samochodzie
+5 -5
View File
@@ -28,12 +28,12 @@ rtl_433_tests commit `1aa8c29…`. Pełne SHA znajdują się w `PROTOCOL.md`.
| Komenda | Wynik |
|---|---|
| `pio test -e native` | **20/20 PASS** — ramka, cztery niezależne wektory, negatywne, NVS, fake clock/radio, Clone IDs, LEARN, SINGLE, ACC, restart |
| `pio run -e esp32dev` | **PASS**, własne ostrzeżenia traktowane jako błędy (`-Werror`) |
| `pio run -e esp32c3supermini` | **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 |
| `git diff --check` | **PASS** |
| dwa czyste `tools/package_release.sh` | **PASS**, identyczne wszystkie 6 SHA-256 po ustawieniu `SOURCE_DATE_EPOCH=1761600000` |
| `bash tools/package_release.sh` | **PASS**, obraz ESP32-C3 z bootloaderem od `0x0` i manifestem SHA-256 |
Dane referencyjne: każdy z `gfile001`…`gfile004` dał dokładnie 16 zgodnych
rekordów, z oczekiwanym ID/flags/ciśnieniem/temperaturą. Syntetyczne ramki
@@ -103,7 +103,7 @@ Katalog `artifacts/release/`:
| Plik | Adres |
|---|---:|
| `bootloader.bin` | `0x1000` |
| `bootloader.bin` | `0x0` — adres dla ESP32-C3, nie `0x1000` |
| `partitions.bin` | `0x8000` |
| `boot_app0.bin` | `0xE000` |
| `firmware.bin` | `0x10000` |
@@ -117,8 +117,8 @@ samej aplikacji `firmware.bin` pod `0x10000` zwykle zachowuje NVS, ale przed
release użytkownik powinien wykonać test na własnym module.
```bash
PORT=/dev/ttyUSB0 bash tools/flash_release.sh
sha256sum -c artifacts/release/SHA256SUMS
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
+9 -6
View File
@@ -1,21 +1,21 @@
; PlatformIO - symulator czujnikow TPMS Schrader EG53MA4 (ESP32 + CC1101)
;
; Kompilacja: pio run -e esp32dev
; Kompilacja: pio run -e esp32c3supermini
; Testy: pio test -e native
; Upload: pio run -e esp32dev -t upload
; Upload: pio run -e esp32c3supermini -t upload
; Monitor: pio device monitor
;
; Zastrzezenie: projekt diagnostyczny/testowy - symulator generuje
; sztuczne dane cisnienia, nie zastepuje prawdziwych czujnikow TPMS.
[platformio]
default_envs = esp32dev
default_envs = esp32c3supermini
[env:esp32dev]
[env:esp32c3supermini]
; Wersje przypiete do zweryfikowanego buildu (espressif32 8.0.0,
; SmartRC-CC1101-Driver-Lib 3.0.2 = commit de6757e)
platform = espressif32@8.0.0
board = esp32dev
board = esp32-c3-devkitm-1
framework = arduino
monitor_speed = 115200
; Biblioteka CC1101 (ELECHOUSE_CC1101_SRC_DRV / SmartRC):
@@ -26,11 +26,14 @@ build_flags =
-Wall
-Wextra
-Werror
; Natywny USB-C SuperMini: konsola Serial i programowanie bez mostka UART.
-DARDUINO_USB_CDC_ON_BOOT=1
-DARDUINO_USB_MODE=1
[env:native]
; Przenosna logika: ramka, NVS i maszyna stanow (PIN_ACC wlaczony w testach).
platform = native
build_flags = -std=gnu++17 -Wall -Wextra -Werror -DPIN_ACC=32
build_flags = -std=gnu++17 -Wall -Wextra -Werror -DPIN_ACC=2
build_src_filter = -<*> +<tpms_frame.cpp> +<settings.cpp> +<app_state.cpp>
test_build_src = true
test_framework = unity
+13 -9
View File
@@ -4,26 +4,30 @@
#define FW_VERSION "2.0.0-rc.1"
/* ESP32 DevKit + CC1101 433 MHz (3,3 V). */
#define PIN_CC1101_SCK 18
#define PIN_CC1101_MISO 19
#define PIN_CC1101_MOSI 23
#define PIN_CC1101_CS 5
#define PIN_CC1101_GDO0 2
/* ESP32-C3 SuperMini + CC1101 433 MHz (3,3 V). */
#define PIN_CC1101_SCK 4
#define PIN_CC1101_MISO 5
#define PIN_CC1101_MOSI 6
#define PIN_CC1101_CS 7
#define PIN_CC1101_GDO0 10
#define PIN_BUTTON 26
#define PIN_BUTTON 3
#define BTN_ACTIVE_LEVEL 0
#define PIN_LED 27
/* Wbudowana niebieska LED na GPIO8 jest aktywna stanem niskim. */
#define PIN_LED 8
#define LED_ACTIVE_LEVEL 0
/* Opcje wylaczone do czasu zmontowania i przetestowania sprzetu. */
#ifndef PIN_LF_TRIGGER
#define PIN_LF_TRIGGER -1
#endif
/* LF dzieli z przyciskiem GPIO wakeup LOW na ESP32-C3. */
#define LF_ACTIVE_LEVEL 0
#ifndef PIN_ACC
#define PIN_ACC -1
#endif
#ifndef PIN_VBAT_ADC
#define PIN_VBAT_ADC 34
#define PIN_VBAT_ADC 0
#endif
#define VBAT_DIVIDER_R1 1000000.0f
#define VBAT_DIVIDER_R2 270000.0f
+8 -6
View File
@@ -155,7 +155,7 @@ static bool wake_sources_active(void)
return true;
}
#if PIN_LF_TRIGGER >= 0
if (digitalRead(PIN_LF_TRIGGER) == HIGH) {
if (digitalRead(PIN_LF_TRIGGER) == LF_ACTIVE_LEVEL) {
return true;
}
#endif
@@ -186,8 +186,8 @@ void setup(void)
settings_store_begin();
console_init();
#if PIN_LF_TRIGGER >= 0
pinMode(PIN_LF_TRIGGER, INPUT_PULLDOWN);
lf_previous = digitalRead(PIN_LF_TRIGGER) == HIGH;
pinMode(PIN_LF_TRIGGER, INPUT_PULLUP);
lf_previous = digitalRead(PIN_LF_TRIGGER) == LF_ACTIVE_LEVEL;
#endif
#if PIN_ACC >= 0
pinMode(PIN_ACC, INPUT);
@@ -208,10 +208,12 @@ void setup(void)
}
esp_sleep_wakeup_cause_t cause = esp_sleep_get_wakeup_cause();
bool transmit = cause != ESP_SLEEP_WAKEUP_EXT0 && cause != ESP_SLEEP_WAKEUP_EXT1;
bool transmit = cause != ESP_SLEEP_WAKEUP_GPIO;
g_app->begin(millis(), transmit);
#if PIN_LF_TRIGGER >= 0
if (cause == ESP_SLEEP_WAKEUP_EXT1) {
uint64_t wake_mask = cause == ESP_SLEEP_WAKEUP_GPIO
? esp_sleep_get_gpio_wakeup_status() : 0;
if ((wake_mask & (1ULL << PIN_LF_TRIGGER)) != 0) {
g_app->send_current();
}
#endif
@@ -234,7 +236,7 @@ void loop(void)
}
console_poll();
#if PIN_LF_TRIGGER >= 0
bool lf = digitalRead(PIN_LF_TRIGGER) == HIGH;
bool lf = digitalRead(PIN_LF_TRIGGER) == LF_ACTIVE_LEVEL;
if (lf && !lf_previous) {
g_app->send_current();
app_stay_awake(BOOT_STAY_AWAKE_MS);
+8 -4
View File
@@ -57,13 +57,17 @@ void power_deep_sleep(uint32_t seconds)
}
esp_sleep_enable_timer_wakeup((uint64_t)seconds * 1000000ULL);
#if PIN_BUTTON >= 0 || PIN_LF_TRIGGER >= 0
/* ESP32-C3 uzywa GPIO wakeup zamiast EXT0/EXT1. Oba wejscia sa
* aktywne nisko, wiec moga wspoldzielic jeden tryb GPIO_LOW. */
uint64_t wake_mask = 0;
#if PIN_BUTTON >= 0
esp_sleep_enable_ext0_wakeup((gpio_num_t)PIN_BUTTON, BTN_ACTIVE_LEVEL);
wake_mask |= 1ULL << PIN_BUTTON;
#endif
#if PIN_LF_TRIGGER >= 0
uint64_t ext1_mask = 1ULL << PIN_LF_TRIGGER;
esp_sleep_enable_ext1_wakeup(ext1_mask, ESP_EXT1_WAKEUP_ANY_HIGH);
wake_mask |= 1ULL << PIN_LF_TRIGGER;
#endif
esp_deep_sleep_enable_gpio_wakeup(wake_mask, ESP_GPIO_WAKEUP_GPIO_LOW);
#endif
esp_deep_sleep_start();
}
+5 -5
View File
@@ -24,7 +24,7 @@ void ui_init(void)
{
pinMode(PIN_BUTTON, BTN_ACTIVE_LEVEL ? INPUT_PULLDOWN : INPUT_PULLUP);
pinMode(PIN_LED, OUTPUT);
digitalWrite(PIN_LED, LOW);
digitalWrite(PIN_LED, LED_ACTIVE_LEVEL ? LOW : HIGH);
uint32_t now = millis();
bool raw = (digitalRead(PIN_BUTTON) == BTN_ACTIVE_LEVEL);
@@ -82,7 +82,7 @@ void ui_set_pattern(ui_pat_t pat)
led_blinks_left = 0;
led_on = false;
led_series = false;
digitalWrite(PIN_LED, LOW);
digitalWrite(PIN_LED, LED_ACTIVE_LEVEL ? LOW : HIGH);
led_next = millis();
}
@@ -104,7 +104,7 @@ void ui_update(void)
if (led_series) {
if (led_on) {
/* koniec migniecia */
digitalWrite(PIN_LED, LOW);
digitalWrite(PIN_LED, LED_ACTIVE_LEVEL ? LOW : HIGH);
led_on = false;
if (led_blinks_left > 0) {
led_blinks_left--;
@@ -113,7 +113,7 @@ void ui_update(void)
}
else if (led_blinks_left > 0) {
/* kolejne migniecie */
digitalWrite(PIN_LED, HIGH);
digitalWrite(PIN_LED, LED_ACTIVE_LEVEL ? HIGH : LOW);
led_on = true;
led_next = now + 90;
}
@@ -135,7 +135,7 @@ void ui_update(void)
/* rozpoczynamy serie wg wzorca */
if (led_pat == UI_PAT_OFF) {
digitalWrite(PIN_LED, LOW);
digitalWrite(PIN_LED, LED_ACTIVE_LEVEL ? LOW : HIGH);
led_next = now + 50;
return;
}
+1 -1
View File
@@ -26,7 +26,7 @@ run() {
run python-self-test python3 tools/tpms_frame.py --self-test
run native-tests "$PIO_BIN" test -e native
run esp32-build "$PIO_BIN" run -e esp32dev
run esp32-build "$PIO_BIN" run -e esp32c3supermini
run cppcheck "$PIO_BIN" check -e native \
--flags='--enable=warning,performance,portability --inline-suppr' \
--fail-on-defect=low
+3 -3
View File
@@ -1,9 +1,9 @@
#!/usr/bin/env bash
# Wgrywa pelny obraz release; PORT=np. /dev/ttyUSB0. Kasuje flash ESP32.
# Wgrywa pelny obraz release; PORT=np. /dev/ttyACM0. Kasuje flash ESP32-C3.
set -euo pipefail
ROOT="$(cd "$(dirname "$0")/.." && pwd)"
PORT="${PORT:?Ustaw PORT=/dev/ttyUSBX}"
PORT="${PORT:?Ustaw PORT=/dev/ttyACMX lub /dev/ttyUSBX}"
ESPTOOL="${ESPTOOL:-${PLATFORMIO_CORE_DIR:-$HOME/.platformio}/packages/tool-esptool/esptool}"
IMAGE="$ROOT/artifacts/release/firmware-full.bin"
[ -f "$IMAGE" ] || { echo "Brak $IMAGE; uruchom tools/package_release.sh"; exit 1; }
"$ESPTOOL" --chip esp32 --port "$PORT" --baud 460800 write-flash 0x0 "$IMAGE"
"$ESPTOOL" --chip esp32c3 --port "$PORT" --baud 460800 write-flash 0x0 "$IMAGE"
+7 -7
View File
@@ -1,5 +1,5 @@
#!/usr/bin/env bash
# Buduje obrazy ESP32 i pelny obraz 4 MB oraz manifest SHA-256.
# Buduje obrazy ESP32-C3 i pelny obraz 4 MB oraz manifest SHA-256.
set -euo pipefail
ROOT="$(cd "$(dirname "$0")/.." && pwd)"
cd "$ROOT"
@@ -7,18 +7,18 @@ PIO_BIN="${PIO:-$ROOT/.venv/bin/pio}"
if [ ! -x "$PIO_BIN" ]; then PIO_BIN="${PIO:-pio}"; fi
export SOURCE_DATE_EPOCH="${SOURCE_DATE_EPOCH:-1761600000}"
OUT="$ROOT/artifacts/release"
BUILD="$ROOT/.pio/build/esp32dev"
BUILD="$ROOT/.pio/build/esp32c3supermini"
BOOT_APP0="${PLATFORMIO_CORE_DIR:-$HOME/.platformio}/packages/framework-arduinoespressif32/tools/partitions/boot_app0.bin"
ESPTOOL="${ESPTOOL:-${PLATFORMIO_CORE_DIR:-$HOME/.platformio}/packages/tool-esptool/esptool}"
"$PIO_BIN" run -e esp32dev
"$PIO_BIN" run -e esp32c3supermini
mkdir -p "$OUT"
cp "$BUILD/bootloader.bin" "$BUILD/partitions.bin" "$BUILD/firmware.bin" \
"$BUILD/firmware.elf" "$OUT/"
cp "$BOOT_APP0" "$OUT/boot_app0.bin"
"$ESPTOOL" --chip esp32 merge-bin -o "$OUT/firmware-full.bin" \
"$ESPTOOL" --chip esp32c3 merge-bin -o "$OUT/firmware-full.bin" \
--flash-mode dio --flash-freq 40m --flash-size 4MB \
0x1000 "$OUT/bootloader.bin" 0x8000 "$OUT/partitions.bin" \
0x0 "$OUT/bootloader.bin" 0x8000 "$OUT/partitions.bin" \
0xe000 "$OUT/boot_app0.bin" 0x10000 "$OUT/firmware.bin"
(
cd "$OUT"
@@ -28,9 +28,9 @@ cp "$BOOT_APP0" "$OUT/boot_app0.bin"
cat > "$OUT/BUILD-INFO.txt" <<'EOF'
Wersja: 2.0.0-rc.1 (release candidate, bez HIL)
PlatformIO: 6.1.18
Platforma: espressif32 8.0.0
Platforma: espressif32 8.0.0, ESP32-C3 SuperMini (esp32-c3-devkitm-1)
CC1101: de6757ef633b3e626dae5c7835cdb66ab53f9a1d
Adresy: 0x1000 bootloader, 0x8000 partitions, 0xe000 boot_app0, 0x10000 firmware
Adresy: 0x0 bootloader, 0x8000 partitions, 0xe000 boot_app0, 0x10000 firmware
Pelny obraz firmware-full.bin: flash od 0x0.
EOF
cat "$OUT/BUILD-INFO.txt"