Files
czcionka e183d23950
check / check-without-hardware (push) Successful in 6m45s
Docs and code: translate Polish comments, messages and documentation to English
- 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
2026-10-30 18:01:32 +00:00

7.7 KiB
Raw Permalink Blame History

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.

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

  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.

Quick Start

1. Assemble the prototype

Buy the parts from the 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:

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 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

.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:

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.

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.

Validation, power, and release

  • Protocol and unknowns: PROTOCOL
  • Detailed results and the HIL checklist: VALIDATION
  • Consumption (estimates so far): POWER
  • LM317T and power from the cigarette-lighter socket: HARDWARE
  • Changes: CHANGELOG

Release images are produced by bash tools/package_release.sh. The files and addresses are described in VALIDATION. The release candidate does not include a CC1101 test result or a car test.