Téléchargement COMTool - Téléchargement du code source COMTool

COMTool

Autres catégories

v3.4.1

Télécharger

COMTool

Anglais | Chine

Un outil de débogage série multiplateforme écrit par python

Fenêtres	Linux	Framboise Pi	macOS

Thème blanc	Thème sombre	plugin de protocole	TCP/UDP	Terminal	Graphique

capture d'écran peut-être l'ancienne version, la dernière peut ne pas être totalement la même ! Mais de meilleures performances, plus faciles à utiliser et plus élégantes

Caractéristiques

Installation

Il existe deux manières d'installer COMTool :

Téléchargez les fichiers binaires et exécutez : Pour Windows ou macOS et les utilisateurs à utilisation simple
Installer en tant que package python (code source) : Pour Linux, ou besoin d'utiliser l'utilisateur des plugins ou des utilisateurs connaissant Python

Installer le binaire

Fenêtres

Téléchargez le dernier fichier bin sur la page de version ou sur sourceforge
Décompressez le fichier .zip et cliquez sur comtool.exe pour exécuter

Et vous pouvez installer par scoop, maintenu par StudentWeis
 scoop bucket add Nightly https://github.com/StudentWeis/Nightly
scoop install comtool

Linux

Linux a trop de versions, nous compilons donc uniquement le binaire pour Ubuntu. Autre distribution, veuillez l'installer à partir de pypi ou du code source. Si vous avez une idée pour emballer des binaires multiplateformes comme flatpak ou appimage, vous pouvez contribuer une pull request ou ajouter un problème pour me dire comment procéder.

Arch Linux et ses distributions dérivées peuvent être installés à partir d'AUR (maintenu par taotieren)：
 # Release version
yay -S python-comtool
# Development version
yay -S python-comtool-git

Téléchargez la version sur la page de version, extrayez les fichiers du fichier .zip , puis cliquez sur comtool pour exécuter
Ajouter l'utilisateur actuel au groupe de numérotation pour éviter la commande sudo

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

Framboise Pi

Ouvrez le terminal, installez les dépendances avec le gestionnaire de packages :

sudo apt install git python3-pyqt5 python3-numpy

Utilisez le gestionnaire de packages pour installer pyqt5 numpy, etc. Cette méthode facilite l'installation. Si vous rencontrez une erreur lors de l'installation avec pip , vous pouvez d'abord essayer d'installer avec le gestionnaire de packages. Pour trouver le nom du package, l'astuce consiste à utiliser sudo apt-cache search package_name | grep package_name pour rechercher le nom du package, puis installez-le.

Installez ensuite d'autres packages avec 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

Ajouter l'utilisateur actuel au groupe de numérotation pour éviter la commande sudo

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

puis profitez par commande

 comtool

macOS

Téléchargez la version sur la page de version ou sur sourceforge
Installer le paquet dmg

Si vous souhaitez ouvrir plusieurs comtool, cliquez simplement avec le bouton droit sur l'icône du Dock, puis cliquez sur New Window .

ou vous pouvez ouvrir le terminal et taper

 open -n /Application/comtool.app

ou

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

Le programme n'étant pas signé par le développeur, il vous avertira lorsque vous l'ouvrirez pour la première fois. Vous devez aller dans Settings -> Security and Privacy -> General pour voir l'invite comtool et cliquer sur Open anyway .

Windows Defender montre que le binaire Comtool est un malware ?

Si votre programme est téléchargé à partir d'ici, tout va bien, l'erreur causée par un problème de pack, tout le code source et le script du pack sont ici, même la progression du pack est totalement automatisée avec l'action github, personne ne packe manuellement.

Si vous restez inquiet, téléchargez simplement le code source pour l'exécuter avec Python ou emballez-le vous-même.

Bien sûr, si vous trouvez une meilleure méthode de pack, veuillez ouvrir le problème pour nous le dire.

Installer le paquet Python

Pour les développeurs ou les binaires ne prenant pas en charge ceux de votre plateforme, utilisez cette méthode pour installer

Installez d'abord Python3
- Si Windows ou macOS : téléchargez python3
- Si Linux : Ubuntu par exemple sudo apt install python3 python3-pip , macOS brew install python3 python3-pip
Assurez-vous d'avoir pip

pip3 --version
# or
pip --version

S'il n'y a pas cette commande, installez-la en

python3 -m ensurepip

Ensuite installez depuis pypi :

pip3 install comtool
comtool

pour le chinois, vous pouvez utiliser des miroirs de thon pour télécharger plus rapidement en :

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

Ou vous pouvez installer directement depuis github

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

Ou vous pouvez télécharger le code source, puis l'installer à partir du code source
- téléchargez le code source, téléchargez dans la page Web ou git clone https://github.com/Neutree/COMTool.git
- installer

 cd COMTool
