COMTool下載 - COMTool原始碼下載

COMTool

其他類別

v3.4.1

下載

COM工具

英語 | 中文

python編寫的跨平台串口調試工具

視窗	Linux	樹莓派	macOS

白色主題	深色主題	協定插件	TCP/UDP	終端	圖形

截圖可能是舊版本，最新的可能完全不一樣！但性能更好、更易用、更優雅

特徵

安裝

有兩種方法安裝 COMTool：

下載二進位檔案並執行：適用於Windows或macOS以及簡單使用的用戶
安裝為python套件（原始碼）：對於Linux，或需要使用插件的用戶，或了解python的用戶

安裝二進位文件

視窗

在發布頁面或sourceforge下載最新的bin文件
解壓縮.zip文件，點選comtool.exe運行

你可以透過 scoop 安裝，由 StudentWeis 維護
 scoop bucket add Nightly https://github.com/StudentWeis/Nightly
scoop install comtool

Linux

Linux版本太多，所以我們只為ubuntu編譯二進位。其他發行版請從 pypi 或原始碼安裝。如果您有任何想法打包跨平台二進位檔案（例如 flatpak 或 appimage），您可以貢獻一個拉取請求或添加一個問題來告訴我如何

Arch Linux 及其衍生發行版可從 AUR 安裝（由 taotieren 維護）：
 # Release version
yay -S python-comtool
# Development version
yay -S python-comtool-git

在release頁面下載release，並從.zip檔案中解壓縮文件，然後點擊comtool運行
將目前使用者新增至 dialout 群組以避免sudo指令

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

樹莓派

開啟終端，使用套件管理器安裝相依性：

sudo apt install git python3-pyqt5 python3-numpy

使用套件管理器安裝 pyqt5 numpy 等。如果使用pip安裝時遇到錯誤，可以先嘗試使用套件管理器安裝。要找套件名稱，技巧是使用sudo apt-cache search package_name | grep package_name搜尋包名，然後安裝。

然後使用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

將目前使用者新增至 dialout 群組以避免sudo指令

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

然後透過命令享受

 comtool

macOS

在發布頁面或 sourceforge 下載版本
安裝dmg包

如果要開啟多個comtool，只需右鍵單擊dock圖標，然後按一下New Window 。

或者你可以打開終端機並輸入

 open -n /Application/comtool.app

或者

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

由於該程式沒有經過開發者簽名，因此第一次開啟時會發出警告。您需要進入Settings -> Security and Privacy -> General才能看到提示comtool ，然後單擊Open anyway 。

Windows Defender 顯示 comtool 二進位是惡意軟體？

如果你的程式是從這裡下載的，沒關係，是pack問題導致的錯誤，所有的源碼和pack腳本都在這裡，連打包進度都是完全用github動作自動化的，沒有人手動打包。

如果您仍然擔心，只需下載原始程式碼以使用 python 運行或自行打包。

當然，如果您發現更好的打包方式，請開issue告訴我們。

安裝python包

對於開發人員或二進位檔案不支援您的平台，請使用此方式安裝

首先安裝Python3
- 如果是 Windows 或 macOS：下載 python3
- 如果 linux: ubuntu 例如sudo apt install python3 python3-pip , macOS brew install python3 python3-pip
確保你pip

pip3 --version
# or
pip --version

如果沒有這個指令，則安裝

python3 -m ensurepip

然後從 pypi 安裝：

pip3 install comtool
comtool

對於中文，您可以使用金槍魚鏡像來更快地下載：

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

或者你可以直接從github安裝

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

或者您可以下載原始程式碼，然後從原始碼安裝
- 下載原始碼，網頁下載或git clone https://github.com/Neutree/COMTool.git
- 安裝

 cd COMTool
pip install .

或建立你自己的wheel二進位文件

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

如果使用pip安裝時遇到錯誤，可以嘗試先使用套件管理器安裝，然後再使用pip安裝。例如

 sudo apt install python3-pyqt5 python3-numpy cython3

要找套件名稱，技巧是使用sudo apt-cache search package_name | grep package_name搜尋包名，然後安裝。

順便說一句，您應該將當前用戶添加到 dialout 群組以避免sudo命令

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

在 Linux 上手動將應用程式新增至開始功能表

將 tool/comtool.desktop 複製到/usr/share/applications資料夾（可能需要root使用者來執行此操作）
編輯/usr/share/applications/comtool.desktop ，將圖標路徑Icon=/usr/local/COMTool/assets/logo.ico更改為實際圖標路徑，您也可以使用您的愛心圖標
然後您可以在開始功能表（或應用程式中心）找到comtool應用程式

打包二進位文件

pip3 install pyinstaller
python pack.py
cd dist
ls

最好在打包之前創建一個虛擬環境，以減少二進位檔案的大小pip install virtualenv virtualenv venv source venv/bin/activate # linux venv/Scripts/activate # windows 如果遇到running scripts is disabled on this system ，可以暫時允許目前終端執行腳本Set-ExecutionPolicy -Scope Process -ExecutionPolicy RemoteSigned然後pip install pyinstaller和python pack.py

發展

安裝 python(>=3.8) 和 pip3

Linux：

 sudo apt install python3 python3-pip

Windows：下載python3

安裝pyserial和PyQt5等軟體套件（在requirements.txt中列出）

 cd COMTool
pip3 install -r requirements.txt

在Raspberry上，可以透過apt指令安裝python3-pyqt5 ：

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

克隆項目

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

程式碼、解決錯誤或新增功能

推薦使用PyCharm IDE 或vscode入門

如何運作：先生成翻譯二進位檔案( .mo )

 python COMTool/i18n.py finish

然後執行主程式

 python COMTool/Main.py

拉取請求

只需幾分鐘即可編寫您自己的插件

請參閱文件/plugins.md

新增翻譯

先安裝環境（requirements.txt中的python pip套件）

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

如果您需要新增語言，或跳過

在 i18n.py 中加入語言環境

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

將您的語言添加到此列表中，區域設定可以在此處或維基百科中找到，例如zh_CN表示中國大陸，對應的語言是簡體中文字符， zh_TW表示中國台灣，語言是繁體中文字符，您也可以只使用zh來使用簡體中文漢字。

產生翻譯文件

python i18n.py prepare

該命令將在 locales 資料夾中產生.po文件

手動翻譯

然後翻譯.po文件，這是標準翻譯文件格式，名為gettext

產生二進位翻譯文件

為了使程式讀取更快，文字檔案.po應該轉換為二進位檔案.mo ，只需執行命令：

python i18n.py finish

然後你可以看到locales/<locale>/LC_MESSAGES/messages.mo文件

測試

運行應用程序，您將看到新的翻譯

拉取請求

建立 PR 以將您的變更合併到此儲存庫

自訂主題

在原始碼或二進位程式目錄下的assets/qss目錄中，複製一個style-dark.qss或style-light.qss文件，檔案名稱為style-xxx.qss ，這裡xxx是主題的名稱，以便軟體可以偵測主題。然後根據自己的喜好修改qss檔。 qss的語法與css類似，但支援不完整。 css語法能不能用就看實際效果了，哈哈。歡迎添加主題代碼！