三亩地 三亩地SAN MU DI · CODE DIARY
交流投稿
ARTICLE DETAIL

日记详情

真实记录编程学习的某一天，欢迎挑你感兴趣的翻一翻。

首页/学习日记/日记详情

C#与Arduino串口通信实战：从协议设计到多线程优化

发布时间：2026/8/5 17:13:57 三亩地 编程学习日记
C#与Arduino串口通信实战：从协议设计到多线程优化

1. 项目概述：为什么选择C#与Arduino这对组合？

在嵌入式开发和上位机软件领域，将功能强大的桌面应用程序与灵活小巧的微控制器连接起来，是许多项目从原型走向实用的关键一步。我最近完成的一个智能温室监控系统项目，其核心就是通过C#编写的Windows桌面应用，与部署在温室现场的多个Arduino节点进行实时通信。这个组合看似普通，但在实际工业控制、数据采集、创客项目中应用极广。C#凭借其成熟的.NET生态、优雅的WinForms/WPF界面开发能力以及稳定的串口通信库，成为了上位机开发的利器；而Arduino则以极低的入门门槛、丰富的传感器生态和稳定的性能，承担着下位机数据采集与执行控制的职责。

这个项目的核心需求很明确：上位机（C#应用）需要能够发送控制指令（如“打开补光灯”、“启动水泵”），并接收下位机（Arduino）采集的实时数据（如温度、湿度、光照强度）。通信的桥梁，最经典、最可靠的就是串行通信（Serial Communication）。对于新手而言，可能会被“Socket通信”、“MQTT物联网协议”等更时髦的词汇吸引，但对于这种一台上位机对少量下位机、距离不远、要求实时可靠的场景，串口通信依然是首选。它不依赖网络配置，协议简单直接，在Windows和Arduino平台上都有非常成熟的支持，调试起来也直观。接下来，我将拆解整个实现流程，从环境搭建、协议设计、代码实现到调试排错，分享一套可直接复用的方案。

2. 通信方案选型与核心原理剖析

2.1 为什么是串口通信？

在C#与Arduino的通信中，有几种常见方式：串口（UART）、网络（TCP/IP）、以及一些无线模块（如蓝牙、Wi-Fi对应的虚拟串口）。对于大多数初学者和快速原型项目，串口通信是性价比和复杂度平衡的最佳选择。

  1. 硬件成本与复杂度极低：Arduino Uno等开发板自带USB转串口芯片，通过一根USB数据线就能同时完成供电和通信，无需额外硬件。即使是需要通过长距离有线连接的场景，也只需要一个USB转TTL串口模块和几条导线。
  2. 软件生态成熟：C#的System.IO.Ports命名空间提供了完整的SerialPort类，封装了所有串口操作。Arduino IDE则内置了Serial对象，双方API都非常简洁。
  3. 协议透明，利于调试：数据以字节流形式直接传输，我们可以自定义任何简单的文本或二进制协议。调试时，可以使用串口调试助手（如Putty、Arduino IDE自带的串口监视器）在中间截取数据，清晰看到每一字节的内容，极大降低了调试难度。
  4. 实时性可靠：串口通信是硬实时通信，没有TCP/IP协议栈的开销和不确定性，在要求快速响应的控制场景中表现稳定。

注意：虽然USB连接看起来像“USB通信”，但对于Arduino和PC端的C#程序而言，它本质上是一个虚拟串口（COM Port）。Windows系统会为连接的Arduino分配一个COM号（如COM3），我们的程序就像操作一个传统的RS232串口一样操作它。

2.2 自定义通信协议设计要点

直接通过串口发送原始字节是不够的，我们需要一个简单的协议，让双方知道一段数据从哪里开始、到哪里结束、以及它代表什么含义。一个健壮的协议能有效避免数据错乱。这里推荐一种简单高效的“帧结构”设计。

帧结构示例：[起始符][命令/数据类型][数据长度][数据内容][校验和][结束符]

  • 起始符/结束符：例如用<和>，用于在数据流中识别一帧数据的边界。这是解决“粘包”问题的关键。
  • 命令/数据类型：一个字节（char）或短整数，用于标识这帧数据的意图。例如，'T'代表温度数据，'L'代表控制LED。
  • 数据长度：指示后续“数据内容”部分的字节数，便于接收方准确解析。
  • 数据内容：实际要传输的数据，可以是文本（如"25.6"），也可以是二进制（如浮点数的字节数组）。
  • 校验和：一个简单的字节，由前面所有字节相加后取低8位得到。用于验证数据在传输过程中是否出错。

