C# 串口操作系列(1) -- 入門篇，一個標準的，簡陋的串口例子。

我假設讀者已經瞭解了c#的語法，本文是針對剛打算解除串口編程的朋友閱讀的，作爲串口編程的入門範例，也是我這個系列的基礎。

我們的開發環境假定爲vs2005(雖然我在用vs2010，但避免有些網友用2005，不支持lambda，避免不兼容，就用2005來做例子)

一個基本的串口程序，既然是個程序了。我們就先從功能說起，包含

串口選擇

波特率選擇

打開

關閉

接受數據顯示

發送數據輸入

發送數據

數據量提示以及歸零

好吧，有了這些功能，我們就先畫出界面。例如：

這裏，波特率就定死幾種好了。直接界面上添加2400,4800,9600,19200,38400,57600,115200

comboPortName這裏，爲了我們的軟件能通用所有電腦避免每次查詢的效率損失，我們使用微軟提供的枚舉方式，代碼如下：

view plain copy to clipboard print ?

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

顯然，我們需要定義一個SerialPort對象。添加DataReceived事件響應收到數據，還有一個重點，我們需要記得設置NewLine屬性哦。好想有的版本不設置的時候，WriteLine和Write效果一樣。

所以，我們需要初始化SerialPort對象，例如：

view plain copy to clipboard print ?

//初始化SerialPort對象
comm.NewLine = "/r/n";
comm.RtsEnable = true;//根據實際情況吧。
//添加事件註冊
comm.DataReceived += comm_DataReceived;

初始化好串口，簡單的編寫打開，關閉方法，編寫界面響應的是否自動換行，如何復位計數器，發送方法。以及數據處理。因爲我已經寫了完整注視，我就直接貼代碼了。

view plain copy to clipboard print ?

using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Linq;
using System.Text;
using System.Windows.Forms;
using System.IO.Ports;
using System.Text.RegularExpressions;
namespace SerialportSample
{
public partial class SerialportSampleForm : Form
{
private SerialPort comm = new SerialPort();
private StringBuilder builder = new StringBuilder();//避免在事件處理方法中反覆的創建，定義到外面。
private long received_count = 0;//接收計數
private long send_count = 0;//發送計數
public SerialportSampleForm()
{
InitializeComponent();
}
//窗體初始化
private void Form1_Load(object sender, EventArgs e)
{
//初始化下拉串口名稱列表框
string[] ports = SerialPort.GetPortNames();
Array.Sort(ports);
comboPortName.Items.AddRange(ports);
comboPortName.SelectedIndex = comboPortName.Items.Count > 0 ? 0 : -1;
comboBaudrate.SelectedIndex = comboBaudrate.Items.IndexOf("9600");
//初始化SerialPort對象
comm.NewLine = "/r/n";
comm.RtsEnable = true;//根據實際情況吧。
//添加事件註冊
comm.DataReceived += comm_DataReceived;
}
void comm_DataReceived(object sender, SerialDataReceivedEventArgs e)
{
int n = comm.BytesToRead;//先記錄下來，避免某種原因，人爲的原因，操作幾次之間時間長，緩存不一致
byte[] buf = new byte[n];//聲明一個臨時數組存儲當前來的串口數據
received_count += n;//增加接收計數
comm.Read(buf, 0, n);//讀取緩衝數據
builder.Clear();//清除字符串構造器的內容
//因爲要訪問ui資源，所以需要使用invoke方式同步ui。
this.Invoke((EventHandler)(delegate
{
//判斷是否是顯示爲16禁止
if (checkBoxHexView.Checked)
{
//依次的拼接出16進制字符串
foreach (byte b in buf)
{
builder.Append(b.ToString("X2") + " ");
}
}
else
{
//直接按ASCII規則轉換成字符串
builder.Append(Encoding.ASCII.GetString(buf));
}
//追加的形式添加到文本框末端，並滾動到最後。
this.txGet.AppendText(builder.ToString());
//修改接收計數
labelGetCount.Text = "Get:" + received_count.ToString();
}));
}
private void buttonOpenClose_Click(object sender, EventArgs e)
{
//根據當前串口對象，來判斷操作
if (comm.IsOpen)
{
//打開時點擊，則關閉串口
comm.Close();
}
else
{
//關閉時點擊，則設置好端口，波特率後打開
comm.PortName = comboPortName.Text;
comm.BaudRate = int.Parse(comboBaudrate.Text);
try
{
comm.Open();
}
catch(Exception ex)
{
//捕獲到異常信息，創建一個新的comm對象，之前的不能用了。
comm = new SerialPort();
//現實異常信息給客戶。
MessageBox.Show(ex.Message);
}
}
//設置按鈕的狀態
buttonOpenClose.Text = comm.IsOpen ? "Close" : "Open";
buttonSend.Enabled = comm.IsOpen;
}
//動態的修改獲取文本框是否支持自動換行。
private void checkBoxNewlineGet_CheckedChanged(object sender, EventArgs e)
{
txGet.WordWrap = checkBoxNewlineGet.Checked;
}
private void buttonSend_Click(object sender, EventArgs e)
{
//定義一個變量，記錄發送了幾個字節
int n = 0;
//16進制發送
if (checkBoxHexSend.Checked)
{
//我們不管規則了。如果寫錯了一些，我們允許的，只用正則得到有效的十六進制數
MatchCollection mc = Regex.Matches(txSend.Text, @"(?i)[/da-f]{2}");
List<byte> buf = new List<byte>();//填充到這個臨時列表中
//依次添加到列表中
foreach (Match m in mc)
{
buf.Add(byte.Parse(m.Value));
}
//轉換列表爲數組後發送
comm.Write(buf.ToArray(), 0, buf.Count);
//記錄發送的字節數
n = buf.Count;
}
else//ascii編碼直接發送
{
//包含換行符
if (checkBoxNewlineSend.Checked)
{
comm.WriteLine(txSend.Text);
n = txSend.Text.Length + 2;
}
else//不包含換行符
{
comm.Write(txSend.Text);
n = txSend.Text.Length;
}
}
send_count += n;//累加發送字節數
labelSendCount.Text = "Send:" + send_count.ToString();//更新界面
}
private void buttonReset_Click(object sender, EventArgs e)
{
//復位接受和發送的字節數計數器並更新界面。
send_count = received_count = 0;
labelGetCount.Text = "Get:0";
labelSendCount.Text = "Send:0";
}
}
}

