adc_inputs.cpp File Reference

Detailed Description

Low level ADC code.

rusEfi uses two ADC devices on the same 16 pins at the moment. Two ADC devices are used in orde to distinguish between fast and slow devices. The idea is that but only having few channels in 'fast' mode we can sample those faster?

At the moment rusEfi does not allow to have more than 16 ADC channels combined. At the moment there is no flexibility to use any ADC pins, only the hardcoded choice of 16 pins.

Slow ADC group is used for IAT, CLT, AFR, VBATT etc - this one is currently sampled at 500Hz

Fast ADC group is used for MAP, MAF HIP - this one is currently sampled at 10KHz We need frequent MAP for map_averaging.cpp

10KHz equals one measurement every 3.6 degrees at 6000 RPM

Date

Jan 14, 2013

Author

Andrey Belomutskiy, (c) 2012-2020

Definition in file adc_inputs.cpp.

Functions
float	__attribute__ ((weak)) getAnalogInputDividerCoefficient(adc_channel_e)
float	getVoltageDivided (const char *msg, adc_channel_e hwChannel)
float	getVoltage (const char *msg, adc_channel_e hwChannel)
static adcsample_t	getAvgAdcValue (int index, adcsample_t *samples, int bufDepth, int numChannels)
static void	adc_callback_fast (ADCDriver *adcp)
AdcDevice fastAdc &	adcgrpcfgFast (fastAdcSampleBuf)
static void	fast_adc_callback (GPTDriver *)
float	getMCUInternalTemperature ()
int	getInternalAdcValue (const char *msg, adc_channel_e hwChannel)
adc_channel_mode_e	getAdcMode (adc_channel_e hwChannel)
static void	printAdcValue (int channel)
void	printFullAdcReport (void)
static void	setAdcDebugReporting (int value)
void	waitForSlowAdc (uint32_t lastAdcCounter)
int	getSlowAdcCounter ()
void	addChannel (const char *, adc_channel_e setting, adc_channel_mode_e mode)
void	removeChannel (const char *name, adc_channel_e setting)
static void	configureInputs ()
void	initAdcInputs ()
void	printFullAdcReportIfNeeded (void)

Variables
static NO_CACHE adcsample_t	slowAdcSamples [SLOW_ADC_CHANNEL_COUNT]
static adc_channel_mode_e	adcHwChannelEnabled [HW_MAX_ADC_INDEX]
static uint32_t	slowAdcCounter = 0
static int	adcDebugReporting = false
static ADCConversionGroup	adcgrpcfgFast
static NO_CACHE adcsample_t	fastAdcSampleBuf [ADC_BUF_DEPTH_FAST *ADC_MAX_CHANNELS_COUNT]
static float	mcuTemperature
static GPTConfig	fast_adc_config
static uint32_t	slowAdcConversionCount = 0
static uint32_t	slowAdcErrorsCount = 0
static SlowAdcController	slowAdcController
	adc_channel_e

Function Documentation

__attribute__()

float __attribute__

(

(weak)

)

Definition at line 24 of file adc_inputs.cpp.

                                                                            {
    return engineConfiguration->analogInputDividerCoefficient;
}

adc_callback_fast()

static void adc_callback_fast ( ADCDriver *  adcp )

static

Definition at line 115 of file adc_inputs.cpp.

                                               {
    // State may not be complete if we get a callback for "half done"
    if (adcp->state == ADC_COMPLETE) {
        onFastAdcComplete(adcp->samples);
    }
}

Here is the call graph for this function:

adcgrpcfgFast()

AdcDevice fastAdc& adcgrpcfgFast

(

fastAdcSampleBuf

)

Referenced by portInitAdc().

Here is the caller graph for this function:

addChannel()

void addChannel	(	const char *	name,
		adc_channel_e	setting,
		adc_channel_mode_e	mode
	)

