1、C#基本操作步骤。
①新建项目:
VS---新建---项目---选择C#下面的Windows窗口应用程序,输入项目"名称"、选择保存"位置",点确定。
②添加按钮(添加button控件):
工具箱窗口选择"button"---拖动到"Form1.cs[设计]","button"的属性窗口,
"name"是button的唯一名称标识,"text"是button上显示的文本信息。
③添加处理函数(添加button控件事件处理函数):
双击设计窗口的"button",自动添加“button1_Click”函数,光标移动到代码输入位置,
添加代码语句"MessageBox.Show("hello world");"。
④执行并生成执行文件(调试及运行):
调试菜单----启动调试F5(或者开始执行不调试ctrl+F5),可以观察到项目的执行情况。
生成菜单---生成解决方案,项目保存路径找到bin---debug里面有"xxxxxx.exe",双击即可看到项目的执行情况。
2、C#编写串口助手。
①创建Windows窗口应用程序。
文件---新建---项目,选择Visual C#,选择Windows窗体应用chen程序,名称:项目名称"serial commcommunication",位置:保存项目的路径,解决方案:创建新的解决方案(添加到解决方案),解决方案名称:自动生成与项目名称相同,框架:.NET Framework 4.7,默认勾选为解决方案创建目录,点击确定。
Program.cs是默认生成的C#文件,里面的程序是默认生成的。
Form1.cs是自动生成的窗体,双击可以看见窗体,在窗体右键---查看代码,可以看到同名Form1.cs的C#文件。
②创建窗体的界面。
Form1窗体添加三个GroupBox控件,Text分别设置为:串口设置、接收数据、发送数据。
Form1窗体添加五个Lable控件,Text分别设置为:串口号:、波特率:、停止位:、奇偶校验:、数据位:。
Form1窗体添加五个ComoBox控件,Name分别设置为:cbxCOMPort、cbxBaudRate、cbxStopBits、cbxParity、cbxDataBits。
Form1窗体添加两个RadioButton控件,Text分别设置为:字符显示、HEX显示,Name分别设置为:rbnChar、rbnHex,
Checked分别为:True、False。
Form1窗体添加四个Button控件,Text分别设置为:检测串口、打开串口、清空数据、发送数据,
Name分别设置为:btnCheckCom、btnOpenCom、btnClearData、btnSendData。
Form1窗体添加两个TextBox控件,Name分别设置为:tbxRecvData、tbxSendData,接收的ReadOnly属性设置为True。
Fomr1窗体的AcceptButton属性设置为btnSendData,在窗体上回车关联到发送数据按钮。
③代码编写。
- 加入命名空间:
using System.IO.Ports; //添加命名空间System.IO.Ports,因为要用到串口类
- 定义四个变量:
SerialPort sp = null; //申明一个串口类
bool isOpen = false; //打开串口的标志
bool isSetProperty = false; //属性设置的标志
bool isHex = false; //十六进制显示的标志
- 自动生成Form1的构造函数:
public Form1()
{
InitializeComponent(); //所有零件初始化
}
- Form1的加载函数:
private void Form1_Load(object sender, EventArgs e)
{
this.MaximizeBox = false; //窗口的最大化按钮失能
this.MaximumSize = this.Size; //窗口的最大尺寸为当前尺寸
this.MinimumSize = this.Size; //窗口的最小尺寸为当前尺寸
//博客后面的函数都需要添加在此
}
- 添加串口号:
for(int i=0;i<10;i++)
{
cbxCOMPort.Items.Add("COM"+(i+1).ToString()); //ComboBox的Items属性的Add方法,可以添加条目
}
cbxCOMPort.SelectedIndex = 0; //串口号选择的索引为0,即COM1
- 添加波特率:
cbxBaudRate.Items.Add("1200"); //cbxBaudRaud的Items属性的Add方法,可以添加条目
cbxBaudRate.Items.Add("2400");
cbxBaudRate.Items.Add("4800");
cbxBaudRate.Items.Add("9600");
cbxBaudRate.Items.Add("19200");
cbxBaudRate.Items.Add("38400");
cbxBaudRate.Items.Add("115200");
cbxBaudRate.SelectedIndex = 5; //波特率选择的索引为5,即38400波特率
- 添加停止位:
cbxStopBits.Items.Add("0"); //cbxStopBits的Items属性的Add方法,可以添加条目
cbxStopBits.Items.Add("1");
cbxStopBits.Items.Add("1.5");
cbxStopBits.Items.Add("2");
cbxStopBits.SelectedIndex = 0; //停止位选择的索引为0,即0位停止
- 添加奇偶校验:
cbxParity.Items.Add("无"); //cbxParity的Items属性的Add方法,可以添加条目
cbxParity.Items.Add("奇校验");
cbxParity.Items.Add("偶校验");
cbxParity.SelectedIndex = 0; //校验选择的索引为0,即无校验
- 添加数据位:
cbxDataBits.Items.Add("8"); //cbxDataBits的Items属性的Add方法,可以添加条目
cbxDataBits.Items.Add("7");
cbxDataBits.Items.Add("6");
cbxDataBits.Items.Add("5");
cbxDataBits.SelectedIndex = 0; //数据位选择的索引为0,即8位数据
- 显示类型:
rbnChar.Checked = true; //rbnChar选中
- 检测可用串口:
private void btnCheckCom_Click(object sender, EventArgs e)
{
bool comExistence = false; //有无可用串口标志位
cbxCOMPort.Items.Clear(); //清除当前串口号中的所有串口名称
for(int i=0;i<10;i++)
{
try
{
SerialPort sp = new SerialPort("COM"+(i+1).ToString()); //sp依次赋值COM1、COM2、、COM10
sp.Open();
sp.Close();
cbxCOMPort.Items.Add("COM"+(i+1).ToString()); //串口可以打开关闭说明串口可以使用,否则跳到异常
comExistence = true; //有可用串口则标志位为true
}
catch(Exception)
{
continue; //COM1串口不存在,则继续COM2,依次循环到COM10
}
}
if(comExistence)
{
cbxCOMPort.SelectedIndex = 0; //串口号更新为最先有效的串口
}
else
{
MessageBox.Show("没有找到可用的串口!","错误提示");
}
}
- 检查串口是否设置:
private bool CheckPortSetting()
{
if(cbxCOMPort.Text.Trim()==“”) return false; //Trim()删除开头和结尾的空白字符
if(cbxBaudRate.Text.Trim()==“”) return false;
if(cbxDataBits.Text.Trim()==“”) return false;
if(cbxStopBits.Text.Trim()==“”) return false;
if(cbxParity.Text.Trim()==“”) return false;
return true; //串口号、波特率、数据位、停止位、校验同时不为空,则返回true
}
- 检查发送数据是否为空:
private bool CheckSendData()
{
if(tbxSendData.Tex.Trim()=="") turn false; //发送数据框为空返回false
return true;
}
- 设置串口的属性:
private void SetProperty()
{
sp = new SerialPort(); //初始化sp
sp.PortName = cbxCOMPort.Text.Trim(); //设置串口名
sp.BaudRate = Convert.ToInt32(cbxBaudRate.Text.Trim()); //设置波特率,波特率是把字符串转换为32位整型
if(cbxStopBits.Text.Trim()=="0")
{
sp.StopBits = StopBits.None; //停止位为0
}
else if(cbxStopBits.Text.Trim()=="1.5")
{
sp.StopBits = StopBits.OnePointFive; //停止位为1.5
}
else if(cbxStopBits.Text.Trim()=="2")
{
sp.StopBits = StopBits.Two; //停止位为2
}
else
{
sp.StopBits = StopBits.One; //停止位为1
}
sp.DataBits = Convert.ToInt16(cbxDataBits.Text.Trim()); //设置数据位,数据位是把字符串转换为16位整型
if(cbxParity.Text.Trim()=="奇校验")
{
sp.Parity = Parity.Odd; //奇校验
}
else if(cbxParity.Text.Trim()=="偶校验")
{
sp.Parity = Parity.Even; //偶校验
}
else
{
sp.Parity = Parity.None; //不校验
}
}
sp.ReadTimeout = -1; //读取数据不超时,同 sp.ReadTimeout = TimeOut.Infinite
sp.RtsEnable = true; //request to send,请求发送使能
sp.DataReceived += new SerialDataReceivedEventHandler(sp_DataReceived); //定义sp_DataReceived接收数据触发事件
if(rbnHex.Checked) //rbnHex选中则显示十六进制,否则不显示十六进制
{
isHex = true;
}
else
{
isHex = false;
}
}
- 打开串口函数:
private void btnOpenCom_Click(object sender, EventArgs e)
{
if(isOpen == false) //之前串口是关闭的,则执行if语句块
{
if(!CheckPortSetting()) //串口未设置
{
MessageBox.Show("串口未设置", "错误提示");
return; //void函数加return,退出函数体
}
if(!isSetProperty)
{
SetPortProperty(); //设置串口属性
isSetProperty = true; //串口属性设置标志位设置为true
}
try
{
sp.Open(); //打开串口
isOpen = true; //串口打开标志位设置为true
btnOpenCom.Text = "关闭串口"; //btnOpenCom的文本设置为“关闭串口”
cbxCOMPort.Enabled = false; //串口号失能
cbxBaudRate.Enabled = false; //波特率
cbxDataBits.Enabled = false; //数据位
cbxStopBits.Enabled = false; //停止位
cbxParity.Enabled = false; //校验
rbnChar.Enabled = false; //字符型
rbnHex.Enabled = false; //Hex型
}
catch(Exception)
{
isSetProperty = false; //串口设置标志位设置为false
isOpen = false; //串口打开标志位设置为false
MessageBox.Show("串口无效或已被占用", "错误提示"); //打开失败提示消息框
}
}
else //之前串口是打开的,则执行else语句块
{
try
{
sp.Close(); //关闭串口
isOpen = false; //串口打开标志位设置为false
btnOpenCom.Text = "打开串口"; //btnOpenCom的文本设置为“打开串口”
cbxCOMPort.Enabled = true; //串口号使能
cbxBaudRate.Enabled = true; //波特率
cbxDataBits.Enabled = true; //数据位
cbxStopBits.Enabled = true; //停止位
cbxParity.Enabled = true; //校验
rbnChar.Enabled = true; //字符型
rbnHex.Enabled = true; //Hex型
}
catch(Exception)
{
MessageBox.Show("关闭串口时发生错误", "错误提示"); //关闭失败提示消息框
}
}
}
- 发送数据函数:
private void btnSendData_Click(object sender, EventArgs e)
{
if(isOpen) //串口打开状态
{
try
{
sp.WriteLine(tbxSendData.Text); //串口发送数据
}
catch
{
MessageBox.Show("发送数据时发生错误!", "错误提示");
return;
}
}
else
{
MessageBox.Show("串口未打开", "错误提示");
}
if(!CheckSendData())
{
MessageBox.Show("请输入要发送的数据", "错误提示");
}
}
- 接收数据函数:
private void sp_DataReceived(object sender, SerialDataReceivedEventArgs e)
{
System.Threading.Thread.Sleep(100); //延时100ms,等待接收完数据
this.Invoke((EventHandler)delegate //this.Invoke是跨线程访问ui的方法,也是文本的范例
{
if(isHex==false)
{
tbxRecvData.Text += sp.ReadLine(); //字符型,把接收字符直接显示在tbxRecvData上面,sp.ReadLine读串口字符串
}
else
{
Byte[] ReceivedData = new Byte[sp.BytesToRead]; //定义并初始化字符数组,sp.ByteToRead串口读字符串长度
sp.Read(ReceivedData, 0, ReceivedData.Length); //字符数组读取串口数据
String RecvDataText = null; //定义字符串
for(int i=0;i<ReceivedData.Length;i++)
{
RecvDataText += ("0X" + ReceivedData[i].ToString("X2") + " "); //串口接收字符数组,字符依次转换为字符串,0Xxx
//X2:X是十六进制,2是两位。(A X2--0X0A,A X---0XA)
}
tbxRecvData.Text += RecvDataText; //转换后的字符串显示到tbxRecvData上面
}
sp.DiscardInBuffer(); //清除串口接收缓冲区数据
});
}
- 清除数据函数:
private void btnClearData_Click(object sender, EventArgs e)
{
tbxRecvData.Text = "";
tbxSendData.Text = "";
}
- 源码如下:
//参考 https://wenku.baidu.com/view/8c6822f9a0116c175e0e4823.html
using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Linq;
using System.Text;
using System.Windows.Forms;
using System.IO.Ports; //自己添加
namespace serial_communication
{
public partial class Form1 : Form
{
SerialPort sp = null; //声明一个串口类
bool isOpen = false; //打开串口标志位
bool isSetProperty = false; //属性设置标志位
bool isHex = false; //十六进制显示标志位
public Form1() //Form1的构造函数,net自动生成
{
InitializeComponent(); //初始化所有零件(包括控件、组件等)
}
private void Form1_Load(object sender, EventArgs e) //双击form自动生成的函数,form回车处理函数
{
//设置窗口大小
this.MaximizeBox = false; //影藏最大化按钮
this.MaximumSize = this.Size; //固定窗口尺寸最大为当前尺寸
this.MinimumSize = this.Size; //固定窗口尺寸最小为当前尺寸
for (int i = 0; i < 10; i++) //最大支持10个串口,可根据自己需求增加
{
cbxCOMPort.Items.Add("COM"+(i+1).ToString());
}
cbxCOMPort.SelectedIndex = 0;
//列出常用的波特率
cbxBaudRate.Items.Add("1200");
cbxBaudRate.Items.Add("2400");
cbxBaudRate.Items.Add("4800");
cbxBaudRate.Items.Add("9600");
cbxBaudRate.Items.Add("19200");
cbxBaudRate.Items.Add("38400");
cbxBaudRate.Items.Add("115200");
cbxBaudRate.SelectedIndex = 5;
//列出停止位
cbxStopBits.Items.Add("0");
cbxStopBits.Items.Add("1");
cbxStopBits.Items.Add("1.5");
cbxStopBits.Items.Add("2");
cbxStopBits.SelectedIndex = 1;
//列出数据位
cbxDataBits.Items.Add("8");
cbxDataBits.Items.Add("7");
cbxDataBits.Items.Add("6");
cbxDataBits.Items.Add("5");
cbxDataBits.SelectedIndex = 0;
//列出奇偶校验位
cbxParity.Items.Add("无");
cbxParity.Items.Add("奇校验");
cbxParity.Items.Add("偶校验");
cbxParity.SelectedIndex = 0;
//默认为char显示
rbnChar.Checked = true;
}
private void btnCheckCom_Click(object sender, EventArgs e) //检测哪些串口可用,btnCheckCom串口检测点击处理函数
{
bool comExistence = false; //有可用串口标志位
cbxCOMPort.Items.Clear(); //清除当前串口号中的所有串口名称
for (int i = 0; i < 10; i++)
{
try
{
SerialPort sp = new SerialPort("COM" + (i + 1).ToString());
sp.Open();
sp.Close();
cbxCOMPort.Items.Add("COM" + (i + 1).ToString());
comExistence = true;
}
catch (Exception)
{
continue;
}
}
if (comExistence)
{
cbxCOMPort.SelectedIndex = 0;
}
else
{
MessageBox.Show("没有找到可用的串口!", "错误提示");
}
}
private bool CheckPortSetting() //检查串口是否设置
{
if (cbxCOMPort.Text.Trim() == "") return false;
if (cbxBaudRate.Text.Trim() == "") return false;
if (cbxDataBits.Text.Trim() == "") return false;
if (cbxParity.Text.Trim() == "") return false;
if (cbxStopBits.Text.Trim() == "") return false;
return true;
}
private bool CheckSendData() //检查发送数据是否输入
{
if (tbxSendData.Text.Trim() == "") return false;
return true;
}
private void SetPortProperty() //设置串口的属性
{
sp = new SerialPort();
sp.PortName = cbxCOMPort.Text.Trim(); //设置串口名
sp.BaudRate = Convert.ToInt32(cbxBaudRate.Text.Trim()); //设置串口的波特率
if (cbxStopBits.Text.Trim() == "0") //设置停止位
{
sp.StopBits = StopBits.None;
}
else if (cbxStopBits.Text.Trim() == "1.5")
{
sp.StopBits = StopBits.OnePointFive;
}
else if (cbxStopBits.Text.Trim() == "2")
{
sp.StopBits = StopBits.Two;
}
else
{
sp.StopBits = StopBits.One;
}
sp.DataBits = Convert.ToInt16(cbxDataBits.Text.Trim()); //设置数据位
if (cbxParity.Text.Trim() == "奇校验") //设置校验
{
sp.Parity = Parity.Odd;
}
else if (cbxParity.Text.Trim() == "偶校验")
{
sp.Parity = Parity.Even;
}
else
{
sp.Parity = Parity.None;
}
sp.ReadTimeout = -1; //设置超时读取时间
sp.RtsEnable = true;
//定义DataReceived事件,当串口收到数据后触发事件
sp.DataReceived += new SerialDataReceivedEventHandler(sp_DataReceived);
if (rbnHex.Checked)
{
isHex = true;
}
else
{
isHex = false;
}
}
private void btnOpenCom_Click(object sender, EventArgs e) //打开串口,btnopencom点击处理函数
{
if (isOpen == false)
{
if (!CheckPortSetting()) //检测串口设置
{
MessageBox.Show("串口未设置", "错误提示");
return;
}
if (!isSetProperty)
{
SetPortProperty();
isSetProperty = true;
}
try
{
sp.Open();
isOpen = true;
btnOpenCom.Text = "关闭串口";
//串口打开后,相关的串口设置按钮不可再用
cbxCOMPort.Enabled = false;
cbxBaudRate.Enabled = false;
cbxDataBits.Enabled = false;
cbxStopBits.Enabled = false;
cbxParity.Enabled = false;
rbnChar.Enabled = false;
rbnHex.Enabled = false;
}
catch (Exception)
{
//打开串口失败后,相应标志位取消
isSetProperty = false;
isOpen = false;
MessageBox.Show("串口无效或已被占用", "错误提示");
}
}
else
{
try //打开串口
{
sp.Close();
isOpen = false;
isSetProperty = false;
btnOpenCom.Text = "打开串口";
//关闭串口后,串口设置选项可以继续使用
cbxCOMPort.Enabled = true;
cbxBaudRate.Enabled = true;
cbxDataBits.Enabled = true;
cbxStopBits.Enabled = true;
cbxParity.Enabled = true;
rbnChar.Enabled = true;
rbnHex.Enabled = true;
}
catch (Exception)
{
MessageBox.Show("关闭串口时发生错误", "错误提示");
}
}
}
private void btnSendData_Click(object sender, EventArgs e) //发送数据,btnsenddata点击处理函数
{
if (isOpen)
{
try
{
sp.WriteLine(tbxSendData.Text);
}
catch (Exception)
{
MessageBox.Show("发送数据时发生错误!", "错误提示");
return;
}
}
else
{
MessageBox.Show("串口未打开", "错误提示");
return;
}
if (!CheckSendData())
{
MessageBox.Show("请输入要发送的数据!", "错误提示");
return;
}
}
private void sp_DataReceived(object sender, SerialDataReceivedEventArgs e)
{
System.Threading.Thread.Sleep(100); //延时100ms等待接收完数据
//this.Invoke就是跨线程访问ui的方法,也是文本的范例
this.Invoke((EventHandler)delegate
{
if (isHex == false)
{
tbxRecvData.Text += sp.ReadLine();
}
else
{
Byte[] ReceivedData = new Byte[sp.BytesToRead];
sp.Read(ReceivedData, 0, ReceivedData.Length);
String RecvDataText = null;
for (int i = 0; i < ReceivedData.Length; i++)
{
RecvDataText += ("0x" + ReceivedData[i].ToString("X2") + " ");
}
tbxRecvData.Text += RecvDataText;
}
sp.DiscardInBuffer();
});
}
private void btnClearData_Click(object sender, EventArgs e)
{
tbxRecvData.Text = "";
tbxSendData.Text = "";
}
}
}