Plate Config App

Приложение для настройки и тестирования аппаратных плат через COM-порт. Позволяет подключаться к плате, проходить авторизацию, отправлять команды, тестировать входы, выходы и подсветку, обновлять прошивку и назначать роли.

---

Содержание

• Системные требования
• Установка и запуск
• Интерфейс приложения
  • Главная страница
  • Подключение к плате
  • Панель управления
• Файлы данных
• Настройки
• Документация для разработчиков

---

Системные требования

• Windows 10 / 11
• COM-порт (физический или виртуальный), к которому подключена плата

Для запуска из собранного EXE дополнительных зависимостей не требуется.

---

Установка и запуск

Из готового EXE

1. Скопируйте plate_config_app.exe в любую папку.
2. Запустите двойным кликом.

Файл настроек settings.json создается автоматически рядом с EXE при первом изменении настроек.

Из исходников (для разработки)

См. DEVELOPMENT.md.

---

Интерфейс приложения

Главная страница

При запуске отображается стартовый экран с кнопками:

• Новое соединение -- открывает вкладку настройки COM-порта.
• Команды платы -- справочник поддерживаемых команд платы с поиском.
• Настройки приложения -- выбор цветовой темы (светлая / темная, зеленый / синий акцент).

Приложение поддерживает несколько одновременных подключений: каждое соединение открывается в отдельной вкладке.

Подключение к плате

Во вкладке соединения выберите параметры:

Параметр	Значение по умолчанию
Port	(первый доступный)
Baud rate	115200
Data bits	8
Stop bits	1
Parity	None
Flow control	None

Нажмите OK для подключения. Кнопка Обновить порты обновляет список доступных COM-портов.

Панель управления

После подключения открывается панель с действиями:

Действие	Описание
Handshake (Авторизация)	AES-256 авторизация на плате (если требуется)
Тест ввода	Мониторинг состояния входов в реальном времени
Тест подсветки	Управление светодиодами и режимами подсветки
Тест силовых выходов	Включение/выключение силовых выходов
Обновление прошивки	Загрузка файла прошивки на плату
Задание роли	Назначение роли платы
Ввод команд	Терминал для отправки произвольных команд вручную

Индикатор в заголовке вкладки отображает текущее состояние:

• Красный -- нет связи.
• Желтый -- подключено, требуется авторизация.
• Зеленый -- подключено, плата готова к работе.

Приложение автоматически отслеживает состояние соединения и пытается переподключиться при потере связи.

---

Файлы данных

Рядом с EXE (или в корне проекта при запуске из исходников) могут располагаться папки с конфигурациями:

Папка	Расширение	Назначение
light_modes/	.lm	Режимы подсветки (формат TOML)
input_mappings/	.mapping	Маппинги входов по играм (формат TOML)
commands/	.csv	Наборы команд платы (разделитель ;)

Эти файлы располагаются рядом с EXE (или в корне проекта при запуске из исходников). При сборке они автоматически копируются в папку dist/ рядом с EXE. Можно редактировать файлы конфигураций без пересборки — достаточно изменить нужный файл и перезапустить приложение.

---

Настройки

Настройки хранятся в settings.json рядом с EXE. Файл создается автоматически.

Доступные параметры (изменяются через диалог в приложении):

Параметр	Значения	По умолчанию
Тема	Светлая / Темная	Светлая
Акцент	Зеленый / Синий	Зеленый

---

Документация для разработчиков

• DEVELOPMENT.md -- настройка окружения, структура проекта, запуск из исходников.
• BUILD_EXE.md -- сборка EXE-файла через PyInstaller.
• Система команд платы v2.x.md -- описание протокола и команд платы.