add README.md

This commit is contained in:
vc4
2021-08-24 22:21:05 +08:00
parent 3d66313cfd
commit 2c2ad307d7

62
README.md Normal file
View File

@@ -0,0 +1,62 @@
# scomm串口调试助手(Mac/Linux/Windows)
一款跨平台串口调试助手助力Mac/Linux平台下的嵌入式开发。
## 功能特色
1. 依托python全平台运行
2. 接收数据,自定义脚本解析输出
3. 数据显示,自定义文本编码
4. 预置数据,快速编辑、一键发送
5. 接收数据,自定义分帧间隔
6. 串口开关状态灯指示
7. HEX格式、时间戳、循环发送、保存文件等
## 运行环境
* python3.x
* tkinter
## 解析脚本
鼠标右键/中键选择对应脚本,可以打开脚本编辑对话框。
程序中调用*eval*函数解析脚本并打印执行结果。
```python
# data为接收到的数据帧字节数组
# 注意数据帧可能有分片、组包的情况
# 可配合分帧间隔字段处理
#
# data内容按16进制转换加空格后连接
' '.join(['%02X'%x for x in data])
```
## 数据编码
嵌入式环境下中文常用gbk编码输入中文内容执行发送时
会自动按照数据编码设定,编码后输出。
注意某些tcl/tk版本不兼容可能无法输入中文可通过快捷键编辑处理。
## 预置数据
鼠标右键/中键选择对应预置数据按钮,可以打开编辑对话框。
HEX格式请注意检测数据是否有效程序中未对数据有效性作检查。
## 分帧间隔
电脑端系统驱动层有数据接收缓存,不能保证接收到的数据都是按数据帧分开的。
请合理设置分帧间隔字段,以确保数据显示符合预期。
## 常规选项
- HEX显示
- 数据收发内容窗口的显示格式
- HEX发送
- 按HEX格式解析要发送的数据注意程序未对数据有效性作检查。
- 发送显示
- 发送出去的数据是否显示
- 收发时间
- 是否显示时间戳
- 循环发送
- 按指定时间循环发送数据