Trigger shape has all the fields needed to describe and decode trigger signal. More...

#include <trigger_structure.h>

Collaboration diagram for TriggerWaveform:

[legend]

Public Member Functions
	TriggerWaveform ()

void	initializeTriggerWaveform (operation_mode_e triggerOperationMode, const trigger_config_s &triggerType, bool isCrankWheel=true)

void	setShapeDefinitionError (bool value)

void	calculateExpectedEventCounts ()

size_t	getExpectedEventCount (TriggerWheel channelIndex) const

void	addEvent (angle_t angle, TriggerValue const state, TriggerWheel const channelIndex=TriggerWheel::T_PRIMARY)

void	addEvent720 (angle_t angle, TriggerValue const state, TriggerWheel const channelIndex=TriggerWheel::T_PRIMARY)

void	addEvent360 (angle_t angle, TriggerValue const state, TriggerWheel const channelIndex=TriggerWheel::T_PRIMARY)

void	addToothRiseFall (angle_t angle, angle_t width=10, TriggerWheel const channelIndex=TriggerWheel::T_PRIMARY)

void	addToothFallRise (angle_t angle, angle_t width=10, TriggerWheel const channelIndex=TriggerWheel::T_PRIMARY)

void	addEventAngle (angle_t angle, TriggerValue const state, TriggerWheel const channelIndex=TriggerWheel::T_PRIMARY)

void	addEventClamped (angle_t angle, TriggerValue const state, TriggerWheel const channelIndex, float filterLeft, float filterRight)

operation_mode_e	getWheelOperationMode () const

void	initialize (operation_mode_e operationMode, SyncEdge syncEdge)

void	setTriggerSynchronizationGap (float syncRatio)

void	setTriggerSynchronizationGap3 (int index, float syncRatioFrom, float syncRatioTo)

void	setTriggerSynchronizationGap4 (int index, float syncRatio)

void	setTriggerSynchronizationGap2 (float syncRatioFrom, float syncRatioTo)

void	setSecondTriggerSynchronizationGap (float syncRatio)

void	setSecondTriggerSynchronizationGap2 (float syncRatioFrom, float syncRatioTo)

void	setThirdTriggerSynchronizationGap (float syncRatio)

size_t	getLength () const

size_t	getSize () const

int	getTriggerWaveformSynchPointIndex () const

angle_t	getAngle (int phaseIndex) const

angle_t	getCycleDuration () const

bool	needsDisambiguation () const

void	initializeSyncPoint (TriggerDecoderBase &state, const TriggerConfiguration &triggerConfiguration)

uint16_t	findAngleIndex (TriggerFormDetails *details, angle_t angle) const

TriggerWheel	getWheel (size_t index)

angle_t	getSwitchAngle (int index) const

Data Fields
bool	isSynchronizationNeeded

bool	isSecondWheelCam

int	gapTrackingLength = 1

bool	shapeWithoutTdc = false

bool	needSecondTriggerInput = false

bool	shapeDefinitionError = false

int	version = 0

float	synchronizationRatioFrom [GAP_TRACKING_LENGTH]

float	synchronizationRatioTo [GAP_TRACKING_LENGTH]

int	syncRatioAvg

angle_t	tdcPosition

bool	useOnlyPrimaryForSync

SyncEdge	syncEdge

bool	useOnlyRisingEdges

size_t	expectedEventCount [PWM_PHASE_MAX_WAVE_PER_PWM]

TriggerWheel	triggerSignalIndeces [PWM_PHASE_MAX_COUNT]

TriggerValue	triggerSignalStates [PWM_PHASE_MAX_COUNT]

bool	knownOperationMode = true

MultiChannelStateSequenceWithData< PWM_PHASE_MAX_COUNT >	wave

bool	isRiseEvent [PWM_PHASE_MAX_COUNT]

int	triggerShapeSynchPointIndex

Private Attributes
angle_t	previousAngle

operation_mode_e	operationMode

Detailed Description

Trigger shape has all the fields needed to describe and decode trigger signal.

See also: TriggerState for trigger decoder state which works based on this trigger shape model

Definition at line 47 of file trigger_structure.h.

Constructor & Destructor Documentation

◆ TriggerWaveform()

TriggerWaveform::TriggerWaveform ( )

Definition at line 61 of file trigger_structure.cpp.

                                 {
    initialize(OM_NONE, SyncEdge::Rise);
}

Here is the call graph for this function:

Member Function Documentation

◆ addEvent()

void TriggerWaveform::addEvent	(	angle_t	angle,
		TriggerValue const	state,
		TriggerWheel const	channelIndex = `TriggerWheel::T_PRIMARY`
	)

Parameters

angle (0..1]

todo: it would be nice to be able to provide trigger angles without sorting them externally The idea here is to shift existing data - including handling high vs low state of the signals

Definition at line 270 of file trigger_structure.cpp.

                                                                                                       {
    efiAssertVoid(ObdCode::CUSTOM_OMODE_UNDEF, operationMode != OM_NONE, "operationMode not set");
 
    if (channelIndex == TriggerWheel::T_SECONDARY) {
        needSecondTriggerInput = true;
    }
 
#if EFI_UNIT_TEST
    if (printTriggerDebug) {
        printf("addEvent2 %.2f i=%d front=%d\r\n", angle, channelIndex, state);
    }
#endif
 
#if EFI_UNIT_TEST
    assertIsInBounds(wave.phaseCount, triggerSignalIndeces, "trigger shape overflow");
    triggerSignalIndeces[wave.phaseCount] = channelIndex;
    triggerSignalStates[wave.phaseCount] = state;
#endif // EFI_UNIT_TEST
 
 
    // todo: the whole 'useOnlyRisingEdgeForTrigger' parameter and logic should not be here
    // todo: see calculateExpectedEventCounts
    // related calculation should be done once trigger is initialized outside of trigger shape scope
    if (!useOnlyRisingEdges || state == TriggerValue::RISE) {
        expectedEventCount[(int)channelIndex]++;
    }
 
    if (angle <= 0 || angle > 1) {
        firmwareError(ObdCode::CUSTOM_ERR_6599, "angle should be positive not above 1: index=%d angle %f", (int)channelIndex, angle);
        return;
    }
    if (wave.phaseCount > 0) {
        if (angle <= previousAngle) {
            warning(ObdCode::CUSTOM_ERR_TRG_ANGLE_ORDER, "invalid angle order %s %s: new=%.2f/%f and prev=%.2f/%f, size=%d",
                    getTriggerWheel(channelIndex),
                    getTrigger_value_e(state),
                    angle, angle * getCycleDuration(),
                    previousAngle, previousAngle * getCycleDuration(),
                    wave.phaseCount);
            setShapeDefinitionError(true);
            return;
        }
    }
    previousAngle = angle;
    if (wave.phaseCount == 0) {
        wave.phaseCount = 1;
        for (int i = 0; i < PWM_PHASE_MAX_WAVE_PER_PWM; i++) {
            wave.setChannelState(i, /* switchIndex */ 0, TriggerValue::FALL);
        }
 
        isRiseEvent[0] = TriggerValue::RISE == state;
        wave.setSwitchTime(0, angle);
        wave.setChannelState((int)channelIndex, /* channelIndex */ 0, /* value */ state);
        return;
    }
 
    if (wave.findAngleMatch(angle)) {
        warning(ObdCode::CUSTOM_ERR_SAME_ANGLE, "same angle: not supported");
        setShapeDefinitionError(true);
        return;
    }
 
    int index = wave.findInsertionAngle(angle);
 
    /**
     * todo: it would be nice to be able to provide trigger angles without sorting them externally
     * The idea here is to shift existing data - including handling high vs low state of the signals
     */
    // todo: does this logic actually work? I think it does not! due to broken state handling
/*
    for (int i = size - 1; i >= index; i--) {
        for (int j = 0; j < PWM_PHASE_MAX_WAVE_PER_PWM; j++) {
            wave.waves[j].pinStates[i + 1] = wave.getChannelState(j, index);
        }
        wave.setSwitchTime(i + 1, wave.getSwitchTime(i));
    }
*/
    isRiseEvent[index] = TriggerValue::RISE == state;
 
    if ((unsigned)index != wave.phaseCount) {
        firmwareError(ObdCode::ERROR_TRIGGER_DRAMA, "are we ever here?");
    }
 
    wave.phaseCount++;
 
    for (int i = 0; i < PWM_PHASE_MAX_WAVE_PER_PWM; i++) {
        pin_state_t value = wave.getChannelState(/* channelIndex */i, index - 1);
        wave.setChannelState(i, index, value);
    }
    wave.setSwitchTime(index, angle);
    wave.setChannelState((int)channelIndex, index, state);
}

