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

什么是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.readBytesUntil()
Arduino的Serial.readBytesUntil()是一个用于从串行端口接收多个字节的数据，直到遇到指定的终止字符为止的函数。它可以用于与电脑或其他设备通信，或者从串行监视器上读取用户的输入。Serial.readBytesUntil()的适用范围：
1）从电脑上接收一行文本，以换行符’\n’作为终止字符，实现文本处理或命令解析。
2）从蓝牙模块或无线模块接收数据包，以特定的标志位作为终止字符，实现数据校验或解码。
3）从键盘或按键模块接收用户的字符串输入，以回车键’\r’作为终止字符，实现交互式的程序。

主要应用场景：
1）终止字符接收和存储：Serial.readBytesUntil()函数适用于接收并存储以指定终止字符结尾的数据。它可以用于接收文本数据、命令行输入、控制信息等场景中，将接收到的数据存储到缓冲区中，以供后续处理和分析。
2）命令解析和处理：通过指定终止字符，Serial.readBytesUntil()函数可以用于解析和处理命令。例如，在命令行界面中，可以使用该函数接收用户输入的命令，并根据指定的终止字符进行解析和执行相应的操作。
3）串口通信协议：在一些串口通信协议中，数据包的结束标志可能是一个特定的终止字符。使用Serial.readBytesUntil()函数可以方便地接收和处理这种带有特定终止字符的数据包。

Serial.readBytesUntil()的使用需要注意以下事项：
1）在使用Serial.readBytesUntil()之前，需要先调用Serial.begin()来设置串行端口的波特率。波特率是指每秒传输的位数，不同的设备可能需要不同的波特率。如果波特率不匹配，会导致数据接收错误或乱码。
2）Serial.readBytesUntil()需要三个参数，一个是用于存储数据的数组，一个是要读取的终止字符，一个是要读取的最大字节数。数组的长度必须大于等于要读取的最大字节数，否则会导致数据溢出或丢失。
3）Serial.readBytesUntil()在读取数据之前，需要先检查是否有数据可读。可以使用Serial.available()函数来判断串行端口是否有数据到达。如果没有数据可读，Serial.readBytesUntil()会等待一段时间，直到有数据或超时为止。
4）Serial.readBytesUntil()会返回实际读取的字节数，如果超时或出错，会返回0。如果遇到终止字符，会返回终止字符之前的字节数，并将终止字符留在缓冲区中。可以根据返回值判断是否成功读取数据。

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

// 引入LCD库
#include <LiquidCrystal.h>

// 定义LCD的引脚
#define RS 7
#define EN 6
#define D4 5
#define D5 4
#define D6 3
#define D7 2

// 创建LCD对象
LiquidCrystal lcd(RS, EN, D4, D5, D6, D7);

// 定义用于存储文本输入的数组
char input[16];

// 定义要读取的终止字符
char terminator = '\n';

// 定义要读取的最大字节数
int inputSize = 16;

void setup() {
  // 初始化串行端口，设置波特率为9600
  Serial.begin(9600);
  // 初始化LCD，设置为16x2的显示模式
  lcd.begin(16, 2);
}

void loop() {
  // 检查是否有数据从串行端口接收
  if (Serial.available() > 0) {
    // 如果有数据，读取一行文本并存储到数组中
    int bytesRead = Serial.readBytesUntil(terminator, input, inputSize);
    // 打印读取到的字节数，并换行
    Serial.println(bytesRead);
    // 打印接收到的文本，并换行
    Serial.println(input);
    // 在LCD上显示接收到的文本
    lcd.clear();
    lcd.setCursor(0, 0);
    lcd.print(input);
  }
}

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

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

// 定义DHT11引脚
#define DHTPIN 2

// 定义DHT11类型
#define DHTTYPE DHT11

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

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

// 定义要读取的终止字符
char terminator = '#';

// 定义要读取的最大字节数
int packetSize = 6;

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

void setup() {
  // 初始化串行端口，设置波特率为9600
  Serial.begin(9600);
  // 初始化DHT11传感器
  dht.begin();
}

