Arduinoで開発環境構築(Arduino IED、Visual Studio Code) + Arduino言語入門

本記事について

Arduinoをこれから始める人向けにプログラミング環境を快適にできる開発環境構築の手引きになるようなものを記述します。
それプラス、簡単にArduino言語についての説明をします。

本記事における筆者の開発環境

Windows10 バージョン2004 (OSビルド 19041.630)
Arduino IDE version 1.8.13
Visual Studio Code 1.52.0 (以下vscode)
Arduino for Visual Studio Code 0.3.4
Arduino Uno R3

インストール

vscodeとArduino IDEをインストールします。
vscodeはたくさん記事があるので、Arduino IDEのインストール方法を記述します。

Arduino IDEのインストール

いきなりですが、Arduino IDEはMicrosoftストアからダウンロード、インストールしてはいけません。
筆者の環境では以下のようなエラーが発生してコンパイルできませんでした。

[Starting] Upload sketch - blink.ino
[Warning] Output path is not specified. Unable to reuse previously compiled files. Upload could be slow. See README.
[Error] Exit with code=EPERM

<参考>
https://github.com/microsoft/vscode-arduino/issues/842
※2020/12/20現在の話なのでいずれ解消されることを期待します。。。

そのため、公式からダウンロード、インストールします。
https://www.arduino.cc/en/software
このページにもWindows appつまりMicrosoftストアへのリンクもあるので注意しましょう。

exeファイルをダウンロードしてポチポチするだけなのでインストールにつまるところはないと思います。

IDE起動

いくつかのドライバーをインストールするとき、Windowsセキュリティの警告がはいるかもしれませんが
信頼して「インストール」を押下しましょう。
無事インストールが成功して起動して以下のようになればOKです。

実機接続確認

Arduino UnoをUSB接続します。
接続したら以下を確認しましょう。

ボード

「ツール」-「ボード」-「Arduino Uno」

今回はArduino Unoなので上記画像のようになります。自分のもっているボードを選択しましょう。DUEなどインストール初期では存在しないボードなどもあるので、その場合はボードマネージャ...からインストールをしましょう。

シリアルポート

「ツール」-「シリアルポート」

ここに上記のような画像で接続したArduinoが表示されていれば認識されているはずです。
今回はCOM3を選択します。

コンパイル

上記のボタンを押します。

上記のようになれば成功です。
実機に転送する前に、ビルドができるかチェックする目的に使います。

転送

上記のボタンを押します。

上記のようになれば成功です。
何も実行されないプログラムが転送されました。

Arduino言語

やっと言語の記述をします。
Arduino言語はざっくりいうとほぼC言語の同じような仕様になっています。
なのでC言語を調べれば大体のことは解決すると思いますが、それだとあっさりすぎるので
Arduino言語を始めるに当たって特有のことで知っておいたほうがいいことを少しだけ記述します。

setupとloop

IDEを起動したとき最初から書いてあるテンプレートの記述です。
setup関数は、Arduinoに電源をいれたときなどに一度だけ実行される関数です。
主に初期化(ピンのセットアップなど)する処理を記述します。
loop関数は、setupが呼ばれた後、延々ループして呼ばれる関数です。
ここでピン状態の監視などをして、なにか具体的な処理(LEDを光らせるなど)を記述します。

void setup() {
  // put your setup code here, to run once:
}

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

}

シリアル通信で出力

上記のソースコードに
Serial.begin(9600);
Serial.println("setup");
の2行を追加しました。
シリアル通信で出力を行っています。
具体的にシリアル通信がなにかというよりも、ここで知ってもらいたいのは
ログのようなもの出力してデバックする用途で使えます。

void setup() {
  // put your setup code here, to run once:
  Serial.begin(9600);
  Serial.println("setup");
}

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

}

「ツール」-「シリアルモニタ」

赤丸のところが今回は初期値の「9600bps」になっていることを確認します。
そうすると"setup"と上記のソースコードのprintlnの内容が出力されます。

