Detailed Description

Low level ADC code.

Date: Jan 14, 2013

Author: Andrey Belomutskiy, (c) 2012-2020

Functions
float BOARD_WEAK	getAnalogInputDividerCoefficient (adc_channel_e)

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	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 uint32_t	slowAdcErrorsCount = 0

static float	mcuTemperature

static AdcChannelMode	adcHwChannelMode [EFI_ADC_TOTAL_CHANNELS]

static int	adcDebugReporting = false

static SlowAdcController	slowAdcController

	adc_channel_e

Function Documentation

◆ attribute()

__attribute__ ( (weak) )

Definition at line 173 of file adc_inputs.cpp.

173 { }

◆ addFastAdcChannel()

void addFastAdcChannel	(	const char *	name,
		adc_channel_e	hwChannel
	)

Definition at line 145 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:

◆ 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 175 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);
  
     addFastAdcChannel("HIP9011", engineConfiguration->hipOutputChannel);
  
     // 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 37 of file adc_inputs.cpp.

                                                    {
     return adcHwChannelMode[hwChannel];
 }

Referenced by AdcSubscription::PrintInfo().

Here is the caller graph for this function:

◆ getAnalogInputDividerCoefficient()

float BOARD_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 45 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 41 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 205 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
     // 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
 }

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

 {
     if (isAdcChannelValid(hwChannel)) {
         ioportid_t port = getAdcChannelPort("print", hwChannel);
         int pin = getAdcChannelPin(hwChannel);
         int adcValue = getAdcValue("print", hwChannel);
         float volts = getVoltage("print", hwChannel);
         float voltsDivided = getVoltageDivided("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, voltsDivided);
     }
 }

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 60 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 value = getAdcValue("print", (adc_channel_e)channel);
     float volts = adcToVoltsDivided(value, (adc_channel_e)channel);
     efiPrintf("adc %d voltage : %.3f", channel, volts);
 }

Referenced by initAdcInputs().

Here is the caller graph for this function:

◆ printFullAdcReport()

void printFullAdcReport ( void )

Definition at line 87 of file adc_inputs.cpp.

                               {
 #if EFI_USE_FAST_ADC
     efiPrintf("fast %lu samples", fastAdc.conversionCount);
  
     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 230 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 158 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 107 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 195 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);
     }
 }