Engine Class Reference

#include <engine.h>

Inheritance diagram for Engine:

Collaboration diagram for Engine:

Public Member Functions
	Engine ()
template<typename get_t >
constexpr auto &	module ()
void	resetLua ()
void	OnTriggerStateProperState (efitick_t nowNt) override
void	OnTriggerSynchronization (bool wasSynchronized, bool isDecodingError) override
void	OnTriggerSynchronizationLost () override
void	setConfig ()
int	getGlobalConfigurationVersion (void) const
void	periodicFastCallback ()
void	periodicSlowCallback ()
void	updateSlowSensors ()
void	updateSwitchInputs ()
void	updateTriggerWaveform ()
void	resetEngineSnifferIfInTestMode ()
void	preCalculate ()
void	efiWatchdog ()
void	onEngineHasStopped ()
void	checkShutdown ()
bool	isInShutdownMode () const
bool	isMainRelayEnabled () const
void	onSparkFireKnockSense (uint8_t cylinderIndex, efitick_t nowNt)

Data Fields
bool	enableOverdwellProtection = true
TunerStudioOutputChannels	outputChannels
bool	allowCanTx = true
bool	isPwmEnabled = true
const char *	prevOutputName = nullptr
bool	pauseCANdueToSerial = false
PinRepository	pinRepository
IEtbController *	etbControllers [ETB_COUNT] = {nullptr}
FuelComputer	fuelComputer
type_list< Mockable< InjectorModelPrimary >, Mockable< InjectorModelSecondary >,#if EFI_IDLE_CONTROL Mockable< IdleController >,#endif TriggerScheduler,#if EFI_HPFP &&EFI_ENGINE_CONTROL HpfpController,#endif #if EFI_ENGINE_CONTROL Mockable< ThrottleModel >,#endif #if EFI_ALTERNATOR_CONTROL AlternatorController,#endif FuelPumpController, MainRelayController, IgnitionController, Mockable< AcController >, FanControl1, FanControl2, PrimeController, DfcoController,#if EFI_HD_ACR HarleyAcr,#endif Mockable< WallFuelController >,#if EFI_VEHICLE_SPEED GearDetector, TripOdometer,#endif KnockController, SensorChecker,#if EFI_ENGINE_CONTROL LimpManager,#endif #if EFI_VVT_PID VvtController1, VvtController2, VvtController3, VvtController4,#endif #if EFI_BOOST_CONTROL BoostController,#endif EngineModule >	engineModules
GearControllerBase *	gearController
SwitchedState	clutchUpSwitchedState
SwitchedState	brakePedalSwitchedState
SwitchedState	acButtonSwitchedState
SimpleSwitchedState	luaDigitalInputState [LUA_DIGITAL_INPUT_COUNT]
LaunchControlBase	launchController
SoftSparkLimiter	softSparkLimiter
SoftSparkLimiter	hardSparkLimiter
AntilagSystemBase	antilagController
SoftSparkLimiter	ALSsoftSparkLimiter
LambdaMonitor	lambdaMonitor
IgnitionState	ignitionState
Timer	startStopStateLastPush
LocalVersionHolder	versionForConfigurationListeners
AuxActor	auxValves [AUX_DIGITAL_VALVE_COUNT][2]
bool	needTdcCallback = true
int	bailedOnDwell = 0
SingleTimerExecutor	executor
SleepExecutor	executor
TestExecutor	executor
std::function< void(IgnitionEvent *, bool)>	onIgnitionEvent
FuelSchedule	injectionEvents
IgnitionEventList	ignitionEvents
scheduling_s	tdcScheduler [2]
bool	etbAutoTune = false
bool	tdcMarkEnabled = true
bool	slowCallBackWasInvoked = false
RpmCalculator	rpmCalculator
Timer	configBurnTimer
int	globalConfigurationVersion = 0
TpsAccelEnrichment	tpsAccelEnrichment
TriggerCentral	triggerCentral
float	stftCorrection [STFT_BANK_COUNT] = {0}
bool	isRunningPwmTest = false
bool	isFunctionalTestMode = false
EngineState	engineState
dc_motors_s	dc_motors
sent_state_s	sent_state
percent_t	blipIdlePosition
efitimeus_t	timeToStopBlip = 0
efitimeus_t	timeToStopIdleTest = 0
SensorsState	sensors
AirmassModelBase *	mockAirmassModel = nullptr

Private Member Functions
void	reset ()
void	injectEngineReferences ()

Detailed Description

Definition at line 89 of file engine.h.

Constructor & Destructor Documentation

Engine()

Engine::Engine

(

)

Definition at line 282 of file engine.cpp.

    : clutchUpSwitchedState(&engineState.clutchUpState),
    brakePedalSwitchedState(&engineState.brakePedalState),
    acButtonSwitchedState(&module<AcController>().unmock().acButtonState)
 
#if EFI_LAUNCH_CONTROL
 
    , softSparkLimiter(false), hardSparkLimiter(true)
 
#if EFI_ANTILAG_SYSTEM
    , ALSsoftSparkLimiter(false)
#endif /* EFI_ANTILAG_SYSTEM */
 
#endif // EFI_LAUNCH_CONTROL
{
    reset();
}

Here is the call graph for this function:

Member Function Documentation

checkShutdown()

void Engine::checkShutdown

(

)

Needed by EFI_MAIN_RELAY_CONTROL to shut down the engine correctly. This method cancels shutdown if the ignition voltage is detected.

