ターゲットと環境

コンパイル対象のボード、PlatformIO環境、接続デバイス、書き込みとモニターの設定。

下部ツールバーの左側にある3つのピッカーで、ファームウェアのビルドを制御します。

ピッカー 決めること 必要な場面
Target どのボード向けにコンパイルするか コンパイルと書き込み
Environment(レイヤーアイコン) platformio.ini のどのビルドプロファイルを使うか プロファイルが複数あるプロジェクト
Device ボードがどのポートに接続されているか 書き込みとシリアルモニター

何も接続していなくてもコンパイルできます。デバイスが必要なのは、書き込みとシリアルモニターを開くときだけです。

Electronics only のプロジェクトでは、これらのピッカーは表示されません。ホーム画面では、+ Firmware を選ぶと入力欄の横に Target ピッカーが表示されるので、新しいプロジェクトを最初から正しいボードで始められます。

ターゲット

ターゲットはボードのプリセットです。3つのPlatformIOの値に対応します。

値 意味 例
Platform PlatformIOのプラットフォームパッケージ espressif32、atmelavr、raspberrypi、ststm32、nordicnrf52
Board プラットフォーム内のボードID esp32dev、uno、pico、bluepill_f103c8
Framework ファームウェアが使うSDK arduino、espidf、zephyr、stm32cube、mbed

esp32 ターゲットは「Arduinoを使うESP32 DevKit」を意味します。実際に接続されているESP32の種類を検出したり、気にしたりはしません。

ターゲットを選ぶ

  1. ツールバーの Target: をクリックします(未設定の場合は Select Target と表示されます)。
  2. Search targets... に入力します。空欄のときは人気のボードが表示されます。
  3. ターゲットをクリックします。

検索は、ターゲットID、ボードID、名前、MCU、ベンダー、プラットフォーム、フレームワーク、カテゴリーに一致します。スペースや記号は無視されるため、esp32s3、esp32-s3、esp32 s3 は同じボードを見つけます。3文字以上の検索語では、小さなタイプミスも許容されます。結果は順位付けされ、最大50件です。目的のボードが見当たらない場合は、検索語を絞り込んでください。

ターゲットにカーソルを合わせると、Platform、Framework、Board ID、Category が表示されます。

Embedrには、ESP32、nRF、STM32、SAMD、RP2040、Teensy、RISC-V、NXP、Renesas、TI、Silicon Labsなどのファミリーにわたる約200のボードプリセットが付属しています。ESP-IDF版(esp32-idf、esp32-s3-idf、esp32-c3-idf、esp32-c6-idf)やZephyr版(例:nrf52840-zephyr)も含まれます。CLIで一覧を表示できます。

embedr boards            # popular boards
embedr boards --all      # every preset
embedr boards -f s3      # filter by text
embedr boards -c nordic  # filter by category

ターゲットを選ぶと変わること

ターゲットを選ぶとプロジェクトに書き込まれるため、選択はフォルダと一緒に持ち運ばれます。

  • platformio.ini に、そのボード用の [env:<target-id>] セクションが(なければ)追加され、default_envs がそれを指します。
  • embedr.yaml の capabilities.firmware に、有効なターゲットとして記録されます。

たとえば、新しいUnoのプロジェクトを esp32 に切り替えると、次のようになります。

[env:uno]
platform = atmelavr
board = uno
framework = arduino
monitor_speed = 115200

[env:esp32]
platform = espressif32
board = esp32dev
framework = arduino
monitor_speed = 115200

[platformio]
default_envs = esp32

古い環境は残るので、Environment ピッカーから元に戻せます。ターゲットを変えてもソースは書き換えられません。ArduinoのスケッチはESP-IDFのターゲットではコンパイルできないため、フレームワークを変える場合はエージェントにコードの移植を依頼してください。

環境

環境は platformio.ini の [env:name] セクション1つ分です。1つのプロジェクトを複数のボード、フレームワーク、構成向けにビルドする場合に複数使います。

[env:esp32]
platform = espressif32
board = esp32dev
framework = arduino
monitor_speed = 115200

[env:esp32-debug]
platform = espressif32
board = esp32dev
framework = arduino
monitor_speed = 115200
build_type = debug
build_flags = -DLOG_LEVEL=4

[platformio]
default_envs = esp32

Environment ボタンは、Device の後にあるレイヤーアイコンです。メニューの見出しは ENVIRONMENT で、すべての [env:...] セクションが一覧表示されます("2 environments available")。1つ選ぶと、コンパイルと書き込みでその環境が使われます。ボタンに琥珀色の点がある場合は、選択中の環境が既定の環境ではないことを示します。

ツールチップには "Environment: " と表示されます。環境がない場合はボタンが無効になり、メニューに "No environments in manifest" と表示されます。

Embedrは、プロジェクトで最後に選んだ環境を記憶します。記憶がなければ default_envs を、それもなければ最初のセクションを使います。

デバイス

  1. データ通信対応のUSBケーブルでボードを接続します。
  2. Device: をクリックします(未設定の場合は Select Device)。CONNECTED DEVICES の一覧は開くたびに再スキャンされます。再スキャンボタン(Scan for USB devices)でもう一度スキャンできます。
  3. ポートを選びます。

