adc_inputs.cpp File Reference

Detailed Description

Low level ADC code.

Date

Jan 14, 2013

Author

Andrey Belomutskiy, (c) 2012-2020

Definition in file adc_inputs.cpp.

Functions
float PUBLIC_API_WEAK	getAnalogInputDividerCoefficient (adc_channel_e)
float PUBLIC_API_WEAK	boardAdjustVoltage (float voltage, adc_channel_e)
ObdCode PUBLIC_API_WEAK	boardGetAnalogDiagnostic ()
int PUBLIC_API_WEAK	boardGetAnalogInputDiagnostic (adc_channel_e channel, float)
static ObdCode	analogGetVrefDiagnostic ()
ObdCode	analogGetDiagnostic ()
expected< float >	adcGetRawVoltage (const char *msg, adc_channel_e hwChannel)
expected< float >	adcGetScaledVoltage (const char *msg, adc_channel_e hwChannel)
AdcChannelMode	getAdcMode (adc_channel_e hwChannel)
adcsample_t	adcOnchipSlowGetAvgRaw (adc_channel_e hwChannel)
int	getInternalAdcValue (const char *msg, adc_channel_e hwChannel)
static void	printAdcValue (int channel)
void	adcPrintChannelReport (const char *prefix, int internalIndex, adc_channel_e hwChannel)
void	adcOnchipSlowShowReport ()
void	printFullAdcReport (void)
static void	setAdcDebugReporting (int value)
void	adcOnchipSlowUpdate (efitick_t nowNt)
void	adcInputsUpdateSubscribers (efitick_t nowNt)
void	addFastAdcChannel (const char *, adc_channel_e hwChannel)
void	removeChannel (const char *, adc_channel_e hwChannel)
	__attribute__ ((weak)) void setAdcChannelOverrides()
static void	configureInputs ()
void	initAdcInputs ()
void	printFullAdcReportIfNeeded (void)

Variables
AdcDevice	fastAdc
static AdcChannelMode	adcHwChannelMode [EFI_ADC_TOTAL_CHANNELS]
static int	adcDebugReporting = false
	adc_channel_e

Function Documentation

__attribute__()

__attribute__

(

(weak)

)

Definition at line 221 of file adc_inputs.cpp.

{ }

adcGetRawVoltage()

expected< float > adcGetRawVoltage	(	const char *	msg,
		adc_channel_e	hwChannel
	)

Definition at line 78 of file adc_inputs.cpp.

                                                                           {
    float rawVoltage = adcRawValueToRawVoltage(adcGetRawValue(msg, hwChannel));
    int inputStatus = boardGetAnalogInputDiagnostic(hwChannel, rawVoltage);
 
    if (inputStatus == 0) {
        return expected(rawVoltage);
    }
 
    /* TODO: convert inputStatus to unexpected? */
    return unexpected;
}

Referenced by adcGetScaledVoltage(), adcPrintChannelReport(), AdcSubscription::PrintInfo(), printMAPInfo(), and AdcSubscription::UpdateSubscribers().

Here is the call graph for this function:

Here is the caller graph for this function:

adcGetScaledVoltage()

expected< float > adcGetScaledVoltage	(	const char *	msg,
		adc_channel_e	hwChannel
	)

Definition at line 91 of file adc_inputs.cpp.

                                                                              {
    auto rawVoltage = adcGetRawVoltage(msg, hwChannel);
 
    if (rawVoltage) {
        // TODO: merge getAnalogInputDividerCoefficient() and boardAdjustVoltage() into single board hook?
        float voltage = rawVoltage.value_or(0) * getAnalogInputDividerCoefficient(hwChannel);
        return expected(boardAdjustVoltage(voltage, hwChannel));
    }
 
    return expected(rawVoltage);
}

Referenced by adcPrintChannelReport(), getAfr(), and updateRawSensors().

Here is the call graph for this function:

Here is the caller graph for this function:

adcInputsUpdateSubscribers()

void adcInputsUpdateSubscribers

(

efitick_t

nowNt

)

Definition at line 181 of file adc_inputs.cpp.

                                                 {
    adcOnchipSlowUpdate(nowNt);
 
    {
        ScopePerf perf(PE::AdcProcessSlow);
 
        AdcSubscription::UpdateSubscribers(nowNt);
 
        protectedGpio_check(nowNt);
    }
}

Referenced by initAdcInputs(), and MainLoop::PeriodicTask().

Here is the call graph for this function:

Here is the caller graph for this function:

adcOnchipSlowGetAvgRaw()

adcsample_t adcOnchipSlowGetAvgRaw ( adc_channel_e  hwChannel )

extern

Definition at line 59 of file adc_onchip_slow.cpp.

