PlatformIOのインストール:VS CodeでArduino、ESP32、Picoを使うガイド
VS CodeへのPlatformIOのインストール方法を解説します。platformio.iniでUno、ESP32、Picoを設定し、lib_depsでライブラリを追加して書き込み、Arduino IDEから移行する手順まで紹介します。
PlatformIOのインストールは、VS Codeに拡張機能を1つ追加するだけで、Arduino Uno、ESP32、Raspberry Pi Picoなどのボードを1つの本格的な開発環境からプログラミングできるようにするものです。手順を簡単にまとめると、VS Codeをインストールし、「拡張機能」タブでPlatformIO IDEを検索してインストールし、初回起動時に必要なツールのダウンロードが終わるのを待ってから、PIO Home画面でボードを選んで新しいプロジェクトを作成します。あとはplatformio.iniという小さな設定ファイルで管理します。どのボード、どのフレームワーク、どのライブラリ、どのシリアルポートの速度を使うかが、すべてこのファイルに書かれます。
Arduino IDEは学習にはとてもよいツールですが、プロジェクトが大きくなるにつれて限界を感じるようになります。コード補完は基本的なものにとどまり、ライブラリはすべてのプロジェクトで共有されるため、ライブラリを更新すると古いプロジェクトが動かなくなることがあり、ボードの設定もプロジェクトと一緒には保存されません。PlatformIOはこうした問題を解決します。このガイドでは、ステップごとにインストールし、最初のプロジェクトを作成し、platformio.iniで3種類のボードを1つのプロジェクトに定義し、ライブラリを追加し、コードを書き込んでシリアルモニタを開き、既存のArduino IDEのプロジェクトを移行する方法を学びます。最後のセクションでは2つのツールを公平に比較し、どちらが合っているかを判断する手助けをします。

