====== analogRead() ======

''analogRead()''は指定したチャネルの生のアナログ値を読み取ります。

{{:ja-jp_commands:reference:analogread.svg?900|analogRead コマンドの動作フロー}}

''int analogRead(uint8_t pin)''

===== コマンド =====

^ コマンド ^ 引数 ^ 戻り値 ^ 動作 ^
| ''analogRead(pin)'' | ''uint8_t pin'' — MPAINOでは''0'' ~ ''19''をアナログ入力モジュール全体のチャネル番号として使用 | ''int'' | 指定したチャネルの生のアナログ値を読み取ります。 |


===== 使用例 =====

MPAINO-8A8R(T)にX入力モジュールを2台接続し、Arduino IDEで**Analog Input Module → X2**を選択した例です。X1のCH0は''0''、X2のCH0は''4''です。

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

void loop() {
  const int first = analogRead(0);  // X1 CH0のアナログ原始値を読み取ります。
  const int second = analogRead(4);  // X2 CH0のアナログ原始値を読み取ります。
  Serial.print(F("X1 CH0: "));
  Serial.println(first);
  Serial.print(F("X2 CH0: "));
  Serial.println(second);
  delay(500);
}
</code>

===== 注意事項 =====

  * MPAINOの''analogRead(0~19)''の戻り値は電圧・電流・温度単位に変換した値ではなく、ADS1118の生ADC値です。
  * 4~20mA用途でソフトウェアカットと断線判定が必要な場合、MPINOでは''analogRead2(Aピン)''、MPAINOでは''analogRead2(モジュールチャネル)''を使用します。
  * サンプリング速度は''analogReadInit(sps)''で設定できます。未設定の場合は''analogRead()''の既定値に従います。
  * 平均サンプル数は最大''20''です。''samples = 0''またはメモリ確保に失敗した場合、現在の生値を返します。
  * 両方の平均関数を使うとそれぞれ別の動的バッファを確保するため、SRAM使用量が増加します。
  * MPAINOアナログ入力モジュールのDIPスイッチと実際の配線は入力種類と一致させてください。

===== 同じカテゴリの内蔵コマンド =====

  * [[:ja-jp_commands:reference:analogreadinit|analogReadInit() 詳細説明を見る]]
  * [[:ja-jp_commands:reference:analogreadavg|analogReadAvg() 詳細説明を見る]]
  * [[:ja-jp_commands:reference:analogreadavgf|analogReadAvgf() 詳細説明を見る]]

[[:ja-jp_commands:builtin|← 内蔵コマンド一覧]]