View source for Config:Ignition

[[File:Ignition menu.jpg|thumb|Ignition menu]]

= Ignition =
The Ignition menu is used to configure all aspects of ignition control, including [[Config:Ignition#Knock Control|Knock Control]].

= Ignition advance =
This is the main ignition table, in degrees BTDC before any corrections. This defines the baseline ignition angle.

= CLT timing correction =
This table defines the coolant temperature ignition correction. Used to prevent knock on very hot engines.

= IAT timing correction =
This table defines the intake air temperature ignition correction. Use this table to prevent knock on bad intake setups or poor charge air cooling.

= Dwell Table =
This table defines the dwell time for the ignition system, defined in miliseconds. This table is defined in the Y axis by the battery voltage, used to correct for poor spark during cranking by introducing more dwell time.

= Ignition Hardware Angle Correction =
Compensates for trigger delay due to belt stretch, or other electro-mechanical issues. Also used to compensate for the ignition system delay.
{{Warning|This is correction in degrees by RPM. Beware that raising this value is directly added to the advance and this advances ignition timing!}}

= Ignition Hardware =

==== Spark ====
If ignition is enabled.

==== Mode ====

* '''Single coil''' - Simple distributor

* '''Individual coils''' - One coil per cylinder (coil-on-plug or coil-near-plug). Requires sequential mode or [[Config:Setup#Guess sync RPM threshold(rpm)|phase guessing]].

* '''Wasted spark''' - Fires pairs of cylinders together, either one coil per pair of cylinders or one coil per cylinder. Choose this if you have coil-on-plug or coil-near-plug but no camshaft sensor or you do not want to use [[Config:Setup#Guess sync RPM threshold(rpm)|phase guessing]]. Enable [[Config:Ignition#Individually wired Wasted Spark|Individually wired Wasted Spark]] for such a setup.

* '''Two distributors''' - A pair of distributors, found on some BMW, Porsche, Toyota and other engines.

==== Dwell duty cycle limit ====
Clamp dwell duration to this % of time slot (100=do not clamp)

Just like injectors, ignition coils have duty cycle, if duty cycle gets close to or exceeds 100%, ignition stops working

==== Individually wired Wasted Spark ====
This is needed if your coils are individually wired (COP) and you wish to use batch ignition (Wasted Spark).

==== Override ignition table load axis ====
Override the Y axis (load) value used for the ignition table.
{{Warning Mild|Advanced users only: If you aren't sure you need this, you probably don't need this.}}

==== Timing Mode ====

* '''Dynamic''' - Ignition behaves normally using the ignition table and any corrections applied to it.

* '''Static''' - Fixes the timing to the value set below.
{{Warning Mild|Only used fixed timing to verify trigger configuration with a timing light, never during normal driving conditions.}}

==== Fixed Timing ====
The fixed timing value when fixed timing is used.
{{Warning Mild|Only used fixed timing to verify trigger configuration with a timing light, never during normal driving conditions.}}

=== Ignition Outputs ===

==== Ignition Output Mode ====
See [[Hardware:ECU output mode selection|ECU output mode selection]].

==== Ignition Output x ====
This is the physical output pin for the ignition output.

To find the actual value for your hardware, see [[Hardware]].

=== Enable/Disable ignition outputs ===

==== Ignition x  disable ====
This disables the specified ignition output. Used for testing/debugging.

= Ignition Table Switch =
This is used for ignition table switching.

== Ignition Table Switch x Settings ==

==== Ignition Table Switch x Pin ====
This is the pin to toggle the table switch.

==== Ignition Table Switch x Pin Mode ====
See [[Hardware:ECU input mode selection|ECU input mode selection]].

==== Ignition Table Switch x Parameter ====
This changes the ignition table switch X axis parameter

==== Ignition Table Switch x Blend Mode ====
Blend mode adds or multiplies the switch table with base, default is switch.

==== Ignition Table Switch x Y axis override ====
This changes the ignition switch table Y axis.{{Warning Mild|Advanced users only: If you aren't sure you need this, you probably don't need this.}}

== Ignition Table Switch x ==
This is the ignition switch OR blend table as defined by [[Config:Ignition#Ignition Table Switch x Blend Mode|Ignition Table Switch x Blend Mode]]

= Cylinder Ignition Trim =
This is individual cylinder ignition trim.

== Ignition trim cyl x (deg) ==
This table trims the ignition by the specified number of degrees in relation to load.

== Switchable Ignition Adders ==

==== Ignition adder x pin ====
This is the physical input pin that enables the ignition adder.

==== Ignition adder x pin mode ====
See [[Hardware:ECU input mode selection|ECU input mode selection]].

==== Ignition adder x value ====
Random ignition adder x value (-60 to 60 degrees)

= Knock Control =
This is the epicEFI software-defined knock control. The knock control on epicEFI is software-based, ie. the software does the raw sensor sampling, the digital filtering, [[wikipedia:Band-pass_filter|bandpassing]] and windowing (only listening to knock on specific crank angles).

Special thanks to [https://github.com/mck1117 Matthew Kennedy] for implementing this feature and testing it on his engines (of which he destroyed a few in the process).
{{Warning|The Knock retard functionality is a tool to detect engine knock, but with wrong settings it can cause engine damages. Use with caution!}}

==== Software Knock Sense Enable ====
Enable or disable knock control.

==== Linear scale ====
Changes knock sensor values from logarithmic (dB) to a linear scale starting at 0.

==== Linear scale gain ====
This defines the linear scale gain.

==== Cylinder Bore ====
Cylinder diameter in mm

==== Estimated Knock Frequency ====
If you want to define the knock frequency manually, use this input field. If this field is non-zero, the [[Config:Ignition#Cylinder Bore|Cylinder Bore]]-based knock frequency calculation is ignored.

==== Detection mode ====

* '''First harmonic''' - The basic calculated or defined frequency

* '''Second harmonic''' - The first harmonic frequency, but doubled. This is possible because the pressure wave can fit two half-waves across the bore instead of one. It’s weaker than the first harmonic, but its much cleaner (less contaminated by valvetrain, piston slap, mechanical noise) and extremely useful at high RPM where the fundamental gets buried in engine noise.

==== Detection Window Start ====
The windowed knock control start window in degrees BTDC.

==== Sampling Duration ====
The angular duration of the knock window. Defined in crankshaft angle.

==== Enable Knock Spectrogram ====
Available via TS Plugin see https://rusefi.com/s/knock

==== Enable Knock Spectrogram Filter ====
This defines a filter for the spectrogram.

==== Knock Spectrum Sensitivity ====
This defines the relative sensitivity of the knock spectrogram.

=== Select the nearest sensor for each cylinder ===

==== Cylinder x ====
This defines what cylinder is closes the the physical knock sensor.

=== Response ===

==== knockRetardAggression ====
Ignition timing to remove when a knock event occurs. Advice: 5% (mild), 10% (turbo/high comp.), 15% (high knock, e.g. GDI), 20% (spicy lump),

==== knockRetardReapplyRate ====
After a knock event, reapply timing at this rate.

==== knockFuelTrimAggression ====
Fuel to odd when a knock event occurs. Advice: 5% (mild), 10% (turbo/high comp.), 15% (high knock, e.g. GDI), 20% (spicy lump),

==== knockFuelTrimReapplyRate ====
After a knock event, reapply fuel at this rate.

==== knockFuelTrim ====
Fuel trim when knock, max 30%

==== knockSuppressMinTps ====
Below TPS value all knock suppression will be disabled.

==== knockSuppressMinRpm ====
Below RPM value all knock suppression will be disabled

== Knock threshold ==

Knock sensor output knock detection threshold depending on current RPM. This is the threshold above which engine noise is considered as knock and [[Config:Ignition#Response|response]] starts to get applied.

= Max knock retard =
This table defines the maximum allowed knock retard.

= Per cylinder knock gains =
This table defines the per-cylinder knock gain (used when lots of cylinders share a single knock sensor).