C#开发串口小助手(可更改波特率、串口号，可实现数据以及字符的收发)

0. 前言

• 前置项目为：VS 2019中利用C#语言在.Net Framework 4.5框架上开发简易串口发送数据软件
• 本项目的全部代码已经放置至码云：https://gitee.com/jiawei_zh/serial_assistant
• 本项目参考杜洋工作室：入门C#设计。

1. 项目实现

1.1 配置Form1.cs[设计]文件(设计器)

首先放入如下控件：Label、ComboBox、RadioButton、Panel、Button、TextBox、GroupBox

除此之外，还需要添加SerialPort控件。

1.1.1 添加Panel的作用

• Panel属于容器控件，官方对Panel作用的说明是：允许对控件集合分组。
• 在上图中，用Panel把四个RadioButton分为两组，这样就可以实现，在每个组内，有且仅有一个RadioButton会被选中。
• 假如没有利用Panel将四个RadioButton分组，那么这四个RadioButton在同一时刻内，有且仅有一个会被选中。

1.1.2 对TextBox增加滚动条

这两个地方的TextBox都有可能有大量数据的输入或者输出，当数据量超出可视范围时，就需要滚动条来扩大显示范围。

点一下其中一个要增加滚动条的TextBox，然后在属性栏中对ScrollBars进行修改，Vertical就是增加垂直滚动条，Horizontal就是增加水平滚动条，Both就是垂直滚动条和水平滚动条都加上。

1.1.3 配置comboBox_baud

单击一下下图中的comboBox。

然后在它的属性栏中对Items选项进行修改：

在集合内预先填入波特率。

1.1.4 特殊情况

如果加了一个控件，但忘记了这个控件的名字，可以点击控件，然后从控件属性栏处的名称获得。

1.2 配置Form1.cs文件

Form1.cs的代码如下所示

using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using System.Windows.Forms;
using System.IO.Ports;  //这个引用一定要加上

namespace SerialCommunicate
{
    public partial class Form1 : Form
    {
        public Form1()
        {
            InitializeComponent();
            System.Windows.Forms.Control.CheckForIllegalCrossThreadCalls = false;
        }

        private void Form1_Load(object sender, EventArgs e)
        {
            for (int i = 1; i < 20; i++)
            {
                comboBox_port.Items.Add("COM" + i.ToString()); //从1至19添加串口号
            }
            comboBox_port.Text = "COM1";//串口号多额默认值
            comboBox_baud.Text = "9600";//波特率默认值(其他波特率在属性的Items内添加)

            /*****************非常重要************************/

            serialPort1.DataReceived += new SerialDataReceivedEventHandler(port_DataReceived);//必须手动添加事件处理程序(接收串口数据)
        }

        private void port_DataReceived(object sender, SerialDataReceivedEventArgs e)//串口数据接收事件
        {
            if (!radioButton_rxd_int.Checked)//如果接收模式为字符模式
            {
                string str = serialPort1.ReadExisting();//字符串方式读
                textBox_rxd.AppendText(str);//添加内容
            }
            else
            { //如果接收模式为数值接收
                byte data;
                data = (byte)serialPort1.ReadByte();//此处需要强制类型转换，将(int)类型数据转换为(byte类型数据，不必考虑是否会丢失数据
                string str = Convert.ToString(data, 16).ToUpper();//转换为大写十六进制字符串
                textBox_rxd.AppendText("0x" + (str.Length == 1 ? "0" + str : str) + " ");//空位补“0”   
                //上一句等同为：if(str.Length == 1)
                //                  str = "0" + str;
                //              else 
                //                  str = str;
                //              textBox_rxd.AppendText("0x" + str);
            }
        }
        private void button_open_port_Click(object sender, EventArgs e)
        {
            try
            {
                serialPort1.PortName = comboBox_port.Text;
                serialPort1.BaudRate = Convert.ToInt32(comboBox_baud.Text, 10);//十进制数据转换(波特率是字符型的，需要转换为十进制整形)
                serialPort1.Open();
                button_open_port.Enabled = false;//打开串口按钮不可用(“打开串口”按钮在刚打开软件时应该是可用的，需要将设计器内button_open_port属性中的Enabled设置为True)
                button_close_port.Enabled = true;//关闭串口(“关闭串口”按钮在刚打开软件时应该是不可用的，需要将设计器内button_close_port属性中的Enabled设置为False)
            }
            catch
            {
                MessageBox.Show("端口错误,请检查串口", "错误");
            }
        }

