「ESP32の性能を100%引き出すために『ESP-IDF』を使ってみたいけれど、環境構築が難しそう…」と躊躇していませんか?
確かに以前はコマンドラインでのセットアップが主流で少しハードルが高かったESP-IDFですが、現在はVS Code(Visual Studio Code)の公式拡張機能を使うことで、驚くほどスムーズに開発を始めることができます。
今回は、VS CodeにESP-IDF拡張機能を導入し、サンプルプロジェクト「Blink(Lチカ)」をビルドしてESP32へ書き込むまでの全手順をわかりやすく解説します!
開発を始める前の準備(前提ツール)
まずはお使いのPCに以下のベースツールがインストールされているか確認しておきましょう。
-
Visual Studio Code(VS Code)
-
Git
-
Python 3.10以上
-
データ通信対応のUSBケーブル(充電専用ケーブルではマイコンが認識されません)
-
ESP32開発ボード
Step 1:ESP-IDF 拡張機能のインストール
VS Codeを起動し、公式の環境構築ツールを追加します。
-
VS Code左側のサイドバーから 「拡張機能」アイコン(
Ctrl+Shift+X/Cmd+Shift+X)を開きます。 -
検索窓に
ESP-IDFと入力します。 -
Espressif Systems公式の 「ESP-IDF Extension」 を見つけ、「インストール」 をクリックします。
Step 2:ESP-IDF ツールの初期セットアップ
拡張機能がインストールされたら、コンパイラやSDK本体(ESP-IDF)を自動ダウンロードしてセットアップします。
-
コマンドパレットを開きます(
F1キー またはCtrl+Shift+P/Cmd+Shift+P)。 -
ESP-IDF: Configure ESP-IDF Extensionと入力して選択します。 -
セットアップ方法の選択画面が出たら 「EXPRESS」(推奨設定)をクリックします。
-
設定項目を確認します:
-
Download Server:
EspressifまたはGitHubを選択 -
ESP-IDF Version: 最新の安定版(
v5.x系推奨)を選択
-
-
「Install」 ボタンをクリックするとダウンロードとビルドツールのセットアップが始まります(回線速度によりますが数分〜十数分かかります)。
画面下に「ESP-IDF has been configured」と表示されれば初期セットアップ完了です!
Step 3:サンプルプロジェクト(Blink)の生成
動作確認のために、マイコンのLEDを点滅させる定番サンプル「Blink」を生成してみましょう。
-
コマンドパレットを開き、
ESP-IDF: Create Project from Extension Templateを選択します。 -
インストールしたESP-IDFのバージョンを選択します。
-
テンプレート一覧から
get-started>blinkを選択します。 -
「Create project using template blink」 をクリックし、プロジェクトを保存するフォルダを選びます。
-
「新しいウィンドウで開きますか?」と聞かれたら「Yes」を選択します。
Step 4:ターゲットマイコンとCOMポートの設定
接続したESP32に合わせて開発ターゲットを設定します。設定はVS Code最下部の「ステータスバー」を使うと非常に簡単です。
-
ターゲットデバイスの設定
-
ステータスバーにある
[ESP32]と書かれた領域(またはコマンドパレットのESP-IDF: Set Espressif Device Target)をクリック。 -
使用するチップ(
esp32,esp32s3,esp32c3など)を選択します。
-
-
COMポート(通信ポート)の設定
-
ESP32をUSBでPCに接続します。
-
ステータスバーのプラグマーク(
ESP-IDF: Select Port to Use)をクリック。 -
認識されたCOMポート(Windowsなら
COM3等、Mac/Linuxなら/dev/ttyUSB0等)を選択します。
-
Step 5:ビルド・書き込み・シリアルモニターの実行
準備が整ったら、ワンクリックでプログラムを実行してみましょう! ステータスバーにある以下のアイコンを使用します。
-
ビルド(コンパイル): シリンダー(炎)アイコン をクリック
-
初回ビルドは数分かかりますが、2回目以降は変更点のみ高速にビルドされます。
-
-
書き込み(Flash): イナズマアイコン をクリック
-
通信方式を聞かれた場合は「UART」を選択します。
-
-
シリアルモニター: PCモニターアイコン をクリック
-
ESP32のログ出力(
Hello WorldやBlinking LED...)がターミナルに表示されます。
-
裏技(時短テクニック): ステータスバーにある 再生(▶)アイコン(Build, Flash and Monitor) をクリックすると、「ビルド ➔ 書き込み ➔ シリアルモニター起動」 の全プロセスを自動で一括実行してくれます!
つまずきやすいポイントと対処法
Q1. 書き込み時に Failed to connect to ESP32 と出る
-
ESP32ボードによっては、書き込み開始時に手動で「書き込みモード」に入る必要があります。
-
ログに
Connecting...と表示されたタイミングで、ボード上のBOOT(またはIO0)ボタンを長押し してみてください。
Q2. シリアルポート(COMポート)が見つからない
-
充電専用USBケーブルを使っていませんか?通信用ケーブルに差し替えてみてください。
-
CP210x や CH340 などの「USB-UART変換ドライバ」がPCにインストールされているか確認してください。
まとめ
VS CodeのESP-IDF拡張機能を使えば、面倒な環境変数の設定やコマンドライン操作なしで、直感的に公式SDK開発を始めることができます。
一度この環境を整えてしまえば、FreeRTOSを活用したマルチタスク処理や、Bluetooth/Wi-Fiを使った本格的なIoT開発も自由自在です。ぜひ「Blink」を皮切りに、ESP32の真の性能を体験してみてください!