基于python的tkinter和pyserial的简易串口调试器——实现与详解

太长不看版：本文程序github链接
串口自环实验图（发送Aloha Oe）：

契机

最近偶然碰到一个项目，需要写一个PC端的单片机上位机通信和演示程序。项目原来的工程师们是精于单片机、FPGA和模拟电路的高手，却对GUI束手无策。辣鸡博主也一样，除了早已忘光的MFC和并不实用的javafx，也没做更多GUI方面的工作了。然而当时我考试紧张，正和Markov Chain做殊死搏斗，也就没有参加。
其实大三的时候，电气学院就有同学问我能不能帮他们写一个接收串口数据的GUI，当时我正在和信息论殊死搏斗，以及当时我也只会用MFC艰难地开发，于是只得抱歉放弃。最近在等仿真结果的时候，又把这个问题捡起来，终于用python搞定（换句话说，python是如此美好，只要我们等仿真结果这些许时间，就可以完成C++可能要一整天才能解决的问题）。
已经有不少博主分享他们用python编写的串口调试GUI程序了，但大多只是拍代码上来，对于其实主业不是python编程的同学可能帮助不大。这篇博客争取详细地介绍整个程序的设计过程，方便只熟悉嵌入式编程，不熟悉PC编程的同学学习。

我在写这个程序的时候，也参考其他博主的程序，特此鸣谢！

程序流程和必须的库

我们使用tkinter设计GUI，tkinter虽然并不好看，但足够简单，满足电子工程师的需求。串口通信用pyserial，关于这个库，网络上有大量的介绍，官方主页也写得很详细。
实现串口数据及时（自动）接收，关键需要有像单片机中的中断那样的响应机制。在python中自然不可能直接接收到硬件中断，但我们可以通过为串口接收加一个轮询串口的线程来实现，这是显然的，但不熟悉操作系统原理或者不熟悉计算机编程，其实很难想到这点（非常惭愧，这是我第一次写多线程的程序）。

pyserial的简单操作

要用pyserial建立串口通信，首先要先建一个Serial类对象，然后定义端口波特率等参数，然后就可以启动，简单的一个测试代码如下，只读不写：

# UART receiver
import serial
ser = serial.Serial()
ser.port = 'COM4' # 我实验时设备接在com4
ser.baudrate = 9600
ser.bytesize = 8
ser.parity = serial.PARITY_NONE
ser.stopbits = 1
ser.open() # 开启串口
while True:
    ch = ser.read() # 只收一个bytes
    print(ch.decode(encoding='ascii'),end='')

在测试代码的时候，当然要有数据给它。我是用我上次调试STM8 I2C的小模块，大家可以拿手上方便的单片机来实验。
还要说明，pyserial接收上来的数据是bytes类，不是标准的str类，所以接收后要用bytes的decode方法解码，用ser.write()写入前也要用str的encode方法编码。

为收串口数据新建线程

考虑上一段代码，为了及时接收，直接写了一个死循环。这没有问题，但在tkinter中，程序需要去执行tkinter窗口的mainloop()，于是必须新建线程。
python的线程可以用threading库实现，这个库一般是自带，一个简单的例子如下：

# serial object
import threading
...
# serial read threading
ReadUARTThread = threading.Thread(target=ReadUART)
ReadUARTThread.start()
...
def ReadUART(args):
    while True:
        ch = ser.read()
        print(ch.decode(encoding='ascii'),end='')

其中，ReadUART是我们定义的一个函数，专门接收串口数据。新建的线程target指向它，等于是运行了一个死循环只读程序，实现了我们轮询的目标。

tkinter的界面设计简单介绍

我在设计GUI的时候并没有看很多官方手册（主要是看不懂），最初我是读梁勇的《Python语言程序设计》学tkinter的，在这次编程时也基本仿照书本例子编写。这里从我总代码中截出一点介绍几个关键点

tkinter控件中数据的变量

labelBaudrate = tk.Label(frame_COMinf,text="Baudrate: ")
self.Baudrate = tk.IntVar(value = 9600)
ertryBaudrate = tk.Entry(frame_COMinf, textvariable = self.Baudrate)

比如这里用一个输入框类(tk.Entry)接收设定波特率，默认9600。这个变量self.Baudrate)的类型是tk.IntVar。Tkinter提供了一种变量类，和普通变量对应，但又可以与GUI控件连接，动态变化。但我们要用这些数据进行计算时，必须把他们转成普通变量，通常是用get()函数，如self.Baudrate.get()，比如在按键的响应函数中：

self.buttonSS = tk.Button(frame_COMinf, text = "Start", command = self.processButtonSS)
...
def processButtonSS(self):
    # print(self.Parity.get())
    if (self.uartState):
        self.ser.close()
        self.buttonSS["text"] = "Start"
        self.uartState = False
    else:
        # restart serial port
        self.ser.port = self.COM.get() # 获取数据
        self.ser.baudrate = self.Baudrate.get()
        ...

tkinter的grid函数布局和pack函数布局

以用于展示接收信号的文本框为例：

frameRecv = tk.Frame(window) # frameRecv的父节点是window
frameRecv.grid(row = 2, column = 1) # 整个窗口用grid布局，接收文本框在第二列
labelOutText = tk.Label(frameRecv,text="Received Data:")
labelOutText.grid(row = 1, column = 1, padx = 3, pady = 2, sticky = tk.W)
frameRecvSon = tk.Frame(frameRecv)
frameRecvSon.grid(row = 2, column =1)
scrollbarRecv = tk.Scrollbar(frameRecvSon)
scrollbarRecv.pack(side = tk.RIGHT, fill = tk.Y) # 滑动条只能用pack布局
self.OutputText = tk.Text(frameRecvSon, wrap = tk.WORD, width = 60, height = 20, yscrollcommand = scrollbarRecv.set)
self.OutputText.pack()

grid函数布局更像是划分网格空间填充，pack则是直接装，大多数时候我们用grid足矣。