C#上位機開發(三)—— 構建SerialAssistant雛形


  上一篇簡單介紹了C#的一些基本知識,並成功的Hello,World,那么從這篇開始,我們來自己動手寫一個串口助手:

1、構思功能

  串口助手在單片機開發中經常被用來調試,最基本的功能就是接收功能和發送功能,其次,串口在打開前需要進行一些設置:串口列表選擇、波特率、數據位、校驗位、停止位,這樣就有了一個基本的雛形;然后我們在下一篇中在此功能上添加:ASCII/HEX顯示,發送,發送新行功能,重復自動發送功能,顯示接收數據時間這幾項擴展功能;

2、設計布局

  根據以上功能,將整個界面分為兩塊:設置界面(不可縮放)+ 接收區和發送區(可縮放),下面就來依次拖放控件實現:

  1)容器控件(Panel)

    Panel是容器控件,是一些小控件的容器池,用來給控件進行大致分組,要注意容器是一個虛擬的,只會在設計的時候出現,不會顯示在設計完成的界面上,這里我們將整個界面分為6個容器池,如圖:

  2)文本標簽控件(Lable)

    用於顯示一些文本,但是不可被編輯;改變其顯示內容有兩種方法:一是直接在屬性面板修改“Text”的值,二是通過代碼修改其屬性,見如下代碼;另外,可以修改Font屬性修改其顯示字體及大小,這里我們選擇微軟雅黑,12號字體;

label1.Text = "串口";    //設置label的Text屬性值

   3)下拉組合框控件(ComboBox)

    用來顯示下拉列表;通常有兩種模式,一種是DropDown模式,既可以選擇下拉項,也可以選擇直接編輯;另一種是DropDownList模式,只能從下拉列表中選擇,兩種模式通過設置DropDownStyle屬性選擇,這里我們選擇第二種模式;

    那么,如何加入下拉選項呢?對於比較少的下拉項,可以通過在屬性面板中Items屬性中加入,比如停止位設置,如圖,如果想要出現默認值,改變Text屬性就可以,但要注意必須和下拉項一致:

  另外一種是直接在頁面加載函數代碼中加入,比如波特率的選擇,代碼如下:

 private void Form1_Load(object sender, EventArgs e)
        {
            int i;
            //單個添加for (i = 300; i <= 38400; i = i*2)
            {
                comboBox2.Items.Add(i.ToString());  //添加波特率列表
            }

            //批量添加波特率列表
            string[] baud = { "43000","56000","57600","115200","128000","230400","256000","460800" }; 
            comboBox2.Items.AddRange(baud);

            //設置默認值
            comboBox1.Text = "COM1";
            comboBox2.Text = "115200";
            comboBox3.Text = "8";
            comboBox4.Text = "None";
            comboBox5.Text = "1";
        }

  4)按鈕控件(Button)

    5)文本框控件(TextBox)

   TextBox控件與label控件不同的是,文本框控件的內容可以由用戶修改,這也滿足我們的發送文本框需求;在默認情況下,TextBox控價是單行顯示的,如果想要多行顯示,需要設置其Multiline屬性為true;

   TextBox的方法中最多的是APPendText方法,它的作用是將新的文本數據從末尾處追加至TextBox中,那么當TextBox一直追加文本后就會帶來本身長度不夠而無法顯示全部文本的問題,此時我們需要使能TextBox的縱向滾動條來跟蹤顯示最新文本,所以我們將TextBox的屬性ScrollBars的值設置為Vertical即可;

  至此,我們的顯示控件就全部添加完畢,但是還有一個最重要的空間沒有添加,這種控件叫做隱式控件,它是運行於后台的,用戶看不見,更不能直接控制,所以也成為組件,接下來我們添加最主要的串口組件;

  6)串口組件(SerialPort)

   這種隱式控件添加后位於設計器下面 ,串口常用的屬性有兩個,一個是端口號(PortName),一個是波特率(BaudRate),當然還有數據位,停止位,奇偶校驗位等;串口打開與關閉都有接口可以直接調用,串口同時還有一個IsOpen屬性,IsOpen為true表示串口已經打開,IsOpen為flase則表示串口已經關閉。

  添加了串口組件后,我們就可以通過它來獲取電腦當前端口,並添加到可選列表中,代碼如下:

   //獲取電腦當前可用串口並添加到選項列表中
   comboBox1.Items.AddRange(System.IO.Ports.SerialPort.GetPortNames());

  啟動后可以看到界面布局效果圖如下(確保USB轉串口CH340已連接):

