Download COMTool - download do código-fonte COMTool

COMTool

Outras categorias

v3.4.1

Baixar

COMFerramenta

Inglês | 中文

Uma ferramenta de depuração serial de plataforma cruzada escrita por python

Windows	Linux	Framboesa Pi	macOS

Tema branco	Tema escuro	plugin de protocolo	TCP/UDP	terminal	Gráfico

captura de tela talvez a versão antiga, a mais recente pode não ser totalmente a mesma! Mas melhor desempenho, mais fácil de usar e mais elegante

Características

Instalação

Existem duas maneiras de instalar o COMTool:

Baixe arquivos binários e execute: Para Windows ou macOS e usuários de uso simples
Instalar como pacote python (código fonte): Para Linux, ou necessidade de usar usuário de plugins, ou usuários que conheçam python

Instalar binário

Windows

Baixe o arquivo bin mais recente na página de lançamento ou no sourceforge
Descompacte o arquivo .zip e clique em comtool.exe para executar

E você pode instalar por furo, mantido por StudentWeis
 scoop bucket add Nightly https://github.com/StudentWeis/Nightly
scoop install comtool

Linux

O Linux tem muitas versões, então compilamos apenas binários para o Ubuntu. Outra distribuição, instale a partir do pypi ou do código-fonte. Se você tiver alguma ideia de empacotar binário de plataforma cruzada como flatpak ou appimage, você pode contribuir com uma solicitação pull ou adicionar um problema para me dizer como fazer

Arch Linux e suas distribuições derivadas podem ser instaladas a partir do AUR (mantido por taotieren):
 # Release version
yay -S python-comtool
# Development version
yay -S python-comtool-git

Baixe o lançamento na página de lançamento, extraia os arquivos do arquivo .zip e clique em comtool para executar
Adicione o usuário atual ao grupo de discagem para evitar o comando sudo

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

Framboesa Pi

Abra o terminal, instale dependências com o gerenciador de pacotes:

sudo apt install git python3-pyqt5 python3-numpy

Use o gerenciador de pacotes para instalar o pyqt5 numpy etc. Se você encontrar algum erro ao instalar com pip , você pode tentar instalar primeiro com o gerenciador de pacotes. Para encontrar o nome do pacote, o truque é usar sudo apt-cache search package_name | grep package_name para pesquisar o nome do pacote e instale-o.

Em seguida, instale outros pacotes com 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

Adicione o usuário atual ao grupo de discagem para evitar o comando sudo

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

então aproveite por comando

 comtool

macOS

Baixe o lançamento na página de lançamento ou no sourceforge
Instale o pacote dmg

Se você deseja abrir vários comtool, basta clicar com o botão direito no ícone dock e clicar em New Window .

ou você pode abrir o terminal e digitar

 open -n /Application/comtool.app

ou

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

Como o programa não é assinado pelo desenvolvedor, ele avisará quando você abri-lo pela primeira vez. Você precisa ir para Settings -> Security and Privacy -> General para ver o prompt comtool e clicar em Open anyway .

O Windows Defender mostra que o binário do Comtool é malware?

Se o seu programa for baixado daqui, tudo bem, o erro causado pelo problema do pacote, todo o código fonte e script do pacote estão aqui, até o progresso do pacote é totalmente automatizado com a ação do github, ninguém empacota manualmente.

Se você ainda estiver preocupado, basta baixar o código-fonte para rodar com python ou empacotar você mesmo.

Claro, se você encontrar uma forma de embalagem melhor, abra o problema para nos contar.

Instale o pacote python

Para desenvolvedores ou o binário não suporta sua plataforma, use esta forma de instalar

Instale o Python3 primeiro
- Se for Windows ou macOS: baixe python3
- Se linux: ubuntu por exemplo sudo apt install python3 python3-pip , macOS brew install python3 python3-pip
Certifique-se de ter pip

pip3 --version
# or
pip --version

Se não houver este comando, instale por

python3 -m ensurepip

Em seguida, instale a partir do pypi:

pip3 install comtool
comtool

para chinês, você pode usar espelhos de atum para baixar mais rápido:

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

Ou você pode instalar diretamente do github

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

Ou você pode baixar o código-fonte e instalar a partir do código-fonte
- baixe o código-fonte, baixe na página da web ou git clone https://github.com/Neutree/COMTool.git
- instalar

 cd COMTool
