C#实现【串口助手】【入门级别】【小白进】

【前言】根据杜洋和李苍源老师的教程，开发了一个最基础的串口调试助手，希望能起到抛砖引玉的作用吧♥
课程视频链接：【杜洋工作室】C#开发串口助手

1 界面设计

2 代码具体实现

2.1 Form1_Load事件处理器

功能描述

• 初始化【端口下拉列表】和【波特率下拉列表】
  • 下拉列表的内容可以在属性框中的Item中手动添加，也可以在代码中调用成员函数Item进行添加
  • 波特率下拉列表的内容是博主手动添加的，故代码中没有体现
• 定义串口数据接收的事件处理器

代码

private void Form1_Load(object sender, EventArgs e)
        {
            for (int i = 1; i <= 20; ++i)
            {
                comboBox1.Items.Add("COM" + i.ToString());
            }
            comboBox1.Text = "COM1";
            comboBox2.Text = "4800";
            //串口没有内置的事件处理器，需要手动添加
            serialPort1.DataReceived += new SerialDataReceivedEventHandler(port_DataReceived);
        }

2.2 打开端口button事件处理器

功能描述

• 设置串口的端口号和波特率
• 打开串口
• 将【打开端口button】置为不可用（false），将【关闭端口button】置为可用（true）

代码

private void button1_Click(object sender, EventArgs e)
        {
            try
            {
                //将端口号和波特率赋值给串口
                serialPort1.PortName = comboBox1.Text;  //标准格式为 <COM数字>
                //comboBox2.Text是字符串，将它作为十进制数转换为int32类型
                serialPort1.BaudRate = Convert.ToInt32(comboBox2.Text, 10);
                //打开串口
                serialPort1.Open();
                //一旦打开端口，就将打开端口置为不可用（不能重复打开），将关闭端口置为可用
                button1.Enabled = false;  //打开端口button不可用
                button2.Enabled = true;   //关闭端口button可用
            }
            //如果try中的语句遇到错误，则直接跳去执行catch中的语句
            catch
            {
                serialPort1.Close();
                MessageBox.Show("端口错误，请检查串口", "错误");
                button1.Enabled = true;  //打开端口button不可用
                button2.Enabled = false;   //关闭端口button可用
            }
        }

2.3 关闭端口button事件处理器

功能描述

和打开端口的功能相对应

• 关闭串口
• 将【打开端口button】置为可用，将【关闭端口button】置为不可用

代码

private void button2_Click(object sender, EventArgs e)
        {
            try
            {
                serialPort1.Close();
                button1.Enabled = true;  
                button2.Enabled = false;   
            }
            catch
            {
                //一般情况下关闭串口不会出错，所以不需要加处理程序
            }
        }

2.4 发送button事件处理器

功能描述

• 如果发送模式是字符模式，则将textBox的内容直接发送即可
• 如果发送模式是数值模式
  • 将要发送的数据作为16进制数发送出去
  • 一次发送1byte，两位16进制数组成1byte，故一次发送两个十六进制数字

代码

private void button3_Click(object sender, EventArgs e)
        {
            //发送数据的缓冲区
            byte[] Data = new byte[1];
            //要确保串口是打开的
            if (serialPort1.IsOpen)
            {
                //确保发送数据的textBox有内容
                if (textBox2.Text != "")
                {
                    if (radioButton2.Checked)  //发送模式是字符模式
                    {
                        try
                        {
                            serialPort1.WriteLine(textBox2.Text);  //写数据
                        }
                        //如果写数据失败
                        catch (Exception err)
                        {
                            serialPort1.Close();
                            MessageBox.Show("串口数据写入错误", "错误");
                            button1.Enabled = true;
                            button2.Enabled = false;
                        }
                    }
                    //发送模式是数值模式：即要发送的数据是16进制数，两位十六进制数组成1byte，每次发送1byte的数据
                    //示例：要发送的数据为12B63C6，则拆分成0X12,0XB6,0X3C,0X6发送
                    else
                    {
                        //一次处理两位数据
                        for (int i = 0; i < (textBox2.Text.Length - textBox2.Text.Length % 2) / 2; ++i)
                        {
                            //取子字符串：substring(begin, offset)，begin是起始位置，offset是取几位字符
                            //Convert.ToByte(str, 16)，意思是将str作为16进制数，转换为byte类型
                            Data[0] = Convert.ToByte(textBox2.Text.Substring(i * 2, 2), 16);
                            //将Data中的数据通过串口写入串口连接的设备
                            serialPort1.Write(Data, 0, 1);  //每次发送1byte的数据
                        }
                        //如果数据个数是奇数位，则在此处理最后一位
                        if (textBox2.Text.Length % 2 != 0)  
                        {
                            Data[0] = Convert.ToByte(textBox2.Text.Substring(textBox2.Text.Length - 1, 1), 16);
                            serialPort1.Write(Data, 0, 1);
                        }
                    }
                }
            }
        }

2.5 串口数据接收事件处理器

功能概述

与其他组件不同，在设计界面双击串口的标志，在代码界面不会自动生成其事件处理器，故需要我们手动添加串口的事件处理器。

• 手动添加串口数据接收数据处理器
• 若接收模式为字符串，则以字符串的方式读入，然后将其直接在文本框显示出来即可
• 若接收模式是数值模式，则以byte的方式读入，然后将其转换成字符串，格式同“0xab”，在文本框中显示出来

代码

//串口数据接收事件处理器（需要手动添加此成员函数）
private void port_DataReceived(object sender, SerialDataReceivedEventArgs e)
{
    //接收模式为字符串模式
    if (radioButton4.Checked)  
    {
        string str = serialPort1.ReadExisting();  //字符串方式读
        textBox1.AppendText(str);  //将读进来的内容添加进文本框1，等价于textBox1.Text += str;
    }
    //接收模式为数值模式
    else
    {
        //一次接收1byte的数据
        byte data = (byte)serialPort1.ReadByte();  //ReadByte()返回值类型为int，要强转成byte
        string str = Convert.ToString(data, 16).ToUpper();
        if (str.Length == 1) str = "0" + str;  //若接收到的数据是一位的，比如是y，则以"0y"的形式显示出来
        textBox1.AppendText("0x" + str);  //若str是12，则规范化显示的格式为"0x12"
    }
}

3 总结

总体来说，本项目作为C#的入门小项目很合适。只要有C++或Java基础，上手真的非常简单。我将使用C#进行windows窗体应用开发的基本步骤进行总结：

1. 明确想要实现的功能，实现界面的设计。
2. 双击小组件，进行该小组件事件处理器的编写。清楚该组件会触发什么事件，要实现什么功能；比如文中的发送Button，点击Button，就要将文本框的数据发送出去；然后再进行细化。
3. 每完成一个小组件的事件处理器的编写，及时编译运行一下，早遇到问题早处理。

下一篇文章是【在没有下位机的情况下，如何对该串口助手进行测试】，感兴趣的朋友欢迎移步：

博主知识浅薄，文中如有不对之处，希望您在评论区指出，将感激不尽！