EIM-CLI を用いた ESP-IDF のセットアップ (Windows11 with ESP-IDF Installation Manager (EIM-CLI))

Espresiff のマニュアル を参考にして Windows11 に ESP-IDF 環境をインストールする．およそ 10 GB のディスク容量を消費する．

インストール中に，残り時間が「数時間」と出ることがあるが，たいていの場合は 30 分程度でインストールが完了する． 「数時間」と表示されても慌てず騒がず待って欲しい．

準備

VS code，Git，Python がインストールされているか確認する．もしインストールされていないときは，ESP-IDF をインストールする前に VS code，git, python をインストールすること．

インストールされているか確認するためには，PowerShell を立ち上げ，以下のようにコマンドを実行してみる． Python や git のバージョンが表示されれば OK である．

> python --version
Python 3.13.12

> git -v
git version 2.53.0.windows.2

> code -v
1.113.0
cfbea10c5ffb233ea9177d34726e6056e89913dc
x64

もしインストールされていなければ，VS Code, Python, Git のホームページから インストーラーをダウンロードして実行しても良いが，PowerShell 上で winget コマンドでインストールするのが簡単である． その場合は，Windows PowerShell を「管理者権限」で起動し (アイコンを右クリックすると「管理者として実行」が表示される)， 以下のように winget コマンドでインストールする．

> winget.exe install Git.Git 
> winget.exe install Python
> winget.exe install vscode

vscode, git, python をインストールしたら，右上のバツ印をクリックして PowerShell を閉じること．

EIM-CLI (ESP-IDF Installation Manager CLI 版) のインストール

EIM には GUI 版と CLI 版があるが，このドキュメントでは CLI 版を利用する． Windows PowerShell を「管理者権限」で起動し (アイコンを右クリックすると「管理者として実行」が表示される)， Winget コマンドで CLI 版をインストールする．

> winget install Espressif.EIM-CLI

EIM-CLI をインストールしたら，右上のバツ印をクリックして PowerShell を閉じること．

EIM CLI 版でのセットアップ

インストール前に Windows PowerShell を再起動する必要がある． 今回は 2026/03/30 現在，mrubyc-esp32 でサポートしている v5.5.4 をインストールする．-i オプションでバージョンを指定する．

> eim install -i v5.5.4

インストールの途中でプログレスバーが動かなくなる (サブモジュールのダウンロードに時間がかかる) ことがある． たいていの場合，10～30 分程度でインストールが完了するので，慌てず騒がず待って欲しい．

動作確認 (デバイスマネージャー)

PC にマイコンを接続する．デバイスマネージャーを起動し，「ポート (COM と LPT)」を確認する．「USB Serial Port (COM ...)」が存在するかを確認する．

動作確認

デスクトップ上にアイコンが作成されるので，それをクリックする

ESP-IDF の L チカのサンプルを取得し，それを動かしてみる．

C:\esp\v5.5.4 以下にサンプルプロジェクトを作成し，そこへ移動する．

> cd C:\esp\v5.5.4\
> cp -r .\esp-idf\examples\get-started\blink .
> cd .\blink\

menuconfig を実行し，マイコン上の LED のピン番号を指定する．

> idf.py menuconfig

   Example Configuration > (13) Blink GPIO number  [ピン番号を 13 (マイコンボード上の LED のピン番号) に変更]

ビルド (build) して，マイコンに書き込み (flash)，実行・シリアルモニタの表示 (monitor) を行う．

> idf.py build
> idf.py flash
> idf.py monitor

シリアルモニタ (monitor) を終了させるときは，Ctrl-] を打鍵する (コントロールキーと大カッコ閉じるを一緒に押す)．