Arduino串口函数详解

最新推荐文章于 2024-04-17 22:29:43 发布

LoveArduinos

最新推荐文章于 2024-04-17 22:29:43 发布

阅读量9.4k

点赞数 14

文章标签：单片机嵌入式硬件

原文链接：https://blog.csdn.net/yangchangqi789/article/details/119567104

版权

本文总结了Arduino常用串口操作函数，函数说明部分来源于Arduino 官网串口使用指南，示例与实验部分为自编。本文是对Arduino串口操作函数的较全面总结，可作为工具贴查找使用。

1.串口设置（初始化串口，开启串口，通常置于setup()函数中）
Serial.begin();

语法：

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个停止位。
返回：无

示例

void setup() { 
Serial.begin(9600); // 开启串口，定义波特率9600 
}

2.串口设置（禁止串口传输函数。此时串口传输的pin脚可以作为数字IO脚使用。）
Serial.end();
语法：

Serial.end()
参数：无
返回 ：无

3.清空串口缓存（1.0版本之前为清空串口缓存，现在该函数作用为等待输出数据传送完毕。如果要清空串口缓存的话，可以使用：****while(Serial.read() >= 0)****来代替。)
Serial.flush();
语法

Serial.flush ()
参数：无
返回 ：无

while(Serial.read()>= 0){}

说明
因Serial.read()函数读取串口缓存中的一个字符，并删除已读字符，如果清空了返回值为-1。因此可以用这句代码来清空串口缓存。实验代码详见下文代码。

4.输出串口数据（串口输出数据函数，写入字符串数据到串口。）
Serial.print();

语法

Serial.print(val)
Serial.print(val,format)
Serial.println(val) 
Serial.println(val,format)
参数：
val: 打印的值，任意数据类型
format: 输出的数据格式，包括整数类型和浮点型数据的小数点位数。
返回 ：发送字节数量

Serial.print("\n") 和 Serial.println() 等效，相当于多了一个换行符
示例

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."

5、串口准备好时触发的事件函数（串口数据准备好时触发的事件函数，即串口数据准备好调用该函数。）
Serial.SerialEvent();
语法

Serial.serialEvent{"statements"} 
参数 
statements: 执行任何有效的语句。

6.读串口缓存区数据（判断串口缓冲器的状态函数，用以判断数据是否送达串口。注意使用时通常用delay(100)以保证串口字符接收完毕，即保证Serial.available()返回的是缓冲区准确的可读字节数。）
Serial.available();
语法

Serial.available();

参数：无
返回：返回缓冲区可读字节数目

示例

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){} //清空串口缓存
}

7.Serial.read();（读取串口数据，一次读一个字符，读完后删除已读数据。）

语法

Serial.read();

参数：无
返回：返回串口缓存中第一个可读字节，当没有可读数据时返回-1，整数类型。

示例

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); 
    }
 }

8.Serial.peek(); （读串口缓存中下一字节的数据（字符型），但不从内部缓存中删除该数据。也就是说，连续的调用peek()将返回同一个字符。而调用read()则会返回下一个字符。）

语法

Serial.peek();
参数：无
返回：返回串口缓存中下一字节（字符）的数据，如果没有返回-1，整数int型

示例

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); 
    }
 }

9.Serial.readBytes(buffer,length);（从串口读取指定长度length的字符到缓存数组buffer。）

语法

Serial.readBytes(buffer,length);

参数： buffer: 缓存变量
	  length:设定的读取长度
返回：返回存入缓存的字符数，0表示没有有效数据。

示例

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';
    }
}

10.Serial.readBytesUntil(character,buffer,length);（从串口缓存读取指定长度的字符到数组buffer，遇到终止字符character后停止。）

语法

Serial.readBytesUntil(character ,buffer,length);

参数：  character : 查找的字符 (char)
		buffer: 存储读取数据的缓存(char[] 或byte[])
		length:设定的读取长度

返回：返回存入缓存的字符数，0表示没有有效数据。

示例

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';
    }
}

11.Serial.readString()；（从串口缓存区读取全部数据到一个字符串型变量。）

语法

Serial.readString();

参数：无

返回：返回从串口缓存区中读取的一个字符串。

示例

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 = "";
}

12.Serial.readStringUntil()；（从串口缓存区读取字符到一个字符串型变量，直至读完或遇到某终止字符。）

语法

Serial.readStringUntil(terminator)

参数：terminator:终止字符(cha型)
返回：从串口缓存区中读取的整个字符串，直至检测到终止字符。

示例

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){}
}

13.Serial.parseFloat();（读串口缓存区第一个有效的浮点型数据，数字将被跳过。当读到第一个非浮点数时函数结束。）

语法

Serial.parseFloat()
参数：无None

返回：返回串口缓存区第一个有效的浮点型数据，数字将被跳过。

示例

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){}
}

14.Serial.parseInt()（从串口接收数据流中读取第一个有效整数（包括负数）。）
注意：
非数字的首字符或者负号将被跳过
当可配置的超时值没有读到有效字符时，或者读不到有效整数时，分析停止
如果超时且读不到有效整数时，返回0

语法

Serial.parseInt()
Serial.parseInt(charskipChar)
参数：skipChar用于在搜索中跳过指定字符（此用法未知）
返回：返回下一个有效整型值。

示例

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){}
}

15.串口查找指定字符串
Serial.find();（从串口缓存区读取数据，寻找目标字符串target(char型)）

语法

char target[] = ”目标字符串”;

Serial.find(target); 

参数：
target: 目标字符串（char型）
返回：找到目标字符串返回真，否则为假

示例

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){}
}

16.Serial.findUntil(target,terminal); （从串口缓存区读取数据，寻找目标字符串target(char型数组)，直到出现给定字符串terminal(char型)，找到为真，否则为假。）
语法

Serial.findUntil(target,terminal); 
参数
target : 目标字符串（char型）
terminal : 结束搜索字符串（char型）

返回：如果在找到终止字符terminal之前找到目标字符target，返回真，否则返回假。

示例

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){}
}

17.向串口写数据（串口输出数据函数。写二进制数据到串口。）
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 thevalue 45 
  int bytesSent = Serial.write(“hello”); //sendthe string “hello” and return the length of the string. 
}

转载请注明：http://blog.csdn.net/iracer/article/details/50334041
————————————————
版权声明：本文为CSDN博主「iracer」的原创文章，遵循CC 4.0 BY-SA版权协议，转载请附上原文出处链接及本声明。
原文链接：https://blog.csdn.net/iracer/article/details/50334041

---------------------
作者：yangchangqi789
来源：CSDN
原文：https://blog.csdn.net/yangchangqi789/article/details/119567104
版权声明：本文为作者原创文章，转载请附上博文链接！
内容解析By：CSDN,CNBLOG博客文章一键转载插件