Detailed Description

Date: Aug 26, 2013

Author: Andrey Belomutskiy, (c) 2012-2020

Definition in file tunerstudio.h.

Data Structures
struct	tunerstudio_counters_s

struct	TunerStudioRWChunkRequest

struct	TunerStudioPageRWChunkRequest

class	TunerstudioThread

Functions
void	tunerStudioDebug (TsChannelBase tsChannel, const char msg)

void	tunerStudioError (TsChannelBase tsChannel, const char msg)

void	sendErrorCode (TsChannelBase tsChannel, uint8_t code, const char msg="")

void	requestBurn ()

int	getSecondsSinceChannelsRequest ()

void	updateTunerStudioState ()

bool	isTuningVeNow ()

void	startTunerStudioConnectivity ()

bool	needToTriggerTsRefresh ()

void	onApplyPreset ()

struct TunerStudioRWChunkRequest	__attribute__ ((packed))

bool	isTouchingArea (uint16_t offset, uint16_t count, int areaStart, int areaSize)

Variables
tunerstudio_counters_s	tsState

uint16_t	offset

uint16_t	count

uint16_t	page

TunerstudioThread	__attribute__

Function Documentation

◆ attribute()

struct TunerStudioRWChunkRequest __attribute__ ( (packed) )

Definition at line 38 of file tooth_logger.h.

                                        {
    // the whole order of all packet bytes is reversed, not just the 'endian-swap' integers
    uint32_t timestamp;
    // unfortunately all these fields are required by TS...
    bool priLevel : 1;
    bool secLevel : 1;
    bool trigger : 1;
    bool sync : 1;
    bool coil : 1;
    bool injector : 1;
} composite_logger_s;

◆ getSecondsSinceChannelsRequest()

int getSecondsSinceChannelsRequest ( )

Definition at line 15 of file tunerstudio_commands.cpp.

                                     {
    return channelsRequestTimer.getElapsedSeconds();
}

Referenced by configureRusefiLuaHooks().

Here is the caller graph for this function:

◆ isTouchingArea()

bool isTouchingArea	(	uint16_t	offset,
		uint16_t	count,
		int	areaStart,
		int	areaSize
	)

Definition at line 283 of file tunerstudio.cpp.

                                                                                  {
  if (offset + count < areaStart) {
    // we are touching below for instance VE table
    return false;
  }
  if (offset > areaStart + areaSize) {
    // we are touching after for instance VE table
    return false;
  }
  // else - we are touching it!
  return true;
}

Referenced by isTouchingVe().

Here is the caller graph for this function:

◆ isTuningVeNow()

bool isTuningVeNow ( )

Definition at line 1039 of file tunerstudio.cpp.

                     {
    return (!TunerDetectorUtils::isTuningDetectorUndefined()) &&
        !calibrationsVeWriteTimer.hasElapsedSec(TunerDetectorUtils::getUserEnteredTuningDetector());
}

Referenced by checkIfTuningVeNow(), and TpsAccelEnrichment::getTpsEnrichment().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ needToTriggerTsRefresh()

bool needToTriggerTsRefresh ( )

Definition at line 265 of file tunerstudio.cpp.

                              {
    return !engine->engineTypeChangeTimer.hasElapsedSec(1);
}

Referenced by handleBurnCommand(), TunerStudio::handleWriteChunkCommand(), and updateTunerStudioState().

Here is the caller graph for this function:

◆ onApplyPreset()

void onApplyPreset ( )

Definition at line 269 of file tunerstudio.cpp.

                     {
    engine->engineTypeChangeTimer.reset();
}

Referenced by applyPreset().

Here is the caller graph for this function:

◆ requestBurn()

void requestBurn ( )

Definition at line 449 of file tunerstudio.cpp.

                   {
#if !EFI_UNIT_TEST
    onBurnRequest();
 
#if EFI_CONFIGURATION_STORAGE
    setNeedToWriteConfiguration();
#endif /* EFI_CONFIGURATION_STORAGE */
#endif // !EFI_UNIT_TEST
}

