【雕爷学编程】Arduino 手册之通讯函数 Serial.setTimeout()

什么是Arduino？
Arduino 是一款开源的电子原型平台，它可以让你用简单的硬件和软件来创建各种创意的项目。无论你是初学者还是专家，Arduino 都能为你提供无限的可能性。你可以用 Arduino 来控制传感器、灯光、马达、机器人、物联网设备等等，只要你能想到的，Arduino 都能帮你实现。

如果你想了解更多关于 Arduino 的信息，你可以访问 Arduino 的官方网站，那里有丰富的资源和教程供你参考。你也可以加入 Arduino 的社区，和来自世界各地的爱好者、学生、设计师和工程师交流心得和经验。此外，你还可以使用 Arduino 的在线编程工具，在云端编写代码并上传到你的开发板上。

Arduino 是一个不断发展和创新的平台，它有着广泛的应用领域和潜力。这里希望本手册能激发你对 Arduino 的兴趣和热情，让你享受 Arduino 带来的创造力和乐趣。

维基百科的定义
Arduino 是一个开源嵌入式硬件平台，用来供用户制作可交互式的嵌入式项目。此外 Arduino 作为一个开源硬件和开源软件的公司，同时兼有项目和用户社群。该公司负责设计和制造Arduino电路板及相关附件。这些产品按照GNU宽通用公共许可证（LGPL）或GNU通用公共许可证（GPL）许可的开源硬件和软件分发的，Arduino 允许任何人制造 Arduino 板和软件分发。 Arduino 板可以以预装的形式商业销售，也可以作为 DIY 套件购买。

Arduino 2005 年时面世，作为意大利伊夫雷亚地区伊夫雷亚互动设计研究所的学生设计，目的是为新手和专业人员提供一种低成本且简单的方法，以建立使用传感器与环境相互作用的装置。初学者和爱好者可用Arduino制造传感器、简单机器人、恒温器和运动检测器等装置。

Arduino 这个名字来自意大利伊夫雷亚的一家酒吧，该项目的一些创始人过去常常会去这家酒吧。 酒吧以伊夫雷亚的 Arduin（Arduin of Ivrea）命名，他是伊夫雷亚边疆伯爵，也是 1002 年至 1014 年期间的意大利国王。

二十一、Arduino 通讯函数 Serial.setTimeout()
Arduino的Serial.setTimeout()是一个用于设置串行端口读取数据的超时时间的函数。它可以用于控制Serial.readBytes()或Serial.readString()等函数的等待时间，以提高程序的效率和响应性。Serial.setTimeout()的适用范围：
1）从电脑上接收图片或音频等二进制文件，根据文件的大小和传输速度，设置合适的超时时间，避免过长的等待或数据丢失。
2）从蓝牙模块或无线模块接收数据包，根据数据包的格式和频率，设置合适的超时时间，避免数据包的分割或重复。
3）从键盘或按键模块接收用户的字符串输入，根据用户的输入习惯，设置合适的超时时间，避免字符串的截断或拼接。

主要应用场景：
1）数据接收等待：Serial.setTimeout()函数适用于需要等待一段时间来接收完整数据的场景。在某些情况下，数据可能需要一段时间才能完全接收，例如串口通信中的大数据包传输或者慢速传输的传感器数据。通过设置适当的超时时间，可以确保在一定时间内接收完整的数据，避免数据丢失或接收错误。
2）防止阻塞：当串口接收没有设置超时时间时，如果没有新的数据到达，程序会一直阻塞在接收数据的操作上。这可能导致程序在等待数据时无法执行其他任务或逻辑。使用Serial.setTimeout()函数可以设置一个合理的超时时间，从而避免阻塞情况的发生。
3）超时处理：在一些应用场景中，如果在指定的时间内没有接收到数据，需要执行特定的超时处理逻辑。通过设置超时时间，可以实现在接收数据超时时执行相应的处理操作，例如发送错误消息、重新启动通信等。

Serial.setTimeout()的使用需要注意以下事项：
1）在使用Serial.setTimeout()之前，需要先调用Serial.begin()来设置串行端口的波特率。波特率是指每秒传输的位数，不同的设备可能需要不同的波特率。如果波特率不匹配，会导致数据传输错误或乱码。
2）Serial.setTimeout()需要一个参数，即超时时间（毫秒）。超时时间是指在读取数据时，如果在指定的时间内没有接收到新的数据，就停止读取并返回已读取的数据。超时时间默认为1000毫秒，可以根据需要进行修改。
3）Serial.setTimeout()会影响所有使用串行端口读取数据的函数，例如Serial.readBytes()或Serial.readString()等。如果想要恢复默认的超时时间，可以使用Serial.setTimeout(1000)。