Definition at line 402 of file adc_inputs.cpp.

                                                                               {
    if (!isAdcChannelValid(setting)) {
        return;
    }
 
    adcHwChannelEnabled[setting] = mode;
 
#if EFI_USE_FAST_ADC
    if (mode == ADC_FAST) {
        fastAdc.enableChannel(setting);
        return;
    }
#endif
 
    // 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:

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 430 of file adc_inputs.cpp.

                              {
    memset(adcHwChannelEnabled, 0, sizeof(adcHwChannelEnabled));
 
    /**
     * 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.
     */
 
    addChannel("MAP", engineConfiguration->map.sensor.hwChannel, ADC_FAST);
 
    addChannel("HIP9011", engineConfiguration->hipOutputChannel, ADC_FAST);
 
    // not currently used   addChannel("Vref", engineConfiguration->vRefAdcChannel, ADC_SLOW);
 
    addChannel("AUXF#1", engineConfiguration->auxFastSensor1_adcChannel, ADC_FAST);
 
    setAdcChannelOverrides();
}

Referenced by initAdcInputs().

Here is the call graph for this function:

Here is the caller graph for this function:

fast_adc_callback()

static void fast_adc_callback ( GPTDriver *  )

static

Definition at line 169 of file adc_inputs.cpp.

                                          {
#if EFI_INTERNAL_ADC
    /*
     * Starts an asynchronous ADC conversion operation, the conversion
     * will be executed in parallel to the current PWM cycle and will
     * terminate before the next PWM cycle.
     */
    chSysLockFromISR()
    ;
    if (ADC_FAST_DEVICE.state != ADC_READY &&
    ADC_FAST_DEVICE.state != ADC_COMPLETE &&
    ADC_FAST_DEVICE.state != ADC_ERROR) {
        engine->outputChannels.fastAdcErrorsCount++;
        // todo: when? why? criticalError("ADC fast not ready?");
        // see notes at https://github.com/rusefi/rusefi/issues/6399
        chSysUnlockFromISR();
        return;
    }
 
    adcStartConversionI(&ADC_FAST_DEVICE, &adcgrpcfgFast, fastAdc.samples, ADC_BUF_DEPTH_FAST);
    chSysUnlockFromISR();
    fastAdc.conversionCount++;
#endif /* EFI_INTERNAL_ADC */
}

getAdcMode()

adc_channel_mode_e getAdcMode

(

adc_channel_e

hwChannel

)

Definition at line 228 of file adc_inputs.cpp.

                                                       {
#if EFI_USE_FAST_ADC
    if (fastAdc.isHwUsed(hwChannel)) {
        return ADC_FAST;
    }
#endif // EFI_USE_FAST_ADC
 
    return ADC_SLOW;
}

Referenced by AdcSubscription::PrintInfo().

Here is the call graph for this function:

Here is the caller graph for this function:

getAvgAdcValue()

static adcsample_t getAvgAdcValue ( int  index, adcsample_t *  samples, int  bufDepth, int  numChannels  )

static

Definition at line 85 of file adc_inputs.cpp.

                                                                                                  {
    uint32_t result = 0;
    for (int i = 0; i < bufDepth; i++) {
      adcsample_t sample = samples[index];
//    if (sample > 0x1FFF) {
//      // 12bit ADC expected right now, make this configurable one day
//      criticalError("fast ADC unexpected sample %d", sample);
//    } else
      if (sample > 0xFFF) {
        if (!engineConfiguration->skipADC12bitAssert) {
          criticalError("fast ADC unexpected sample %d. Please report and use skipADC12bitAssert to disable", sample);
        }
        engine->outputChannels.unexpectedAdcSample = sample;
        sample = sample & 0xFFF; // sad hack which works around https://github.com/rusefi/rusefi/issues/6376 which we do not understand
        engine->outputChannels.adc13bitCounter++;
      }
        result += sample;
        index += numChannels;
    }
 
    // this truncation is guaranteed to not be lossy - the average can't be larger than adcsample_t
    return static_cast<adcsample_t>(result / bufDepth);
}

Referenced by getInternalAdcValue(), and printFullAdcReport().

Here is the caller graph for this function:

getInternalAdcValue()

int getInternalAdcValue	(	const char *	msg,
		adc_channel_e	hwChannel
	)

Definition at line 201 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 (adcHwChannelEnabled[hwChannel] == ADC_FAST) {
        int internalIndex = fastAdc.internalAdcIndexByHardwareIndex[hwChannel];
// todo if ADC_BUF_DEPTH_FAST EQ 1
//      return fastAdc.samples[internalIndex];
        int value = getAvgAdcValue(internalIndex, fastAdc.samples, ADC_BUF_DEPTH_FAST, fastAdc.size());
        return value;
    }
#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 197 of file adc_inputs.cpp.

                                  {
    return mcuTemperature;
}

Referenced by populateFrame(), and updateMiscSensors().

Here is the caller graph for this function:

getSlowAdcCounter()

int getSlowAdcCounter

(

)

Definition at line 364 of file adc_inputs.cpp.

                        {
    return slowAdcCounter;
}

getVoltage()

float getVoltage	(	const char *	msg,
		adc_channel_e	hwChannel
	)

Definition at line 51 of file adc_inputs.cpp.

                                                           {
    return adcToVolts(getAdcValue(msg, hwChannel));
}

Referenced by getVoltageDivided(), AdcSubscription::PrintInfo(), printMAPInfo(), showHipInfo(), and AdcSubscription::UpdateSubscribers().

Here is the caller graph for this function:

getVoltageDivided()

float getVoltageDivided	(	const char *	msg,
		adc_channel_e	hwChannel
	)

Definition at line 46 of file adc_inputs.cpp.

                                                                  {
    return getVoltage(msg, hwChannel) * getAnalogInputDividerCoefficient(hwChannel);
}

Referenced by getAfr(), and updateRawSensors().

Here is the call graph for this function:

Here is the caller graph for this function:

initAdcInputs()

void initAdcInputs

(

)

Definition at line 452 of file adc_inputs.cpp.

                     {
    efiPrintf("initAdcInputs()");
 
    configureInputs();
 
    // migrate to 'enable adcdebug'
    addConsoleActionI("adcdebug", &setAdcDebugReporting);
 
#if EFI_INTERNAL_ADC
    portInitAdc();
 
    // Start the slow ADC thread
    slowAdcController.start();
 
#if EFI_USE_FAST_ADC
    fastAdc.init();
 
    gptStart(EFI_INTERNAL_FAST_ADC_GPT, &fast_adc_config);
    gptStartContinuous(EFI_INTERNAL_FAST_ADC_GPT, GPT_PERIOD_FAST);
#endif // EFI_USE_FAST_ADC
 
    addConsoleActionI("adc", (VoidInt) printAdcValue);
#else
    efiPrintf("ADC disabled");
#endif
}

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 306 of file adc_inputs.cpp.

                                       {
    int value = getAdcValue("print", (adc_channel_e)channel);
    float volts = adcToVoltsDivided(value, (adc_channel_e)channel);
    efiPrintf("adc voltage : %.2f", volts);
}

Referenced by initAdcInputs().

Here is the caller graph for this function:

printFullAdcReport()

void printFullAdcReport

(

void

)

Definition at line 315 of file adc_inputs.cpp.

                              {
#if EFI_USE_FAST_ADC
    efiPrintf("fast %d samples", fastAdc.conversionCount);
 
    for (int internalIndex = 0; internalIndex < fastAdc.size(); internalIndex++) {
        adc_channel_e hwIndex = fastAdc.getAdcHardwareIndexByInternalIndex(internalIndex);
 
        if (isAdcChannelValid(hwIndex)) {
            ioportid_t port = getAdcChannelPort("print", hwIndex);
            int pin = getAdcChannelPin(hwIndex);
            int adcValue = getAvgAdcValue(internalIndex, fastAdc.samples, ADC_BUF_DEPTH_FAST, fastAdc.size());
            float volts = adcToVolts(adcValue);
            /* Human index starts from 1 */
            efiPrintf(" F ch[%2d] @ %s%d ADC%d 12bit=%4d %.2fV",
                internalIndex, portname(port), pin, hwIndex - EFI_ADC_0 + 1, adcValue, volts);
        }
    }
#endif // EFI_USE_FAST_ADC
    efiPrintf("slow %d samples", slowAdcConversionCount);
 
    /* we assume that all slow ADC channels are enabled */
    for (int internalIndex = 0; internalIndex < ADC_MAX_CHANNELS_COUNT; internalIndex++) {
        adc_channel_e hwIndex = static_cast<adc_channel_e>(internalIndex + EFI_ADC_0);
 
        if (isAdcChannelValid(hwIndex)) {
            ioportid_t port = getAdcChannelPort("print", hwIndex);
            int pin = getAdcChannelPin(hwIndex);
            int adcValue = slowAdcSamples[internalIndex];
            float volts = adcToVolts(adcValue);
            /* Human index starts from 1 */
            efiPrintf(" S ch[%2d] @ %s%d ADC%d 12bit=%4d %.2fV",
                internalIndex, portname(port), pin, hwIndex - EFI_ADC_0 + 1, adcValue, volts);
        }
    }
}

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 479 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	setting
	)

