1 В избранное 0 Ответвления 0

OSCHINA-MIRROR/neutree-comtool

Присоединиться к Gitlife
Откройте для себя и примите участие в публичных проектах с открытым исходным кодом с участием более 10 миллионов разработчиков. Приватные репозитории также полностью бесплатны :)
Присоединиться бесплатно
Клонировать/Скачать
Внести вклад в разработку кода
Синхронизировать код
Отмена
Подсказка: Поскольку Git не поддерживает пустые директории, создание директории приведёт к созданию пустого файла .keep.
Loading...
README.MD

COMTool

Кроссплатформенный инструмент для отладки последовательных портов, написанный на Python.

Языки: английский | китайский

Скриншоты:

Windows Linux Raspberry Pi macOS
comtool Windows screenshot (скриншот версии 2, белый фон) comtool linux screenshot (скриншот версии 1.4, тёмный фон) comtool Raspberry Pi screenshot screenshot macOS
Белый фон Тёмный фон Плагин протокола TCP/UDP Терминал Графики
comtool белый фон (скриншот версии 2) comtool тёмный фон (скриншот версии 2) comtool плагин протокола TCP/UDP plugin terminal plugin graph

Скриншоты могут быть старыми версиями, актуальные версии могут отличаться. Но в них улучшена производительность, они стали более удобными и элегантными.