Referenced by configureRusefiLuaHooks(), handleBurnCommand(), initFlash(), and unlockEcu().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ sendErrorCode()

void sendErrorCode	(	TsChannelBase *	tsChannel,
		uint8_t	code,
		const char *	msg = `""`
	)

Definition at line 226 of file tunerstudio.cpp.

                                                                            {
    //TODO uncomment once I have test it myself
    UNUSED(msg);
    //if (msg != DO_NOT_LOG) {
    //  efiPrintf("TS <- Err: %d [%s]", code, msg);
    //}
 
    switch (code) {
    case TS_RESPONSE_UNDERRUN:
        tsState.errorUnderrunCounter++;
        break;
    case TS_RESPONSE_OVERRUN:
        tsState.errorOverrunCounter++;
        break;
    case TS_RESPONSE_CRC_FAILURE:
        tsState.errorCrcCounter++;
        break;
    case TS_RESPONSE_UNRECOGNIZED_COMMAND:
        tsState.errorUnrecognizedCommand++;
        break;
    case TS_RESPONSE_OUT_OF_RANGE:
        tsState.errorOutOfRange++;
        break;
    default:
        tsState.errorOther++;
        break;
    }
 
    tsChannel->writeCrcResponse(code);
}

Referenced by handleBurnCommand(), tsProcessOne(), and validateOffsetCount().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ startTunerStudioConnectivity()

void startTunerStudioConnectivity ( )

Definition at line 1044 of file tunerstudio.cpp.

                                    {
    // Assert tune & output channel struct sizes
    static_assert(sizeof(persistent_config_s) == TOTAL_CONFIG_SIZE, "TS datapage size mismatch");
    // useful trick if you need to know how far off is the static_assert
    //char (*__kaboom)[sizeof(persistent_config_s)] = 1;
    // another useful trick
    //static_assert(offsetof (engine_configuration_s,HD44780_e) == 700);
 
    memset(&tsState, 0, sizeof(tsState));
 
    addConsoleAction("tsinfo", printTsStats);
    addConsoleAction("reset_ts", resetTs);
    addConsoleActionI("set_ts_speed", setTsSpeed);
 
#if EFI_BLUETOOTH_SETUP
    // module initialization start (it waits for disconnect and then communicates to the module)
    // Usage:   "bluetooth_hc06 <baud> <name> <pincode>"
    // Example: "bluetooth_hc06 38400 rusefi 1234"
    // bluetooth_jdy 115200 alphax 1234
    addConsoleActionSSS("bluetooth_hc05", [](const char *baudRate, const char *name, const char *pinCode) {
        bluetoothStart(BLUETOOTH_HC_05, baudRate, name, pinCode);
    });
    addConsoleActionSSS("bluetooth_hc06", [](const char *baudRate, const char *name, const char *pinCode) {
        bluetoothStart(BLUETOOTH_HC_06, baudRate, name, pinCode);
    });
    addConsoleActionSSS("bluetooth_bk", [](const char *baudRate, const char *name, const char *pinCode) {
        bluetoothStart(BLUETOOTH_BK3231, baudRate, name, pinCode);
    });
    addConsoleActionSSS("bluetooth_jdy", [](const char *baudRate, const char *name, const char *pinCode) {
        bluetoothStart(BLUETOOTH_JDY_3x, baudRate, name, pinCode);
    });
    addConsoleActionSSS("bluetooth_jdy31", [](const char *baudRate, const char *name, const char *pinCode) {
        bluetoothStart(BLUETOOTH_JDY_31, baudRate, name, pinCode);
    });
#endif /* EFI_BLUETOOTH_SETUP */
}

Referenced by runRusEfi().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ tunerStudioDebug()

void tunerStudioDebug	(	TsChannelBase *	tsChannel,
		const char *	msg
	)

Definition at line 163 of file tunerstudio.cpp.

                                                                 {
#if EFI_TUNER_STUDIO_VERBOSE
    efiPrintf("%s: %s", tsChannel->name, msg);
#endif /* EFI_TUNER_STUDIO_VERBOSE */
}

