Skip to content

Commit 55d7a5a

Browse files
committed
update readme and dependence
1 parent 5b10813 commit 55d7a5a

5 files changed

Lines changed: 85 additions & 53 deletions

File tree

-9.54 KB
Loading

README.MD

Lines changed: 41 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -34,32 +34,48 @@ A cross platform serial debug tools written by python
3434
- [x] cross platform (Windows, Linux, macOS, Raspberry Pi)(code with python, only if your platform support python)
3535
- [x] reliable stability, no UI freeze
3636
- [x] multiple language support
37-
- [x] serial auto detect, and remember last selected support
38-
- [x] serial offline auto reconnect support
39-
- [x] port baudrate(any value) bytesize parity stopbits flow control etc. settings
40-
- [x] basic send/receive data (ascii and hex)
41-
- [x] send and receive data count
42-
- [x] clear received data area
43-
- [x] auto linefeed
44-
- [x] scheduled auto send
45-
- [x] send history and select send again
46-
- [x] custom most usage data items and one click to send
47-
- [x] CR LF(\r\n) or LF(\n) support
48-
- [x] auto save settings
49-
- [x] key shortcuts like <kbd>Ctrl+Enter</kbd> to send
50-
- [x] escape character support, like `\r \n \t \x` etc.
37+
- [x] configs save and auto load(auto save settings when exit)
5138
- [x] multiple character encode support(`ASII,GBK(Chinese),UTF-8,UTF-16` etc.)
52-
- [x] receive and send record support add timestamp and save log to file
53-
- [x] send file
54-
- [x] unix terminal style color support(e.g.`\x1b[33;42mhello\x1b[0mhello2`)
55-
- [x] night theme and White theme
56-
- [x] rts & dtr control by hand
57-
- [x] protocol with customable encoding and decoding method support,
58-
- [x] Custom shortcut send(in protocol plugin)
59-
- [x] TCP UDP support
60-
- [x] Terminal mode support
61-
- [x] plugin support(Create plugin see [docs/plugins.md](./docs/plugins.md))
62-
- [x] real time data graphic display
39+
- [x] night theme and White theme(can create more theme if you want)
40+
- [x] multiple connection type support, and support add connection plugin
41+
- [x] serial port
42+
- [x] serial auto detect, and remember last selected support
43+
- [x] serial offline auto reconnect support
44+
- [x] port baudrate(any value) bytesize parity stopbits flow control etc. settings
45+
- [x] rts & dtr control by hand
46+
- [x] TCP/UDP support, include client and server mode
47+
- [x] SSH client support
48+
- [x] plugin support(Create plugin see [docs/plugins.md](./docs/plugins.md)), built-in plugin:
49+
- [x] dbg plugin, support basic send receive debug operation
50+
- [x] basic send/receive data (ascii and hex)
51+
- [x] send and receive data count
52+
- [x] clear received data area
53+
- [x] auto linefeed
54+
- [x] scheduled auto send
55+
- [x] send history and select send again
56+
- [x] custom most usage data items and one click to send
57+
- [x] CR LF(\r\n) or LF(\n) support
58+
- [x] key shortcuts like <kbd>Ctrl+Enter</kbd> to send etc. More see help
59+
- [x] receive and send record support add timestamp and save log to file
60+
- [x] send file
61+
- [x] unix terminal style color support(e.g.`\x1b[33;42mhello\x1b[0mhello2`)
62+
- [x] escape character support, like `\r \n \t \x` etc.
63+
- [x] protocol plugin, customize your own protocol
64+
- [x] customize encoding and decoding method
65+
- [x] customize shortcut key
66+
- [x] escape character support, like `\r \n \t \x` etc.
67+
- [x] terminal plugin, basic terminal interaction
68+
- [x] gragh plugin
69+
- [x] support dynamicly add gragh widgets, add gragh widgets you need
70+
- [x] display line chart in realtime, support customize protocol header(support escape characters)
71+
- [x] customable button to send data, support shortcut key
72+
73+
## Installation
74+
75+
There are two ways to install COMTool:
76+
77+
* [Download binary files and run](#Install-binary) : For Windows or macOS, and simple usage users
78+
* [Install as python package(source code)](#Install-python-package) : For Linux, or need to use plugins' user, or users who know about python
6379

6480
## Install binary
6581

README_ZH.MD

Lines changed: 40 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -30,33 +30,47 @@ COMTool
3030
- [x] 跨平台 (Windows, Linux, macOS, Raspberry Pi)(使用 python 编写,只要你的平台支持 python)
3131
- [x] 可靠,界面不会卡死
3232
- [x] 多语言支持
33-
- [x] 串口自动检测,支持记住上次使用的串口号
34-
- [x] 串口断线自动重连
35-
- [x] 波特率(随意设置)、校验、停止位、流控等设置支持
36-
- [x] 基础收发功能(字符(ASCII) 和 十六进制(HEX))
37-
- [x] 收发计数
38-
- [x] 清空接收缓冲区支持
39-
- [x] 自动换行
40-
- [x] 定时发送
41-
- [x] 发送记录保存和再次选中发送
42-
- [x] 自定义常用发送内容,一键发送
43-
- [x] 两种常用换行符CR LF(\r\n) 和 LF(\n) 支持
44-
- [x] 自动保存设置(退出保存)
45-
- [x] 快捷键比如 <kbd>Ctrl+Enter</kbd> 发送数据
46-
- [x] 转义字符支持,比如 `\r \n \t \x`
47-
- [x] 多种字符编码格式支持,比如 `ASII,GBK(Chinese),UTF-8,UTF-16`
48-
- [x] 收发记录,以及添加时间戳和记录到文件功能
49-
- [x] 发送文件
50-
- [x] `unix` 终端风格颜色支持,比如`\x1b[33;42mhello\x1b[0mhello2`
5133
- [x] 白色主题和黑色主题切换
52-
- [x] `rts``dtr` 手动控制
53-
- [x] 自定义协议编解码支持
54-
- [x] 自定义快捷键发送(在协议功能里面)
55-
- [x] TCP UDP 支持
56-
- [x] 终端模式支持
57-
- [x] 插件支持(插件开发请看[docs/plugins_zh.md](./docs/plugins_zh.md)
58-
- [x] 实时图像数据显示
59-
34+
- [x] 多种字符编码格式支持,比如 `ASII,GBK(Chinese),UTF-8,UTF-16`
35+
- [x] 自动保存设置(退出保存)
36+
- [x] 多种连接方式支持,同时支持编写连接插件
37+
- [x] 串口 支持
38+
- [x] 串口自动检测,支持记住上次使用的串口号
39+
- [x] 串口断线自动重连
40+
- [x] 波特率(随意设置)、校验、停止位、流控等设置支持
41+
- [x] `rts``dtr` 手动控制
42+
- [x] TCP/UDP 支持,包括客户端和服务端模式支持
43+
- [x] SSH 客户端支持
44+
- [x] 插件支持(插件开发请看[docs/plugins_zh.md](./docs/plugins_zh.md))),内置插件如下:
45+
- [x] 调试插件,基本收发数据调试
46+
- [x] 基础收发功能(字符(ASCII) 和 十六进制(HEX))
47+
- [x] 收发计数
48+
- [x] 清空接收缓冲区支持
49+
- [x] 自动换行
50+
- [x] 定时发送
51+
- [x] 发送记录保存和再次选中发送
52+
- [x] 自定义常用发送内容,一键发送
53+
- [x] 两种常用换行符CR LF(\r\n) 和 LF(\n) 支持
54+
- [x] 快捷键比如 <kbd>Ctrl+Enter</kbd> 发送数据
55+
- [x] 转义字符支持,比如 `\r \n \t \x`
56+
- [x] 收发记录,以及添加时间戳和记录到文件功能
57+
- [x] 发送文件
58+
- [x] `unix` 终端风格颜色支持,比如`\x1b[33;42mhello\x1b[0mhello2`
59+
- [x] 协议插件,可自定义收发协议
60+
- [x] 自定义协议编解码支持
61+
- [x] 自定义快捷键发送
62+
- [x] 终端插件, 基本终端功能
63+
- [x] 图表插件
64+
- [x] 支持动态添加图表控件,添加你需要的控件
65+
- [x] 实时显示折线图,支持自定义协议头(支持转移符)
66+
- [x] 自定义按钮来发送数据,支持自定义快捷键
67+
68+
## 安装
69+
70+
有两种安装方式:
71+
72+
* [下载二进制文件并运行](#安装可执行程序(无需安装,直接执行)): 适合 Windows 或 macOS,以及简单使用的用户
73+
* [以 python 包方式安装(源码安装)](#以-python-包形式安装): 适合 Linux 用户, 以及需要使用插件的用户,或者熟悉 python 的用户
6074

6175
## 安装可执行程序(无需安装,直接执行)
6276

requirements.txt

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,3 +7,4 @@ paramiko
77
pyte
88
pyperclip
99
coloredlogs
10+
pyqtgraph

setup.py

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@
2121
ret = os.system("sudo apt install python3 python3-pip python3-pyqt5")
2222
if ret != 0:
2323
raise Exception("install python3 pyqt5 failed")
24-
ret = os.system("sudo pip3 install --upgrade pyserial requests Babel qtawesome paramiko pyte pyperclip coloredlogs")
24+
ret = os.system("sudo pip3 install --upgrade pyserial requests Babel qtawesome paramiko pyte pyperclip coloredlogs pyqtgraph")
2525
if ret != 0:
2626
raise Exception("install packages failed")
2727
installRequires = []
@@ -34,7 +34,8 @@
3434
'paramiko',
3535
'pyte',
3636
'pyperclip',
37-
'coloredlogs'
37+
'coloredlogs',
38+
'pyqtgraph'
3839
]
3940

4041
setup(

0 commit comments

Comments
 (0)