Definition at line 469 of file engine.cpp.

                           {
#if EFI_MAIN_RELAY_CONTROL
    // if we are already in the "ignition_on" mode, then do nothing
/* this logic is not alive
    if (ignitionOnTimeNt > 0) {
        return;
    }
todo: move to shutdown_controller.cpp
*/
 
    // here we are in the shutdown (the ignition is off) or initial mode (after the firmware fresh start)
/* this needs work or tests
    const efitick_t engineStopWaitTimeoutUs = 500000LL; // 0.5 sec
    // in shutdown mode, we need a small cooldown time between the ignition off and on
todo: move to shutdown_controller.cpp
    if (stopEngineRequestTimeNt == 0 || (getTimeNowNt() - stopEngineRequestTimeNt) > US2NT(engineStopWaitTimeoutUs)) {
        // if the ignition key is turned on again,
        // we cancel the shutdown mode, but only if all shutdown procedures are complete
        const float vBattThresholdOn = 8.0f;
        // we fallback into zero instead of VBAT_FALLBACK_VALUE because it's not safe to false-trigger the "ignition on" event,
        // and we want to turn on the main relay only when 100% sure.
        if ((Sensor::getOrZero(SensorType::BatteryVoltage) > vBattThresholdOn) && !isInShutdownMode()) {
            ignitionOnTimeNt = getTimeNowNt();
            efiPrintf("Ignition voltage detected!");
            if (stopEngineRequestTimeNt != 0) {
                efiPrintf("Cancel the engine shutdown!");
                stopEngineRequestTimeNt = 0;
            }
        }
    }
*/
#endif /* EFI_MAIN_RELAY_CONTROL */
}

Referenced by periodicSlowCallback().

Here is the caller graph for this function:

efiWatchdog()

void Engine::efiWatchdog

(

)

todo: better watch dog implementation should be implemented - see http://sourceforge.net/p/rusefi/tickets/96/

Definition at line 428 of file engine.cpp.

                         {
    assertTimeIsLinear();
    if (isRunningPwmTest)
        return;
 
#if EFI_ENGINE_CONTROL && EFI_SHAFT_POSITION_INPUT
    if (module<PrimeController>()->isPriming() || triggerCentral.engineMovedRecently()) {
        // do not invoke check in priming or if engine moved recently, no need to assert safe pin state.
        return;
    }
 
    if (!triggerCentral.isSpinningJustForWatchdog) {
        if (!isRunningBenchTest() && enginePins.stopPins()) {
            // todo: make this a firmwareError assuming functional tests would run
            warning(ObdCode::CUSTOM_ERR_2ND_WATCHDOG, "Some pins were turned off by 2nd pass watchdog");
        }
        return;
    }
 
    /**
     * todo: better watch dog implementation should be implemented - see
     * http://sourceforge.net/p/rusefi/tickets/96/
     */
    triggerCentral.isSpinningJustForWatchdog = false;
    onEngineHasStopped();
#endif // EFI_ENGINE_CONTROL && EFI_SHAFT_POSITION_INPUT
}

Referenced by periodicSlowCallback().

Here is the call graph for this function:

Here is the caller graph for this function:

getGlobalConfigurationVersion()

int Engine::getGlobalConfigurationVersion

(

void

)

const

Definition at line 300 of file engine.cpp.

                                                    {
    return globalConfigurationVersion;
}

Referenced by TriggerCentral::checkIfTriggerConfigChanged(), configureRusefiLuaHooks(), doPeriodicSlowCallback(), printConfiguration(), and updateTriggerWaveformIfNeeded().

Here is the caller graph for this function:

injectEngineReferences()

void Engine::injectEngineReferences ( )

private

Definition at line 393 of file engine.cpp.

                                    {
#if EFI_SHAFT_POSITION_INPUT
    triggerCentral.primaryTriggerConfiguration.update();
    for (int camIndex = 0;camIndex < CAMS_PER_BANK;camIndex++) {
        triggerCentral.vvtTriggerConfiguration[camIndex].update();
    }
#endif // EFI_SHAFT_POSITION_INPUT
}

Referenced by setConfig().

Here is the call graph for this function:

Here is the caller graph for this function:

isInShutdownMode()

bool Engine::isInShutdownMode

(

)

const

Allows to finish some long-term shutdown procedures (stepper motor parking etc.) Called when the ignition switch is turned off (vBatt is too low). Returns true if some operations are in progress on background.

Definition at line 503 of file engine.cpp.

                                    {
    // TODO: this logic is currently broken
#if 0 && EFI_MAIN_RELAY_CONTROL && EFI_PROD_CODE
    // if we are in "ignition_on" mode and not in shutdown mode
    if (stopEngineRequestTimeNt == 0 && ignitionOnTimeNt > 0) {
        const float vBattThresholdOff = 5.0f;
        // start the shutdown process if the ignition voltage dropped low
        if (Sensor::get(SensorType::BatteryVoltage).value_or(VBAT_FALLBACK_VALUE) <= vBattThresholdOff) {
            scheduleStopEngine();
        }
    }
 
    // we are not in the shutdown mode?
    if (stopEngineRequestTimeNt == 0) {
        return false;
    }
 
    const efitick_t turnOffWaitTimeoutNt = NT_PER_SECOND;
    // We don't want any transients to step in, so we wait at least 1 second whatever happens.
    // Also it's good to give the stepper motor some time to start moving to the initial position (or parking)
    if ((getTimeNowNt() - stopEngineRequestTimeNt) < turnOffWaitTimeoutNt)
        return true;
 
    const efitick_t engineSpinningWaitTimeoutNt = 5 * NT_PER_SECOND;
    // The engine is still spinning! Give it some time to stop (but wait no more than 5 secs)
    if (isSpinning && (getTimeNowNt() - stopEngineRequestTimeNt) < engineSpinningWaitTimeoutNt)
        return true;
 
    // The idle motor valve is still moving! Give it some time to park (but wait no more than 10 secs)
    // Usually it can move to the initial 'cranking' position or zero 'parking' position.
    const efitick_t idleMotorWaitTimeoutNt = 10 * NT_PER_SECOND;
    if (isIdleMotorBusy() && (getTimeNowNt() - stopEngineRequestTimeNt) < idleMotorWaitTimeoutNt)
        return true;
#endif /* EFI_MAIN_RELAY_CONTROL */
    return false;
}

Here is the call graph for this function:

isMainRelayEnabled()

bool Engine::isMainRelayEnabled

(

)

const

The stepper does not work if the main relay is turned off (it requires +12V). Needed by the stepper motor code to detect if it works.

Definition at line 540 of file engine.cpp.

                                      {
#if EFI_MAIN_RELAY_CONTROL
    return enginePins.mainRelay.getLogicValue();
#else
    // if no main relay control, we assume it's always turned on
    return true;
#endif /* EFI_MAIN_RELAY_CONTROL */
}

Referenced by StepperMotorBase::doIteration(), StepDirectionStepper::pulse(), and LimpManager::updateState().