各項目にはポートの説明が表示され、説明が空の場合はパスが表示されます。USBシリアル変換(CH340、CP210x、FTDIなどのUSB/UARTポート)が先頭に並び、Bluetoothやデバッグコンソールのポートは表示されません。項目にカーソルを合わせると、完全なパスが表示されます。

OS 一般的なポート
macOS /dev/cu.usbserial-0001、/dev/cu.usbmodem14101(/dev/cu. を省いて表示)
Windows COM3、COM5
Linux /dev/ttyUSB0、/dev/ttyACM0

Embedrがポートを自動で選ぶことはありません。最後に使ったポートがまだ接続されていればそれを復元し、そのポートがなくなると選択を解除します。Deselect Device で手動で解除することもできます。

"No devices detected" は、たいてい充電専用ケーブル、USBドライバの不足(Windows)、シリアルポートの権限不足(Linux)、またはボードのUSBポートが無効な状態であることが原因です。トラブルシューティングを参照してください。

ブラウザでは、ペアリングしたポートだけが一覧に表示されます。Pair Browser Serial... で追加します。ブラウザ版Embedrを参照してください。

Target Settings

Target メニューを開き、Target Settings(歯車)をクリックすると、有効なターゲットの書き込みとモニターの設定を調整できます。

セクション 設定
Monitor & Serial Monitor Speed
Upload & Debug Upload Speed、Upload Protocol、Debug Tool
  • 各項目にカーソルを合わせると、ボードの既定値が表示されます("Default: …" または "Auto-detected")。点は、プロジェクトで上書きしている値を示します。
  • フッターには上書きの数が表示されます("2 project overrides active")。Save Project Settings をクリックして書き込みます。
  • Restore はボードの既定値をプロジェクトの値に上書き保存します。Reload は設定を読み直します。

PlatformIOプロジェクトでは、値は platformio.ini の有効な [env:...] セクションに書き込まれます。

[env:esp32]
platform = espressif32
board = esp32dev
framework = arduino
monitor_speed = 9600
upload_speed = 921600

platformio.ini を設定の正としない古いプロジェクトでは、値は embedr.yaml に保存され、platformio.ini はそこから再生成されます。

これら4つ以外の設定(ビルドフラグ、パーティション、ビルドタイプ)は、手動で、またはエージェントに依頼して、platformio.ini に直接書きます。

カスタムターゲット

PlatformIOがボードに対応しているのに一覧にプリセットがない場合は、カスタムターゲットを使います。

  1. Target メニューを開き、Custom Target... をクリックします。

  2. Create Custom Target で、4つの項目すべてを入力します。

    項目 例
    Name My ESP32-S3 Board
    Framework arduino
    Platform espressif32
    Board esp32-s3-devkitc-1
  3. Save で保存するか、Save and Select で保存して開いているプロジェクトをそれに切り替えます。

カスタムターゲットはこのコンピューターに保存され、すべてのプロジェクトで使えます("These presets are available across all projects on this machine.")。ターゲット一覧の先頭の Custom Targets に表示されます。編集や削除は、同じダイアログの Saved Targets から行います。名前は重複できません。書き込みとデバッグの詳細設定は Target Settings で行います。

カスタムターゲットはデスクトップ版の機能です。

カスタムビルドコマンドを使うプロジェクト

Make、CMake、Zephyrの west、Cargo、ベンダーSDKでビルドするプロジェクトは、embedr.yaml に独自のコマンドを宣言します(カスタムファームウェアアクションを参照)。このようなプロジェクトでは:

  • Target と Environment のピッカーは無効になります。
  • Compile は build アクションを実行します。ない場合、ツールチップに "Add capabilities.firmware.actions.build to embedr.yaml to enable compiling" と表示されます。
  • Flash は flash アクションを実行し、Device ピッカーは flash アクションがある場合にだけ有効になります。選択したポートは EMBEDR_DEVICE_PORT としてコマンドに渡されます。

CompileボタンとFlashボタン

ボタン 実行できないときのツールチップ 対処
Compile "Select a target to compile" ターゲットを選びます。
Flash "Select a target first" ターゲットを選びます。
Flash "Select a device to flash" デバイスを選びます。

実行中、ボタンは Compiling と Flashing になります。ビルドの出力は Output タブに表示されます。ビルド、書き込み、シリアルを参照してください。

最初に使うボードの選び方

最初のプロジェクトでは、USBで簡単に書き込める一般的なボードを選びましょう。

ボード ターゲット メモ
Arduino Uno uno CLIで作る新規プロジェクトの既定。遅いがシンプルで、失敗に寛容です。
ESP32 DevKit esp32 Wi-FiとBluetooth。ブラウザからも書き込めます。
ESP32-S3 DevKitC-1 esp32-s3 ネイティブUSB、メモリが多め。ブラウザからも書き込めます。
Raspberry Pi Pico pico 低価格、RP2040。

1つのプロジェクトで複数のファミリーを混ぜる前に、1枚のボードでターゲット、デバイス、コンパイル、書き込み、シリアルモニターの流れを身につけましょう。