{
    return slowAdcSamples[hwChannel - EFI_ADC_0];
}

Referenced by getInternalAdcValue().

Here is the caller graph for this function:

adcOnchipSlowShowReport()

void adcOnchipSlowShowReport ( )

extern

Definition at line 66 of file adc_onchip_slow.cpp.

{
    efiPrintf("slow %lu samples", slowAdcConversionCount);
 
    /* we assume that all slow ADC channels are enabled */
    for (int internalIndex = 0; internalIndex < SLOW_ADC_CHANNEL_COUNT; internalIndex++) {
        adc_channel_e hwChannel = static_cast<adc_channel_e>(internalIndex + EFI_ADC_0);
 
        adcPrintChannelReport("S", internalIndex, hwChannel);
    }
}

Referenced by printFullAdcReport().

Here is the call graph for this function:

Here is the caller graph for this function:

adcOnchipSlowUpdate()

void adcOnchipSlowUpdate ( efitick_t  nowNt )

extern

Definition at line 32 of file adc_onchip_slow.cpp.

                                          {
    UNUSED(nowNt);
 
    ScopePerf perf(PE::AdcConversionSlow);
 
    /* drop volatile type qualifier - this is safe */
    if (!readSlowAnalogInputs((adcsample_t *)slowAdcSamples)) {
        engine->outputChannels.slowAdcErrorCount++;
        return;
    }
 
    // TODO:
    //engine->outputChannels.slowAdcConversionCount++;
    slowAdcConversionCount++;
 
    // Ask the port to sample the MCU temperature
    mcuTemperature = getMcuTemperature();
    if (mcuTemperature > 150.0f || mcuTemperature < -50.0f) {
        /*
         * we have a sporadic issue with this check todo https://github.com/rusefi/rusefi/issues/2552
         */
        //criticalError("Invalid CPU temperature measured %f", degrees);
    }
 
    mcuVrefVoltage = getMcuVrefVoltage();
}

Referenced by adcInputsUpdateSubscribers().

Here is the call graph for this function:

Here is the caller graph for this function:

adcPrintChannelReport()

void adcPrintChannelReport	(	const char *	prefix,
		int	internalIndex,
		adc_channel_e	hwChannel
	)

Definition at line 142 of file adc_inputs.cpp.

{
    if (isAdcChannelValid(hwChannel)) {
        ioportid_t port = getAdcChannelPort("print", hwChannel);
        int pin = getAdcChannelPin(hwChannel);
        int adcValue = adcGetRawValue("print", hwChannel);
        auto volts = adcGetRawVoltage("print", hwChannel);
        auto voltsInput = adcGetScaledVoltage("print", hwChannel);
        /* Human index starts from 1 */
        efiPrintf(" %s ch[%2d] @ %s%d ADC%d 12bit=%4d %.3fV input %.3fV %s",
            prefix, internalIndex, portname(port), pin,
            /* TODO: */ hwChannel - EFI_ADC_0 + 1,
            adcValue, volts.value_or(0), voltsInput.value_or(0), volts ? "valid" : "INVALID");
    }
}

Referenced by adcOnchipSlowShowReport(), and printFullAdcReport().

Here is the call graph for this function:

Here is the caller graph for this function:

addFastAdcChannel()

void addFastAdcChannel	(	const char *	name,
		adc_channel_e	hwChannel
	)

Definition at line 193 of file adc_inputs.cpp.

                                                             {
    if (!isAdcChannelValid(hwChannel)) {
        return;
    }
 
#if EFI_USE_FAST_ADC
    fastAdc.enableChannel(hwChannel);
#endif
 
    adcHwChannelMode[hwChannel] = AdcChannelMode::Fast;
    // Nothing to do for slow channels, input is mapped to analog in init_sensors.cpp
}

Referenced by addAdcChannelForTrigger(), configureInputs(), and setAdcChannelOverrides().

Here is the call graph for this function:

Here is the caller graph for this function:

analogGetDiagnostic()

ObdCode analogGetDiagnostic

(

)

Definition at line 59 of file adc_inputs.cpp.

{
    /* TODO: debounce? */
    auto code = analogGetVrefDiagnostic();
    if (code != ObdCode::None) {
        return code;
    }
 
    return boardGetAnalogDiagnostic();
}

Referenced by SensorChecker::onSlowCallback().

Here is the call graph for this function:

Here is the caller graph for this function:

analogGetVrefDiagnostic()

static ObdCode analogGetVrefDiagnostic ( )

static

Definition at line 40 of file adc_inputs.cpp.

