Dial ESP-IDF BSP 使用チュートリアル

本チュートリアルでは、ESP-IDF 開発環境で Dial ボードサポートパッケージ（BSP）を統合し、ボード上の周辺機器ドライバを迅速に初期化および管理する方法を紹介し、開発効率を向上させます。

1. 準備

1. 環境構築: 本チュートリアルは Ubuntu 上での ESP-IDF 開発環境構築を前提としています。他のプラットフォームの場合は、ESP-IDF - Getting Started Guide を参照してください。

2. Git を使用して esp-idf リポジトリをクローンし、指定されたブランチに切り替え、必要なツールチェーンをインストールするスクリプトを実行します。

git clone --recursive https://github.com/espressif/esp-idf.git
cd esp-idf
git checkout v5.4.1 # 推奨
./install.sh
. ./export.sh

3. 後で使用する idf.py コマンドは ESP-IDF に依存しています。コマンドを実行する前に、プロジェクトディレクトリで . ./export.sh を実行して環境変数を有効にしてください。詳細は ESP-IDF - Getting Started Guide を参照してください。

2. プロジェクト作成

1. ターミナルを開き、作業ディレクトリに移動して dial_projects フォルダを作成します。フォルダに移動した後、esp-idf 内の export.sh を実行して環境変数を有効化します。以下のコマンドは dial_projects と esp-idf が同階層にある場合の例です。パスが異なる場合は適宜修正してください。以下の idf.py create-project コマンドで my_project という名前の空プロジェクトテンプレートを作成します。

mkdir dial_projects
cd dial_projects
. ../esp-idf/export.sh
idf.py create-project my_project

2. プロジェクトフォルダに移動し、Espressif Component Registry を使用して M5Stack Core2 BSP を追加します。

cd my_project
idf.py add-dependency "espressif/m5dial^2.0.0"

3. ターゲットチッププラットフォームを設定します：

idf.py set-target esp32s3

3. サンプルプログラム

1. 空テンプレートのエントリファイルを開き、以下のサンプルコードをコピーします：

vim main/my_project.c

#include "freertos/FreeRTOS.h"
#include "freertos/task.h"
#include "esp_log.h"

#include "lv_demos.h"
#include "bsp/esp-bsp.h"

static char *TAG = "app_main";

#define LOG_MEM_INFO (0)

void app_main(void) {
    /* ディスプレイと LVGL の初期化 */
    bsp_display_start();
    /* ディスプレイの明るさを 100% に設定 */
    bsp_display_backlight_on();

    ESP_LOGI(TAG, "Display LVGL demo");
    bsp_display_lock(0);
    lv_demo_widgets(); /* ウィジェットのサンプル */
    // lv_demo_music(); /* スマートフォン風音楽プレイヤーサンプル */
    // lv_demo_stress();       /* LVGL のストレステスト */
    // lv_demo_benchmark();    /* LVGL の性能比較や設定比較デモ */
    bsp_display_unlock();
}

2. このサンプルプログラムは LVGL コンポーネントのデモを画面に表示する方法を示しています。異なるデモをコンパイルするには、コメントを切り替えてください。使用するデモを有効にするには、idf.py menuconfig で Component config -> LVGL Configuration -> Demos を開き、対応するデモを有効にします。

4. ビルドと書き込み

1. 以下のコマンドを実行してプログラムをコンパイルおよび書き込みします：

idf.py flash