devbox
我家自动化
这个屌丝很懒，什么也没留下！
关注作者
热门标签
热门文章
当前位置:   article > 正文

【博客8】缤果PyQt5串口调试助手V1.1(初级篇)_串口调试助手 py源码

作者：我家自动化 | 2024-06-28 01:40:40

赞

踩

串口调试助手 py源码

超级好用的Python QT GUI串口调试助手

目录

前言

一、软件概要：

二、软件界面：

1.App动态演示

2.其他扩展展示

三、main.py源码：

1.PyQt5_Serial_Debug_Assistant_V1.0源码

四、获取 >> 源码以及Git记录：

总结

前言

        Python串口调试助手支持常用的50bps - 10Mbps波特率，能设置校验、数据位和停止位，能以ASCII码或十六进制接收或发送任何数据或字符，可以任意设定自动发送周期，并能将接收数据实时保存成文本文件，能发送任意大小的数据或字符。

备注: V1.0为简单Demo,适合初级用户使用,V1.1可用于工程应用

高级版: 【博客9】缤果PyQt5串口调试助手V2.0(高级篇)_pyqt 串口助手_Bingo缤果的博客-CSDN博客

英文名：PyQt5_Serial_Debug_Assistant_V1.1
支持：常用的50bps ~ 10Mbps波特率
类型：串口调试助手
软件大小：18M
软件版本：V1.1
软件下载&更新：百度网盘链接_提取码 6666

一、软件概要：

        一款强大而稳定的PyQt串口调试助手，支持常用的110-921600bps波特率及自定义波特率，波特率最高可支持8000000（串口硬件有关），可适应于非标准波特率。支持动态修改串口和波特率,保存当前日志,打开当前日志以及实时保存日志(默认按每小时分包保存日志,100M自动清空接收窗口,防止UI阻塞)。

二、软件界面：

1.App动态演示

2.其他扩展展示

 PyQt5_Serial_Debug_Assistant_V1.1

 PyQt5_Serial_Debug_Assistant_V1.1_串口UI布局

 PyQt5_Serial_Debug_Assistant_V1.0

三、main.py源码：

1.PyQt5_Serial_Debug_Assistant_V1.0源码