デジタル入出力

Arduinoに限らず大体似たようなボードの目的には
・ピンの電圧を読む
・ピンから電圧を出力する
ということが基本的にな目的となります。

PinModeの設定

読む(Read)、出力する(Write)するためには、まずピンをReadもしくはWriteどちらとして機能するか設定する必要があります。
以下が例です。

void setup() {
  // 13番ピンを読み込みに設定
  pinMode(13, INPUT);
  // 14番ピンを出力に設定
  pinMode(14, OUTPUT);
}

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

}

digitalReadでピンの読み込み

PinModeでINPUTにしたピンを読み込みます。
HIGH(1)またはLOW(0)が戻るのでそれでなにかを処理します。

void setup() {
  // 13番ピンを読み込みに設定
  pinMode(13, INPUT);
}

void loop() {
  // ピンを読む
  int hl = digitalRead(13);
}

digitalWriteでピンの出力

PinModeでOUTPUTにしたピンに出力を行います。
電圧を出力してLEDを光らせたりするなどの用途に使用できます。

void setup() {
  // 出力に設定
  pinMode(14, OUTPUT);

}

void loop() {
  // HIGEを出力する
  digitalWrite(14, HIGH);
}

参考

詳細は以下の「Arduino 日本語リファレンス」を参照ください。
http://www.musashinodenpa.com/arduino/ref/

VsCodeとArduino IDEの連携

上記まで一通り環境が整ったので、そのままArduino IDEで開発をすするめることが可能ですが
Arduino IDEが最小限の機能しかなかったりするので
やはりVsCodeを連携させると、色々な機能が使えて便利になります。

Arduino for Visual Studio Codeのインストール

VsCodeの拡張インストールで検索してインストールします。

プロジェクトを開く

Arduino IDEで作成したフォルダを開きます。
.inoファイルが入ったフォルダがArduinoプロジェクトになります。

なにやら赤い破線でエラーっぽくなっていますが一旦無視します。

Command PathとPathの設定

以下の画像のように選択して、拡張機能の設定をします。

Command Pathへ「arduino_debug.exe」をいれます。

Pathに「C:\Program Files (x86)\Arduino」をいれます。
ここは本ページの環境手順であればこのようなパスになりますが、環境によって変わるので適宜置き換えてください。

ここまで設定したらvscodeを再起動させます。設定が反映させるためです。

ボードの設定

Arduino IDEでも行ったボードの設定を行います。
vscodeの右下から「Select Board Type」を選択します。

ここで接続中のボードを選択します。

ここの設定で上記にあったソースコードの赤い破線は消えるかと思います。

シリアルポートの設定

Arduino IDEでも行ったシリアルポートの設定を行います。

Arduino IDEと同様にCOM3を選択します。

コンパイル

右上のボタンを押します。

なにやらArduino IDEよりたくさんログがでますが、以下のようになれば成功です。

転送

右上のボタンを押します。

以下のようになれば成功です。

日本語文字出力の文字化け対応

今回の指定バージョンでは出力ログが文字化けしていたので修正します。
筆者の環境では以下のファイルを修正します。
「C:\Users\username\.vscode\extensions\vsciot-vscode.vscode-arduino-0.3.4\out\src\common\util.js」
215行目ぐらいのif文をコメントアウトします。

/*
        if (os.platform() === "win32") {
            try {
                const chcp = childProcess.execSync("chcp.com");
                codepage = chcp.toString().split(":").pop().trim();
            }
            catch (error) {
                outputChannel_1.arduinoChannel.warning(`Defaulting to code page 850 because chcp.com failed.\
                \rEnsure your path includes %SystemRoot%\\system32\r${error.message}`);
                codepage = "850";
            }
        }
*/

治りました。

終わりに

Arduino IDEでもよいですが
やはりvscodeのライブラリを使えるのはかなりの恩恵な気がします。
簡単ではありましたが、Arduino + vscodeでよりよい開発Lifeを！！