#region 串口通讯
public class SerialPortComm : IDisposable
{
#region 字段与事件
private readonly SerialPort serialPort;
private bool disposed = false;
public event Action<Exception> ErrorOccurred;
/// <summary>
/// 数据接收事件
/// 当串口收到数据时触发，参数为接收到的 byte[] 数组
/// 使用示例：comm.PortData += data => { /* 处理数据 */ };
/// 注意：此事件在工作线程中触发，更新 UI 需使用 Invoke
/// </summary>
public event Action<byte[]> PortData;
#endregion
#region 构造函数
/// <summary>
/// 无参构造：默认配置串口参数
/// </summary>
public SerialPortComm()
{
serialPort = new SerialPort();
InitializeDefaultSettings();
}
/// <summary>
/// 带参构造：指定串口号和波特率
/// </summary>
/// <param name="portName">串口名称，如 COM3</param>
/// <param name="baudRate">波特率，如 96
00</param>
public SerialPortComm(string portName, int baudRate) : this()
{
if (!string.IsNullOrEmpty(portName))
serialPort.PortName = portName;
if (baudRate >
0)
serialPort.BaudRate = baudRate;
}
/// <summary>
/// 初始化默认串口设置
/// 包括数据位、停止位、奇偶校验、握手协议、超时时间等
/// </summary>
private void InitializeDefaultSettings()
{
serialPort.DataBits = 8; //
--------------------数据位：8位
serialPort.StopBits = StopBits.One; //
---------停止位：1位
serialPort.Parity = Parity.None; //
------------奇偶校验：无
serialPort.Handshake = Handshake.None; //
------握手协议：无
serialPort.ReadTimeout = 5
00; //
---------------读取超时：5
00ms
serialPort.WriteTimeout = 5
00; //
--------------写入超时：5
00ms
// 绑定数据接收事件：当串口有数据到达时，自动调用 OnDataReceived 方法
serialPort.DataReceived += OnDataReceived;
}
#endregion
#region 串口初始化
/// <summary>
/// 初始化串口参数（端口名和波特率）
/// 必须在串口未打开的状态下才能修改
/// </summary>
/// <param name="portName">要设置的串口号，如 "COM4"</param>
/// <param name="baudRate">要设置的波特率，如 1152
00</param>
public void IniSerialPort(string portName, int baudRate)
{
// 防止对象已被销毁后调用
if (disposed)
throw new ObjectDisposedException(nameof(SerialPortComm));
// 如果串口已经打开，则不允许修改配置
if (serialPort.IsOpen)
return;
// 设置串口号（仅当输入有效时）
if (!string.IsNullOrEmpty(portName))
serialPort.PortName = portName;
// 设置波特率（仅当输入合法时）
if (baudRate >
0)
serialPort.BaudRate = baudRate;
}
/// <summary>
/// 获取系统中可用的串口列表
/// </summary>
public static string[] GetAvailablePorts()
{
return SerialPort.GetPortNames();
}
#endregion
#region 打开/关闭
/// <summary>
/// 打开串口
/// 调用 SerialPort.Open() 方法启动通信
/// 出错时弹出消息框提示用户
/// </summary>
public void Open()
{
// 检查对象是否已被释放
if (disposed)
throw new ObjectDisposedException(nameof(SerialPortComm));
try
{
// 只有在未打开的情况下才执行打开操作
if (!serialPort.IsOpen)
serialPort.Open();
}
catch (Exception ex)
{
// 1. 记录错误日志（便于调试）
System.Diagnostics.Debug.WriteLine($"[SerialPortComm] 打开串口失败: {ex.Message}");
// 2. 触发错误事件，让上层订阅者自行处理（例如弹窗、写日志等）
OnError(ex);
}
}
/// <summary>
/// 关闭串口
/// </summary>
public void Close()
{
if (disposed) return;
try
{
if (serialPort.IsOpen)
{
serialPort.DiscardInBuffer(); // 清空输入缓冲
serialPort.DiscardOutBuffer(); // 清空输出缓冲
serialPort.Close(); // 关闭串口
}
}
catch (Exception ex)
{
System.Diagnostics.Debug.WriteLine("关闭串口异常：" + ex.Message);
}
}
#endregion
#region 状态查询
/// <summary>
/// 获取串口是否已打开
/// </summary>
/// <returns>true 表示已打开</returns>
public bool IsOpen() => serialPort.IsOpen;
#endregion
#region 数据写入
/// <summary>
/// 发送
字符串数据
/// 使用当前编码（默认为 ASCII）将
字符串转为字节发送
/// </summary>
/// <param name="msg">要发送的
字符串</param>
public void Write(string msg)
{
// 参数检查：空
字符串不发送
if (string.IsNullOrEmpty(msg)) return;
try
{
if (serialPort.IsOpen)
serialPort.Write(msg);
}
catch (Exception ex)
{
OnError(ex);
}
}
/// <summary>
/// 发送字节数组
/// 适用于发送二进制命令（如 Modbus、相机控制指令）
/// </summary>
/// <param name="data">要发送的 byte[] 数组</param>
public void Write(byte[] data)
{
if (data == null || data.Length ==
0) return;
try
{
if (serialPort.IsOpen)
serialPort.Write(data,
0, data.Length);
}
catch (Exception ex)
{
OnError(ex);
}
}
/// <summary>
/// 发送字符数组
/// 类似于 Write(string)，但支持 char[] 输入
/// </summary>
/// <param name="data">要发送的 char[] 数组</param>
public void Write(char[] data)
{
if (data == null || data.Length ==
0) return;
try
{
if (serialPort.IsOpen)
serialPort.Write(data,
0, data.Length);
}
catch (Exception ex)
{
OnError(ex);
}
}
#endregion
#region 数据读取
/// <summary>
/// 数据接收事件处理方法
/// 当串口检测到有数据到达时，系统自动调用此方法
/// </summary>
/// <param name="sender">事件源对象（即 SerialPort）</param>
/// <param name="e">事件参数</param>
private void OnDataReceived(object sender, SerialDataReceivedEventArgs e)
{
try
{
// 获取当前有多少字节可读
int count = serialPort.BytesToRead;
// 如果没有数据，直接返回
if (count ==
0) return;
// 创建缓冲区存储数据
byte[] buffer = new byte[count];
int read = serialPort.Read(buffer,
0, count);
// 确保实际读取数量大于
0
if (read >
0)
{
// 使用
临时数组确保长度准确
byte[] data = new byte[read];
Array.Copy(buffer, data, read);
// 触发事件（注意：此事件在工作线程中执行）
PortData?.Invoke(data);
}
}
catch (Exception ex)
{
OnError(ex);
}
}
#endregion
#region 错误处理辅助
/// <summary>
/// 统一错误处理入口
/// 可用于记录日志或通知上层
/// </summary>
/// <param name="ex">发生的异常</param>
private void OnError(Exception ex)
{
System.Diagnostics.Debug.WriteLine("串口错误：" + ex.Message);
}
#endregion
#region 串口关闭
/// <summary>
/// 实现 IDisposable 接口
/// </summary>
public void Dispose()
{
Dispose(true);
GC.SuppressFinalize(this);
}
protected virtual void Dispose(bool disposing)
{
if (disposed) return;
if (disposing)
{
serialPort?.Dispose(); // 释放 SerialPort 资源
}
disposed = true;
}
#endregion
}
#endregion
OneString是一种创新的0GC解决方案，用于将数字和布尔值转换为字符串而无需产生垃圾回收。该方案支持多种数据类型，包括int、long、float、double和bool，并允许设置浮点数精度。通过提供临时字符串的复用，OneString在打印或临时显示数值时显著减少内存消耗。
扫一扫
721
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
