C#串口开发之SerialPort类封装
SerialPort类
微软在.NET中对串口通讯进行了封装，我们可以在.net2.0及以上版本开发时直接使用SerialPort类对串口进行读写操作。
为操作方便，本文对SerialPort类做了一些封装，暂时取名为SerialPortClient。
SerialPort类的属性主要包括：
- 串口名称（PortName）
- 波特率（BaudRate）
- 数据位 DataBits
- 停止位 StopBits
- 奇偶校验 Parity
SerialPort类的事件主要包括：
- DataReceived：用于异步接收串口数据事件
- ErrorReceived：错误处理事件
SerialPort类的方法主要包括：Open();Close();Read();Write()、DiscardInBuffer()、DiscardOutBuffer()等
参数封装
波特率、数据位这些参数不是系统内置的枚举类型，为方便实际操作需构造波特率、数据位这两个枚举对象。
#region 波特率、数据位的枚举
/// <summary>
/// 串口数据位列表（5,6,7,8）
/// </summary>
public enum DataBits : int
{
Five = 5,
Six = 6,
Sevent = 7,
Eight = 8
}
/// <summary>
/// 串口波特率列表。
/// 75,110,150,300,600,1200,2400,4800,9600,14400,19200,28800,38400,56000,57600,
/// 115200,128000,230400,256000
/// </summary>
public enum BaudRates : int
{
BR_75 = 75,
BR_110 = 110,
BR_150 = 150,
BR_300 = 300,
BR_600 = 600,
BR_1200 = 1200,
BR_2400 = 2400,
BR_4800 = 4800,
BR_9600 = 9600,
BR_14400 = 14400,
BR_19200 = 19200,
BR_28800 = 28800,
BR_38400 = 38400,
BR_56000 = 56000,
BR_57600 = 57600,
BR_115200 = 115200,
BR_128000 = 128000,
BR_230400 = 230400,
BR_256000 = 256000
}
#endregion
控件操作封装
对常用的参数下拉列表绑定做一个封装，该操作为封装类的静态方法。
为兼容第三方控件使用IList接口，不直接使用ComboBox类型作为参数。
#region 静态方法
/// <summary>
/// 设置串口号
/// </summary>
/// <param name="obj">需要绑定的项的集合（如：ComboBox中项的集合ComboBox.Items）</param>
public static void SetPortNameValues(IList obj)
{
obj.Clear();
try
{
foreach (string str in SerialPort.GetPortNames())
{
obj.Add(str);
}
}
catch (Exception e)
{
Console.WriteLine("未能查询到串口名称——"+e.ToString());
}
}
/// <summary>
/// 设置波特率
/// </summary>
/// <param name="obj">需要绑定的项的集合（如：ComboBox中项的集合ComboBox.Items）</param>
public static void SetBauRateValues(IList obj)
{
obj.Clear();
foreach (BaudRates rate in Enum.GetValues(typeof(BaudRates)))
{
obj.Add(((int)rate).ToString());
}
}
/// <summary>
/// 设置数据位
/// </summary>
/// <param name="obj">需要绑定的项的集合（如：ComboBox中项的集合ComboBox.Items）</param>
public static void SetDataBitsValues(IList obj)
{
obj.Clear();
foreach (DataBits databit in Enum.GetValues(typeof(DataBits)))
{
obj.Add(((int)databit).ToString());
}
}
/// <summary>
/// 设置校验位列表
/// </summary>
/// <param name="obj">需要绑定的项的集合（如：ComboBox中项的集合ComboBox.Items）</param>
public static void SetParityValues(IList obj)
{
obj.Clear();
foreach (string str in Enum.GetNames(typeof(Parity)))
{
obj.Add(str);
}
}
/// <summary>
/// 设置停止位
/// </summary>
/// <param name="obj">需要绑定的项的集合（如：ComboBox中项的集合ComboBox.Items）</param>
public static void SetStopBitValues(IList obj)
{
obj.Clear();
foreach (string str in Enum.GetNames(typeof(StopBits)))
{
obj.Add(str);
}
}
#endregion
SerialPortClient类实现
该部分代码是SerialPortClient类非静态操作部分的实现，完整的类实现需要加上上面的控件操作封装的实现代码，具体请参照Demo源码。
#region 变量属性
public event Action<List<byte>> DataReceived;
public event SerialErrorReceivedEventHandler ErrorReceived;
private SerialPort comPort = new SerialPort();
private string portName = "COM1";//串口号，默认COM1
private BaudRates baudRate = BaudRates.BR_9600;//波特率
private Parity parity = Parity.None;//校验位
private StopBits stopBits = StopBits.One;//停止位
private DataBits dataBits = DataBits.Eight;//数据位
/// <summary>
/// 串口号
/// </summary>
public string PortName
{
get { return portName; }
set { portName = value; }
}
/// <summary>
/// 波特率
/// </summary>
public BaudRates BaudRate
{
get { return baudRate; }
set { baudRate = value; }
}
/// <summary>
/// 奇偶校验位
/// </summary>
public Parity Parity
{
get { return parity; }
set { parity = value; }
}
/// <summary>
/// 数据位
/// </summary>
public DataBits DataBits
{
get { return dataBits; }
set { dataBits = value; }
}
/// <summary>
/// 停止位
/// </summary>
public StopBits StopBits
{
get { return stopBits; }
set { stopBits = value; }
}
#endregion
#region 构造函数
/// <summary>
/// 无参构造函数
/// </summary>
public SerialPortClient()
{
BoundEvents();
}
void BoundEvents()
{
comPort.DataReceived += new SerialDataReceivedEventHandler(comPort_DataReceived);
comPort.ErrorReceived += new SerialErrorReceivedEventHandler(comPort_ErrorReceived);
}
/// <summary>
/// 参数构造函数（使用枚举参数构造）
/// </summary>
/// <param name="baud">波特率</param>
/// <param name="par">奇偶校验位</param>
/// <param name="sBits">停止位</param>
/// <param name="dBits">数据位</param>
/// <param name="name">串口号</param>
public SerialPortClient(string name, BaudRates baud, Parity par, DataBits dBits, StopBits sBits)
{
this.portName = name;
this.baudRate = baud;
this.parity = par;
this.dataBits = dBits;
this.stopBits = sBits;
BoundEvents();
}
/// <summary>
/// 参数构造函数（使用字符串参数构造）
/// </summary>
/// <param name="baud">波特率</param>
/// <param name="par">奇偶校验位</param>
/// <param name="sBits">停止位</param>
/// <param name="dBits">数据位</param>
/// <param name="name">串口号</param>
public SerialPortClient(string name, string baud, string par, string dBits, string sBits)
{
this.portName = name;
this.baudRate = (BaudRates)Enum.Parse(typeof(BaudRates), baud);
this.parity = (Parity)Enum.Parse(typeof(Parity), par);
this.dataBits = (DataBits)Enum.Parse(typeof(DataBits), dBits);
this.stopBits = (StopBits)Enum.Parse(typeof(StopBits), sBits);
BoundEvents();
}
#endregion
#region 事件处理函数
/// <summary>
/// 数据仓库
/// </summary>
List<byte> datapool = new List<byte>();//存放接收的所有字节
/// <summary>
/// 数据接收处理
/// </summary>
void comPort_DataReceived(object sender, SerialDataReceivedEventArgs e)
{
if (comPort.IsOpen) //判断是否打开串口
{
Byte[] receivedData = new Byte[comPort.BytesToRead]; //创建接收字节数组
comPort.Read(receivedData, 0, receivedData.Length); //读取数据
//触发整条记录的处理
if (DataReceived != null)
{
datapool.AddRange(receivedData);
DataReceived(datapool);
}
}
else
{
Console.WriteLine("请打开某个串口", "Error");
}
}
/// <summary>
/// 错误处理函数
/// </summary>
void comPort_ErrorReceived(object sender, SerialErrorReceivedEventArgs e)
{
if (ErrorReceived != null)
{
ErrorReceived(sender, e);
}
}
#endregion
#region 串口关闭/打开
/// <summary>
/// 端口是否已经打开
/// </summary>
public bool IsOpen
{
get
{
return comPort.IsOpen;
}
}
/// <summary>
/// 打开端口
/// </summary>
/// <returns></returns>
public void Open()
{
if (comPort.IsOpen) comPort.Close();
comPort.PortName = portName;
comPort.BaudRate = (int)baudRate;
comPort.Parity = parity;
comPort.DataBits = (int)dataBits;
comPort.StopBits = stopBits;
comPort.Open();
}
/// <summary>
/// 关闭端口
/// </summary>
public void Close()
{
if (comPort.IsOpen) comPort.Close();
}
/// <summary>
/// 丢弃来自串行驱动程序的接收和发送缓冲区的数据
/// </summary>
public void DiscardBuffer()
{
comPort.DiscardInBuffer();
comPort.DiscardOutBuffer();
}
#endregion
#region 写入数据
/// <summary>
/// 写入数据
/// </summary>
/// <param name="buffer"></param>
public void Write(byte[] buffer, int offset, int count)
{
if (!(comPort.IsOpen)) comPort.Open();
comPort.Write(buffer,offset, count);
}
/// <summary>
/// 写入数据
/// </summary>
/// <param name="buffer">写入端口的字节数组</param>
public void Write(byte[] buffer)
{
if (!(comPort.IsOpen)) comPort.Open();
comPort.Write(buffer, 0, buffer.Length);
}
#endregion
SerialPortClient类使用
SerialPortClient类使用很简单，主要分为初始化下拉列表、初始化串口（绑定数据接收、错误处理事件）两步，在窗体加载事件中调用即可。代码如下：
//全局变量
SerialPortClient portClient = new SerialPortClient();
private void InitPort()
{
portClient.DataReceived+=new Action<List<byte>>(datapool=>
{
//匹配数据帧，此处以0xea 0xeb为帧头、0xfa 0xfb为帧尾
//实际通讯协议应该更复杂
while (true)
{
if (datapool.Count <4) break;
if ((datapool[0] == 0xea) && (datapool[0] == 0xeb))
{
datapool.RemoveAt(0);
continue;
}
int index = -1;//正确作法是记住上次最末尾的索引，避免重复匹配
for (int i = 0; i < datapool.Count-1; i++)
{
if (datapool[i] == 0xfa && datapool[i + 1] == 0xfb)
{
index = i;
break;
}
}
if (index != -1)
{
byte[] data = datapool.GetRange(0, index + 2).ToArray();
datapool.RemoveRange(0, index + 2);
string msg = Encoding.UTF8.GetString(data,2,data.Length-4);
this.BeginInvoke(new Action(() => { textBox_Recive.Text = msg; }));
}
else break;
}
});
}
private void InitCmb()
{
//绑定端口号
SerialPortClient.SetPortNameValues(comboBox_Com.Items);
comboBox_Com.DropDownStyle = ComboBoxStyle.DropDownList;
comboBox_Com.SelectedIndexChanged += new EventHandler((obj, e) =>
{
if (comboBox_Com.SelectedItem!=null)
{
portClient.PortName = comboBox_Com.SelectedItem.ToString();
}
});
comboBox_Com.SelectedIndex = 0;
//波特率
SerialPortClient.SetBauRateValues(comboBox_BaudRates.Items);
comboBox_BaudRates.DropDownStyle = ComboBoxStyle.DropDownList;
comboBox_BaudRates.SelectedIndexChanged += new EventHandler((obj, e) =>
{
if (comboBox_BaudRates.SelectedItem != null)
{
portClient.BaudRate = (BaudRates)Enum.Parse(typeof(BaudRates), comboBox_BaudRates.SelectedItem.ToString());
}
});
comboBox_BaudRates.SelectedIndex = 9;
//数据位
SerialPortClient.SetDataBitsValues(comboBox_DataBits.Items);
comboBox_DataBits.DropDownStyle = ComboBoxStyle.DropDownList;
comboBox_DataBits.SelectedIndexChanged += new EventHandler((obj, e) =>
{
if (comboBox_DataBits.SelectedItem != null)
{
portClient.DataBits = (DataBits)Enum.Parse(typeof(DataBits), comboBox_DataBits.SelectedItem.ToString());
}
});
comboBox_DataBits.SelectedIndex = 3;
//校验位
SerialPortClient.SetParityValues(comboBox_Parity.Items);
comboBox_Parity.DropDownStyle = ComboBoxStyle.DropDownList;
comboBox_Parity.SelectedIndexChanged += new EventHandler((obj, e) =>
{
if (comboBox_Parity.SelectedItem != null)
{
portClient.Parity = (Parity)Enum.Parse(typeof(Parity), comboBox_Parity.SelectedItem.ToString());
}
});
comboBox_Parity.SelectedIndex = 0;
//停止位
SerialPortClient.SetStopBitValues(comboBox_StopBits.Items);
comboBox_StopBits.DropDownStyle = ComboBoxStyle.DropDownList;
comboBox_StopBits.SelectedIndexChanged += new EventHandler((obj, e) =>
{
if (comboBox_StopBits.SelectedItem != null)
{
portClient.StopBits = (StopBits)Enum.Parse(typeof(StopBits), comboBox_StopBits.SelectedItem.ToString());
}
});
comboBox_StopBits.SelectedIndex = 1;
}
串口的打开、关闭、状态显示等操作请查看文章末尾的Demo源码。
测试Demo
Demo下载：https://files-cdn.cnblogs.com/files/timefiles/SerialPortDemo.rar
参考文章
C#串口开发之SerialPort类封装的更多相关文章
- Android开发之SharedPreferences的封装
对于大部分初学者来说,如果想利用SharedPreferences进行数据存储的话大部分人(包括本人)应该会这样: 存储: SharedPreferences sharedPreferences = ...
- Java开发之File类
File类 File类是对文件系统中文件以及文件夹进行封装的对象,可以通过对象的思想来操作文件和文件夹. File类保存文件或目录的各种元数据信息,包括文件名.文件长度.最后修改时间.是否可读.获取当 ...
- [置顶] Android开发之Thread类分析
在我们Linux系统中创建线程函数为:pthread_create(),在Android中我们为线程封装了一个类Thread,实际调用的还是pthread_create() 当我们想创建线程的时候,只 ...
- Android开发之Thread类分析 （转载）
转自:http://blog.csdn.net/llping2011/article/details/9706599 在我们Linux系统中创建线程函数为:pthread_create(),在Andr ...
- Android开发之MediaRecorder类详解
MediaRecorder类介绍: MediaRecorder类是Android sdk提供的一个专门用于音视频录制,一般利用手机麦克风采集音频,摄像头采集图片信息. MediaRecorder主要函 ...
- Android开发之MediaPlayer类
官网关于MediaPlayer类的使用简介:
- Android开发之Path类使用详解，自绘各种各样的图形！
玩过自定义View的小伙伴都知道,在View的绘制过程中,有一个类叫做Path,Path可以帮助我们实现很多自定义形状的View,特别是配合xfermode属性来使用的时候.OK,那我们今天就来看看P ...
- 安卓开发之HttpURLConnection类和Handler类的使用
package com.lidaochen.test; import java.io.ByteArrayOutputStream; import java.io.InputStream; public ...
- Android开发之PackageManager类
PackageManger,可以获取到手机上所有的App,并可以获取到每个App中清单文件的所有内容. 设置应用程序版本号在应用程序的manifest文件中定义应用程序版本信息.2个必须同时定义的属性 ...
- cocos2dx开发之util类&方法——取当前系统时间
返回time_t,即从1970年1月1日至今的秒数 time_t getSysTime(){ time_t currentTime = time(NULL); return currentTime; ...
随机推荐
- 驱动开发：如何枚举所有SSDT表地址
在前面的博文<驱动开发:Win10内核枚举SSDT表基址>中已经教大家如何寻找SSDT表基地址了,找到后我们可根据序号获取到指定SSDT函数的原始地址,而如果需要输出所有SSDT表信息,则 ...
- C/C++ 通过CRC32实现反破解
我们可以通过使用CRC32算法计算出程序的CRC字节,并将其写入到PE文件的空缺位置,这样当程序再次运行时,来检测这个标志,是否与计算出来的标志一致,来决定是否运行程序,一旦程序被打补丁,其crc32 ...
- 深入浅出Java多线程(三)：线程与线程组
「引言」 大家好,我是你们的老伙计秀才!今天带来的是[深入浅出Java多线程]系列的第三篇内容:线程与线程组.大家觉得有用请点赞,喜欢请关注!秀才在此谢过大家了!!! 在现代软件开发中,多线程编程已成 ...
- Dart常用核心知识
Dart简述 Dart 是一个为全平台构建快速应用的客户端优化的编程语言,免费且开源. Dart是面向对象的.类定义的.单继承的语言.它的语法涵盖了多种语言的语法特性,如C,JavaScirpt, J ...
- locate命令找不到，但是实际文件存在的情况
locate和find命令都是linux下常用的搜索命令,但是locate命令是从一个数据库里面搜索的,它的速度比find查找要快上不少.如果存在某个文件用locate查不到的话,那么可以用upd ...
- Pandas日期时间格式化
当进行数据分析时,我们会遇到很多带有日期.时间格式的数据集,在处理这些数据集时,可能会遇到日期格式不统一的问题,此时就需要对日期时间做统一的格式化处理.比如"Wednesday, June ...
- 精通C语言：打造高效便捷的通讯录管理系统
欢迎大家来到贝蒂大讲堂 养成好习惯,先赞后看哦~ 所属专栏:C语言项目 贝蒂的主页:Betty's blog 引言: 在我们大致学习完C语言之后,我们就可以利用目前所学的知识去做一些有意思的项目,而今 ...
- 解锁Mysql中的JSON数据类型，怎一个爽字了得
引言 在实际业务开发中,随着业务的变化,数据的复杂性和多样性不断增加.传统的关系型数据库模型在这种情况下会显得受限,因为它们需要预先定义严格的数据模式,并且通常只能存储具有相同结构的数据.而面对非结构 ...
- Java集合框架学习（十三） Collections类详解
Collections类介绍 这个类操作或返回集合的专有静态方法. 它包含多态算法,利用wrappers(封装器)返回指定集合类型的新集合,以及其他一些零散功能. 如果该类的方法引用的集合或类对象为n ...
- eclipse解决maven不自动下载jar包问题
今天在eclipse中import一个maven项目,由于我手工中断了相关pom.xml中配置的jar包下载. 导致项目找不到一些jar包.具体错误见下图: 原因就是有些jar包下载没有完成导致的. ...