COMTool Download – Download COMTool Quellcodes

COMTool

Andere Kategorien

v3.4.1

Herunterladen

COMTool

Englisch | 中文

Ein plattformübergreifendes serielles Debug-Tool, das von Python geschrieben wurde

Windows	Linux	Raspberry Pi	macOS

Weißes Thema	Dunkles Thema	Protokoll-Plugin	TCP/UDP	Terminal	Graph

Screenshot möglicherweise die alte Version, die neueste möglicherweise nicht ganz dieselbe! Aber bessere Leistung, einfacher zu bedienen und eleganter

Merkmale

Installation

Es gibt zwei Möglichkeiten, COMTool zu installieren:

Laden Sie Binärdateien herunter und führen Sie sie aus: Für Windows oder macOS und Benutzer mit einfacher Verwendung
Als Python-Paket (Quellcode) installieren: Für Linux, oder Sie müssen Plugins-Benutzer oder Benutzer verwenden, die sich mit Python auskennen

Binär installieren

Windows

Laden Sie die neueste Bin-Datei von der Release-Seite oder von SourceForge herunter
Entpacken Sie .zip Datei und klicken Sie zum Ausführen auf comtool.exe

Und Sie können es per Scoop installieren, verwaltet von StudentWeis
 scoop bucket add Nightly https://github.com/StudentWeis/Nightly
scoop install comtool

Linux

Linux hat zu viele Versionen, daher kompilieren wir nur Binärdateien für Ubuntu. Andere Distributionen installieren Sie bitte von Pypi oder Quellcode. Wenn Sie eine Idee haben, plattformübergreifende Binärdateien wie Flatpak oder Appimage zu packen, können Sie eine Pull-Anfrage stellen oder einen Issue hinzufügen, um mir zu sagen, wie das geht

Arch Linux und seine abgeleiteten Distributionen können von AUR aus installiert werden (verwaltet von taotieren):
 # Release version
yay -S python-comtool
# Development version
yay -S python-comtool-git

Laden Sie die Version auf der Release-Seite herunter, extrahieren Sie Dateien aus .zip Datei und klicken Sie zum Ausführen auf comtool
Fügen Sie den aktuellen Benutzer zur Dialout-Gruppe hinzu, um sudo -Befehl zu vermeiden

sudo usermod -a -G dialout $USER
grep ' dialout ' /etc/group
reboot # must reboot to take effect

Rasberry Pi

Terminal öffnen, Abhängigkeiten mit Paketmanager installieren:

sudo apt install git python3-pyqt5 python3-numpy

Verwenden Sie den Paketmanager, um pyqt5, numpy usw. zu installieren. Auf diese Weise wird die Installation einfacher. Wenn bei der Installation mit pip ein Fehler auftritt, können Sie zunächst versuchen, die Installation mit dem Paketmanager durchzuführen. Um den Paketnamen zu finden, besteht der Trick darin sudo apt-cache search package_name | grep package_name zu verwenden sudo apt-cache search package_name | grep package_name , um den Paketnamen zu suchen und es dann zu installieren.

Dann installieren Sie andere Pakete mit pip :

 git clone https://github.com/Neutree/COMTool.git --depth=1
cd COMTool
pip3 install . --verbose
# 或者
# python setup.py bdist_wheel
# sudo pip3 install dist/COMTool-*.*.*-py3-none-any.whl --verbose

Fügen Sie den aktuellen Benutzer zur Dialout-Gruppe hinzu, um sudo -Befehl zu vermeiden

sudo usermod -a -G dialout $USER
grep ' dialout ' /etc/group
reboot # must reboot to take effect

dann genieße auf Befehl

 comtool

macOS

Laden Sie die Veröffentlichung auf der Veröffentlichungsseite oder bei SourceForge herunter
Installieren Sie das dmg-Paket

Wenn Sie mehrere Comtools öffnen möchten, klicken Sie einfach mit der rechten Maustaste auf das Dock-Symbol und dann auf New Window .

oder Sie können das Terminal öffnen und eingeben

 open -n /Application/comtool.app