Here is the call graph for this function:

Here is the caller graph for this function:

module()

template<typename get_t >

constexpr auto& Engine::module ( )

inlineconstexpr

Slightly shorter helper function to keep the code looking clean.

Definition at line 174 of file engine.h.

                              {
        return engineModules.get<get_t>();
    }

Referenced by WallFuel::adjust(), applyPidSettings(), auxPlainPinTurnOn(), canDashboardHaltech(), EtbController::checkStatus(), configureRusefiLuaHooks(), getAdvanceCorrections(), AlternatorController::getClosedLoop(), IdleController::getClosedLoop(), getIdlePosition(), getInjectionMass(), getLimpManager(), getOutputValueByName(), PrimeController::getPrimeDuration(), getRunningAdvance(), IdleController::getRunningOpenLoop(), IdleController::getTargetRpm(), AirmassVeModelBase::getVe(), handleGetDataRequest(), TriggerCentral::handleShaftSignal(), hipThread(), initAlternatorCtrl(), initBoostCtrl(), initVvtActuators(), LambdaMonitorBase::isCurrentlyGood(), lua_getDigital(), mainTriggerCallback(), FanController::onSlowCallback(), InjectionEvent::onTriggerTooth(), EngineState::periodicFastCallback(), populateFrame(), processLastKnockEvent(), resetLua(), HpfpController::scheduleNextCycle(), scheduleOpen(), scheduleSparkEvent(), setAltPFactor(), shouldUpdateCorrection(), startIdleThread(), updateFlags(), updateFuelResults(), LimpManager::updateState(), updateSwitchInputs(), and updateVehicleSpeed().

Here is the call graph for this function:

Here is the caller graph for this function:

onEngineHasStopped()

void Engine::onEngineHasStopped

(

)

Definition at line 456 of file engine.cpp.

                                {
#if EFI_ENGINE_CONTROL
    ignitionEvents.isReady = false;
#endif // EFI_ENGINE_CONTROL
 
#if EFI_PROD_CODE || EFI_SIMULATOR
    efiPrintf("Engine has stopped spinning.");
#endif
 
    // this invocation should be the last layer of defence in terms of making sure injectors/coils are not active
    enginePins.stopPins();
}

Referenced by efiWatchdog().

Here is the call graph for this function:

Here is the caller graph for this function:

onSparkFireKnockSense()

void Engine::onSparkFireKnockSense	(	uint8_t	cylinderIndex,
		efitick_t	nowNt
	)

Definition at line 161 of file knock_controller.cpp.

                                                                          {
#if EFI_HIP_9011 || EFI_SOFTWARE_KNOCK
    cylinderNumberCopy = cylinderNumber;
    scheduleByAngle(nullptr, nowNt,
            /*angle*/engineConfiguration->knockDetectionWindowStart, { startKnockSampling, engine });
#else
    UNUSED(cylinderNumber);
    UNUSED(nowNt);
#endif
 
#if EFI_HIP_9011
    hip9011_onFireEvent(cylinderNumber, nowNt);
#endif
}

Referenced by fireSparkAndPrepareNextSchedule().

Here is the call graph for this function:

Here is the caller graph for this function:

OnTriggerStateProperState()

void Engine::OnTriggerStateProperState ( efitick_t  nowNt )

overridevirtual

Implements TriggerStateListener.

Definition at line 346 of file engine.cpp.

                                                      {
    rpmCalculator.setSpinningUp(nowNt);
}

Here is the call graph for this function:

OnTriggerSynchronization()

void Engine::OnTriggerSynchronization ( bool  wasSynchronized, bool  isDecodingError  )

overridevirtual

Implements TriggerStateListener.

Definition at line 364 of file engine.cpp.

                                                                                {
    // TODO: this logic probably shouldn't be part of engine.cpp
 
    // We only care about trigger shape once we have synchronized trigger. Anything could happen
    // during first revolution and it's fine
    if (wasSynchronized) {
        enginePins.triggerDecoderErrorPin.setValue(isDecodingError);
 
        // 'triggerStateListener is not null' means we are running a real engine and now just preparing trigger shape
        // that's a bit of a hack, a sweet OOP solution would be a real callback or at least 'needDecodingErrorLogic' method?
        if (isDecodingError) {
#if EFI_PROD_CODE
            if (engineConfiguration->verboseTriggerSynchDetails || (triggerCentral.triggerState.someSortOfTriggerError() && !engineConfiguration->silentTriggerError)) {
                efiPrintf("error: synchronizationPoint @ index %d expected %d/%d got %d/%d",
                        triggerCentral.triggerState.currentCycle.current_index,
                        triggerCentral.triggerShape.getExpectedEventCount(TriggerWheel::T_PRIMARY),
                        triggerCentral.triggerShape.getExpectedEventCount(TriggerWheel::T_SECONDARY),
                        triggerCentral.triggerState.currentCycle.eventCount[0],
                        triggerCentral.triggerState.currentCycle.eventCount[1]);
            }
#endif /* EFI_PROD_CODE */
        }
 
        engine->triggerCentral.triggerErrorDetection.add(isDecodingError);
    }
 
}

Here is the call graph for this function:

OnTriggerSynchronizationLost()

void Engine::OnTriggerSynchronizationLost ( )

overridevirtual

Implements TriggerStateListener.

Definition at line 350 of file engine.cpp.

                                          {
    // Needed for early instant-RPM detection
    rpmCalculator.setStopSpinning();
 
    triggerCentral.triggerState.resetState();
    triggerCentral.instantRpm.resetInstantRpm();
 
    for (size_t i = 0; i < efi::size(triggerCentral.vvtState); i++) {
        for (size_t j = 0; j < efi::size(triggerCentral.vvtState[0]); j++) {
            triggerCentral.vvtState[i][j].resetState();
        }
    }
}

Here is the call graph for this function:

periodicFastCallback()

void Engine::periodicFastCallback

(

)

See FAST_CALLBACK_PERIOD_MS

The idea of this method is to execute all heavy calculations in a lower-priority thread, so that trigger event handler/IO scheduler tasks are faster.

