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)
int PUBLIC_API_WEAK	boardGetAnalogDiagnostic ()
int PUBLIC_API_WEAK	boardGetAnalogInputDiagnostic (adc_channel_e channel, float)
int	analogGetDiagnostic ()
AdcChannelMode	getAdcMode (adc_channel_e hwChannel)
float	getMCUInternalTemperature ()
int	getInternalAdcValue (const char *msg, adc_channel_e hwChannel)
static void	printAdcValue (int channel)
static void	printAdcChannedReport (const char *prefix, int internalIndex, adc_channel_e hwChannel)
void	printFullAdcReport (void)
static void	setAdcDebugReporting (int value)
void	updateSlowAdc (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	waitForSlowAdc (uint32_t lastAdcCounter)
void	initAdcInputs ()
void	printFullAdcReportIfNeeded (void)

Variables
AdcDevice	fastAdc
static volatile NO_CACHE adcsample_t	slowAdcSamples [SLOW_ADC_CHANNEL_COUNT]
static uint32_t	slowAdcConversionCount = 0
static float	mcuTemperature
static AdcChannelMode	adcHwChannelMode [EFI_ADC_TOTAL_CHANNELS]
static int	adcDebugReporting = false
	adc_channel_e

Function Documentation

__attribute__()

__attribute__

(

(weak)

)

Definition at line 203 of file adc_inputs.cpp.

{ }

addFastAdcChannel()

void addFastAdcChannel	(	const char *	name,
		adc_channel_e	hwChannel
	)

Definition at line 175 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()

int analogGetDiagnostic

(

)

Definition at line 41 of file adc_inputs.cpp.

{
    /* TODO: debounce? */
    return boardGetAnalogDiagnostic();
}

Referenced by SensorChecker::onSlowCallback().

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()

int PUBLIC_API_WEAK boardGetAnalogDiagnostic

(

)

Definition at line 23 of file adc_inputs.cpp.

                                               {
    return 0;
}

Referenced by analogGetDiagnostic(), and boardGetAnalogInputDiagnostic().

Here is the caller graph for this function:

boardGetAnalogInputDiagnostic()

int PUBLIC_API_WEAK boardGetAnalogInputDiagnostic	(	adc_channel_e	channel,
		float
	)

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();
    }
#endif // EFI_PROD_CODE
 
    /* input is outside chip/ECU */
    return 0;
}

Here is the call 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 205 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 69 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;
}

getInternalAdcValue()

int getInternalAdcValue	(	const char *	msg,
		adc_channel_e	hwChannel
	)

Definition at line 77 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 slowAdcSamples[hwChannel - EFI_ADC_0];
}

Here is the call graph for this function:

getMCUInternalTemperature()

float getMCUInternalTemperature

(

void

)

Definition at line 73 of file adc_inputs.cpp.

                                  {
    return mcuTemperature;
}

Referenced by populateFrame(), and updateMiscSensors().

Here is the caller graph for this function:

initAdcInputs()

void initAdcInputs

(

)

Definition at line 231 of file adc_inputs.cpp.

                     {
    efiPrintf("initAdcInputs()");
 
    configureInputs();
 
    // migrate to 'enable adcdebug'
    addConsoleActionI("adcdebug", &setAdcDebugReporting);
 
#if EFI_INTERNAL_ADC
    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);
    updateSlowAdc(getTimeNowNt());
}

Referenced by initHardware().

Here is the call graph for this function:

Here is the caller graph for this function:

printAdcChannedReport()

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

static

Definition at line 103 of file adc_inputs.cpp.

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

Referenced by printFullAdcReport().

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 92 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 119 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);
 
        printAdcChannedReport("F", internalIndex, hwChannel);
    }
#endif // EFI_USE_FAST_ADC
    efiPrintf("slow %lu samples", slowAdcConversionCount);
 
    /* we assume that all slow ADC channels are enabled */
    for (int internalIndex = 0; internalIndex < ADC_MAX_CHANNELS_COUNT; internalIndex++) {
        adc_channel_e hwChannel = static_cast<adc_channel_e>(internalIndex + EFI_ADC_0);
 
        printAdcChannedReport("S", internalIndex, hwChannel);
    }
}

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 257 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 188 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 139 of file adc_inputs.cpp.

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

Referenced by initAdcInputs().

Here is the caller graph for this function:

updateSlowAdc()

void updateSlowAdc

(

efitick_t

nowNt

)

Definition at line 144 of file adc_inputs.cpp.

                                    {
    {
        ScopePerf perf(PE::AdcConversionSlow);
 
        /* drop volatile type qualifier - this is safe */
        if (!readSlowAnalogInputs((adcsample_t *)slowAdcSamples)) {
            engine->outputChannels.slowAdcErrorCount++;
            return;
        }
 
        // 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);
        }
    }
 
    {
        ScopePerf perf(PE::AdcProcessSlow);
 
        slowAdcConversionCount++;
 
        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:

waitForSlowAdc()

void waitForSlowAdc

(

uint32_t

lastAdcCounter

)

Definition at line 223 of file adc_inputs.cpp.

                                             {
    // note that having ADC reading is one thing while having new sensor API is a totally different thing!
    // todo: use sync.objects?
    while (slowAdcConversionCount <= lastAdcCounter) {
        chThdSleepMilliseconds(1);
    }
}

Referenced by StepperMotorBase::setInitialPosition().

Here is the caller graph for this function:

Variable Documentation

adc_channel_e

adc_channel_e

Initial value:

{
    return 0

Definition at line 266 of file adc_inputs.cpp.

Referenced by printAdcValue(), and printFullAdcReport().

adcDebugReporting

int adcDebugReporting = false

static

Definition at line 67 of file adc_inputs.cpp.

Referenced by printFullAdcReportIfNeeded(), and setAdcDebugReporting().

adcHwChannelMode

AdcChannelMode adcHwChannelMode[EFI_ADC_TOTAL_CHANNELS]

static

Definition at line 64 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().

mcuTemperature

float mcuTemperature

static

Definition at line 62 of file adc_inputs.cpp.

Referenced by getMCUInternalTemperature(), and updateSlowAdc().

slowAdcConversionCount

uint32_t slowAdcConversionCount = 0

static

Definition at line 60 of file adc_inputs.cpp.

Referenced by printFullAdcReport(), updateSlowAdc(), and waitForSlowAdc().

slowAdcSamples

volatile NO_CACHE adcsample_t slowAdcSamples[SLOW_ADC_CHANNEL_COUNT]

static

Definition at line 58 of file adc_inputs.cpp.

Referenced by getInternalAdcValue(), and updateSlowAdc().

Go to the source code of this file.