Ask me anything
Ithy Logo
Sign in to save

全面构建基于WinForm的SN查询与串口通信程序

实现高效SN查询与多指令串口通信的详细方案

windows forms csharp serial communication

主要收获

  • 高效读取Excel数据： 使用EPPlus库实现SN对应行的数据检索。
  • 灵活的串口通信： 利用SerialPort类进行多指令发送与回显接收。
  • 动态回显校验： 根据不同指令类型实现特定的回显验证逻辑。

项目概述

本项目旨在开发一个Windows Forms应用程序，用户可以通过输入序列号（SN）来检索Excel文件中对应的行数据，并通过串口发送多种指令，随后根据指令类型对串口回显进行特征化校验。该程序具备以下核心功能：

  • 输入SN并查询Excel文件中相关数据。
  • 配置串口参数并建立通信。
  • 发送多类型指令并接收串口回显。
  • 针对不同指令类型进行特定的回显验证。

开发环境与依赖

所需工具与库

  • Visual Studio 2019或更高版本
  • .NET Framework 4.7.2或更高
  • NuGet包管理器
  • EPPlus（用于Excel文件读取）
  • System.IO.Ports（用于串口通信）

步骤详解

1. 创建WinForm项目

在Visual Studio中创建一个新的Windows Forms应用程序项目。命名为SN查询与串口通信工具。

2. 安装必要的NuGet包

通过NuGet包管理器安装以下包：

  • EPPlus：用于读取和操作Excel文件。
  • System.IO.Ports：用于串口通信。

3. 设计用户界面

在设计器中添加以下控件：

  • TextBox：用于输入SN，命名为txtSN。
  • Button：用于触发SN查询，命名为btnSearch，文本为“查询”。
  • TextBox：用于显示Excel查询结果，命名为txtExcelResult，设置为多行模式。
  • ComboBox：用于选择串口，命名为cmbSerialPort。
  • Button：用于打开串口，命名为btnOpenPort，文本为“打开串口”。
  • TextBox：用于输入指令，命名为txtCommand。
  • Button：用于发送指令，命名为btnSendCommand，文本为“发送指令”。
  • TextBox：用于显示串口回显，命名为txtResponse，设置为多行模式。

4. 实现Excel数据读取

使用EPPlus库读取Excel文件，根据输入的SN查找对应的行数据。以下是一个示例方法：


using OfficeOpenXml;
using System.Data;
using System.IO;
using System.Windows.Forms;

public DataRow GetExcelDataBySN(string filePath, string sheetName, string sn)
{
    FileInfo existingFile = new FileInfo(filePath);
    using (ExcelPackage package = new ExcelPackage(existingFile))
    {
        ExcelWorksheet worksheet = package.Workbook.Worksheets[sheetName];
        if (worksheet == null)
        {
            MessageBox.Show("未找到指定的工作表。");
            return null;
        }

        int rowCount = worksheet.Dimension.Rows;
        int colCount = worksheet.Dimension.Columns;

        for (int row = 2; row <= rowCount; row++) // 假设第一行为表头
        {
            if (worksheet.Cells[row, 1].Text.Trim() == sn)
            {
                DataTable dt = new DataTable();
                for (int col = 1; col <= colCount; col++)
                {
                    if (row == 2)
                    {
                        dt.Columns.Add(worksheet.Cells[row, col].Text.Trim());
                    }
                    else
                    {
                        dt.Columns[col - 1].DataType = typeof(string);
                    }
                }

                DataRow dataRow = dt.NewRow();
                for (int col = 1; col <= colCount; col++)
                {
                    dataRow[col - 1] = worksheet.Cells[row, col].Text.Trim();
                }
                return dataRow;
            }
        }
        MessageBox.Show("未找到对应的SN记录。");
        return null;
    }
}

5. 配置串口通信

使用SerialPort类进行串口配置与通信。以下是初始化串口的方法：


using System.IO.Ports;

public SerialPort serialPort;

public void InitializeSerialPort(string portName, int baudRate)
{
    serialPort = new SerialPort(portName, baudRate, Parity.None, 8, StopBits.One)
    {
        ReadTimeout = 3000,
        WriteTimeout = 3000
    };
    serialPort.DataReceived += new SerialDataReceivedEventHandler(DataReceivedHandler);
}

private void DataReceivedHandler(object sender, SerialDataReceivedEventArgs e)
{
    SerialPort sp = (SerialPort)sender;
    string indata = sp.ReadExisting();
    this.Invoke(new Action(() => {
        txtResponse.AppendText(indata);
    }));
}

6. 发送指令与回显校验

根据输入的指令类型发送指令，并依据指令类型对回显进行特征校验。以下是发送指令并验证回显的示例代码：


public void SendCommand(string command)
{
    if (serialPort != null && serialPort.IsOpen)
    {
        serialPort.WriteLine(command);
    }
    else
    {
        MessageBox.Show("串口未打开或不存在。");
    }
}