以下是Arduino的Serial.setTimeout()几个实际运用程序案例：
案例一：从电脑上接收图片文件，并将其显示在OLED屏幕上。

// 引入OLED库
#include <Adafruit_GFX.h>
#include <Adafruit_SSD1306.h>

// 定义OLED屏幕的宽度和高度（像素）
#define SCREEN_WIDTH 128
#define SCREEN_HEIGHT 64

// 定义OLED屏幕的I2C地址
#define OLED_ADDR   0x3C

// 创建OLED对象
Adafruit_SSD1306 display(SCREEN_WIDTH, SCREEN_HEIGHT, &Wire, -1);

// 定义用于存储图片数据的数组
byte imageData[1024];

// 定义要接收的图片字节数
int imageSize = 1024;

// 定义超时时间（毫秒）
int timeout = 500;

void setup() {
  // 初始化串行端口，设置波特率为9600
  Serial.begin(9600);
  // 设置超时时间为500毫秒
  Serial.setTimeout(timeout);
  // 初始化OLED屏幕
  display.begin(SSD1306_SWITCHCAPVCC, OLED_ADDR);
}

void loop() {
  // 检查是否有足够的数据从串行端口接收
  if (Serial.available() >= imageSize) {
    // 如果有足够的数据，读取图片数据并存储到数组中
    int bytesRead = Serial.readBytes(imageData, imageSize);
    // 打印读取到的字节数，并换行
    Serial.println(bytesRead);
    // 在OLED屏幕上显示图片
    display.clearDisplay();
    display.drawBitmap(0, 0, imageData, SCREEN_WIDTH, SCREEN_HEIGHT, WHITE);
    display.display();
  }
}

案例二：从蓝牙模块HC-05接收数据包，并解析其中的温湿度数值。

// 引入DHT11库
#include <DHT.h>

// 定义DHT11引脚
#define DHTPIN 2

// 定义DHT11类型
#define DHTTYPE DHT11

// 创建DHT11对象
DHT dht(DHTPIN, DHTTYPE);

// 定义用于存储数据包的数组
byte packet[6];

// 定义要接收的数据包字节数
int packetSize = 6;

// 定义超时时间（毫秒）
int timeout = 100;

// 定义温湿度数值变量
float temperature = 0;
float humidity = 0;

void setup() {
  // 初始化串行端口，设置波特率为9600
  Serial.begin(9600);
  // 设置超时时间为100毫秒
  Serial.setTimeout(timeout);
  // 初始化DHT11传感器
  dht.begin();
}

void loop() {
  // 检查是否有足够的数据从串行端口接收
  if (Serial.available() >= packetSize) {
    // 如果有足够的数据，读取数据包并存储到数组中
    int bytesRead = Serial.readBytes(packet, packetSize);
    // 打印读取到的字节数，并换行
    Serial.println(bytesRead);
    // 解析数据包中的温湿度数值
    temperature = packet[0] + packet[1] / 100.0;
    humidity = packet[2] + packet[3] / 100.0;
    // 打印温湿度数值，并换行
    Serial.print("Temperature: ");
    Serial.print(temperature);
    Serial.print(" *C, Humidity: ");
    Serial.print(humidity);
    Serial.println(" %");
  }
}

案例三：从键盘或按键模块接收用户的字符串输入，并根据输入执行不同的功能。

String inputString; 

void setup() {
  Serial.begin(9600);
  
  // 设置串口接收超时时间为1000ms
  Serial.setTimeout(1000); 
}

void loop() {
  // 等待并接收串口输入
  if(Serial.available() > 0){
    char inChar = Serial.read();
    inputString += inChar; 

    // 如果接收到回车,执行功能
    if(inChar == '\n'){
      Serial.println(inputString);
      if(inputString == "LED ON"){ 
        digitalWrite(LED_BUILTIN, HIGH);
      }
      else if(inputString == "LED OFF"){
        digitalWrite(LED_BUILTIN, LOW);  
      }

      // 清空字符串变量
      inputString = "";
    }
  }
  
  // 其他任务
  // ......
}

