Start Doctor

The Start Doctor is a real-time diagnostic tool that watches your ECU data while you crank the engine and automatically checks the most common reasons an engine fails to start. When you stop the consultation it gives you a ranked list of problems to investigate, with direct links to the relevant settings page where appropriate.

Opening the Start Doctor

Open the Start Doctor from the sidebar → Tools → 🩺 Start Doctor. The panel is only available when an ECU is connected or a log file is loaded.

The panel layout has four areas:

• Header bar — title, phase badge (IDLE / CRANKING / RUNNING / FAILED), and the control buttons.
• Diagnostic Checks (left column) — ten cards, one per check, updated as data arrives.
• Live Vitals (right column) — ten real-time sparklines showing RPM, battery, MAP, pulse width, AFR, temperatures, TPS, advance, and dwell.
• Channel History (bottom) — a 10-second scrolling graph of RPM, battery voltage, MAP, pulse width, and AFR.

Running a Consultation

1. Connect to your ECU (or load a log file — see Loading a Log File below).
2. Click ▶ Start Consultation.
3. Crank the engine as you normally would.
4. The Start Doctor watches the data and updates the diagnostic cards as it gathers information.
5. Click ⏹ Stop & Diagnose when you are done, or let the engine run — the Doctor automatically transitions to RUNNING or FAILED when the engine fires or cranking times out (10 seconds).

Auto-recording: As soon as you click Start Consultation, VETuner automatically begins recording a log file if one is not already in progress. The log is saved to a file when the consultation ends. This means you always have a recording of the diagnostic session to share with others.

Engine Phases

The Doctor tracks which phase the engine is in and adjusts all checks accordingly:

Once cranking is detected the phase only moves forward — only ↺ Reset returns to IDLE.

Diagnostic Cards

Each card corresponds to one automated check. The status icons and border colours tell you at a glance what the Doctor has found:

Cards update approximately every five samples (~100 ms at 50 Hz). Hover or tap a card to see its detail text.

What the Doctor Checks

Battery Voltage

Checks battery voltage before and during cranking.

• Warns if voltage is below 12.0 V before cranking (battery not fully charged).
• Warns if cranking voltage drops below 9.5 V — borderline for reliable spark and injection.
• Fails if cranking voltage drops below 7.0 V — almost certain to cause misfires and no-starts.
• Advice includes checking the 12 V supply rail that goes live in RUN but is sometimes missing during cranking (a surprisingly common wiring issue).

Crank Sensor

Checks whether the ECU can see the engine turning.

• Fails if RPM remains at zero throughout cranking — no signal at all.
• Warns if RPM is erratic (standard deviation > 150 RPM) — check trigger wheel, air gap, and shielding.
• Monitors the ECU's sync-loss counter (synccnt / syncLossCounter) — warns at 1+ events, fails at 3+.
• Also detects RPM dropout — RPM briefly falling to zero while other channels remain normal — which is the signature of crank-position sync loss even without a dedicated counter.
• Monitoring continues into the RUNNING phase; sync losses during running will also be flagged.

MAP Sensor

Checks the manifold air pressure sensor while the engine is cranking.

• Fails if variance is too low (sensor stuck or disconnected).
• Warns if MAP fluctuation is very wild (broken hose, large vacuum leak).
• Warns if MAP never drops below 80 kPa during cranking — the intake should develop some vacuum; if it does not, compression or cam timing may be wrong.

If the throttle is open during cranking (detected from TPS), high MAP is expected, and the check is suppressed to avoid false positives.

Temperature Sensors

Checks that coolant (CLT) and intake air (IAT) temperatures are within plausible ranges.

• Warns if readings are outside −20 °C to 150 °C (CLT) or −40 °C to 80 °C (IAT).
• Warns if a sensor appears stuck (variance < 0.01 over a full window) — likely an open circuit.
• Auto-detects °F vs °C: if readings exceed the °C maximum but fall within the °F range, Fahrenheit is assumed and thresholds are adjusted accordingly.

Pulse Width

Confirms the ECU is actually commanding fuel delivery.

• Fails during cranking if the maximum commanded pulse width seen is below 0.5 ms — the ECU is not scheduling any fuel. This is a configuration problem: check cranking enrichment, priming pulse, and prime-pulse duration settings.
• Warns during running if commanded pulse width is suspiciously low or saturated above 20 ms (injectors at duty-cycle limit).

AFR

Checks the air-fuel ratio from your wideband or narrowband O₂ sensor.

• Fails if AFR is below 8.0 (extremely rich — stuck injector, fuel pressure issue, or sensor fault).
• Fails if AFR is above 20.0 (extremely lean — potential engine damage from detonation).
• Warns at AFR < 10.0 (rich) or > 18.0 (lean).

If the engine never fires and AFR reads rich, the Doctor interprets this as unburnt fuel passing the sensor (normal) and suppresses the AFR symptom so it does not drown out the real problem.

Signal Quality

Checks for excessive electrical noise on the battery voltage, MAP, TPS, CLT, and IAT channels using two complementary methods:

Spike detection (all phases, including cranking): detects large sample-to-sample jumps on any channel that exceed a per-channel threshold. Legitimate cranking changes — smooth battery voltage sag, gentle MAP pulsing — produce small deltas and do not trigger spikes. Sudden transients caused by bad grounds, poor shielding, or faulty sensor wiring do.