Referenced by addEvent360(), addEvent720(), addEventAngle(), addEventClamped(), and initialize60_2_2_Renault_F().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ addEvent360()

void TriggerWaveform::addEvent360	(	angle_t	angle,
		TriggerValue const	state,
		TriggerWheel const	channelIndex = `TriggerWheel::T_PRIMARY`
	)

this method helps us use real world 360 degrees shape for FOUR_STROKE_CAM_SENSOR and FOUR_STROKE_CRANK_SENSOR

Definition at line 250 of file trigger_structure.cpp.

                                                                                                          {
    efiAssertVoid(ObdCode::CUSTOM_OMODE_UNDEF, operationMode == FOUR_STROKE_CAM_SENSOR || operationMode == FOUR_STROKE_CRANK_SENSOR, "Not a mode for 360");
#define CRANK_MODE_MULTIPLIER 2.0f
    addEvent(CRANK_MODE_MULTIPLIER * angle / FOUR_STROKE_CYCLE_DURATION, state, channelIndex);
}

Referenced by addToothFallRise(), addToothRiseFall(), addvq30tooth(), configure60degSingleTooth(), configureBenelli(), configureGm60_2_2_2(), configureNeon1995TriggerWaveformOnlyCrank(), configureNeon2003TriggerWaveformCrank(), configureOnePlusOne(), gm_tooth_pair(), initializeMazdaLCam(), initializeMitsubishi4G69Cam(), initializeSuzukiK6A(), initializeVvt6G72(), initializeVvtN63TU(), and setSkodaFavorit().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ addEvent720()

void TriggerWaveform::addEvent720	(	angle_t	angle,
		TriggerValue const	state,
		TriggerWheel const	channelIndex = `TriggerWheel::T_PRIMARY`
	)

See header for documentation

Definition at line 246 of file trigger_structure.cpp.

                                                                                                          {
    addEvent(angle / FOUR_STROKE_CYCLE_DURATION, state, channelIndex);
}

Referenced by add4cylblock(), configure3_1_cam(), configureDodgeStratusTriggerWaveform(), configureFiatIAQ_P8(), configureFordAspireTriggerWaveform(), configureHondaCbr600(), configureMazdaProtegeLx(), configureNeon2003TriggerWaveformCam(), initDodgeRam(), initialize2jzGE3_34_simulation_shape(), initializeMazdaMiataNaShape(), initializeMazdaMiataNb1ShapeWithOffset(), initializeMazdaMiataVVtCamShape(), initializeNissanK11(), initializeNissanSR20VE_4(), initializeRoverK(), initializeSuzukiG13B(), initJeep18_2_2_2(), and initJeep_XJ_4cyl_2500().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ addEventAngle()

void TriggerWaveform::addEventAngle	(	angle_t	angle,
		TriggerValue const	state,
		TriggerWheel const	channelIndex = `TriggerWheel::T_PRIMARY`
	)

This version of the method is best when same wheel could be mounted either on crank or cam

This version of 'addEvent...' family considers the angle duration of operationMode in this trigger For example, (0..180] for FOUR_STROKE_SYMMETRICAL_CRANK_SENSOR

TODO: one day kill all usages with FOUR_STROKE_CAM_SENSOR 720 cycle and add runtime prohibition TODO: for FOUR_STROKE_CAM_SENSOR addEvent360 is the way to go

Parameters

angle (0..360] or (0..720] depending on configuration

Definition at line 266 of file trigger_structure.cpp.

                                                                                                            {
    addEvent(angle / getCycleDuration(), state, channelIndex);
}

Referenced by commonRenix(), commonSymmetrical(), configureChryslerNGC_36_2_2(), configureFordPip(), configureFordST170(), configureJeepEVD_36_2_2(), daihatsu(), initializeMazdaMiataNb2Crank(), initializeNissanQR25crank(), initializeSubaru7_6_crankOnly(), JeepRenix66_2_2(), and makeNissanPattern().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ addEventClamped()

void TriggerWaveform::addEventClamped	(	angle_t	angle,
		TriggerValue const	state,
		TriggerWheel const	channelIndex,
		float	filterLeft,
		float	filterRight
	)

Definition at line 189 of file trigger_structure.cpp.

                                                                                                                                                        {
    if (angle > filterLeft && angle < filterRight) {
#if EFI_UNIT_TEST
//      printf("addEventClamped %f %s\r\n", angle, getTrigger_value_e(stateParam));
#endif /* EFI_UNIT_TEST */
        addEvent(angle / getEngineCycle(operationMode), stateParam, channelIndex);
    }
}

Referenced by addSkippedToothTriggerEvents(), configureTriTach(), and setVwConfiguration().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ addToothFallRise()

void TriggerWaveform::addToothFallRise	(	angle_t	angle,
		angle_t	width = `10`,
		TriggerWheel const	channelIndex = `TriggerWheel::T_PRIMARY`
	)

Definition at line 261 of file trigger_structure.cpp.

                                                                                                    {
    addEvent360(angle - width, TriggerValue::FALL, channelIndex);
    addEvent360(angle, TriggerValue::RISE, channelIndex);
}

Referenced by initialize_one_of_24_2_2(), initialize_one_of_36_2_2(), and initialize_one_of_36_2_2_2().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ addToothRiseFall()

void TriggerWaveform::addToothRiseFall	(	angle_t	angle,
		angle_t	width = `10`,
		TriggerWheel const	channelIndex = `TriggerWheel::T_PRIMARY`
	)

Definition at line 256 of file trigger_structure.cpp.

                                                                                                    {
    addEvent360(angle - width, TriggerValue::RISE, channelIndex);
    addEvent360(angle, TriggerValue::FALL, channelIndex);
}

Referenced by addNBCrankTooth(), addTooth(), configureBarra3plus1cam(), configureChryslerVtt15(), configureFordCoyote(), configureGmTriggerWaveform(), configureHondaK_12_1(), configureHondaK_4_1(), configureKawaKX450F(), configureMazdaProtegeSOHC(), configureQuickStartSenderWheel(), initializeMazdaSkyactivCam(), initializeMitsubishi4g63Cam(), initializeNissanHRvvtIn(), initializeNissanVQvvt(), initializeSuzukiK6A(), initializeUzCam(), initializeVvt3A92(), and setMercedesTwoSegment().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ calculateExpectedEventCounts()

void TriggerWaveform::calculateExpectedEventCounts ( )

