LaunchControlBase Class Reference

#include <launch_control.h>

Inheritance diagram for LaunchControlBase:

Collaboration diagram for LaunchControlBase:

Public Member Functions
	LaunchControlBase ()
void	update ()
float	getFuelCoefficient () const
bool	isInsideSpeedCondition () const
bool	isInsideTpsCondition () const
bool	isInsideSwitchCondition ()
LaunchCondition	calculateRPMLaunchCondition (float rpm)
LaunchCondition	calculateLaunchCondition (float rpm)
bool	isLaunchSparkRpmRetardCondition () const
bool	isLaunchFuelRpmRetardCondition () const
float	getSparkSkipRatio () const

Private Member Functions
bool	isLaunchRpmRetardCondition () const
float	calculateSparkSkipRatio (float rpm) const

Private Attributes
float	sparkSkipRatio = 0.0f

Additional Inherited Members
Data Fields inherited from launch_control_state_s
int	retardThresholdRpm = (int)0
bool	launchActivatePinState: 1 {}
bool	isPreLaunchCondition: 1 {}
bool	isLaunchCondition: 1 {}
bool	isSwitchActivated: 1 {}
bool	isClutchActivated: 1 {}
bool	isBrakePedalActivated: 1 {}
bool	isValidInputPin: 1 {}
bool	activateSwitchCondition: 1 {}
bool	rpmLaunchCondition: 1 {}
bool	rpmPreLaunchCondition: 1 {}
bool	speedCondition: 1 {}
bool	tpsCondition: 1 {}
bool	luaLaunchState: 1 {}
bool	unusedBit_14_13: 1 {}
bool	unusedBit_14_14: 1 {}
bool	unusedBit_14_15: 1 {}
bool	unusedBit_14_16: 1 {}
bool	unusedBit_14_17: 1 {}
bool	unusedBit_14_18: 1 {}
bool	unusedBit_14_19: 1 {}
bool	unusedBit_14_20: 1 {}
bool	unusedBit_14_21: 1 {}
bool	unusedBit_14_22: 1 {}
bool	unusedBit_14_23: 1 {}
bool	unusedBit_14_24: 1 {}
bool	unusedBit_14_25: 1 {}
bool	unusedBit_14_26: 1 {}
bool	unusedBit_14_27: 1 {}
bool	unusedBit_14_28: 1 {}
bool	unusedBit_14_29: 1 {}
bool	unusedBit_14_30: 1 {}
bool	unusedBit_14_31: 1 {}

Detailed Description

Definition at line 20 of file launch_control.h.

Constructor & Destructor Documentation

LaunchControlBase()

LaunchControlBase::LaunchControlBase

(

)

Definition at line 112 of file launch_control.cpp.

                                     {
    launchActivatePinState = false;
    isPreLaunchCondition = false;
    isLaunchCondition = false;
}

Member Function Documentation

calculateLaunchCondition()

LaunchCondition LaunchControlBase::calculateLaunchCondition

(

float

rpm

)

Definition at line 97 of file launch_control.cpp.

                                                                           {
    const LaunchCondition currentRpmLaunchCondition = calculateRPMLaunchCondition(rpm);
    activateSwitchCondition = isInsideSwitchCondition();
    rpmLaunchCondition = (currentRpmLaunchCondition == LaunchCondition::Launch);
    rpmPreLaunchCondition = (currentRpmLaunchCondition == LaunchCondition::PreLaunch);
    speedCondition = isInsideSpeedCondition();
    tpsCondition = isInsideTpsCondition();
 
    if(speedCondition && activateSwitchCondition && tpsCondition) {
        return currentRpmLaunchCondition;
    } else {
        return LaunchCondition::NotMet;
    }
}

Referenced by update().

Here is the call graph for this function:

Here is the caller graph for this function:

calculateRPMLaunchCondition()

LaunchCondition LaunchControlBase::calculateRPMLaunchCondition

(

float

rpm

)

