ブログ
ESP32のインストール：ボード、IDE、ライブラリ
Arduino IDEとVS CodeにESP32のボードパッケージとライブラリをインストールする方法。最初の点滅まで進めずに止まってしまうセットアップの疑問を解消します。
ESP32をインストールするには？
ボードパッケージをインストールすれば、IDEはそのチップを認識します。Arduino IDEなら、File → Preferencesを開き、https://dl.espressif.com/dl/package_esp32_index.jsonを「Additional Boards Manager URLs」に貼り付け、Tools → Board → Boards Managerで「esp32」を検索して、「esp32 by Espressif Systems」をインストールします。この1パッケージでWROOM-32D、S3、C3をすべてカバーできます。私のWindowsマシンでは初回インストールに約4分かかりましたが、コンパイラーがキャッシュされるので2回目以降はもっと速いです。インストール後はIDEを再起動しましょう。ボード一覧は再起動で更新されるので、これを省略すると「インストールに失敗した」と勘違いする人が多いです。Arduino IDE FAQに、同じ手順と落とし穴をまとめています。
ESP32をArduinoに追加するには？
「追加」と「インストール」は同じ操作です。Boards Managerからパッケージをインストールすることで、そのボードが「追加」されます。EspressifのJSON URLを「Additional Boards Manager URLs」に貼り付け、インストールして、再起動。この再起動だけで、「まだ表示されない」という報告の半分は解決します。
ESP32をArduinoにインストールするには？
「追加」と同じ意味です。Espressifのボードパッケージには、すべてのESP32バリアントが定義されています。インストール後は、Tools → Board → ESP32 Arduino → ESP32 Dev Moduleで確認できます。サブメニューが表示されない場合は、何よりも先に再インストールと再起動を試しましょう。
Arduino 2.0にESP32をインストールするには？
Arduino IDE 2.xでも、「Additional Boards Manager URLs」欄はFile → Preferencesにあります。2.xはパッケージごとの進捗を表示し、パッケージを並行インストールします。古いパッケージが新しいものを上書きしてしまうため、1.8.xからアップグレードするときは、先に古いESP32のエントリーをアンインストールしてください。この点さえ押さえれば、ほとんど問題なく動きます。
ESP32のライブラリをインストールするには？
Sketch → Include Library → Manage Librariesで検索してインストールします。ライブラリはボードごとではなくIDEごとにインストールされる点に注意。ESP32コアにはWiFi、BLE、esp32-halなどの内蔵ライブラリが付属するので、「ライブラリが見つからない」エラーは、たいていインストール不足ではなくインクルードパスの問題です。サードパーティ製ライブラリは、ボードパッケージが入っていればすぐに表示されます。
VS CodeでESP32を使うには？
2つの方法があります。1つ目はPlatformIO拡張機能。インストールしてプロジェクトを作り、ボードに「Espressif ESP32 Dev Module」を選ぶと、初回ビルドでツールチェーンがダウンロードされます。私は毎日これを使っています。ライブラリはプロジェクトごとに管理されます。2つ目は、Arduino拡張機能＋先ほどインストールしたボードパッケージの組み合わせ。初回ビルドは約500MBのツールチェーンを取得するので、遅い回線だと固まったように見えますが、そうではありません。待ちましょう。PlatformIO FAQにプロジェクト構成の解説があります。
「Downloading packages」でインストールが失敗するのはなぜ？
原因はたいていファイルではなくネットワークです。プロキシやVPNがダウンロードを途中で壊してしまい、IDEは最初からやり直します。対策は、ステージングフォルダーを削除して再試行、有線接続に切り替える、プロキシを解除する、手動インストールする、のいずれかです。手動インストールの手順はIDEのバージョンごとに異なり、公式ドキュメントも曖昧なので、多くの人はネットワーク経由で再試行します。
VS CodeとArduino IDEの両方必要？
いいえ。どちらか1つで十分です。Arduino IDEはやさしい道、PlatformIOはデバッグ機能とプロジェクト単位のライブラリを持つエンジニアリングの道。どちらでもコードは同じC++です。
代わりにMicroPythonをインストールする場合は？
インストール方法は変わりますが、ハードウェアは同じです。esptoolでフラッシュを消去してから、MicroPythonのファームウェアバイナリをアドレス0x1000に書き込みます。この時点でArduinoのボードパッケージは無関係になります。MicroPythonはArduinoツールチェーンを一切使いません。Pythonが好きならおすすめですが、代償としてセンサーライブラリの網羅性は弱めです。正直なところ、プロジェクト次第ですね。
インストールが成功したら、次は？
点滅です。Blinkスケッチをアップロードして、シリアルモニターを眺め、それからGPIO2にLEDを配線しましょう。この「インストール → 書き込み → 出力を見る」のループこそ、実践的な「インストール」の大半です。あとで動かなくなったときの復旧手順は書き込みFAQにあります。