Definition at line 214 of file trigger_structure.cpp.

                                                   {
    if (!useOnlyRisingEdges) {
        for (size_t i = 0; i < efi::size(expectedEventCount); i++) {
            if (getExpectedEventCount((TriggerWheel)i) % 2 != 0) {
                firmwareError(ObdCode::ERROR_TRIGGER_DRAMA, "Trigger: should be even number of events index=%d count=%d", i, getExpectedEventCount((TriggerWheel)i));
            }
        }
    }
 
    bool isSingleToothOnPrimaryChannel = useOnlyRisingEdges ? getExpectedEventCount(TriggerWheel::T_PRIMARY) == 1 : getExpectedEventCount(TriggerWheel::T_PRIMARY) == 2;
    // todo: next step would be to set 'isSynchronizationNeeded' automatically based on the logic we have here
    if (!shapeWithoutTdc && isSingleToothOnPrimaryChannel != !isSynchronizationNeeded) {
        firmwareError(ObdCode::ERROR_TRIGGER_DRAMA, "shapeWithoutTdc isSynchronizationNeeded isSingleToothOnPrimaryChannel constraint violation");
    }
    if (isSingleToothOnPrimaryChannel) {
        useOnlyPrimaryForSync = true;
    } else {
        if (getExpectedEventCount(TriggerWheel::T_SECONDARY) == 0 && useOnlyPrimaryForSync) {
            firmwareError(ObdCode::ERROR_TRIGGER_DRAMA, "why would you set useOnlyPrimaryForSync with only one trigger wheel?");
        }
    }
 
// todo: move the following logic from below here
    //  if (!useOnlyRisingEdgeForTrigger || stateParam == TriggerValue::RISE) {
//      expectedEventCount[channelIndex]++;
//  }
 
}

Referenced by initializeTriggerWaveform().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ findAngleIndex()

uint16_t TriggerWaveform::findAngleIndex	(	TriggerFormDetails *	details,
		angle_t	angle
	)		const

Let's find the last trigger angle which is less or equal to the desired angle todo: extract binary search as template method?

Definition at line 390 of file trigger_structure.cpp.

                                                                                               {
    size_t engineCycleEventCount = getLength();
 
    efiAssert(ObdCode::CUSTOM_ERR_ASSERT, engineCycleEventCount != 0 && engineCycleEventCount <= 0xFFFF,
          "engineCycleEventCount", 0);
 
    uint32_t left = 0;
    uint32_t right = engineCycleEventCount - 1;
 
    /**
     * Let's find the last trigger angle which is less or equal to the desired angle
     * todo: extract binary search as template method?
     */
    do {
        uint32_t middle = (left + right) / 2;
 
        if (details->eventAngles[middle] <= targetAngle) {
            left = middle + 1;
        } else {
            right = middle - 1;
        }
    } while (left <= right);
    left -= 1;
    if (useOnlyRisingEdges) {
        left &= ~1U;
    }
    return left;
}

Referenced by InstantRpmCalculator::calculateInstantRpm().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getAngle()

angle_t TriggerWaveform::getAngle ( int phaseIndex ) const

This private method should only be used to prepare the array of pre-calculated values See eventAngles array

FOUR_STROKE_CRANK_SENSOR magic: We have two crank shaft revolutions for each engine cycle See also trigger_central.cpp See also getEngineCycleEventCount()

Definition at line 172 of file trigger_structure.cpp.

                                                 {
    /**
     * FOUR_STROKE_CRANK_SENSOR magic:
     * We have two crank shaft revolutions for each engine cycle
     * See also trigger_central.cpp
     * See also getEngineCycleEventCount()
     */
    efiAssert(ObdCode::CUSTOM_ERR_ASSERT, wave.phaseCount != 0, "shapeSize=0", NAN);
    int crankCycle = index / wave.phaseCount;
    int remainder = index % wave.phaseCount;
 
    auto cycleStartAngle = getCycleDuration() * crankCycle;
    auto positionWithinCycle = getSwitchAngle(remainder);
 
    return cycleStartAngle + positionWithinCycle;
}

Referenced by TriggerFormDetails::prepareEventAngles().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getCycleDuration()

angle_t TriggerWaveform::getCycleDuration ( ) const

physical primary trigger duration

See also: getEngineCycle; getCrankDivider

Definition at line 115 of file trigger_structure.cpp.

                                                {
    switch (operationMode) {
    case FOUR_STROKE_SYMMETRICAL_CRANK_SENSOR:
        return FOUR_STROKE_CYCLE_DURATION / SYMMETRICAL_CRANK_SENSOR_DIVIDER;
    case FOUR_STROKE_THREE_TIMES_CRANK_SENSOR:
        return FOUR_STROKE_CYCLE_DURATION / SYMMETRICAL_THREE_TIMES_CRANK_SENSOR_DIVIDER;
    case FOUR_STROKE_SIX_TIMES_CRANK_SENSOR:
        return FOUR_STROKE_CYCLE_DURATION / SYMMETRICAL_SIX_TIMES_CRANK_SENSOR_DIVIDER;
    case FOUR_STROKE_TWELVE_TIMES_CRANK_SENSOR:
        return FOUR_STROKE_CYCLE_DURATION / SYMMETRICAL_TWELVE_TIMES_CRANK_SENSOR_DIVIDER;
    case FOUR_STROKE_CRANK_SENSOR:
    case TWO_STROKE:
        return TWO_STROKE_CYCLE_DURATION;
    case OM_NONE:
  case FOUR_STROKE_CAM_SENSOR:
        return FOUR_STROKE_CYCLE_DURATION;
    }
    criticalError("unreachable getCycleDuration");
    return 0;
}

Referenced by addEvent(), addEventAngle(), commonRenix(), configureChryslerNGC_36_2_2(), configureFordPip(), configureFordST170(), daihatsu(), getAngle(), getLength(), getSwitchAngle(), initializeTriggerWaveform(), and JeepRenix66_2_2().

Here is the caller graph for this function:

◆ getExpectedEventCount()

size_t TriggerWaveform::getExpectedEventCount ( TriggerWheel channelIndex ) const

Definition at line 210 of file trigger_structure.cpp.

                                                                             {
    return expectedEventCount[(int)channelIndex];
}

Referenced by calculateExpectedEventCounts(), TriggerDecoderBase::getEventCountersError(), and Engine::OnTriggerSynchronization().

Here is the caller graph for this function:

◆ getLength()

size_t TriggerWaveform::getLength ( ) const

this one is per CRANKshaft revolution

Trigger event count equals engine cycle event count if we have a cam sensor. Two trigger cycles make one engine cycle in case of a four stroke engine If we only have a cranksensor.

'engine->engineCycleEventCount' hold a pre-calculated copy of this value as a performance optimization

24 for FOUR_STROKE_TWELVE_TIMES_CRANK_SENSOR 6 for FOUR_STROKE_THREE_TIMES_CRANK_SENSOR 4 for FOUR_STROKE_SYMMETRICAL_CRANK_SENSOR 2 for FOUR_STROKE_CRANK_SENSOR 1 otherwise

Definition at line 160 of file trigger_structure.cpp.

                                        {
    /**
     * 24 for FOUR_STROKE_TWELVE_TIMES_CRANK_SENSOR
     * 6 for FOUR_STROKE_THREE_TIMES_CRANK_SENSOR
     * 4 for FOUR_STROKE_SYMMETRICAL_CRANK_SENSOR
     * 2 for FOUR_STROKE_CRANK_SENSOR
     * 1 otherwise
     */
    int multiplier = getEngineCycle(operationMode) / getCycleDuration();
    return multiplier * getSize();
}

Referenced by TriggerCentral::applyShapesConfiguration(), TriggerDecoderBase::decodeTriggerEvent(), findAngleIndex(), InstantRpmCalculator::movePreSynchTimestamps(), and TriggerFormDetails::prepareEventAngles().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getSize()

size_t TriggerWaveform::getSize ( ) const

Definition at line 102 of file trigger_structure.cpp.

                                      {
    return wave.phaseCount;
}

Referenced by TriggerStimulatorHelper::assertSyncPosition(), calculateTriggerSynchPoint(), TriggerDecoderBase::decodeTriggerEvent(), TriggerCentral::engineMovedRecently(), TriggerStimulatorHelper::feedSimulatedEvent(), TriggerDecoderBase::findTriggerZeroEventIndex(), getLength(), getSimulatedEventTime(), TriggerCentral::handleShaftSignal(), TriggerDecoderBase::isValidIndex(), HpfpController::onFastCallback(), TriggerDecoderBase::onShaftSynchronization(), TriggerFormDetails::prepareEventAngles(), startSimulatedTriggerSignal(), startTriggerInputPins(), and triggerShapeInfo().

