====== analogReadAvg() ======

''analogReadAvg()'' returns an integer average of multiple input values.

{{:en-us_commands:reference:analogreadavg.svg?900|analogReadAvg command operation flow}}

''int32_t analogReadAvg(uint8_t ch, uint8_t samples)''

===== Commands =====

^ Command ^ Arguments ^ Return Value ^ Operation ^
| ''analogReadAvg(ch, samples)'' | ''uint8_t ch''\\ ''uint8_t samples'' — Number of averaging samples | ''int32_t'' | Returns an integer average of multiple input values. |


===== Example =====

<code cpp>
void setup() {
  Serial.begin(115200);
}

void loop() {
  int ai0 = analogRead(0);  // Read the raw analog value of the specified channel.
  int ai4 = analogRead(4);  // Read the raw analog value of the specified channel.
  int32_t avg0 = analogReadAvg(0, 5);  // Return the integer average of multiple input values.
  float avg0f = analogReadAvgf(0, 5);  // Return the floating-point average of multiple input values.

  Serial.print("AI0: ");
  Serial.println(ai0);

  Serial.print("AI4: ");
  Serial.println(ai4);

  Serial.print("AI0 AVG: ");
  Serial.println(avg0);

  Serial.print("AI0 AVG float: ");
  Serial.println(avg0f, 2);

  delay(500);
}
</code>

===== Precautions =====

  * First check the supported channels and module DIP switch input ranges for the product.
  * Do not use error constants as normal measurements.
  * Increasing the sample count slows response and increases memory usage.
  * MPINO ''A0'' and MPAINO ''0'' do not identify the same physical input. Recheck arguments when changing product families.

===== Built-in Commands in the Same Category =====

  * [[:en-us_commands:reference:analogreadinit|analogReadInit() View detailed description]]
  * [[:en-us_commands:reference:analogread|analogRead() View detailed description]]
  * [[:en-us_commands:reference:analogreadavgf|analogReadAvgf() View detailed description]]

[[:en-us_commands:builtin|← Built-in Command List]]