HOWTO · Arduino
Arduino 串列埠列印多個變數
可以使用 Serial.print()和 Serial.println()函式在串列埠監視器上顯示變數值。
本頁內容
若要在 Arduino 串列埠監控視窗中顯示多個變數值,請先使用 Serial.begin() 初始化序列通訊,再用 Serial.print() 或 Serial.println() 傳送各個值。連續呼叫 Serial.print() 會在目前這一行繼續輸出;Serial.println() 則會在輸出值後換行。你可以在值與值之間加入文字,讓結果更容易閱讀。請將串列埠監控視窗設為與 Serial.begin() 相同的鮑率。
下方的完整範例會示範如何在同一行輸出以分隔符隔開的值、設定浮點數精度、將值分行輸出,以及輸出一組會變動的數值。範例中的輕量主機替代層可讓同一份程式碼以標準 C++ 執行:在 Arduino 上,Serial 和 delay() 由開發板核心提供;在電腦上,替代層會將內容輸出至標準輸出,並執行兩次範例迴圈。使用開發板時,請將串列埠監控視窗設為與 Serial.begin() 相同的鮑率。
使用 Serial.print() 在同一行輸出多個值
Serial.print() 會將值轉換為文字並輸出,但不會加上換行。你可以依序對每個欄位呼叫此函式,並在欄位之間輸出分隔符。範例在溫度與濕度讀數之間使用定位字元("\t"),因此輸出中會是定位字元,而不是反斜線和 t 這兩個可見字元。
輸出浮點數時,選用的第二個引數可指定小數點後要顯示幾位數。此處的 Serial.print(temperature, 2) 會要求顯示兩位小數。這只會改變顯示格式,不會改變變數中儲存的值。最後呼叫 Serial.println(),即可在該列末尾加上換行。精度引數適用於浮點數格式;整數則會以整數形式輸出。
使用 Serial.println() 將值分行輸出
若要讓每個值各自從新的一行開始,請使用 Serial.println(value)。它會輸出值並接著換行,因此連續呼叫會形成垂直排列的清單。在範例程式中,標籤與對應的值會留在同一行,因為每個標籤都使用 Serial.print(),而其對應的值則使用 Serial.println()。
請以 9600 鮑率開啟串列埠監控視窗,讓它與 Serial.begin(9600) 的設定一致。如果監控視窗使用不同的速率,即使程式傳送的是預期的值,收到的字元仍可能顯示為亂碼。每次呼叫 Serial.println() 都會在值後面加上換行,因此下一次呼叫會從新的一行開始。
合併使用兩個函式格式化變動的值
若要重複輸出讀數,請先用 Serial.print() 輸出第一個值和分隔符,再用 Serial.println() 輸出該列的最後一個值。下方的迴圈會輸出一組持續變動的值,兩者之間以定位字元分隔,並在每組值後換行。下一次迴圈執行前,濕度值會遞增;第二個值始終比第一個值大 5。在開發板上,迴圈會持續執行,並在每列輸出之間短暫暫停。主機替代層會執行兩次迴圈,讓你看出輸出如何變化。上方的同列輸出與分行輸出說明都指向這份完整範例,因此變數宣告和序列通訊設定只需寫在同一處。
修改範例時,如果另一個程式會剖析這些資料列,請維持欄位順序和分隔符一致;更改其中任一項都可能影響該程式。主機替代層只示範格式化方式,不會模擬開發板或串列埠監控視窗。
執行此範例。主機替代層會將內容輸出至標準輸出;在開發板上,Arduino 核心會提供相同的 Serial 呼叫,並持續執行 loop()。由於範例程式碼與輸出區塊須保持原樣,其中顯示的標籤和文字仍為英文。
#ifndef ARDUINO
#include <iostream>
class HostSerial {
public:
void begin(unsigned long) {}
void print(const char* value) { std::cout << value; }
void print(int value) { std::cout << value; }
void print(double value, int digits = 2) {
std::cout.setf(std::ios::fixed);
std::cout.precision(digits);
std::cout << value;
std::cout.unsetf(std::ios::fixed);
}
void println(const char* value) { print(value); std::cout << '\n'; }
void println(int value) { print(value); std::cout << '\n'; }
void println(double value, int digits = 2) { print(value, digits); std::cout << '\n'; }
};
HostSerial Serial;
void delay(unsigned long) {}
#endif
int humidity = 40;
void setup() {
Serial.begin(9600);
}
void loop() {
float temperature = 23.456;
Serial.print("Temperature: ");
Serial.print(temperature, 2);
Serial.print("\t");
Serial.print("Humidity: ");
Serial.println(humidity);
Serial.print("Temperature on its own line: ");
Serial.println(temperature, 2);
Serial.print("Humidity on its own line: ");
Serial.println(humidity);
int first = humidity;
int second = humidity + 5;
Serial.print(first);
Serial.print("\t");
Serial.println(second);
humidity++;
delay(1000);
}
#ifndef ARDUINO
int main() {
setup();
loop();
loop();
}
#endif
Temperature: 23.46 Humidity: 40
Temperature on its own line: 23.46
Humidity on its own line: 40
40 45
Temperature: 23.46 Humidity: 41
Temperature on its own line: 23.46
Humidity on its own line: 41
41 46