Here is the caller graph for this function:

◆ getSwitchAngle()

angle_t TriggerWaveform::getSwitchAngle ( int index ) const

These angles are in trigger DESCRIPTION coordinates - i.e. the way you add events while declaring trigger shape

Definition at line 363 of file trigger_structure.cpp.

                                                       {
    return getCycleDuration() * wave.getSwitchTime(index);
}

Referenced by getAngle().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getTriggerWaveformSynchPointIndex()

int TriggerWaveform::getTriggerWaveformSynchPointIndex ( ) const

Definition at line 106 of file trigger_structure.cpp.

                                                             {
    return triggerShapeSynchPointIndex;
}

◆ getWheel()

TriggerWheel TriggerWaveform::getWheel ( size_t index )

Definition at line 419 of file trigger_structure.cpp.

                                                   {
#if EFI_UNIT_TEST
    return triggerSignalIndeces[index];
#endif
    return TriggerWheel::T_PRIMARY;
}

Referenced by TriggerFormDetails::prepareEventAngles().

Here is the caller graph for this function:

◆ getWheelOperationMode()

operation_mode_e TriggerWaveform::getWheelOperationMode ( ) const

See also Engine::getOperationMode which accounts for additional settings which are needed to resolve precise mode for vague wheels

Definition at line 202 of file trigger_structure.cpp.

                                                              {
    return operationMode;
}

Referenced by RpmCalculator::getOperationMode(), TriggerCentral::handleShaftSignal(), and needsDisambiguation().

Here is the caller graph for this function:

◆ initialize()

void TriggerWaveform::initialize	(	operation_mode_e	operationMode,
		SyncEdge	syncEdge
	)

Definition at line 65 of file trigger_structure.cpp.

                                                                                      {
    operationMode = p_operationMode;
    syncEdge = p_syncEdge;
 
    isSynchronizationNeeded = true; // that's default value
    isSecondWheelCam = false;
    needSecondTriggerInput = false;
    shapeWithoutTdc = false;
 
    // If RiseOnly, ignore falling edges completely.
    useOnlyRisingEdges = syncEdge == SyncEdge::RiseOnly;
 
    setTriggerSynchronizationGap(2);
    for (int gapIndex = 1; gapIndex < GAP_TRACKING_LENGTH ; gapIndex++) {
        // NaN means do not use this gap ratio
        setTriggerSynchronizationGap3(gapIndex, NAN, 100000);
    }
    gapTrackingLength = 1;
 
    tdcPosition = 0;
    shapeDefinitionError = false;
    useOnlyPrimaryForSync = false;
 
    triggerShapeSynchPointIndex = 0;
    setArrayValues(expectedEventCount, 0);
    wave.reset();
    wave.waveCount = TRIGGER_INPUT_PIN_COUNT;
    wave.phaseCount = 0;
    previousAngle = 0;
    setArrayValues(isRiseEvent, 0);
#if EFI_UNIT_TEST
    memset(triggerSignalIndeces, 0, sizeof(triggerSignalIndeces));
    memset(&triggerSignalStates, 0, sizeof(triggerSignalStates));
    knownOperationMode = true;
#endif // EFI_UNIT_TEST
}

Here is the call graph for this function:

◆ initializeSyncPoint()

void TriggerWaveform::initializeSyncPoint	(	TriggerDecoderBase &	state,
		const TriggerConfiguration &	triggerConfiguration
	)

Definition at line 112 of file trigger_decoder.cpp.

                                                              {
    triggerShapeSynchPointIndex = state.findTriggerZeroEventIndex(*this, triggerConfiguration);
}

Referenced by calculateTriggerSynchPoint(), and initVvtShape().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ initializeTriggerWaveform()

void TriggerWaveform::initializeTriggerWaveform	(	operation_mode_e	triggerOperationMode,
		const trigger_config_s &	triggerType,
		bool	isCrankWheel = `true`
	)

External logger is needed because at this point our logger is not yet initialized

Note: TT_HALF_MOON setup events as 180 and 360 degrees. It uses SyncEdge::Rise for additional phase align on falling edge and will not work with non- symmetrical blind type where open and closed sections are not equal

different from TT_HALF_MOON

Note: Have a something like TT_ONE_PHASED trigger with externally setuped blind width will be a good approach to utilize Rise(and::Both in future) with both edges phase-sync, but to stay simple I suggest just to use another enum for each trigger type.

Feb 2019 suggestion: it would be an improvement to remove 'expectedEventCount' logic from 'addEvent' and move it here, after all events were added.

