InjectorModelWithConfig Class Reference

#include <injector_model.h>

Inheritance diagram for InjectorModelWithConfig:

Collaboration diagram for InjectorModelWithConfig:

Public Types
using	interface_t = IInjectorModel

Public Member Functions
	InjectorModelWithConfig (const injector_s *const cfg)
floatms_t	getDeadtime () const override
float	getBaseFlowRate () const override
float	getInjectorFlowRatio () override
void	updateState () override
expected< float >	getFuelDifferentialPressure () const override
expected< float >	getFuelPressure () const override
floatms_t	getInjectionDuration (float fuelMassGram) const override
Public Member Functions inherited from InjectorModelBase
void	prepare () override
float	getFuelMassForDuration (floatms_t duration) const override
virtual InjectorNonlinearMode	getNonlinearMode () const =0
floatms_t	getBaseDurationImpl (float fuelMassGram) const
virtual floatms_t	correctInjectionPolynomial (float floatms_t) const
virtual float	getSmallPulseFlowRate () const =0
virtual float	getSmallPulseBreakPoint () const =0
Public Member Functions inherited from EngineModule
virtual void	initNoConfiguration ()
virtual void	setDefaultConfiguration ()
virtual void	onConfigurationChange (engine_configuration_s const *)
virtual void	onSlowCallback ()
virtual void	onFastCallback ()
virtual void	onEngineStop ()
virtual void	onIgnitionStateChanged (bool)
virtual bool	needsDelayedShutoff ()
virtual void	onEnginePhase (float, efitick_t, angle_t, angle_t)

Private Member Functions
virtual injector_compensation_mode_e	getInjectorCompensationMode () const =0
virtual float	getFuelReferencePressure () const =0

Private Attributes
const injector_s *const	m_cfg

Additional Inherited Members
Data Fields inherited from injector_model_s
float	m_deadtime = (float)0
float	pressureDelta = (float)0
float	pressureRatio = (float)0
float	pressureCorrectionReference = (float)0

Detailed Description

Definition at line 49 of file injector_model.h.

Member Typedef Documentation

interface_t

using InjectorModelWithConfig::interface_t = IInjectorModel

Definition at line 61 of file injector_model.h.

Constructor & Destructor Documentation

InjectorModelWithConfig()

InjectorModelWithConfig::InjectorModelWithConfig

(

const injector_s *const

cfg

)

Definition at line 290 of file injector_model.cpp.

    : m_cfg(cfg)
{
}

Member Function Documentation

getBaseFlowRate()

float InjectorModelWithConfig::getBaseFlowRate ( ) const

overridevirtual

Implements InjectorModelBase.

Definition at line 27 of file injector_model.cpp.

                                                     {
    if (engineConfiguration->injectorFlowAsMassFlow) {
        return m_cfg->flow;
    } else {
        return convertToGramsPerSecond(m_cfg->flow);
    }
}

Here is the call graph for this function:

getDeadtime()

float InjectorModelWithConfig::getDeadtime ( ) const

overridevirtual

Implements IInjectorModel.

Definition at line 183 of file injector_model.cpp.

                                                 {
    return interpolate3d(
        m_cfg->battLagCorrTable,
        m_cfg->battLagCorrPressBins, pressureCorrectionReference,
        m_cfg->battLagCorrBattBins, Sensor::get(SensorType::BatteryVoltage).value_or(VBAT_FALLBACK_VALUE)
    );
}

Here is the call graph for this function:

getFuelDifferentialPressure()

expected< float > InjectorModelWithConfig::getFuelDifferentialPressure ( ) const

overridevirtual

Implements InjectorModelBase.

Definition at line 94 of file injector_model.cpp.

                                                                           {
    auto map = Sensor::get(SensorType::Map);
    auto baro = Sensor::get(SensorType::BarometricPressure);
 
    float baroKpa = baro.Value;
    // todo: extract baro sensor validation logic
    if (!baro || baro.Value > 120 || baro.Value < 50) {
        baroKpa = STD_ATMOSPHERE;
    }
 
    switch (getInjectorCompensationMode()) {
        case ICM_FixedRailPressure:
            // Add barometric pressure, as "fixed" really means "fixed pressure above atmosphere"
            return getFuelReferencePressure()
                + baroKpa
                - map.value_or(STD_ATMOSPHERE);
        case ICM_SensedRailPressure: {
            if (!Sensor::hasSensor(SensorType::FuelPressureInjector)) {
                warning(ObdCode::OBD_Fuel_Pressure_Sensor_Missing, "Fuel pressure compensation is set to use a pressure sensor, but none is configured.");
                return unexpected;
            }
 
            auto fps = Sensor::get(SensorType::FuelPressureInjector);
 
            // TODO: what happens when the sensor fails?
            if (!fps) {
                return unexpected;
            }
 
            switch (engineConfiguration->fuelPressureSensorMode) {
                case FPM_Differential:
                    // This sensor directly measures delta-P, no math needed!
                    return fps.Value;
                case FPM_Gauge:
                    if (!map) {
                        return unexpected;
                    }
 
                    return fps.Value + baroKpa - map.Value;
                case FPM_Absolute:
                default:
                    if (!map) {
                        return unexpected;
                    }
 
                    return fps.Value - map.Value;
            }
        } default: return unexpected;
    }
}

Referenced by getFuelPressure(), getInjectorFlowRatio(), and updateState().

Here is the call graph for this function:

Here is the caller graph for this function:

getFuelPressure()

