概述:RJCP.DLL.SerialPortStream库为C#串口通信提供强大支持,跨平台、高度可定制,集成基础功能如打开、配置串口和数据读写,以及高级功能包括事件处理、超时设置等,极大简化串口开发流程,适用于不同平台和复杂通信需求。
C#串口开发之RJCP.DLL.SerialPortStream库介绍
用途与优点
RJCP.DLL.SerialPortStream库用于C#中串口通信的开发,具有以下优点:
- 跨平台支持: 适用于Windows、Linux和macOS等多个平台。
- 高度可定制性: 提供灵活的配置选项,可满足不同串口通信需求。
- 开源社区支持: 在GitHub上积极维护,可获取最新版本和社区支持。
基础功能
1. 创建 SerialPortStream 实例
using RJCP.IO.Ports;
SerialPortStream serialPort = new SerialPortStream("COM1");
2. 打开和关闭串口
serialPort.Open();
// 进行串口操作
serialPort.Close();
3. 配置串口参数
serialPort.BaudRate = 9600;
serialPort.Parity = Parity.None;
serialPort.DataBits = 8;
serialPort.StopBits = StopBits.One;
4. 读取和写入数据
// 读取数据
byte[] buffer = new byte[1024];
int bytesRead = serialPort.Read(buffer, 0, buffer.Length);
// 写入数据
byte[] dataToSend = Encoding.UTF8.GetBytes("Hello, Serial!");
serialPort.Write(dataToSend, 0, dataToSend.Length);
高级功能
1. 事件处理
// 添加数据接收事件处理程序
serialPort.DataReceived += (sender, e) => {
byte[] receivedData = new byte[serialPort.BytesToRead];
serialPort.Read(receivedData, 0, receivedData.Length);
Console.WriteLine($"Received: {Encoding.UTF8.GetString(receivedData)}");
};
2. 超时设置
// 设置读取超时时间为100毫秒
serialPort.ReadTimeout = 100;
3. 自定义流控制
// 自定义流控制为RTS/CTS
serialPort.Handshake = Handshake.RequestToSend;
完整示例
以下是一个结合基础和高级功能的完整示例:
using System;
using System.Text;
using RJCP.IO.Ports;
class Program {
static void Main() {
using (SerialPortStream serialPort = new SerialPortStream("COM1")) {
// 基础功能:打开串口、配置参数
serialPort.Open();
serialPort.BaudRate = 9600;
serialPort.Parity = Parity.None;
serialPort.DataBits = 8;
serialPort.StopBits = StopBits.One;
// 高级功能:数据接收事件处理
serialPort.DataReceived += (sender, e) => {
byte[] receivedData = new byte[serialPort.BytesToRead];
serialPort.Read(receivedData, 0, receivedData.Length);
Console.WriteLine($"Received: {Encoding.UTF8.GetString(receivedData)}");
};
// 发送数据
byte[] dataToSend = Encoding.UTF8.GetBytes("Hello, Serial!");
serialPort.Write(dataToSend, 0, dataToSend.Length);
// 等待一段时间以接收数据
Console.WriteLine("Waiting for data...");
Console.ReadLine();
}
}
}
以上示例演示了RJCP.DLL.SerialPortStream库的基础和高级功能,包括打开和配置串口、事件处理、超时设置和流控制等。