Документация программы «КВАНТ»

Описание функциональных характеристик программы для ЭВМ «КВАНТ» в промышленной поставке на транспортное средство.

1. Приём сигналов состояния дверей (RS-232) модулем pcrt-door-gateway и публикация состояния в канал межпроцессного обмена ipc:///run/pcrt/doors.sock.
2. Запись видео с камер дверных проёмов на время открытой двери модулем pcrt-recorder (внешний процесс FFmpeg, кодер ffv1, контейнер Matroska, файл camN.mkv).
3. Локальная обработка видеозаписи после закрытия дверей модулем pcrt-processor: нейросетевая модель OpenVINO на центральном процессоре (формат OpenVINO IR: models/model/model.xml и models/model/model.bin, архитектура семейства YOLO). Обращение к облачным службам обучения или inference третьих лиц не требуется.
4. Определение числа вошедших и вышедших пассажиров.
5. Сохранение результата (вход/выход) в очереди SQLite (типовой путь /var/lib/pcrt/sessions/outbox/results.sqlite).
6. Передача результатов в серверную систему учёта по HTTPS API модулем pcrt-uploader при наличии сети. Потеря сети не останавливает локальный подсчёт; состояние «ожидает отправки» является штатным.

Информация, необходимая для установки программного обеспечения «КВАНТ» на бортовой компьютер заказчика. Установка выполняется на компьютер архитектуры x86-64 под управлением Linux (контрольная среда — Debian 12). Пользовательский графический интерфейс не предусмотрен.

Программа поставляется в виде программного комплекта. Право использования предоставляется по лицензионному договору. Исходный код на транспортное средство не размещается.

1. Среда

Операционная система Debian 12, архитектура x86-64. Комплект размещается в каталоге /opt/pcrt на инфраструктуре заказчика.

2. Зависимости операционной системы

При ручной установке на Debian 12 (x86-64):

sudo apt-get update
sudo apt-get install -y ffmpeg libzmq5 libzmq3-dev libopencv-dev python3 python3-zmq
sudo bash scripts/install_openvino_cpu.sh
bash scripts/check_openvino.sh

Среда исполнения нейросетевых моделей: OpenVINO ветки 2025 (на контрольном стенде подтверждена версия 2025.2). Версия 2024.6 не обеспечивает совместимость с настоящей сборкой модуля подсчёта.

3. Размещение комплекта

Скопировать содержимое каталога поставки bundle/ в /opt/pcrt. После размещения в каталоге находятся исполняемые модули pcrt-door-gateway, pcrt-recorder, pcrt-processor, pcrt-uploader; модель распознавания models/model/model.xml и models/model/model.bin; файлы параметров *.env; каталог scripts/; файл сведений о выпуске RELEASE (наименование продукта «КВАНТ», кодек записи ffv1).

Сформировать файл параметров устройства /etc/pcrt/device.env.

4. Активация лицензии

Для серийной (промышленной) поставки применяется офлайн-лицензия на конкретное устройство. Облачная активация и обязательное обращение к серверам третьих лиц для запуска программы не требуются.

Лицензионный файл выпускается правообладателем на технических средствах на территории Российской Федерации (г. Набережные Челны) и передаётся заказчику в составе комплекта поставки либо отдельно по лицензионному договору.

Файл лицензии промышленного комплекта: /etc/pcrt/license.lic. Признак контроля лицензии промышленной поставки: license_enforcement=1. Активация заключается в размещении этого файла на бортовом компьютере заказчика. Постоянное подключение к сети для активации не требуется.

Учёт выданных лицензий ведёт правообладатель. Отзыв и замена файла лицензии выполняются правообладателем в рамках лицензионного договора.

5. Установка служб

Выполнить установку служб средством install_services.sh. После установки запускаются модули приёма сигналов дверей, записи, обработки и передачи результатов. Имена системных служб (buspcrt-*) сохранены по историческим причинам; официальное наименование программы — «КВАНТ».

6. Проверка кодера записи

bash /opt/pcrt/scripts/check_runtime_licenses.sh

Требуется наличие кодера ffv1. Программа не использует кодер libx264 для штатной записи.

Информация, необходимая для эксплуатации бортовой программы «КВАНТ» после установки на компьютер архитектуры x86-64 под управлением Linux (контрольная среда — Debian 12). Пользовательский графический интерфейс не предусмотрен.

Запуск и останов

Службы комплекта запускаются средствами операционной системы после установки (install_services.sh / штатная установка комплекта). Проверка, что службы активны, выполняется командами journalctl и systemctl по именам служб комплекта.

Штатный режим на транспортном средстве

1. Сигнал дверей поступает на шлюз (последовательный порт RS-232). Модуль шлюза передаёт состояние в канал межпроцессного обмена.
2. Дверь открыта — выполняется запись видео camN.mkv (кодер ffv1).
3. Все двери закрыты — сессия помещается в каталог готовых, модуль обработки выполняет локальный подсчёт вошедших и вышедших (OpenVINO на CPU).
4. Результат сохраняется в очередь SQLite (типовой путь /var/lib/pcrt/sessions/outbox/results.sqlite).
5. При наличии сети модуль передачи отправляет результаты по HTTPS API. Сервер приёма результатов для локального подсчёта не обязателен.

Как проверить, что комплект работает

Эксплуатационный признак исправной работы: появление записей входа и выхода в очереди результатов после закрытия дверей.

Отсутствие сети не останавливает локальный подсчёт. Состояние «ожидает отправки» является штатным.

Типовые неисправности

• нет подсчёта: проверить службы, журнал, наличие сессий, OpenVINO 2025.2 (bash scripts/check_openvino.sh); версия 2024.6 несовместима;
• нет записи: bash /opt/pcrt/scripts/check_runtime_licenses.sh (нужен ffv1);
• нет передачи: сеть необязательна для подсчёта; очередь копит результаты.

Исправления выпускаются правообладателем в виде нового комплекта (не путём git pull с зарубежных площадок в штатном режиме). Заказчику поставляется обновлённый программный комплект; исходный код на транспортные средства не размещается.

Поддержка

Круглосуточно, территория Российской Федерации. Техническую поддержку обеспечивает персонал правообладателя. Ответственный за организацию поддержки: генеральный директор Ахметов Ленар Тимергалиевич. Привлечение иностранного вендора как обязательного канала поддержки не требуется.

hugary.hugary45@gmail.com, +7 904 713-33-62.