pip install .

ou construa sua própria roda binária

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

Se encontrar um erro ao instalar com pip , você pode tentar instalar primeiro com o gerenciador de pacotes e depois instalar com pip novamente. por exemplo

 sudo apt install python3-pyqt5 python3-numpy cython3

Para encontrar o nome do pacote, o truque é usar sudo apt-cache search package_name | grep package_name para pesquisar o nome do pacote e instale-o.

A propósito, você deve adicionar o usuário atual ao grupo de discagem para evitar o comando sudo

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

Adicione manualmente o aplicativo ao menu iniciar no Linux

Copie tool/comtool.desktop para a pasta /usr/share/applications (pode ser necessário que o usuário root faça isso)
Edite /usr/share/applications/comtool.desktop , altere o caminho do ícone Icon=/usr/local/COMTool/assets/logo.ico para o caminho do ícone real, você também pode usar seu ícone de amor
Então você pode encontrar o aplicativo comtool no menu iniciar (ou centro de aplicativos)

Pacote binário

pip3 install pyinstaller
python pack.py
cd dist
ls

É melhor criar um ambiente virtual antes do pacote para diminuir o tamanho do binário pip install virtualenv virtualenv venv source venv/bin/activate # linux venv/Scripts/activate # windows Se você encontrar running scripts is disabled on this system , você pode permitir temporariamente o terminal atual para executar scripts Set-ExecutionPolicy -Scope Process -ExecutionPolicy RemoteSigned Então pip install pyinstaller e python pack.py

Desenvolvimento

Instale python(>=3.8) e pip3

Linux:

 sudo apt install python3 python3-pip

Windows: baixe python3

instale pacotes como pyserial e PyQt5 etc. (lista em requisitos.txt)

 cd COMTool
pip3 install -r requirements.txt

No Raspberry, python3-pyqt5 pode ser instalado pelo comando apt :

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

projeto clone

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

código, resolva bugs ou adicione novas características

PyCharm IDE ou vscode recomendado para começar

Como executar: Gere primeiro os arquivos binários de tradução ( .mo )

 python COMTool/i18n.py finish

Em seguida, execute o programa principal

 python COMTool/Main.py

solicitação pull

Escreva seus próprios plug-ins em minutos

veja docs/plugins.md

Adicionar tradução

Instale o ambiente primeiro (pacotes python pip em quirments.txt)

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

Se você precisar adicionar um novo idioma ou pular

Adicionar localidade em i18n.py

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

anexe seu idioma a esta lista, as localidades podem ser encontradas aqui ou na wikipedia, zh_CN por exemplo significa China Continental, o idioma correspondente são caracteres chineses simplificados, zh_TW significa China Taiwan e o idioma são caracteres chineses tradicionais, você também pode usar apenas zh para usar caracteres simplificados Caracteres chineses.

Gerar arquivos de tradução

python i18n.py prepare

Este comando irá gerar arquivos .po na pasta locales

Traduzir manualmente

Em seguida, traduza os arquivos .po , este é um formato de arquivo de tradução padrão denominado gettext

Gere arquivos de tradução binários

para tornar a leitura do programa mais rápida, os arquivos de texto .po devem ser convertidos para o arquivo binário .mo , basta executar o comando:

python i18n.py finish

e então você pode ver o arquivo locales/<locale>/LC_MESSAGES/messages.mo

Teste

Execute o aplicativo, você verá a nova tradução

Solicitação pull

Crie um PR para mesclar suas alterações neste repositório

Personalizar tema

No diretório assets/qss no código-fonte ou diretório do programa binário, copie um arquivo de style-dark.qss ou style-light.qss , o nome do arquivo é style-xxx.qss , aqui xxx é o nome do tema, para que o software possa detectar o tema. Em seguida, modifique o arquivo qss de acordo com suas preferências. A sintaxe de qss é semelhante a css , mas o suporte não é completo. Se a sintaxe css pode ser usada depende do efeito real, haha. Adicionar código de tema é bem-vindo!(PR)

Além disso, o software não foi deliberadamente otimizado para o tema, e a classe e o ID podem ter sido escritos casualmente, portanto não há garantia de que os códigos futuros serão totalmente compatíveis com o qss atual.