Definition at line 557 of file engine.cpp.

                                  {
    ScopePerf pc(PE::EnginePeriodicFastCallback);
 
#if EFI_MAP_AVERAGING
    refreshMapAveragingPreCalc();
#endif
 
    engineState.periodicFastCallback();
 
    tachUpdate();
    speedoUpdate();
 
    engine->engineModules.apply_all([](auto & m) { m.onFastCallback(); });
}

Referenced by RpmCalculator::assignRpmValue(), and mainTriggerCallback().

Here is the call graph for this function:

Here is the caller graph for this function:

periodicSlowCallback()

void Engine::periodicSlowCallback

(

)

See SLOW_CALLBACK_PERIOD_MS

Definition at line 142 of file engine.cpp.

                                  {
    ScopePerf perf(PE::EnginePeriodicSlowCallback);
 
#if EFI_SHAFT_POSITION_INPUT
    // Re-read config in case it's changed
    triggerCentral.primaryTriggerConfiguration.update();
    for (int camIndex = 0;camIndex < CAMS_PER_BANK;camIndex++) {
        triggerCentral.vvtTriggerConfiguration[camIndex].update();
    }
 
  getEngineState()->heaterControlEnabled = engineConfiguration->forceO2Heating || engine->rpmCalculator.isRunning();
    enginePins.o2heater.setValue(getEngineState()->heaterControlEnabled);
    enginePins.starterRelayDisable.setValue(Sensor::getOrZero(SensorType::Rpm) < engineConfiguration->cranking.rpm);
#endif // EFI_SHAFT_POSITION_INPUT
 
    efiWatchdog();
    updateSlowSensors();
    checkShutdown();
 
    tpsAccelEnrichment.onNewValue(Sensor::getOrZero(SensorType::Tps1));
 
    updateVrThresholdPwm();
 
    updateGppwm();
 
    engine->engineModules.apply_all([](auto & m) { m.onSlowCallback(); });
 
#if (BOARD_TLE8888_COUNT > 0)
    tle8888startup();
#endif
 
#if EFI_DYNO_VIEW
    updateDynoView();
#endif
 
    slowCallBackWasInvoked = true;
 
#if EFI_PROD_CODE
    void baroLps25Update();
    baroLps25Update();
#endif // EFI_PROD_CODE
 
#if ANALOG_HW_CHECK_MODE
    criticalAssertVoid(isAdcChannelValid(engineConfiguration->clt.adcChannel), "No CLT setting");
    efitimesec_t secondsNow = getTimeNowS();
 
#if ! HW_CHECK_ALWAYS_STIMULATE
    fail("HW_CHECK_ALWAYS_STIMULATE required to have self-stimulation")
#endif
 
    int hwCheckRpm = 204;
    if (secondsNow > 2 && secondsNow < 180) {
        assertCloseTo("RPM", Sensor::get(SensorType::Rpm).Value, hwCheckRpm);
    } else if (!hasFirmwareError() && secondsNow > 180) {
        static bool isHappyTest = false;
        if (!isHappyTest) {
            setTriggerEmulatorRPM(5 * hwCheckRpm);
            efiPrintf("TEST PASSED");
            isHappyTest = true;
        }
    }
 
    assertCloseTo("clt", Sensor::getRaw(SensorType::Clt), 1.351f);
    assertCloseTo("iat", Sensor::getRaw(SensorType::Iat), 2.245f);
    assertCloseTo("aut1", Sensor::getRaw(SensorType::AuxTemp1), 2.750f);
    assertCloseTo("aut2", Sensor::getRaw(SensorType::AuxTemp2), 3.176f);
#endif // ANALOG_HW_CHECK_MODE
}

Referenced by doPeriodicSlowCallback().

Here is the call graph for this function:

Here is the caller graph for this function:

preCalculate()

void Engine::preCalculate

(

)

Here we have a bunch of stuff which should invoked after configuration change so that we can prepare some helper structures

Definition at line 333 of file engine.cpp.

                          {
#if EFI_TUNER_STUDIO
    // we take 2 bytes of crc32, no idea if it's right to call it crc16 or not
    // we have a hack here - we rely on the fact that engineMake is the first of three relevant fields
    engine->outputChannels.engineMakeCodeNameCrc16 = crc32(engineConfiguration->engineMake, 3 * VEHICLE_INFO_SIZE);
 
    // we need and can empty warning message for CRC purposes
    memset(config->warning_message, 0, sizeof(config->warning_message));
    engine->outputChannels.tuneCrc16 = crc32(config, sizeof(persistent_config_s));
#endif /* EFI_TUNER_STUDIO */
}

Referenced by incrementGlobalConfigurationVersion(), and validateConfiguration().

Here is the caller graph for this function:

reset()

void Engine::reset ( )

private

it's important for wrapAngle() that engineCycle field never has zero

Definition at line 304 of file engine.cpp.

                   {
    /**
     * it's important for wrapAngle() that engineCycle field never has zero
     */
    engineState.engineCycle = getEngineCycle(FOUR_STROKE_CRANK_SENSOR);
    resetLua();
}

Referenced by Engine().

Here is the call graph for this function:

Here is the caller graph for this function:

resetEngineSnifferIfInTestMode()

void Engine::resetEngineSnifferIfInTestMode

(

)

Definition at line 56 of file engine.cpp.

                                            {
#if EFI_ENGINE_SNIFFER
    if (isFunctionalTestMode) {
        // TODO: what is the exact reasoning for the exact engine sniffer pause time I wonder
        waveChart.pauseEngineSnifferUntilNt = getTimeNowNt() + MS2NT(300);
        waveChart.reset();
    }
#endif /* EFI_ENGINE_SNIFFER */
}

Referenced by setEngineType(), setTriggerEmulatorRPM(), setTriggerType(), setValue(), setWholeTimingMapCmd(), and setWholeVeCmd().

Here is the call graph for this function:

Here is the caller graph for this function:

resetLua()

void Engine::resetLua

(

)