public bool ValidateResponse(string command, string response)
{
    if (command.StartsWith("CMD_A"))
    {
        return response.Contains("ACK_A");
    }
    else if (command.StartsWith("CMD_B"))
    {
        return response.Contains("ACK_B");
    }
    // 添加更多指令类型的校验逻辑
    return false;
}

private void btnSendCommand_Click(object sender, EventArgs e)
{
    string command = txtCommand.Text.Trim();
    if (!string.IsNullOrEmpty(command))
    {
        SendCommand(command);
        // 假设在DataReceivedHandler中已将回显显示在txtResponse中
        // 这里可以根据实际情况添加等待或回调机制进行校验
    }
    else
    {
        MessageBox.Show("请输入指令。");
    }
}

7. 完整示例代码

以下是整合上述功能的完整代码示例：


using System;
using System.Data;
using System.IO;
using System.IO.Ports;
using System.Windows.Forms;
using OfficeOpenXml;

namespace SNSerialPortApp
{
    public partial class MainForm : Form
    {
        private SerialPort serialPort;

        public MainForm()
        {
            InitializeComponent();
            LoadAvailablePorts();
        }

        private void LoadAvailablePorts()
        {
            cmbSerialPort.Items.AddRange(SerialPort.GetPortNames());
            if (cmbSerialPort.Items.Count > 0)
            {
                cmbSerialPort.SelectedIndex = 0;
            }
        }

        private void btnSearch_Click(object sender, EventArgs e)
        {
            string sn = txtSN.Text.Trim();
            if (string.IsNullOrEmpty(sn))
            {
                MessageBox.Show("请输入SN。");
                return;
            }

            string excelPath = @"C:\path\to\your\excel.xlsx"; // 修改为实际路径
            string sheetName = "Sheet1"; // 修改为实际工作表名称

            DataRow row = GetExcelDataBySN(excelPath, sheetName, sn);
            if (row != null)
            {
                string result = "";
                foreach (var item in row.ItemArray)
                {
                    result += item.ToString() + "\t";
                }
                txtExcelResult.Text = result;
            }
        }

        private DataRow GetExcelDataBySN(string filePath, string sheetName, string sn)
        {
            try
            {
                FileInfo existingFile = new FileInfo(filePath);
                using (ExcelPackage package = new ExcelPackage(existingFile))
                {
                    ExcelWorksheet worksheet = package.Workbook.Worksheets[sheetName];
                    if (worksheet == null)
                    {
                        MessageBox.Show("未找到指定的工作表。");
                        return null;
                    }

                    int rowCount = worksheet.Dimension.Rows;
                    int colCount = worksheet.Dimension.Columns;

                    for (int row = 2; row <= rowCount; row++)
                    {
                        if (worksheet.Cells[row, 1].Text.Trim() == sn)
                        {
                            DataTable dt = new DataTable();
                            for (int col = 1; col <= colCount; col++)
                            {
                                if (row == 2)
                                {
                                    dt.Columns.Add(worksheet.Cells[row, col].Text.Trim());
                                }
                                else
                                {
                                    dt.Columns[col - 1].DataType = typeof(string);
                                }
                            }

                            DataRow dataRow = dt.NewRow();
                            for (int col = 1; col <= colCount; col++)
                            {
                                dataRow[col - 1] = worksheet.Cells[row, col].Text.Trim();
                            }
                            return dataRow;
                        }
                    }
                    MessageBox.Show("未找到对应的SN记录。");
                    return null;
                }
            }
            catch (Exception ex)
            {
                MessageBox.Show("读取Excel文件时出错：" + ex.Message);
                return null;
            }
        }

        private void btnOpenPort_Click(object sender, EventArgs e)
        {
            if (serialPort != null && serialPort.IsOpen)
            {
                serialPort.Close();
                btnOpenPort.Text = "打开串口";
                return;
            }

            string portName = cmbSerialPort.SelectedItem.ToString();
            int baudRate = 9600; // 可根据需要调整

            try
            {
                serialPort = new SerialPort(portName, baudRate, Parity.None, 8, StopBits.One);
                serialPort.DataReceived += new SerialDataReceivedEventHandler(DataReceivedHandler);
                serialPort.Open();
                btnOpenPort.Text = "关闭串口";
                MessageBox.Show("串口已打开。");
            }
            catch (Exception ex)
            {
                MessageBox.Show("无法打开串口：" + ex.Message);
            }
        }

        private void DataReceivedHandler(object sender, SerialDataReceivedEventArgs e)
        {
            SerialPort sp = (SerialPort)sender;
            string indata = sp.ReadExisting();
            this.Invoke(new Action(() => {
                txtResponse.AppendText(indata + Environment.NewLine);
            }));
        }

        private void btnSendCommand_Click(object sender, EventArgs e)
        {
            string command = txtCommand.Text.Trim();
            if (string.IsNullOrEmpty(command))
            {
                MessageBox.Show("请输入指令。");
                return;
            }

            if (serialPort != null && serialPort.IsOpen)
            {
                serialPort.WriteLine(command);
                // 这里可以添加等待机制或回调进行回显校验
                // 示例中直接显示回显内容
                // 实际应用中建议使用更可靠的回显处理方式
            }
            else
            {
                MessageBox.Show("串口未打开。");
            }
        }

