PrimeController Class Reference

#include <prime_injection.h>

Inheritance diagram for PrimeController:

Collaboration diagram for PrimeController:

Public Member Functions
void	onIgnitionStateChanged (bool ignitionOn) override
void	onSlowCallback () override
floatms_t	getPrimeDuration () const
void	onPrimeStart ()
void	onPrimeEnd ()
bool	isPriming () const
Public Member Functions inherited from EngineModule
virtual void	initNoConfiguration ()
virtual void	setDefaultConfiguration ()
virtual void	onConfigurationChange (engine_configuration_s const *)
virtual void	onFastCallback ()
virtual void	onEngineStop ()
virtual bool	needsDelayedShutoff ()
virtual void	onEnginePhase (float, efitick_t, angle_t, angle_t)

Private Member Functions
uint32_t	getKeyCycleCounter () const
void	setKeyCycleCounter (uint32_t count)

Static Private Member Functions
static void	onPrimeStartAdapter (PrimeController *instance)
static void	onPrimeEndAdapter (PrimeController *instance)

Additional Inherited Members
Data Fields inherited from prime_injection_s
bool	m_isPriming: 1 {}
bool	unusedBit_1_1: 1 {}
bool	unusedBit_1_2: 1 {}
bool	unusedBit_1_3: 1 {}
bool	unusedBit_1_4: 1 {}
bool	unusedBit_1_5: 1 {}
bool	unusedBit_1_6: 1 {}
bool	unusedBit_1_7: 1 {}
bool	unusedBit_1_8: 1 {}
bool	unusedBit_1_9: 1 {}
bool	unusedBit_1_10: 1 {}
bool	unusedBit_1_11: 1 {}
bool	unusedBit_1_12: 1 {}
bool	unusedBit_1_13: 1 {}
bool	unusedBit_1_14: 1 {}
bool	unusedBit_1_15: 1 {}
bool	unusedBit_1_16: 1 {}
bool	unusedBit_1_17: 1 {}
bool	unusedBit_1_18: 1 {}
bool	unusedBit_1_19: 1 {}
bool	unusedBit_1_20: 1 {}
bool	unusedBit_1_21: 1 {}
bool	unusedBit_1_22: 1 {}
bool	unusedBit_1_23: 1 {}
bool	unusedBit_1_24: 1 {}
bool	unusedBit_1_25: 1 {}
bool	unusedBit_1_26: 1 {}
bool	unusedBit_1_27: 1 {}
bool	unusedBit_1_28: 1 {}
bool	unusedBit_1_29: 1 {}
bool	unusedBit_1_30: 1 {}
bool	unusedBit_1_31: 1 {}

Detailed Description

Definition at line 13 of file prime_injection.h.

Member Function Documentation

getKeyCycleCounter()

uint32_t PrimeController::getKeyCycleCounter ( ) const

private

Definition at line 85 of file prime_injection.cpp.

                                                   {
#if EFI_BACKUP_SRAM
    return backupRamLoad(backup_ram_e::IgnCounter);
#else // not EFI_BACKUP_SRAM
    return 0;
#endif // EFI_BACKUP_SRAM
}

Referenced by onIgnitionStateChanged().

Here is the call graph for this function:

Here is the caller graph for this function:

getPrimeDuration()

floatms_t PrimeController::getPrimeDuration

(

)

const

Definition at line 14 of file prime_injection.cpp.

                                                  {
    auto clt = Sensor::get(SensorType::Clt);
 
    // If the coolant sensor is dead, skip the prime. The engine will still start fine, but may take a little longer.
    if (!clt) {
        return 0;
    }
 
    auto primeMass =
        0.001f *    // convert milligram to gram
        interpolate2d(clt.Value, engineConfiguration->primeBins, engineConfiguration->primeValues);
 
    efiPrintf("Priming pulse mass: %.4f g", primeMass);
 
    return engine->module<InjectorModelPrimary>()->getInjectionDuration(primeMass);
}

Referenced by onPrimeStart().

Here is the call graph for this function:

Here is the caller graph for this function:

isPriming()

bool PrimeController::isPriming ( ) const

inline

Definition at line 23 of file prime_injection.h.

                           {
        return m_isPriming;
    }

onIgnitionStateChanged()

void PrimeController::onIgnitionStateChanged ( bool  ignitionOn )

overridevirtual

Reimplemented from EngineModule.

