串口工具

最近忙着调试设备, 之前的软件没什么时间更新, 最近的主要精力还是放在工作上
这个软件就是我为了方便通过串口调试设备写的, 虽然市面上很多很多串口工具, 但串口上报数据的可读性不强, 因为我们调试的设备大多都是16进制报文, 对于年迈的我来说实在是记不住, 于是就做了这么个软件
打开软件, 是一个普普通通的串口工具, 基础能力只有发报文, 收报文, 没什么特别的
但是软件的强大之处在于, 可以通过加载python脚本的方式, 适配任何设备的任何协议
比如我今天调试 moudbus 协议的电表, 调试时需要将mac处理后组装进报文中, 我之前用的串口调试助手是无能无力的, 只能在其他程序中组装好报文黏贴过来再发送, 费时费力
但我们可以通过python脚本, 预先将组装报文的功能定义成按钮, 我们甚至可以创建动态表单来添加组装报文的参数,这样一来灵活性大大提高
而且我们调试另一种设备时, 无需再度修改脚本, 而是直接再写一个新的脚本, 定义为B插件, 程序可以通过插件切换的方式为每种设备做定制化协议
另外我可以将报文解析方式写在脚本中, 将报文解析成我们能看懂的中文, 而不是16进制报文
插件还可触发自动任务, 比如设备上电后, 对设备时间进行修正, 或是设备初始化配置等
至于更多功能, 大家可下载软件进行探索
当然, 由于时间紧迫,程序有些地方还没做, 但目前我调我们公司的设备够用了, 想来应该能满足大家需求, 大家在使用中若发现什么问题, 可以留言告诉我
插件示例:

import binascii
必须导入这个包

from super_serial_sdk.plugin_base import PluginBase
class ExamplePlugin(PluginBase):
def init(self):
super().init()
"""插件名称务必唯一"""
self.name = "示例插件"
self.initialized = False

