ESP-IDF
ESP-IDF(英語) は、ESP32 および ESP32-S シリーズ SoC(英語) の公式開発フレームワークです。この記事は、CLion で ESP-IDF を操作するための入門ガイドです。
いくつかの手順は、ESP-IDF はじめ(英語)にガイドを複製します。以下の例は macOS の場合について与えられており、それに応じて Windows 固有の指示がマークされています。
環境を整える
システムに最新の Python(英語) バージョン、pip(英語)、および git(英語) がインストールされていることを確認してください。
システムターミナルを使用して、ESP-IDF のディレクトリを作成し、公式リポジトリ(英語)のクローンを作成します。
mkdir -p ~/esp cd ~/esp git clone --recursive https://github.com/espressif/esp-idf.gitESP-IDF は ~/esp/esp-idf にダウンロードされます。
同じシェルに、ツールをインストールします。
cd esp-idf ./install.shWindows では、ESP-32 ボードの USB ブリッジが正しく識別されていることを確認してください。デバイスマネージャーで確認できます。
CLion のターミナルを使用してサンプルプロジェクトを設定する
CLion で、メインメニューの~/esp/esp-idf ディレクトリを選択します。
に移動し、この時点で、現在のディレクトリ '../esp/esp-idf' はビルドできません ... エラーが原因でプロジェクトのロードが失敗する可能性があります。
CLion の内蔵ターミナル(
または Alt+F12)を開きます。. $HOME/esp/esp-idf/export.sh
を実行して環境変数を設定します。examples/get-started ディレクトリから hello_world プロジェクトを構成しましょう。次のコマンドは、ESP32 チップをターゲットとして設定し、menuconfig 構成ユーティリティを実行します。
cd $IDF_PATH/examples/get-started/hello_world idf.py set-target esp32 idf.py menuconfig最後のコマンドは、構成メニューを開きます。使用している hello_world プロジェクトはデフォルト構成で実行されるため、このメニューで設定する必要はありません。
メニューから出て、構成が完了していることを確認します。
これで、
idf.py build
を実行して hello_world をビルドできます。
次に、ターミナルを使用して CLion でプロジェクトの作業を続行できます。これには、追加の CMake 構成は必要ありません。または、コマンドラインなしでプロジェクトをロード、ビルド、実行できるように CMake を設定することもできます(以下を参照)。
CLion で ESPCMake プロジェクトを構成する
Hello-world プロジェクトを開く
メインメニューで、esp/esp-idf/examples/get-started/hello_world フォルダーを選択します。
に移動し、プロジェクトとして開くをクリックして、ソースを信頼します。
この時点で、プロジェクトの読み込みが失敗する可能性があります。
環境を調達する
ツールチェーン設定を使用して、ESP-IDF 環境スクリプトを指定します。
ESP-IDF インストールには 1 つまたは 2 つの環境ファイルが必要です。Python 仮想環境の場合は 2 つのファイルが必要です。
環境スクリプトをソースする (macOS の例)
に移動します。
「名前」フィールドの横にある「環境を追加する」をクリックし、「次のファイルから」をクリックします。
esp/esp-idf に移動し、export.sh を選択します。
ツールチェーン設定を保存します。
プロジェクトは自動的に再ロードされます。エラーが発生した場合は、メインメニューから
を呼び出します。
カスタムスクリプトを使用して環境を調達する (Windows の例)
Windows では、ESP-IDF 環境をセットアップするには 2 つのファイルが必要です。これを自動化するには、両方をロードしてツールチェーン環境ファイルとして使用する簡単なスクリプトを作成できます。
プロジェクトフォルダーにスクリプトファイルを作成します。例: espidf_source.bat。
次の行をカスタマイズしてスクリプトに追加します。
@call C:\Espressif\python_env\idf5.0_py3.8_env\Scripts\activate.bat @call C:\Espressif\frameworks\esp-idf-v5.0-2\export.batに移動します。
「名前」フィールドの横にある「環境を追加する」をクリックし、「次のファイルから」をクリックします。
新しく作成したファイルを選択します。
ツールチェーン設定を保存します。
プロジェクトは自動的に再ロードされます。エラーが発生した場合は、メインメニューから
を呼び出します。
プロジェクトのビルド
CLion は、検出されたすべての CMake ターゲットに対して実行 / デバッグ構成を自動的に作成します。
プロジェクトをビルドするには、構成スイッチャーでアプリを選択し、ハンマーアイコンをクリックするか、Ctrl + F9 を押してこの構成のビルドを実行します。
この時点で、すべての CLion コードインサイト機能が ESP プロジェクトで利用可能になります。いくつかの例については、Windows 上の CLion を使用した ESP32 用の開発: コードインサイト(英語)を参照してください。
CLion の ESP-32 チップをフラッシュして監視する
構成スイッチャーでフラッシュを選択し、ハンマーアイコンをクリックするか、Ctrl + F9 を押してビルドします。
ビルド出力で、チップの点滅のパーセンテージインジケーターを確認できます。
モニター構成を選択して構築します。シリアルポートを開けないというエラーが表示された場合は、次の手順を実行します。
デバイスマネージャーを開き、ESP デバイスで使用されているポートを確認します。
CMake 設定の環境変数にもう 1 つの変数
ESPPORT
を追加します。値をポートに設定します(例:COM3
)。プロジェクトが再ロードされた後、モニター構成を再度ビルドします。ESP-32 チップは期待どおりに報告する必要があります。
既知の問題と制限
現在、
long
のサイズは 64 ビットと見なされていますが、ESP-32(CPP-23731(英語))の場合は 32 ビットである必要があります。これを回避するには、 に移動し、clangd 診断オプションに--target=riscv32
を追加します。
トラブルシューティング (Windows)
Windows で Git executable not found
エラーが発生する場合は、ESP-IDF の find_package(Git)
コマンドで検出可能な場所に Git がインストールされていることを確認してください。
これを回避するには、git.exe バイナリへのフルパスを使用して GIT
環境変数を追加します。esp/idf/tools/cmake/git_submodules.cmake を変更することでそれを行うことができます。最初の行で、find_package(Git)
を次のように変更します。
関連ページ:
![](https://resources.jetbrains.com/help/img/idea/2024.1/cl_trust_cmake_prj_dialog.png)
プロジェクトのセキュリティ
潜在的なセキュリティリスクを防ぐために、CLion では、プロジェクトのソースがわからない場合にプロジェクトを開く方法を決定できます。CLion は、オープニングプロセス中に実行されるタスクまたは構成について警告し、信頼できるソースを構成できるようにします。不明なソースからプロジェクトを開く:CMake、Makefile、Gradle プロジェクトを開くと、CLion はロードプロセス中にビルドスクリプトを実行します。これらのビルドスクリプトには、任意の(潜在的に危険な)コードを含めることができ...
![](https://resources.jetbrains.com/help/img/idea/2024.1/cl_toolchain_options.png)
チュートリアル: Windows で CLion を設定する
WSL ツールチェーンを使用すると、Linux の CMake とコンパイラーを使用してプロジェクトを構築し、Windows マシンで leavCLionLion を実行せずに WSL で実行 / デバッグできます。Microsoft Visual C++:システムに Visual Studio2013, 2015, 2017, 2019,, 2022 をインストールしてください。CLion で、に移動します。をクリックし、ツールチェーンテンプレートのリストから Visual Studio を選択しま...
![](https://resources.jetbrains.com/help/img/idea/2024.1/cl_rdconfigslist_temporary.png)
実行 / デバッグ構成
CLion は、実行 / デバッグ構成を使用して、コードを実行、デバッグ、テストします。各構成は、何を実行し、どのパラメーターと環境を使用するかを定義する、名前付きのスタートアッププロパティのセットです。実行 / デバッグ構成には 2 つのタイプがあります。一時的 — テスト、テストスイート、フィクスチャ、エントリを実行 / デバッグするたびに作成され、ガターアイコン / を使用します。永続的 — テンプレートから明示的に作成されるか、一時的な構成を保存することによって作成されます。永続的な構成は、削除...
![](https://resources.jetbrains.com/help/img/idea/2024.1/cl_buildproject.png)
ビルドアクション
プロジェクトのビルド、クリーニング、インストールのアクションは、メインメニューのビルドセクションにまとめられています。以下の表は、ビルドアクションが次のタイプのプロジェクトでどのように機能するかを示しています。CMake,、メイクファイル、中間子、カスタムビルドターゲットを含む Compilation Database とカスタム実行 / デバッグ構成。CMake プロジェクトのビルドアクション:プロジェクトのビルドカスタムビルドターゲットの場合: 最初のターゲットのビルドツールを呼び出します。ビ...
![](https://resources.jetbrains.com/help/img/idea/2024.1/emmet_history.png)
Emmet
Emmet ツールキットは、HTML、CSS、JSX によるコーディングを強化します。CLion を移動せずに Emmet コードテンプレートを使用できます。テンプレートを正しいマークアップに展開するには、その略語を入力してを押します。を別のキーに置き換えるには、「略語拡張キーを構成する」を参照してください。例: HTML ファイルでと入力し、を押して 3 × 2 テーブルのスタブを取得します。<table> <tr> <td></td> &l...
![](https://resources.jetbrains.com/help/img/idea/2024.1/cl_fortran_format.png)
Fortran
CLion は、Fortran プラグインを介して Fortran をサポートします。プラグインは、FORTRAN 77/90/95/2003/2008 の言語サポートとデバッガーを提供します。アプリケーションサポートは CMake によって提供されます。CLion で Fortran プロジェクトを開始する Fortran コンパイラーをインストールします。GCC インストールに含まれている GNU Fortran コンパイラー、または選択した別の Fortran コンパイラーを使用できます。Fortr...