HOWTO · Arduino

Arduino でコンソールに印刷する方法

このチュートリアルでは、Arduino IDE のシリアルモニターを使用してコンソールにテキストや変数を印刷する方法について説明します。

このページの内容

コンソールは、しばしばシリアルモニターと呼ばれ、Arduino の動作を覗く仮想的な窓として機能します。

これにより、マイクロコントローラーからコンピューターへ情報を送信したり、その逆にデータを受け取ったりできます。この双方向通信は、初心者にとっても経験豊富な Arduino 愛好家にとっても強力なツールです。

このチュートリアルでは、Arduino IDE のシリアルモニターを使用してコンソールにテキストや変数を印刷する方法について説明します。Serial.print() と Serial.println() の使用の基礎から始めて、Serial.write() を利用したバイナリ データ送信のような、より高度な戦略へと進みます。

Arduino でシリアルモニターを使ってコンソールに印刷する

Arduino IDE には下部にコンソールがありますが、そこには何も印刷できません。コンソールは、コードの検証とコンパイル時の情報を表示するためだけのものです。

コンソールには、コードのメモリ使用量 (バイト単位) と、コードの検証やアップロード時のエラーが表示されます。変数に格納された値を印刷または表示するには、Arduino IDE のシリアルモニターを使用できます。

シリアルモニターは Arduino IDE の組み込みツールで、Arduino ボードと通信できます。Arduino からコンピューターへデータを送信したり、コンピューターから Arduino へデータを受信したりする便利な方法を提供します。

シリアルモニターは、Arduino IDE ツールバーの Tools タブを使って起動できます。

serial monitor in tools tab

Note
シリアルモニターは、Arduino ボードが Arduino IDE に接続されているときにのみ実行できます。

シリアルモニターで Serial.print() 関数と Serial.println() 関数を使う

Serial.begin() 関数を使用すると、特定のボーレートや速度でシリアル通信を開始できます。Serial.print() 関数と Serial.println() 関数を使用すると、シリアルモニターにテキストや変数を印刷できます。

Serial.print() と Serial.println() の構文:

Serial.print(data);
Serial.println(data);

パラメーター:

  • data:シリアルポートに送信したいデータ。整数、浮動小数点数、文字、文字列など、さまざまな型を使用できます。

追加のパラメーター (任意):

  • format:このパラメーターでは、データを印刷する形式を指定できます。次のいずれかです。
    1. DEC:10 進数として印刷します。
    2. BIN:2 進数として印刷します。
    3. OCT:8 進数として印刷します。
    4. HEX:16 進数として印刷します。

Serial.print() と Serial.println() の違いは、print() 関数は変数を印刷し、カーソルは同じ行に留まるのに対し、println() 関数では変数を印刷した後、カーソルが次の行に移動することです。

たとえば、2 つの変数を同じ行に印刷し、3 つ目の変数を次の行に印刷したいとします。その場合、print() 関数を使って最初の変数を印刷し、次に println() 関数を使って 2 つ目の変数を印刷してカーソルを次の行に移動させ、さらに print() 関数を再び使って 3 つ目の変数を印刷します。

いくつかの変数を定義し、それらをシリアルモニターに印刷してみましょう。以下のコードを参照してください。

例:

int My_Int = 10;
unsigned long My_TimeStamp = 1416803716;
const char *My_CharArray = {"This is My_CharArray"};
float My_Float = 3.14159266759;

void setup() {
  Serial.begin(9600);
  Serial.println(My_Int);
  Serial.println(My_TimeStamp);
  Serial.println(My_CharArray);
  Serial.print(My_Float, 5);  // prints to five places right of the decimal
}
void loop() {
  // put your code here to run repeatedly
}

このコードは、異なるデータ型の変数をいくつか宣言することから始まります。setup() では、シリアル通信が 9600 のボーレートで設定されます。次に、Serial.print() と Serial.println() を使って変数の値を印刷します。

変数をシリアルモニターに一度だけ印刷したい場合は、setup() 関数は Arduino ボードの電源が入ったときに一度だけ実行されるため、その中で Serial.print() 関数を使用できます。

変数を継続的に印刷したい場合は、loop() 関数の中で印刷しなければなりません。その中のコードは Arduino の電源が入っている間ループして実行されるためです。シリアルモニターを使えば、すべてのデータ型の変数を印刷できます。

出力:

10
1416803716
This is My_CharArray
3.14159

Serial.print() 関数の 2 つ目の引数を定義することもできます (上記のサンプル コードと同様)。これは変数の値を印刷する形式です。

たとえば、整数や long データ型の場合、BIN は 2 進数、DEC は 10 進数のように、表示したい記数法を定義できます。デフォルトでは、数値は 10 進数で表示されます。

浮動小数点数の場合、シリアルモニターに印刷したい数値の小数点以下の桁数を定義できます。Serial.print() 関数の詳細については、このリンクを確認してください。

Serial.write() 関数を使ってバイナリ データをシリアルモニターに送信する

Serial.print() 関数内のデータは ASCII 表現に変換されます。データをバイトのストリームとして送信したい場合は、Serial.print() 関数の代わりに Serial.write() 関数 を使用できます。

Arduino プログラミングでは、Serial.write() 関数はシリアル接続を介してバイナリ データを送信するために使用されます。解釈を介さずに、1 バイトまたは一連のバイトを直接送信できます。

これは、生データや制御コードを送信する必要がある場合に特に便利です。

構文:

Serial.write(data);

パラメーター:

  • data:シリアル接続を介して送信したいバイトまたはデータ配列。単一のバイト (符号なし char) またはバイトの配列です。

追加のパラメーター (任意):

  • length:配列から送信するバイト数。このパラメーターは、データの配列を送信するときに使用されます。

Serial.write() を使用すると、バイナリ データをコンソールに送信できます。テキスト以外のデータを扱う場合や、バイナリ通信を必要とする他のデバイスと接続する場合に便利です。

例:

void loop() {
  byte data[] = {0x48, 0x65, 0x6C, 0x6C, 0x6F};  // ASCII values of "Hello"
  Serial.write(data, sizeof(data));
  delay(1000);
}

このコードは、'H'、'e'、'l'、'l'、'o' の ASCII 値を 1 秒の間隔を空けて次々にシリアルモニターへ送信します。このコードを実行してシリアルモニターを開くと、コンソールに "Hello" が表示されます。

結論

結論として、コンソールへの印刷は、強力なデバッグおよび監視ツールを操ることに等しいと言えます。このガイドを通じて、基本的な Serial.print() 関数と Serial.println() 関数から、Serial.write() によるバイナリ データ送信のような高度な戦略まで、シリアルモニターを使用するさまざまな方法を探ってきました。

これらのテクニックを理解し、効果的に活用することで、Arduino とコンピューターの間でシームレスに通信できます。これにより、センサー データのリアルタイム監視から、複雑なコード ロジックのトラブルシューティングまで、さまざまな可能性が開かれます。