如何使用Arduino串口绘图仪

void setup() {
  Serial.begin(9600);   // 初始化串口，波特率必须与绘图仪一致
}

void loop() {
  int sensorValue = analogRead(A0);       // 读取0~1023的原始值
  float voltage = sensorValue * (5.0 / 1023.0); // 转换为电压值0~5V
  Serial.println(voltage);                 // 发送数据并换行
  delay(50);                               // 控制发送频率
}

操作步骤：

将代码上传到开发板。
点击IDE菜单 工具 → 串口绘图仪。
在绘图仪窗口右下角，将波特率设置为 9600（与代码一致）。
稍等片刻，你就会看到一条实时变化的曲线。旋转电位器，曲线会随之上下波动。

关键点：

必须使用 Serial.println() 发送数值，因为绘图仪依靠换行符来区分每一帧数据。
发送频率不宜过快（建议 delay(10) 以上），否则曲线过于密集，不易观察。

3. 显示多条曲线

很多时候我们需要同时观察多个变量（比如温度和湿度、期望值和实际值）。绘图仪支持在同一张图上显示多条曲线，只需在同一行内发送多个数值，并用分隔符隔开。

3.1 使用逗号分隔

void loop() {
  int val1 = analogRead(A0);
  int val2 = analogRead(A1);
  Serial.print(val1);
  Serial.print(",");     // 逗号分隔
  Serial.println(val2);
  delay(50);
}

3.2 使用空格或制表符分隔

Serial.print(val1);
Serial.print(" ");       // 空格分隔
Serial.println(val2);

绘图仪会自动为每条曲线分配不同颜色，并在图例中显示为“数据0”、“数据1”等。

注意事项：

每行发送的数值数量必须固定，否则绘图仪会解析错误。
分隔符可以是逗号、空格或制表符（\t），但不能混用（推荐统一使用逗号）。

4. 为曲线添加标签

如果默认的“数据0”、“数据1”不够直观，你可以在发送数值时加上名称:数值的格式，绘图仪就会将名称显示在图例中。

格式：名称1:数值1,名称2:数值2 （名称和数值之间用英文冒号连接，不同数据间用逗号分隔）

示例代码：发送正弦波和一条水平参考线，并分别命名为Sin和Ref。

float sinValue;
int refValue = 500;

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

void loop() {
  sinValue = 220 * sin(millis() / 1000.0) + 220; // 模拟一个正弦波（范围约0~440）

  Serial.print("Sin:");      // 标签
  Serial.print(sinValue);
  Serial.print(",");         // 逗号分隔
  Serial.print("Ref:");      // 标签
  Serial.println(refValue);  // 自动换行

  delay(20);
}

此时绘图仪窗口的图例会显示为 Sin 和 Ref，非常清晰。

重要：

标签和数值之间必须紧跟英文冒号，不能有空格（例如 "Temp:23.5" 正确，"Temp : 23.5" 错误）。
一行内如果有多个带标签的数据，它们之间仍然需要用分隔符（逗号或空格）隔开。

5. 高级技巧：固定Y轴范围

默认情况下，绘图仪的Y轴会自动缩放以适应数据范围。如果你希望固定Y轴的显示范围（例如始终显示0~5V），可以通过发送特殊名称的数据来“强制”绘图仪保持这个范围。

原理：绘图仪为了显示所有数据，会调整坐标轴。如果我们发送两个特殊的、始终不变的数值（比如名为_rangeMin和_rangeMax的曲线），并且让它们的数值固定为你想要的上下限，那么绘图仪为了显示这两条“线”，就会把Y轴锁定在这个范围内。

示例代码：固定Y轴为0~5，并显示一个0~5V的模拟输入。

void loop() {
  // 发送两个特殊数据定义Y轴范围
  Serial.print("_rangeMin:0 ");
  Serial.print("_rangeMax:5 ");

  // 发送实际数据（带标签）
  float voltage = analogRead(A0) * (5.0 / 1023.0);
  Serial.print("Sensor:");
  Serial.println(voltage);

  delay(50);
}

