COMTool
A cross platform serial debug tools written by python
Windows
Linux(Elementry OS)
Raspberry Pi3
screenshot shows the version 1.0, the latest may not the same totally! But better performance、more easy to use and more elegant
Features
cross platform (Windows, Linux, MacOS, Raspberry Pi ... ...)
port baudrate bytesize parity stopbits settings
basic send data (ascii and hex)
basic receive data (ascii and hex)
send and receive data count
clear received data area
auto linefeed on every once receive
scheduled auto send
send history and select send again
serial auto detect
CR LF / LF select support
auto save settings
Ctrl+Enter to send
escape character support, like \x \r \n etc.
multiple character encode support(ASII,GBK(Chinese),UTF-8,UTF-16......)
multiple auto send (order and disorder)
unix style terminal color support
night theme and White theme
real time data graphic display
rts & dtr control by hand
Install
Windows
Test pass on Win10
there's three ways:
download excutable bin file, easiest way for one never used python
Download the latest bin file at the release page
unzip, and run comtool.exe
Install Python3 first then install from pypi:
Install by pip,
pip install comtool
comtool
Or you can download source code, then install from source code
download sourcecode
install
python setup.py bdist_wheel
pip install dist/COMTool-*.*.*-py3-none-any.whl
comtool
or
pip3 install pyinstaller
python pack.py
cd dist
Linux
Test on Ubuntu 16 18 and Elementry OS 4
there's many ways to install comtool on linux
(1) Download release (Recommend)
Download release at release page
(2) Download and install from [pypi] by pip
sudo apt install python3
sudo apt install python3-pip
sudo pip3 install comtool
sudo comtool
The installation proccess will automatically install PyQt5, it may takes a long times!!!
you can install pyqt5 manually by command sudo apt install python3-pyqt5 or sudo pip3 install pyqt5
(3) Or get by tool get-pip.py
sudo apt install python3
wget https://bootstrap.pypa.io/get-pip.py
sudo python3 get-pip.py
sudo pip3 install comtool
sudo comtool
be sure python bin path already in the $PATH env.
(4) Just install from github source code by pip
sudo apt install python3 python3-pip
sudo pip3 install git+https://github.com/Neutree/COMTool
sudo comtool
(5) Or you can download source code, then install from source code
python setup.py bdist_wheel
sudo pip3 install dist/COMTool-*.*.*-py3-none-any.whl
or
pip3 install pyinstaller
python3 pack.py
cd dist/comtool
./comtool
We should add current user to dialout group to avoid sudo command
sudo usermod -a -G dialout $USER
grep 'dialout' /etc/group
reboot #must reboot to take effect
macOS
(1) Download release (Recommend)
Download release at release page
(2) Install from pipy
brew install python3 python3-pip
sudo pip3 install COMTool
It will automatically install pyqt5, may takes a lot of time depend on your network
(3) Install from source
pip3 install pyinstaller
python3 pack.py
cd dist
then double click comtool.app
Rasberry Pi
Test pass on Raspberry Pi 3
just open terminal, type the command below:
sudo apt install git
git clone https://github.com/Neutree/COMTool.git
cd COMTool
python setup.py bdist_wheel
sudo pip3 install dist/COMTool-*.*.*-py3-none-any.whl
comtool
then enjoy
Development
Install python3.6 and pip3
Linux:
sudo apt install python3 python3-pip
install pyserial and PyQt5
sudo pip3 install pyserial pyqt5 bs4
On Raspberry:
sudo pip3 install --upgrade pyserial bs4
sudo apt install python3-pyqt5
clone project
git clone https://github.com/Neutree/COMTool.git
code, resolve bugs or add new reatures
Recommended PyCharm IDE to get start
pull request
Issue and improvement
Create issue here