Definition at line 312 of file engine.cpp.

                      {
    // todo: https://github.com/rusefi/rusefi/issues/4308
    engineState.lua = {};
    engineState.lua.fuelAdd = 0;
    engineState.lua.fuelMult = 1;
    engineState.lua.luaDisableEtb = false;
    engineState.lua.luaIgnCut = false;
#if EFI_BOOST_CONTROL
    module<BoostController>().unmock().resetLua();
#endif // EFI_BOOST_CONTROL
    ignitionState.luaTimingAdd = 0;
    ignitionState.luaTimingMult = 1;
#if EFI_IDLE_CONTROL
    module<IdleController>().unmock().luaAdd = 0;
#endif // EFI_IDLE_CONTROL
}

Referenced by reset().

Here is the caller graph for this function:

setConfig()

void Engine::setConfig

(

)

Definition at line 402 of file engine.cpp.

                       {
    efi::clear(config);
 
    injectEngineReferences();
}

Referenced by runRusEfi().

Here is the call graph for this function:

Here is the caller graph for this function:

updateSlowSensors()

void Engine::updateSlowSensors

(

)

We are executing these heavy (logarithm) methods from outside the trigger callbacks for performance reasons. See also periodicFastCallback

Definition at line 215 of file engine.cpp.

                               {
    updateSwitchInputs();
 
#if EFI_SHAFT_POSITION_INPUT
    int rpm = Sensor::getOrZero(SensorType::Rpm);
    triggerCentral.isEngineSnifferEnabled = rpm < engineConfiguration->engineSnifferRpmThreshold;
    getEngineState()->sensorChartMode = rpm < engineConfiguration->sensorSnifferRpmThreshold ? engineConfiguration->sensorChartMode : SC_OFF;
 
    engineState.updateSlowSensors();
#endif // EFI_SHAFT_POSITION_INPUT
}

Referenced by periodicSlowCallback(), and testRusefiMethods().

Here is the call graph for this function:

Here is the caller graph for this function:

updateSwitchInputs()

void Engine::updateSwitchInputs

(

)

Definition at line 245 of file engine.cpp.

                                {
#if EFI_GPIO_HARDWARE
    // this value is not used yet
    if (isBrainPinValid(engineConfiguration->clutchDownPin)) {
        engine->engineState.clutchDownState = engineConfiguration->clutchDownPinInverted ^ efiReadPin(engineConfiguration->clutchDownPin);
    }
    {
        bool currentState;
        if (hasAcToggle()) {
            currentState = getAcToggle();
#ifdef EFI_KLINE
        } else if (engineConfiguration->hondaK) {
extern bool kAcRequestState;
            currentState = kAcRequestState;
#endif // EFI_KLINE
        } else {
            currentState = engine->engineState.lua.acRequestState;
        }
        AcController & acController = engine->module<AcController>().unmock();
        if (engine->acButtonSwitchedState.update(currentState)) {
            acController.acSwitchLastChangeTimeMs = US2MS(getTimeNowUs());
        }
    }
    engine->clutchUpSwitchedState.update(getClutchUpState());
 
#if EFI_IDLE_CONTROL
    if (isBrainPinValid(engineConfiguration->throttlePedalUpPin)) {
        engine->module<IdleController>().unmock().throttlePedalUpState = efiReadPin(engineConfiguration->throttlePedalUpPin);
    }
#endif // EFI_IDLE_CONTROL
 
    engine->brakePedalSwitchedState.update(getBrakePedalState());
    pokeAuxDigital();
 
#endif // EFI_GPIO_HARDWARE
}

Referenced by updateSlowSensors().

Here is the call graph for this function:

Here is the caller graph for this function:

updateTriggerWaveform()

void Engine::updateTriggerWaveform

(

)

Definition at line 118 of file engine.cpp.

                                   {
 
 
#if EFI_ENGINE_CONTROL && EFI_SHAFT_POSITION_INPUT
    // we have a confusing threading model so some synchronization would not hurt
    chibios_rt::CriticalSectionLocker csl;
 
    engine->triggerCentral.updateWaveform();
 
 
    if (!engine->triggerCentral.triggerShape.shapeDefinitionError) {
        prepareOutputSignals();
    }
#endif /* EFI_ENGINE_CONTROL && EFI_SHAFT_POSITION_INPUT */
}

Referenced by applyNonPersistentConfiguration(), and onConfigurationChangeTriggerCallback().

Here is the call graph for this function:

Here is the caller graph for this function:

Field Documentation

acButtonSwitchedState

SwitchedState Engine::acButtonSwitchedState

Definition at line 185 of file engine.h.

Referenced by sendQcBenchButtonCounters(), and updateSwitchInputs().

allowCanTx

bool Engine::allowCanTx = true

Sometimes for instance during shutdown we need to completely supress CAN TX

Definition at line 101 of file engine.h.

Referenced by configureRusefiLuaHooks(), and CanTxMessage::~CanTxMessage().

ALSsoftSparkLimiter

SoftSparkLimiter Engine::ALSsoftSparkLimiter

Definition at line 200 of file engine.h.

Referenced by onTriggerEventSparkLogic().

antilagController

AntilagSystemBase Engine::antilagController

Definition at line 196 of file engine.h.

Referenced by getFuelALSCorrection(), getRunningAdvance(), getRunningFuel(), IdleController::getRunningOpenLoop(), EtbController::getSetpointEtb(), onTriggerEventSparkLogic(), and EngineState::periodicFastCallback().

auxValves

AuxActor Engine::auxValves[AUX_DIGITAL_VALVE_COUNT][2]

Definition at line 222 of file engine.h.

Referenced by initAuxValves().

bailedOnDwell

int Engine::bailedOnDwell = 0

Definition at line 226 of file engine.h.

blipIdlePosition

percent_t Engine::blipIdlePosition

idle blip is a development tool: alternator PID research for instance have benefited from a repetitive change of RPM

Definition at line 313 of file engine.h.

Referenced by blipIdle(), and IdleController::getIdlePosition().

brakePedalSwitchedState

SwitchedState Engine::brakePedalSwitchedState

Definition at line 184 of file engine.h.

Referenced by sendQcBenchButtonCounters(), and updateSwitchInputs().

clutchUpSwitchedState

SwitchedState Engine::clutchUpSwitchedState

Definition at line 183 of file engine.h.

Referenced by sendQcBenchButtonCounters(), and updateSwitchInputs().

configBurnTimer

Timer Engine::configBurnTimer

Definition at line 265 of file engine.h.

Referenced by assertTimeIsLinear(), and writeToFlashNow().

