Python与Arduino高效实时数据交互：基于串口通信的坐标传输教程

新闻中心 NEWS CENTER

您当前位置：首页 > 新闻中心 > 网络学院

Python与Arduino高效实时数据交互：基于串口通信的坐标传输教程

2025-11-20

浏览次数：次

返回列表

python与arduino高效实时数据交互：基于串口通信的坐标传输教程

本文旨在指导读者如何在Python与Arduino之间建立高效的实时数据传输通道，特别针对需要传输连续坐标数据（如人脸追踪）的应用场景。我们将摒弃传统的文件读写方式，转而采用更直接、低延迟的串口通信机制，详细阐述Python端的数据发送与Arduino端的数据接收及解析方法，并提供关键代码示例与最佳实践建议。

在许多涉及计算机视觉（如OpenCV进行人脸追踪）与硬件控制（如Arduino控制云台）的实时应用中，Python程序需要将处理后的数据（例如X、Y坐标）实时传输给Arduino。虽然将数据写入CSV文件再由Arduino读取是一种思路，但这在实时性要求高的场景下效率低下且存在诸多弊端。更优的解决方案是利用串口（Serial Port）进行直接通信，实现数据的高效、低延迟传输。

为什么选择串口通信？

传统的通过文件（如CSV）进行数据传输存在以下问题：

高延迟： 文件I/O操作本身具有一定的延迟，不适合需要毫秒级响应的实时系统。
I/O开销： 频繁的文件读写会增加系统资源消耗，降低整体性能。
复杂性： Arduino直接读取SD卡或外部存储设备上的文件，需要额外的硬件模块和复杂的库支持。
同步问题： Python写入文件和Arduino读取文件之间的同步机制需要精心设计，容易出现数据不一致或读取旧数据的问题。

相比之下，串口通信具有以下显著优势：

实时性强： 数据直接通过物理线路传输，延迟极低。
效率高： 无需中间文件存储，减少了I/O开销。
实现简单： Python和Arduino都内置了对串口通信的良好支持，易于上手。
广泛适用： 几乎所有微控制器和计算机都支持串口通信。

Python端数据发送实现

在Python中，我们通常使用pyserial库来与串口进行交互。以下是一个将X、Y坐标以CSV格式通过串口发送的示例。

安装pyserial库：

pip install pyserial

Python发送代码示例：

小云雀

剪映出品的AI视频和图片创作助手

1949 查看详情小云雀

import serial
import time
import random # 模拟OpenCV获取的坐标数据

# 配置串口参数
# 根据你的系统和Arduino连接的端口进行修改
# Windows系统通常是'COMx'，Linux/macOS系统通常是'/dev/ttyUSBx' 或 '/dev/tty.usbmodemxxx'
SERIAL_PORT = 'COM3'  
BAUD_RATE = 9600

try:
    # 初始化串口
    ser = serial.Serial(SERIAL_PORT, BAUD_RATE, timeout=1)
    print(f"串口 {SERIAL_PORT} 以 {BAUD_RATE} 波特率打开成功。")

    while True:
        # 模拟从OpenCV获取X、Y坐标
        # 实际应用中，这里会是你的OpenCV人脸追踪逻辑
        x_coord = random.randint(0, 640)  # 假设屏幕宽度640
        y_coord = random.randint(0, 480)  # 假设屏幕高度480

        # 将坐标格式化为CSV字符串，并添加换行符作为数据包结束标志
        data_to_send = f"{x_coord},{y_coord}\n"

        # 将字符串编码为字节流发送
        ser.write(data_to_send.encode('utf-8'))
        print(f"发送数据: {data_to_send.strip()}") # .strip()去除末尾换行符，便于显示

        time.sleep(0.1) # 每100毫秒发送一次数据

except serial.SerialException as e:
    print(f"串口错误: {e}")
except KeyboardInterrupt:
    print("程序被用户中断。")
finally:
    if 'ser' in locals() and ser.is_open:
        ser.close()
        print("串口已关闭。")

注意事项：

