ターゲットと環境
コンパイル対象のボード、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の種類を検出したり、気にしたりはしません。
ターゲットを選ぶ
- ツールバーの Target: をクリックします(未設定の場合は Select Target と表示されます)。
- Search targets... に入力します。空欄のときは人気のボードが表示されます。
- ターゲットをクリックします。
検索は、ターゲット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:
Embedrは、プロジェクトで最後に選んだ環境を記憶します。記憶がなければ default_envs を、それもなければ最初のセクションを使います。
デバイス
- データ通信対応のUSBケーブルでボードを接続します。
- Device: をクリックします(未設定の場合は Select Device)。CONNECTED DEVICES の一覧は開くたびに再スキャンされます。再スキャンボタン(Scan for USB devices)でもう一度スキャンできます。
- ポートを選びます。
各項目にはポートの説明が表示され、説明が空の場合はパスが表示されます。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がボードに対応しているのに一覧にプリセットがない場合は、カスタムターゲットを使います。
Target メニューを開き、Custom Target... をクリックします。
Create Custom Target で、4つの項目すべてを入力します。
項目 例 Name My ESP32-S3 BoardFramework arduinoPlatform espressif32Board esp32-s3-devkitc-1Save で保存するか、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枚のボードでターゲット、デバイス、コンパイル、書き込み、シリアルモニターの流れを身につけましょう。