dc_motors

dc_motors_s Engine::dc_motors

Definition at line 307 of file engine.h.

Referenced by getOutputValueByName(), and updateTunerStudioState().

enableOverdwellProtection

bool Engine::enableOverdwellProtection = true

Definition at line 94 of file engine.h.

engineModules

type_list< Mockable<InjectorModelPrimary>, Mockable<InjectorModelSecondary>,#if EFI_IDLE_CONTROL Mockable<IdleController>,#endif TriggerScheduler,#if EFI_HPFP && EFI_ENGINE_CONTROL HpfpController,#endif #if EFI_ENGINE_CONTROL Mockable<ThrottleModel>,#endif #if EFI_ALTERNATOR_CONTROL AlternatorController,#endif FuelPumpController, MainRelayController, IgnitionController, Mockable<AcController>, FanControl1, FanControl2, PrimeController, DfcoController,#if EFI_HD_ACR HarleyAcr,#endif Mockable<WallFuelController>,#if EFI_VEHICLE_SPEED GearDetector, TripOdometer,#endif KnockController, SensorChecker,#if EFI_ENGINE_CONTROL LimpManager,#endif #if EFI_VVT_PID VvtController1, VvtController2, VvtController3, VvtController4,#endif #if EFI_BOOST_CONTROL BoostController,#endif EngineModule > Engine::engineModules

Definition at line 168 of file engine.h.

Referenced by incrementGlobalConfigurationVersion(), module(), MainRelayController::onSlowCallback(), IgnitionController::onSlowCallback(), periodicFastCallback(), and periodicSlowCallback().

engineState

EngineState Engine::engineState

Definition at line 305 of file engine.h.

Referenced by auxPlainPinTurnOn(), HpfpQuantity::calcFuelPercent(), canDashboardHaltech(), EtbController::checkStatus(), configureRusefiLuaHooks(), AemXSeriesWideband::decodeRusefiDiag(), detectHellenBoardType(), fireSparkAndPrepareNextSchedule(), firmwareError(), getAcrState(), getAdvanceCorrections(), SpeedDensityAirmass::getAirmass(), AngleBasedEvent::getAngleFromNow(), getBaseFuelMass(), getBoardId(), getBrakePedalState(), getClutchUpState(), getCrankingFuel3(), getEngineState(), getInjectionMass(), getInjectorDutyCycle(), getInjectorDutyCycleStage2(), getMultiSparkCount(), getOutputValueByName(), getPerCylinderFiringOrderOffset(), getRunningAdvance(), getRunningFuel(), AirmassVeModelBase::getVe(), handleGetDataRequest(), handleTestCommand(), initDataStructures(), initializeIgnitionActions(), is_F_OrOlder(), LaunchControlBase::isInsideSwitchCondition(), isMegaModuleRevision(), lua_getDigital(), mapAveragingTriggerCallback(), obdOnCanPacketRx(), KnockControllerBase::onKnockSenseCompleted(), HarleyAcr::onSlowCallback(), onStartStopButtonToggle(), onTriggerEventSparkLogic(), overFireSparkAndPrepareNextSchedule(), periodicFastCallback(), EngineState::periodicFastCallback(), populateFrame(), postMapState(), printConfiguration(), recalculateAuxValveTiming(), refreshMapAveragingPreCalc(), reset(), resetLua(), runOneLua(), sayHello(), scheduleOpen(), scheduleSparkEvent(), sendWidebandInfo(), setBoardConfigOverrides(), Generic4TransmissionController::setPcState(), slowStartStopButtonCallback(), startAveraging(), startDwellByTurningSparkPinHigh(), testRusefiMethods(), THD_FUNCTION(), turnSparkPinHighStartCharging(), updateFuelInfo(), updateSlowSensors(), LimpManager::updateState(), updateSwitchInputs(), updateTunerStudioState(), updateWarningCodes(), and warning().

etbAutoTune

bool Engine::etbAutoTune = false

Definition at line 254 of file engine.h.

Referenced by EtbController::checkStatus(), enableOrDisable(), handleCommandX14(), and initElectronicThrottle().

etbControllers

IEtbController* Engine::etbControllers[ETB_COUNT] = {nullptr}

Definition at line 115 of file engine.h.

Referenced by doInitElectronicThrottle(), etbAutocal(), etbPidReset(), initElectronicThrottle(), setEtbIdlePosition(), setEtbLuaAdjustment(), and setEtbWastegatePosition().

executor [1/3]

SingleTimerExecutor Engine::executor

Definition at line 236 of file engine.h.

Referenced by applyIACposition(), executorStatistics(), fireSparkAndPrepareNextSchedule(), getExecutorInterface(), globalTimerCallback(), Generic4TransmissionController::init(), Gm4l6xTransmissionController::init(), initAlternatorCtrl(), initDcMotor(), initGpPwm(), initPwmTester(), initSpeedometer(), initTachometer(), initVrThresholdPwm(), runBench(), scheduleByAngle(), TriggerScheduler::scheduleEventsUntilNextTriggerTooth(), startBoostPin(), startPwm(), startSimulatedTriggerSignal(), testCallback(), toggleTestAndScheduleNext(), triggerScopeGetBuffer(), turnVvtPidOn(), validateHardwareTimer(), and watchDogBuddyCallback().

executor [2/3]

SleepExecutor Engine::executor

Definition at line 239 of file engine.h.

executor [3/3]

TestExecutor Engine::executor

Definition at line 242 of file engine.h.

fuelComputer

FuelComputer Engine::fuelComputer

Definition at line 118 of file engine.h.

Referenced by boardInitHardware(), IdleController::determinePhase(), getBaseFuelMass(), IdleController::getIdleTimingAdjustment(), ClosedLoopFuelCellImpl::getLambdaError(), LambdaMonitor::getMaxAllowedLambda(), getOutputValueByName(), getRunningFuel(), SensorChecker::onSlowCallback(), EngineState::periodicFastCallback(), populateFrame(), shouldCorrect(), updateLambda(), and EngineState::updateTChargeK().

gearController

GearControllerBase* Engine::gearController

Definition at line 179 of file engine.h.

Referenced by doPeriodicSlowCallback(), and initGearController().