PlatformIOとは?どのように動作するのか
PlatformIOは、組み込みシステム向けのオープンソースの開発エコシステムです。中心にはPythonで書かれたPlatformIO Coreというコマンドラインツールがあり、VS Codeの拡張機能がボタン、メニュー、PIO Home画面でこのツールを使いやすくしています。プロジェクトをビルドすると、PlatformIOはまずplatformio.iniを読み込み、必要なコンパイラ(Unoならavr-gcc、ESP32ならXtensaのツールチェーン、Picoならarm-none-eabi-gcc)、フレームワーク、ライブラリを独自のレジストリからダウンロードして、コードをコンパイルします。これらのパッケージは一度だけダウンロードされ、ユーザーフォルダーの.platformioフォルダーに保存されます。以降のプロジェクトでは同じパッケージが再利用されます。次の用語を知っておくと、ファイルがずっと読みやすくなります。
| 用語 | 意味 | 例 |
|---|---|---|
| プラットフォーム(Platform) | あるマイコンファミリー用のコンパイラと書き込みツールのパッケージ | atmelavr、espressif32、raspberrypi |
| ボード(Board) | プラットフォーム内の特定のボード。ピンの対応、クロック速度、メモリの情報 | uno、nanoatmega328、esp32dev、pico |
| フレームワーク(Framework) | コードを書く土台となるソフトウェア基盤 | arduino、espidf |
| 環境(env) | プラットフォーム、ボード、フレームワーク、追加の設定をまとめて定義するセクション | [env:uno] |
| ライブラリ | lib_depsでプロジェクトに追加する既製のコードパッケージ | adafruit/DHT sensor library(ライブラリ名) |
| PIO Home | プロジェクトを開いたり、ボードやライブラリを検索したりする画面 | ステータスバーの家のアイコン |
PlatformIOのインストール手順
- Visual Studio Codeを公式サイトからダウンロードしてインストールします。Windowsでは、インストール中にAdd to PATH(PATHへの追加)にチェックを入れておくと、ターミナルが使いやすくなります。
- VS Codeを開き、左側の「拡張機能」タブをクリックするか、Ctrl+Shift+X(macOSではCmd+Shift+X)のショートカットを使います。
- 検索ボックスにPlatformIO IDEと入力し、PlatformIOが公開している拡張機能をInstall(インストール)ボタンでインストールします。必要なC/C++の拡張機能も自動的に一緒に入ります。
- 右下に「Installing PlatformIO Core」という通知が表示されます。インターネットの速度によって数分かかります。その間はVS Codeを閉じないでください。
- インストールが終わると、VS Codeの再起動を求められます。再起動すると、左端にPlatformIOのアイコン、下のステータスバーに家のアイコンが表示されます。
- 家のアイコンをクリックしてPIO Home画面を開きます。この画面が問題なく表示されれば、インストールは完了です。
最初のプロジェクトの作成とフォルダー構成
PIO HomeでNew Project(新規プロジェクト)ボタンを押します。開いたウィンドウでプロジェクトに名前(例:blink-uno)を付け、Boardの欄にArduino Unoと入力してリストから選び、FrameworkはArduinoのままにして保存場所を決めます。Finishを押すと、PlatformIOは選んだボードに必要なプラットフォームのパッケージを初めてダウンロードします。そのため最初のプロジェクトは数分かかることがありますが、2回目以降は数秒で開きます。プロジェクトが作成されるとVS Codeがフォルダーを開き、次のような構成が表示されます。
| フォルダー/ファイル | 用途 |
|---|---|
| platformio.ini | プロジェクトの中心。ボード、フレームワーク、ライブラリ、ポートの設定 |
| src/ | ソースコード。プログラムはmain.cppから始まります |
| include/ | 自作のヘッダー(.h)ファイル |
| lib/ | 手動で追加するプロジェクト専用のローカルライブラリ(それぞれ別のサブフォルダーに入れる) |
| test/ | ユニットテスト用のフォルダー |
| .pio/ | ビルドの出力とダウンロードしたライブラリ。削除しても再作成されます |
| .vscode/ | VS CodeとIntelliSenseの設定。自動的に生成されます |
platformio.iniファイルとは?
platformio.iniは、INI形式のプレーンテキストファイルです。角かっこで始まる[env:名前]の各セクションが、1つのビルド環境を定義します。Arduino IDEで「ツール」メニューから選ぶボードやポートの速度を、ここでは文字で書きます。そのため、プロジェクトを別のパソコンに移したり友だちに渡したりしても、設定がコードと一緒に移ります。セミコロンで始まる行はコメントです。Uno用に作成されたファイルにシリアルモニタの速度を追加すると、ファイルは次のようになります。
1; PlatformIO proje ayarları / PlatformIO project settings
2[env:uno]
3platform = atmelavr
4board = uno
5framework = arduino
6; Seri monitör hızı, Serial.begin ile aynı olmalı / Monitor speed, must match Serial.begin
7monitor_speed = 115200| 設定 | 役割 | 値の例 |
|---|---|---|
| platform | 使用するプラットフォームのパッケージ。バージョンの固定もできます | atmelavr、[email protected] |
| board | ボードのID | uno、megaatmega2560、esp32dev、pico |
| framework | ソフトウェアのフレームワーク | arduino |
| monitor_speed | シリアルモニタの速度(初期値9600) | 115200 |
| upload_port | 書き込みポート(空欄なら自動で検出) | COM5、/dev/ttyUSB0 |
| upload_speed | 書き込みのボーレート(特にESPボード) | 921600 |
| lib_deps | 自動でダウンロードするライブラリ | adafruit/DHT sensor library@^1.4.4(バージョン指定付き) |
| build_flags | コンパイラに渡す追加のフラグとマクロ | -D LED_PIN=2 |
| monitor_filters | シリアルモニタの出力にかけるフィルター | time、esp32_exception_decoder |
最初のコード:main.cppとArduino.hの違い
srcフォルダーのmain.cppは、Arduino IDEの.inoファイルに相当しますが、重要な違いが2つあります。1つ目は、ファイルの先頭にArduino.hヘッダーを読み込む#includeの行が必要なことです。Arduino IDEは裏で自動的に追加しますが、PlatformIOは追加しません。2つ目は、.cppファイルは本来のC++のルールに従うことです。関数を呼び出す前に、コンパイラがその関数を知っている必要があります。Arduino IDEは関数のプロトタイプを自動で生成しますが、PlatformIOでは、使う前に関数を定義するか、ファイルの先頭に1行のプロトタイプを書きます。次の例は、Uno、ESP32、Picoのどれでも動くLED点滅(blink)のプログラムです。
1#include <Arduino.h>
2
3// LED_PIN platformio.ini'den gelebilir / LED_PIN may come from platformio.ini
4#ifndef LED_PIN
5#define LED_PIN LED_BUILTIN // Uno: 13, Pico: GP25
6#endif
7
8void blinkLed(int count); // prototip / prototype
9
10void setup() {
11 Serial.begin(115200);
12 pinMode(LED_PIN, OUTPUT);
13 Serial.println("PlatformIO hazir / ready");
14}
15
16void loop() {
17 blinkLed(3);
18 delay(1000);
19}
20
21void blinkLed(int count) {
22 for (int i = 0; i < count; i++) {
23 digitalWrite(LED_PIN, HIGH);
24 delay(150);
25 digitalWrite(LED_PIN, LOW);
26 delay(150);
27 }
28 Serial.print("Yanip sondu / Blinked: ");
29 Serial.println(count);
30}ビルド、書き込み、シリアルモニタ
| 操作 | ステータスバー/メニュー | ターミナルのコマンド |
|---|---|---|
| ビルド(Build) | チェックマーク | pio run(ビルド) |
| 書き込み(Upload) | 右向きの矢印 | pio run -t upload(書き込み) |
| 書き込んでモニタを開く | PlatformIOメニュー > Upload and Monitor | pio run -t upload -t monitor(書き込みとモニタ) |
| シリアルモニタ | プラグのアイコン | pio device monitor(シリアルモニタ) |
| クリーン | ゴミ箱 | pio run -t clean(クリーン) |
| ポートの一覧 | PIO Home > Devices | pio device list(ポートの一覧) |
| 特定の環境をビルド | 環境の切り替え(env:...) | pio run -e esp32dev(esp32devだけをビルド) |
| ライブラリのインストール | PIO Home > Libraries | pio pkg install -l "adafruit/DHT sensor library"(ライブラリのインストール) |
シリアルモニタを正しく動作させるには、platformio.iniのmonitor_speedの値と、コードのSerial.begin()の速度を同じにする必要があります。そうしないと画面に文字化けした文字が表示されます。PlatformIOは接続されたボードを通常は自動で見つけますが、パソコンに複数のシリアルデバイスがあると、違うポートに書き込もうとすることがあります。その場合はpio device listでポートを一覧表示し、正しいポートをupload_portとmonitor_portの行に書きます。Arduino IDEのシリアルモニタやほかのターミナルソフトがポートを開いたままだと、書き込みは「Access is denied」や「Resource busy」(ポート使用中)のエラーで止まります。そのソフトを閉じれば解決します。シリアルモニタそのものについては、Arduinoのシリアルモニタの記事も参考にしてください。pioコマンドは、PlatformIOメニューから開くPlatformIO Core CLIのターミナルなら必ず使えます。
Uno、ESP32、Picoを1つのプロジェクトに定義する
PlatformIOの大きな強みの1つは、同じコードを複数のボード向けにビルドできることです。ボードごとに別の[env:...]セクションを書き、共通の設定を名前のない[env]セクションに入れると、すべての環境がそれを引き継ぎます。次の表に、人気のある3つのボードの基本的な値をまとめます。
| 値 | Arduino Uno | ESP32 DevKit | Raspberry Pi Pico |
|---|---|---|---|
| platform | atmelavr | espressif32 | raspberrypi |
| board | uno | esp32dev | pico |
| framework | arduino | arduino | arduino(Arduino Mbedコア) |
| 内蔵LED | D13 | GPIO 2(多くのDevKitボード) | GP25 |
| 書き込み方法 | USBシリアルとブートローダー | USBシリアルとesptool | USBとBOOTSELモード |
| 一般的なmonitor_speed | 9600または115200 | 115200 | 115200 |
1[platformio]
2; Varsayılan ortam / Default environment
3default_envs = uno
4
5; Tüm ortamlarda ortak ayarlar / Settings shared by all environments
6[env]
7framework = arduino
8monitor_speed = 115200
9
10[env:uno]
11platform = atmelavr
12board = uno
13
14[env:esp32dev]
15platform = espressif32
16board = esp32dev
17upload_speed = 921600
18monitor_filters = esp32_exception_decoder
19; Dahili LED GPIO 2 / Onboard LED on GPIO 2
20build_flags = -D LED_PIN=2
21
22[env:pico]
23platform = raspberrypi
24board = picodefault_envsの行は、ステータスバーのビルドボタンと書き込みボタンがどの環境を使うかを決めます。この行を書かないと、PlatformIOはファイル内のすべての環境を順番にビルドします。ステータスバーの環境の切り替えからその場で別のボードに切り替えたり、ターミナルでpio run -e esp32dev -t uploadと入力してESP32に直接書き込んだりできます。ESP32の環境にある-D LED_PIN=2フラグは、コード内のLED_PINマクロを定義します。UnoとPicoにはこのフラグがないため、コードはLED_BUILTINの値(13と25)を使います。こうして1つのmain.cppが、3つのボードすべてで何も変更せずに動きます。ボードのピンの並びをすぐに確認したいときは、「ピン配置」ツールを使ってください。
ESP32向けのPlatformIOの設定
ESP32ボードは、Arduino IDEと同じようにPlatformIOでもesptoolで書き込みます。upload_speed = 921600にすると書き込み時間がかなり短くなります。ケーブルが長かったり品質が悪かったりしてエラーが出る場合は、460800か115200に下げてください。esp32_exception_decoderフィルターは、ボードがクラッシュしたときにシリアルモニタに表示される意味の分からないアドレスの羅列を、関数名と行番号に変換します。Guru Meditationエラーの原因を探すのにとても役立ちます。書き込みが「Connecting...」の段階で止まったら、ボードのBOOTボタンを押したままにし、書き込みが始まったら離します。詳しい解決方法はESP32のFailed to Connectエラーの記事にあります。もう1つ知っておきたいのがコアのバージョンです。PlatformIOの公式espressif32プラットフォームは、長い間Arduino-ESP32コアの2.xを使っていました。3.x固有のAPIが必要な場合は、コミュニティが保守しているpioarduinoプラットフォームに切り替えられます。どのコアが使われているかは、ビルド出力の先頭にあるPACKAGESの行のframework-arduinoespressif32のバージョンで確認できます。両方のバージョンでコンパイルできるようにしたい場合は、ESP_ARDUINO_VERSION_MAJORマクロで切り分けます。
Raspberry Pi PicoとPlatformIO
公式のraspberrypiプラットフォームは、board = picoの設定で、Arduino公式のMbed OSベースのRP2040コアを使います。一方で、機能が多くライブラリとの互換性も高いEarle Philhower氏のarduino-picoコアを好むユーザーも多くいます。PlatformIOでこのコアを使うには、コミュニティが保守している別のプラットフォームのパッケージとboard_build.core = earlephilhowerの設定を使います。どちらのコアを選んでも、最初の書き込みではBOOTSELボタンを押したままPicoをUSBにつなぐ必要がある場合があります。ボードはパソコン上でRPI-RP2という名前のドライブとして表示され、PlatformIOがプログラムを書き込むと自動的に再起動します。2回目以降の書き込みでは、たいていボタンは不要です。重要な注意点として、PlatformIOはMicroPythonに対応していません。PicoをMicroPythonでプログラミングしたい場合は、Thonnyなどのエディターを使ってください。詳しくは「MicroPythonの基本」と「Raspberry Pi Picoとは?」の記事をご覧ください。
ライブラリの追加:lib_deps
PlatformIOでは、ライブラリはパソコン全体ではなくプロジェクトごとに別々にインストールされます。いちばんすっきりした方法は、platformio.iniにlib_depsの行を追加することです。最初のビルドでPlatformIOがレジストリからライブラリをダウンロードし、.pio/libdeps/フォルダーに入れます。PIO HomeのLibrariesタブでライブラリの正確な名前を検索し、Add to Projectボタンで追加することもできます。このボタンがlib_depsの行を代わりに書いてくれます。次は、DHT11センサーをUnoのD2ピンにつなぐ例です。センサーの配線については「DHT11温湿度センサー」の記事を参照してください。
1[env:uno]
2platform = atmelavr
3board = uno
4framework = arduino
5monitor_speed = 115200
6; Kütüphaneler ilk derlemede otomatik iner / Libraries download on first build
7lib_deps =
8 adafruit/DHT sensor library@^1.4.4
9 adafruit/Adafruit Unified Sensor@^1.1.91#include <Arduino.h>
2#include <DHT.h>
3
4#define DHT_PIN 2 // Uno D2 pini / Uno pin D2
5#define DHT_TYPE DHT11
6
7DHT dht(DHT_PIN, DHT_TYPE);
8
9void setup() {
10 Serial.begin(115200);
11 dht.begin();
12}
13
14void loop() {
15 delay(2000); // DHT11 en fazla 1 Hz / DHT11 max 1 Hz
16 float h = dht.readHumidity();
17 float t = dht.readTemperature();
18 if (isnan(h) || isnan(t)) {
19 Serial.println("Sensor okunamadi / Read failed");
20 return;
21 }
22 Serial.print("Sicaklik / Temp: ");
23 Serial.print(t, 1);
24 Serial.print(" C Nem / Hum: ");
25 Serial.print(h, 0);
26 Serial.println(" %");
27}バージョンの書き方では、^1.4.4は1.4.4以上かつ2.0.0未満のバージョンを許可し、~1.4.4は1.4.xのパッチだけを受け入れます。1.4.4とだけ書くと、バージョンは完全に固定されます。バージョンを固定しておくと、1年後にプロジェクトを開いたときも、同じコードが同じようにコンパイルされることが保証されます。レジストリにないライブラリや自作のライブラリは、プロジェクトのlibフォルダーにそのライブラリ名のサブフォルダーとして置けば、PlatformIOが自動的に見つけます。Arduino IDEでのライブラリの仕組みと比べたい場合は、「Arduinoにライブラリを追加する方法」の記事を読んでみてください。
Arduino IDEからPlatformIOへのプロジェクトの移行
- PIO Homeで新しいプロジェクトを作成し、Arduino IDEで使っていたのと同じボードを選びます。
- .inoファイルの内容をsrc/main.cppに貼り付けます。同じフォルダーにあるほかの.inoタブはmain.cppの末尾に追加し、.hと.cppファイルはsrcフォルダーにコピーします。
- ファイルのいちばん上に、Arduino.hの#includeの行を追加します。
- setup()とloop()以外に書いたすべての関数について、ファイルの上部にプロトタイプを書きます。
- 使っているライブラリをPIO Home > Librariesで探してlib_depsに追加します。Arduino IDEで使っていたバージョン番号を書けば、同じ動作になります。
- Serial.begin()の速度をmonitor_speedの行に書き、プロジェクトをビルドします。エラー一覧に残った警告を1つずつ修正します。
別の方法として、PIO HomeのImport Arduino Project(Arduinoプロジェクトのインポート)ボタンで、既存のフォルダーを直接インポートすることもできます。PlatformIOは、srcフォルダー内の.inoファイルをビルド時に自動で.cppに変換し、プロトタイプの生成を試みます。ただし、この変換は複雑なコードでは失敗することがあり、.inoファイルではIntelliSenseが十分に働かないため、長い目で見ればmain.cppに移行するほうが確実です。ビルドのメッセージが読み解けないときは、「Arduinoのコンパイルエラー」の記事の説明がPlatformIOにもそのまま当てはまります。
Arduino IDEとPlatformIO、どちらを選ぶ?
| 項目 | Arduino IDE 2.x | PlatformIO(VS Code) |
|---|---|---|
| インストール | 1つのパッケージで数分 | VS Codeと拡張機能。初回セットアップでツールをダウンロード |
| コード補完 | 基本的 | 高度なIntelliSense、定義へ移動、一括での名前変更 |
| ボードの設定 | 「ツール」メニューにあり、プロジェクトと一緒に保存されない | platformio.iniにあり、プロジェクトと一緒に移る |
| ライブラリ | パソコン全体で共有 | プロジェクトごとに別々、バージョンを固定できる |
| 複数のボード | 毎回メニューから変更 | 1つのプロジェクトに複数の環境 |
| ファイル構成 | .ino。フォルダー名をファイル名と同じにする必要がある | src、include、lib。標準の.cppと.h |
| 関数のプロトタイプ | 自動で生成 | 手動で書く(.inoのインポート時は自動) |
| Gitでのバージョン管理 | 可能だが、ボードの設定は管理の外 | 簡単。.pioフォルダー以外はすべて管理できる |
| デバッグとテスト | 一部のボードでデバッガーが使える | デバッガー(デバッグプローブ)とユニットテストに対応 |
| 初心者への向き | とても高い | 中程度。少し慣れる期間が必要 |
まとめると、初めてLEDを点灯させる段階や、ファイルが数個の学校のプロジェクトなら、Arduino IDEで十分で、迷うことも少なくなります。複数のボード、複数ファイルのコード、Gitでのバージョン管理、チームでの開発が関わるなら、PlatformIOで大幅に時間を節約できます。2つのツールはどちらか一方しか使えないわけではなく、同じパソコンで両方を使えます。Arduino IDEをまだインストールしていない場合は、「Arduino IDEのインストール方法」の記事から始めてください。
よくある間違いと解決方法
| 症状 | 考えられる原因 | 解決方法 |
|---|---|---|
| エラー:'xyz' was not declared in this scope(宣言されていない) | 関数のプロトタイプがない | setup()の前にプロトタイプを書くか、関数を上に移動する |
| エラー:fatal error: DHT.h: No such file or directory(ファイルが見つからない) | ライブラリがlib_depsにない、または別の環境に追加されている | 正しい[env]セクションにライブラリを追加して再ビルドする |
| シリアルモニタで文字化け | monitor_speedとSerial.begin()の速度が違う | 2つの値をそろえる(例:115200) |
| ボードが表示されず、ポートがない | 充電専用ケーブル、またはCH340/CP2102のドライバがない | データ通信用ケーブルを使い、ドライバをインストールし、pio device listで確認する |
| Access is denied / Resource busy(ポート使用中) | ポートが別のソフトで開かれている | Arduino IDEのシリアルモニタやほかのターミナルを閉じる |
| ESP32でFailed to connectやWrong boot mode(起動モードが違う) | ボードがダウンロードモードに入っていない | BOOTボタンを押したまま書き込みを始める |
| Picoへの書き込みが始まらない | ボードがBOOTSELモードになっていない | BOOTSELを押したままつなぎ、RPI-RP2ドライブが表示されるか確認する |
| LinuxでPermission denied: /dev/ttyUSB0(権限がない) | udevルールまたはユーザーの権限がない | 99-platformio-udev.rulesファイルをインストールし、ユーザーをdialoutグループに追加する |
| Windowsで意味の分からないパスのエラーでビルドが止まる | ユーザー名に英語以外の文字やスペースがある | PLATFORMIO_CORE_DIRでコアのフォルダーをC:\platformioに移す |
| インストールが「Installing PlatformIO Core」の段階で止まる | インターネット、ウイルス対策ソフト、Pythonの問題 | VS Codeを再起動し、「出力」>「PlatformIO」のログを確認する |
PlatformIOで最初に試したいプロジェクト
- 複数ボードでのLED点滅:上の3つの環境を持つプロジェクトをUno、ESP32、Picoに順番に書き込み、環境の切り替えの仕組みを理解します。
- タイムスタンプ付きのセンサー記録:monitor_filters = timeの設定で、DHT11のデータを時刻付きでシリアルモニタに表示します。
- Wi-FiのWebサーバー:ESP32のWebサーバーのプロジェクトで、コードを複数の.cppと.hファイルに分けて整理された構成を作ります。
- 無線アップデート:ESP32のOTAで、upload_protocol = espotaを設定し、upload_portの行にボードのIPアドレスを書いて、Wi-Fi経由でコードを書き込みます。
- ステートマシン:Arduinoのステートマシンの処理を別のクラスファイルに書き、PlatformIOのフォルダー構成を活用します。
- delayを使わないタイミング処理:millis()を使って、複数の処理を同時に進めるプログラムを書きます。
PlatformIOのインストールは、最初はArduino IDEより少し時間がかかりますが、platformio.iniファイルがプロジェクトのすべての設定を1か所にまとめてくれるので、使ううちにいちばん時間を節約できるツールになります。セットアップが終わったら、まずは簡単なLEDのプロジェクトをビルドして書き込み、次にライブラリを使うプロジェクトや複数ボードのプロジェクトに進みましょう。BlueGraysアプリでは、LEDの点滅、ESP32とPicoの入門プロジェクト、DHT11やHC-SR04などのセンサーのプロジェクトを、回路図とコード付きでステップごとに確認できます。そのコードを自分のPlatformIOのプロジェクトにそのまま移して試せます。
よくある質問
PlatformIOは無料ですか?
はい。PlatformIO CoreとVS Code用のPlatformIO IDE拡張機能はオープンソースで、無料で使えます。趣味、学校、商用のどのプロジェクトでも、ボードの定義、ライブラリマネージャ、ビルド、書き込みの機能にライセンス料を払う必要はありません。
Arduino IDEのコードはPlatformIOで動きますか?
動きます。framework = arduinoを選ぶと、同じArduinoのコアと同じ関数が使われるためです。必要なのは、コードをsrc/main.cppに移し、先頭にArduino.hのincludeの行を追加し、関数のプロトタイプを書き、使っているライブラリをlib_depsに追加することだけです。
PlatformIOのインストールにこれほど時間がかかるのはなぜですか?
初回のセットアップでは、PlatformIO Core、Pythonの環境、基本的なツールがダウンロードされます。最初のプロジェクトでは、選んだボードのコンパイラとフレームワークもダウンロードされます。ESP32のパッケージは数百メガバイトになることもあるため、回線の速度によっては5〜15分かかります。一度パッケージをダウンロードすれば、以降のプロジェクトはすぐに開きます。
PlatformIOはMicroPythonに対応していますか?
いいえ。PlatformIOはArduinoやESP-IDFなどのC/C++ベースのフレームワーク向けに作られています。Raspberry Pi PicoやESP32をMicroPythonでプログラミングしたい場合は、Thonnyなどのエディターを使ってください。同じボードを、PlatformIOでArduinoのフレームワークを使ってプログラミングすることもできます。
PlatformIOでライブラリを追加するにはどうすればいいですか?
いちばん簡単なのは、PIO HomeでLibrariesタブを開いてライブラリを検索し、Add to Projectで自分のプロジェクトを選ぶ方法です。これでplatformio.iniにlib_depsの行が追加され、最初のビルドでライブラリが自動的にダウンロードされます。自作のライブラリは、プロジェクトのlibフォルダーにサブフォルダーとして置けます。
PlatformIOでCOMポートを選ぶにはどうすればいいですか?
PlatformIOはたいてい、接続されたボードを自動で見つけます。複数のシリアルデバイスがある場合は、ステータスバーのポートの切り替えを使うか、platformio.iniにupload_port = COM5とmonitor_port = COM5の行を書いて、ポートを固定できます。どのポートが接続されているかは、pio device listコマンドで確認できます。
この記事を読んだ後に作れるプロジェクト
全プロジェクトを見る
LEDの点滅
電子工作の第一歩は、1個のLEDを点けたり消したりすることです。Arduinoで短い間隔で点灯と消灯を繰り返すと、LEDが素早く点滅します。ボードが光を制御する仕組みを最もシンプルな形で確かめ、これから取り組むプロジェクトの基礎を身につけます。