void loop() {
  // 检查是否有数据从串行端口接收
  if (Serial.available() > 0) {
    // 如果有数据，读取数据包并存储到数组中
    int bytesRead = Serial.readBytesUntil(terminator, 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(" %");
  }
}

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

// 定义模式变量
int mode = 0;

// 定义用于存储字符串输入的数组
char input[16];

// 定义要读取的终止字符
char terminator = '\r';

// 定义要读取的最大字节数
int inputSize = 16;

void setup() {
  // 初始化串行端口，设置波特率为9600
  Serial.begin(9600);
}

void loop() {
  // 检查是否有数据从串行端口接收
  if (Serial.available() > 0) {
    // 如果有数据，读取字符串输入并存储到数组中
    int bytesRead = Serial.readBytesUntil(terminator, input, inputSize);
    // 打印读取到的字节数，并换行
    Serial.println(bytesRead);
    // 打印接收到的字符串，并换行
    Serial.println(input);
    
    // 根据字符串输入，选择不同的模式
    if (strcmp(input, "hello") == 0) {
      // 如果输入等于"hello"，选择模式1
      mode = 1;
      // 执行模式1的功能
      // ...
    } else if (strcmp(input, "time") == 0) {
      // 如果输入等于"time"，选择模式2
      mode = 2;
      // 执行模式2的功能
      // ...
    } else if (strcmp(input, "reset") == 0) {
      // 如果输入等于"reset"，选择模式3
      mode = 3;
      // 执行模式3的功能
      // ...
    } else {
      // 如果输入不匹配任何功能，选择模式0
      mode = 0;
      // 执行模式0的功能（默认）
      // ...
    }
  }
}

案例四：接收和存储终止字符前的数据

void setup() {
  Serial.begin(9600);  // 初始化串口通信

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

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

    // 读取直到遇到终止字符'\n'，最多读取20个字节
    size_t bytesRead = Serial.readBytesUntil('\n', buffer, sizeof(buffer) - 1);
    buffer[bytesRead] = '\0';  // 添加字符串结束符

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

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

案例五：命令解析和处理

void setup() {
  Serial.begin(9600);  // 初始化串口通信

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

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

    // 读取直到遇到终止字符'\n'，最多读取50个字节
    size_t bytesRead = Serial.readBytesUntil('\n', buffer, sizeof(buffer) - 1);
    buffer[bytesRead] = '\0';  // 添加字符串结束符

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

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

案例六：串口通信协议

void setup() {
  Serial.begin(9600);  // 初始化串口通信

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

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

    // 读取直到遇到终止字符'\r'，最多读取100个字节
    size_t bytesRead = Serial.readBytesUntil('\r', buffer, sizeof(buffer) - 1);
    buffer[bytesRead] = '\0';  // 添加字符串结束符

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

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

这些案例展示了Serial.readBytesUntil()函数的不同应用场景。第一个案例演示了如何使用Serial.readBytesUntil()函数接收以换行符（‘\n’）结尾的数据，并将数据存储到缓冲区中以供后续处理和分析。第二个案例展示了如何使用Serial.readBytesUntil()函数接收以换行符（‘\n’）结尾的命令，并进行解析和执行相应的操作。第三个案例演示了如何使用Serial.readBytesUntil()函数接收以回车符（‘\r’）结尾的数据包，并进行处理。这些案例可以根据具体的应用需求进行修改和扩展。

案例七：按行接收并处理文本数据

const int BUFFER_SIZE = 64; // 缓冲区大小

void setup() {
  Serial.begin(9600); // 初始化串口，波特率为9600
}

void loop() {
  if (Serial.available()) {
    char buffer[BUFFER_SIZE]; // 定义缓冲区

    // 读取一行文本数据，以换行符作为终止字符
    int bytesRead = Serial.readBytesUntil('\n', buffer, BUFFER_SIZE);

    // 在缓冲区末尾添加空字符，形成C字符串
    buffer[bytesRead] = '\0';

    // 处理接收到的文本数据
    // ...
  }
}

案例八：截取一定长度的数据

const int BUFFER_SIZE = 16; // 缓冲区大小
const int DATA_LENGTH = 10; // 截取的数据长度

void setup() {
  Serial.begin(9600); // 初始化串口，波特率为9600
}

void loop() {
  if (Serial.available() >= DATA_LENGTH) {
    char buffer[BUFFER_SIZE]; // 定义缓冲区

    // 读取指定长度的数据
    Serial.readBytesUntil('\n', buffer, DATA_LENGTH);

    // 处理截取的数据
    // ...
  }
}

案例九：解析特定格式的数据

const int BUFFER_SIZE = 32; // 缓冲区大小

void setup() {
  Serial.begin(9600); // 初始化串口，波特率为9600
}

void loop() {
  if (Serial.available()) {
    char buffer[BUFFER_SIZE]; // 定义缓冲区

    // 读取数据直到遇到特定字符':'
    int bytesRead = Serial.readBytesUntil(':', buffer, BUFFER_SIZE);

    // 在缓冲区末尾添加空字符，形成C字符串
    buffer[bytesRead] = '\0';

    // 提取有效信息并进行处理
    // ...
  }
}

这些案例展示了Serial.readBytesUntil()的一些常见应用。通过调用Serial.readBytesUntil()，我们可以从串口读取一串字节数据并存储到缓冲区中，直到遇到指定的终止字符为止。这在处理文本数据、截断数据和解析特定格式的数据时非常有用。在使用Serial.readBytesUntil()时，请确保已经初始化了串口，并根据实际需求选择合适的缓冲区大小和终止字符。