Definition at line 458 of file trigger_structure.cpp.

                                                                                                                                             {
 
#if EFI_PROD_CODE
    efiAssertVoid(ObdCode::CUSTOM_ERR_6641, hasLotsOfRemainingStack(), "init t");
    efiPrintf("initializeTriggerWaveform(%s/%d)", getTrigger_type_e(triggerType.type), (int)triggerType.type);
#endif
 
    shapeDefinitionError = false;
 
    switch (triggerType.type) {
    case trigger_type_e::TT_TOOTHED_WHEEL:
        initializeSkippedToothTrigger(this, triggerType.customTotalToothCount,
                triggerType.customSkippedToothCount, triggerOperationMode, SyncEdge::RiseOnly);
        break;
 
    case trigger_type_e::TT_MAZDA_MIATA_NA:
        initializeMazdaMiataNaShape(this);
        break;
 
    case trigger_type_e::TT_MAZDA_MIATA_VVT_TEST:
        initializeMazdaMiataVVtTestShape(this);
        break;
 
    case trigger_type_e::TT_SUZUKI_K6A:
        initializeSuzukiK6A(this);
        break;
 
    case trigger_type_e::TT_SUZUKI_G13B:
        initializeSuzukiG13B(this);
        break;
 
    case trigger_type_e::TT_FORD_TFI_PIP:
        configureFordPip(this);
        break;
 
    case trigger_type_e::TT_FORD_ST170:
        configureFordST170(this);
        break;
 
    case trigger_type_e::TT_VVT_MIATA_NB:
        initializeMazdaMiataVVtCamShape(this);
        break;
 
    case trigger_type_e::TT_RENIX_66_2_2_2:
        initializeRenix66_2_2(this);
        break;
 
    case trigger_type_e::TT_RENIX_44_2_2:
        initializeRenix44_2_2(this);
        break;
 
    case trigger_type_e::TT_MIATA_VVT:
        initializeMazdaMiataNb2Crank(this);
        break;
 
    case trigger_type_e::TT_DODGE_NEON_1995:
    case trigger_type_e::TT_DODGE_NEON_1995_ONLY_CRANK:
        configureNeon1995TriggerWaveformOnlyCrank(this);
        break;
 
    case trigger_type_e::TT_DODGE_STRATUS:
        configureDodgeStratusTriggerWaveform(this);
        break;
 
    case trigger_type_e::TT_DODGE_NEON_2003_CAM:
        configureNeon2003TriggerWaveformCam(this);
        break;
 
    case trigger_type_e::TT_DODGE_NEON_2003_CRANK:
        configureNeon2003TriggerWaveformCam(this);
//      configureNeon2003TriggerWaveformCrank(triggerShape);
        break;
 
    case trigger_type_e::TT_FORD_ASPIRE:
        configureFordAspireTriggerWaveform(this);
        break;
 
    case trigger_type_e::TT_VVT_NISSAN_VQ35:
        initializeNissanVQvvt(this);
        break;
 
    case trigger_type_e::TT_VVT_MITSU_6G72:
        initializeVvt6G72(this);
        break;
 
    case trigger_type_e::TT_VVT_MITSUBISHI_3A92:
        initializeVvt3A92(this);
        break;
 
    case trigger_type_e::TT_TOYOTA_3_TOOTH_UZ:
      initializeUzCam(this);
    break;
 
    case trigger_type_e::TT_VVT_TOYOTA_4_1:
        initializeSkippedToothTrigger(this, 4, 1, triggerOperationMode, SyncEdge::RiseOnly);
        setTriggerSynchronizationGap3(/*gapIndex*/0, /*from*/1.60, 2.40);
        setTriggerSynchronizationGap3(/*gapIndex*/1, /*from*/0.75, 1.25);
        break;
 
    case trigger_type_e::TT_NISSAN_QR25:
        initializeNissanQR25crank(this);
        break;
 
    case trigger_type_e::TT_NISSAN_VQ30:
        initializeNissanVQ30cam(this);
        break;
 
    case trigger_type_e::TT_NISSAN_VQ35:
        initializeNissanVQ35crank(this);
        break;
 
    case trigger_type_e::TT_NISSAN_MR18_CRANK:
        initializeNissanMR18crank(this);
        break;
 
    case trigger_type_e::TT_NISSAN_MR18_CAM_VVT:
        initializeNissanMRvvt(this);
        break;
 
    case trigger_type_e::TT_KAWA_KX450F:
        configureKawaKX450F(this);
        break;
 
    case trigger_type_e::TT_SKODA_FAVORIT:
        setSkodaFavorit(this);
        break;
 
    case trigger_type_e::TT_GM_60_2_2_2:
        configureGm60_2_2_2(this);
        break;
 
    case trigger_type_e::TT_GM_7X:
        configureGmTriggerWaveform(this);
        break;
 
    case trigger_type_e::TT_MAZDA_DOHC_1_4:
        configureMazdaProtegeLx(this);
        break;
 
    case trigger_type_e::TT_ONE_PLUS_ONE:
        configureOnePlusOne(this);
        break;
 
    case trigger_type_e::TT_3_1_CAM:
        configure3_1_cam(this);
        break;
 
    case trigger_type_e::TT_MERCEDES_2_SEGMENT:
        setMercedesTwoSegment(this);
        break;
 
    case trigger_type_e::TT_HALF_MOON:
        /** @note TT_HALF_MOON setup events as 180 and 360 degrees. It uses SyncEdge::Rise
         *  for additional phase align on falling edge and will not work with non-
         *  symmetrical blind type where open and closed sections are not equal */
        initializeSkippedToothTrigger(this, 1, 0, triggerOperationMode, SyncEdge::Rise);
        break;
 
    case trigger_type_e::TT_NARROW_SINGLE_TOOTH:
        /** different from TT_HALF_MOON */
        initializeSkippedToothTrigger(this, 1, 0, triggerOperationMode, SyncEdge::RiseOnly);
        break;
 
    case trigger_type_e::TT_MAZDA_SOHC_4:
        configureMazdaProtegeSOHC(this);
        break;
 
    case trigger_type_e::TT_DAIHATSU_3_CYL:
        configureDaihatsu3cyl(this);
        break;
 
    case trigger_type_e::TT_DAIHATSU_4_CYL:
        configureDaihatsu4cyl(this);
        break;
 
    case trigger_type_e::TT_VVT_TOYOTA_3_TOOTH:
        initializeSkippedToothTrigger(this, 3, 0, triggerOperationMode, SyncEdge::RiseOnly);
        break;
 
    case trigger_type_e::TT_36_2_1_1:
        initialize36_2_1_1(this);
        break;
 
    case trigger_type_e::TT_36_2_1:
        initialize36_2_1(this);
        break;
 
    case trigger_type_e::TT_TOOTHED_WHEEL_32_2:
        initializeSkippedToothTrigger(this, 32, 2, triggerOperationMode, SyncEdge::RiseOnly);
        // todo: why is this 32/2 asking for third gap while 60/2 is happy with just two gaps?
        // method above sets second gap, here we add third
        // this third gap is not required to sync on perfect signal but is needed to handle to reject cranking transition noise
        setThirdTriggerSynchronizationGap(1);
        break;
 
    case trigger_type_e::TT_TOOTHED_WHEEL_60_2:
        initializeSkippedToothTrigger(this, 60, 2, triggerOperationMode, SyncEdge::RiseOnly);
        break;
 
    case trigger_type_e::TT_TOOTHED_WHEEL_36_2:
        initializeSkippedToothTrigger(this, 36, 2, triggerOperationMode, SyncEdge::RiseOnly);
        setTriggerSynchronizationGap3(/*gapIndex*/0, /*from*/1.6, 3.5);
        setTriggerSynchronizationGap3(/*gapIndex*/1, /*from*/0.7, 1.3); // second gap is not required to synch on perfect signal but is needed to handle to reject cranking transition noise
        break;
 
    case trigger_type_e::TT_60_2_WRONG_POLARITY:
        setVwConfiguration(this);
        break;
 
    case trigger_type_e::TT_TOOTHED_WHEEL_36_1:
        initializeSkippedToothTrigger(this, 36, 1, triggerOperationMode, SyncEdge::RiseOnly);
        break;
 
    case trigger_type_e::TT_VVT_BOSCH_QUICK_START:
        configureQuickStartSenderWheel(this);
        break;
 
    case trigger_type_e::TT_VVT_BARRA_3_PLUS_1:
        configureBarra3plus1cam(this);
        break;
 
    case trigger_type_e::TT_HONDA_K_CAM_4_1:
        configureHondaK_4_1(this);
        break;
 
    case trigger_type_e::TT_HONDA_K_CRANK_12_1:
        configureHondaK_12_1(this);
        break;
 
    case trigger_type_e::TT_HONDA_J30A2_24_1_1:
    configureHondaJ30A2_24_1_1(this);
    break;
 
    case trigger_type_e::TT_SUBARU_EZ30:
        initializeSubaruEZ30(this);
        break;
 
    case trigger_type_e::TT_VVT_MAZDA_SKYACTIV:
        initializeMazdaSkyactivCam(this);
        break;
 
    case trigger_type_e::TT_VVT_MAZDA_L:
        initializeMazdaLCam(this);
        break;
 
    case trigger_type_e::TT_BENELLI_TRE:
        configureBenelli(this);
        break;
 
    case trigger_type_e::TT_MITSU_4G63_CRANK:
        initializeMitsubishi4gSymmetricalCrank(this);
        break;
    case trigger_type_e::TT_DEV:
    case trigger_type_e::TT_VVT_FORD_COYOTE:
        configureFordCoyote(this);
        break;
    case trigger_type_e::TT_60DEG_TOOTH:
        /** @note
         * Have a something like TT_ONE_PHASED trigger with
         * externally setuped blind width will be a good
         * approach to utilize ::Rise(and::Both in future)
         * with both edges phase-sync, but to stay simple I suggest
         * just to use another enum for each trigger type. */
        configure60degSingleTooth(this);
        break;
    case trigger_type_e::TT_60_2_2_F3R:
        initialize60_2_2_Renault_F(this);
        break;
    case trigger_type_e::TT_VVT_MITSUBISHI_4G69:
        initializeMitsubishi4G69Cam(this);
        break;
    case trigger_type_e::TT_MITSU_4G63_CAM:
        initializeMitsubishi4g63Cam(this);
        break;
 
    case trigger_type_e::TT_NISSAN_K11:
      initializeNissanK11(this);
    break;
    case trigger_type_e::TT_HONDA_CBR_600:
        configureHondaCbr600(this);
        break;
 
    case trigger_type_e::TT_CHRYSLER_PHASER:
      configureChryslerVtt15(this);
    break;
    case trigger_type_e::TT_CHRYSLER_NGC_36_2_2:
        configureChryslerNGC_36_2_2(this);
        break;
 
    case trigger_type_e::TT_JEEP_EVD_36_2_2:
        configureJeepEVD_36_2_2(this);
        break;
 
    case trigger_type_e::TT_DODGE_RAM:
        initDodgeRam(this);
        break;
 
    case trigger_type_e::TT_JEEP_4_CYL:
        initJeep_XJ_4cyl_2500(this);
        break;
 
    case trigger_type_e::TT_JEEP_18_2_2_2:
        initJeep18_2_2_2(this);
        break;
 
    case trigger_type_e::TT_SUBARU_7_6:
        initializeSubaru7_6(this);
        break;
 
    case trigger_type_e::TT_36_2_2_2:
        initialize36_2_2_2(this);
        break;
 
    case trigger_type_e::TT_2JZ_3_34_SIMULATION_ONLY:
        initialize2jzGE3_34_simulation_shape(this);
        break;
 
    case trigger_type_e::TT_3_TOOTH_CRANK:
        configure3ToothCrank(this);
        break;
 
    case trigger_type_e::TT_6_TOOTH_CRANK:
        configure6ToothCrank(this);
        break;
 
    case trigger_type_e::TT_12_TOOTH_CRANK:
        configure12ToothCrank(this);
        break;
 
    case trigger_type_e::TT_ARCTIC_CAT:
      configureArcticCat(this);
      break;
 
  case trigger_type_e::TT_NISSAN_HR_CAM_IN:
    initializeNissanHRvvtIn(this);
    break;
    case trigger_type_e::TT_NISSAN_HR:
      initializeNissanHRcrank(this);
    break;
    case trigger_type_e::TT_NISSAN_SR20VE:
        initializeNissanSR20VE_4(this);
        break;
 
    case trigger_type_e::TT_ROVER_K:
        initializeRoverK(this);
        break;
 
    case trigger_type_e::TT_FIAT_IAW_P8:
        configureFiatIAQ_P8(this);
        break;
 
    case trigger_type_e::TT_TRI_TACH:
        configureTriTach(this);
        break;
 
    case trigger_type_e::TT_GM_24x_5:
        initGmLS24_5deg(this);
        break;
 
    case trigger_type_e::TT_GM_24x_3:
        initGmLS24_3deg(this);
        break;
 
    case trigger_type_e::TT_VVT_SUBARU_7_WITHOUT_6:
        initializeSubaruOnly7(this);
        break;
 
    case trigger_type_e::TT_SUBARU_SVX:
        initializeSubaru_SVX(this);
        break;
 
    case trigger_type_e::TT_SUBARU_SVX_CRANK_1:
        initializeSubaru_SVX(this);
        break;
 
    case trigger_type_e::TT_SUBARU_SVX_CAM_VVT:
        initializeSubaru_SVX(this);
        break;
 
    case trigger_type_e::TT_JEEPRENIX_66_2_2_2:
        initializeJeepRenix66_2_2(this);
        break;
 
    case trigger_type_e::TT_UNUSED_95:
    case trigger_type_e::TT_UNUSED_96:
    case trigger_type_e::TT_SUBARU_7_6_CRANK:
        initializeSubaru7_6_crankOnly(this);
        break;
 
 
    default:
      customTrigger(triggerOperationMode, this, triggerType.type);
    }
 
    if (isCrankWheel && !needSecondTriggerInput &&
#if EFI_UNIT_TEST
    engineConfiguration != nullptr &&
#endif
    engineConfiguration->triggerInputPins[1] != Gpio::Unassigned) {
// todo: technical debt: HW CI should not require special treatment
#ifndef HARDWARE_CI
      criticalError("Single-channel trigger %s selected while two inputs were configured", getTrigger_type_e(triggerType.type));
#endif
    }
 
    /**
     * Feb 2019 suggestion: it would be an improvement to remove 'expectedEventCount' logic from 'addEvent'
     * and move it here, after all events were added.
     */
    calculateExpectedEventCounts();
    version++;
 
    if (!shapeDefinitionError) {
        wave.checkSwitchTimes(getCycleDuration());
    }
}