在实际项目中，为了快速验证，我们可以先从更简单的文本协议开始。例如，约定上位机发送字符串"LED_ON\n"控制LED亮，发送"TEMP?\n"查询温度；下位机回复"TEMP:25.6\n"。\n（换行符）在这里就充当了帧结束符。SerialPort类的ReadLine()方法可以很方便地读取到换行符为止的数据。这种方式虽然效率不如二进制帧，但胜在直观、易调试。

3. Arduino端（下位机）程序实现详解

Arduino端的核心任务是：初始化串口、解析来自C#应用的指令、执行相应操作（如读取传感器、控制引脚）、然后组织数据回复。

3.1 基础框架与串口初始化

// 定义引脚和全局变量 const int ledPin = 13; // 板载LED const int tempSensorPin = A0; // 假设温度传感器接在A0 float temperature = 0.0; void setup() { // 初始化串口，波特率必须与C#端设置一致 Serial.begin(9600); // 初始化IO引脚 pinMode(ledPin, OUTPUT); digitalWrite(ledPin, LOW); // 等待串口连接（对于某些板卡有必要） while (!Serial) { ; } Serial.println("Arduino Ready."); // 发送就绪信号 } void loop() { // 1. 检查并读取串口指令 if (Serial.available() > 0) { String command = Serial.readStringUntil('\n'); // 以换行符为结束读取命令 command.trim(); // 去除首尾空白字符 processCommand(command); } // 2. 可以在这里添加定时采集数据并主动上报的逻辑（可选） // static unsigned long lastReport = 0; // if (millis() - lastReport > 5000) { // 每5秒上报一次 // readTemperature(); // Serial.print("DATA,TEMP,"); // Serial.println(temperature); // lastReport = millis(); // } }

关键点解析：

  • Serial.begin(9600)：设置通信波特率。这是通信的基石，必须保证两端（Arduino和C#程序）的波特率、数据位、停止位、校验位设置完全一致，否则接收到的将是乱码。9600是常用且稳定的速率。
  • Serial.readStringUntil('\n')：这是实现简单文本协议的关键。它会持续读取串口数据，直到遇到换行符\n，然后将之前接收到的字符作为一个完整的字符串返回。这天然地解决了一帧数据的边界问题。
  • command.trim()：非常重要！串口读取的字符串末尾可能包含回车\r或其他不可见字符，trim()能清理它们，避免后续字符串比较失败。

3.2 指令处理与数据回复

在processCommand函数中，我们解析并执行命令。

