このプロジェクトについて
ESP-IDF(Espressif IoT Development Framework)は、Espressif SoC向けの公式開発フレームワークであり、Windows、Linux、macOSでサポートされています。Espressifのチップを対象としています。2016年より前にリリースされたSoC(ESP8266およびESP8285)は、代わりに別のRTOS SDKによってサポートされています。
このリポジトリには、リリースのサポートスケジュール、製品寿命(EOL)に関する勧告、およびESP-IDFリリースとチップリビジョン間の互換性が記載されています。各SoCシリーズと各ESP-IDFリリースには独自のドキュメントがあり、READMEはオンラインドキュメントの「Versions」セクションを参照して、ドキュメントの検索や特定リリースのチェックアウトを行います。
使用を開始するには、ホストのビルド依存関係をインストールし、インストールスクリプト(Windowsではinstall.batまたはinstall.ps1、Unixシェルではinstall.shまたはinstall.fish)を実行し、ESP-IDFを使用する前に各シェルで環境をエクスポート(Windowsではexport.bat、Unixではsource export.sh)する必要があります。テンプレートプロジェクト(esp-idf-template)と、examplesディレクトリ内の一連のサンプルプロジェクトが提供されています。サンプルから新しいプロジェクトを開始するには、サンプルディレクトリをESP-IDFツリーの外にコピーします。
主なワークフローは、idf.pyコマンドラインツールを使用します。`idf.py set-target <chip_name>` でターゲットチップを選択し、`idf.py menuconfig` でテキストベースの設定メニューを開きます。`idf.py build` はアプリケーションとブートローダをコンパイルし、設定からパーティションテーブルを生成します。書き込みは `idf.py -p PORT flash` で行い、アプリ、ブートローダ、パーティションテーブルを新しいチップに書き込み、必要なものは自動的に再ビルドします。ポートオプションを省略した場合は、利用可能な最初のシリアルポートを試します。シリアル出力は `idf.py monitor` で表示します。これはesp-idf-monitorツールを使用し、クラッシュ出力のデコードやデバイスとの対話ができ、Ctrl-]で終了します。`idf.py flash monitor` はビルド、書き込み、モニタリングを1回でまとめて行います。反復作業では、`idf.py app` はアプリのみをビルドし、`idf.py app-flash` はアプリのみを書き込み、ソースが変更されると自動的に再ビルドします。`idf.py erase-flash` はフラッシュ全体を消去し、パーティションテーブルの変更やOTAアップデートに便利で、他のターゲットと組み合わせることができます。
GitHub以外のフォークの場合、READMEにはサブモジュールのURLが相対パスでGitHubにリンクされていると記載されています。スクリプト tools/set-submodules-to-github.sh は絶対URLを設定するため、`git submodule update --init --recursive` を完了できます。この手順はGitHubからクローンする場合は不要です。
リソースには、docsディレクトリから構築されたオンラインドキュメント、初心者向けガイドビデオ、質問やコミュニティリソースのためのesp32.comフォーラム、バグや機能リクエストのためのGitHub Issuesセクション、およびコントリビューションガイドが含まれます。
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.