globalConfigurationVersion

int Engine::globalConfigurationVersion = 0

This counter is incremented every time user adjusts ECU parameters online (either via rusEfi console or other tuning software)

Definition at line 271 of file engine.h.

Referenced by getGlobalConfigurationVersion(), and incrementGlobalConfigurationVersion().

hardSparkLimiter

SoftSparkLimiter Engine::hardSparkLimiter

Definition at line 192 of file engine.h.

Referenced by onTriggerEventSparkLogic(), and EngineState::updateSparkSkip().

ignitionEvents

IgnitionEventList Engine::ignitionEvents

Definition at line 249 of file engine.h.

Referenced by getIgnitionEvents(), initDataStructures(), initializeIgnitionActions(), onEngineHasStopped(), and onTriggerEventSparkLogic().

ignitionState

IgnitionState Engine::ignitionState

Definition at line 207 of file engine.h.

Referenced by configureRusefiLuaHooks(), fireSparkAndPrepareNextSchedule(), getAdvanceCorrections(), getCoilDutyCycle(), getOutputValueByName(), getRunningAdvance(), initializeIgnitionActions(), onTriggerEventSparkLogic(), EngineState::periodicFastCallback(), prepareIgnitionSchedule(), resetLua(), and scheduleSparkEvent().

injectionEvents

FuelSchedule Engine::injectionEvents

Definition at line 248 of file engine.h.

Referenced by commonInitEngineController(), getFuelSchedule(), prepareOutputSignals(), resetAccel(), RpmCalculator::setRpmValue(), and updateFuelInfo().

isFunctionalTestMode

bool Engine::isFunctionalTestMode = false

are we running any kind of functional test? this affect some areas

Definition at line 301 of file engine.h.

Referenced by enableOrDisable(), and resetEngineSnifferIfInTestMode().

isPwmEnabled

bool Engine::isPwmEnabled = true

Definition at line 104 of file engine.h.

Referenced by applyPinState(), and enableOrDisable().

isRunningPwmTest

bool Engine::isRunningPwmTest = false

Definition at line 295 of file engine.h.

Referenced by efiWatchdog(), and startPwmTest().

lambdaMonitor

LambdaMonitor Engine::lambdaMonitor

Definition at line 204 of file engine.h.

Referenced by getOutputValueByName(), EngineState::periodicFastCallback(), populateFrame(), and LimpManager::updateState().

launchController

LaunchControlBase Engine::launchController

Definition at line 189 of file engine.h.

Referenced by canDashboardHaltech(), getOutputValueByName(), getRunningAdvance(), getRunningFuel(), EngineState::periodicFastCallback(), updateFlags(), and LimpManager::updateState().

luaDigitalInputState

SimpleSwitchedState Engine::luaDigitalInputState[LUA_DIGITAL_INPUT_COUNT]

Definition at line 186 of file engine.h.

Referenced by pokeAuxDigital(), and sendQcBenchAuxDigitalCounters().

mockAirmassModel

AirmassModelBase* Engine::mockAirmassModel = nullptr

Definition at line 346 of file engine.h.

Referenced by getAirmassModel().

needTdcCallback

bool Engine::needTdcCallback = true

Definition at line 225 of file engine.h.

Referenced by onTdcCallback().

onIgnitionEvent

std::function<void(IgnitionEvent*, bool)> Engine::onIgnitionEvent

Definition at line 244 of file engine.h.

Referenced by fireSparkAndPrepareNextSchedule(), and turnSparkPinHighStartCharging().

outputChannels

TunerStudioOutputChannels Engine::outputChannels

Definition at line 96 of file engine.h.

Referenced by attachMsdSdCard(), canInfo(), EtbController::checkStatus(), TunerStudio::cmdOutputChannels(), completionCallback(), TriggerCentral::decodeMapCam(), executorStatistics(), fast_adc_callback(), fireSparkAndPrepareNextSchedule(), fuelClosedLoopCorrection(), getAdvanceCorrections(), getAvgAdcValue(), VvtController::getClosedLoop(), BoostController::getClosedLoop(), AlternatorController::getClosedLoop(), EtbController::getClosedLoopAutotune(), IdleController::getIdlePosition(), getLiveData(), SpeedDensityAirmass::getMap(), BoostController::getOpenLoop(), getOutputValueByName(), getRunningAdvance(), BoostController::getSetpoint(), VvtController::getSetpoint(), EtbController::getSetpointEtb(), EtbController::getSetpointIdleValve(), TpsAccelEnrichment::getTpsEnrichment(), getTunerStudioOutputChannels(), AirmassVeModelBase::getVe(), grabPedalIsUp(), grabPedalIsWideOpen(), handleCommandX14(), handleFuel(), handleShaftSignal(), handleVvtCamSignal(), initElectronicThrottle(), lua_setDebug(), mapAveragingAdcCallback(), mountMmc(), myAlloc(), onTriggerEventSparkLogic(), InjectionEvent::onTriggerTooth(), populateFrame(), postCanState(), StepperMotorBase::postCurrentPosition(), GearControllerBase::postState(), preCalculate(), prepareCylinderIgnitionSchedule(), printErrorCounters(), printUid(), processLastKnockEvent(), readGppwmChannel(), reportLogicAnalyzerToTS(), runBench(), runOneLua(), IgnitionOutputPin::setHigh(), IgnitionOutputPin::setLow(), EtbController::setOutput(), setToothLogReady(), startLua(), THD_FUNCTION(), tle8888PostState(), triggerScopeDisable(), triggerScopeGetBuffer(), InjectionEvent::update(), SimpleTransmissionController::update(), DynoView::update(), updateEgtSensors(), updateFlags(), updateFuelCorrections(), updateFuelInfo(), updateFuelResults(), updateFuelSensors(), updateGppwm(), updateIgnition(), updateLambda(), updateMiscSensors(), updatePressures(), updateRawSensors(), updateTempSensors(), updateThrottles(), updateTunerStudioState(), updateVehicleSpeed(), updateVvtSensors(), updateWarningCodes(), and CanTxMessage::~CanTxMessage().

pauseCANdueToSerial

bool Engine::pauseCANdueToSerial = false

