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

''analogReadAvg()''는 여러 입력값의 정수 평균을 반환합니다.

{{:commands:reference:analogreadavg.svg?900|analogReadAvg 명령어 동작 흐름}}

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

===== 명령어 =====

^ 명령어 ^ 인수 ^ 반환값 ^ 동작 ^
| ''analogReadAvg(ch, samples)'' | ''uint8_t ch''\\ ''uint8_t samples'' — 평균 샘플 수 | ''int32_t'' | 여러 입력값의 정수 평균을 반환합니다. |


===== 예제 =====

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

void loop() {
  int ai0 = analogRead(0);  // 지정한 채널의 원시 아날로그값을 읽습니다.
  int ai4 = analogRead(4);  // 지정한 채널의 원시 아날로그값을 읽습니다.
  int32_t avg0 = analogReadAvg(0, 5);  // 여러 입력값의 정수 평균을 반환합니다.
  float avg0f = analogReadAvgf(0, 5);  // 여러 입력값의 실수 평균을 반환합니다.

  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>

===== 주의사항 =====

  * 제품별 지원 채널과 모듈 딥스위치 입력 범위를 먼저 확인합니다.
  * 오류 상수를 정상 측정값으로 사용하지 않습니다.
  * 샘플 수를 크게 설정하면 응답이 느려지고 메모리 사용량이 증가합니다.
  * MPINO의 ''A0''와 MPAINO의 ''0''은 같은 물리 의미가 아니므로 제품군 변경 시 인자를 다시 확인합니다.

===== 같은 카테고리의 내장 명령어 =====

  * [[commands:reference:analogreadinit|analogReadInit() 상세 설명 보기]]
  * [[commands:reference:analogread|analogRead() 상세 설명 보기]]
  * [[commands:reference:analogreadavgf|analogReadAvgf() 상세 설명 보기]]

[[commands:builtin|← 내장 명령어 리스트]]