Config:Idle - Revision history

Agnese: Stepper acceleration profile

2026-08-07T14:54:13Z

Stepper acceleration profile

@@ Line 361: / Line 361: @@
 Number of extra steps to overstep toward closed when re-parking after force-close. Compensates for stepper drift without needing the full startup homing sequence. 5 is a good starting point.
-<!-- section:IdleTimingTargetErrorDialog -->
+<!-- section:IdleTimingTargetErrorDialog -->= Stepper acceleration profile =
 = Open loop ignition idle timing (RPM-error) =
 Open-loop idle timing curve: ignition advance/retard as a function of how far RPM is from the idle target. Enabled by [[Idle#Open loop idle timing (RPM-error)|Open loop idle timing (RPM-error)]].

Ogalic at 22:58, 6 June 2026

2026-06-06T22:58:36Z

Show changes

Ogalic at 22:14, 6 June 2026

2026-06-06T22:14:38Z

← Older revision		Revision as of 22:14, 6 June 2026
Line 280:		Line 280:
	<!-- field:idle_solenoidPinMode -->		<!-- field:idle_solenoidPinMode -->
	==== Idle Solenoid output(s) Mode ====		==== Idle Solenoid output(s) Mode ====

	* '''$pin_output_mode_e_enum'''		* '''$pin_output_mode_e_enum'''

Line 298:		Line 297:
	==== ETB idle maximum angle ====		==== ETB idle maximum angle ====
	This sets the range of the idle control on the ETB. At 100% idle position, the value specified here sets the base ETB position.		This sets the range of the idle control on the ETB. At 100% idle position, the value specified here sets the base ETB position.

			<!-- curve:cltCrankingCurve -->
			== Cranking Idle Valve Curve ==
			2D curve — X: Coolant (-40 to 120), Y: Percent (0 to 100).

	<!-- section:afterCrankingIACtaperDurationDialog -->		<!-- section:afterCrankingIACtaperDurationDialog -->
	= Idle after start (crank-to-run) taper =		= Idle after start (crank-to-run) taper =

			<!-- curve:afterCrankingIACtaperCurve -->
			== Idle valve Crank-to-Run Taper ==
			2D curve — X: Coolant (-40 to 120), Y: cycles (0 to 500).

	<!-- section:iacPidMultTbl -->		<!-- section:iacPidMultTbl -->
Line 336:		Line 343:
	<!-- section:IdleTimingTargetErrorDialog -->		<!-- section:IdleTimingTargetErrorDialog -->
	= Open loop ignition idle timing (RPM-error) =		= Open loop ignition idle timing (RPM-error) =

			<!-- curve:idleTimingTargetErrorCRV -->
			== Idle Target Error ==
			2D curve — X: Delta (-500 to 500), Y: Deg (-30 to 30).

	<!-- section:idleVeTableTbl -->		<!-- section:idleVeTableTbl -->
Line 359:		Line 370:
	<!-- field:rotationalIdlePinMode -->		<!-- field:rotationalIdlePinMode -->
	==== Pin Mode ====		==== Pin Mode ====

	* '''$pin_input_mode_e_enum'''		* '''$pin_input_mode_e_enum'''

Line 486:		Line 496:
	<!-- field:transmissionIdleUpPinMode -->		<!-- field:transmissionIdleUpPinMode -->
	==== Transmission idle up switch mode ====		==== Transmission idle up switch mode ====

	* '''$pin_input_mode_e_enum'''		* '''$pin_input_mode_e_enum'''

Ogalic at 22:04, 6 June 2026

2026-06-06T22:04:11Z

Show changes

Ogalic: Created page with "= Idle = == Idle settings == '''Idle control mode''' See also idleRpmPid === Idle Detection Thresholds === '''TPS threshold''' Below this throttle position, the engine is considered idling. If you have an electronic throttle, this checks accelerator pedal position instead of throttle position, and should be set to 1-2%. '''Force Idle State Below DriverThrottleIntent Threshold''' Force idle STATE below DriveIntent threshold. '''Force Idle Ignition ONLY Below Driv..."

2026-02-12T22:30:23Z

Created page with "= Idle = == Idle settings == '''Idle control mode''' See also idleRpmPid === Idle Detection Thresholds === '''TPS threshold''' Below this throttle position, the engine is considered idling. If you have an electronic throttle, this checks accelerator pedal position instead of throttle position, and should be set to 1-2%. '''Force Idle State Below DriverThrottleIntent Threshold''' Force idle STATE below DriveIntent threshold. '''Force Idle Ignition ONLY Below Driv..."

New page

= Idle =

== Idle settings ==

'''Idle control mode'''

See also idleRpmPid

=== Idle Detection Thresholds ===

'''TPS threshold'''

Below this throttle position, the engine is considered idling. If you have an electronic throttle, this checks accelerator pedal position instead of throttle position, and should be set to 1-2%.

'''Force Idle State Below DriverThrottleIntent Threshold'''

Force idle STATE below DriveIntent threshold.

'''Force Idle Ignition ONLY Below DriverThrottleIntent Threshold'''

Force idle ignition (delta target only) below DriverThreshold threshold, only for ignition timing

'''Idle force delayed by DFCO'''

Do not force idle ignition while DFCO is active for either of the above.

'''Delta target rpm smoothing factor'''

Smoothing factor for delta target rpm ignition adjustment

'''RPM upper limit'''

How far above idle speed do we consider idling, i.e. coasting detection threshold.
For example, if target = 800, this param = 200, then anything below 1000 RPM is considered idle.

'''RPM deadzone'''

If the RPM closer to target than this value, disable closed loop idle correction to prevent oscillation

'''Max vehicle speed'''

Above this speed, disable closed loop idle control. Set to 0 to disable (allow closed loop idle at any speed).

=== Open Loop Idle ===

'''A/C adder'''

Additional idle % while A/C is active

'''A/C RPM target'''

Idle target speed when A/C is enabled. Some cars need the extra speed to keep the AC efficient while idling.

'''Transmission idle up adder'''

Additional idle % while transmission idle up is active

'''Transmission idle up RPM target'''

Idle target speed when transmission idle up is enabled. Some transmissions need extra idle speed when engaged.

'''Fan #1 adder'''

Additional idle % when fan #1 is active. In PWM mode this is scaled according to PWM %

'''Fan #2 adder'''

Additional idle % when fan #2 is active. In PWM mode this is scaled according to PWM %

=== Closed Loop Idle ===

'''P-factor'''

~~PLACEHOLDER~~

'''I-factor'''

~~PLACEHOLDER~~

'''D-factor'''

~~PLACEHOLDER~~

'''Min'''

Output Min Duty Cycle

'''Max'''

Output Max Duty Cycle

'''iTerm Min'''

iTerm min value

'''iTerm Max'''

iTerm max value

'''PID Extra for low RPM'''

Increases PID reaction for RPM<target by adding extra percent to PID-error

'''Use IAC PID Multiplier Table'''

This flag allows to use a special 'PID Multiplier' table (0.0-1.0) to compensate for nonlinear nature of IAC-RPM controller

=== Extra Idle Features ===

'''Separate idle ignition table'''

This activates a separate ignition timing table for idle conditions, this can help idle stability by using ignition retard and advance either side of the desired idle speed. Extra advance at low idle speeds will prevent stalling and extra retard at high idle speeds can help reduce engine power and slow the idle speed.

'''Use idle ignition table while coasting'''

~~PLACEHOLDER~~

'''Separate idle VE table'''

This activates a separate fuel table for Idle, this allows fine tuning of the idle fuelling.

'''Override Idle VE table load axis'''

Allows you to change the default load axis used for the VE table, which is typically MAP (manifold absolute pressure).

'''Ramp target RPM on return to idle'''

Ramp the idle target down from the entry threshold over N seconds when returning to idle. Helps prevent overshooting (below) the idle target while returning to idle from coasting.

'''Ramp target duration'''

idle return target ramp duration

'''Separate idle tables for cranking taper'''

This uses separate ignition timing and VE tables not only for idle conditions, also during the postcranking-to-idle taper transition (See also afterCrankingIACtaperDuration).

'''Separate coasting idle table'''

Override the IAC position during overrun conditions to help reduce engine breaking, this can be helpful for large engines in light weight cars or engines that have trouble returning to idle.

'''Dashpot coasting-to-idle Initial idle Adder'''

This value is an added for base idle value. Idle Value added when coasting and transitioning into idle.

'''Dashpot coasting-to-idle Hold time'''

How long initial idle adder is held before starting to decay.

'''Dashpot coasting-to-idle Decay time'''

How long it takes to remove initial IAC adder to return to normal idle.

'''Dashpot coasting-to-idle Initial idle Adder(AC ON)'''

This value is an added for base idle value(AC ON). Idle Value added when coasting and transitioning into idle.

'''Dashpot coasting-to-idle Hold time(AC ON)'''

How long initial idle adder is held before starting to decay(AC ON).

'''Dashpot coasting-to-idle Decay time(AC ON)'''

How long it takes to remove initial IAC adder to return to normal idle(AC ON).

'''CAN box extra idle-up target RPM adder'''

can box idle up demand

'''CAN box extra idle-up % adder'''

can box idle up demand %

'''Use Idle Timing Target Error curve'''

Use Idle Target Error Delta timing curve

'''Idle Timing Target Error is Adder'''

0 = replace, 1 = add

'''Enable closed loop idle ignition timing'''

~~PLACEHOLDER~~

== Idle hardware ==

'''Use Stepper'''

This setting should only be used if you have a stepper motor idle valve and a stepper motor driver installed.

'''Electronic throttle idle range'''

This sets the range of the idle control on the ETB. At 100% idle position, the value specified here sets the base ETB position.

=== Idle Valve Hardware ===

=== Solenoid ===

'''Idle Solenoid Primary output'''

?highlight=class~outputs

'''Double Solenoid Mode'''

Subaru/BMW style where default valve position is somewhere in the middle. First solenoid opens it more while second can close it more than default position.

'''Idle Solenoid Secondary output'''

Some Subaru and some Mazda use double-solenoid idle air valve
?highlight=class~outputs

'''Idle Solenoid output(s) Mode'''

~~PLACEHOLDER~~

'''Idle Solenoid Frequency'''

~~PLACEHOLDER~~

=== Stepper ===

'''Drive stepper with dual H bridges'''

If enabled we use two H-bridges to drive stepper idle air valve

'''Drive stepper with PushPull outputs'''

If enabled we use four Push-Pull outputs to directly drive stepper idle air valve coils

'''Stepper reaction time'''

~~PLACEHOLDER~~

'''Stepper total steps'''

~~PLACEHOLDER~~

'''Stepper parking extra steps, %'''

~~PLACEHOLDER~~

'''Force parking every restart'''

~~PLACEHOLDER~~

=== Stepper Controller Hardware ===

'''Idle Stepper Step Pin'''

~~PLACEHOLDER~~

'''Idle Stepper Dir Pin'''

~~PLACEHOLDER~~

'''Idle Stepper Dir Pin Mode'''

~~PLACEHOLDER~~

'''Idle Stepper Enable Pin'''

~~PLACEHOLDER~~

'''Idle Stepper Enable Pin Mode'''

~~PLACEHOLDER~~

=== Stepper H-Bridge Hardware ===

'''Inverted driver pins'''

Enable if DC-motor driver (H-bridge) inverts the signals (eg. RZ7899 on Hellen boards)

=== H-Bridge Hardware No1 ===

'''No1 Direction #1'''

~~PLACEHOLDER~~

'''No1 Direction #2'''

~~PLACEHOLDER~~

'''No1 Control'''

Acts as EN pin in two-wire mode

'''No1 Disable'''

~~PLACEHOLDER~~

=== H-Bridge Hardware No2 ===

'''No2 Direction #1'''

~~PLACEHOLDER~~

'''No2 Direction #2'''

~~PLACEHOLDER~~

'''No2 Control'''

Acts as EN pin in two-wire mode

'''No2 Disable'''

~~PLACEHOLDER~~

=== Stepper Direct-Drive Hardware ===

'''Stepper A+'''

stepper_raw_output 1
?highlight=class~outputs

'''Stepper A-'''

stepper_raw_output 2
?highlight=class~outputs

'''Stepper B+'''

stepper_raw_output 3
?highlight=class~outputs

'''Stepper B-'''

stepper_raw_output 4
?highlight=class~outputs

=== Micro-Stepping ===

'''Stepping Mode'''

For micro-stepping, make sure that PWM frequency (etbFreq) is high enough

'''Min. Duty Cycle'''

Use to limit the current when the stepper motor is idle, not moving (100% = no limit)

'''Max. Duty Cycle'''

Use to limit the max.current through the stepper motor (100% = no limit)

== Open Loop Idle ==

'''A/C adder'''

Additional idle % while A/C is active

'''A/C RPM target'''

Idle target speed when A/C is enabled. Some cars need the extra speed to keep the AC efficient while idling.

'''Transmission idle up adder'''

Additional idle % while transmission idle up is active

'''Transmission idle up RPM target'''

Idle target speed when transmission idle up is enabled. Some transmissions need extra idle speed when engaged.

'''Fan #1 adder'''

Additional idle % when fan #1 is active. In PWM mode this is scaled according to PWM %

'''Fan #2 adder'''

Additional idle % when fan #2 is active. In PWM mode this is scaled according to PWM %

== Transmission Idle Up ==

'''Transmission idle up switch'''

Transmission idle up switch input
?highlight=class~switch_inputs

'''Transmission idle up switch mode'''

~~PLACEHOLDER~~

'''Transmission idle up adder'''

Additional idle % while transmission idle up is active

'''Transmission idle up RPM target'''

Idle target speed when transmission idle up is enabled. Some transmissions need extra idle speed when engaged.

== Idle Target RPM from CLT ==

~~PLACEHOLDER~~

== Idle Position from CLT vs Idle Target RPM ==

~~PLACEHOLDER~~

== Idle After Start (Crank-to-Run) Taper vs CLT ==

== Closed-loop Ignition idle timing ==

'''Proportional gain'''

~~PLACEHOLDER~~

'''Integral gain'''

~~PLACEHOLDER~~

'''Derivative gain'''

~~PLACEHOLDER~~

'''Min adjustment (retard)'''

Output Min Duty Cycle

'''Max adjustment (advance)'''

Output Max Duty Cycle

'''Soft entry time'''

When entering idle, and the PID settings are aggressive, it's good to make a soft entry upon entering closed loop

== Target Delta ignition idle timing ==

== Idle PID multiplier ==

~~PLACEHOLDER~~

== Idle extra PID ==

~~PLACEHOLDER~~

== Coasting Idle position ==

~~PLACEHOLDER~~

== Idle VE ==

~~PLACEHOLDER~~

== Idle Target RPM Ignition advance ==

~~PLACEHOLDER~~

== Rotational Idle ==

'''Enable'''

Enable rotational idle.

'''Pin'''

Pin that activates the rotational idle.
?highlight=class~switch_inputs

'''Pin Mode'''

~~PLACEHOLDER~~

'''Stop STFT for rotational idle (no fuel trim)'''

Zero STFT for rotational idle.

'''Rotational cut spark'''

Rotational cut spark.

'''Rotational cut fuel'''

Rotational cut fuel.

'''Enable automatic engagement for TPS'''

Enable automatic engagement of rotational idle.

'''Engage rotational idle below this Driver Intent(TPS/PPS)'''

Engage rotational idle under this Driver Intent.

'''Enable auto engage for CLT'''

Enable Rotational Idle Auto engage CLT.

'''Auto engage above this CLT'''

Rotational Idle Auto engage CLT.

'''Minimum CLT'''

Minimum CLT for the rotational idle.

'''Maximum TPS/PPS (0 to disable)'''

Disengage rotational idle above this Driver Intent.

'''Minimum RPM'''

Minimum RPM for the rotational idle.

'''Maximum RPM'''

Maximum RPM for the rotational idle.

'''Add idle % idle output'''

Add air to the idle.

'''Add/Remove air percentage'''

Percentage of air to add/remove to the idle.

'''Override ETB Idle Authority (0 to disable override)'''

Override the ETB authority for the rotational idle.

'''Fuel Multiplier (1.5 = 150% , 0 to 2.5)'''

Rotational idle fuel multiplier

'''Rotational Absolute Timing (-30 = 30 ATDC, 0 = original timing, 10 - -100)'''

Rotational idle absolute ignition (-20 = atdc 20 degrees)

'''Old rotational idle logic (true = old, false = new) - see tooltip'''

Old rotational idle logic, New logic is based on global spark counter, the three layers of accumulators and adders run at the same time, offset shifts the pattern forward or backward with relation to each other, this should allow different sound patterns by combining different offsets;"true = old, false = new

'''Rotational Fuel Offset (should be 0, this shifts fuel cut in relation to ignition signal)'''

Rotational idle fuel offset (should be 0, this shifts fuel cut in relation to ignition signal). At 0, in sequential injection/ignition the fuel pulse is cut before the ignition pulse. so fuel is not wasted.

'''Accumulator Max 1'''

Max value for the rotational idle accumulator to skip

'''Accumulator Adder 1'''

Accumulator adder

'''Accumulator Offset 1'''

Rotational pattern shift #1

'''Accumulator Max 2'''

Max value for the rotational idle accumulator to skip

'''Accumulator Adder 2'''

Accumulator adder

'''Accumulator Offset 2'''

Rotational pattern shift #2

'''Accumulator Max 3'''

Max value for the rotational idle accumulator to skip

'''Accumulator Adder 3'''

Accumulator adder

'''Accumulator Offset 3'''

Rotational pattern shift #3