Referenced by TriggerCentral::applyShapesConfiguration(), and initVvtShape().

Here is the caller graph for this function:

◆ needsDisambiguation()

bool TriggerWaveform::needsDisambiguation ( ) const

Definition at line 136 of file trigger_structure.cpp.

                                                {
    switch (getWheelOperationMode()) {
        case FOUR_STROKE_CRANK_SENSOR:
        case FOUR_STROKE_SYMMETRICAL_CRANK_SENSOR:
        case FOUR_STROKE_THREE_TIMES_CRANK_SENSOR:
        case FOUR_STROKE_SIX_TIMES_CRANK_SENSOR:
        case FOUR_STROKE_TWELVE_TIMES_CRANK_SENSOR:
            return true;
        case FOUR_STROKE_CAM_SENSOR:
        case TWO_STROKE:
        case OM_NONE:
            return false;
    /* let's NOT handle default in order to benefit from -Werror=switch */
    }
    criticalError("unreachable needsDisambiguation");
    return true;
}

Referenced by TriggerCentral::applyShapesConfiguration().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setSecondTriggerSynchronizationGap()

void TriggerWaveform::setSecondTriggerSynchronizationGap ( float syncRatio )

Definition at line 434 of file trigger_structure.cpp.

                                                                        {
    setTriggerSynchronizationGap4(/*gapIndex*/1, syncRatio);
}

Referenced by configureFordCoyote(), configureFordPip(), configureQuickStartSenderWheel(), initGmLS24_3deg(), initGmLS24_5deg(), initialize36_2_1(), initialize36_2_1_1(), initialize60_2_2_Renault_F(), initializeMazdaSkyactivCam(), initializeMitsubishi4G69Cam(), initializeNissanQR25crank(), initializeSkippedToothTrigger(), initializeSuzukiG13B(), initializeSuzukiK6A(), initializeVvt3A92(), setMercedesTwoSegment(), and setVwConfiguration().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setSecondTriggerSynchronizationGap2()

void TriggerWaveform::setSecondTriggerSynchronizationGap2	(	float	syncRatioFrom,
		float	syncRatioTo
	)

Definition at line 438 of file trigger_structure.cpp.

                                                                                                {
    setTriggerSynchronizationGap3(/*gapIndex*/1, syncRatioFrom, syncRatioTo);
}

Referenced by configureHondaK_12_1(), initializeMazdaMiataNaShape(), initializeMazdaMiataNb2Crank(), initializeMazdaMiataVVtCamShape(), initializeMitsubishi4g63Cam(), initializeNissanMRvvt(), initializeNissanVQvvt(), and initializeRoverK().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setShapeDefinitionError()

void TriggerWaveform::setShapeDefinitionError ( bool value )

Definition at line 426 of file trigger_structure.cpp.

                                                        {
    shapeDefinitionError = value;
}

Referenced by addEvent(), TriggerStimulatorHelper::assertSyncPosition(), calculateTriggerSynchPoint(), customTrigger(), TriggerStimulatorHelper::findTriggerSyncPoint(), and initializeSkippedToothTrigger().

Here is the caller graph for this function:

◆ setThirdTriggerSynchronizationGap()

void TriggerWaveform::setThirdTriggerSynchronizationGap ( float syncRatio )

Definition at line 442 of file trigger_structure.cpp.

                                                                       {
    setTriggerSynchronizationGap4(/*gapIndex*/2, syncRatio);
}

Referenced by initGmLS24_3deg(), initGmLS24_5deg(), initialize60_2_2_Renault_F(), initializeMazdaSkyactivCam(), initializeRoverK(), initializeTriggerWaveform(), setMercedesTwoSegment(), and setVwConfiguration().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setTriggerSynchronizationGap()

void TriggerWaveform::setTriggerSynchronizationGap ( float syncRatio )

Definition at line 430 of file trigger_structure.cpp.

                                                                  {
    setTriggerSynchronizationGap4(/*gapIndex*/0, syncRatio);
}

Referenced by configureArcticCat(), configureChryslerNGC_36_2_2(), configureDaihatsu3cyl(), configureDaihatsu4cyl(), configureFiatIAQ_P8(), configureFordCoyote(), configureFordPip(), configureGmTriggerWaveform(), configureKawaKX450F(), configureNeon2003TriggerWaveformCrank(), configureQuickStartSenderWheel(), initGmLS24_3deg(), initGmLS24_5deg(), initialize(), initialize36_2_1(), initialize36_2_1_1(), initialize60_2_2_Renault_F(), initializeMazdaSkyactivCam(), initializeMitsubishi4G69Cam(), initializeNissanMR18crank(), initializeNissanQR25crank(), initializeRoverK(), initializeSkippedToothTrigger(), initializeSuzukiG13B(), initializeSuzukiK6A(), initializeVvt3A92(), and setMercedesTwoSegment().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setTriggerSynchronizationGap2()

