Danil Iarosh
c34cb0cd7e
- добавлена полная повторная авторизация перед командой 04 - добавлена авторизация после успешного обновления и перезагрузки платы - общий OTA-сценарий подключён к базовому и PRO-интерфейсам - в терминал команд добавлена кнопка ручной авторизации - состояние авторизации синхронизировано с основной вкладкой - добавлены тесты порядка авторизации и обработки ошибок OTA - версия приложения повышена до 1.5.0 - обновлена документация
Plate Config App
Приложение для настройки и тестирования аппаратных плат через COM-порт. Позволяет подключаться к плате, проходить авторизацию, отправлять команды, тестировать входы, выходы и подсветку, обновлять прошивку и назначать роли.
Содержание
- Системные требования
- Установка и запуск
- Интерфейс приложения
- Файлы данных
- Настройки
- Документация для разработчиков
Системные требования
- Windows 10 / 11
- Debian 13 x86_64 (для Linux-сборки и запуска Linux-пакета)
- COM-порт (физический или виртуальный), к которому подключена плата
Для запуска из собранного EXE дополнительных зависимостей не требуется.
Установка и запуск
Из готового EXE
- Скопируйте
plate_config_app.exeв любую папку. - Запустите двойным кликом.
Файл настроек settings.json создается автоматически рядом с EXE при первом
изменении настроек.
Из исходников (для разработки)
См. DEVELOPMENT.md.
Для Debian 13 x86_64 используйте build_linux.sh; подробности сборки приведены в BUILD_EXE.md.
Интерфейс приложения
Главная страница
При запуске отображается стартовый экран с кнопками:
- Новое соединение -- открывает вкладку настройки COM-порта.
- Команды платы -- справочник поддерживаемых команд платы с поиском.
- Настройки приложения -- выбор цветовой темы (светлая / темная, зеленый / синий акцент).
Приложение поддерживает несколько одновременных подключений: каждое соединение открывается в отдельной вкладке.
Подключение к плате
Во вкладке соединения выберите параметры:
| Параметр | Значение по умолчанию |
|---|---|
| Port | (первый доступный) |
| Baud rate | 115200 |
| Data bits | 8 |
| Stop bits | 1 |
| Parity | None |
| Flow control | None |
Нажмите OK для подключения. Кнопка Обновить порты обновляет список доступных COM-портов.
Панель управления
После подключения открывается панель с двумя режимами работы:
Базовый режим
В базовом режиме доступны встроенные секции, организованные в сворачиваемые группы:
| Секция | Описание |
|---|---|
| Обновление прошивки | Загрузка файла и OTA-обновление с прогрессом |
| Тест цвета | Управление светодиодами и режимами подсветки |
| Тест ввода | Мониторинг входов, джойстик, калибровка, ADC |
| Тест оплаты и призов | Монетоприёмник, хоппер, автовыдача призов |
PRO-режим
Переключатель «PRO» открывает доступ к расширенным диалогам:
| Действие | Описание |
|---|---|
| Handshake (Авторизация) | AES-256 авторизация на плате (если требуется) |
| Тест ввода | Мониторинг состояния входов в реальном времени |
| Тест подсветки | Управление светодиодами и режимами подсветки |
| Тест силовых выходов | Включение/выключение силовых выходов |
| Обновление прошивки | Загрузка файла прошивки на плату |
| Задание роли | Назначение роли платы |
| Ввод команд | Терминал для отправки произвольных команд вручную |
Статус подключения
Индикатор в заголовке вкладки отображает текущее состояние:
- Красный — нет связи.
- Желтый — подключено, требуется авторизация.
- Зеленый — подключено, плата готова к работе.
Кнопка переподключения (↻) позволяет быстро восстановить связь при обрыве. Перед запуском OTA и после успешного обновления приложение автоматически выполняет полную AES-256 авторизацию платы. В терминале команд доступна отдельная кнопка ручной авторизации.
Файлы данных
Рядом с EXE (или в корне проекта при запуске из исходников) могут располагаться папки с конфигурациями:
| Папка | Расширение | Назначение |
|---|---|---|
light_modes/ |
.lm |
Режимы подсветки (формат TOML) |
input_mappings/ |
.mapping |
Маппинги входов по играм (формат TOML) |
commands/ |
.csv |
Наборы команд платы (разделитель ;) |
Эти файлы располагаются рядом с EXE (или в корне проекта при запуске из
исходников). При сборке они автоматически копируются в папку dist/ рядом с
EXE. Можно редактировать файлы конфигураций без пересборки — достаточно
изменить нужный файл и перезапустить приложение.
Настройки
Настройки хранятся в settings.json рядом с EXE. Файл создается автоматически.
Доступные параметры (изменяются через диалог в приложении):
| Параметр | Значения | По умолчанию |
|---|---|---|
| Тема | Светлая / Тёмная | Светлая |
| Акцент | Зелёный / Синий | Зелёный |
| Проверка состояния платы | Вкл / Выкл | Выкл |
| Интервал проверки | 5–60 сек | 10 сек |
Документация для разработчиков
- DEVELOPMENT.md -- настройка окружения, структура проекта, запуск из исходников.
- BUILD_EXE.md -- сборка EXE-файла через PyInstaller.
- Система команд платы v2.x.md -- описание протокола и команд платы.