1.     self.main_window = None
3. def send_data(self, fc, data, mode):
4.     """发送数据到串口, 只是简化了方法名, 与直接调用下面的方法一样"""
5.     self.main_window.send_to_serial(fc, data, mode)
7. """收到串口上报的二进制字节后, 在此方法中进行逻辑处理, 如解析, 解析完成后可将消息添加到聊天框中"""
8. def on_received_data(self, byte_data: bytes):
9.     """
10.     接收到串口数据后由主程序调用
11.     这里实现插件的处理逻辑
12.     """
13.     if not self.initialized:
14.         self.initialize()
16.     # 示例处理：将接收到的hex数据显示为可读格式
17.     try:
18.         # 如果设备报文编码是ascii用这套
19.         # start_index = byte_data.find(b'+') + 1
20.         # imei_bytes = byte_data[start_index:]
21.         # mes = imei_bytes.decode('ascii') # 将字节转换为10进制字符串
23.         # 如果设备报文是十六进制, 则注释上面那几行, 解除下面这三行注释
24.         hex_string = binascii.hexlify(byte_data).decode('utf-8')
25.         hex_string_separated = ' '.join([hex_string[i:i + 2] for i in range(0, len(hex_string), 2)])
26.         mes = hex_string_separated.replace(' ', '')
28.         """后续会开放获取主页面中的编码复选框, 用户可视情况选择写死还是根据复选框来判断编码,
29.         但一般情况下, 插件针对某种设备编码是一样的, 所以仍推荐插件中写死编码格式"""
31.         # 显示到对话框中
32.         if self.main_window:
33.             self.main_window.add_message_for_plugin(f"[{self.name}] 接收到的数据: {mes}", 1)
34.     except Exception as e:
35.         print(f"[示例插件] 处理数据时出错: {e}")
36. # 无需关注
37. def initialize(self):
38.     """
39.     插件初始化，如注册命令、设置参数等
40.     """
41.     print("示例插件已初始化")
42.     self.initialized = True
43.     # main_window = self.main_window
45. def get_input_text(self):
46.     """获取主窗口中输入的文本"""
47.     return self.main_window.input_text.toPlainText()
49. def clear_input_text(self):
50.     """清空主窗口输入框中的文本"""
51.     self.main_window.input_text.clear()
53. def on_reset_button_clicked(self):
54.     # 处理重置按钮点击事件
55.     self.main_window.add_message_for_plugin("正在重置设备...", 2)
56.     # 执行重置逻辑...
58. """插件卸载时调用, 插件开发者无需关注"""
59. def cleanup(self):
60.     # 插件卸载时清理按钮
61.     if hasattr(self, 'main_window'):
62.         self.main_window.clear_plugin_buttons(self.get_name())
64. #无需关注
65. def get_name(self) -> str:
66.     """
67.     返回插件名称，用于下拉菜单显示
68.     """
69.     return self.name
71. # 创建一个动态表单(示例, 若需要输入参数, 可参考此方法创建动态表单)
73. def getDict(self, data):
74.     print(12321321)
75.     self.main_window.add_message_for_plugin(f"[{self.name}] 接收到数据: {data}", 1)
77. def create_dialog(self, params, callback):
78.     """创建弹窗"""
79.     self.main_window.createDialog(params, callback)
81. """添加自定义按钮"""
82. def set_main_window(self, main_window):
83.     """
84.     设置主窗口引用，以便插件可以调用主窗口的方法
85.     """
86.     self.main_window = main_window
87.     print("已设置主窗口引用")
88.     # 添加一个自定义按钮
89.     # 添加自定义按钮
90.     buttons_config = [
91.         ("创建表单", self.createDialogTest, "b5"),
92.         ("拉闸", self.on_test_button_clicked, "b6"),
93.         ("解析输入框报文", self.jiexiInput, "b7")
94.     ]
96.     for text, callback, button_id in buttons_config:
97.         main_window.add_plugin_button(
98.             plugin_name=self.get_name(),
99.             button_text=text,
100.             callback=callback,
101.             button_id=button_id
102.     )
104. # 解析输入框报文
105. def jiexiInput(self):
106.     # 获取输入框数据
107.     text = self.get_input_text()
108.     # 清空输入框数据
109.     self.cleanup()
110.     # 这里可以写解析输入框数据的逻辑
112. """这是点击事件的示例, 用户可参考本方法自行定义, 绑定到按钮上"""
113. def on_test_button_clicked(self):
114.     zhiling = "ab ac ad 01 00 00 00 00"  # 示例报文
115.     # 向串口发送报文的方法,  这里基本都是组装报文的, 如果是写死的报文, 就不必处理, 直接发送到主窗口
116.     # 这里可以做很多事情, 如将动态表单获取的数据组装进报文, 获取输入框中的数据等等
117.     zhiling = zhiling.replace(" ", "")
118.     mac = self.get_input_text().replace(" ", "")
119.     if mac is not None and len(mac) == 6:
120.         zhiling = zhiling.replace("abacfd", mac)
121.         # 组装, 加减替换, 怎么操作都可以
123.     # 发送报文到串口, 这里我封装了处理指令的方法, 第一个参数是 指令描述, 第二个参数是报文, 第三个参数是报文编码方式 hex或 ascii
124.     self.main_window.send_to_serial("拉闸", zhiling, "hex")
126. def createDialogTest(self):
127.     params = [
128.         {
129.             "title": "command",
130.             "placeholder": "请输入命令"
131.         },
132.         {
133.             "title": "description",
134.             "placeholder": "请输入命令描述"
135.         },
136.         {
137.             "title": "interval",
138.             "placeholder": "请输入时间间隔(s)"
139.         }
140.     ]
141.     self.create_dialog(params, self.getDict)

复制代码

简单收发
通过插件实时解析报文
切换插件2
切换插件1
自动任务

1.0.11版本,记录消息发送/收到时间
https://wwqy.lanzouo.com/iZT9a36rcy4h

1.0.10版本:  支持插件操作输入框, 可玩性更高, 此版本包含一个插件模板, 大家可以仿照模板开发插件
https://wwqy.lanzouo.com/ioaAN366y1sj
密码:g5b1
插件开发讲解视频:  
8.92 复制打抖开音，看看【吴钩霜雪明的作品】串口工具插件开发  https://v.douyin.com/gt_uIngjBUU/ [email protected] YzG:/ 03/07

不是不能用, 即便不做插件, 也可以像使用其他串口工具一样，收发报文来调试, 但如果想更方便, 就需要按照自己公司的协议来制作插件.。就拿合闸拉闸来说， 纳宇电表是标准modbus-RTU协议， 这种协议的报文格式为 [设备地址] [功能码] [数据] [CRC校验高字节] [CRC校验低字节]， 字节数为  1字节  1字节   N字节  1字节   1字节， 你在插件定义合闸按钮，需要定义两个方法，一个是获取设备地址即电表上的表号的方法，这种可以通过创建动态表单的方法来获取，一个是组装报文的方法，需要根据你刚刚表单返回的表号 + 合闸的功能码 + 数据位 + CRC 来组装。实时解析也是如此，在接收报文的方法中，根据功能码来知道这条报文是干啥的，再根据功能码来定义解析方式，比如读余额的功能码为02， 那么余额上报报文的功能码也是02， 再根据设备具体协议做解析的逻辑。

先收藏了，感谢分享

感谢分享，看着还不错。

非常感谢！下载收藏试用

代码格式乱了

加入插件功能的串口软件还比较少见

串口依旧是工控的重要通讯端口