Arduino Serial庫的使用

---

1 Serial.begin()
2 Serial.end()
3 Serial.available()
4 Serial.read()
5 Serial.peek()
6 Serial.flush()
7 Serial.print()
8 Serial.println()
9 Serial.write()
10 Serial.serialEvent()

Serial.begin()

串口波特率定義函數。一般取值300, 1200, 2400, 4800, 9600, 14400, 19200, 28800, 38400, 57600, or 115200。

語法
Serial.begin(speed)

參數
speed: 速率，長整數型long

返回
None

例子
void setup() {
Serial.begin(9600); // opens serial port, sets data rate to 9600 bps
}

Serial.end()

禁止串口傳輸函數。此時串口傳輸的pin腳可以作為數字IO腳使用。

語法
Serial.end()

參數
None

返回
None

Serial.available()

判斷串口接收緩沖器的狀態函數。讀取串口接收緩沖器的值（128字節寄存器），以判斷數據送達到串口。

語法
Serial.available()

參數
None

返回
串口已經准備好的字節數

例子
int incomingByte = 0; // for incoming serial data

void setup()
{
Serial.begin(9600); // opens serial port, sets data rate to 9600 bps
}

void loop()
{
// send data only when you receive data:
if (Serial.available() > 0)
{
incomingByte = Serial.read(); // read the incoming byte:
Serial.print("I received: "); // say what you got:
Serial.println(incomingByte, DEC);
}
}

Serial.read()

讀取串口函數。

語法
Serial.read()

參數
None

返回
串口的數據第一個字節，如果沒有返回-1；整數類型int

Serial.peek()

串口讀取函數。返回的是串口數據中下一字節的內容。

語法
Serial.peek()

參數
None

返回
串口數據中下一個字節內容，如果沒有返回-1；整數類型int

Serial.flush()

清除串口緩沖器內容函數。

語法
Serial.flush()

參數
None

返回
None

Serial.print()

串口輸出數據函數。

語法
Serial.print(val)
Serial.print(val,format)

參數
val: 打印的值，任意數據類型
format: 輸出的數據格式，包括整數類型和浮點型數據的小數點位數。

返回
字節

例子
Serial.print(78, BIN) 得到 "1001110"
Serial.print(78, OCT) 得到 "116"
Serial.print(78, DEC) 得到 "78"
Serial.print(78, HEX) 得到 "4E"
Serial.print(1.23456, 0) 得到 "1"
Serial.print(1.23456, 2) 得到 "1.23"
Serial.print(1.23456, 4) 得到 "1.2346"
Serial.print('N') 得到 "N"
Serial.print("Hello world.") 得到 "Hello world."

Serial.println()

串口輸出數據函數。與Serial.print()不同的是輸出數據帶回車符。

語法
Serial.println(val)
Serial.println(val,format)

參數
val: 打印的值，任意數據類型
format: 輸出的數據格式，包括整數類型和浮點型數據的小數點位數。

返回
字節

Serial.write()

串口輸出數據函數。寫二進制數據到串口。

語法
Serial.write(val)
Serial.write(str)
Serial.write(buf, len)

參數
val: 字節
str: 一串字節
buf: 字節數組
len: buf的長度

返回
字節

例子
void setup()
{
Serial.begin(9600);
}

void loop()
{
Serial.write(45); // send a byte with the value 45
int bytesSent = Serial.write(“hello”);
//send the string “hello” and return the length of the string.
}

Serial.serialEvent()

串口數據准備好調用該函數。

語法
Serial.serialEvent{//statements}

參數
statements: 任何有效的語句。