C# 串口操作系列(1) -- 入门篇，一个标准的，简陋的串口例子。

忘是亡心i 2022-08-07 09:54 174阅读 0赞

[点击打开链接][Link 1]

我假设读者已经了解了c\#的语法，本文是针对刚打算解除串口编程的朋友阅读的，作为串口编程的入门范例，也是我这个系列的基础。

我们的开发环境假定为vs2005(虽然我在用vs2010，但避免有些网友用2005，不支持lambda，避免不兼容，就用2005来做例子)

一个基本的串口程序，既然是个程序了。我们就先从功能说起，包含

串口选择

波特率选择

打开

关闭

接受数据显示

发送数据输入

发送数据

数据量提示以及归零

好吧，有了这些功能，我们就先画出界面。例如：

![38687_1273950504GzKy.jpg][]

这里，波特率就定死几种好了。直接界面上添加2400,4800,9600,19200,38400,57600,115200

comboPortName这里，为了我们的软件能通用所有电脑避免每次查询的效率损失，我们使用微软提供的枚举方式，代码如下：

**\[c-sharp\]** [ view plain][view plain] [copy][view plain]

1.  string\[\] ports = SerialPort.GetPortNames();  
2.  Array.Sort(ports);  
3.  comboPortName.Items.AddRange(ports);

显然，我们需要定义一个SerialPort对象。添加DataReceived事件响应收到数据，还有一个重点，我们需要记得设置NewLine属性哦。好想有的版本不设置的时候，WriteLine和Write效果一样。

所以，我们需要初始化SerialPort对象，例如：

**\[c-sharp\]** [ view plain][view plain] [copy][view plain]

1.  //初始化SerialPort对象  
2.  comm.NewLine = "/r/n";  
3.  comm.RtsEnable = true;//根据实际情况吧。  
4.  //添加事件注册  
5.  comm.DataReceived += comm\_DataReceived;

初始化好串口，简单的编写打开，关闭方法，编写界面响应的是否自动换行，如何复位计数器，发送方法。以及数据处理。因为我已经写了完整注视，我就直接贴代码了。

**\[c-sharp\]** [ view plain][view plain] [copy][view plain]