Variance analysis (idle, running, and failed phases only): warns if the standard deviation of battery voltage, MAP, or TPS exceeds its noise threshold (0.3 V, 5 kPa, or 1.5 % respectively). This part of the check is limited to non-cranking phases because the starter motor legitimately inflates variance — battery voltage sags smoothly while cranking, and MAP fluctuates with each compression stroke — which would otherwise produce false positives.

ECU Stability

Monitors the ECU's seconds counter (SecL) to detect unexpected reboots.

• Warns on the first reboot — power supply, grounds, or alternator noise.
• Fails on two or more reboots — the ECU is crashing repeatedly.
• Natural byte-boundary wrap-arounds (255 → 0, 65535 → 0, etc.) are correctly ignored.

Enrichment

Checks the ECU's enrichment strategy (warm-up enrichment, after-start enrichment, air-density correction) that is needed to fire a cold engine.

• Reads enrichment values from the live data and cross-checks them against the ECU constants from your tune file.
• Requires the engine to have entered the RUNNING or FAILED phase before a conclusion is drawn.

Ignition Advance

Checks that cranking ignition advance is within a sensible range.

• Fails if peak advance exceeds 25° — excessive advance during cranking risks starter kickback and mechanical damage.
• Warns if advance exceeds 15° — most engines start most reliably between 6° and 10°.
• Warns if advance is below 2° — too little for reliable ignition.
• Warns if dwell is below 0.5 ms — coil may not be charging sufficiently for a strong spark.

The Diagnosis

When the consultation ends (you press Stop, the engine starts, or cranking times out), the Diagnosis overlay appears automatically.

The overlay shows:

• A summary line — "All clear" or the number of problems found.
• Up to three ranked problems, each with:
  • A severity badge (🔴 Critical / 🟡 Warning).
  • A type badge — ⚙️ Configuration (fixable in the app) or 🔧 Physical (wiring / hardware).
  • The problem title and the detail message from the diagnostic card.
  • Advice text in italic.
  • For configuration problems, a Open [Settings] → button that navigates directly to the relevant settings dialog.
• A footer note if more than three issues were found.

How problems are ranked

The Doctor uses a heuristic expert system that reasons about cause and effect:

• Root causes are promoted to the top. If the pulse width check fails (ECU not commanding fuel), that is ranked above a lean AFR reading, because the lean condition is a consequence of the missing fuel command, not an independent problem.
• Downstream consequences are suppressed to avoid noise. A rich AFR when the engine never fired is expected (unburnt fuel passing the sensor) and is filtered out unless it persists after firing.
• ECU reboots are always raised to highest priority — an unstable ECU makes every other check unreliable.
• Stall patterns influence enrichment diagnosis: a stall within three seconds of starting points straight at after-start enrichment (ASE); a stall within thirty seconds points to warmup enrichment (WUE).

Stall pattern classification

If the engine starts and then stalls, the Doctor classifies the stall:

Threshold Overrides

Advanced users can adjust the thresholds used by each check. Click ⚙️ Thresholds in the header to open the drawer.

Thresholds are organised into nine groups — Battery, Crank Sensor, MAP Sensor, Temperatures, Signal Noise, Pulse Width, AFR, Ignition, and Stall Detection.

• Modified values are highlighted with an amber border so you can see at a glance what has been changed.
• Changes apply immediately to the running consultation.
• Values are saved to localStorage under startDoctor_thresholdOverrides and persist across sessions.
• Click ↺ Defaults to restore all thresholds to the built-in values.

Overrides survive ↺ Reset — they are configuration, not session state.

Loading a Log File

You do not need a live ECU connection to use the Start Doctor. Click 📂 Load Log to load a previously recorded log file (MLG, MSL+MSQ, or JSON recording). VETuner replays the log through the same Start Doctor engine, giving you a full analysis of a past cranking attempt.

VETuner Pro required. Loading a previously saved log file is a VETuner Pro feature. Upgrade to VETuner Pro to unlock log file analysis.

This is useful for:

• Diagnosing a friend's engine based on a log they have sent you.
• Comparing before-and-after logs after making a change.
• Getting a diagnosis on a log file captured on the dyno or during a road session.

Tips

• Record multiple attempts. The Doctor analyses one cranking event per consultation, but you can load the same log file multiple times to examine different attempts within it, or load separate recordings.
• Share the auto-captured log. Every consultation automatically creates a log file. If you cannot diagnose the problem yourself, share that file with someone else who can load it in VETuner.
• Check battery first. A low battery affects almost every other check. A fully charged battery (12.6 V resting) eliminates one of the most common no-start causes before you investigate anything else.
• Cranking advance matters. Many people tune the running advance tables carefully and ignore the cranking advance. If the Ignition card warns about high advance, lowering the cranking advance to 8°–10° is a quick win.
• Trust the suppression. If you see only one or two problems after a complicated-looking crank, the Doctor has already filtered out the downstream noise — focus on what the Diagnosis actually highlights.

Related

• Starting Your Engine — first-time starting checklist and beginner guidance
• Connecting to Your ECU — setting up a live ECU connection
• VE Analysis — automated VE table correction once the engine is running reliably