RJCP.DLL.SerialPortStream 是一个.NET库，提供了对串口通信的高级封装。与System.IO.Ports.SerialPort相比，它提供了更稳定的性能和更丰富的功能，如更好的异步读写支持和对串口参数的更细致控制。本文将通过几个示例展示如何使用SerialPortStream进行串口通信。

安装

首先，需要通过NuGet安装SerialPortStream库。在Visual Studio中，可以通过NuGet包管理器搜索SerialPortStream并安装，或者在包管理器控制台中运行以下命令：

Install-Package RJCP.SerialPortStream

示例1：打开串口

这个例子展示了如何打开串口。

SerialPortStream serialPort = new SerialPortStream("COM1", 9600);
private void btnConnect_Click(object sender, EventArgs e)
{

    try
    {
        serialPort.Open();
        stsMain_lblLog.Text = "串口已打开";
    }
    catch (Exception ex)
    {
        stsMain_lblLog.Text = "打开出错";
    }
}

示例2：发送数据

本示例展示如何向串口发送数据。

private void btnSend_Click(object sender, EventArgs e)
{
    string dataToSend = "Hello, Serial Port!";
    byte[] data = System.Text.Encoding.ASCII.GetBytes(dataToSend);

    serialPort.Write(data, 0, data.Length);
}

示例3：异步读取数据

本示例展示如何异步读取串口数据，这对于不阻塞主线程而持续监听串口非常有用。

serialPort.DataReceived += SerialPort_DataReceived1;

private async void SerialPort_DataReceived1(object? sender, SerialDataReceivedEventArgs e)
{
    byte[] buffer = new byte[1024];
    int bytesRead = await serialPort.ReadAsync(buffer, 0, buffer.Length);
    this.Invoke(() =>
    {
        txtLog.AppendText(System.Text.Encoding.UTF8.GetString(buffer));
        txtLog.AppendText(System.Environment.NewLine);
    });

}

示例4：设置串口参数

本示例展示如何设置串口的一些常见参数，比如波特率、数据位、停止位和奇偶校验位。

SerialPortStream serialPort = new SerialPortStream("COM1", 9600)
{
    DataBits = 8,
    Parity = Parity.None,
    StopBits = StopBits.One,
};

示例5：关闭串口

serialPort.Close();

主要优势

RJCP.DLL.SerialPortStream库与System.IO.Ports.SerialPort类都是用于.NET应用程序中实现串口通信的工具。尽管它们在功能上有一定的重叠，但RJCP.DLL.SerialPortStream提供了一些显著的优势和改进，使其在某些场景下成为更佳的选择。以下是RJCP.DLL.SerialPortStream相比于System.IO.Ports.SerialPort的一些主要优势：

1. 更好的跨平台支持

• RJCP.DLL.SerialPortStream：设计时就考虑了跨平台的兼容性，因此在Windows、Linux和MacOS上都能提供一致的行为和性能。
• System.IO.Ports.SerialPort：虽然.NET Core和.NET 5/6增强了跨平台支持，但在不同操作系统上的表现可能仍有所不同，尤其是在Linux和MacOS上。

2. 更稳定的性能

• RJCP.DLL.SerialPortStream：专注于提供稳定的性能，特别是在高负载或长时间运行的应用程序中。它通过使用本地代码（尤其是在Windows系统上）来优化数据传输和处理，减少了延迟和资源消耗。
• System.IO.Ports.SerialPort：虽然在大多数常规应用中表现良好，但在极端条件下（如高速数据传输、长时间运行）可能会遇到性能瓶颈或稳定性问题。

3. 更丰富的功能和配置选项

• RJCP.DLL.SerialPortStream：提供了更多的配置选项和功能，如调制解调器信号状态的检测、串口缓冲区大小的调整等，这些在System.IO.Ports.SerialPort中可能不那么容易实现或配置。
• System.IO.Ports.SerialPort：提供了基础的串口通信功能，对于大多数简单应用来说已经足够。但在需要高级功能时，可能需要额外的工作或寻找替代方案。

4. 更好的异步支持

• RJCP.DLL.SerialPortStream：提供了更完整的异步API支持，使得在不阻塞主线程的情况下进行数据读写变得更加容易和高效。
• System.IO.Ports.SerialPort：虽然也支持异步操作，但在某些版本的.NET Framework中，其异步API的实现可能不如RJCP.DLL.SerialPortStream那样完善。

5. 更好的错误处理和诊断

• RJCP.DLL.SerialPortStream：提供了更详细的错误报告和诊断信息，这对于开发和调试复杂的串口通信应用程序来说非常有用。
• System.IO.Ports.SerialPort：在错误处理和诊断方面相对较简单，可能需要开发者自己实现更详细的日志记录和错误分析机制。

结论

RJCP.DLL.SerialPortStream 是一个功能强大且易于使用的.NET库，适用于需要进行串口通信的应用程序。通过上述示例，您可以开始使用这个库来打开串口、发送和接收数据以及设置串口参数。这个库提供的功能远不止这些，更多高级功能和使用方法可以参考官方文档。