Definition at line 74 of file launch_control.cpp.

                                                                              {
    if ((engineConfiguration->launchActivationMode == SWITCH_INPUT_LAUNCH)
        && (engineConfiguration->torqueReductionActivationMode == LAUNCH_BUTTON)
        && engineConfiguration->torqueReductionEnabled
        && (engineConfiguration->torqueReductionArmingRpm <= rpm)
    ) {
        // We need perform Shift Torque Reduction stuff (see
        // https://github.com/rusefi/rusefi/issues/5608#issuecomment-2391500472 and
        // https://github.com/rusefi/rusefi/issues/5608#issuecomment-2391772899 for details)
        return LaunchCondition::NotMet;
    }
 
    const int launchRpm = engineConfiguration->launchRpm;
    const int preLaunchRpm = launchRpm - engineConfiguration->launchRpmWindow;
    if (rpm < preLaunchRpm) {
        return LaunchCondition::NotMet;
    } else if (launchRpm <= rpm) {
        return LaunchCondition::Launch;
    } else {
        return LaunchCondition::PreLaunch;
    }
}

Referenced by calculateLaunchCondition().

Here is the caller graph for this function:

calculateSparkSkipRatio()

float LaunchControlBase::calculateSparkSkipRatio ( float  rpm ) const

private

Definition at line 150 of file launch_control.cpp.

                                                                      {
    float result = 0.0f;
    if (engineConfiguration->launchControlEnabled && engineConfiguration->launchSparkCutEnable) {
        if (isLaunchCondition) {
            result = 1.0f;
        } else if (isPreLaunchCondition) {
            const int launchRpm = engineConfiguration->launchRpm;
            const int sparkSkipStartRpm = launchRpm - engineConfiguration->launchRpmWindow;
            if (sparkSkipStartRpm <= rpm) {
                const float initialIgnitionCutRatio = engineConfiguration->initialIgnitionCutPercent / 100.0f;
                const int sparkSkipEndRpm = launchRpm - engineConfiguration->launchCorrectionsEndRpm;
                const float finalIgnitionCutRatio = engineConfiguration->finalIgnitionCutPercentBeforeLaunch / 100.0f;
                result = interpolateClamped(sparkSkipStartRpm, initialIgnitionCutRatio, sparkSkipEndRpm, finalIgnitionCutRatio, rpm);
            }
        }
    }
    return result;
}

Referenced by update().

Here is the call graph for this function:

Here is the caller graph for this function:

getFuelCoefficient()

float LaunchControlBase::getFuelCoefficient

(

)

const

Definition at line 118 of file launch_control.cpp.

                                                  {
    return 1 + (isLaunchCondition && engineConfiguration->launchControlEnabled ? engineConfiguration->launchFuelAdderPercent / 100.0 : 0);
}

Referenced by getRunningFuel().

Here is the caller graph for this function:

getSparkSkipRatio()

float LaunchControlBase::getSparkSkipRatio ( ) const

inline

Definition at line 36 of file launch_control.h.

{ return sparkSkipRatio; }

Referenced by EngineState::updateSparkSkip().

Here is the caller graph for this function:

isInsideSpeedCondition()

bool LaunchControlBase::isInsideSpeedCondition

(

)

const

Returns True when Vehicle speed ALLOWS launch control

Definition at line 49 of file launch_control.cpp.

                                                     {
    if (engineConfiguration->launchSpeedThreshold == 0) {
        return true; // allow launch, speed does not matter
    }
 
    int speed = Sensor::getOrZero(SensorType::VehicleSpeed);
 
    return engineConfiguration->launchSpeedThreshold > speed;
}

Referenced by calculateLaunchCondition().

Here is the call graph for this function:

Here is the caller graph for this function:

isInsideSwitchCondition()

bool LaunchControlBase::isInsideSwitchCondition

(

)

We can have active condition from switch or from clutch. In case we are dependent on VSS we just return true.