ELM327 cannot handle both RX and TX at the same time, we have to stay quite once first ISO/TP packet was detected this is a pretty temporary hack only while we are trying ELM327, long term ISO/TP and rusEFI broadcast should find a way to coexists

Definition at line 111 of file engine.h.

Referenced by CanWrite::PeriodicTask(), and CanStreamerState::receiveFrame().

pinRepository

PinRepository Engine::pinRepository

Definition at line 113 of file engine.h.

Referenced by brain_pin_markUsed(), getBrainUsedPin(), and setPin().

prevOutputName

const char* Engine::prevOutputName = nullptr

Definition at line 106 of file engine.h.

rpmCalculator

RpmCalculator Engine::rpmCalculator

Definition at line 263 of file engine.h.

Referenced by commonInitEngineController(), configureRusefiLuaHooks(), IdleController::determinePhase(), disengageStarterIfNeeded(), doPeriodicSlowCallback(), enableTriggerStimulator(), executeTSCommand(), getAdvance(), getCrankingFuel(), IdleController::getCrankingTaperFraction(), TriggerCentral::getCurrentEnginePhase(), getCurrentIgnitionMode(), getEngineRotationState(), getInjectionMass(), VvtController::getSetpoint(), IgnitionState::getSparkDwell(), FanController::getState(), TriggerCentral::handleShaftSignal(), mainTriggerCallback(), onEcuStartDoSomethingTriggerInputPins(), WallFuelController::onFastCallback(), TripOdometer::onSlowCallback(), onStartStopButtonToggle(), PrimaryTriggerDecoder::onTriggerError(), OnTriggerStateProperState(), OnTriggerSynchronizationLost(), EngineState::periodicFastCallback(), periodicSlowCallback(), rpmShaftPositionCallback(), scheduleByAngle(), StepperMotorBase::setInitialPosition(), shouldCorrect(), startKnockSampling(), tle8888startup(), LimpManager::updateState(), and updateTunerStudioState().

sensors

SensorsState Engine::sensors

Definition at line 317 of file engine.h.

Referenced by processCanRxImu_BoschM5_10_RollX(), processCanRxImu_BoschM5_10_YawY(), processCanRxImu_BoschM5_10_Z(), and updateTunerStudioState().

sent_state

sent_state_s Engine::sent_state

Definition at line 308 of file engine.h.

Referenced by SentDecoderThread().

slowCallBackWasInvoked

bool Engine::slowCallBackWasInvoked = false

Definition at line 261 of file engine.h.

Referenced by EngineState::periodicFastCallback(), and periodicSlowCallback().

softSparkLimiter

SoftSparkLimiter Engine::softSparkLimiter

Definition at line 190 of file engine.h.

Referenced by onTriggerEventSparkLogic(), and EngineState::updateSparkSkip().

startStopStateLastPush

Timer Engine::startStopStateLastPush

Definition at line 210 of file engine.h.

Referenced by disengageStarterIfNeeded(), and onStartStopButtonToggle().

stftCorrection

float Engine::stftCorrection[STFT_BANK_COUNT] = {0}

Definition at line 280 of file engine.h.

Referenced by handleGetDataRequest(), EngineState::periodicFastCallback(), populateFrame(), and updateFuelCorrections().

tdcMarkEnabled

bool Engine::tdcMarkEnabled = true

Definition at line 257 of file engine.h.

Referenced by tdcMarkCallback().

tdcScheduler

scheduling_s Engine::tdcScheduler[2]

Definition at line 250 of file engine.h.

Referenced by tdcMarkCallback().

timeToStopBlip

efitimeus_t Engine::timeToStopBlip = 0

Definition at line 314 of file engine.h.

Referenced by blipIdle(), IdleController::getIdlePosition(), and undoIdleBlipIfNeeded().

timeToStopIdleTest

efitimeus_t Engine::timeToStopIdleTest = 0

Definition at line 315 of file engine.h.

Referenced by applyIACposition(), finishIdleTestIfNeeded(), and startIdleBench().

tpsAccelEnrichment

TpsAccelEnrichment Engine::tpsAccelEnrichment

Definition at line 273 of file engine.h.

Referenced by getInjectionMass(), TriggerCentral::handleShaftSignal(), periodicSlowCallback(), resetAccel(), setTpsAccelLen(), and updateTunerStudioState().

triggerCentral

TriggerCentral Engine::triggerCentral

Definition at line 276 of file engine.h.

Referenced by applyIACposition(), canDashboardHaltech(), RpmCalculator::checkIfSpinning(), EtbController::checkStatus(), configureRusefiLuaHooks(), disableTriggerStimulator(), doPeriodicSlowCallback(), efiWatchdog(), emulatorApplyPinState(), enableExternalTriggerStimulator(), enableTriggerStimulator(), extIonCallback(), HpfpLobe::findNextLobe(), getAdvanceCorrections(), getCurrentIgnitionMode(), RpmCalculator::getOperationMode(), getOutputValueByName(), getTriggerCentral(), injectEngineReferences(), isTriggerErrorNow(), VvtController::observePlant(), onFastAdcComplete(), HpfpController::onFastCallback(), RpmCalculator::onSlowCallback(), IdleController::onSlowCallback(), FuelPumpController::onSlowCallback(), PrimaryTriggerDecoder::onTriggerError(), OnTriggerSynchronization(), OnTriggerSynchronizationLost(), periodicSlowCallback(), populateFrame(), prepareOutputSignals(), readGppwmChannel(), refreshMapAveragingPreCalc(), rpmShaftPositionCallback(), sendQcBenchEventCounters(), SetNextCompositeEntry(), RpmCalculator::setSpinningUp(), RpmCalculator::setStopped(), startSimulatedTriggerSignal(), startTriggerInputPins(), updateDevConsoleState(), updateSlowSensors(), LimpManager::updateState(), updateTriggerWaveform(), updateTunerStudioState(), updateVvtSensors(), and TriggerCentral::updateWaveform().

versionForConfigurationListeners

LocalVersionHolder Engine::versionForConfigurationListeners

Definition at line 220 of file engine.h.

Referenced by doPeriodicSlowCallback().

---

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

• controllers/algo/engine.h
• controllers/algo/engine.cpp
• controllers/engine_cycle/knock_controller.cpp