{
#if HAL_USE_ADC
    float vref = getMCUVref();
 
    // TODO: +/-10% is way too big?
    if (vref > engineConfiguration->adcVcc * 1.1) {
        return ObdCode::OBD_Sensor_Refence_Voltate_A_High;
    }
 
    if (vref < engineConfiguration->adcVcc * 0.9) {
        return ObdCode::OBD_Sensor_Refence_Voltate_A_Low;
    }
#endif
 
    return ObdCode::None;
}

Referenced by analogGetDiagnostic().

Here is the call graph for this function:

Here is the caller graph for this function:

boardAdjustVoltage()

float PUBLIC_API_WEAK boardAdjustVoltage	(	float	voltage,
		adc_channel_e	hwChannel
	)

Definition at line 15 of file adc_inputs.cpp.

                                                                         {
    // a hack useful when we do not trust voltage just after board EN was turned on. is this just hiding electrical design flaws?
    return voltage;
}

Referenced by adcGetScaledVoltage().

Here is the caller graph for this function:

boardGetAnalogDiagnostic()

ObdCode PUBLIC_API_WEAK boardGetAnalogDiagnostic

(

)

Definition at line 23 of file adc_inputs.cpp.

                                                   {
    return ObdCode::None;
}

Referenced by analogGetDiagnostic(), and boardGetAnalogInputDiagnostic().

Here is the caller graph for this function:

boardGetAnalogInputDiagnostic()

int PUBLIC_API_WEAK boardGetAnalogInputDiagnostic	(	adc_channel_e	channel,
		float	voltage
	)

Definition at line 28 of file adc_inputs.cpp.

                                                                                {
#if EFI_PROD_CODE
    /* for on-chip ADC inputs we check common analog health */
    if (isAdcChannelOnChip(channel)) {
        return (boardGetAnalogDiagnostic() == ObdCode::None) ? 0 : -1;
    }
#endif // EFI_PROD_CODE
 
    /* input is outside chip/ECU */
    return 0;
}

Referenced by adcGetRawVoltage().

Here is the call graph for this function:

Here is the caller graph for this function:

configureInputs()

static void configureInputs ( )

static

order of analog channels here is totally random and has no meaning we also have some weird implementation with internal indices - that all has no meaning, it's just a random implementation which does not mean anything.

Definition at line 223 of file adc_inputs.cpp.

                              {
    memset(adcHwChannelMode, (int)AdcChannelMode::Off, sizeof(adcHwChannelMode));
 
    /**
     * order of analog channels here is totally random and has no meaning
     * we also have some weird implementation with internal indices - that all has no meaning, it's just a random implementation
     * which does not mean anything.
     */
 
    addFastAdcChannel("MAP", engineConfiguration->map.sensor.hwChannel);
 
    // not currently used   addFastAdcChannel("Vref", engineConfiguration->vRefAdcChannel, ADC_SLOW);
 
    addFastAdcChannel("AUXF#1", engineConfiguration->auxFastSensor1_adcChannel);
 
    setAdcChannelOverrides();
}

Referenced by initAdcInputs().

Here is the call graph for this function:

Here is the caller graph for this function:

getAdcMode()

AdcChannelMode getAdcMode

(

adc_channel_e

hwChannel

)

Definition at line 110 of file adc_inputs.cpp.

                                                   {
    return adcHwChannelMode[hwChannel];
}

Referenced by AdcSubscription::PrintInfo().

Here is the caller graph for this function:

getAnalogInputDividerCoefficient()

float PUBLIC_API_WEAK getAnalogInputDividerCoefficient

(

adc_channel_e

hwChannel

)

Definition at line 11 of file adc_inputs.cpp.

                                                                      {
    return engineConfiguration->analogInputDividerCoefficient;
}

Referenced by adcGetScaledVoltage().

Here is the caller graph for this function:

getInternalAdcValue()

int getInternalAdcValue	(	const char *	msg,
		adc_channel_e	hwChannel
	)

Definition at line 116 of file adc_inputs.cpp.

                                                                  {
    if (!isAdcChannelValid(hwChannel)) {
        warning(ObdCode::CUSTOM_OBD_ANALOG_INPUT_NOT_CONFIGURED, "ADC: %s input is not configured", msg);
        return -1;
    }
 
#if EFI_USE_FAST_ADC
    if (adcHwChannelMode[hwChannel] == AdcChannelMode::Fast) {
        return fastAdc.getAvgAdcValue(hwChannel);
    }
#endif // EFI_USE_FAST_ADC
 
    return adcOnchipSlowGetAvgRaw(hwChannel);
}

Here is the call graph for this function:

initAdcInputs()

void initAdcInputs

(

)

