なぜAIでArduinoコードを書くのか

Arduinoの文法自体はシンプルですが、pinModeの設定漏れ、割り込みでのvolatile忘れ、センサのデータシート特有の計算式など、
「知らないと詰まる」細部が多いのも事実です。AIはこうした定型知識の補完に強く、アイデアを電気信号に変換するまでの時間を大幅に短縮してくれます。
基本文法や関数の正確な仕様は、最終的にはArduino公式の言語リファレンス↗で裏取りするのが確実です。

ただし、AIが出力したコードをそのまま書き込むのは推奨しません。目的は「AIに書かせて終わり」ではなく、生成されたコードを読み解き、自分の回路とすり合わせる力を身につけることです。
本記事はその実践トレーニングでもあります。

• 定型処理の高速化 ― センサ初期化、ライブラリの呼び出し方など
• 設計のたたき台作り ― 状態遷移やピン配置の初期案
• デバッグの壁打ち相手 ― エラーメッセージを貼るだけで原因の仮説が返る

良いプロンプトの設計図

AIへの指示が曖昧だと、動作要件が抜けたコードが返ってきます。Arduino向けプロンプトには、最低限次の4要素を含めるのがコツです。

実際に使ったプロンプトはこちらです。ピン配置と測定原理はHC-SR04のデータシート↗を先に読んでから組み立てました。

生成されたスケッチ全文

上のプロンプトに対してAIが返した実際のコードです。次のセクションで、このコードをブロックごとに解説していきます。

// 超音波距離センサによる接近警告システム
// ボード: Arduino Uno / センサ: HC-SR04
const int TRIG_PIN = 9;
const int ECHO_PIN = 10;
const int BUZZER_PIN = 8;
const int LED_PIN = 7;
const int THRESHOLD_CM = 20;      // 警告を出す距離のしきい値
const unsigned long BLINK_INTERVAL = 200;  // LED点滅の間隔(ms)
const unsigned long PRINT_INTERVAL = 500;  // シリアル表示の間隔(ms)
unsigned long lastBlinkTime = 0;
unsigned long lastPrintTime = 0;
bool ledState = false;
void setup() {
  pinMode(TRIG_PIN, OUTPUT);
  pinMode(ECHO_PIN, INPUT);
  pinMode(BUZZER_PIN, OUTPUT);
  pinMode(LED_PIN, OUTPUT);
  Serial.begin(9600);
}
float measureDistanceCm() {
  digitalWrite(TRIG_PIN, LOW);
  delayMicroseconds(2);
  digitalWrite(TRIG_PIN, HIGH);
  delayMicroseconds(10);
  digitalWrite(TRIG_PIN, LOW);
  long duration = pulseIn(ECHO_PIN, HIGH, 30000);
  if (duration == 0) return -1;  // タイムアウト（未検出）
  return duration * 0.0343 / 2.0;
}
void loop() {
  unsigned long now = millis();
  float distance = measureDistanceCm();
  bool isAlert = (distance > 0 && distance < THRESHOLD_CM);
  if (isAlert) {
    digitalWrite(BUZZER_PIN, HIGH);
    if (now - lastBlinkTime >= BLINK_INTERVAL) {
      lastBlinkTime = now;
      ledState = !ledState;
      digitalWrite(LED_PIN, ledState);
    }
  } else {
    digitalWrite(BUZZER_PIN, LOW);
    digitalWrite(LED_PIN, LOW);
    ledState = false;
  }
  if (now - lastPrintTime >= PRINT_INTERVAL) {
    lastPrintTime = now;
    Serial.print("Distance: ");
    Serial.print(distance);
    Serial.println(" cm");
  }
}

コード解説：ブロック単位で読む

AIが生成したコードは「動く」だけでなく「なぜそう書かれているか」まで理解して初めて自分の資産になります。ブロックごとに見ていきましょう。

① 定数とピン定義

② millis()による時間管理変数

③ measureDistanceCm() ― センサ計測の関数化

④ loop() ― 状態判定とノンブロッキング点滅

AI生成コードにありがちな落とし穴

便利な一方で、AIの出力は「もっともらしいが実機では動かない」ことも珍しくありません。代表的な注意点をまとめます。

これらは「動かしてみないと分からない」ものが多いため、次のステップである実機検証が欠かせません。

実機で検証し、対話で直す

書き込んで終わりではなく、Arduino IDEのシリアルモニタで実測値を見ながら、期待通りに動いているかを確認します。
うまくいかない場合は、エラーメッセージやおかしな挙動をそのままAIに伝えるのが最短ルートです。

このように「症状」を具体的に伝えると、AIは該当ブロックだけを修正した差分を返してくれます。全部を書き直させるのではなく、
問題箇所を絞り込んで対話することが、AI活用と自力デバッグ力の両方を伸ばすコツです。

まとめ：次に試すこと

AIはArduinoコードの「下書き」を高速に用意してくれますが、最終的に回路を安定して動かすのは、コードを読み解き検証する人間の理解です。
本記事のワークフロー（プロンプト設計 → 生成 → 解説読解 → 実機検証 → 対話修正）を繰り返すことで、AIと組む開発速度はどんどん上がっていきます。

• 状態機械への拡張：警告レベルを多段階にし、enumで状態を管理させてみる
• 無線化：ESP32へ移植し、検知結果をWi-Fi経由でスマホに通知するようAIに依頼する
• 省メモリ化：F()マクロの活用など、AIにメモリ最適化案を出させて比較する