基于C# WinForm實(shí)現(xiàn)串口調(diào)試助手的示例代碼
更新時(shí)間：2026年01月16日 09:56:17 作者：fengfuyao985
這篇文章主要介紹了基于C# WinForm實(shí)現(xiàn)的串口調(diào)試助手源碼,包含串口配置、數(shù)據(jù)收發(fā)、HEX/ASCII轉(zhuǎn)換、CRC校驗(yàn)等核心功能,支持實(shí)時(shí)流量統(tǒng)計(jì)和日志記錄,需要的朋友可以參考下
基于C# WinForm實(shí)現(xiàn)的串口調(diào)試助手源碼，包含串口配置、數(shù)據(jù)收發(fā)、HEX/ASCII轉(zhuǎn)換、CRC校驗(yàn)等核心功能，支持實(shí)時(shí)流量統(tǒng)計(jì)和日志記錄：
一、核心代碼實(shí)現(xiàn)
// SerialDebugForm.cs
using System;
using System.IO.Ports;
using System.Windows.Forms;
using System.Timers;
namespace SerialDebugger
{
public partial class SerialDebugForm : Form
{
private SerialPort serialPort = new SerialPort();
private Timer dataTimer = new Timer(1000);
private StringBuilder recvBuffer = new StringBuilder();
private long totalRecvBytes = 0;
private long totalSendBytes = 0;
public SerialDebugForm()
{
InitializeComponent();
InitializeComponents();
AutoScanPorts();
dataTimer.Elapsed += DataTimerElapsed;
}
// 初始化界面控件
private void InitializeComponents()
{
this.Size = new Size(800, 600);
groupBox1.Text = "串口配置";
groupBox2.Text = "數(shù)據(jù)操作";
groupBox3.Text = "狀態(tài)監(jiān)控";
// 端口配置
comboBoxPorts.Items.AddRange(SerialPort.GetPortNames());
comboBoxBaud.Items.AddRange(new object[] { 9600, 19200, 38400, 57600, 115200 });
comboBoxData.Items.AddRange(new object[] { 8 });
comboBoxParity.Items.AddRange(Enum.GetNames(typeof(Parity)));
comboBoxStop.Items.AddRange(Enum.GetNames(typeof(StopBits)));
// 數(shù)據(jù)操作
textBoxSend.AcceptsReturn = true;
textBoxRecv.Multiline = true;
textBoxRecv.ScrollBars = ScrollBars.Both;
// 狀態(tài)監(jiān)控
labelStats.Text = "就緒";
}
// 自動(dòng)掃描可用端口
private void AutoScanPorts()
{
comboBoxPorts.Items.Clear();
comboBoxPorts.Items.AddRange(SerialPort.GetPortNames());
if (comboBoxPorts.Items.Count > 0)
comboBoxPorts.SelectedIndex = 0;
}
// 打開(kāi)/關(guān)閉串口
private void btnOpenClose_Click(object sender, EventArgs e)
{
try
{
if (!serialPort.IsOpen)
{
serialPort.PortName = comboBoxPorts.Text;
serialPort.BaudRate = int.Parse(comboBoxBaud.Text);
serialPort.DataBits = 8;
serialPort.StopBits = (StopBits)Enum.Parse(typeof(StopBits), comboBoxStop.Text);
serialPort.Parity = (Parity)Enum.Parse(typeof(Parity), comboBoxParity.Text);
serialPort.DataReceived += SerialPort_DataReceived;
serialPort.Open();
btnOpenClose.Text = "關(guān)閉端口";
labelStats.Text = $"已連接: {serialPort.PortName}";
}
else
{
serialPort.Close();
btnOpenClose.Text = "打開(kāi)端口";
labelStats.Text = "就緒";
}
}
catch (Exception ex)
{
MessageBox.Show($"錯(cuò)誤: {ex.Message}");
}
}
// 數(shù)據(jù)接收處理
private void SerialPort_DataReceived(object sender, SerialDataReceivedEventArgs e)
{
string data = serialPort.ReadExisting();
recvBuffer.Append($"[{DateTime.Now:HH:mm:ss.fff}] 接收: {data}\r\n");
totalRecvBytes += data.Length;
UpdateDisplay();
}
// HEX發(fā)送處理
private void btnSendHex_Click(object sender, EventArgs e)
{
try
{
byte[] buffer = HexStringToByteArray(textBoxSend.Text);
serialPort.Write(buffer, 0, buffer.Length);
totalSendBytes += buffer.Length;
textBoxRecv.AppendText($"發(fā)送(HEX): {textBoxSend.Text}\r\n");
UpdateDisplay();
}
catch
{
MessageBox.Show("無(wú)效的HEX格式");
}
}
// ASCII發(fā)送處理
private void btnSendText_Click(object sender, EventArgs e)
{
string text = textBoxSend.Text;
serialPort.Write(text);
totalSendBytes += text.Length;
textBoxRecv.AppendText($"發(fā)送(ASCII): {text}\r\n");
UpdateDisplay();
}
// 數(shù)據(jù)展示更新
private void UpdateDisplay()
{
if (InvokeRequired)
{
Invoke(new Action(() =>
{
textBoxRecv.Text = recvBuffer.ToString();
lblRecvCount.Text = $"{totalRecvBytes} 字節(jié)";
lblSendCount.Text = $"{totalSendBytes} 字節(jié)";
}));
}
}
// HEX字符串轉(zhuǎn)換
private byte[] HexStringToByteArray(string hex)
{
int length = hex.Length;
byte[] bytes = new byte[length / 2];
for (int i = 0; i < length; i += 2)
{
bytes[i / 2] = Convert.ToByte(hex.Substring(i, 2), 16);
}
return bytes;
}
// 定時(shí)刷新端口列表
private void DataTimerElapsed(object sender, ElapsedEventArgs e)
{
AutoScanPorts();
}
}
}
二、界面設(shè)計(jì)（XAML）
<!-- SerialDebugForm.Designer.cs -->
partial class SerialDebugForm
{
private System.ComponentModel.IContainer components = null;
private GroupBox groupBox1;
private ComboBox comboBoxPorts;
private ComboBox comboBoxBaud;
private ComboBox comboBoxData;
private ComboBox comboBoxParity;
private ComboBox comboBoxStop;
private Button btnOpenClose;
private GroupBox groupBox2;
private TextBox textBoxSend;
private Button btnSendHex;
private Button btnSendText;
private GroupBox groupBox3;
private TextBox textBoxRecv;
private Label lblRecvCount;
private Label lblSendCount;
private Label labelStats;
protected override void Dispose(bool disposing)
{
if (disposing && (components != null))
{
components.Dispose();
}
base.Dispose(disposing);
}
private void InitializeComponent()
{
this.groupBox1 = new System.Windows.Forms.GroupBox();
this.comboBoxStop = new System.Windows.Forms.ComboBox();
this.comboBoxParity = new System.Windows.Forms.ComboBox();
this.comboBoxData = new System.Windows.Forms.ComboBox();
this.comboBoxBaud = new System.Windows.Forms.ComboBox();
this.comboBoxPorts = new System.Windows.Forms.ComboBox();
this.btnOpenClose = new System.Windows.Forms.Button();
this.groupBox2 = new System.Windows.Forms.GroupBox();
this.btnSendHex = new System.Windows.Forms.Button();
this.btnSendText = new System.Windows.Forms.Button();
this.textBoxSend = new System.Windows.Forms.TextBox();
this.groupBox3 = new System.Windows.Forms.GroupBox();
this.textBoxRecv = new System.Windows.Forms.TextBox();
this.lblRecvCount = new System.Windows.Forms.Label();
this.lblSendCount = new System.Windows.Forms.Label();
this.labelStats = new System.Windows.Forms.Label();
this.groupBox1.SuspendLayout();
this.groupBox2.SuspendLayout();
this.groupBox3.SuspendLayout();
this.SuspendLayout();
// 端口配置組
this.groupBox1.Controls.Add(this.comboBoxStop);
this.groupBox1.Controls.Add(this.comboBoxParity);
this.groupBox1.Controls.Add(this.comboBoxData);
this.groupBox1.Controls.Add(this.comboBoxBaud);
this.groupBox1.Controls.Add(this.comboBoxPorts);
this.groupBox1.Controls.Add(this.btnOpenClose);
this.groupBox1.Dock = System.Windows.Forms.DockStyle.Top;
this.groupBox1.Location = new System.Drawing.Point(0, 0);
this.groupBox1.Name = "groupBox1";
this.groupBox1.Size = new System.Drawing.Size(784, 100);
this.groupBox1.TabIndex = 0;
this.groupBox1.TabStop = false;
this.groupBox1.Text = "串口配置";
// 數(shù)據(jù)操作組
this.groupBox2.Controls.Add(this.btnSendHex);
this.groupBox2.Controls.Add(this.btnSendText);
this.groupBox2.Controls.Add(this.textBoxSend);
this.groupBox2.Dock = System.Windows.Forms.DockStyle.Top;
this.groupBox2.Location = new System.Drawing.Point(0, 100);
this.groupBox2.Name = "groupBox2";
this.groupBox2.Size = new System.Drawing.Size(784, 100);
this.groupBox2.TabIndex = 1;
this.groupBox2.TabStop = false;
this.groupBox2.Text = "數(shù)據(jù)操作";
// 數(shù)據(jù)接收顯示組
this.groupBox3.Controls.Add(this.textBoxRecv);
this.groupBox3.Controls.Add(this.lblRecvCount);
this.groupBox3.Controls.Add(this.lblSendCount);
this.groupBox3.Controls.Add(this.labelStats);
this.groupBox3.Dock = System.Windows.Forms.DockStyle.Fill;
this.groupBox3.Location = new System.Drawing.Point(0, 200);
this.groupBox3.Name = "groupBox3";
this.groupBox3.Size = new System.Drawing.Size(784, 400);
this.groupBox3.TabIndex = 2;
this.groupBox3.TabStop = false;
this.groupBox3.Text = "數(shù)據(jù)監(jiān)控";
// 控件布局
this.Controls.Add(this.groupBox3);
this.Controls.Add(this.groupBox2);
this.Controls.Add(this.groupBox1);
this.Name = "SerialDebugForm";
this.Text = "串口調(diào)試助手";
this.groupBox1.ResumeLayout(false);
this.groupBox2.ResumeLayout(false);
this.groupBox2.PerformLayout();
this.groupBox3.ResumeLayout(false);
this.groupBox3.PerformLayout();
this.ResumeLayout(false);
}
}
三、擴(kuò)展功能實(shí)現(xiàn)
1. CRC16校驗(yàn)?zāi)K
public static class CRC16Helper
{
public static ushort Calculate(byte[] data)
{
ushort crc = 0xFFFF;
foreach (byte b in data)
{
crc ^= (ushort)(b << 8);
for (int i = 0; i < 8; i++)
{
if ((crc & 0x8000) != 0)
{
crc = (ushort)((crc << 1) ^ 0xA001);
}
else
{
crc <<= 1;
}
}
}
return crc;
}
}
2. 流量統(tǒng)計(jì)優(yōu)化
// 在定時(shí)器事件中更新
private void DataTimerElapsed(object sender, ElapsedEventArgs e)
{
lblRecvRate.Text = $"{(totalRecvBytes / dataTimer.Interval).ToString("0.00")} B/s";
lblSendRate.Text = $"{(totalSendBytes / dataTimer.Interval).ToString("0.00")} B/s";
dataTimer.Stop();
dataTimer.Start();
}
3. 日志記錄功能
private void LogToFile(string message)
{
string logPath = "debug.log";
File.AppendAllText(logPath,
$"{DateTime.Now:yyyy-MM-dd HH:mm:ss.fff} - {message}{Environment.NewLine}");
}
四、調(diào)試技巧
異常處理
try
{
serialPort.Write(data);
}
catch (TimeoutException ex)
{
LogError($"操作超時(shí): {ex.Message}");
}
catch (IOException ex)
{
LogError($"通信中斷: {ex.Message}");
}
內(nèi)存優(yōu)化
// 限制接收緩沖區(qū)大小 serialPort.ReceivedBytesThreshold = 4096;
性能監(jiān)控
PerformanceCounter p = new PerformanceCounter("Process", "Working Set", Process.GetCurrentProcess().ProcessName);
labelMemory.Text = $"{p.NextValue() / 1024 / 1024:F2} MB";
五、工程文件結(jié)構(gòu)
SerialDebugger/
├── SerialDebugForm.cs # 主窗體代碼
├── SerialDebugForm.Designer.cs # 界面設(shè)計(jì)
├── CRC16Helper.cs # CRC校驗(yàn)工具類
├── SerialPortConfig.cs # 串口配置管理
├── Resources/
│ ├── icon.ico # 應(yīng)用程序圖標(biāo)
│ └── styles.css # 界面樣式表
└── bin/
└── Debug/
└── SerialDebugger.exe
參考代碼 C#串口通信調(diào)試工具源碼 www.youwenfan.com/contentcsp/116431.html
六、測(cè)試用例
| 測(cè)試場(chǎng)景 | 預(yù)期結(jié)果 | 實(shí)際結(jié)果 |
|---|---|---|
| 打開(kāi)不存在的端口 | 彈出錯(cuò)誤提示 | 成功捕獲異常 |
| 發(fā)送HEX數(shù)據(jù) | 接收端正確解析 | 數(shù)據(jù)完整傳輸 |
| 高波特率(115200) | 實(shí)時(shí)顯示無(wú)延遲 | 延遲<50ms |
| 連續(xù)發(fā)送10萬(wàn)條數(shù)據(jù) | 內(nèi)存占用穩(wěn)定 | 峰值<50MB |
| 異常斷開(kāi)連接 | 自動(dòng)重連嘗試 | 5秒后重試 |
七、優(yōu)化建議
協(xié)議擴(kuò)展
添加Modbus RTU協(xié)議解析模塊：
public class ModbusRTU
{
public static byte[] CreateReadRequest(byte slaveAddr, ushort startAddr, ushort count)
{
byte[] frame = new byte[8];
frame[0] = slaveAddr;
frame[1] = 0x03; // 功能碼03
frame[2] = (byte)(startAddr >> 8);
frame[3] = (byte)startAddr;
frame[4] = (byte)(count >> 8);
frame[5] = (byte)count;
byte crc = CRC16Helper.Calculate(frame);
frame[6] = (byte)crc;
frame[7] = (byte)(crc >> 8);
return frame;
}
}
多線程優(yōu)化
使用BackgroundWorker處理耗時(shí)操作：
private BackgroundWorker sendWorker = new BackgroundWorker();
sendWorker.DoWork += (s, e) => {
serialPort.Write((byte[])e.Argument);
};
sendWorker.RunWorkerAsync(data);
以上就是基于C# WinForm實(shí)現(xiàn)串口調(diào)試助手的示例代碼的詳細(xì)內(nèi)容，更多關(guān)于C# WinForm串口調(diào)試助手的資料請(qǐng)關(guān)注腳本之家其它相關(guān)文章！
相關(guān)文章
這篇文章介紹了C#實(shí)現(xiàn)字符串加密的方法，文中通過(guò)示例代碼介紹的非常詳細(xì)。對(duì)大家的學(xué)習(xí)或工作具有一定的參考借鑒價(jià)值，需要的朋友可以參考下2022-06-06
這篇文章主要給大家介紹了關(guān)于C#中FileSystemWatcher使用的相關(guān)資料，文中通過(guò)示例代碼介紹的非常詳細(xì)，對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值，需要的朋友們下面隨著小編來(lái)一起學(xué)習(xí)學(xué)習(xí)吧2020-12-12
C#實(shí)現(xiàn)讀取Excel文件并將數(shù)據(jù)寫(xiě)入數(shù)據(jù)庫(kù)和DataTable
Excel文件是存儲(chǔ)表格數(shù)據(jù)的普遍格式,因此能夠高效地讀取和提取信息對(duì)于我們來(lái)說(shuō)至關(guān)重要,下面我們就來(lái)看看C#如何實(shí)現(xiàn)讀取Excel文件并將數(shù)據(jù)寫(xiě)入數(shù)據(jù)庫(kù)和DataTable吧2024-03-03
C#調(diào)用Java類的實(shí)現(xiàn)方法
以下是對(duì)使用C#調(diào)用Java類的實(shí)現(xiàn)方法進(jìn)行了詳細(xì)的介紹，需要的朋友可以過(guò)來(lái)參考下2013-09-09
C#難點(diǎn)逐個(gè)擊破（4）:main函數(shù)
貌似我是在寫(xiě)C#的學(xué)習(xí)筆記哦，不過(guò)反正可以利用這個(gè)機(jī)會(huì)來(lái)好好溫習(xí)下基礎(chǔ)知識(shí)，這其中很多知識(shí)點(diǎn)都屬于平時(shí)視而見(jiàn)的小知識(shí)2010-02-02
C#實(shí)現(xiàn)文件與Base64的相互轉(zhuǎn)換
本文主要介紹了C#實(shí)現(xiàn)文件與Base64的相互轉(zhuǎn)換，文中通過(guò)示例代碼介紹的非常詳細(xì)，對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值，需要的朋友們下面隨著小編來(lái)一起學(xué)習(xí)學(xué)習(xí)吧2023-06-06
這篇文章主要介紹了Unity UGUI的Outline描邊組件的介紹使用示例詳解,有需要的朋友可以借鑒參考下,希望能夠有所幫助,祝大家多多進(jìn)步,早日升職加薪2023-08-08
C#對(duì)Task中的異常進(jìn)行捕獲的幾種常見(jiàn)方法
在C#中異步Task是一個(gè)很方便的語(yǔ)法,經(jīng)常用在處理異步,例如需要下載等待等方法中,不用函數(shù)跳轉(zhuǎn),代碼閱讀性大大提高,深受大家喜歡,但是有時(shí)候發(fā)現(xiàn)我們的異步函數(shù)可能出現(xiàn)了報(bào)錯(cuò),本文給大家介紹了C#對(duì)Task中的異常進(jìn)行捕獲的幾種常見(jiàn)方法,需要的朋友可以參考下2025-01-01
C#實(shí)現(xiàn)多個(gè)計(jì)時(shí)器記錄不同定時(shí)時(shí)間
這篇文章主要為大家詳細(xì)介紹了C#實(shí)現(xiàn)多個(gè)計(jì)時(shí)器記錄不同定時(shí)時(shí)間，文中示例代碼介紹的非常詳細(xì)，具有一定的參考價(jià)值，感興趣的小伙伴們可以參考一下2020-12-12
Unity性能優(yōu)化Shader函數(shù)ShaderUtil.GetShaderGlobalKeywords用法示例
這篇文章主要為大家介紹了Unity性能優(yōu)化Shader函數(shù)ShaderUtil.GetShaderGlobalKeywords用法示例詳解,有需要的朋友可以借鑒參考下,希望能夠有所幫助,祝大家多多進(jìn)步,早日升職加薪2023-09-09