ガイド · 読了まで16分

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でプログラミングするArduino Unoボード
PlatformIOを使えば、Arduino Uno、ESP32、Raspberry Pi Picoなどのボードを、同じエディターから1つの設定ファイルでプログラミングできます。

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のインストール手順

  1. Visual Studio Codeを公式サイトからダウンロードしてインストールします。Windowsでは、インストール中にAdd to PATH(PATHへの追加)にチェックを入れておくと、ターミナルが使いやすくなります。
  2. VS Codeを開き、左側の「拡張機能」タブをクリックするか、Ctrl+Shift+X(macOSではCmd+Shift+X)のショートカットを使います。
  3. 検索ボックスにPlatformIO IDEと入力し、PlatformIOが公開している拡張機能をInstall(インストール)ボタンでインストールします。必要なC/C++の拡張機能も自動的に一緒に入ります。
  4. 右下に「Installing PlatformIO Core」という通知が表示されます。インターネットの速度によって数分かかります。その間はVS Codeを閉じないでください。
  5. インストールが終わると、VS Codeの再起動を求められます。再起動すると、左端にPlatformIOのアイコン、下のステータスバーに家のアイコンが表示されます。
  6. 家のアイコンをクリックしてPIO Home画面を開きます。この画面が問題なく表示されれば、インストールは完了です。
Windowsのユーザー名にアクセント付きの文字や英語以外の文字(日本語など)やスペースが含まれていると、PlatformIOのツールチェーンがC:\Users\<name>\.platformioのパスで問題を起こし、意味の分からないパスのエラーでビルドが止まることがあります。解決方法は、システムの環境変数にPLATFORMIO_CORE_DIRを追加し、その値をC:\platformioのような半角英字だけのフォルダーにすることです。Linuxでインストールがエラーになる場合は、まずpython3-venvパッケージがインストールされているか確認してください。

最初のプロジェクトの作成とフォルダー構成

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用に作成されたファイルにシリアルモニタの速度を追加すると、ファイルは次のようになります。

C++ (Arduino IDE)
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ボードのIDuno、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)のプログラムです。

C++ (Arduino IDE)
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}
コンパイル時に'blinkLed' was not declared in this scope(宣言されていない)というエラーが出たら、足りないのはほぼ必ずプロトタイプです。関数の1行目を本体なしで、末尾にセミコロンを付けてsetup()の上にコピーするだけで解決します。関数が多い場合は、includeフォルダーの.hファイルにまとめると整理しやすくなります。

ビルド、書き込み、シリアルモニタ

操作ステータスバー/メニューターミナルのコマンド
ビルド(Build)チェックマークpio run(ビルド)
書き込み(Upload)右向きの矢印pio run -t upload(書き込み)
書き込んでモニタを開くPlatformIOメニュー > Upload and Monitorpio run -t upload -t monitor(書き込みとモニタ)
シリアルモニタプラグのアイコンpio device monitor(シリアルモニタ)
クリーンゴミ箱pio run -t clean(クリーン)
ポートの一覧PIO Home > Devicespio device list(ポートの一覧)
特定の環境をビルド環境の切り替え(env:...)pio run -e esp32dev(esp32devだけをビルド)
ライブラリのインストールPIO Home > Librariespio 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 UnoESP32 DevKitRaspberry Pi Pico
platformatmelavrespressif32raspberrypi
boardunoesp32devpico
frameworkarduinoarduinoarduino(Arduino Mbedコア)
内蔵LEDD13GPIO 2(多くのDevKitボード)GP25
書き込み方法USBシリアルとブートローダーUSBシリアルとesptoolUSBとBOOTSELモード
一般的なmonitor_speed9600または115200115200115200
C++ (Arduino IDE)
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 = pico

default_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温湿度センサー」の記事を参照してください。

C++ (Arduino IDE)
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.9
C++ (Arduino IDE)
1#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へのプロジェクトの移行

  1. PIO Homeで新しいプロジェクトを作成し、Arduino IDEで使っていたのと同じボードを選びます。
  2. .inoファイルの内容をsrc/main.cppに貼り付けます。同じフォルダーにあるほかの.inoタブはmain.cppの末尾に追加し、.hと.cppファイルはsrcフォルダーにコピーします。
  3. ファイルのいちばん上に、Arduino.hの#includeの行を追加します。
  4. setup()とloop()以外に書いたすべての関数について、ファイルの上部にプロトタイプを書きます。
  5. 使っているライブラリをPIO Home > Librariesで探してlib_depsに追加します。Arduino IDEで使っていたバージョン番号を書けば、同じ動作になります。
  6. 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.xPlatformIO(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」のログを確認する
ビルドは成功するのに、IntelliSenseがコードに赤い波線を付けることがあります。これはたいてい、VS Codeでプロジェクトのサブフォルダーを開いているか、インデックスが更新されていないことを意味します。必ずplatformio.iniがあるフォルダーを開き、コマンドパレット(Ctrl+Shift+P)からPlatformIO: Rebuild IntelliSense Indexコマンドを実行してください。

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の点滅
AR-1初級

LEDの点滅

電子工作の第一歩は、1個のLEDを点けたり消したりすることです。Arduinoで短い間隔で点灯と消灯を繰り返すと、LEDが素早く点滅します。ボードが光を制御する仕組みを最もシンプルな形で確かめ、これから取り組むプロジェクトの基礎を身につけます。

4.6(200)
1246
ESP32でLEDを点滅
ES-1初級

ESP32でLEDを点滅

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

4.7(37)
108
Raspberry Pi Picoの内蔵LEDを点滅(PicoとPico W)
PI-1初級

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)出力で、切り替わる様子をリアルタイムに確認できます。

5.0(1)
10
DHT11で温度と湿度を測定
AR-55中級

DHT11で温度と湿度を測定

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

4.7(47)
83
HC-SR04で距離を測定(シリアルモニタ表示)
AR-27初級

HC-SR04で距離を測定(シリアルモニタ表示)

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

4.6(50)
82
ESP32の内蔵LEDを点滅
ES-4初級

ESP32の内蔵LEDを点滅

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

4.8(29)
54
Raspberry Pi Picoで外付けLEDを点灯(ブレッドボード)
PI-2初級

Raspberry Pi Picoで外付けLEDを点灯(ブレッドボード)

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

4.5(2)
7
ESP32でボタンによるLED制御(押している間だけ点灯)
ES-2初級

ESP32でボタンによるLED制御(押している間だけ点灯)

ボタンを押している間はLEDが点灯し、離すと消灯します。ESP32のデジタル入力ピンと内蔵プルアップ抵抗の使い方を学びます。INPUT_PULLUPモードを使うため、外付け抵抗は不要です。

4.6(36)
57