ESP32でLEDを点滅
ESP32のGPIO出力の基本を学びます。デジタルピンからLEDを点灯・消灯させて、点滅させます。Arduino UNOの定番のLED点滅プロジェクトのESP32版です。Arduino環境で使う基本的な点滅コマンドは同じですが、ESP32のピン配置と3.3 VのGPIO電圧レベルはArduino UNOとは異なります。

Raspberry Pi Picoの内蔵LEDを点滅(PicoとPico W)
Raspberry Pi Picoシリーズの最初のプロジェクトです!ボード上の緑色LEDを点滅させて動作を確認する、定番の「Hello World」に相当する実験です。外付け部品は不要で、PicoとUSBケーブルだけで始められます。コードはMicroPython(Raspberry Pi Foundationが公式にサポートする言語)で書きます。Thonny IDEでmachine.Pinクラス、Pin.OUTモード、led.on()/off()メソッド、time.sleep()を学びます。シリアル(REPL)出力で、切り替わる様子をリアルタイムに確認できます。

DHT11で温度と湿度を測定
部屋の温度は何度で、空気は湿っているでしょうか、それとも乾燥しているでしょうか?DHT11センサーが温度と湿度を測定し、Arduinoが2行のLCDディスプレイに値を表示して、数秒ごとに更新します。センサーに異常があればエラーメッセージが表示されます。自分だけの小さな気象観測装置を作る第一歩です。