Definition at line 42 of file prime_injection.cpp.

                                                            {
    if (!ignitionOn) {
        // don't prime on ignition-off
        return;
    }
 
    // First, we need a protection against 'fake' ignition switch on and off (i.e. no engine started), to avoid repeated prime pulses.
    // So we check and update the ignition switch counter in non-volatile backup-RAM
    uint32_t ignSwitchCounter = getKeyCycleCounter();
 
    // if we're just toying with the ignition switch, give it another chance eventually...
    if (ignSwitchCounter > 10) {
        ignSwitchCounter = 0;
    }
 
    // If we're going to skip this pulse, then save the counter as 0.
    // That's because we'll definitely need the prime pulse next time (either due to the cylinder cleanup or the engine spinning)
    if (isPrimeInjectionPulseSkipped()) {
        ignSwitchCounter = -1;
    }
 
    // start prime injection if this is a 'fresh start'
    if (ignSwitchCounter == 0) {
        // Give sensors long enough to wake up before priming
        constexpr float minimumPrimeDelayMs = 100;
        int32_t primeDelayNt = assertFloatFitsInto32BitsAndCast("primingDelay", MSF2NT(engineConfiguration->primingDelay * 1000 + minimumPrimeDelayMs));
 
        auto startTime = getTimeNowNt() + primeDelayNt;
        getScheduler()->schedule("primingDelay", nullptr, startTime, action_s::make<onPrimeStartAdapter>( this ));
    } else {
        efiPrintf("Skipped priming pulse since ignSwitchCounter = %lu", ignSwitchCounter);
    }
 
    // we'll reset it later when the engine starts
    setKeyCycleCounter(ignSwitchCounter + 1);
}

Here is the call graph for this function:

onPrimeEnd()

void PrimeController::onPrimeEnd

(

)

Definition at line 118 of file prime_injection.cpp.

                                 {
    endSimultaneousInjectionOnlyTogglePins();
 
    m_isPriming = false;
}

Here is the call graph for this function:

onPrimeEndAdapter()

static void PrimeController::onPrimeEndAdapter ( PrimeController *  instance )

inlinestaticprivate

Definition at line 33 of file prime_injection.h.

                                                             {
        instance->onPrimeEnd();
    }

onPrimeStart()

void PrimeController::onPrimeStart

(

)

Definition at line 93 of file prime_injection.cpp.

                                   {
    auto durationMs = getPrimeDuration();
 
    // Don't prime a zero-duration pulse
    if (durationMs <= 0) {
        efiPrintf("Skipped zero-duration priming pulse.");
        return;
    }
#if EFI_PROD_CODE
    if (durationMs >= TOO_FAR_INTO_FUTURE_MS) {
      criticalError("Priming duration too long %dms", durationMs);
    }
#endif
 
    efiPrintf("Firing priming pulse of %.2f ms", durationMs);
    engine->outputChannels.injectionPrimingCounter++;
 
    auto endTime = sumTickAndFloat(getTimeNowNt(), MSF2NT(durationMs));
 
    // Open all injectors, schedule closing later
    m_isPriming = true;
    startSimultaneousInjection();
    getScheduler()->schedule("onPrimeStart", nullptr, endTime, action_s::make<onPrimeEndAdapter>( this ));
}

Here is the call graph for this function:

onPrimeStartAdapter()

static void PrimeController::onPrimeStartAdapter ( PrimeController *  instance )

inlinestaticprivate

Definition at line 29 of file prime_injection.h.

                                                               {
        instance->onPrimeStart();
    }

onSlowCallback()

void PrimeController::onSlowCallback ( )

overridevirtual

Reimplemented from EngineModule.

Definition at line 124 of file prime_injection.cpp.

                                     {
    if (!getEngineRotationState()->isStopped()) {
#if EFI_BACKUP_SRAM
        backupRamSave(backup_ram_e::IgnCounter, 0);
#endif /* EFI_BACKUP_SRAM */
    }
}

Here is the call graph for this function:

setKeyCycleCounter()

void PrimeController::setKeyCycleCounter ( uint32_t  count )

private

Definition at line 79 of file prime_injection.cpp.

                                                       {
#if EFI_BACKUP_SRAM
    backupRamSave(backup_ram_e::IgnCounter, count);
#endif // EFI_BACKUP_SRAM
}

Referenced by onIgnitionStateChanged().

Here is the call graph for this function:

Here is the caller graph for this function:

---

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

• controllers/engine_cycle/prime_injection.h
• controllers/engine_cycle/prime_injection.cpp