        private void button_close_port_Click(object sender, EventArgs e)
        {
            try
            {
                serialPort1.Close();//关闭串口
                button_open_port.Enabled = true;//打开串口按钮可用
                button_close_port.Enabled = false;//关闭串口按钮不可用
            }
            catch (Exception err)//一般情况下关闭串口不会出错，所以不需要加处理程序
            {

            }
        }

        private void button_empty_output_Click(object sender, EventArgs e)
        {
            textBox_rxd.Text = "";
        }

        private void button_launch_Click(object sender, EventArgs e)
        {
            byte[] Data = new byte[1];//作用同上集
            if (serialPort1.IsOpen)//判断串口是否打开，如果打开执行下一步操作
            {
                if (textBox_txd.Text != "")
                {
                    if (!radioButton_txd_int.Checked)//如果发送模式是字符模式
                    {
                        try
                        {
                            serialPort1.WriteLine(textBox_txd.Text);//写数据
                        }
                        catch (Exception err)
                        {
                            MessageBox.Show("串口数据写入错误", "错误");//出错提示
                            serialPort1.Close();
                            button_open_port.Enabled = true;//打开串口按钮可用
                            button_close_port.Enabled = false;//关闭串口按钮不可用
                        }
                    }
                    else
                    {
                        for (int i = 0; i < (textBox_txd.Text.Length - textBox_txd.Text.Length % 2) / 2; i++)//取余3运算作用是防止用户输入的字符为奇数个
                        {
                            Data[0] = Convert.ToByte(textBox_txd.Text.Substring(i * 2, 2), 16);
                            serialPort1.Write(Data, 0, 1);//循环发送（如果输入字符为0A0BB,则只发送0A,0B）
                        }
                        if (textBox_txd.Text.Length % 2 != 0)//剩下一位单独处理
                        {
                            Data[0] = Convert.ToByte(textBox_txd.Text.Substring(textBox_txd.Text.Length - 1, 1), 16);//单独发送B（0B）
                            serialPort1.Write(Data, 0, 1);//发送
                        }
                    }
                }
            }
        }

//下面这个事件是"串口自动检测"按钮按下后将会触发的时间。
//因为在本文中，代码更新了但是上位机的图片没更新。
//所以如果想要增加此功能的话，请自行在设计器中增加一个名为"button_auto_detect"的按钮控件。
        private void button_auto_detect_Click(object sender, EventArgs e)
        {
            bool comExistence = false; //有可用的串口标志位
            comboBox_port.Items.Clear(); //清除当前串口号中所有串口名称
            for (int i = 0; i < 19; i++)
            {
                try
                {
                    SerialPort sp = new SerialPort("COM" + (i + 1).ToString()); //串口实例化
                    sp.ReadBufferSize = 1024000; //设置接收缓存
                    sp.Open();
                    sp.Close();
                    comboBox_port.Items.Add("COM" + (i + 1).ToString());
                    comExistence = true;
                }
                catch (Exception)
                {
                    continue;
                }
                if (comExistence)
                {
                    comboBox_port.SelectedIndex = 0; //使ListBox显示第1个添加的索引
                    break; //找到一个可用的串口即可
                }
                else
                {
                    MessageBox.Show("没有找到可用串口！", "错误提示"); //显示具有指定文本和标题的消息框
                }
            }
        }
    }
}

2. 串口小助手预览

3. 试验

3.1 配置虚拟串口对

打开VSPD，配置一个COM3和COM4的串口对，然后点击Add pair。

得到一个虚拟串口对：COM3和COM4。

也可以在设备管理器内查看虚拟串口对。

3.2 配置SSCOM

打开SSCOM。配置串口号为COM4，波特率为9600。

3.3 配置串口小助手

打开串口小助手，配置串口号为COM3，波特率为9600，并更改发送和接收模式为字符(更改发送和接收模式为字符模式仅仅是为了能够更直观地显示，数值模式也可以正常工作)。

3.4 开始试验

在SSCOM中点击打开串口。

在串口小助手中点击打开端口。

在串口小助手的输入框内输入555，SSCOM的接收框内可以接收到555。

在SSCOM的输入框内输入666，串口小助手的接收框内可以接收到666。