串口名称（SERIAL_PORT）： 务必根据你的操作系统和Arduino连接情况进行修改。在Windows上通常是COMx，在Linux或macOS上通常是/dev/ttyUSBx或/dev/tty.usbmodemxxx。
波特率（BAUD_RATE）： 必须与Arduino端的波特率设置完全一致。
数据格式： 使用f"{x},{y}\n"的格式，其中\n（换行符）作为数据包的结束标志，这对于Arduino端解析非常重要。
编码： 发送数据前需要使用.encode('utf-8')将其转换为字节流。

Arduino端数据接收与解析

Arduino通过Serial对象来处理串口通信。接收到的数据需要进行解析，以提取出X、Y坐标。

Arduino接收代码示例：

// 定义缓冲区大小，足以容纳预期的数据字符串
const int BUFFER_SIZE = 64; 
char receivedChars[BUFFER_SIZE]; // 存储接收到的字符
boolean newData = false;         // 标志是否有新数据

int x_coord = 0; // 解析出的X坐标
int y_coord = 0; // 解析出的Y坐标

void setup() {
  // 初始化串口通信，波特率必须与Python端一致
  Serial.begin(9600); 
  Serial.println("Arduino已启动，等待Python数据...");
}

void loop() {
  recvWithEndMarker(); // 接收数据
  if (newData == true) {
    parseData();       // 解析数据
    // 在这里使用解析出的x_coord和y_coord来控制你的设备，例如舵机
    Serial.print("接收到X: ");
    Serial.print(x_coord);
    Serial.print(", Y: ");
    Serial.println(y_coord);

    newData = false; // 重置标志位
  }
  // 其他非阻塞任务可以在这里执行
}

// 接收以换行符（'\n'）结尾的数据包
void recvWithEndMarker() {
  static byte ndx = 0; // 索引
  char rc;             // 接收到的字符

  while (Serial.*ailable() > 0 && newData == false) {
    rc = Serial.read(); // 读取一个字符

    if (rc != '\n') { // 如果不是换行符
      receivedChars[ndx] = rc; // 存入缓冲区
      ndx++;
      if (ndx >= BUFFER_SIZE) { // 防止缓冲区溢出
        ndx = BUFFER_SIZE - 1;
      }
    } else { // 遇到换行符，表示一个数据包结束
      receivedChars[ndx] = '\0'; // 添加字符串结束符
      newData = true;            // 设置新数据标志
      ndx = 0;                   // 重置索引
    }
  }
}

// 解析CSV格式的数据
void parseData() {
  char *strtokIndex; // 用于strtok函数的指针

  // 复制一份数据，因为strtok会修改原始字符串
  char tempChars[BUFFER_SIZE];
  strcpy(tempChars, receivedChars);

  // 获取第一个逗号前的字符串（X坐标）
  strtokIndex = strtok(tempChars, ",");
  if (strtokIndex != NULL) {
    x_coord = atoi(strtokIndex); // 转换为整数
  } else {
    // 错误处理，例如设置默认值或打印错误
    x_coord = 0; 
  }

  // 获取第二个逗号后的字符串（Y坐标）
  strtokIndex = strtok(NULL, ","); // 继续从上次strtok停止的位置查找
  if (strtokIndex != NULL) {
    y_coord = atoi(strtokIndex); // 转换为整数
  } else {
    // 错误处理
    y_coord = 0;
  }
}

注意事项：

波特率（Serial.begin(9600)）： 必须与Python端的波特率设置完全一致。
数据包结束标志： Arduino端通过检测\n（换行符）来判断一个完整的数据包是否接收完毕。
缓冲区溢出： recvWithEndMarker函数中包含了防止缓冲区溢出的基本检查，但仍需确保BUFFER_SIZE足够大，以容纳预期的最长数据字符串。
数据解析： 使用strtok函数来分割CSV格式的字符串，然后使用atoi将字符串转换为整数。
非阻塞读取： recvWithEndMarker函数是非阻塞的，它只在有数据可用时读取，不会暂停loop()函数的执行，这对于实时控制非常重要。