void TriggerWaveform::setTriggerSynchronizationGap2	(	float	syncRatioFrom,
		float	syncRatioTo
	)

Definition at line 367 of file trigger_structure.cpp.

                                                                                          {
    setTriggerSynchronizationGap3(/*gapIndex*/0, syncRatioFrom, syncRatioTo);
}

Referenced by configureDodgeStratusTriggerWaveform(), configureHondaCbr600(), configureHondaK_12_1(), configureNeon2003TriggerWaveformCam(), initializeMazdaMiataNaShape(), initializeMazdaMiataNb2Crank(), initializeMazdaMiataVVtCamShape(), initializeMitsubishi4g63Cam(), initializeNissanMRvvt(), initializeNissanSR20VE_4(), initializeNissanVQvvt(), initializeSubaru7_6_crankOnly(), initializeVvtN63TU(), and setVwConfiguration().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setTriggerSynchronizationGap3()

void TriggerWaveform::setTriggerSynchronizationGap3	(	int	index,
		float	syncRatioFrom,
		float	syncRatioTo
	)

note that index is in reverse order comparing with chronological order on the documentation images https://wiki.rusefi.com/All-Supported-Triggers

Definition at line 371 of file trigger_structure.cpp.

                                                                                                        {
    isSynchronizationNeeded = true;
    criticalAssertVoid(gapIndex >= 0 && gapIndex < GAP_TRACKING_LENGTH, "gapIndex out of range");
    synchronizationRatioFrom[gapIndex] = syncRatioFrom;
    synchronizationRatioTo[gapIndex] = syncRatioTo;
    if (gapIndex == 0) {
        // we have a special case here - only sync with one gap has this feature
        this->syncRatioAvg = (int)efiRound((syncRatioFrom + syncRatioTo) * 0.5f, 1.0f);
    }
    gapTrackingLength = maxI(1 + gapIndex, gapTrackingLength);
 
#if EFI_UNIT_TEST
    if (printTriggerDebug) {
        printf("setTriggerSynchronizationGap3 %d %.2f %.2f\r\n", gapIndex, syncRatioFrom, syncRatioTo);
    }
#endif /* EFI_UNIT_TEST */
 
}

Referenced by TriggerCentral::applyTriggerGapOverride(), commonSymmetrical(), configureArcticCat(), configureBarra3plus1cam(), configureHondaJ30A2_24_1_1(), configureHondaK_4_1(), configureJeepEVD_36_2_2(), configureNeon1995TriggerWaveformOnlyCrank(), configureNeon2003TriggerWaveformCam(), initialize(), initialize36_2_2_2(), initializeJeepRenix66_2_2(), initializeMazdaLCam(), initializeMazdaMiataNb1ShapeWithOffset(), initializeNissanHRcrank(), initializeNissanHRvvtIn(), initializeNissanK11(), initializeNissanVQ35crank(), initializeSubaru7_6(), initializeSubaru7_6_camOnly(), initializeSubaruEZ30(), initializeTriggerWaveform(), initializeVvt6G72(), setSecondTriggerSynchronizationGap2(), setSkodaFavorit(), setTriggerSynchronizationGap2(), and setTriggerSynchronizationGap4().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setTriggerSynchronizationGap4()

void TriggerWaveform::setTriggerSynchronizationGap4	(	int	index,
		float	syncRatio
	)

inline

Definition at line 201 of file trigger_structure.h.

                                                                   {
      setTriggerSynchronizationGap3(index, syncRatio * TRIGGER_GAP_DEVIATION_LOW, syncRatio * TRIGGER_GAP_DEVIATION_HIGH);
    }

Referenced by configureChryslerNGC_36_2_2(), configureChryslerVtt15(), initializeNissanVQ30cam(), initializeUzCam(), setSecondTriggerSynchronizationGap(), setThirdTriggerSynchronizationGap(), and setTriggerSynchronizationGap().

Here is the call graph for this function:

Here is the caller graph for this function:

Field Documentation

◆ expectedEventCount

size_t TriggerWaveform::expectedEventCount[PWM_PHASE_MAX_WAVE_PER_PWM]

This is used for signal validation

Definition at line 133 of file trigger_structure.h.

Referenced by addEvent(), calculateExpectedEventCounts(), getExpectedEventCount(), and initialize().

◆ gapTrackingLength

int TriggerWaveform::gapTrackingLength = 1

number of consecutive trigger gaps needed to synchronize

Definition at line 66 of file trigger_structure.h.

Referenced by TriggerCentral::applyCamGapOverride(), TriggerCentral::applyTriggerGapOverride(), TriggerDecoderBase::decodeTriggerEvent(), initialize(), TriggerDecoderBase::isSyncPoint(), TriggerDecoderBase::printGaps(), and setTriggerSynchronizationGap3().

◆ isRiseEvent

bool TriggerWaveform::isRiseEvent[PWM_PHASE_MAX_COUNT]

Definition at line 155 of file trigger_structure.h.

Referenced by addEvent(), initialize(), and TriggerFormDetails::prepareEventAngles().

◆ isSecondWheelCam

bool TriggerWaveform::isSecondWheelCam

trigger meta information: is second wheel mounted on crank shaft ('false') or cam shaft ('true')

Definition at line 62 of file trigger_structure.h.

Referenced by configureFordAspireTriggerWaveform(), configureGm60_2_2_2(), configureMazdaProtegeLx(), configureOnePlusOne(), initialize(), and initializeMazdaMiataNaShape().

◆ isSynchronizationNeeded

bool TriggerWaveform::isSynchronizationNeeded

Simplest trigger shape does not require any synchronization - for example if there is only one primary channel tooth each raising (or falling depending on configuration) front would synchronize

Definition at line 57 of file trigger_structure.h.

Referenced by calculateExpectedEventCounts(), configure3_1_cam(), configure60degSingleTooth(), configureFordAspireTriggerWaveform(), configureGm60_2_2_2(), configureMazdaProtegeLx(), configureMazdaProtegeSOHC(), configureOnePlusOne(), configureTriTach(), TriggerDecoderBase::decodeTriggerEvent(), initDodgeRam(), initialize(), initialize2jzGE3_34_simulation_shape(), initializeSkippedToothTrigger(), initializeSubaru_SVX(), initJeep18_2_2_2(), initJeep_XJ_4cyl_2500(), setTriggerSynchronizationGap3(), and triggerInfo().

◆ knownOperationMode

bool TriggerWaveform::knownOperationMode = true

Definition at line 143 of file trigger_structure.h.

Referenced by initialize(), initialize36_2_2_2(), initializeMitsubishi4gSymmetricalCrank(), and initializeSkippedToothTrigger().

◆ needSecondTriggerInput

bool TriggerWaveform::needSecondTriggerInput = false

this flag tells us if we should ignore events on second input channel that's the way to ignore noise from the disconnected wire

Definition at line 76 of file trigger_structure.h.

Referenced by addEvent(), initialize(), initializeTriggerWaveform(), and triggerInfo().

◆ operationMode

operation_mode_e TriggerWaveform::operationMode

private

this is part of performance optimization

Definition at line 256 of file trigger_structure.h.

Referenced by addEvent(), addEvent360(), addEventClamped(), getCycleDuration(), getLength(), getWheelOperationMode(), and initialize().

◆ previousAngle

angle_t TriggerWaveform::previousAngle

private

This variable is used to confirm that events are added in the right order. todo: this variable is probably not needed, could be reimplemented by accessing by index

Definition at line 252 of file trigger_structure.h.

Referenced by addEvent(), and initialize().

◆ shapeDefinitionError

