adc: try to clean naming mess: getVoltageDivided() rename to adcGetScaledVoltage()

firmware/console/status_loop.cpp

@@ -501,12 +501,12 @@ static void updateRawSensors() {
 	for (int i = 0; i < LUA_ANALOG_INPUT_COUNT; i++) {
 		adc_channel_e channel = engineConfiguration->auxAnalogInputs[i];
 		if (isAdcChannelValid(channel)) {
-			engine->outputChannels.rawAnalogInput[i] = getVoltageDivided("raw aux", channel);
+			engine->outputChannels.rawAnalogInput[i] = adcGetScaledVoltage("raw aux", channel);
 		}
 	}
 
 	// TODO: transition AFR to new sensor model
-	engine->outputChannels.rawAfr = (engineConfiguration->afr.hwChannel == EFI_ADC_NONE) ? 0 : getVoltageDivided("ego", engineConfiguration->afr.hwChannel);
+	engine->outputChannels.rawAfr = (engineConfiguration->afr.hwChannel == EFI_ADC_NONE) ? 0 : adcGetScaledVoltage("ego", engineConfiguration->afr.hwChannel);
 }
 static void updatePressures() {
 	engine->outputChannels.baroPressure = Sensor::getOrZero(SensorType::BarometricPressure);

firmware/controllers/sensors/impl/ego.cpp

@@ -30,7 +30,7 @@ float getAfr(SensorType type) {
 		return 0;
 	}
 
-	float volts = getVoltageDivided("ego", type == SensorType::Lambda1 ? sensor->hwChannel : sensor->hwChannel2);
+	float volts = adcGetScaledVoltage("ego", type == SensorType::Lambda1 ? sensor->hwChannel : sensor->hwChannel2);
 
 	return interpolateMsg("AFR", sensor->v1, sensor->value1, sensor->v2, sensor->value2, volts)
 			+ engineConfiguration->egoValueShift;

firmware/hw_layer/adc/adc_external.h

@@ -11,6 +11,8 @@
 
 #include "mcp3208.h"
 
+/* 12 bits, 5V reference */
+#define adcRawToScaledVoltage(adc) (5.0f / 4095 * (adc))
+
 #define adcGetRawValue(channel) getMcp3208adc(channel)
-#define adcToVoltsDivided(adc) (5.0f / 4095 * (adc))
-#define getVoltageDivided(msg, channel) (isAdcChannelValid(channel) ? adcToVoltsDivided(adcGetRawValue(msg, channel), channel) : 66.66)
+#define adcGetScaledVoltage(msg, channel) (isAdcChannelValid(channel) ? adcToVoltsDivided(adcGetRawValue(msg, channel), channel) : 66.66)

firmware/hw_layer/adc/adc_inputs.cpp

@@ -75,12 +75,12 @@ static void printAdcChannedReport(const char *prefix, int internalIndex, adc_cha
 		int pin = getAdcChannelPin(hwChannel);
 		int adcValue = adcGetRawValue("print", hwChannel);
 		float volts = adcGetRawVoltage("print", hwChannel);
-		float voltsDivided = getVoltageDivided("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, voltsDivided);
+			adcValue, volts, voltsInput);
 	}
 }
 
@@ -240,7 +240,8 @@ __attribute__((weak)) float adcGetRawVoltage(const char*, adc_channel_e) {
 	return 0;
 }
 
-__attribute__((weak)) float getVoltageDivided(const char*, adc_channel_e) {
+// voltage in ECU universe, with all input dividers and OpAmps gains taken into account, voltage at ECU connector pin
+__attribute__((weak)) float adcGetScaledVoltage(const char*, adc_channel_e) {
 	return 0;
 }
 

firmware/hw_layer/adc/adc_inputs_onchip.cpp

@@ -34,8 +34,8 @@ float adcGetRawVoltage(const char *msg, adc_channel_e hwChannel) {
 	return adcToRawVolts(adcGetRawValue(msg, hwChannel));
 }
 
-// Board voltage, with divider coefficient accounted for
-float getVoltageDivided(const char *msg, adc_channel_e hwChannel) {
+// voltage in ECU universe, with all input dividers and OpAmps gains taken into account, voltage at ECU connector pin
+float adcGetScaledVoltage(const char *msg, adc_channel_e hwChannel) {
 	return adcGetRawVoltage(msg, hwChannel) * getAnalogInputDividerCoefficient(hwChannel);
 }
 

firmware/hw_layer/algo/adc_math.h

@@ -24,5 +24,6 @@
 // voltage in MCU universe, from zero to Vref
 float adcGetRawVoltage(const char *msg, adc_channel_e channel);
 
-float getVoltageDivided(const char *msg, adc_channel_e channel);
+// voltage in ECU universe, with all input dividers and OpAmps gains taken into account, voltage at ECU connector pin
+float adcGetScaledVoltage(const char *msg, adc_channel_e channel);
 

simulator/simulator/boards.cpp

@@ -20,7 +20,7 @@ float adcGetRawVoltage(const char *msg, adc_channel_e hwChannel) {
 	return adcToRawVolts(adcGetRawValue(msg, hwChannel));
 }
 
-// Board voltage, with divider coefficient accounted for
-float getVoltageDivided(const char *msg, adc_channel_e hwChannel) {
+// voltage in ECU universe, with all input dividers and OpAmps gains taken into account, voltage at ECU connector pin
+float adcGetScaledVoltage(const char *msg, adc_channel_e hwChannel) {
 	return adcGetRawVoltage(msg, hwChannel) * engineConfiguration->analogInputDividerCoefficient;
 }

unit_tests/boards.cpp

@@ -17,6 +17,6 @@ float adcGetRawVoltage(const char *msg, adc_channel_e hwChannel) {
 	return 0;
 }
 
-float getVoltageDivided(const char *msg, adc_channel_e hwChannel) {
+float adcGetScaledVoltage(const char *msg, adc_channel_e hwChannel) {
 	return 0;
 }