        private bool ValidateResponse(string command, string response)
        {
            if (command.StartsWith("CMD_A"))
            {
                return response.Contains("ACK_A");
            }
            else if (command.StartsWith("CMD_B"))
            {
                return response.Contains("ACK_B");
            }
            // 添加更多指令类型的校验逻辑
            return false;
        }
    }

详细功能实现

Excel数据读取与SN查询

通过EPPlus库读取指定路径的Excel文件，遍历工作表中的每一行，匹配输入的SN，若匹配成功则提取该行的所有单元格数据并显示在界面上。此过程包括错误处理，如未找到工作表或SN记录。

串口通信配置与管理

利用SerialPort类初始化串口参数，包括端口名称、波特率、校验位等。用户可以通过下拉菜单选择可用的串口，并通过按钮控制串口的打开与关闭。串口开启后，程序将监听数据接收事件，并将接收到的数据实时显示在界面上。

指令发送与回显校验

用户可以在指令输入框中输入想要发送的指令，点击发送按钮后，指令将通过串口发送至目标设备。接收到的回显数据将显示在回显文本框中。根据指令前缀或类型，程序将执行相应的回显校验逻辑，确保指令正确执行。

示例：多指令类型的回显校验

假设有两种指令类型：

  • CMD_A：期望回显包含ACK_A
  • CMD_B：期望回显包含ACK_B

校验函数如下：


private bool ValidateResponse(string command, string response)
{
    if (command.StartsWith("CMD_A"))
    {
        return response.Contains("ACK_A");
    }
    else if (command.StartsWith("CMD_B"))
    {
        return response.Contains("ACK_B");
    }
    // 添加更多指令类型的校验逻辑
    return false;
}

用户体验优化

为了提升用户体验，建议实现以下优化：

  • 在发送指令后添加回显校验结果的提示信息。
  • 为串口选择添加刷新功能，确保最新的串口信息可用。
  • 在Excel读取和串口通信过程中添加进度条或加载指示器，避免程序无响应。

示例：发送指令后的回显校验提示


private void btnSendCommand_Click(object sender, EventArgs e)
{
    string command = txtCommand.Text.Trim();
    if (string.IsNullOrEmpty(command))
    {
        MessageBox.Show("请输入指令。");
        return;
    }

    if (serialPort != null && serialPort.IsOpen)
    {
        serialPort.WriteLine(command);
        // 假设在DataReceivedHandler中已将回显显示在txtResponse中
        // 这里可以根据实际情况添加等待机制或延时后进行校验
        System.Threading.Thread.Sleep(500); // 简单延时示例
        bool isValid = ValidateResponse(command, txtResponse.Text);
        if (isValid)
        {
            MessageBox.Show("指令回显校验成功。");
        }
        else
        {
            MessageBox.Show("指令回显校验失败。");
        }
    }
    else
    {
        MessageBox.Show("串口未打开。");
    }
}

性能优化与错误处理

优化Excel读取效率

对于大型Excel文件，逐行读取可能会导致性能瓶颈。可以考虑以下优化措施：

  • 使用索引或缓存机制加快SN的查找速度。
  • 仅加载必要的列，减少内存占用。
  • 异步读取Excel数据，避免阻塞UI线程。

增强串口通信的稳健性

在串口通信过程中，可能会遇到数据丢失、通信中断等问题。建议采取以下措施增强程序的稳健性：

  • 在发送和接收数据时添加异常处理，防止程序崩溃。
  • 实现重试机制，确保指令可靠发送与接收。
  • 配置适当的超时时间，避免程序长时间等待。

示例：完善的异常处理


private void InitializeSerialPort(string portName, int baudRate)
{
    try
    {
        serialPort = new SerialPort(portName, baudRate, Parity.None, 8, StopBits.One)
        {
            ReadTimeout = 3000,
            WriteTimeout = 3000
        };
        serialPort.DataReceived += new SerialDataReceivedEventHandler(DataReceivedHandler);
        serialPort.Open();
        btnOpenPort.Text = "关闭串口";
    }
    catch (UnauthorizedAccessException)
    {
        MessageBox.Show("访问被拒绝，无法打开串口。");
    }
    catch (IOException)
    {
        MessageBox.Show("串口不存在或被占用。");
    }
    catch (Exception ex)
    {
        MessageBox.Show("打开串口时发生错误：" + ex.Message);
    }
}

结论

通过上述步骤，您可以构建一个功能完善的WinForm程序，实现通过输入SN查询Excel数据，并通过串口发送多种指令及其回显校验。关键在于合理使用EPPlus进行高效的Excel数据操作，以及灵活运用SerialPort类实现稳定的串口通信。此外，根据不同指令类型设计特定的回显校验逻辑，确保通信的可靠性和准确性。

参考资料

cnblogs.com
C# Windows Forms 串口通信教程
docs.microsoft.com
System.IO.Ports.SerialPort 类参考

Last updated February 13, 2025

AI-assisted research. Sources, methodology and corrections · Source-checked guides and tools · Explore published answers

Ask Ithy AI