oder

 cd /Applicatioin/comtool.app/Contents/MacOS
./comtool

Da das Programm nicht vom Entwickler signiert ist, wird beim ersten Öffnen eine Warnung angezeigt. Sie müssen zu Settings -> Security and Privacy -> General gehen, um die Eingabeaufforderung comtool anzuzeigen, und Open anyway klicken.

Windows Defender zeigt an, dass es sich bei Comtool Binary um Malware handelt?

Wenn Ihr Programm von hier heruntergeladen wird, ist es in Ordnung, der durch das Pack-Problem verursachte Fehler, der gesamte Quellcode und das Pack-Skript sind hier, sogar der Pack-Fortschritt ist mit Github-Aktionen vollständig automatisiert, niemand packt manuell.

Wenn Sie weiterhin Bedenken haben, laden Sie einfach den Quellcode herunter, um ihn mit Python auszuführen, oder packen Sie ihn selbst.

Wenn Sie eine bessere Verpackungsmöglichkeit finden, öffnen Sie bitte die Ausgabe, um uns dies mitzuteilen.

Installieren Sie das Python-Paket

Für Entwickler oder die Binärdatei, die Ihre Plattform nicht unterstützt, verwenden Sie diese Installationsmethode

Installieren Sie zuerst Python3
- Wenn Windows oder macOS: Python3 herunterladen
- Wenn Linux: Ubuntu zum Beispiel sudo apt install python3 python3-pip , macOS brew install python3 python3-pip
Stellen Sie sicher, dass Sie pip haben

pip3 --version
# or
pip --version

Wenn dieser Befehl nicht vorhanden ist, installieren Sie ihn mit

python3 -m ensurepip

Dann von Pypi installieren:

pip3 install comtool
comtool

Für Chinesisch können Sie Tuna Mirrors verwenden, um den Download zu beschleunigen, indem Sie:

pip install -i https://pypi.tuna.tsinghua.edu.cn/simple comtool

Oder Sie können direkt von Github aus installieren

 pip3 install git+https://github.com/Neutree/COMTool

Oder Sie können den Quellcode herunterladen und dann vom Quellcode installieren
- Laden Sie den Quellcode herunter, laden Sie ihn auf einer Webseite herunter oder git clone https://github.com/Neutree/COMTool.git
- installieren

 cd COMTool
pip install .

oder erstellen Sie Ihre eigene Rad-Binärdatei

 pip3 install wheel
python setup.py bdist_wheel
pip install dist/COMTool-*.*.*-py3-none-any.whl
comtool

Wenn bei der Installation mit pip ein Fehler auftritt, können Sie versuchen, zuerst mit dem Paketmanager zu installieren und dann erneut mit pip zu installieren. z.B

 sudo apt install python3-pyqt5 python3-numpy cython3

Um den Paketnamen zu finden, besteht der Trick darin sudo apt-cache search package_name | grep package_name zu verwenden sudo apt-cache search package_name | grep package_name , um den Paketnamen zu suchen und es dann zu installieren.

Übrigens sollten Sie den aktuellen Benutzer zur Dialout-Gruppe hinzufügen, um sudo -Befehl zu vermeiden

sudo usermod -a -G dialout $USER
grep ' dialout ' /etc/group
reboot # must reboot to take effect

Fügen Sie die App manuell zum Startmenü unter Linux hinzu

Kopieren Sie „tool/comtool.desktop“ in den Ordner /usr/share/applications (möglicherweise ist hierfür root Benutzer erforderlich).
Bearbeiten Sie /usr/share/applications/comtool.desktop und ändern Sie den Symbolpfad Icon=/usr/local/COMTool/assets/logo.ico in den tatsächlichen Symbolpfad. Sie können auch Ihr Liebessymbol verwenden
Dann finden Sie die Comtool-App im Startmenü (oder im App Center).

Binär packen

pip3 install pyinstaller
python pack.py
cd dist
ls