expected< float > InjectorModelWithConfig::getFuelPressure ( ) const

overridevirtual

Implements InjectorModelBase.

Definition at line 90 of file injector_model.cpp.

                                                               {
  return getFuelDifferentialPressure().Value + Sensor::get(SensorType::Map).value_or(STD_ATMOSPHERE);
}

Referenced by updateState().

Here is the call graph for this function:

Here is the caller graph for this function:

getFuelReferencePressure()

virtual float InjectorModelWithConfig::getFuelReferencePressure ( ) const

privatepure virtual

Implemented in InjectorModelPrimary, and InjectorModelSecondary.

Referenced by getFuelDifferentialPressure(), and getInjectorFlowRatio().

Here is the caller graph for this function:

getInjectionDuration()

floatms_t InjectorModelWithConfig::getInjectionDuration ( float  fuelMassGram ) const

overridevirtual

Reimplemented from InjectorModelBase.

Definition at line 204 of file injector_model.cpp.

                                                                                {
    if (fuelMassGram <= 0) {
        // If 0 mass, don't do any math, just skip the injection.
        return 0.0f;
    }
 
  // hopefully one day we pick between useInjectorFlowLinearizationTable and ICM_HPFP_Manual_Compensation approaches
  // and not more than one of these would stay
    if (engineConfiguration->useInjectorFlowLinearizationTable) {
      auto fps = Sensor::get(SensorType::FuelPressureInjector);
    // todo: KPA vs BAR mess?!
    return interpolate3d(config->injectorFlowLinearization,
            config->injectorFlowLinearizationPressureBins, KPA2BAR(fps.Value),// array values are on bar
            config->injectorFlowLinearizationFuelMassBins, fuelMassGram * 1000);  // array values are on mg
    }
 
    // Get the no-offset duration
    floatms_t baseDuration = getBaseDurationImpl(fuelMassGram);
 
    // default non GDI case
    if (getInjectorCompensationMode() != ICM_HPFP_Manual_Compensation) {
        // Add deadtime offset
        return baseDuration + m_deadtime;
    }
 
    if (!Sensor::hasSensor(SensorType::FuelPressureHigh)) {
        return baseDuration + m_deadtime;
    }
 
    auto fps = Sensor::get(SensorType::FuelPressureHigh);
    // todo: KPA vs BAR mess in code and UI?!
    float fuelMassCompensation = interpolate3d(config->hpfpFuelMassCompensation,
            config->hpfpFuelMassCompensationFuelPressure, KPA2BAR(fps.Value),// array values are on bar
            config->hpfpFuelMassCompensationFuelMass, fuelMassGram * 1000);  // array values are on mg
 
    // recalculate base duration with fuel mass compensation
    baseDuration =  getBaseDurationImpl(fuelMassGram * fuelMassCompensation);
    return baseDuration + m_deadtime;
}

Here is the call graph for this function:

getInjectorCompensationMode()

virtual injector_compensation_mode_e InjectorModelWithConfig::getInjectorCompensationMode ( ) const

privatepure virtual

Implemented in InjectorModelPrimary, and InjectorModelSecondary.

Referenced by getFuelDifferentialPressure(), getInjectionDuration(), and getInjectorFlowRatio().

Here is the caller graph for this function:

getInjectorFlowRatio()

float InjectorModelWithConfig::getInjectorFlowRatio ( )

overridevirtual

Implements InjectorModelBase.

Definition at line 145 of file injector_model.cpp.

                                                    {
    // Compensation disabled, use reference flow.
    auto compensationMode = getInjectorCompensationMode();
    if (compensationMode == ICM_None || compensationMode == ICM_HPFP_Manual_Compensation) {
        return 1.0f;
    }
 
    const float referencePressure = getFuelReferencePressure();
 
    if (referencePressure < 50) {
        // impossibly low fuel ref pressure
        criticalError("Impossible fuel reference pressure: %f", referencePressure);
 
        return 1.0f;
    }
 
    expected<float> diffPressure = getFuelDifferentialPressure();
 
    // If sensor failed, best we can do is disable correction
    if (!diffPressure) {
        return 1.0f;
    }
 
    pressureDelta = diffPressure.Value;
 
    // Somehow pressure delta is less than 0, assume failed sensor and return default flow
    if (pressureDelta <= 0) {
        return 1.0f;
    }
 
    pressureRatio = pressureDelta / referencePressure;
    // todo: live data model?
    float flowRatio = sqrtf(pressureRatio);
 
    // TODO: should the flow ratio be clamped?
    return flowRatio;
}

Here is the call graph for this function:

updateState()

void InjectorModelWithConfig::updateState ( )

overridevirtual

Implements InjectorModelBase.

Definition at line 80 of file injector_model.cpp.

                                          {
    // TODO: remove at the end of 2025
    // hack not to break tunes before 2779925f54f5c2d23499cbb2797f71508c652f54 "injector lag lookup should be done based on differential pressure"
    if (engineConfiguration->useAbsolutePressureForLagTime) {
        pressureCorrectionReference = getFuelPressure().Value;
    } else {
        pressureCorrectionReference = getFuelDifferentialPressure().Value;
    }
}

Here is the call graph for this function:

Field Documentation

m_cfg

const injector_s* const InjectorModelWithConfig::m_cfg

private

Definition at line 66 of file injector_model.h.

Referenced by getBaseFlowRate(), and getDeadtime().

---

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

• controllers/algo/fuel/injector_model.h
• controllers/algo/fuel/injector_model.cpp