HC-SR04で距離を測定(シリアルモニタ表示)
HC-SR04センサーは、コウモリが暗闇で道を見つけるのと同じ仕組みで動作します。人には聞こえない音を出し、その反響を捉えて前方の物体までの距離を測ります。Arduinoは0.5秒ごとに距離をセンチメートル単位でコンピューターの画面に表示し、3〜100センチメートルの測定値を示します。駐車センサーや障害物を避けるロボットなどのプロジェクトの基礎になります。

ESP32の内蔵LEDを点滅
ESP32 DevKit V1に内蔵された青色LEDを点滅させます。外付け部品は不要です!ESP32を購入したら、最初に試すプロジェクトです。GPIO 2が内蔵LEDにつながっています。

Raspberry Pi Picoで外付けLEDを点灯(ブレッドボード)
Picoの内蔵LEDの次は、ブレッドボードに外付けLEDを接続し、GP14ピンで制御します。このプロジェクトでは、Picoの汎用GPIOピンを出力として使う方法、LEDの極性(長い足=アノード/+、短い足=カソード/−)、電流制限抵抗(220Ω)が必要な理由を学びます。抵抗を入れないと、LEDに過大な電流が流れて壊れることがあります。回路はとても簡単です。Pico GP14 → 220Ω抵抗 → LED(+)→ LED(−)→ Pico GND。Wokwiでシミュレーションできます。

ESP32でボタンによるLED制御(押している間だけ点灯)
ボタンを押している間はLEDが点灯し、離すと消灯します。ESP32のデジタル入力ピンと内蔵プルアップ抵抗の使い方を学びます。INPUT_PULLUPモードを使うため、外付け抵抗は不要です。
ほかの記事
BlueGraysアプリ
この回路をスマホでステップごとに作る
回路図、コード、部品リストを1つの画面で確認できます。Arduino、ESP32、Picoのプロジェクトを500件以上用意しています。

