01書き込みエラーは「原因が一つとは限らない」から厄介である

結論から言えば、Arduinoの書き込みエラーは「これさえ確認すれば必ず直る」という単一の原因があるわけではない。ボード・ポートの選択ミス、USBケーブルの不良、配線の問題、ブートローダーの種類など、複数の候補を一つずつ切り分けていく必要がある。闇雲に「アップロード」ボタンを連打しても、多くの場合は解決しない。

実例として、Arduinoで「avrdude: stk500_recv(): programmer is not responding」というエラーに遭遇し、原因を特定した記録がある。Arduinoで書き込みエラー：programmer is not responding（Qiita）では、Arduinoに接続していたものをすべて外してマイコンだけで書き込みを試したところ成功し、原因はBLEモジュールなどでD0(RX)ピンやD1(TX)ピンに頻繁にアクセスするコードを書いていたことや、これらのピンとの交信中に書き込みを行おうとしたことにあったと判明している。

編集部見解:書き込みエラーは、初心者にとっては「何が悪いのか全く分からない」不安を感じやすいトラブルである。しかし実際には、候補となる原因はある程度パターン化されている。焦って何度も試すより、候補を一つずつ確実に潰していく方が結果的に早く解決することが多いと考えられる。
― YOFUKASI AI編集部

本記事では、書き込みエラーの背景にあるavrdudeの仕組みから、代表的な原因と対処法、そして実際にエラーを切り分ける手順までを、初心者から中級者を対象に体系的に解説する。

02avrdudeとエラーメッセージの基礎知識

Arduino IDEでスケッチを書き込む際、内部ではavrdudeというプログラムが実際の書き込み処理を担っている。書き込みエラーの多くは、このavrdudeが出力するメッセージとして表示される。代表的なものにprogrammer is not respondingやnot in syncがある。

用語の整理

• avrdude:AVRマイコンにプログラムを書き込むためのツール。Arduino IDEが内部で利用している。
• ブートローダー:マイコンの起動時に動作する小さなプログラムで、新しいスケッチの書き込みを受け付ける役割を持つ。
• verbose output(詳細出力):通常は省略されている詳しいログ情報。原因調査に役立つ。

書き込みエラーへの一次対応は、公式のヘルプセンターでも整理されている。‘Error: avrdude’ when uploading（Arduino Help Center）では、正しいボードとポートがTools>BoardおよびTools>Portで選択されているかを確認すること、他のArduino IDEのインスタンスやシリアルモニタなどポートを使用している可能性のあるソフトウェアを閉じること、ボードのRESETボタンを押してみること、USBケーブルやポートを変えて試すことなどが案内されている。

Arduino IDE自体のインストールや基本操作をもう一度確認したい場合は、以下の記事も参考になる。Arduino IDEのダウンロード・インストール方法はこちらの記事で解説している。

03なぜ書き込みが失敗するのか、仕組みと技術的背景

書き込みが失敗する背景には、ブートローダーとの「同期」のタイミングが関わっている場合がある。パソコン側とマイコン側の通信タイミングが合わないと、avrdudeはnot in syncというエラーを返す。

実際にこのエラーの原因を配線ミスとして特定した記録がある。Arduinoに書き込めない問題を修正する方法[not in sync]（Memoteki）では、ATmega328Pのマイコン単体をブレッドボード上で使用した際に、リセットピンの接続方法が誤っていたために書き込みができなかったことが原因だったと説明されている。ブレッドボード上でマイコン単体を扱う場合、既製のArduinoボードでは自動的に処理されているリセット回路を自分で正しく組む必要がある点に注意したい。

実際に、Old Bootloaderへの切り替えで解決したという報告もある。ArduinoNanoに書き込めない時の解決方法（めかとろな日々）では、Arduino IDEのツール＞プロセッサを開き、ATmega328P(Old Bootloader)を選択することで解決することが多いと説明されている。

Arduino本体の各ピンの役割やブートローダーの位置づけをもう一度確認したい場合は、以下の記事も参考になる。Arduinoメインボード徹底解説はこちらの記事で紹介している。

04対処法の比較と選択肢

書き込みエラーへの対処法は、エラーの状況によって効果が変わる。以下に3つの代表的な対処法を整理する。

※各対処法の効果は状況によって異なり、複数を組み合わせて切り分ける必要がある場合が多い。公式の対処手順はIf your sketch doesn’t upload（Arduino Help Center）を参照。

初めて遭遇したエラーであれば、まずA案(ボード・ポートの再確認)から試すのが基本になる。Nano系のボードで発生している場合はB案、周辺機器を接続した状態で発生している場合はC案を試すと、原因の切り分けが早く進みやすい。

05実践:書き込みエラーを切り分ける5ステップ

ここでは「スケッチのアップロード時にavrdudeのエラーが表示された」という状況を題材に、原因を切り分ける具体的な手順を示す。

1. STEP1. エラーメッセージの種類を確認する

   表示されたメッセージが「programmer is not responding」なのか「not in sync」なのか、あるいは「no upload port provided」なのかを確認する。メッセージの種類によって疑うべき候補が変わる。

   実例:「avrdude: stk500_recv(): programmer is not responding」というメッセージを確認した。
2. STEP2. ボード・ポートの選択を再確認する

   「ツール」メニューでボードの種類とポートが正しく選択されているか確認する。他のシリアルモニタやソフトウェアがポートを使用していないかも確認する。

   実例:シリアルモニタを開いたままアップロードしようとしていたため、一度閉じてから再度アップロードを試した。
3. STEP3. D0・D1ピンの接続を確認する

   D0(RX)・D1(TX)ピンに他のデバイスが接続されていないか確認する。接続されている場合は、一時的に外してから書き込みを試す。

   実例:BluetoothモジュールをD0・D1ピンに直結していたため、一時的に配線を外してアップロードしたところ成功した。
4. STEP4. Nano系ボードならブートローダー設定を確認する

   Arduino Nanoやその互換機を使っている場合、「ツール」→「プロセッサ」で「ATmega328P (Old Bootloader)」への切り替えを試す。

   実例:互換Nanoボードでエラーが解消しなかったため、プロセッサ設定をOld Bootloaderに変更したところ書き込みに成功した。
5. STEP5. 詳細出力を有効にしてログを確認する

   「ファイル」→「環境設定」で「書き込み」の詳細出力を有効にし、再度アップロードして表示されるログを確認する。

   実例:詳細出力を有効にしたところ、特定のCOMポートで応答がないことがログから読み取れ、USBケーブルの交換で解決した(編集部想定シナリオ)。

Arduinoの基礎的なコードの書き方や、書き込み前のコンパイル確認についてもう一度確認したい場合は、以下の記事も参考になる。

Arduinoのコードの書き方の基礎はこちらの記事で詳しく解説している。

06注意点・よくある誤解

07FAQ