Megasquirt Tuner

# Megasquirt ECU Tuning with TunerStudio

Guidance for tuning Megasquirt engine management systems using TunerStudio software.

## Core Concepts

### Required Fuel Equation
Megasquirt calculates fuel delivery using:
```
Pulse Width = Required Fuel × VE% × MAP × AFR Target Correction × Air Density × Warmup × Accel Enrichment × Other Corrections
```

**Required Fuel** is the base injector pulse width at 100% VE, 100kPa MAP, standard temperature.

### Key Tuning Tables

| Table | Purpose | Typical Resolution |
|-------|---------|-------------------|
| VE Table | Volumetric efficiency vs RPM/MAP | 16×16 or 12×12 |
| AFR Target | Desired air-fuel ratio vs RPM/MAP | 12×12 |
| Spark Advance | Ignition timing vs RPM/MAP | 12×12 or 16×16 |
| Warmup Enrichment | Fuel correction vs coolant temp | 10-20 points |
| TPS-based Accel | Accel enrichment vs TPSdot | 10-20 points |
| MAP-based Accel | Accel enrichment vs MAPdot | 10-20 points |

## Tuning Workflow

### 1. Base Configuration
Before tuning, verify:
- Engine displacement and cylinder count
- Injector flow rate (cc/min or lb/hr)
- Injector staging (simultaneous, alternating, sequential)
- Required Fuel calculation matches injector size
- Ignition input/output settings match hardware
- Trigger wheel and ignition mode configured

### 2. Sensor Calibration
Calibrate sensors before tuning:
- **CLT (Coolant Temp)**: Set resistance values at known temps
- **IAT (Intake Air Temp)**: Similar to CLT
- **TPS**: Set closed and WOT positions (0-100%)
- **MAP**: Verify atmospheric reading at key-on
- **O2 Sensor**: Calibrate wideband controller output range

### 3. VE Table Tuning (Speed Density)

**Method 1: Wideband O2 Feedback**
1. Enable EGO correction with moderate authority (±15-20%)
2. Set realistic AFR targets
3. Run engine at steady state (fixed RPM/load cell)
4. Allow EGO to correct, note correction percentage
5. Adjust VE by inverse of correction (if +10% correction, increase VE by 10%)
6. Save and move to next cell

**Meth...

# Megasquirt ECU Tuner with TunerStudio

Let your AI agent help tune your Megasquirt engine management system using TunerStudio. Get expert guidance on fuel mapping, ignition timing, sensor calibration, and advanced features—just describe what you're working on.

## What Can Your AI Agent Do?

Your AI agent can guide you through the entire tuning process:

### 🔧 **Base Configuration**
- **Engine setup**: "Help me configure my 2.0L 4-cylinder with 440cc injectors"
- **Required fuel calculation**: "Calculate required fuel for my setup"
- **Sensor calibration**: "Calibrate my GM coolant temp sensor"
- **TPS setup**: "Set up my throttle position sensor"

### ⛽ **Fuel Tuning (VE Tables)**
- **Speed density tuning**: "How do I tune my VE table?"
- **AFR targets**: "What AFR should I target at WOT?"
- **Auto-tune setup**: "Configure VEAL for my wideband"
- **Cell-by-cell tuning**: "How do I tune the 3000 RPM, 80kPa cell?"
- **Transition smoothing**: "Interpolate between my tuned cells"

### ⚡ **Ignition Timing**
- **Spark table setup**: "Build a conservative timing map for my turbo engine"
- **Base timing verification**: "Verify my timing with a timing light"
- **Knock troubleshooting**: "I'm getting knock at 4000 RPM under load"
- **Advance tuning**: "How much timing can I add at cruise?"

### 🌡️ **Startup & Idle**
- **Cranking settings**: "Set up cold start for -10°C weather"
- **Idle control**: "Tune my PWM idle valve"
- **Warmup enrichment**: "Adjust my warmup curve"
- **Idle stability**: "Fix my hunting idle"

### 🚀 **Acceleration & Transients**
- **Accel enrichment**: "Tune out my tip-in bog"
- **TPS-based enrichment**: "Set up throttle-based acceleration fuel"
- **MAP-based enrichment**: "Configure MAP-dot enrichment for my ITBs"
- **Decel fuel cut**: "Enable DFCO to save fuel"

### 🔍 **Tune File Analysis**
- **Safety review**: "Analyze this MSQ file before I start the engine"
- **Spot problems**: Find lean AFR targets, excessive timing, untuned cells
- **Optim...