1.  using System;  
2.  using System.Collections.Generic;  
3.  using System.ComponentModel;  
4.  using System.Data;  
5.  using System.Drawing;  
6.  using System.Linq;  
7.  using System.Text;  
8.  using System.Windows.Forms;  
9.  using System.IO.Ports;  
10. using System.Text.RegularExpressions;  
11. namespace SerialportSample  
12. \{  
13.     public partial class SerialportSampleForm : Form  
14.     \{  
15.         private SerialPort comm = new SerialPort();  
16.         private StringBuilder builder = new StringBuilder();//避免在事件处理方法中反复的创建，定义到外面。  
17.         private long received\_count = 0;//接收计数  
18.         private long send\_count = 0;//发送计数  
19.         public SerialportSampleForm()  
20.         \{  
21.             InitializeComponent();  
22.         \}  
23.         //窗体初始化  
24.         private void Form1\_Load(object sender, EventArgs e)  
25.         \{  
26.             //初始化下拉串口名称列表框  
27.             string\[\] ports = SerialPort.GetPortNames();  
28.             Array.Sort(ports);  
29.             comboPortName.Items.AddRange(ports);  
30.             comboPortName.SelectedIndex = comboPortName.Items.Count > 0 ? 0 : -1;  
31.             comboBaudrate.SelectedIndex = comboBaudrate.Items.IndexOf("9600");  
32.             //初始化SerialPort对象  
33.             comm.NewLine = "/r/n";  
34.             comm.RtsEnable = true;//根据实际情况吧。  
35.             //添加事件注册  
36.             comm.DataReceived += comm\_DataReceived;  
37.         \}  
38.         void comm\_DataReceived(object sender, SerialDataReceivedEventArgs e)  
39.         \{  
40.             int n = comm.BytesToRead;//先记录下来，避免某种原因，人为的原因，操作几次之间时间长，缓存不一致  
41.             byte\[\] buf = new byte\[n\];//声明一个临时数组存储当前来的串口数据  
42.             received\_count += n;//增加接收计数  
43.             comm.Read(buf, 0, n);//读取缓冲数据  
44.             builder.Clear();//清除字符串构造器的内容  
45.             //因为要访问ui资源，所以需要使用invoke方式同步ui。  
46.             this.Invoke((EventHandler)(delegate  
47.             \{  
48.                 //判断是否是显示为16禁止  
49.                 if (checkBoxHexView.Checked)  
50.                 \{  
51.                     //依次的拼接出16进制字符串  
52.                     foreach (byte b in buf)  
53.                     \{  
54.                         builder.Append(b.ToString("X2") + " ");  
55.                     \}  
56.                 \}  
57.                 else  
58.                 \{  
59.                     //直接按ASCII规则转换成字符串  
60.                     builder.Append(Encoding.ASCII.GetString(buf));  
61.                 \}  
62.                 //追加的形式添加到文本框末端，并滚动到最后。  
63.                 this.txGet.AppendText(builder.ToString());  
64.                 //修改接收计数  
65.                 labelGetCount.Text = "Get:" + received\_count.ToString();  
66.             \}));  
67.         \}  
68.         private void buttonOpenClose\_Click(object sender, EventArgs e)  
69.         \{  
70.             //根据当前串口对象，来判断操作  
71.             if (comm.IsOpen)  
72.             \{  
73.                 //打开时点击，则关闭串口  
74.                 comm.Close();  
75.             \}  
76.             else  
77.             \{  
78.                 //关闭时点击，则设置好端口，波特率后打开  
79.                 comm.PortName = comboPortName.Text;  
80.                 comm.BaudRate = int.Parse(comboBaudrate.Text);  
81.                 try  
82.                 \{  
83.                     comm.Open();  
84.                 \}  
85.                 catch(Exception ex)  
86.                 \{  
87.                     //捕获到异常信息，创建一个新的comm对象，之前的不能用了。  
88.                     comm = new SerialPort();  
89.                     //现实异常信息给客户。  
90.                     MessageBox.Show(ex.Message);  
91.                 \}  
92.             \}  
93.             //设置按钮的状态  
94.             buttonOpenClose.Text = comm.IsOpen ? "Close" : "Open";  
95.             buttonSend.Enabled = comm.IsOpen;  
96.         \}  
97.         //动态的修改获取文本框是否支持自动换行。  
98.         private void checkBoxNewlineGet\_CheckedChanged(object sender, EventArgs e)  
99.         \{  
100.             txGet.WordWrap = checkBoxNewlineGet.Checked;  
101.         \}  
102.         private void buttonSend\_Click(object sender, EventArgs e)  
103.         \{  
104.             //定义一个变量，记录发送了几个字节  
105.             int n = 0;  
106.             //16进制发送  
107.             if (checkBoxHexSend.Checked)  
108.             \{  
109.                 //我们不管规则了。如果写错了一些，我们允许的，只用正则得到有效的十六进制数  
110.                 MatchCollection mc = Regex.Matches(txSend.Text, @"(?i)\[/da-f\]\{2\}");  
111.                 List<byte> buf = new List<byte>();//填充到这个临时列表中  
112.                 //依次添加到列表中  
113.                 foreach (Match m in mc)  
114.                 \{  
115.                     buf.Add(byte.Parse(m.Value));  
116.                 \}  
117.                 //转换列表为数组后发送  
118.                 comm.Write(buf.ToArray(), 0, buf.Count);  
119.                 //记录发送的字节数  
120.                 n = buf.Count;  
121.             \}  
122.             else//ascii编码直接发送  
123.             \{  
124.                 //包含换行符  
125.                 if (checkBoxNewlineSend.Checked)  
126.                 \{  
127.                     comm.WriteLine(txSend.Text);  
128.                     n = txSend.Text.Length + 2;  
129.                 \}  
130.                 else//不包含换行符  
131.                 \{  
132.                     comm.Write(txSend.Text);  
133.                     n = txSend.Text.Length;  
134.                 \}  
135.             \}  
136.             send\_count += n;//累加发送字节数  
137.             labelSendCount.Text = "Send:" + send\_count.ToString();//更新界面  
138.         \}  
139.         private void buttonReset\_Click(object sender, EventArgs e)  
140.         \{  
141.             //复位接受和发送的字节数计数器并更新界面。  
142.             send\_count = received\_count = 0;  
143.             labelGetCount.Text = "Get:0";  
144.             labelSendCount.Text = "Send:0";  
145.         \}  
146.     \}  
147. \}

至此，一个标准的串口调试助手就完成了。留下一个思考题，如果接收数据后，更新界面的时候，尚未操作完成，此时并发了关闭串口的操作。程序会如何呢？敬请阅读《C\# 串口操作系列(2) -- 如何避免关闭串口偶尔软件死锁》。

[VS2010项目范例下载][VS2010]

[VS2008项目范例下载][VS2008]

//append by wuyazhe @2011-5-26

上面有一点疏漏，源自第一篇，结果到这里还是没修改，源码中有一行，需要修改一下。

//发送按钮中

buf.Add(byte.Parse(m.Value));

要修改为

buf.Add(byte.Parse(m.Value,System.Globalization.NumberStyles.HexNumber));

[Link 1]: http://blog.csdn.net/wuyazhe/article/details/5598945
[38687_1273950504GzKy.jpg]: /images/20220805/40c2bc03d21d4d8d995be11953bf3447.png
[view plain]: http://blog.csdn.net/wuyazhe/article/details/5598945#
[VS2010]: http://d.download.csdn.net/down/2360835/wuyazhe
[VS2008]: http://d.download.csdn.net/down/2485323/wuyazhe