From a3c5e5eafcb2f7d764a4a6aad1a8dc53c910bbe0 Mon Sep 17 00:00:00 2001 From: LowaSC Date: Wed, 19 Feb 2025 23:55:21 +0300 Subject: [PATCH] Update README with comprehensive documentation and usage guidelines for COM port emulator --- README.md | 90 ++++++++++++++++++++++++++---------------------- requirements.txt | 4 +++ 2 files changed, 52 insertions(+), 42 deletions(-) create mode 100644 requirements.txt diff --git a/README.md b/README.md index f19742f..7736072 100644 --- a/README.md +++ b/README.md @@ -1,59 +1,65 @@ -# Testing_APP_for_ComConfigCopy +# COM Port Эмулятор -Программа для тестирование работоспособности другой программы - ComConfigCopy. -Эмуляция COM-порта +Это приложение позволяет эмулировать последовательные COM-порты для тестирования и разработки приложений, использующих последовательную связь. ## Требования -- Python 3.6 или выше -- Библиотека pyserial -- Для Windows: com0com -- Для Linux: socat + +- Windows 7/8/10/11 +- Python 3.7 или выше +- com0com (Null-modem эмулятор) ## Установка -1. Установите Python-зависимости: -bash -pip install pyserial +1. Установите com0com + - Скачайте установщик com0com с [официального сайта](https://sourceforge.net/projects/com0com/) + - Запустите установщик от имени администратора + - Следуйте инструкциям установщика + - После установки откройте "Setup for com0com" и создайте пару виртуальных COM-портов -2. Установка драйвера виртуального COM-порта: +2. Установите зависимости Python: -### Windows: -- Скачайте и установите com0com: https://sourceforge.net/projects/com0com/ -- Запустите установщик от имени администратора - -### Linux: - -```bash -sudo apt-get install socat -``` + ```bash + pip install -r requirements.txt + ``` ## Использование -1. Сначала создайте виртуальные COM-порты: -```bash -# Windows: запустите от имени администратора -python virtual_com.py +1. Измените порт в файле main.py, что бы он соответствовал номеру порта в com0com -# Linux: запустите с sudo -sudo python virtual_com.py -``` +2. Запустите приложение: -2. После создания виртуальных портов запустите основную программу: -```bash -python main.py -``` + ```bash + python main.py + ``` -3. Выберите один из созданных виртуальных COM-портов -4. В другом терминале запустите еще одну копию программы и выберите второй виртуальный порт -5. Теперь вы можете обмениваться сообщениями между двумя экземплярами программы +## Параметры конфигурации com0com -## Примечания -- В Windows виртуальные порты создаются как CNCA0 и CNCB0 -- В Linux виртуальные порты создаются как /dev/ttyV0 и /dev/ttyV1 -- Для работы требуются права администратора/root +Рекомендуемые настройки для пары виртуальных портов: -Теперь у вас есть полный набор инструментов для тестирования: -1. Программа для создания виртуальных COM-портов -2. Программа для обмена данными через эти порты +- Baud rate: 9600 +- Data bits: 8 +- Stop bits: 1 +- Parity: None +- Flow control: None -Вы можете запустить два экземпляра основной программы, каждый на своем виртуальном порту, и тестировать обмен данными между ними. +## Решение проблем + +1. Если порты не отображаются: + - Проверьте, что com0com установлен корректно + - Проверьте, что com0com запущен + - Проверьте, что в диспетчере устройств отображаются виртуальные COM-порты + - Убедитесь в правильности установки драйверов от com0com (для windows 11 была использована версия 2.2.2.0. В версия 3.0.0.0 может быть проблема с установкой драйверов) + - Перезапустите компьютер после установки com0com + +2. Если возникает ошибка доступа: + - Убедитесь, что выбран правильный порт в приложении + - Убедитесь, что порт не используется другими приложениями + - Запустите приложение от имени администратора + +## Лицензия + +MIT License + +## Поддержка + +При возникновении проблем создайте Issue в репозитории проекта. diff --git a/requirements.txt b/requirements.txt new file mode 100644 index 0000000..7ae7b54 --- /dev/null +++ b/requirements.txt @@ -0,0 +1,4 @@ +pyserial>=3.5 +PyQt5>=5.15.0 +pyqtgraph>=0.12.0 +numpy>=1.19.0 \ No newline at end of file