void processCommand(String cmd) { if (cmd.equals("LED_ON")) { digitalWrite(ledPin, HIGH); Serial.println("STATUS,LED,ON"); // 回复执行状态 } else if (cmd.equals("LED_OFF")) { digitalWrite(ledPin, LOW); Serial.println("STATUS,LED,OFF"); } else if (cmd.equals("GET_TEMP")) { readTemperature(); // 读取温度 // 组织回复数据，格式建议包含数据类型和值，用逗号分隔便于C#端分割 Serial.print("DATA,TEMP,"); Serial.println(temperature, 2); // 发送温度，保留2位小数 } else if (cmd.startsWith("SET_PWM:")) { // 示例：接收设置PWM值的命令，格式如 "SET_PWM:128" int pwmValue = cmd.substring(8).toInt(); // 提取冒号后的部分并转整数 pwmValue = constrain(pwmValue, 0, 255); // 限制范围 analogWrite(ledPin, pwmValue); // 假设LED支持PWM Serial.print("STATUS,PWM_SET,"); Serial.println(pwmValue); } else { Serial.print("ERROR,UNKNOWN_CMD:"); Serial.println(cmd); // 将错误命令回传，便于上位机调试 } } void readTemperature() { // 模拟一个温度读取过程（假设使用LM35，10mV/°C） int sensorValue = analogRead(tempSensorPin); float voltage = (sensorValue / 1024.0) * 5.0; // 转换为电压值 temperature = voltage * 100.0; // LM35转换公式 }

实操心得：

  1. 回复格式标准化：像"DATA,TEMP,25.6"或"STATUS,LED,ON"这样的回复格式，包含了数据类别和状态，方便C#端用string.Split(',')统一解析，扩展新传感器或指令时非常清晰。
  2. 错误处理：一定要有else分支来处理未知命令，并回复错误信息。这在上位机调试阶段能快速定位是命令发送错误还是Arduino程序逻辑问题。
  3. 避免使用delay()：在loop()中如果使用长时间的delay()，会阻塞串口数据的接收。对于需要定时执行的任务，应使用millis()进行非阻塞计时，如上面注释的定时上报逻辑。

4. C#端（上位机）程序实现详解

C#端我们将使用WinForms创建一个带有基础控制界面的应用程序。核心是System.IO.Ports.SerialPort组件。

4.1 界面布局与串口初始化

首先，在Visual Studio中创建一个WinForms项目，从工具箱拖拽以下控件到窗体：

  • ComboBox(Name:comboBoxPorts)：用于列出可用串口。
  • Button(Name:buttonRefreshPorts)：刷新串口列表。
  • Button(Name:buttonConnect)：连接/断开串口。
  • TextBox(Name:textBoxSend)：用于输入要发送的命令。
  • Button(Name:buttonSend)：发送命令按钮。
  • RichTextBox(Name:richTextBoxReceived)：用于显示接收到的数据。
  • Label(Name:labelStatus)：显示连接状态。

在窗体加载和刷新按钮事件中，动态获取系统串口列表：

private void Form1_Load(object sender, EventArgs e) { RefreshPortList(); } private void buttonRefreshPorts_Click(object sender, EventArgs e) { RefreshPortList(); } private void RefreshPortList() { string currentSelection = comboBoxPorts.SelectedItem?.ToString(); comboBoxPorts.Items.Clear(); string[] ports = SerialPort.GetPortNames(); comboBoxPorts.Items.AddRange(ports); if (!string.IsNullOrEmpty(currentSelection) && ports.Contains(currentSelection)) { comboBoxPorts.SelectedItem = currentSelection; } else if (comboBoxPorts.Items.Count > 0) { comboBoxPorts.SelectedIndex = 0; } }

4.2 串口连接、数据发送与接收

这是C#端的核心逻辑。我们使用一个SerialPort实例来管理连接。

private SerialPort serialPort = new SerialPort(); private void buttonConnect_Click(object sender, EventArgs e) { if (!serialPort.IsOpen) { // 连接操作 try { serialPort.PortName = comboBoxPorts.SelectedItem?.ToString(); if (string.IsNullOrEmpty(serialPort.PortName)) { MessageBox.Show("请选择串口！"); return; } // 参数必须与Arduino端严格匹配 serialPort.BaudRate = 9600; serialPort.DataBits = 8; serialPort.StopBits = StopBits.One; serialPort.Parity = Parity.None; serialPort.Handshake = Handshake.None; // 设置编码，处理中文（如果传输文本包含中文） serialPort.Encoding = System.Text.Encoding.UTF8; // 非常重要：设置数据接收事件处理函数 serialPort.DataReceived += SerialPort_DataReceived; serialPort.Open(); buttonConnect.Text = "断开连接"; labelStatus.Text = $"已连接 {serialPort.PortName}"; richTextBoxReceived.AppendText($"[{DateTime.Now:HH:mm:ss}] 系统：串口连接成功。\n"); } catch (Exception ex) { MessageBox.Show($"连接失败：{ex.Message}"); } } else { // 断开连接操作 try { serialPort.DataReceived -= SerialPort_DataReceived; // 移除事件订阅 serialPort.Close(); buttonConnect.Text = "连接"; labelStatus.Text = "未连接"; richTextBoxReceived.AppendText($"[{DateTime.Now:HH:mm:ss}] 系统：串口已断开。\n"); } catch (Exception ex) { MessageBox.Show($"断开失败：{ex.Message}"); } } } // 发送命令按钮事件 private void buttonSend_Click(object sender, EventArgs e) { if (serialPort.IsOpen && !string.IsNullOrWhiteSpace(textBoxSend.Text)) { try { string commandToSend = textBoxSend.Text.Trim() + "\n"; // 添加结束符 serialPort.Write(commandToSend); richTextBoxReceived.AppendText($"[{DateTime.Now:HH:mm:ss}] 发送：{textBoxSend.Text.Trim()}\n"); textBoxSend.Clear(); } catch (Exception ex) { MessageBox.Show($"发送失败：{ex.Message}"); } } }

关键点解析：

  • 参数匹配：BaudRate,DataBits,StopBits,Parity必须与Arduino端Serial.begin()的设置完全一致，这是通信成功的前提。
  • DataReceived事件：这是异步接收数据的标准做法。当串口接收缓冲区有数据到达时，会触发此事件。绝对不要在UI线程中直接使用SerialPort.ReadExisting()循环读取，这会阻塞界面。
  • 添加结束符：serialPort.Write(commandToSend + "\n")，我们在发送的字符串末尾添加了换行符\n，这与Arduino端的readStringUntil('\n')遥相呼应，构成完整的帧。

4.3 异步数据接收与线程安全更新UI

DataReceived事件是在后台线程中触发的，不能直接在其中操作UI控件（如richTextBoxReceived），否则会导致程序崩溃。

private void SerialPort_DataReceived(object sender, SerialDataReceivedEventArgs e) { // 此方法在非UI线程执行 try { if (serialPort.IsOpen) { // 读取所有可用数据。使用ReadExisting或ReadTo。 string receivedData = serialPort.ReadExisting(); // 或者使用 ReadTo("\n") 按行读取，但要注意缓冲区处理 // 将数据派发到UI线程进行显示 this.Invoke(new Action(() => { // 对接收到的数据进行处理，例如按行分割 if (!string.IsNullOrEmpty(receivedData)) { // 直接追加显示，可以按需进行格式化 richTextBoxReceived.AppendText($"[{DateTime.Now:HH:mm:ss}] 接收：{receivedData}"); // 自动滚动到最后 richTextBoxReceived.ScrollToCaret(); // 可以在这里添加更复杂的数据解析逻辑 // ParseReceivedData(receivedData); } })); } } catch (Exception ex) { // 记录或显示错误 this.Invoke(new Action(() => { richTextBoxReceived.AppendText($"[{DateTime.Now:HH:mm:ss}] 接收错误：{ex.Message}\n"); })); } }

注意事项：

  1. Invoke是必须的：this.Invoke(new Action(() => { ... }))是将代码块安全地切换到UI线程执行的关键。WinForms中还可以使用BeginInvoke。
  2. 数据完整性：ReadExisting()会读取当前串口缓冲区中的所有内容。如果Arduino一次发送的数据量很大或很快，可能会分多次触发DataReceived事件。对于严格的帧协议，更好的做法是在事件中读取字节到自定义缓冲区，然后在UI线程或另一个解析线程中根据帧结构（如起始符、结束符）来解析完整的一帧数据。
  3. 性能考虑：频繁地调用Invoke和更新UI（尤其是RichTextBox）可能会在高速数据流下影响性能。对于高速数据采集，应考虑使用队列（Queue<string>）缓冲数据，然后使用定时器在UI线程中定时批量更新显示。

5. 高级应用与协议优化

5.1 实现二进制协议传输

当需要传输浮点数、整数等非文本数据，或对传输效率、精度有要求时，文本协议（如"25.6"）就显得低效且易出错。此时需要采用二进制协议。

Arduino端（发送一个浮点数）：

float myFloat = 25.6f; byte *dataPtr = (byte*)&myFloat; // 获取浮点数内存地址 Serial.write(dataPtr, sizeof(float)); // 发送4个字节

C#端（接收并解析）： 在DataReceived事件中，我们需要按字节读取并重组。

private List<byte> byteBuffer = new List<byte>(); // 用于累积字节的缓冲区 private void SerialPort_DataReceived_Binary(object sender, SerialDataReceivedEventArgs e) { int bytesToRead = serialPort.BytesToRead; byte[] buffer = new byte[bytesToRead]; serialPort.Read(buffer, 0, bytesToRead); byteBuffer.AddRange(buffer); // 解析缓冲区，寻找完整帧 while (byteBuffer.Count >= 4) // 假设我们一帧就是一个float (4字节) { // 这里可以加入更复杂的帧头帧尾判断 byte[] floatBytes = byteBuffer.Take(4).ToArray(); byteBuffer.RemoveRange(0, 4); this.Invoke(new Action(() => { float receivedFloat = BitConverter.ToSingle(floatBytes, 0); // 注意字节序！Arduino通常是Little-Endian，与PC一致，但跨平台时需确认 // 如果字节序不对，需要 Array.Reverse(floatBytes); richTextBoxReceived.AppendText($"收到浮点数：{receivedFloat:F2}\n"); })); } }

重要提示：二进制通信必须严格处理字节序（Endianness）。Arduino AVR架构是小端序（Little-Endian），与x86/x64的Windows一致，所以通常没问题。但如果使用其他架构的Arduino兼容板（如某些ESP32配置），或与不同架构的系统通信，就必须进行字节序转换。

5.2 多线程与数据队列

对于需要稳定、高速、不丢包的数据采集应用，一个生产-消费者模型是更专业的选择。

  1. 独立的接收线程：不再依赖DataReceived事件，而是创建一个后台线程（Thread或Task）来阻塞式读取串口数据（SerialPort.Read(byte[], int, int)），并放入一个线程安全的队列（如ConcurrentQueue<byte[]>）。
  2. 独立的解析线程：另一个线程从队列中取出原始字节数组，根据协议解析成有意义的数据包。
  3. UI定时器更新：使用一个System.Windows.Forms.Timer，定时（如每100ms）从解析线程或另一个共享数据结构中取出已解析好的数据，更新到UI控件上。

这种架构将耗时的IO操作、数据解析与UI渲染解耦，能极大提升程序的响应速度和稳定性，避免因UI操作缓慢导致数据接收缓冲区溢出。

6. 调试技巧与常见问题排查

在实际开发中，通信失败是常态。以下是我总结的排查清单：

问题1：C#程序打开串口时提示“端口已被占用”或“访问被拒绝”。

  • 原因：最常见的原因是Arduino IDE的串口监视器没有关闭，或者另一个程序（如其他串口调试助手）占用了该COM口。
  • 解决：关闭所有可能占用该串口的软件，包括Arduino IDE。如果问题依旧，尝试重启电脑或更换USB口。

问题2：能连接，但发送数据后Arduino无反应，或接收到的全是乱码。

  • 原因：波特率等参数不匹配是首要怀疑对象。
  • 排查：
    1. 双重检查C#端SerialPort的BaudRate、DataBits、StopBits、Parity是否与Arduino代码中Serial.begin()的参数一字不差。
    2. 使用串口调试助手（如Putty、AccessPort）作为“中间人”。让调试助手连接Arduino，看是否能正常收发。再用C#程序连接调试助手（需要虚拟串口对软件创建一对虚拟COM口），隔离测试双方。

问题3：数据接收不完整，或者几帧数据粘在一起。

  • 原因：这就是“粘包”问题。没有明确的帧边界判断机制。
  • 解决：
    1. 文本模式：确保发送方在每条命令后都添加了唯一的结束符（如\n），接收方使用ReadLine()或ReadTo("\n")。
    2. 二进制模式：设计包含帧头、长度、帧尾的协议。接收方先寻找帧头，然后根据“长度”字段读取指定字节数，最后验证帧尾。

问题4：C#界面在接收数据时卡顿、无响应。

  • 原因：在DataReceived事件中执行了耗时操作（如复杂的字符串处理、数据库写入），或者频繁地、不加限制地调用Invoke更新UI。
  • 解决：
    1. 在DataReceived事件中只做最核心的数据读取和入队操作。
    2. 将数据解析和UI更新移到其他线程或定时器中。
    3. 控制UI更新频率，例如每收集到10条数据或每100ms才更新一次显示。

问题5：通信一段时间后突然中断。

  • 原因：可能是线路干扰、电源不稳定，或者程序中有未处理的异常导致串口对象状态异常。
  • 解决：
    1. 在C#代码中所有serialPort.Read/Write操作周围添加try-catch，捕获InvalidOperationException、TimeoutException等。
    2. 实现一个心跳机制。C#端定时发送一个"PING"命令，Arduino端回复"PONG"。如果连续几次收不到回复，则认为连接断开，触发重连逻辑。
    3. 检查硬件连接，尤其是长距离导线，考虑使用屏蔽线并远离强电干扰源。

我个人在项目中最深刻的体会是，前期花时间设计一个鲁棒的通信协议和错误处理机制，远比后期调试各种灵异问题要高效得多。先从最简单的文本协议、带换行符的交互开始，让通信链路跑通。然后，根据项目复杂度的提升，逐步引入二进制协议、多线程、心跳包、数据校验等高级特性。每次改动后，都用串口调试助手进行验证，确保每一帧数据都符合预期。最后，C#与Arduino的串口通信，核心在于“约定大于配置”，双方对数据格式、时序的严格约定，是通信稳定的基石。

编程学习 学习日记 实战经验
← 返回列表