3、搭建后台

   界面布局完成后,我們就要用代碼來搭建整個軟件的后台,這部分才是重中之重。

  首先,我們先來控制打開/關閉串口大致思路是:當按下打開串口按鈕后,將設置值傳送到串口控件的屬性中,然后打開串口,按鈕顯示關閉串口,再次按下時,串口關閉,顯示打開按鈕;

  在這個過程中,要注意一點,當我們點擊打開按鈕時,會發生一些我們編程時無法處理的事件,比如硬件串口沒有連接,串口打開的過程中硬件突然斷開,這些被稱之為異常,針對這些異常,C#也有try..catch處理機制,在try中放置可能產生異常的代碼,比如打開串口,在catch中捕捉異常進行處理,詳細代碼如下:

 private void button1_Click(object sender, EventArgs e)        {
        try
            {
                //將可能產生異常的代碼放置在try塊中
                //根據當前串口屬性來判斷是否打開
                if (serialPort1.IsOpen)
                {
                    //串口已經處於打開狀態
                    serialPort1.Close();    //關閉串口
                    button1.Text = "打開串口";
                    button1.BackColor = Color.ForestGreen;
                    comboBox1.Enabled = true;
                    comboBox2.Enabled = true;
                    comboBox3.Enabled = true;
                    comboBox4.Enabled = true;
                    comboBox5.Enabled = true;
            textBox_receive.Text = "";  //清空接收區
            textBox_send.Text = "";     //清空發送區
                }
                else
                {
                    //串口已經處於關閉狀態,則設置好串口屬性后打開
                    comboBox1.Enabled = false;
                    comboBox2.Enabled = false;
                    comboBox3.Enabled = false;
                    comboBox4.Enabled = false;
                    comboBox5.Enabled = false;
                    serialPort1.PortName = comboBox1.Text;
                    serialPort1.BaudRate = Convert.ToInt32(comboBox2.Text);
                    serialPort1.DataBits = Convert.ToInt16(comboBox3.Text);

                    if (comboBox4.Text.Equals("None"))
                        serialPort1.Parity = System.IO.Ports.Parity.None;
                    else if(comboBox4.Text.Equals("Odd"))
                        serialPort1.Parity = System.IO.Ports.Parity.Odd;
                    else if (comboBox4.Text.Equals("Even"))
                        serialPort1.Parity = System.IO.Ports.Parity.Even;
                    else if (comboBox4.Text.Equals("Mark"))
                        serialPort1.Parity = System.IO.Ports.Parity.Mark;
                    else if (comboBox4.Text.Equals("Space"))
                        serialPort1.Parity = System.IO.Ports.Parity.Space;

                    if (comboBox5.Text.Equals("1"))
                        serialPort1.StopBits = System.IO.Ports.StopBits.One;
                    else if (comboBox5.Text.Equals("1.5"))
                        serialPort1.StopBits = System.IO.Ports.StopBits.OnePointFive;
                    else if (comboBox5.Text.Equals("2"))
                        serialPort1.StopBits = System.IO.Ports.StopBits.Two;

                    serialPort1.Open();     //打開串口
                    button1.Text = "關閉串口";
                    button1.BackColor = Color.Firebrick;
                }
            }
            catch (Exception ex)
            {
                //捕獲可能發生的異常並進行處理

                //捕獲到異常,創建一個新的對象,之前的不可以再用
                serialPort1 = new System.IO.Ports.SerialPort();
                //刷新COM口選項
                comboBox1.Items.Clear();
                comboBox1.Items.AddRange(System.IO.Ports.SerialPort.GetPortNames());
                //響鈴並顯示異常給用戶
                System.Media.SystemSounds.Beep.Play();
                button1.Text = "打開串口";
                button1.BackColor = Color.ForestGreen;
                MessageBox.Show(ex.Message);
                comboBox1.Enabled = true;
                comboBox2.Enabled = true;
                comboBox3.Enabled = true;
                comboBox4.Enabled = true;
                comboBox5.Enabled = true;
            }
        }

 

 

   接下來我們構建發送和接收的后台代碼,串口發送和接收都是在串口成功打開的情況下進行的,所以首先要判斷串口屬性IsOpen是否為1

  串口發送有兩種方法,一種是字符串發送WriteLine,一種是Write(),可以發送一個字符串或者16進制發送(見下篇),其中字符串發送WriteLine默認已經在末尾添加換行符;

 private void button2_Click(object sender, EventArgs e)
        {
            try
            {
                //首先判斷串口是否開啟
                if (serialPort1.IsOpen)
                {
                    //串口處於開啟狀態,將發送區文本發送
                    serialPort1.Write(textBox_send.Text);
                }
            }
            catch (Exception ex)
            {
                //捕獲到異常,創建一個新的對象,之前的不可以再用
                serialPort1 = new System.IO.Ports.SerialPort();
                //刷新COM口選項
                comboBox1.Items.Clear();
                comboBox1.Items.AddRange(System.IO.Ports.SerialPort.GetPortNames());
                //響鈴並顯示異常給用戶
                System.Media.SystemSounds.Beep.Play();
                button1.Text = "打開串口";
                button1.BackColor = Color.ForestGreen;
                MessageBox.Show(ex.Message);
                comboBox1.Enabled = true;
                comboBox2.Enabled = true;
                comboBox3.Enabled = true;
                comboBox4.Enabled = true;
                comboBox5.Enabled = true;
            }
        }

  接下來開始最后一個任務 —— 串口接收,在使用串口接收之前要先為串口注冊一個Receive事件,相當於單片機中的串口接收中斷,然后在中斷內部對緩沖區的數據進行讀取,如圖,輸入完成后回車,就會跳轉到響應代碼部分:

 //串口接收事件處理
 private void SerialPort1_DataReceived(object sender, System.IO.Ports.SerialDataReceivedEventArgs e) { }

 

  同樣的,串口接收也有兩種方法,一種是16進制方式讀(下篇介紹),一種是字符串方式讀,在剛剛生成的代碼中編寫,如下:

 //串口接收事件處理
        private void SerialPort1_DataReceived(object sender, System.IO.Ports.SerialDataReceivedEventArgs e)
        {
            try
            {
                //因為要訪問UI資源,所以需要使用invoke方式同步ui
                this.Invoke((EventHandler)(delegate
                {
                    textBox_receive.AppendText(serialPort1.ReadExisting());
                }
                   )
                );
               
            }
            catch (Exception ex)
            {
                //響鈴並顯示異常給用戶
                System.Media.SystemSounds.Beep.Play();
                MessageBox.Show(ex.Message);
          
            }
        }

  這里又有了一個新的知識點,這個串口接收處理函數屬於一個單獨的線程,不屬於main的主線程,而接收區的TextBox是在主線程中創建的,所以當我們直接用serialPort1.ReadExisting()讀取回來字符串,然后用追加到textBox_receive.AppendText()追加到接收顯示文本框中的時候,串口助手在運行時沒有反應,甚至報異常,如圖:

 

  所以,這個時候我們就需要用到invoke方式這種方式專門被用於解決從不是創建控件的線程訪問它,加入了invoke方式后,串口助手就可以正常接收到數據了,如圖:

 

 

 

    

 

  


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM