Documentation — Tuning guide
MS41 Live / Docs / Tuning guide
Tuning guide
A practical order of work: make the numbers describe your engine, get the VE table right with the wideband, then decide mixture and timing. Change one thing at a time and let the measurements decide.
1. Describe the engine
On Fuel › Engine & injectors, check the values the fuel calculation is built on:
- Displacement of the engine.
- Injector flow at your fuel pressure, and the dead time table against battery voltage, from the injector data.
- Stoichiometric ratio and density of the fuel: 14.7 for gasoline, 14.1 for E10.
If these are right, a change of injectors or fuel is a change of these settings, and the VE table keeps its meaning. These settings need a flash.
air = VE × MAP × (displacement ÷ 6) ÷ (R × 313 K) × IAT correction
fuel = air × 14.7 ÷ (AFR target × stoich)
pulse width = fuel ÷ injector flow + dead time
2. Trust the sensors first
A VE table tuned against a wrong MAP or AFR reading is wrong everywhere. Do the checks in Sensors & calibration before touching a table: barometric pressure with the engine off, and the AFR gauge against the controller’s display.
3. Set the AFR targets
The AFR target table (16 × 20, MAP × RPM) is what the ECU aims for everywhere: it is used in the fuel calculation and by the wideband closed loop. Values are on the gasoline scale (14.7 = lambda 1) whatever the fuel; the table can be displayed as lambda.
The base tunes hold 14.7 at light load and get richer towards full load and into boost. Set the targets you actually want before tuning VE: the VE corrections are computed against them.
4. Tune the VE table
Work with the engine fully warm, so that warm-up enrichment is out of the picture.
- Connect the editor and open Fuel › VE table. The cursor shows the cell the engine is in.
- Hold a steady operating point — constant RPM and load — for a few seconds.
- Read AFR, Target and Fuel trim on the gauges.
- Compute the correction for that cell and apply it.
- Move to the next operating point. Smooth and interpolate between tuned cells.
VE correction = measured AFR × (1 + trim) ÷ target AFR
The trim is the fuel the closed loop is already adding (positive) or removing (negative). Example: target 14.7, measured 14.9, trim +4 %. Correction = 14.9 × 1.04 ÷ 14.7 = 1.054: raise VE in that cell by about 5 %. With the VE right, the engine sits on target with a trim near zero.
- Outside closed loop the trim is zero and the formula is simply measured ÷ target.
- Use steady points only. The exhaust gas takes a few tenths of a second to reach the sensor: during a throttle movement, the AFR you read belongs to an earlier cell.
- Edit in percent. Select the cells around the cursor and use the percentage buttons; the change is in the ECU immediately.
- Start where it is safe: idle, cruise, light acceleration. Go to high load last, in short pulls, and lift at once if the mixture goes lean.
- Arm the lean-AFR protection before high-load work. See Motorsport functions.
The stock long-term fuel adaptation stays active and is not one of the editor’s gauges. A VE table that needs little short-term trim across the map keeps it small.
Boost. The tables go to 200 kPa, but boosted operation has not been validated on a car. In the base tunes, everything above atmospheric pressure is an untested starting point.
5. Throttle transients
A lean spike when the throttle opens, followed by a correct mixture, is not a VE problem. Use the Acceleration enrichment page: amount, load factor and decay. A spike that lasts longer than the enrichment calls for a longer decay rather than a larger amount.
6. Ignition
The Ignition table (16 × 20, MAP × RPM) is the base advance. The stock BMW corrections are applied afterwards, and the stock knock control stays active.
- The Knock gauge shows the timing currently pulled by knock control. Where it pulls timing repeatedly in the same cells, reduce the base advance there.
- Knock sensors also hear mechanical noise. Retard that appears at low RPM and light load, with no audible knock, deserves a mechanical check before a timing change.
- Above 100 kPa the base tunes carry conservative values that have not been tested. Timing under boost must be established on a dyno with proper knock monitoring.
7. Idle
Idle keeps the stock strategy. The Idle pages hold the target speed against coolant temperature (with and without air conditioning) and the base position of the idle control valve. Idle timing has its own table on Ignition › Idle timing.
- Tune the VE cells around idle first: a correct mixture is the basis of a stable idle.
- If the warm idle sits above its target, the base position of the idle valve is probably too high; if the engine dips or stalls when you lift off, it is too low.
- Engine speed that hangs when you lift off is governed by the dashpot and by the valve opening against throttle, on Idle › ICV & dashpot.
8. Cold start and warm-up
Cranking, after-start and warm-up enrichment are the stock BMW strategies, with their tables on the Starting pages.
- Tune VE warm first. Then correct cold running with the warm-up tables — not with the VE table.
- The wideband is not ready in the first seconds after a cold start: ignore the AFR reading until the controller is.
- As in the stock software, closed loop starts once the engine has warmed past a coolant threshold; before that the mixture is whatever VE, targets and enrichment give.
9. Keep your work
Live edits live in ECU RAM. At the end of a session, flash the calibration (Flashing) and save the tune file under a new version name. Keeping one file per session makes it easy to go back.

