電子發燒友App
1、串口設置
Serial.begin（）;
說明
開啟串口，通常置于setup（）函數中。
語法
Serial.begin（speed）;
Serial.begin（speed，config）;
speed： 波特率，一般取值300， 1200， 2400， 4800， 9600， 14400， 19200， 28800， 38400， 57600，115200
config： 設置數據位、校驗位和停止位。例如Serial.begin（speed，Serial_8N1）; Serial_8N1中：8表示8個數據位，N表示沒有校驗，1表示有1個停止位。
返回
None
示例
［cpp］ view plain copy
void setup（） {
Serial.begin（9600）; // opensserial port， sets data rate to 9600 bps
}
Serial.end（）;
說明
禁止串口傳輸函數。此時串口傳輸的pin腳可以作為數字IO腳使用。
語法
Serial.end（）
參數
None
返回
None
2、清空串口緩存
Serial.flush（）;
說明
1.0版本之前為清空串口緩存，現在該函數作用為等待輸出數據傳送完畢。如果要清空串口緩存的話，可以使用：while（Serial.read（） 》= 0）來代替。
語法
Serial.flush （）
參數
None
返回
None
while（Serial.read（）》= 0）{}
說明
因Serial.read（）函數讀取串口緩存中的一個字符，并刪除已讀字符。因此可以用這句代碼來清空串口緩存。實驗代碼詳見下文代碼。
語法
while（Serial.read（） 》=0）{}
參數
None
返回
None
3、輸出串口數據
將打印輸出串口數據的函數在這一小節給出，方便大家閱讀后面的各個示例代碼。
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.println（val）
Serial.println（val，format）
參數
val： 打印的值，任意數據類型
format： 輸出的數據格式，包括整數類型和浮點型數據的小數點位數。
返回
字節
Serial.SerialEvent（）;
串口數據準備好時觸發的事件函數，即串口數據準備好調用該函數。
語法
Serial.serialEvent{//statements}
參數
statements： 任何有效的語句。
4、讀串口緩存區數據
Serial.available（）;
說明
判斷串口緩沖器的狀態函數，用以判斷數據是否送達串口。注意使用時通常用delay（100）以保證串口字符接收完畢，即保證Serial.available（）返回的是緩沖區準確的可讀字節數。
語法
Serial.available（）;
參數
None
返回
返回緩沖區可讀字節數目
示例
［cpp］ view plain copy
void setup（） {
Serial.begin（9600）;
while（Serial.read（）》= 0）{}//clear serialbuffer
}
void loop（） {
if （Serial.available（） 》 0） {
delay（100）; // 等待數據傳完
int numdata = Serial.available（）;
Serial.print（“Serial.available = ：”）;
Serial.println（numdata）;
}
while（Serial.read（）》=0）{} //清空串口緩存
}
實驗結果
Serial.read（）;
說明
讀取串口數據，一次讀一個字符，讀完后刪除已讀數據。
語法
Serial.read（）;
參數
None
返回
返回串口緩存中第一個可讀字節，當沒有可讀數據時返回-1，整數類型。
示例
［cpp］ view plain copy
char comchar;
void setup（） {
Serial.begin（9600）;
while（Serial.read（）》= 0）{}/ /clear serialbuffer
}
void loop（） {
// read data from serial port
while（Serial.available（）》0）{
comchar = Serial.read（）;//讀串口第一個字節
Serial.print（“Serial.read： ”）;
Serial.println（comchar）;
delay（100）;
}
}
實驗結果
從實驗結果可以看出：Serial.read（）每次從串口緩存中讀取第一個字符，并將讀過的字符刪除。
Serial.peek（）;
說明
讀串口緩存中下一字節的數據（字符型），但不從內部緩存中刪除該數據。也就是說，連續的調用peek（）將返回同一個字符。而調用read（）則會返回下一個字符。
語法
Serial.peek（）;
參數
None
返回
返回串口緩存中下一字節（字符）的數據，如果沒有返回-1，整數int型
示例
［cpp］ view plain copy
char comchar;
void setup（） {
Serial.begin（9600）;
while（Serial.read（）》= 0）{}//clear serialbuffer
}
void loop（） {
// read data from serial port
while（Serial.available（）》0）{
comchar = Serial.peek（）;
Serial.print（“Serial.peek： ”）;
Serial.println（comchar）;
delay（100）;
}
}
實驗結果
從實驗結果可以看出：Serial.peek（）每次從串口緩存中讀取一個字符，并不會將讀過的字符刪除。第二次讀取時仍然為同一個字符。
Serial.readBytes（buffer，length）;
說明
從串口讀取指定長度length的字符到緩存數組buffer。
語法
Serial.readBytes（buffer，length）;
參數
buffer： 緩存變量
length：設定的讀取長度
返回
返回存入緩存的字符數，0表示沒有有效數據。
示例
［cpp］ view plain copy
char buffer［18］;
int numdata=0;
void setup（） {
Serial.begin（9600）;
while（Serial.read（）》= 0）{}//clear serial port
}
void loop（） {
// read data from serial port
if（Serial.available（）》0）{
delay（100）;
numdata = Serial.readBytes（buffer，3）;
Serial.print（“Serial.readBytes：”）;
Serial.println（buffer）;
}
// clear serial buffer
while（Serial.read（） 》= 0）{}
for（int i=0; i《18; i++）{
buffer［i］=‘\0’;
}
}
實驗結果
從串口緩存讀取指定長度為3的字節。
Serial.readBytesUntil（character，buffer，length）;
說明
從串口緩存讀取指定長度的字符到數組buffer，遇到終止字符character后停止。
語法
Serial.readBytesUntil（character ，buffer，length）;
參數
character ： 查找的字符 （char）
buffer： 存儲讀取數據的緩存（char［］ 或byte［］）
length：設定的讀取長度
返回
返回存入緩存的字符數，0表示沒有有效數據。
示例
［cpp］ view plain copy
char buffer［18］;
char character = ‘，’; //終止字符
int numdata=0;
void setup（） {
Serial.begin（9600）;
while（Serial.read（）》= 0）{}//clear serialport
}
void loop（） {
// read data from serial port
if（Serial.available（）》0）{
delay（100）;
numdata =Serial.readBytesUntil（character，buffer，3）;
Serial.print（“Serial.readBytes：”）;
Serial.println（buffer）;
}
// clear serial buffer
while（Serial.read（） 》= 0）{}
for（int i=0; i《18; i++）{
buffer［i］=‘\0’;
}
}
實驗結果
從串口緩存中讀取3個字符，當遇到“，”時終止讀取。
Serial.readString（）；
說明
從串口緩存區讀取全部數據到一個字符串型變量。
語法
Serial.readString（）;
參數
None
返回
返回從串口緩存區中讀取的一個字符串。
示例
［cpp］ view plain copy
String comdata = “”;
void setup（） {
Serial.begin（9600）;
while（Serial.read（）》= 0）{} //clear serialbuffer
}
void loop（） {
// read data from serial port
if（Serial.available（）》0）{
delay（100）;
comdata = Serial.readString（）;
Serial.print（“Serial.readString：”）;
Serial.println（comdata）;
}
comdata = “”;
}
實驗結果
從實驗結果可以看出：Serial.readString（）從串口緩存中讀取字符至字符串。
Serial.readStringUntil（）；
說明
從串口緩存區讀取字符到一個字符串型變量，直至讀完或遇到某終止字符。
語法
Serial.readStringUntil（terminator）
參數
terminator：終止字符（cha型）
返回
從串口緩存區中讀取的整個字符串，直至檢測到終止字符。
示例
［cpp］ view plain copy
String comdata = “”;
char terminator = ‘，’;
void setup（） {
Serial.begin（9600）;
while（Serial.read（）》= 0）{} //clear serialbuffer
}
void loop（） {
// read data from serial port
if（Serial.available（）》0）{
delay（100）;
comdata =Serial.readStringUntil（terminator）;
Serial.print（“Serial.readStringUntil： ”）;
Serial.println（comdata）;
}
while（Serial.read（）》= 0）{}
}
實驗結果
從串口讀取所有字符存放于字符串comdata，直至遇到字符“，”時終止讀取。
Serial.parseFloat（）;
說明
讀串口緩存區第一個有效的浮點型數據，數字將被跳過。當讀到第一個非浮點數時函數結束。
語法
Serial.parseFloat（）
參數
None
返回
返回串口緩存區第一個有效的浮點型數據，數字將被跳過。
示例
［cpp］ view plain copy
float comfloat;
void setup（） {
Serial.begin（9600）;
while（Serial.read（）》= 0）{}//clear serialbuffer
}
void loop（） {
// read data from serial port
if（Serial.available（）》0）{
delay（100）;
comfloat = Serial.parseFloat（）;
Serial.print（“Serial.parseFloat：”）;
Serial.println（comfloat）;
}
// clear serial buffer
while（Serial.read（） 》= 0）{}
}
實驗結果
從實驗結果可以看出：Serial. parseFloat（）從串口緩存中讀取第一個有效的浮點數，第一個有效數字之前的負號也將被讀取，獨立的負號將被舍棄。
Serial.parseInt（）
說明
從串口接收數據流中讀取第一個有效整數（包括負數）。
注意：
非數字的首字符或者負號將被跳過
當可配置的超時值沒有讀到有效字符時，或者讀不到有效整數時，分析停止
如果超時且讀不到有效整數時，返回0
語法
Serial.parseInt（）
Serial.parseInt（charskipChar）
參數
skipChar用于在搜索中跳過指定字符（此用法未知）
返回
返回下一個有效整型值。
示例
［cpp］ view plain copy
int comInt;
voidsetup（） {
Serial.begin（9600）;
while（Serial.read（）》= 0）{}//clear serialbuffer
}
void loop（） {
// read data from serial port
if（Serial.available（）》0）{
delay（100）;
comInt = Serial.parseInt（）;
Serial.print（“Serial.parseInt：”）;
Serial.println（comInt）;
}
// clear serial buffer
while（Serial.read（） 》= 0）{}
}
實驗結果
從實驗結果可以看出：Serial. parseInt（）從串口緩存中讀取第一個有效整數，第一個有效數字之前的負號也將被讀取，獨立的負號將被舍棄。
5.串口查找指定字符串
Serial.find（）
說明
從串口緩存區讀取數據，尋找目標字符串target（char型）
語法
char target［］ = ”目標字符串”;
Serial.find（target）;
參數
target： 目標字符串（char型）
返回
找到目標字符串返回真，否則為假
示例
［cpp］ view plain copy
char target［］ =“test”;
void setup（） {
Serial.begin（9600）;
while（Serial.read（）》= 0）{}//clear serialbuffer
}
void loop（） {
// read data from serial port
if（Serial.available（）》0）{
delay（100）;
if（ Serial.find（target））{
Serial.print（“find traget：”）;
Serial.println（target）;
}
}
// clear serial buffer
while（Serial.read（） 》= 0）{}
}
實驗結果
串口輸入字符中只要有test，函數返回真，打印出目標字符串”test”，否則返回假，不打印任何值。
Serial.findUntil（target，terminal）;
說明
從串口緩存區讀取數據，尋找目標字符串target（char型數組），直到出現給定字符串terminal（char型），找到為真，否則為假。
語法
Serial.findUntil（target，terminal）;
參數
target ： 目標字符串（char型）
terminal ： 結束搜索字符串（char型）
返回
如果在找到終止字符terminal之前找到目標字符target，返回真，否則返回假。
示例
［cpp］ view plain copy
char target［］ =“test”;
char terminal［］ =“end”;
void setup（） {
Serial.begin（9600）;
while（Serial.read（）》= 0）{}//clear serialbuffer
}
void loop（） {
// read data from serial port
if（Serial.available（）》0）{
delay（100）;
if（ Serial.findUntil（target，terminal））{
Serial.print（“find traget：”）;
Serial.println（target）;
}
}
// clear serial buffer
while（Serial.read（） 》= 0）{}
}
實驗結果
如果串口緩存中有目標字符”test”，返回真，但如果先遇到終止字符串”end”則函數立即終止，不論字符串后面有沒有目標字符”test”。
6.向串口寫數據
Serial.write（）;
說明
串口輸出數據函數。寫二進制數據到串口。
語法
Serial.write（val）
Serial.write（str）
Serial.write（buf， len）
參數
val： 字節
str： 一串字節
buf： 字節數組
len： buf的長度
返回
字節長度
示例
［cpp］ view plain copy
void setup（）{
Serial.begin（9600）;
}
void loop（）{
Serial.write（45）; // send a byte with thevalue 45
int bytesSent = Serial.write（“hello”）; //sendthe string “hello” and return the length of the string.
}
工商網監
評論