pip install .

ou construisez votre propre binaire de roue

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

Si vous rencontrez une erreur lors de l'installation avec pip , vous pouvez d'abord essayer d'installer avec le gestionnaire de packages, puis réinstaller avec pip . par exemple

 sudo apt install python3-pyqt5 python3-numpy cython3

Pour trouver le nom du package, l'astuce consiste à utiliser sudo apt-cache search package_name | grep package_name pour rechercher le nom du package, puis installez-le.

À propos, vous devez ajouter l'utilisateur actuel au groupe de numérotation pour éviter la commande sudo

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

Ajouter manuellement une application au menu Démarrer sous Linux

Copiez tool/comtool.desktop dans le dossier /usr/share/applications (un utilisateur root peut être nécessaire pour ce faire)
Modifiez /usr/share/applications/comtool.desktop , remplacez le chemin de l'icône Icon=/usr/local/COMTool/assets/logo.ico par le chemin de l'icône réel, vous pouvez également utiliser votre icône d'amour
Ensuite, vous pouvez trouver l'application Comtool dans le menu Démarrer (ou dans le centre d'applications).

Pack binaire

pip3 install pyinstaller
python pack.py
cd dist
ls

Il est préférable de créer un environnement virtuel avant le pack pour diminuer la taille du binaire pip install virtualenv virtualenv venv source venv/bin/activate # linux venv/Scripts/activate # windows Si vous rencontrez running scripts is disabled on this system , vous pouvez temporairement autoriser le terminal actuel pour exécuter les scripts Set-ExecutionPolicy -Scope Process -ExecutionPolicy RemoteSigned Puis pip install pyinstaller et python pack.py

Développement

Installez python(>=3.8) et pip3

Linux :

 sudo apt install python3 python3-pip

Windows : télécharger python3

installer des packages comme pyserial et PyQt5 etc. (liste dans exigences.txt)

 cd COMTool
pip3 install -r requirements.txt

Sur Raspberry, python3-pyqt5 peut être installé par la commande apt :

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

projet de clonage

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

coder, résoudre des bugs ou ajouter de nouvelles caractéristiques

IDE PyCharm ou vscode recommandé pour commencer

Comment exécuter : Générez d'abord la traduction des fichiers binaires ( .mo )

 python COMTool/i18n.py finish

Puis exécutez le programme principal

 python COMTool/Main.py

demande de tirage

Écrivez vos propres plugins en quelques minutes

voir docs/plugins.md

Ajouter une traduction

Installez d'abord l'environnement (packages python pip dans le fichier requirejs.txt)

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

Si vous devez ajouter une nouvelle langue ou ignorer

Ajouter des paramètres régionaux dans i18n.py

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

ajoutez votre langue à cette liste, les paramètres régionaux peuvent être trouvés ici ou sur Wikipédia, zh_CN par exemple signifie Chine continentale, la langue correspondante est constituée de caractères chinois simplifiés, zh_TW signifie Chine Taiwan et la langue est constituée de caractères chinois traditionnels, vous pouvez également utiliser uniquement zh pour utiliser des caractères simplifiés. Caractères chinois.

Générer des fichiers de traduction

python i18n.py prepare

Cette commande générera des fichiers .po dans le dossier locales

Traduire manuellement

Traduisez ensuite les fichiers .po , il s'agit d'un format de fichier de traduction standard nommé gettext

Générer des fichiers de traduction binaires

pour accélérer la lecture du programme, les fichiers texte .po doivent être convertis en fichier binaire .mo , exécutez simplement la commande :

python i18n.py finish

et ensuite vous pouvez voir le fichier locales/<locale>/LC_MESSAGES/messages.mo

Test

Exécutez l'application, vous verrez la nouvelle traduction

Demande de tirage

Créez un PR pour fusionner vos modifications dans ce dépôt

Personnaliser le thème

Dans le répertoire assets/qss sous le répertoire du code source ou du programme binaire, copiez un fichier depuis style-dark.qss ou style-light.qss , le nom du fichier est style-xxx.qss , ici xxx est le nom du thème, afin que le logiciel puisse détecter le thème. Modifiez ensuite le fichier qss selon vos préférences. La syntaxe de qss est similaire à css , mais la prise en charge n'est pas complète. La possibilité d'utiliser la syntaxe css dépend de l'effet réel, haha. L'ajout d'un code de thème est le bienvenu ! (PR)

De plus, le logiciel n'a pas été délibérément optimisé pour le thème, et la classe et l'identifiant peuvent avoir été écrits avec désinvolture, il n'y a donc aucune garantie que les futurs codes seront entièrement compatibles avec les qss actuels.