Definition at line 241 of file adc_inputs.cpp.

                     {
    efiPrintf("initAdcInputs()");
 
    configureInputs();
 
    // migrate to 'enable adcdebug'
    addConsoleActionI("adcdebug", &setAdcDebugReporting);
 
#if EFI_INTERNAL_ADC
    // This will start HW for all used ADCs
    portInitAdc();
 
#if EFI_USE_FAST_ADC
    // After this point fastAdc is not allowed to add channels
    fastAdc.init();
#endif // EFI_USE_FAST_ADC
 
    addConsoleActionI("adc", (VoidInt) printAdcValue);
#else // ! EFI_INTERNAL_ADC
    efiPrintf("ADC disabled");
#endif // EFI_INTERNAL_ADC
 
    // Workaround to pre-feed all sensors with some data...
    chThdSleepMilliseconds(1);
    adcInputsUpdateSubscribers(getTimeNowNt());
}

Referenced by initHardware().

Here is the call graph for this function:

Here is the caller graph for this function:

printAdcValue()

static void printAdcValue ( int  channel )

static

Definition at line 131 of file adc_inputs.cpp.

                                       {
    /* Do this check before conversion to adc_channel_e that is uint8_t based */
    if ((channel < EFI_ADC_NONE) || (channel >= EFI_ADC_TOTAL_CHANNELS)) {
        efiPrintf("Invalid ADC channel %d", channel);
        return;
    }
    int adcValue = adcGetRawValue("print", (adc_channel_e)channel);
    float voltsInput = adcRawValueToScaledVoltage(adcValue, (adc_channel_e)channel);
    efiPrintf("adc %d input %.3fV", channel, voltsInput);
}

Referenced by initAdcInputs().

Here is the caller graph for this function:

printFullAdcReport()

void printFullAdcReport

(

void

)

Definition at line 160 of file adc_inputs.cpp.

                              {
#if EFI_USE_FAST_ADC
    efiPrintf("fast %u samples", engine->outputChannels.fastAdcConversionCount);
 
    for (int internalIndex = 0; internalIndex < fastAdc.size(); internalIndex++) {
        adc_channel_e hwChannel = fastAdc.getAdcChannelByInternalIndex(internalIndex);
 
        adcPrintChannelReport("F", internalIndex, hwChannel);
    }
#endif // EFI_USE_FAST_ADC
 
    adcOnchipSlowShowReport();
}

Referenced by initSettings(), and printFullAdcReportIfNeeded().

Here is the call graph for this function:

Here is the caller graph for this function:

printFullAdcReportIfNeeded()

void printFullAdcReportIfNeeded

(

void

)

Definition at line 268 of file adc_inputs.cpp.

                                      {
    if (!adcDebugReporting)
        return;
    printFullAdcReport();
}

Referenced by updateDevConsoleState().

Here is the call graph for this function:

Here is the caller graph for this function:

removeChannel()

void removeChannel	(	const char *	name,
		adc_channel_e	hwChannel
	)

Definition at line 206 of file adc_inputs.cpp.

                                                         {
    if (!isAdcChannelValid(hwChannel)) {
        return;
    }
#if EFI_USE_FAST_ADC
    if (adcHwChannelMode[hwChannel] == AdcChannelMode::Fast) {
        /* TODO: */
        //fastAdc.disableChannel(hwChannel);
    }
#endif
 
    adcHwChannelMode[hwChannel] = AdcChannelMode::Off;
}

Referenced by setAdcChannelOverrides().

Here is the call graph for this function:

Here is the caller graph for this function:

setAdcDebugReporting()

static void setAdcDebugReporting ( int  value )

static

Definition at line 174 of file adc_inputs.cpp.

                                            {
    adcDebugReporting = value;
    efiPrintf("adcDebug=%d", adcDebugReporting);
}

Referenced by initAdcInputs().

Here is the caller graph for this function:

Variable Documentation

adc_channel_e

adc_channel_e

Initial value:

{
    return expected(0.0f)

Definition at line 277 of file adc_inputs.cpp.

Referenced by printAdcValue(), and printFullAdcReport().

adcDebugReporting

int adcDebugReporting = false

static

Definition at line 108 of file adc_inputs.cpp.

Referenced by printFullAdcReportIfNeeded(), and setAdcDebugReporting().

adcHwChannelMode

AdcChannelMode adcHwChannelMode[EFI_ADC_TOTAL_CHANNELS]

static

Definition at line 105 of file adc_inputs.cpp.

Referenced by addFastAdcChannel(), configureInputs(), getAdcMode(), getInternalAdcValue(), and removeChannel().

fastAdc

AdcDevice fastAdc

extern

Referenced by addFastAdcChannel(), fastAdcStartTrigger(), AdcDevice::getAdcChannelToken(), AdcDevice::getAvgAdcValue(), getInternalAdcValue(), initAdcInputs(), and printFullAdcReport().

Go to the source code of this file.