在这里,使用了Serial.setTimeout()设置了串口接收超时时间为1秒。这样就可以在loop()循环中不断检测和接收串口输入,同时还可以执行其他任务,不会被输入阻塞。如果1秒内没有接收到一个完成的命令,将会超时退出,避免长时间等待。

案例四：接收和处理命令

void setup() {
  Serial.begin(9600);  // 初始化串口通信
  Serial.setTimeout(1000);  // 设置超时时间为1秒

  // 初始化设置
  // ...
}

void loop() {
  // 接收命令
  if (Serial.available()) {
    // 创建缓冲区
    char buffer[50];

    // 读取数据，超时时间内没有数据可用则跳过
    size_t bytesRead = Serial.readBytesUntil('\n', buffer, sizeof(buffer) - 1);
    buffer[bytesRead] = '\0';  // 添加字符串结束符

    // 解析和处理接收到的命令
    // ...
  }

  // 执行其他操作
  // ...
}

案例五：接收和存储数据包

void setup() {
  Serial.begin(9600);  // 初始化串口通信
  Serial.setTimeout(2000);  // 设置超时时间为2秒

  // 初始化设置
  // ...
}

void loop() {
  // 接收数据包
  if (Serial.available()) {
    // 创建缓冲区
    byte buffer[100];

    // 读取数据，超时时间内没有数据可用则跳过
    size_t bytesRead = Serial.readBytes(buffer, sizeof(buffer));

    // 对接收到的数据包进行处理
    // ...
  }

  // 执行其他操作
  // ...
}

案例六：超时处理

void setup() {
  Serial.begin(9600);  // 初始化串口通信
  Serial.setTimeout(5000);  // 设置超时时间为5秒

  // 初始化设置
  // ...
}

void loop() {
  // 接收数据
  if (Serial.available()) {
    // 创建缓冲区
    char buffer[50];

    // 读取数据，超时时间内没有数据可用则跳过
    size_t bytesRead = Serial.readBytesUntil('\n', buffer, sizeof(buffer) - 1);
    buffer[bytesRead] = '\0';  // 添加字符串结束符

    // 对接收到的数据进行处理
    // ...
  } else {
    // 没有接收到数据，执行超时处理逻辑
    // ...
  }

  // 执行其他操作
  // ...
}

这些案例展示了Serial.setTimeout()函数的不同应用场景。第一个案例演示了如何使用Serial.setTimeout()函数设置命令接收的超时时间，并在超时时跳过数据接收。第二个案例展示了如何使用Serial.setTimeout()函数设置数据包接收的超时时间，并在超时时跳过数据接收。第三个案例演示了如何使用Serial.setTimeout()函数设置超时时间，并在没有接收到数据时执行超时处理逻辑。在实际应用中，可以根据具体的需求和场景，设置合适的超时时间和相应的处理逻辑。

案例七：读取超时控制

void setup() {
  Serial.begin(9600); // 初始化串口，波特率为9600
  Serial.setTimeout(1000); // 设置读取超时时间为1秒
}

void loop() {
  if (Serial.available()) {
    // 读取数据，等待时间不超过1秒
    int data = Serial.read();

    // 处理读取到的数据
    // ...
  }
}

案例八：错误处理

void setup() {
  Serial.begin(9600); // 初始化串口，波特率为9600
  Serial.setTimeout(1000); // 设置读取超时时间为1秒
}

void loop() {
  if (Serial.available()) {
    // 读取数据，等待时间不超过1秒
    int data = Serial.read();

    if (data == -1) {
      // 读取超时，进行错误处理
      // ...
    } else {
      // 处理读取到的数据
      // ...
    }
  }
}

案例九：优化程序响应性

void setup() {
  Serial.begin(9600); // 初始化串口，波特率为9600
  Serial.setTimeout(500); // 设置读取超时时间为0.5秒
}

void loop() {
  // 处理其他任务

  if (Serial.available()) {
    // 读取数据，等待时间不超过0.5秒
    int data = Serial.read();

    if (data != -1) {
      // 处理读取到的数据
      // ...
    }
  }

  // 继续处理其他任务
}

这些案例展示了Serial.setTimeout()的一些常见应用。通过调用Serial.setTimeout()，我们可以设置串口读取函数的超时时间，以控制读取操作的等待时间，并根据需求进行错误处理和优化程序响应性能。在使用Serial.setTimeout()时，请确保已经初始化了串口，并根据实际需求设置合适的超时时间。