using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Linq;
using System.Text;
using System.Windows.Forms;
using System.IO.Ports;
using System.Text.RegularExpressions;
namespace SerialportSample
{
    public partial class SerialportSampleForm : Form
    {
        private SerialPort comm = new SerialPort();
        private StringBuilder builder = new StringBuilder();//避免在事件處理方法中反覆的創建，定義到外面。
        private long received_count = 0;//接收計數
        private long send_count = 0;//發送計數
        public SerialportSampleForm()
        {
            InitializeComponent();
        }
        //窗體初始化
        private void Form1_Load(object sender, EventArgs e)
        {
            //初始化下拉串口名稱列表框
            string[] ports = SerialPort.GetPortNames();
            Array.Sort(ports);
            comboPortName.Items.AddRange(ports);
            comboPortName.SelectedIndex = comboPortName.Items.Count > 0 ? 0 : -1;
            comboBaudrate.SelectedIndex = comboBaudrate.Items.IndexOf("9600");
            //初始化SerialPort對象
            comm.NewLine = "/r/n";
            comm.RtsEnable = true;//根據實際情況吧。
            //添加事件註冊
            comm.DataReceived += comm_DataReceived;
        }
        void comm_DataReceived(object sender, SerialDataReceivedEventArgs e)
        {
            int n = comm.BytesToRead;//先記錄下來，避免某種原因，人爲的原因，操作幾次之間時間長，緩存不一致
            byte[] buf = new byte[n];//聲明一個臨時數組存儲當前來的串口數據
            received_count += n;//增加接收計數
            comm.Read(buf, 0, n);//讀取緩衝數據
            builder.Clear();//清除字符串構造器的內容
            //因爲要訪問ui資源，所以需要使用invoke方式同步ui。
            this.Invoke((EventHandler)(delegate
            {
                //判斷是否是顯示爲16禁止
                if (checkBoxHexView.Checked)
                {
                    //依次的拼接出16進制字符串
                    foreach (byte b in buf)
                    {
                        builder.Append(b.ToString("X2") + " ");
                    }
                }
                else
                {
                    //直接按ASCII規則轉換成字符串
                    builder.Append(Encoding.ASCII.GetString(buf));
                }
                //追加的形式添加到文本框末端，並滾動到最後。
                this.txGet.AppendText(builder.ToString());
                //修改接收計數
                labelGetCount.Text = "Get:" + received_count.ToString();
            }));
        }
        private void buttonOpenClose_Click(object sender, EventArgs e)
        {
            //根據當前串口對象，來判斷操作
            if (comm.IsOpen)
            {
                //打開時點擊，則關閉串口
                comm.Close();
            }
            else
            {
                //關閉時點擊，則設置好端口，波特率後打開
                comm.PortName = comboPortName.Text;
                comm.BaudRate = int.Parse(comboBaudrate.Text);
                try
                {
                    comm.Open();
                }
                catch(Exception ex)
                {
                    //捕獲到異常信息，創建一個新的comm對象，之前的不能用了。
                    comm = new SerialPort();
                    //現實異常信息給客戶。
                    MessageBox.Show(ex.Message);
                }
            }
            //設置按鈕的狀態
            buttonOpenClose.Text = comm.IsOpen ? "Close" : "Open";
            buttonSend.Enabled = comm.IsOpen;
        }
        //動態的修改獲取文本框是否支持自動換行。
        private void checkBoxNewlineGet_CheckedChanged(object sender, EventArgs e)
        {
            txGet.WordWrap = checkBoxNewlineGet.Checked;
        }
        private void buttonSend_Click(object sender, EventArgs e)
        {
            //定義一個變量，記錄發送了幾個字節
            int n = 0;
            //16進制發送
            if (checkBoxHexSend.Checked)
            {
                //我們不管規則了。如果寫錯了一些，我們允許的，只用正則得到有效的十六進制數
                MatchCollection mc = Regex.Matches(txSend.Text, @"(?i)[/da-f]{2}");
                List<byte> buf = new List<byte>();//填充到這個臨時列表中
                //依次添加到列表中
                foreach (Match m in mc)
                {
                    buf.Add(byte.Parse(m.Value));
                }
                //轉換列表爲數組後發送
                comm.Write(buf.ToArray(), 0, buf.Count);
                //記錄發送的字節數
                n = buf.Count;
            }
            else//ascii編碼直接發送
            {
                //包含換行符
                if (checkBoxNewlineSend.Checked)
                {
                    comm.WriteLine(txSend.Text);
                    n = txSend.Text.Length + 2;
                }
                else//不包含換行符
                {
                    comm.Write(txSend.Text);
                    n = txSend.Text.Length;
                }
            }
            send_count += n;//累加發送字節數
            labelSendCount.Text = "Send:" + send_count.ToString();//更新界面
        }
        private void buttonReset_Click(object sender, EventArgs e)
        {
            //復位接受和發送的字節數計數器並更新界面。
            send_count = received_count = 0;
            labelGetCount.Text = "Get:0";
            labelSendCount.Text = "Send:0";
        }
    }
}

至此，一個標準的串口調試助手就完成了。留下一個思考題，如果接收數據後，更新界面的時候，尚未操作完成，此時併發了關閉串口的操作。程序會如何呢？敬請閱讀《C# 串口操作系列(2) -- 如何避免關閉串口偶爾軟件死鎖》。

VS2010項目範例下載

VS2008項目範例下載

//append by wuyazhe @2011-5-26

上面有一點疏漏，源自第一篇，結果到這裏還是沒修改，源碼中有一行，需要修改一下。

//發送按鈕中

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

要修改爲

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

C# 串口操作系列(1) -- 入門篇，一個標準的，簡陋的串口例子。

SerialPort類實現串口通信時遇到的多線程問題

C# 串口操作系列(1) -- 入門篇，一個標準的，簡陋的串口例子。

C#常用小技巧

抽象類和接口的區別

C#串口通信時丟失數據的一種解決方法

Mac下配置sublime實現LaTeX

https://yachay.unat.edu.pe/blog/index.php?comment_area=format_blog&comment_component=blog&comment_co

linux以太網驅動總結