Definition at line 419 of file adc_inputs.cpp.

                                                            {
    (void)name;
    if (!isAdcChannelValid(setting)) {
        return;
    }
    adcHwChannelEnabled[setting] = ADC_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 351 of file adc_inputs.cpp.

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

Referenced by initAdcInputs().

Here is the caller graph for this function:

waitForSlowAdc()

void waitForSlowAdc

(

uint32_t

lastAdcCounter

)

Definition at line 356 of file adc_inputs.cpp.

                                             {
    // we use slowAdcCounter instead of slowAdc.conversionCount because we need ADC_COMPLETE state
    // todo: use sync.objects?
    while (slowAdcCounter <= lastAdcCounter) {
        chThdSleepMilliseconds(1);
    }
}

Referenced by initHardware(), and 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 487 of file adc_inputs.cpp.

Referenced by printAdcValue(), and printFullAdcReport().

adcDebugReporting

int adcDebugReporting = false

static

Definition at line 82 of file adc_inputs.cpp.

Referenced by printFullAdcReportIfNeeded(), and setAdcDebugReporting().

adcgrpcfgFast

ADCConversionGroup adcgrpcfgFast

static

Definition at line 122 of file adc_inputs.cpp.

Referenced by fast_adc_callback().

adcHwChannelEnabled

adc_channel_mode_e adcHwChannelEnabled[HW_MAX_ADC_INDEX]

static

Definition at line 43 of file adc_inputs.cpp.

Referenced by addChannel(), configureInputs(), getInternalAdcValue(), and removeChannel().

fast_adc_config

GPTConfig fast_adc_config

static

Initial value:

= {
    GPT_FREQ_FAST,
    fast_adc_callback,
    0, 0
}

Definition at line 221 of file adc_inputs.cpp.

Referenced by initAdcInputs().

fastAdcSampleBuf

NO_CACHE adcsample_t fastAdcSampleBuf[ADC_BUF_DEPTH_FAST *ADC_MAX_CHANNELS_COUNT]

static

Definition at line 166 of file adc_inputs.cpp.

mcuTemperature

float mcuTemperature

static

Definition at line 195 of file adc_inputs.cpp.

Referenced by getMCUInternalTemperature().

slowAdcController

SlowAdcController slowAdcController

static

Definition at line 450 of file adc_inputs.cpp.

Referenced by initAdcInputs().

slowAdcConversionCount

uint32_t slowAdcConversionCount = 0

static

Definition at line 312 of file adc_inputs.cpp.

Referenced by printFullAdcReport().

slowAdcCounter

uint32_t slowAdcCounter = 0

static

Definition at line 79 of file adc_inputs.cpp.

Referenced by getSlowAdcCounter(), and waitForSlowAdc().

slowAdcErrorsCount

uint32_t slowAdcErrorsCount = 0

static

Definition at line 313 of file adc_inputs.cpp.

slowAdcSamples

NO_CACHE adcsample_t slowAdcSamples[SLOW_ADC_CHANNEL_COUNT]

static

Definition at line 41 of file adc_inputs.cpp.

Referenced by getInternalAdcValue(), and printFullAdcReport().

Go to the source code of this file.