注意：

特殊名称 _rangeMin 和 _rangeMax 以下划线开头，这是绘图仪内置的识别规则。
这两个特殊数据必须持续发送，不能只发一次，否则绘图仪会重新自动缩放。
发送顺序可以任意，只要保证每行都包含它们即可。

6. 进阶技巧：保存数据用于后期分析

串口绘图仪本身没有“保存数据”的功能，但你可以通过以下两种方式记录数据：

6.1 使用串口助手软件

一些第三方串口助手（如 Serial Port Monitor、sscom）支持将接收到的数据保存为文本文件。
只需打开这些软件，连接对应端口，设置好波特率，然后开始记录即可。

6.2 自己写Python脚本

Python的pyserial库可以轻松读取串口数据并保存为CSV文件，之后可以用Excel或Matplotlib进一步分析。

简单示例（需安装pyserial）：

import serial
import time

ser = serial.Serial('COM3', 9600)  # 替换为你的端口
with open('data.csv', 'w') as f:
    f.write('time,value\n')
    start = time.time()
    while True:
        line = ser.readline().decode().strip()
        if line:
            t = time.time() - start
            f.write(f'{t},{line}\n')
            print(f'{t:.2f},{line}')

7. 常见问题与排错

Q1：绘图仪窗口一片空白，什么也没有？

检查波特率：确保代码中的 Serial.begin() 值与绘图仪右下角选择的波特率完全一致（常见的是9600）。
检查数据发送：确认代码中有 Serial.print() 或 Serial.println() 发送数据，且已经上传成功。
检查换行符：必须使用 Serial.println() 或手动发送 \n，否则绘图仪不知道一帧数据何时结束。
检查端口：确保在绘图仪打开时，没有其他程序（如串口监视器）占用同一串口。

Q2：曲线非常密集，看不清楚怎么办？

在 loop() 中增加 delay() 时间，降低数据发送频率，例如从 delay(10) 改为 delay(50)。
或者在代码中加入条件判断，只在一定时间间隔后发送数据（使用 millis() 非阻塞计时）。

Q3：我想显示负数值，可以吗？

可以，绘图仪支持负数，Y轴会自动包含负半轴。

Q4：多条曲线时，颜色总变，我想固定颜色可以吗？

目前绘图仪不支持手动指定曲线颜色，颜色是自动分配的。不过每次打开绘图仪，相同名称的曲线颜色会保持一致。

Q5：发送的数据包含小数，能正常显示吗？

可以，浮点数会被正确解析和显示。

8. 总结

Arduino串口绘图仪是一个简单但强大的可视化工具，掌握它能让你的调试工作事半功倍。回顾一下核心要点：

单条曲线：Serial.println(数值)
多条曲线：同一行内用逗号/空格分隔多个数值，例如 Serial.print(val1); Serial.print(","); Serial.println(val2);
添加标签：Serial.print("名称:数值")
固定Y轴范围：发送 _rangeMin:下限 和 _rangeMax:上限 两个特殊数据

扩展阅读：

AI硬件创业社区

智能硬件社区聚焦AI智能硬件技术生态，汇聚嵌入式AI、物联网硬件开发者，打造交流分享平台，同步全国赛事资讯、开展 OPC 核心人才招募，助力技术落地与开发者成长。

更多推荐

【实战】STM32八大系列怎么选？F0/F1/F4/H7/L4/U5/WB/G0核心参数对比与嵌入式物联网项目选型决策（附选型评估代码）

STM32八大系列选型的核心原则是"够用即可，适度预留"：功耗约束（电池供电锁L4/U5）是不可妥协的硬约束，关键外设（以太网/CAN-FD/无线RF/高级定时器）直接排除不支持的系列，算力需求（FPU/DSP/Cache）决定算法实现方式，成本预算在满足前三项的前提下选最低方案，生态与供货优先选上市2年以上的成熟型号并确认替代方案。对绝大多数工业控制和物联网项目，STM32F4是性能、生态、成本