Skip to main content

Cross platform serial debug assistant

Project description

COMTool
========
A cross platform serial debug tools written by python
![screenshot](./COMTool/assets/screenshot_V1.0.png)
> screenshot shows the version 1.0, the latest may not the same totally! But better performance、more easy to use and more elegant

## Features

- [x] cross platform
- [x] port baudrate bytesize parity stopbits settings
- [x] basic send data (ascii and hex)
- [x] basic receive data (ascii and hex)
- [x] send and receive data count
- [x] clear received data area
- [x] auto linefeed on every once receive
- [x] scheduled auto send
- [x] send history and select send again
- [x] serial auto detect
- [x] CR LF / LF select support
- [x] auto save settings
- [x] <kbd>Ctrl+Enter</kbd> to send
- [ ] escape character support, like \x \r \n etc.
- [ ] multiple character encode support
- [ ] multiple auto send (order and disorder)
- [ ] unix style terminal color support
- [ ] night theme and White theme

## Install

### Windows

there's three ways:
1. download excutable bin file, easiest way for one never used python
* Download the latest bin file at the [release page](https://github.com/Neutree/COMTool/releases)
* unzip, and run COMTool.exe
2. Install Python3 first then install from pypi:
* [dowload python3](https://www.python.org/downloads/)
* Install pip,save https://bootstrap.pypa.io/get-pip.py as file get-pip.py
```
sduo python get-pip.py
```
* Install by pip,
```
pip install COMTool
```
3. Or you can download source code, then install from source code
* download sourcecode
* install
```
python setup.py bdist_wheel
```
COMTool.exe in dir `C:\Users\yourName\AppData\Local\Programs\Python\Python36-32\Scripts`
* you can click `COMTool.exe` or run command `pycom or COMTool` to run app


### Linux

* download and install
```
sudo apt install python3
sudo apt install python3-pip
pip3 install COMTool
```
be sure python bin path already in the `$PATH` env(add `export PATH=$PATH:~/.local/bin` to ~/.bashrc).
then enjoy by type `COMTool`


Or you can download source code, then install from source code
* download sourcecode
```
python setup.py bdist_wheel
```


### macOS

```
brew install python3 python3-pip
pip install COMTool
```

## Development

1. Install python3.6 and pip
Linux:
```
sudo apt install python3 python3-pip
```

Windows:
[dowload python3](https://www.python.org/downloads/)

2. install pyserial and PyQt5
```
pip install pyserail pyqt5
```

3. clone project
```
git clone https://github.com/Neutree/COMTool.git
```

4. code, resolve bugs or add new reatures


5. pull request




Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

COMTool-1.1.7-py3-none-any.whl (84.5 kB view details)

Uploaded Python 3

File details

Details for the file COMTool-1.1.7-py3-none-any.whl.

File metadata

File hashes

Hashes for COMTool-1.1.7-py3-none-any.whl
Algorithm Hash digest
SHA256 9d1e1a388c1f4ac888c2d9102ea12ea0cfd73ce0ccaca261a4c010a7469c356f
MD5 544df7a015af0047b7d9ed033bd8b714
BLAKE2b-256 63015e3939f7fbf2db31caaf435a9b71406a948a7a17d7bc069c8772c6abf1f6

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page