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
182 lines
7.7 KiB
Markdown
182 lines
7.7 KiB
Markdown
# Schrader EG53MA4 TPMS Simulator — ESP32-S2-MINI + CC1101
|
||
|
||
**Version 2.0.0-rc.1 — release candidate without hardware validation.**
|
||
|
||
A workshop device that transmits four independent TPMS identifiers with the
|
||
OOK/Manchester Schrader EG53MA4 profile on 433.92 MHz. By default each wheel
|
||
reports **260 kPa (2.6 bar; protocol byte `0x68`)**. The target scenario is
|
||
diagnostics of an Opel Astra J Sedan 1.4 LPG (2016, EU), but **compatibility
|
||
must be confirmed for the specific car**: via VIN/service listings, markings of
|
||
factory sensors, a diagnostic readout, or a reception test. OE number
|
||
13506028, related part numbers, or a listing offer alone do not confirm the
|
||
radio profile.
|
||
|
||
> **This is not a homologated sensor nor a replacement for a working TPMS.
|
||
> Do not use while driving.** Synthetic pressure can hide a punctured or
|
||
> underinflated tyre and delay the warning. Before and after the test, check
|
||
> all tyres with an independent gauge. See [SAFETY](docs/SAFETY.md).
|
||
|
||
## What is done, and what is not
|
||
|
||
- Done: ESP32 build, frame/NVS/state-machine tests, synthetic CU8 decoded by
|
||
an independent `rtl_433`, persistent configuration from the console, Clone
|
||
IDs and LEARN.
|
||
- **Not done:** measurement of a real CC1101, RTL-SDR with an antenna, a test
|
||
with a car, current measurement, and automotive tests. That is why the
|
||
result is RC, not "validated".
|
||
- The only base profile is **OOK**. Do not switch to FSK "just to try it".
|
||
- The ESP32 does not generate the 433 MHz carrier — a separate CC1101 433 MHz
|
||
is required.
|
||
|
||
## Concept sketch
|
||
|
||
```text
|
||
Bench prototype:
|
||
USB-C ──> [ESP32-S2-MINI] ── SPI ──> [CC1101 433 MHz] ──> SMA antenna
|
||
│ │ │
|
||
│ └── GPIO0: button (BOOT) └── common GND, 3.3 V only
|
||
└── GPIO15: built-in LED (active HIGH)
|
||
|
||
Target supply from the car cigarette-lighter socket:
|
||
variant A: socket ──> [USB car charger] ──> board USB-C
|
||
variant B: socket ──> fuse/TVS ──> [LM317T 3.3 V] ──> 3V3 + CC1101 VCC
|
||
|
||
Configuration: USB CDC 115200 → NVS → 4 × {ID, pressure, temperature}
|
||
```
|
||
|
||
Set the LM317T output with the divider to **3.3 V and connect it to 3V3, not
|
||
to 5V**. Do not connect 12 V to GPIO, 3V3, or 5V. When powering from an
|
||
external 3.3 V source, disconnect USB unless source separation has been
|
||
verified for the specific board revision. In most cars the cigarette-lighter
|
||
socket is powered only after the ignition is switched on — **check this in
|
||
your own car**. Then the emulator draws no current while parked; the car
|
||
computer does not read TPMS state with the ignition off anyway, so lacking
|
||
parking transmission does not matter. Full pinout, the LM317T divider, and
|
||
capacitors: [HARDWARE](docs/HARDWARE.md).
|
||
|
||
## Quick Start
|
||
|
||
### 1. Assemble the prototype
|
||
|
||
Buy the parts from the [BOM](docs/HARDWARE.md#laboratory-prototype-bom).
|
||
Connect the CC1101 and the button according to the pin table; the LED is
|
||
already on the S2 Mini board. On the bench, power the device through a tested
|
||
USB-C cable that carries data. Do not install anything in the car yet.
|
||
|
||
### 2. Install the tools and verify the project
|
||
|
||
Required: Python 3, Git, CMake, a C/C++ compiler, `pkg-config`, and the
|
||
libusb and librtlsdr headers. The easiest way is Docker:
|
||
|
||
```bash
|
||
docker build -t tpms-rc .
|
||
docker run --rm -v "$PWD/artifacts:/work/artifacts" tpms-rc
|
||
```
|
||
|
||
Without Docker, the script creates a `.venv` with PlatformIO, fetches the
|
||
pinned `rtl_433`, and the reference recordings:
|
||
|
||
```bash
|
||
bash tools/check_all
|
||
```
|
||
|
||
The last message must read `PASS: all hardware-free tests...`.
|
||
It is not a test of physical radio.
|
||
|
||
### 3. Build and flash
|
||
|
||
```bash
|
||
.venv/bin/pio run -e esp32s2mini
|
||
.venv/bin/pio run -e esp32s2mini -t upload
|
||
.venv/bin/pio device monitor --baud 115200
|
||
```
|
||
|
||
If the port is not detected automatically, add `--upload-port /dev/ttyACM0`
|
||
(for `run`) or `--port /dev/ttyACM0` (for `device monitor`). Depending on the
|
||
system and USB mode it may also be `/dev/ttyUSB0`. In the PlatformIO monitor,
|
||
the exit shortcut is usually `Ctrl+]`. If the upload does not start, hold
|
||
**BOOT**, press and release **RESET**, then release BOOT.
|
||
|
||
After startup, type `stay 300` and press Enter. You have 5 minutes to
|
||
configure; the `info` command shows active values. Every configuration change
|
||
is saved to NVS immediately and survives a restart — **do not edit IDs in
|
||
code**.
|
||
|
||
### 4A. Preferred: Clone IDs
|
||
|
||
If you know the original 24-bit IDs (e.g. from an earlier `rtl_433` readout),
|
||
enter them in FL, FR, RR, RL order. Example — replace the values with your
|
||
own:
|
||
|
||
```text
|
||
stay 300
|
||
id 1 2FC871
|
||
id 2 2EAAF9
|
||
id 3 3495AC
|
||
id 4 2FC780
|
||
pressure all 260
|
||
info
|
||
send
|
||
```
|
||
|
||
An ID must have six hex digits, be non-zero, differ from `FFFFFF`, and be
|
||
unique. The device returns to NORMAL and transmits the known IDs. **Learning
|
||
may be unnecessary, but that is not guaranteed.** Confirm reception
|
||
diagnostically; do not start with a road drive.
|
||
|
||
### 4B. Alternative: New IDs + LEARN
|
||
|
||
1. Type `ids new`, then `info`, and write down the generated IDs.
|
||
2. Start the TPMS learning procedure appropriate for your car model/version
|
||
according to its service instructions. Do not guess menu/pedal sequences.
|
||
3. Type `mode learn`. It transmits FL only, every 2 s. The LED shows 1 blink.
|
||
4. `send` forces the current wheel without changing it. After confirming the
|
||
step in the car, type `next`: FR → RR → RL. A short button press does the
|
||
same; after RL it returns to NORMAL.
|
||
5. If 60 s passes on a wheel, LEARN interrupts to NORMAL. The whole session
|
||
has a 15 min limit. When finished, verify the IDs and diagnostic codes.
|
||
|
||
EL-50448/OEC-T5 is a 125 kHz LF activator, **not an ESP32 programmer**. This
|
||
procedure does not require it. Details: [SETUP](docs/SETUP.md).
|
||
|
||
## Controls — one table
|
||
|
||
The LED works only while awake; in deep sleep it is off. After a wheel change,
|
||
a series of 1–4 blinks indicates FL/FR/RR/RL.
|
||
|
||
| Mode | LED pattern | Short button | Long ≥1.5 s | Very long ≥4 s |
|
||
|---|---|---|---|---|
|
||
| NORMAL | 1 blink / 2 s | burst of all 4 | enter LEARN | enter SINGLE |
|
||
| LEARN | 3 blinks / 0.5 s; changes with wheel number | next wheel + TX; after RL done | exit to NORMAL | enter SINGLE |
|
||
| SINGLE | 2 blinks / 0.5 s; changes with wheel number | next wheel + TX | enter LEARN | exit to NORMAL |
|
||
|
||
In the console, `send` in NORMAL transmits all wheels, and in LEARN/SINGLE
|
||
only the current one. `send 1`…`send 4` select a wheel explicitly; `send all`
|
||
transmits four. SINGLE shuts off after 5 min.
|
||
|
||
## Most common problems
|
||
|
||
- **`ERROR: no CC1101`**: check 3.3 V, common ground, and SCK/MISO/MOSI/CS
|
||
on GPIO4/5/6/7 and GDO0 on GPIO10; do not use 5 V on the CC1101.
|
||
- **Console disappears before you enter commands**: right after restart type
|
||
`stay 300`; a plain RTC wake deliberately does not open the console window.
|
||
- **NVS reports an error**: the device uses safe defaults; type `info`.
|
||
`factory YES` erases your IDs and restores the factory configuration.
|
||
- **The car does not receive**: first verify the car profile and RTL-SDR
|
||
reception; do not randomly change modulation, flags, or intervals. See
|
||
[TROUBLESHOOTING](docs/TROUBLESHOOTING.md).
|
||
|
||
## Validation, power, and release
|
||
|
||
- Protocol and unknowns: [PROTOCOL](docs/PROTOCOL.md)
|
||
- Detailed results and the HIL checklist: [VALIDATION](docs/VALIDATION.md)
|
||
- Consumption (estimates so far): [POWER](docs/POWER.md)
|
||
- LM317T and power from the cigarette-lighter socket:
|
||
[HARDWARE](docs/HARDWARE.md#cigarette-lighter-socket-variant--requirements-unvalidated-design)
|
||
- Changes: [CHANGELOG](CHANGELOG.md)
|
||
|
||
Release images are produced by `bash tools/package_release.sh`. The files and
|
||
addresses are described in
|
||
[VALIDATION](docs/VALIDATION.md#artifacts-and-flashing). The release candidate
|
||
does not include a CC1101 test result or a car test.
|