Es ist besser virtualenv venv vor dem Packen eine virtuelle Umgebung zu source venv/bin/activate , um die Größe der binären pip install virtualenv running scripts is disabled on this system venv/Scripts/activate Das aktuelle Terminal zum Ausführen von Skripten Set-ExecutionPolicy -Scope Process -ExecutionPolicy RemoteSigned Dann pip install pyinstaller und python pack.py

Entwicklung

Installieren Sie Python (>=3.8) und pip3

Linux:

 sudo apt install python3 python3-pip

Windows: Python3 herunterladen

Installieren Sie Pakete wie pyserial und PyQt5 usw. (Liste in „requirements.txt“)

 cd COMTool
pip3 install -r requirements.txt

Auf Raspberry kann python3-pyqt5 mit dem Befehl apt installiert werden:

 sudo pip3 install --upgrade pyserial
sudo apt install python3-pyqt5

Klonprojekt

 git clone https://github.com/Neutree/COMTool.git

Code ändern, Fehler beheben oder neue Funktionen hinzufügen

Empfohlene PyCharm IDE oder vscode für den Einstieg

Vorgehensweise: Generieren Sie zuerst übersetzte Binärdateien ( .mo )

 python COMTool/i18n.py finish

Führen Sie dann das Hauptprogramm aus

 python COMTool/Main.py

Pull-Anfrage

Schreiben Sie in wenigen Minuten Ihre eigenen Plugins

siehe docs/plugins.md

Übersetzung hinzufügen

Installieren Sie zuerst die Umgebung (Python-Pip-Pakete in der Datei „requirments.txt“).

apt install python3 python3-pip
pip3 install -r requirements.txt

Wenn Sie eine neue Sprache hinzufügen oder überspringen müssen

Gebietsschema in i18n.py hinzufügen

 locales=["en", "zh_CN", "zh_TW", "ja"]

Hängen Sie Ihre Sprache an diese Liste an. Gebietsschemata finden Sie hier oder auf Wikipedia. zh_CN bedeutet beispielsweise „Festlandchina“, die entsprechende Sprache sind vereinfachte chinesische Zeichen, zh_TW bedeutet „China Taiwan“ und die Sprache sind traditionelle chinesische Zeichen. Sie können auch nur zh verwenden, um vereinfachte Zeichen zu verwenden Chinesische Schriftzeichen.

Übersetzungsdateien generieren

python i18n.py prepare

Dieser Befehl generiert .po Dateien im Ordner „locales“.

Manuell übersetzen

Übersetzen Sie dann .po Dateien. Dies ist ein Standardformat für Übersetzungsdateien mit dem Namen gettext

Generieren Sie binäre Übersetzungsdateien

Um das Lesen des Programms zu beschleunigen, sollten die Textdateien .po in die Binärdatei .mo konvertiert werden. Führen Sie einfach den folgenden Befehl aus:

python i18n.py finish

und dann können Sie die Datei locales/<locale>/LC_MESSAGES/messages.mo sehen

Prüfen

Führen Sie die Anwendung aus, Sie sehen die neue Übersetzung

Pull-Anfrage

Erstellen Sie eine PR, um Ihre Änderungen an diesem Repo zusammenzuführen

Thema anpassen

Kopieren Sie im Verzeichnis assets/qss unter dem Quellcode- oder Binärprogrammverzeichnis eine Datei von style-dark.qss oder style-light.qss . Der Dateiname lautet style-xxx.qss “. Hier ist xxx der Name des Themas. damit die Software das Thema erkennen kann. Ändern Sie dann die qss Datei nach Ihren Wünschen. Die Syntax von qss ähnelt der von css , die Unterstützung ist jedoch nicht vollständig. Ob die css -Syntax verwendet werden kann, hängt vom tatsächlichen Effekt ab, haha. Das Hinzufügen von Theme-Code ist willkommen!(PR)

Darüber hinaus wurde die Software nicht bewusst für das Thema optimiert und die Klasse und ID wurden möglicherweise beiläufig geschrieben, sodass es keine Garantie dafür gibt, dass zukünftige Codes vollständig mit dem aktuellen QSS kompatibel sind.