bool TriggerWaveform::shapeDefinitionError = false

true value here means that we do not have a valid trigger configuration

Definition at line 80 of file trigger_structure.h.

Referenced by TriggerCentral::applyShapesConfiguration(), TriggerStimulatorHelper::assertSyncPosition(), TriggerDecoderBase::findTriggerZeroEventIndex(), TriggerCentral::handleShaftSignal(), initialize(), initializeTriggerWaveform(), TriggerCentral::prepareTriggerShape(), setShapeDefinitionError(), and Engine::updateTriggerConfiguration().

◆ shapeWithoutTdc

bool TriggerWaveform::shapeWithoutTdc = false

special case for triggers which do not provide exact TDC location For example pick-up in distributor with mechanical ignition firing order control.

Definition at line 71 of file trigger_structure.h.

Referenced by calculateExpectedEventCounts(), commonSymmetrical(), configureMazdaProtegeSOHC(), initialize(), initialize2jzGE3_34_simulation_shape(), initializeSkippedToothTrigger(), and initializeVvtN63TU().

◆ syncEdge

SyncEdge TriggerWaveform::syncEdge

Definition at line 121 of file trigger_structure.h.

Referenced by initialize(), and shouldConsiderEdge().

◆ synchronizationRatioFrom

float TriggerWaveform::synchronizationRatioFrom[GAP_TRACKING_LENGTH]

Depending on trigger shape, we use between one and three previous gap ranges to detect synchronization.

Usually second or third gap is not needed, but some crazy triggers like 36-2-2-2 require two consecutive gaps ratios to sync

Definition at line 94 of file trigger_structure.h.

Referenced by TriggerCentral::applyCamGapOverride(), TriggerCentral::applyTriggerGapOverride(), TriggerDecoderBase::decodeTriggerEvent(), TriggerDecoderBase::isSyncPoint(), TriggerDecoderBase::printGaps(), and setTriggerSynchronizationGap3().

◆ synchronizationRatioTo

float TriggerWaveform::synchronizationRatioTo[GAP_TRACKING_LENGTH]

Definition at line 95 of file trigger_structure.h.

Referenced by TriggerCentral::applyCamGapOverride(), TriggerCentral::applyTriggerGapOverride(), TriggerDecoderBase::decodeTriggerEvent(), TriggerDecoderBase::isSyncPoint(), TriggerDecoderBase::printGaps(), and setTriggerSynchronizationGap3().

◆ syncRatioAvg

int TriggerWaveform::syncRatioAvg

used by NoiselessTriggerDecoder (See TriggerCentral::handleShaftSignal())

Definition at line 101 of file trigger_structure.h.

Referenced by setTriggerSynchronizationGap3().

◆ tdcPosition

angle_t TriggerWaveform::tdcPosition

Trigger indexes within trigger cycle are counted from synchronization point, and all engine processes are defined in angles from TDC.

That's the angle distance from trigger event #0 and actual engine TDC

◆ triggerShapeSynchPointIndex

int TriggerWaveform::triggerShapeSynchPointIndex

index of synchronization event within TriggerWaveform See findTriggerZeroEventIndex()

Definition at line 231 of file trigger_structure.h.

Referenced by getTriggerWaveformSynchPointIndex(), initialize(), initializeSyncPoint(), and TriggerFormDetails::prepareEventAngles().

◆ triggerSignalIndeces

TriggerWheel TriggerWaveform::triggerSignalIndeces[PWM_PHASE_MAX_COUNT]

These signals are used for trigger export only

Definition at line 139 of file trigger_structure.h.

Referenced by addEvent(), getWheel(), and initialize().

◆ triggerSignalStates

TriggerValue TriggerWaveform::triggerSignalStates[PWM_PHASE_MAX_COUNT]

Definition at line 140 of file trigger_structure.h.

Referenced by addEvent(), and initialize().

◆ useOnlyPrimaryForSync

bool TriggerWaveform::useOnlyPrimaryForSync

In case of a multi-channel trigger, do we want to sync based on primary channel only? See also gapBothDirections

Definition at line 118 of file trigger_structure.h.

Referenced by calculateExpectedEventCounts(), configure60degSingleTooth(), configureNeon2003TriggerWaveformCam(), configureOnePlusOne(), initialize(), initializeMazdaMiataNaShape(), initializeMazdaMiataNb1ShapeWithOffset(), initializeSubaru7_6(), initializeSubaru_SVX(), and shouldConsiderEdge().

◆ useOnlyRisingEdges

bool TriggerWaveform::useOnlyRisingEdges

Definition at line 124 of file trigger_structure.h.

Referenced by addEvent(), calculateExpectedEventCounts(), TriggerDecoderBase::decodeTriggerEvent(), findAngleIndex(), handleShaftSignal(), TriggerCentral::handleShaftSignal(), initialize(), isUsefulSignal(), TriggerFormDetails::prepareEventAngles(), and InstantRpmCalculator::setLastEventTimeForInstantRpm().

◆ version

int TriggerWaveform::version = 0

this variable is incremented after each trigger shape redefinition

Definition at line 85 of file trigger_structure.h.

Referenced by initializeTriggerWaveform(), and updateTriggerWaveformIfNeeded().

◆ wave

MultiChannelStateSequenceWithData<PWM_PHASE_MAX_COUNT> TriggerWaveform::wave

wave.phaseCount is total count of shaft events per CAM or CRANK shaft revolution. TODO this should be migrated to CRANKshaft revolution, this would go together this variable is public for performance reasons (I want to avoid costs of method if it's not inlined) but name is supposed to hint at the fact that decoders should not be assigning to it Please use "getSize()" function to read this value

Definition at line 153 of file trigger_structure.h.

Referenced by addEvent(), TriggerStimulatorHelper::feedSimulatedEvent(), getAngle(), getSimulatedEventTime(), getSize(), getSwitchAngle(), initialize(), initialize60_2_2_Renault_F(), initializeTriggerWaveform(), and startSimulatedTriggerSignal().

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

controllers/trigger/decoders/trigger_structure.h
controllers/trigger/decoders/trigger_structure.cpp
controllers/trigger/trigger_decoder.cpp

Public Member Functions

Data Fields

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ TriggerWaveform()

Member Function Documentation

◆ addEvent()

◆ addEvent360()

◆ addEvent720()

◆ addEventAngle()

◆ addEventClamped()

◆ addToothFallRise()

◆ addToothRiseFall()

◆ calculateExpectedEventCounts()

◆ findAngleIndex()

◆ getAngle()

◆ getCycleDuration()

◆ getExpectedEventCount()

◆ getLength()

◆ getSize()

◆ getSwitchAngle()

◆ getTriggerWaveformSynchPointIndex()

◆ getWheel()

◆ getWheelOperationMode()

◆ initialize()

◆ initializeSyncPoint()

◆ initializeTriggerWaveform()

◆ needsDisambiguation()

◆ setSecondTriggerSynchronizationGap()

◆ setSecondTriggerSynchronizationGap2()

◆ setShapeDefinitionError()

◆ setThirdTriggerSynchronizationGap()

◆ setTriggerSynchronizationGap()

◆ setTriggerSynchronizationGap2()

◆ setTriggerSynchronizationGap3()

◆ setTriggerSynchronizationGap4()

Field Documentation

◆ expectedEventCount

◆ gapTrackingLength

◆ isRiseEvent

◆ isSecondWheelCam

◆ isSynchronizationNeeded

◆ knownOperationMode

◆ needSecondTriggerInput

◆ operationMode

◆ previousAngle

◆ shapeDefinitionError

◆ shapeWithoutTdc

◆ syncEdge

◆ synchronizationRatioFrom

◆ synchronizationRatioTo

◆ syncRatioAvg

◆ tdcPosition

◆ triggerShapeSynchPointIndex

◆ triggerSignalIndeces

◆ triggerSignalStates

◆ useOnlyPrimaryForSync

◆ useOnlyRisingEdges

◆ version

◆ wave