Update README with comprehensive documentation and usage guidelines for COM port emulator
This commit is contained in:
90
README.md
90
README.md
@@ -1,59 +1,65 @@
|
|||||||
# Testing_APP_for_ComConfigCopy
|
# COM Port Эмулятор
|
||||||
|
|
||||||
Программа для тестирование работоспособности другой программы - ComConfigCopy.
|
Это приложение позволяет эмулировать последовательные COM-порты для тестирования и разработки приложений, использующих последовательную связь.
|
||||||
Эмуляция COM-порта
|
|
||||||
|
|
||||||
## Требования
|
## Требования
|
||||||
- Python 3.6 или выше
|
|
||||||
- Библиотека pyserial
|
- Windows 7/8/10/11
|
||||||
- Для Windows: com0com
|
- Python 3.7 или выше
|
||||||
- Для Linux: socat
|
- com0com (Null-modem эмулятор)
|
||||||
|
|
||||||
## Установка
|
## Установка
|
||||||
|
|
||||||
1. Установите Python-зависимости:
|
1. Установите com0com
|
||||||
bash
|
- Скачайте установщик com0com с [официального сайта](https://sourceforge.net/projects/com0com/)
|
||||||
pip install pyserial
|
- Запустите установщик от имени администратора
|
||||||
|
- Следуйте инструкциям установщика
|
||||||
|
- После установки откройте "Setup for com0com" и создайте пару виртуальных COM-портов
|
||||||
|
|
||||||
2. Установка драйвера виртуального COM-порта:
|
2. Установите зависимости Python:
|
||||||
|
|
||||||
### Windows:
|
```bash
|
||||||
- Скачайте и установите com0com: https://sourceforge.net/projects/com0com/
|
pip install -r requirements.txt
|
||||||
- Запустите установщик от имени администратора
|
```
|
||||||
|
|
||||||
### Linux:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
sudo apt-get install socat
|
|
||||||
```
|
|
||||||
|
|
||||||
## Использование
|
## Использование
|
||||||
|
|
||||||
1. Сначала создайте виртуальные COM-порты:
|
1. Измените порт в файле main.py, что бы он соответствовал номеру порта в com0com
|
||||||
```bash
|
|
||||||
# Windows: запустите от имени администратора
|
|
||||||
python virtual_com.py
|
|
||||||
|
|
||||||
# Linux: запустите с sudo
|
2. Запустите приложение:
|
||||||
sudo python virtual_com.py
|
|
||||||
```
|
|
||||||
|
|
||||||
2. После создания виртуальных портов запустите основную программу:
|
```bash
|
||||||
```bash
|
python main.py
|
||||||
python main.py
|
```
|
||||||
```
|
|
||||||
|
|
||||||
3. Выберите один из созданных виртуальных COM-портов
|
## Параметры конфигурации com0com
|
||||||
4. В другом терминале запустите еще одну копию программы и выберите второй виртуальный порт
|
|
||||||
5. Теперь вы можете обмениваться сообщениями между двумя экземплярами программы
|
|
||||||
|
|
||||||
## Примечания
|
Рекомендуемые настройки для пары виртуальных портов:
|
||||||
- В Windows виртуальные порты создаются как CNCA0 и CNCB0
|
|
||||||
- В Linux виртуальные порты создаются как /dev/ttyV0 и /dev/ttyV1
|
|
||||||
- Для работы требуются права администратора/root
|
|
||||||
|
|
||||||
Теперь у вас есть полный набор инструментов для тестирования:
|
- Baud rate: 9600
|
||||||
1. Программа для создания виртуальных COM-портов
|
- Data bits: 8
|
||||||
2. Программа для обмена данными через эти порты
|
- 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 в репозитории проекта.
|
||||||
|
|||||||
4
requirements.txt
Normal file
4
requirements.txt
Normal file
@@ -0,0 +1,4 @@
|
|||||||
|
pyserial>=3.5
|
||||||
|
PyQt5>=5.15.0
|
||||||
|
pyqtgraph>=0.12.0
|
||||||
|
numpy>=1.19.0
|
||||||
Reference in New Issue
Block a user