Referenced by TunerStudio::handleCrcCommand(), TunerStudio::handlePlainCommand(), handleTestCommand(), and tunerStudioError().

Here is the caller graph for this function:

◆ tunerStudioError()

void tunerStudioError	(	TsChannelBase *	tsChannel,
		const char *	msg
	)

Definition at line 762 of file tunerstudio.cpp.

                                                                 {
    tunerStudioDebug(tsChannel, msg);
    printErrorCounters();
    tsState.errorCounter++;
}

Referenced by getWorkingPageAddr(), TunerStudio::handleCrc32Check(), TunerStudio::handleCrcCommand(), TunerStudio::handlePageReadCommand(), TunerStudio::handleWriteChunkCommand(), tsProcessOne(), and validateOffsetCount().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ updateTunerStudioState()

void updateTunerStudioState ( )

Definition at line 626 of file status_loop.cpp.

                              {
    TunerStudioOutputChannels *tsOutputChannels = &engine->outputChannels;
#if EFI_USB_SERIAL
  // pretty much SD card logs know if specifically USB serial is active
    engine->outputChannels.isUsbConnected = is_usb_serial_ready();
#endif // EFI_USB_SERIAL
 
    float rpm = Sensor::get(SensorType::Rpm).value_or(0);
 
 
  static Timer blinkIndicatorsTimer;
  constexpr float blinkHalfPeriod = 0.3;
  bool isBlinkPhase = blinkIndicatorsTimer.hasElapsedSec(blinkHalfPeriod);
#if EFI_ELECTRONIC_THROTTLE_BODY
  blinkEtbErrorCodes(isBlinkPhase);
#endif // EFI_ELECTRONIC_THROTTLE_BODY
  if (isBlinkPhase) {
    engine->outputChannels.sparkCutReasonBlinker = 0;
    engine->outputChannels.fuelCutReasonBlinker = 0;
 
    if (blinkIndicatorsTimer.hasElapsedSec(2 * blinkHalfPeriod)) {
      blinkIndicatorsTimer.reset();
    }
  } else {
    engine->outputChannels.sparkCutReasonBlinker = engine->outputChannels.sparkCutReason;
    engine->outputChannels.fuelCutReasonBlinker = engine->outputChannels.fuelCutReason;
  }
 
 
#if EFI_PROD_CODE
    executorStatistics();
#endif /* EFI_PROD_CODE */
 
    DcHardware *dc = getPrimaryDCHardwareForLogging();
    engine->dc_motors.dcOutput0 = dc->dcMotor.get();
    engine->dc_motors.isEnabled0_int = dc->msg() == nullptr;
 
    tsOutputChannels->RPMValue = rpm;
#if EFI_SHAFT_POSITION_INPUT
    tsOutputChannels->instantRpm = engine->triggerCentral.instantRpm.getInstantRpm();
    tsOutputChannels->totalTriggerErrorCounter = engine->triggerCentral.triggerState.totalTriggerErrorCounter;
    tsOutputChannels->rpmAcceleration = engine->rpmCalculator.getRpmAcceleration();
 
    tsOutputChannels->orderingErrorCounter = engine->triggerCentral.triggerState.orderingErrorCounter;
#endif // EFI_SHAFT_POSITION_INPUT
 
    updateSensors();
    updateFuelInfo();
    updateIgnition(rpm);
    updateFlags();
    // update calibration channel, reset to None state after timeout
    tsCalibrationIsIdle();
 
    // Output both the estimated air flow, and measured air flow (if available)
    tsOutputChannels->mafMeasured = Sensor::getOrZero(SensorType::Maf);
    tsOutputChannels->mafMeasured2 = Sensor::getOrZero(SensorType::Maf2);
    tsOutputChannels->mafEstimate = engine->engineState.airflowEstimate;
 
#if EFI_ENGINE_CONTROL
    tsOutputChannels->injectorDutyCycle = minF(/*let's avoid scaled "uint8_t, 2" overflow*/127, getInjectorDutyCycle(rpm));
    tsOutputChannels->injectorDutyCycleStage2 = getInjectorDutyCycleStage2(rpm);
#endif
 
    tsOutputChannels->seconds = getTimeNowS();
 
    tsOutputChannels->engineMode = packEngineMode();
    tsOutputChannels->firmwareVersion = getRusEfiVersion();
 
    tsOutputChannels->accelerationLat = engine->sensors.accelerometer.lat;
    tsOutputChannels->accelerationLon = engine->sensors.accelerometer.lon;
    tsOutputChannels->accelerationVert = engine->sensors.accelerometer.vert;
    tsOutputChannels->gyroYaw = engine->sensors.accelerometer.yawRate;
 
#if EFI_DYNO_VIEW
    tsOutputChannels->hp = getDynoviewHP();
  tsOutputChannels->torque = getDynoviewTorque();
#else
    tsOutputChannels->hp = -1;
  tsOutputChannels->torque = -1;
#endif
 
    tsOutputChannels->turboSpeed = Sensor::getOrZero(SensorType::TurbochargerSpeed);
    extern FrequencySensor inputShaftSpeedSensor;
    tsOutputChannels->issEdgeCounter = inputShaftSpeedSensor.eventCounter;
    extern FrequencySensor vehicleSpeedSensor;
    tsOutputChannels->vssEdgeCounter = vehicleSpeedSensor.eventCounter;
 
    tsOutputChannels->hasCriticalError = hasFirmwareError() || hasConfigError() || engine->engineState.warnings.hasWarningMessage();
    tsOutputChannels->hasFaultReportFile = hasErrorReportFile();
    tsOutputChannels->triggerPageRefreshFlag = needToTriggerTsRefresh() || ltftNeedVeRefresh();
 
    tsOutputChannels->isWarnNow = engine->engineState.warnings.isWarningNow();
 
    tsOutputChannels->tpsAccelFuel = engine->engineState.tpsAccelEnrich;
 
    tsOutputChannels->checkEngine = hasErrorCodes();
 
    engine->engineState.warnings.refreshTs();
 
    tsOutputChannels->starterState = enginePins.starterControl.getLogicValue();
    tsOutputChannels->starterRelayDisable = enginePins.starterRelayDisable.getLogicValue();
 
 
    tsOutputChannels->revolutionCounterSinceStart = engine->rpmCalculator.getRevolutionCounterSinceStart();
 
#if EFI_CLOCK_LOCKS
    tsOutputChannels->maxLockedDuration = NT2US(maxLockedDuration);
#endif /* EFI_CLOCK_LOCKS */
 
#if EFI_SHAFT_POSITION_INPUT
    tsOutputChannels->maxTriggerReentrant = maxTriggerReentrant;
    tsOutputChannels->triggerPrimaryFall = engine->triggerCentral.getHwEventCounter((int)SHAFT_PRIMARY_FALLING);
    tsOutputChannels->triggerPrimaryRise = engine->triggerCentral.getHwEventCounter((int)SHAFT_PRIMARY_RISING);
 
    tsOutputChannels->triggerSecondaryFall = engine->triggerCentral.getHwEventCounter((int)SHAFT_SECONDARY_FALLING);
    tsOutputChannels->triggerSecondaryRise = engine->triggerCentral.getHwEventCounter((int)SHAFT_SECONDARY_RISING);
 
#endif // EFI_SHAFT_POSITION_INPUT
 
#if HAL_USE_PAL && EFI_PROD_CODE
    tsOutputChannels->extiOverflowCount = getExtiOverflowCounter();
#endif
 
    switch (engineConfiguration->debugMode) {
    case DBG_LOGIC_ANALYZER:
#if EFI_LOGIC_ANALYZER
    // used by HW CI
        reportLogicAnalyzerToTS();
#endif /* EFI_LOGIC_ANALYZER */
        break;
    default:
        ;
    }
}