Функции

  • Кроссплатформенность (Windows, Linux, macOS, Raspberry Pi) (код на Python, только если ваша платформа поддерживает Python).
  • Надёжная стабильность, без зависания пользовательского интерфейса.
  • Поддержка нескольких языков.
  • Сохранение и автоматическая загрузка конфигураций (автоматическое сохранение настроек при выходе).
  • Поддержка множества кодировок символов (ASII, GBK (китайский), UTF-8, UTF-16 и др.).
  • Поддержка множественных типов соединений и возможность добавления плагинов для соединения:
    • Последовательный порт:
      • Автоматическое обнаружение последовательного порта и запоминание последнего выбранного порта.
      • Автономное автоматическое переподключение к последовательному порту.
      • Настройки скорости передачи данных (любая скорость), размера байтов, контроля чётности, стоповых битов, управления потоком и т. д.
      • Ручное управление RTS и DTR.
    • Поддержка TCP/UDP, включая клиентский и серверный режимы.
    • Поддержка SSH-клиента.
  • Поддержка плагинов (создание плагина см. в docs/plugins.md). Встроенный плагин:
    • Плагин dbg, поддержка основных операций отправки и получения данных для отладки:
      • Базовая отправка и получение данных (ASCII и шестнадцатеричный формат).
      • Отправка и получение счётчика данных.
      • Очистка области полученных данных.
      • Автоматическая подача строки.
      • Запланированная автоматическая отправка.
      • Выбор отправленных данных и повторная отправка.
      • Настройка наиболее используемых элементов данных и отправка одним кликом.
      • Поддержка CR LF (\r\n) или LF (\n).
      • Сочетания клавиш, такие как Ctrl+Enter, для отправки и т.д. Подробнее см. справку.
      • Запись полученных и отправленных данных с добавлением метки времени и сохранением журнала в файл.
      • Отправка файла.
      • Поддержка цвета в стиле терминала Unix (например, \x1b[33;42mhello\x1b[0mhello2).
      • Поддержка управляющих символов, таких как \r \n \t \x и т. п.
    • Плагин протокола, настройка собственного протокола:
      • Настройка методов кодирования и декодирования.
      • Настройка сочетания клавиш.
      • Поддержка управляющих символов, таких как \r \n \t \x и т.п.
    • Терминальный плагин, базовое взаимодействие с терминалом.
    • Графический плагин:
      • Динамическое добавление виджетов графиков.
      • Отображение линейных диаграмм в реальном времени.
      • Поддержка настройки протокола заголовка (поддержка управляющих символов).
      • Настраиваемая кнопка для отправки данных, поддержка сочетания клавиш. Установка

Существует два способа установить COMTool:

  • [Скачать бинарные файлы и запустить](#Установка-бинарных файлов): для Windows или macOS, а также для пользователей простого использования.
  • Установить как пакет Python (исходный код): для Linux или для пользователей, которым необходимо использовать плагины, или для тех, кто знаком с Python.

Установка бинарных файлов

Windows

  • Скачайте последний файл bin на странице релизов или sourceforge.
  • Распакуйте файл .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):

# Версия релиза
yay -S python-comtool
# Разработка версии
yay -S python-comtool-git
  • Загрузите релиз на странице релиза, распакуйте файлы из файла .zip и нажмите comtool, чтобы запустить.

  • Добавьте текущего пользователя в группу dialout, чтобы избежать команды sudo:

sudo usermod -a -G dialout $USER
grep 'dialout' /etc/group
reboot #необходимо перезагрузиться, чтобы изменения вступили в силу

Raspberry Pi

Откройте терминал и установите зависимости с помощью менеджера пакетов:

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 'dialtool' /etc/group
reboot #необходима перезагрузка, чтобы изменения вступили в силу

затем наслаждайтесь командой:

comtool

macOS

  • Скачать релиз на странице релизов или sourceforge.
  • Установите dmg пакет.

Если вы хотите открыть несколько comtool, просто щёлкните правой кнопкой мыши значок док-станции и выберите «Новое окно».

Или вы можете открыть терминал и ввести:

open -n /Application/comtool.app

или

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

Поскольку программа не подписана разработчиком, она выдаст предупреждение при первом открытии. Вам нужно перейти в «Настройки» > «Безопасность и конфиденциальность» > «Общие», чтобы увидеть приглашение comtool и нажать «Открыть в любом случае».

Windows defender показывает, что двоичный файл comtool является вредоносным?

Если ваша программа загружена отсюда, всё в порядке, ошибка вызвана проблемой упаковки (pack issue), весь исходный код и сценарий упаковки здесь, даже процесс упаковки полностью автоматизирован с помощью действия GitHub, никто вручную не упаковывает.

Если у вас всё ещё есть опасения, просто скачайте исходный код, чтобы запустить его с помощью Python или упакуйте самостоятельно.

Конечно, если вы найдёте лучший способ упаковки, пожалуйста, создайте задачу, чтобы рассказать нам.

Установить пакет Python

Для разработчиков или если двоичный файл не поддерживает вашу платформу, используйте этот способ для установки:

  • Сначала установите Python3:

    • Если Windows или macOS: скачать Python3.
    • Если Linux: например, Ubuntu sudo apt install python3 python3-pip, macOS brew install python3 python3-pip.
  • Убедитесь, что у вас есть pip:

pip3 **Стандартный формат файлов перевода, который называется gettext**

* Генерация бинарных файлов перевода

Чтобы программа считывала быстрее, текстовые файлы `.po` следует преобразовать в бинарный файл `.mo`. Для этого нужно выполнить команду:
```shell
python i18n.py finish

После чего вы увидите файл locales/<locale>/LC_MESSAGES/messages.mo.

  • Тестирование

Запустите приложение, и вы увидите новый перевод.

  • Запрос на включение изменений

Создайте запрос на включение (pull request) для объединения ваших изменений в этот репозиторий.

Настройка темы

В каталоге assets/qss под исходным кодом или каталогом бинарной программы скопируйте файл из style-dark.qss или style-light.qss, имя файла — style-xxx.qss, где xxx — это название темы. Так программное обеспечение сможет обнаружить тему. Затем измените файл qss в соответствии с вашими предпочтениями. Синтаксис qss похож на css, но поддержка не полная. Возможность использования синтаксиса css зависит от фактического эффекта, ха-ха. Добавление кода темы приветствуется! (PR)

Кроме того, программное обеспечение не было специально оптимизировано для темы, а класс и идентификатор могли быть написаны небрежно, поэтому нет гарантии, что будущие коды будут полностью совместимы с текущим qss.

Проблемы и улучшения

Оформите проблему здесь.

Лицензия

Лицензия LGPL-3.0.

Использованы следующие проекты с открытым исходным кодом в качестве библиотек:

Пожертвование

Если этот проект вам помог, вы можете купить мне чашку кофе.

Комментарии ( 0 )

Вы можете оставить комментарий после Вход в систему

Введение

Кроссплатформенный Serial Assistant (помощник по отладке через последовательный порт, помощник по работе с последовательным портом, сетевой помощник по отладке, терминальный инструмент для Linux, Windows, macOS, Raspberry Pi). Развернуть Свернуть
LGPL-3.0
Отмена

Обновления

Пока нет обновлений

Участники

все

Недавние действия

Загрузить больше
Больше нет результатов для загрузки
1
https://api.gitlife.ru/oschina-mirror/neutree-comtool.git
git@api.gitlife.ru:oschina-mirror/neutree-comtool.git
oschina-mirror
neutree-comtool
neutree-comtool
master