当前位置：首页 > news >正文

C# 串口通信教程

news 2025/7/17 21:36:35

串口通信（Serial Communication）是一种用于设备之间数据传输的常见方法，通常用于与外部硬件设备（如传感器、机器人、微控制器）进行通信。在 C# 中，System.IO.Ports 命名空间提供了与串口设备交互的功能，可以轻松实现串口通信。

本教程将引导你如何在 C# 中实现串口通信，并展示一些常用的通信操作，如打开和关闭串口、读取和写入数据。

一、添加 `System.IO.Ports` 命名空间

在进行串口通信之前，需要导入 System.IO.Ports 命名空间，它提供了 SerialPort 类，用于串口操作：

using System.IO.Ports;

二、配置串口参数

在串口通信中，通常需要设置以下几个关键参数：

串口号（Port Name）：用于指定与哪个串口进行通信（如 COM1、COM3）。
波特率（Baud Rate）：通信的速度，一般常见的值有 9600、115200 等。
数据位（Data Bits）：数据传输的位数，一般为 8。
停止位（Stop Bits）：一个字节结束后的停止位，一般为 1。
奇偶校验位（Parity）：用于错误检测，一般为 None。

以下是如何在 C# 中创建并配置 SerialPort 对象的示例代码：

SerialPort serialPort = new SerialPort();// 设置串口号
serialPort.PortName = "COM3";// 设置波特率
serialPort.BaudRate = 9600;// 设置数据位
serialPort.DataBits = 8;// 设置停止位
serialPort.StopBits = StopBits.One;// 设置奇偶校验位
serialPort.Parity = Parity.None;

三、打开和关闭串口

在配置好串口参数之后，需要调用 Open 方法来打开串口。完成数据传输后，应使用 Close 方法关闭串口。

try
{// 打开串口serialPort.Open();Console.WriteLine("串口已打开");// 进行数据通信...
}
catch (Exception ex)
{Console.WriteLine($"无法打开串口: {ex.Message}");
}
finally
{// 关闭串口if (serialPort.IsOpen){serialPort.Close();Console.WriteLine("串口已关闭");}
}

四、读取和写入数据

通过 SerialPort 类的 Read 和 Write 方法，可以从串口读取和写入数据。可以采用同步或异步的方式来进行数据通信。以下是一些常见的操作。

1. 同步写入数据

try
{if (serialPort.IsOpen){string message = "Hello, Device!";serialPort.WriteLine(message); // 向串口写入数据Console.WriteLine($"已发送: {message}");}
}
catch (Exception ex)
{Console.WriteLine($"写入数据时出错: {ex.Message}");
}

2. 同步读取数据

try
{if (serialPort.IsOpen){string receivedData = serialPort.ReadLine(); // 从串口读取数据Console.WriteLine($"收到: {receivedData}");}
}
catch (Exception ex)
{Console.WriteLine($"读取数据时出错: {ex.Message}");
}

3. 异步读取数据

为了避免阻塞程序，可以使用 DataReceived 事件异步接收数据。当串口收到数据时，该事件将被触发。

// 订阅 DataReceived 事件
serialPort.DataReceived += new SerialDataReceivedEventHandler(DataReceivedHandler);// 打开串口
serialPort.Open();// 异步数据接收处理
private static void DataReceivedHandler(object sender, SerialDataReceivedEventArgs e)
{SerialPort sp = (SerialPort)sender;string receivedData = sp.ReadExisting();Console.WriteLine($"异步收到: {receivedData}");
}

五、错误处理和调试

在串口通信中，常见的错误包括无法打开串口、串口被占用、数据读取超时等。在调试串口通信时，可以使用以下几种方法：

捕获异常：使用 try-catch 语句来捕获和处理异常。
检查串口状态：通过 serialPort.IsOpen 属性检查串口是否已打开。
设置超时：可以通过 serialPort.ReadTimeout 和 serialPort.WriteTimeout 设置读写操作的超时时间。

serialPort.ReadTimeout = 500;  // 500 毫秒
serialPort.WriteTimeout = 500; // 500 毫秒

六、完整示例

以下是一个完整的串口通信示例，展示了如何打开串口、发送和接收数据，并处理常见的错误。

using System;
using System.IO.Ports;class Program
{static void Main(string[] args){SerialPort serialPort = new SerialPort();// 串口配置serialPort.PortName = "COM3";serialPort.BaudRate = 9600;serialPort.DataBits = 8;serialPort.StopBits = StopBits.One;serialPort.Parity = Parity.None;// 订阅数据接收事件serialPort.DataReceived += new SerialDataReceivedEventHandler(DataReceivedHandler);try{// 打开串口serialPort.Open();Console.WriteLine("串口已打开");// 发送数据serialPort.WriteLine("Hello, Device!");Console.WriteLine("数据已发送");// 等待一段时间来接收数据Console.ReadLine();}catch (Exception ex){Console.WriteLine($"串口通信出错: {ex.Message}");}finally{// 关闭串口if (serialPort.IsOpen){serialPort.Close();Console.WriteLine("串口已关闭");}}}// 数据接收处理private static void DataReceivedHandler(object sender, SerialDataReceivedEventArgs e){SerialPort sp = (SerialPort)sender;string receivedData = sp.ReadExisting();Console.WriteLine($"收到的数据: {receivedData}");}
}