DTC opinions
Per-DTC repair paths contributed by owners and indie technicians. Each opinion includes the typical DIY, indie and dealer cost ranges, severity, and citations to the in-repo source.
| Code | Source | Severity | Notes |
|---|---|---|---|
| 29E0 | community/opinions/29E0.toml | warn | Fuel injection rail, pressure sensor signal. The N54 HPFP headline. |
| 2A82 | community/opinions/2A82.toml | warn | VANOS intake control fault. Solenoid-clogging on higher-mileage cars. |
| P0171 | community/opinions/P0171.toml | warn | System too lean (Bank 1). Vacuum leak or tired MAF. |
Guided testplans
Step-by-step diagnostic walkthroughs for specific fault codes. Each testplan is a branching graph of measurements and conclusions, with in-repo citations at every step.
| Code | Steps | Source |
|---|---|---|
| 2A82 | 8 | community/testplans/2A82.toml — VANOS solenoid diagnostic walkthrough |
| 29E0 | 9 | community/testplans/29E0.toml — HPFP family diagnostic |
| 29E1 | 9 | community/testplans/29E1.toml — rail pressure plausibility |
| 29E2 | 8 | community/testplans/29E2.toml — rail pressure over-range |
| 29CC | 7 | community/testplans/29CC.toml — cylinder 1-4 misfire |
| 2E81 | 7 | community/testplans/2E81.toml — electric coolant pump |
| 2E82 | 7 | community/testplans/2E82.toml — electric coolant pump speed |
| 30FF | 9 | community/testplans/30FF.toml — turbocharger underboost |
| P0171 | 9 | community/testplans/P0171.toml — system too lean (with N55/S55 fuel-trim DIDs) |
| P0300 | 9 | community/testplans/P0300.toml — random misfire |
| P0420 | 9 | community/testplans/P0420.toml — catalyst efficiency (diagnose only) |
Freeze-frame schemas
Per-ECU freeze-frame schemas. Define which DIDs the DME records when a code triggers, and how to decode the bytes into engineering units.
| Address | Source | Coverage |
|---|---|---|
0x12 (DME) | community/freeze/12.toml | Engine RPM, coolant, IAT, MAF, fuel trim, O2 sensor voltages, short-term fuel trim, vehicle speed, ambient pressure |
0x18 (EGS) | community/freeze/18.toml (planned) | Gear, input/output shaft speed, fluid temp, torque request |
0x29 (DSC) | community/freeze/29.toml | Wheel speeds, brake pressure, steering angle, yaw rate, lateral G |
0x60 (KOMBI) | community/freeze/60.toml (planned) | Mileage, fuel level, oil-temp, CBS counters |
0x72 (IHKA / climate) | community/freeze/72.toml | Cabin temp, set temp, fan speed, blend door position |
Engine profiles
Each BMW engine Beemuu supports has a profile in community/profiles/<id>.toml. The profile lists every parameter the engine control module exposes, the query path (OBD-II PID or UDS DID), the decoder (how raw bytes become engineering units), and the verification status.
Beemuu ships 10 production-engine profiles plus an example harness profile:
- B48 / B46 — 22 params, 14 verified
- B58 — 22 params, 20 verified
- N20 / N26 — 22 params, 14 verified
- N52 — 10 params, 9 verified
- N54 — 12 params, 11 verified
- N55 — 25 params, 24 verified
- N57 — 30 params, 21 verified
- N62 — 13 params, 13 verified
- S55 — 25 params, 16 verified
- S58 — 23 params, 14 verified
example_e70_n62— example profile, not a production engine
How to contribute
See the contributing guide for the full process. The shortest path is a TOML contribution:
- Pick a directory.
opinions for per-DTC repair paths. testplans for guided diagnostic walkthroughs. freeze for per-ECU freeze-frame schemas. profiles for engine parameter catalogs.
- Follow the schema.
Each subdirectory has a README documenting the schema. Use the existing files as templates.
- Open a PR.
CI runs the TOML parse gate. A broken data file fails the build rather than silently loading.
- File a real-car verification report (optional).
If your contribution flips a parameter from unverified to verified, file a
docs/validation/report with the harness output.
Community questions
What is the Beemuu community knowledge base?
TOML files in community/opinions, community/testplans, community/freeze, and community/profiles. All CI-gated for syntax.
How do I contribute?
Add a TOML file in the right directory, follow the schema, open a PR. CI does the rest. See /contributing.html.