代码如下（示例）：

  1. import sys
  2. import serial  # 导入模块  #安装: pip3 install pyserial
  3. import serial.tools.list_ports
  4. import webbrowser
  5. import time
  6. import datetime
  7.  
  8. # 导入Ui设计
  9. from PyQt5.QtWidgets import QApplication, QMainWindow # 串口Ui文件
  10. from PyQt5.QtWidgets import QMessageBox, QLabel, QFileDialog
  11. from PyQt5.QtCore import QTimer
  12. from PyQt5.QtGui import QIcon
  13.  
  14. import Serial_Ui_Designer  # 串口UI文件
  15.  
  16. # PyQt5程序打包
  17. # 1.使用PyInstaller来打包：
  18. # 安装：pip3 install PyInstaller
  19. # 打包：pyinstaller -F -w -i=Com.ico main.py  #单文件打包-优缺点:只生成exe文件,但文件大,打开软件时加载时间长
  20. # 打包：pyinstaller -D -w -i=Com.ico main.py  #多文件打包-优缺点:生成exe关联包,可删除无效库,文件小,运行顺畅
  21.  
  22. # 主窗口
  23. class PyQt5_Serial(QMainWindow, Serial_Ui_Designer.Ui_MainWindow):
  24.     # 初始化程序
  25.     def __init__(self):
  26.         super(PyQt5_Serial, self).__init__()
  27.         self.setupUi(self)
  28.         self.Init()
  29.         self.Qt5_Ui_Init()
  30.  
  31.     # 初始化
  32.     def Init(self):
  33.         self.ser = serial.Serial()
  34.         self.port_check()
  35.         self.baudrateBox.setCurrentIndex(5)  # 921600-20 9600-5
  36.         self.dataBitsBox.setCurrentIndex(3)   # 8
  37.  
  38.         # 设置Logo和标题
  39.         self.setWindowIcon(QIcon('Com.ico'))
  40.         self.setWindowTitle("PyQt5_串口调试助手_V1.0")
  41.         #self.setWindowTitle("PyQt5_Serial_Debug_Assistant_V1.0")
  42.  
  43.         # 发送数据和接收数据数目置零
  44.         self.data_num_sended = 0
  45.         self.label_Tx.setText(str(self.data_num_sended))
  46.         self.data_num_received = 0
  47.         self.label_Rx.setText(str(self.data_num_received))
  48.  
  49.         # 串口关闭按钮使能关闭
  50.         self.sendButton.setEnabled(0)
  51.         self.checkBox_autoSend.setEnabled(0)
  52.  
  53.         # 发送框、文本框清除
  54.         self.sendTextEdit.setText("")
  55.         self.recvTextEdit.setText("")
  56.  
  57.     # 建立控件信号与槽关系
  58.     def Qt5_Ui_Init(self):
  59.         # 串口检测按钮
  60.         self.pushButton_Refresh.clicked.connect(self.port_check)
  61.         # 串口打开按钮
  62.         self.pushButton_Open_Close.clicked.connect(self.port_open_close)
  63.         # 定时发送数据
  64.         self.timer_send = QTimer()
  65.         self.timer_send.timeout.connect(self.data_send)
  66.         self.checkBox_autoSend.stateChanged.connect(self.data_send_timer)
  67.         # 发送数据按钮
  68.         self.sendButton.clicked.connect(self.data_send)
  69.         # 保存日志
  70.         self.pushButton_saveLog.clicked.connect(self.savefiles)
  71.         # 加载文件
  72.         self.pushButton_openLog.clicked.connect(self.openfiles)
  73.         # 跳转链接
  74.         self.commandLinkButton.clicked.connect(self.link)
  75.         # 清除发送按钮
  76.         self.pushButton_ClearSend.clicked.connect(self.send_data_clear)
  77.         # 清除接收按钮
  78.         self.pushButton_ClearRecive.clicked.connect(self.receive_data_clear)
  79. 		# RTS
  80.         self.checkBox_RTS.clicked.connect(self.rts_handle)
  81. 		# DTR
  82.         self.checkBox_DTR.clicked.connect(self.dtr_handle)
  83.  
  84.     # 串口检测
  85.     def port_check(self):
  86.         # 检测所有存在的串口，将信息存储在字典中
  87.         self.Com_Dict = {}
  88.         port_list = list(serial.tools.list_ports.comports())
  89.  
  90.         self.portNameBox.clear()
  91.         for port in port_list:
  92.             self.Com_Dict["%s" % port[0]] = "%s" % port[1]
  93.             self.portNameBox.addItem(port[0])
  94.  
  95.         # 无串口判断
  96.         if len(self.Com_Dict) == 0:
  97.             self.portNameBox.addItem("无串口")
  98.  
  99.     # 打开/关闭串口
  100.     def port_open_close(self):
  101.         if self.pushButton_Open_Close.text() == "打开串口":
  102.             self.port_open()
  103.         else:
  104.             self.port_close()
  105.  
  106.     # 打开串口
  107.     def port_open(self):
  108.         port = self.portNameBox.currentText()
  109.         # print("port:", port)
  110.  
  111.         baudrate = int(self.baudrateBox.currentText())
  112.         # print("baudrate:", baudrate)
  113.  
  114.         bytesize = int(self.dataBitsBox.currentText()) # 数据位
  115.         # print("bytesize:", bytesize)
  116.  
  117.         parity = self.ParityBox.currentText()  # 校验位
  118.         # print("parity:", parity)
  119.  
  120.         stopbits = self.stopBitsBox.currentText() # 停止位
  121.         # print("stopbits:", stopbits)
  122.  
  123.         flowctrl = self.flowControlBox.currentText()  # 流控
  124.  
  125.         self.ser.port = port
  126.         self.ser.baudrate = baudrate
  127.  
  128.         # print("bytesize:", bytesize)
  129.         if bytesize == 5:
  130.             self.ser.bytesize = serial.FIVEBITS
  131.         elif bytesize == 6:
  132.             self.ser.bytesize = serial.SIXBITS
  133.         elif bytesize == 7:
  134.             self.ser.bytesize = serial.SEVENBITS
  135.         elif bytesize == 8:
  136.             self.ser.bytesize = serial.EIGHTBITS
  137.         else:
  138.             self.ser.bytesize = serial.EIGHTBITS
  139.  
  140.         # print("parity:", parity)
  141.         if parity == "None":
  142.             self.ser.parity = serial.PARITY_NONE
  143.         elif parity == "Even":
  144.             self.ser.parity = serial.PARITY_EVEN
  145.         elif parity == "Odd":
  146.             self.ser.parity = serial.PARITY_ODD
  147.         elif parity == "Space":
  148.             self.ser.parity = serial.PARITY_SPACE
  149.         elif parity == "Mark":
  150.             self.ser.parity = serial.PARITY_MARK
  151.         else:
  152.             self.ser.parity = serial.PARITY_NONE
  153.  
  154.         # print("stopbits:", stopbits)
  155.         if stopbits == "1":
  156.             self.ser.stopbits = serial.STOPBITS_ONE
  157.         elif stopbits == "1.5":
  158.             self.ser.parity = serial.STOPBITS_ONE_POINT_FIVE
  159.         elif stopbits == "2":
  160.             self.ser.parity = serial.STOPBITS_TWO
  161.         else:
  162.             self.ser.stopbits = serial.STOPBITS_ONE
  163.  
  164.         self.ser.xonxoff = False  # 软件流控
  165.         self.ser.rtscts  = False  # 硬件流控 RTS
  166.         self.ser.dsrdtr  = False  # 硬件流控 DTR
  167.         # print("flowctrl:", flowctrl)
  168.         if flowctrl == "OFF":
  169.             self.ser.xonxoff = False  # 软件流控
  170.             self.ser.rtscts  = False  # 硬件流控 RTS
  171.             self.ser.dsrdtr  = False  # 硬件流控 DTR
  172.         elif flowctrl == "Hardware":
  173.             if self.checkBox_DTR.isChecked():
  174.                 self.ser.dsrdtr = True  #硬件流控 DTR
  175.             if self.checkBox_RTS.isChecked():
  176.                 self.ser.rtscts = True  #硬件流控 RTS
  177.         elif flowctrl == "Software":
  178.             self.ser.xonxoff = True   # 软件流控
  179.             self.ser.rtscts  = False  # 硬件流控 RTS
  180.             self.ser.dsrdtr  = False  # 硬件流控 DTR
  181.  
  182.         # print(self.ser)
  183.         # Serial < id = 0x4883040, open = False > (port='COM1', baudrate=9600, bytesize=8, parity='N', stopbits=1, timeout=None, xonxoff=False, rtscts=False, dsrdtr=False)
  184.  
  185.         try:
  186.             self.ser.open()
  187.         except:
  188.             QMessageBox.critical(self, "串口异常", "串口打开失败! 错误: 拒绝访问(被占用).")
  189.             return None
  190.  
  191.         # 串口打开后，切换开关串口按钮使能状态，防止失误操作
  192.         if self.ser.isOpen():
  193.             self.pushButton_Open_Close.setText("关闭串口")
  194. 			
  195.             self.portNameBox.setEnabled(0)
  196.             self.baudrateBox.setEnabled(0)
  197.             self.dataBitsBox.setEnabled(0)
  198.             self.ParityBox.setEnabled(0)
  199.             self.stopBitsBox.setEnabled(0)
  200.             self.flowControlBox.setEnabled(0)
  201. 						
  202.             self.pushButton_Refresh.setEnabled(0)
  203.             self.sendButton.setEnabled(1)
  204.             self.checkBox_autoSend.setEnabled(1)
  205.  
  206.             # 定时器接收数据
  207.             self.timer = QTimer()
  208.             self.timer.timeout.connect(self.data_receive)
  209.             # 打开串口接收定时器，周期为1ms
  210.             self.timer.start(1)
  211.  
  212.     # 关闭串口
  213.     def port_close(self):
  214.         try:
  215.             self.timer.stop()
  216.             self.timer_send.stop()
  217.             self.ser.close()
  218.             self.pushButton_Open_Close.setText("打开串口")
  219. 			
  220.             self.portNameBox.setEnabled(1)
  221.             self.baudrateBox.setEnabled(1)
  222.             self.dataBitsBox.setEnabled(1)
  223.             self.ParityBox.setEnabled(1)
  224.             self.stopBitsBox.setEnabled(1)
  225.             self.flowControlBox.setEnabled(1)
  226.  
  227.             self.pushButton_Refresh.setEnabled(1)
  228.             self.sendButton.setEnabled(0)
  229.             self.checkBox_autoSend.setEnabled(0)
  230.         except:
  231.             QMessageBox.critical(self, '串口异常', '关闭串口失败，请重启程序！')
  232.             return None
  233.  
  234.     # 定时发送数据
  235.     def data_send_timer(self):
  236.         try:
  237.             if 1<= int(self.spinBox_timeDly.text()) <= 300000:  # 定时时间1ms~30s内
  238.                 if self.checkBox_autoSend.isChecked():
  239.                     self.timer_send.start(int(self.spinBox_timeDly.text()))
  240.                     self.spinBox_timeDly.setEnabled(False)
  241.                 else:
  242.                     self.timer_send.stop()
  243.                     self.spinBox_timeDly.setEnabled(True)
  244.             else:
  245.                 QMessageBox.critical(self, '定时发送数据异常', '定时发送数据周期仅可设置在300秒内！')
  246.         except:
  247.             QMessageBox.critical(self, '定时发送数据异常', '请设置正确的数值类型！')
  248.  
  249.     # 发送数据
  250.     def data_send(self):
  251.         if self.ser.isOpen():
  252.             input_s = self.sendTextEdit.toPlainText()
  253.  
  254.             # 判断是否为非空字符串
  255.             if input_s != "":
  256.                 # 时间显示
  257.                 if self.checkBox_displayTime.isChecked():
  258.                     if self.checkBox_displaySend.isChecked():
  259.                         self.recvTextEdit.insertPlainText(self.get_datetime())
  260.  
  261.                 # HEX发送
  262.                 if self.checkBox_hexSend.isChecked():
  263.                     #input_s = input_s.strip() #strip() 方法用于移除字符串头尾指定的字符（默认为空格或换行符）或字符序列。注意：该方法只能删除开头或是结尾的字符，不能删除中间部分的字符。
  264.                     input_s = input_s.replace(" ", "")
  265.                     send_list = []
  266.                     while input_s != '':
  267.                         try:
  268.                             num = int(input_s[0:2], 16) # 没有步长的简单切片
  269.                             #print( hex(num) )
  270.                         except ValueError:
  271.                             QMessageBox.critical(self, '数据异常', '请输入规范的十六进制数据！')
  272.                             return None
  273.  
  274.                         input_s = input_s[2:]
  275.                         send_list.append(num)
  276.  
  277.                     if self.checkBox_CR_LF.isChecked():
  278.                         send_list.append(0x0D)
  279.                         send_list.append(0x0A)
  280.  
  281.                     input_s = bytes(send_list)
  282.                 # ASCII发送
  283.                 else:
  284.                     if self.checkBox_CR_LF.isChecked():
  285.                         input_s += '\r\n'
  286.  
  287.                     input_s = (input_s).encode('utf-8')
  288.  
  289.                 # HEX接收显示
  290.                 if self.checkBox_hexReceive.isChecked():
  291.                     out_s = ''
  292.                     for i in range(0, len(input_s)):
  293.                         out_s = out_s + '{:02X}'.format(input_s[i]) + ' '
  294.  
  295.                     if self.checkBox_displaySend.isChecked():
  296.                         self.recvTextEdit.insertPlainText(out_s)
  297.                 # ASCII接收显示
  298.                 else:
  299.                     if self.checkBox_displaySend.isChecked():
  300.                         self.recvTextEdit.insertPlainText(input_s.decode('utf-8'))
  301.  
  302.                     # 接收换行
  303.                 if self.checkBox_AutoLineBreak.isChecked():
  304.                     if self.checkBox_displaySend.isChecked():
  305.                         self.recvTextEdit.insertPlainText('\r\n')
  306.  
  307.                 # 获取到Text光标
  308.                 textCursor = self.recvTextEdit.textCursor()
  309.                 # 滚动到底部
  310.                 textCursor.movePosition(textCursor.End)
  311.                 # 设置光标到Text中去
  312.                 self.recvTextEdit.setTextCursor(textCursor)
  313.  
  314.                 # 统计发送字符数量
  315.                 num = self.ser.write(input_s)
  316.                 self.data_num_sended += num
  317.                 self.label_Tx.setText(str(self.data_num_sended))
  318.         else:
  319.             pass
  320.  
  321.     # 接收数据
  322.     def data_receive(self):
  323.         try:
  324.             num = self.ser.inWaiting()
  325.             # if num > 0:
  326.             #     time.sleep(0.1) #100ms
  327.             #     num = self.ser.inWaiting()  # 延时，再读一次数据，确保数据完整性
  328.         except:
  329.             # QMessageBox.critical(self, '串口异常', '串口接收数据异常，请重新连接设备！')
  330.             # self.port_close()
  331.             return None
  332.  
  333.         if num > 0:
  334.             data = self.ser.read(num)
  335.             num = len(data)
  336.  
  337.             # HEX显示数据
  338.             if self.checkBox_hexReceive.checkState():
  339.                 # 时间显示
  340.                 if self.checkBox_displayTime.isChecked():
  341.                     self.recvTextEdit.insertPlainText(self.get_datetime())
  342.                 out_s = ''
  343.                 for i in range(0, len(data)):
  344.                     out_s = out_s + '{:02X}'.format(data[i]) + ' '
  345.  
  346.                 self.recvTextEdit.insertPlainText(out_s)
  347.                 # 接收换行
  348.                 if self.checkBox_AutoLineBreak.isChecked():
  349.                     self.recvTextEdit.insertPlainText('\r\n')
  350.             # ASCII显示数据
  351.             else:
  352.                 try:
  353.                     if self.checkBox_displayTime.isChecked():
  354.                         displayStr = self.get_datetime()
  355.                         displayStr += data.decode('utf-8',"ignore")
  356.                         displayStr = displayStr.replace("\n", "\n" + self.get_datetime())
  357.                         # 接收换行
  358.                         if self.checkBox_AutoLineBreak.isChecked():
  359.                             displayStr += "\r\n"  # 接收换行
  360.                         self.recvTextEdit.insertPlainText(displayStr)
  361.                     else:
  362.                         self.recvTextEdit.insertPlainText(data.decode('utf-8',"ignore"))
  363.                         # 接收换行
  364.                         if self.checkBox_AutoLineBreak.isChecked():
  365.                             self.recvTextEdit.insertPlainText('\r\n')
  366.                 except Exception as e:
  367.                     print("接收数据异常,波特率错误,请重新配置!\n", e)
  368.  
  369.             # 获取到text光标
  370.             textCursor = self.recvTextEdit.textCursor()
  371.             # 滚动到底部
  372.             textCursor.movePosition(textCursor.End)
  373.             # 设置光标到text中去
  374.             self.recvTextEdit.setTextCursor(textCursor)
  375.  
  376.             # 统计接收字符的数量
  377.             self.data_num_received += num
  378.             self.label_Rx.setText(str(self.data_num_received))
  379.         else:
  380.             pass
  381.  
  382.     # 保存日志
  383.     def savefiles(self):
  384.         dlg = QFileDialog()
  385.         filename = self.portNameBox.currentText() + time.strftime("_%Y-%m-%d_%H_%M_%S", time.localtime())
  386.         filenames = dlg.getSaveFileName(None, "保存日志文件", filename, "Txt files(*.txt)")
  387.  
  388.         try:
  389.             with open(file = filenames[0], mode='w', encoding='utf-8') as file:
  390.                 file.write(self.recvTextEdit.toPlainText())
  391.         except:
  392.             #QMessageBox.critical(self, '日志异常', '保存日志文件失败！')
  393.             pass
  394.         
  395.     # 加载日志
  396.     def openfiles(self):
  397.         dlg = QFileDialog()
  398.         filenames = dlg.getOpenFileName(None, "加载日志文件", None, "Txt files(*.txt)")
  399.  
  400.         try:
  401.             with open(file = filenames[0], mode='r', encoding='utf-8') as file:
  402.                 self.sendTextEdit.setPlainText(file.read())
  403.         except:
  404.             # QMessageBox.critical(self, '日志异常', '加载日志文件失败！')
  405.             pass
  406. 				
  407.     # 打开博客链接
  408.     def link(self):
  409.         webbrowser.open('https://blog.csdn.net/santu5234?type=blog')
  410.  
  411.     # 清除发送数据显示
  412.     def send_data_clear(self):
  413.         self.sendTextEdit.setText("")
  414.  
  415.         self.data_num_sended = 0
  416.         self.label_Tx.setText(str(self.data_num_sended))
  417.  
  418.     # 清除接收数据显示
  419.     def receive_data_clear(self):
  420.         self.recvTextEdit.setText("")
  421.  
  422.         self.data_num_received = 0
  423.         self.label_Rx.setText(str(self.data_num_received))
  424.  
  425.         self.data_num_sended = 0
  426.         self.label_Tx.setText(str(self.data_num_sended))
  427.  
  428.     # 时间格式
  429.     def get_datetime(self):
  430.         time_now = datetime.datetime.now()
  431.         # print(str(time_now)[:-3])
  432.         time_now = "[" + str(time_now)[:-3] + "] "  # 转为字符串后切片
  433.         return time_now
  434.  
  435.     # RTS
  436.     def rts_handle(self):
  437.         if self.ser.isOpen():
  438.             if self.checkBox_RTS.isChecked():
  439.                 self.ser.setRTS(1)
  440.             else:
  441.                 self.ser.setRTS(0)
  442.     # DTR
  443.     def dtr_handle(self):
  444.         if self.ser.isOpen():
  445.             if self.checkBox_DTR.isChecked():
  446.                 self.ser.setDTR(1)
  447.             else:
  448.                 self.ser.setDTR(0)
  449.  
  450. # 主函数
  451. def main():
  452.     print("Hello, I'm PyQt5_Serial_Debug_Assistant_V1.0")
  453.     # 1、创建QApplication类的实例对象
  454.     app = QApplication(sys.argv)
  455.     # 2、创建一个 PyQt5_Serial 实例对象
  456.     myMainWindow = PyQt5_Serial()
  457.     # 3、显示主窗口
  458.     myMainWindow.show()
  459.     # 4、进入程序的主循环、并通过exit函数确保主循环安全结束
  460.     sys.exit(app.exec_())
  461.  
  462. if __name__ == '__main__':
  463.     main()

四、获取 >> 源码以及Git记录：

PyQt5_Serial_Debug_Assistant_V1.0&V1.1

总结

欢迎下载&更新使用。

声明：本文内容由网友自发贡献，不代表【wpsshop博客】立场，版权归原作者所有，本站不承担相应法律责任。如您发现有侵权的内容，请联系我们。转载请注明出处：https://www.wpsshop.cn/w/我家自动化/article/detail/764516
推荐阅读
相关标签

Copyright © 2003-2013 www.wpsshop.cn 版权所有，并保留所有权利。

  

闽ICP备14008679号