Definition at line 22 of file launch_control.cpp.

                                                {
    isSwitchActivated = engineConfiguration->launchActivationMode == SWITCH_INPUT_LAUNCH;
    isClutchActivated = engineConfiguration->launchActivationMode == CLUTCH_INPUT_LAUNCH;
    isBrakePedalActivated = engineConfiguration->launchActivationMode == STOP_INPUT_LAUNCH;
 
    if (isSwitchActivated) {
#if !EFI_SIMULATOR
        if (isBrainPinValid(engineConfiguration->launchActivatePin)) {
            launchActivatePinState = efiReadPin(engineConfiguration->launchActivatePin, engineConfiguration->launchActivatePinMode);
        }
#endif // EFI_PROD_CODE
        return launchActivatePinState;
    } else if (isClutchActivated) {
        return getClutchDownState();
    } else if (isBrakePedalActivated) {
        return getBrakePedalState();
    } else if (engineConfiguration->launchActivationMode == LUA_LAUNCH) {
        return luaLaunchState;
    } else {
        // ALWAYS_ACTIVE_LAUNCH
        return true;
    }
}

Referenced by calculateLaunchCondition().

Here is the call graph for this function:

Here is the caller graph for this function:

isInsideTpsCondition()

bool LaunchControlBase::isInsideTpsCondition

(

)

const

Returns false if TPS is invalid or TPS > preset threshold

Definition at line 62 of file launch_control.cpp.

                                                   {
    auto tps = Sensor::get(SensorType::DriverThrottleIntent);
 
    // Disallow launch without valid TPS
    if (!tps.Valid) {
        return false;
    }
 
    // todo: should this be 'launchTpsThreshold <= tps.Value' so that nicely calibrated TPS of zero does not prevent launch?
    return engineConfiguration->launchTpsThreshold < tps.Value;
}

Referenced by calculateLaunchCondition().

Here is the call graph for this function:

Here is the caller graph for this function:

isLaunchFuelRpmRetardCondition()

bool LaunchControlBase::isLaunchFuelRpmRetardCondition

(

)

const

Definition at line 146 of file launch_control.cpp.

                                                             {
    return isLaunchRpmRetardCondition() && engineConfiguration->launchFuelCutEnable;
}

Referenced by LimpManager::updateState().

Here is the call graph for this function:

Here is the caller graph for this function:

isLaunchRpmRetardCondition()

bool LaunchControlBase::isLaunchRpmRetardCondition ( ) const

private

Definition at line 138 of file launch_control.cpp.

                                                         {
    return isLaunchCondition && engineConfiguration->launchControlEnabled && (retardThresholdRpm < Sensor::getOrZero(SensorType::Rpm));
}

Referenced by isLaunchFuelRpmRetardCondition(), and isLaunchSparkRpmRetardCondition().

Here is the call graph for this function:

Here is the caller graph for this function:

isLaunchSparkRpmRetardCondition()

bool LaunchControlBase::isLaunchSparkRpmRetardCondition

(

)

const

Definition at line 142 of file launch_control.cpp.

                                                              {
    return isLaunchRpmRetardCondition() && engineConfiguration->launchSparkCutEnable;
}

Referenced by LimpManager::updateState().

Here is the call graph for this function:

Here is the caller graph for this function:

update()

void LaunchControlBase::update

(

)

Definition at line 122 of file launch_control.cpp.

                               {
    if (!engineConfiguration->launchControlEnabled) {
        return;
    }
 
    const float rpm = Sensor::getOrZero(SensorType::Rpm);
    const LaunchCondition launchCondition = calculateLaunchCondition(rpm);
    isLaunchCondition = (launchCondition == LaunchCondition::Launch);
    isPreLaunchCondition = (launchCondition == LaunchCondition::PreLaunch);
 
    //and still recalculate in case user changed the values
    retardThresholdRpm = engineConfiguration->launchRpm;
 
    sparkSkipRatio = calculateSparkSkipRatio(rpm);
}

Referenced by EngineState::periodicFastCallback().

Here is the call graph for this function:

Here is the caller graph for this function:

Field Documentation

sparkSkipRatio

float LaunchControlBase::sparkSkipRatio = 0.0f

private

Definition at line 44 of file launch_control.h.

Referenced by getSparkSkipRatio(), and update().

---

The documentation for this class was generated from the following files:

• controllers/algo/launch_control.h
• controllers/algo/launch_control.cpp