最初のプログラム

まずは簡単なプログラムを作成してみましょう。

ここでは、最初のプログラムとして「シリアル通信」のプログラムを作ることにします。シリアル通信についてのより詳しい説明は「STEP04　シリアル通信」で行いますが、とりあえずは「マイコンからPCに文字列を送るプログラム」と考えておきましょう。

以下は、1秒おきにシリアルモニタに「Hello, world!」と出力するプログラムを作成する例です。

PlatformIOの設定

プロジェクトを新規作成したら、「platformio.ini」に「monitor_speed = 115200」と追記します。この設定が無い場合、シリアルモニタ上で文字化けが起こることがあります。

[env:esp32dev]
platform = espressif32
board = esp32dev
framework = arduino
monitor_speed = 115200
Code language: TOML, also INI (ini)

最小限のプログラム

エクスプローラで「src」→「main.cpp」を開いてみましょう。これがメインのプログラムファイルです。

プロジェクト作成直後には、main.cppにはプログラムの雛形となるコードが書かれています。以下は初期状態でのmain.cppのコード例です（実際のコードはPlatformIOのバージョン等により異なってくる場合があります）。

#include <Arduino.h>

// put function declarations here:
int myFunction(int, int);

void setup() {
  // put your setup code here, to run once:
  int result = myFunction(2, 3);
}

void loop() {
  // put your main code here, to run repeatedly:
}

// put function definitions here:
int myFunction(int x, int y) {
  return x + y;
}
Code language: Arduino (arduino)

プログラムのコードは、原則として「半角英数字」「半角記号」「半角スペース」「改行」のみが使用可能であり、上記コードもこれらのみで書かれています。

それでは、VSCodeの画面右上の「build」（画面右上のチェックマーク）をクリックし、このプロジェクトのビルド（コンパイルおよび実行ファイルの作成）が行えることを確認しましょう。画面下のターミナルに「SUCCESS」とのメッセージが表示されればビルド成功です。

なお、上記コードには適正なプログラムとして最小限必要なコードの他に、雛形として便利なコードがいくらか含まれています。最小限必要なコード以外を除去すると、以下のようになります。

#include <Arduino.h>

void setup() {
}

void loop() {
}
Code language: Arduino (arduino)

このコードもビルドできることを確認しておきましょう。

シリアル通信のプログラム

それでは、「1秒おきにシリアルモニタに「Hello, world!」と出力するプログラム」を作ってみましょう。

「main.cpp」を以下のようにコーディングしましょう。詳しい解説は後のSTEPで行いますので、まずはこの通り正確に書いてみましょう。

#include <Arduino.h>

void setup() {
  Serial.begin(115200);
}

void loop() {
  Serial.println("Hello, world!");
  delay(1000);
}
Code language: Arduino (arduino)

コーディングには「半角英数字」「半角記号」「半角スペース」「改行」のみを使いましょう。それ以外の文字（全角スペース等）を使うとエラーになる場合があるのでご注意ください。

コーディングが完了したら、VSCodeの画面右上の「Build」（チェックマーク）をクリックし、プロジェクトのビルド（コンパイルおよび実行ファイルの作成）を行います。ターミナルに「SUCCESS」とのメッセージが表示されればビルド成功です。

プログラムのマイコンへの書き込み

プロジェクトのビルドに成功したら、マイコンにプログラムを書き込みましょう。

まずは、PCとマイコンモジュールをUSB Micro-Bケーブルで接続します。

VSCodeの画面右上の「Upload」（矢印マーク）をクリックし、マイコンにプログラムをアップロード（書き込み）します。ターミナルに「SUCCESS」とのメッセージが表示されればアップロード成功です。

VSCodeの画面右上の「Serial Monitor」（コンセント状のマーク）をクリックし、シリアルモニターを表示します。VSCodeの画面下部の「ターミナル」に1秒おきに「Hello, world!」が出力されることを確認しましょう。

マイコンのリセット

以上が確認できたら、マイコンモジュールのENボタンを押してマイコンをリセットしてみましょう。リセット後、ターミナルにまずはマイコンに関する情報が出力され、その後「Hello, world!」が1秒おきに出力されることを確認しましょう。