Инструкция по установке и применению

Установка программного комплекса «Контур 2.0» выполняется на предварительно настроенный одноплатный компьютер Raspberry Pi с установленной ОС Raspbian (Debian 12 Bookworm, aarch64). Поставка осуществляется в виде deb-пакета contour_X.Y.Z_arm64.deb.

3.1. Предварительная настройка Raspbian

1. Включение композитного видеовыхода

   Отредактируйте /boot/firmware/config.txt: отключите HDMI (hdmi_ignore_hotplug=1), включите композитный выход через оверлей dtoverlay=vc4-kms-v3d,composite, установите 64-битный режим (arm_64bit=1).

2. Настройка параметров ядра

   В /boot/firmware/cmdline.txt добавьте параметр video=Composite-1:720x576i,tv_mode=PAL для принудительного режима PAL.

3. Установка системных зависимостей

   Выполните:

   sudo apt update && sudo apt install -y \
     libyaml-cpp0.8 libqt6widgets6 \
     libopencv-core410 libopencv-imgproc410 \
     libopencv-features2d410 libopencv-calib3d410 \
     libopencv-videoio410 libopencv-highgui410 \
     libevent-pthreads-2.1-7 \
     xorg xinit unclutter

4. Настройка X11

   Создайте /etc/X11/xorg.conf с драйвером fbdev на устройстве /dev/fb0. Настройте .xinitrc для отключения гашения экрана и скрытия курсора.

5. Настройка автозапуска

   Установите multi-user.target как цель по умолчанию. Настройте systemd-сервис для автоматического запуска X-сессии с приложением при загрузке.

3.2. Установка deb-пакета

1. Копирование пакета

   Скопируйте файл contour_X.Y.Z_arm64.deb на Raspberry Pi (например, через SCP):

   scp contour_X.Y.Z_arm64.deb pi@192.168.1.X:/tmp/

2. Установка пакета

   На Raspberry Pi выполните:

   sudo dpkg -i /tmp/contour_X.Y.Z_arm64.deb
   Выбор ранее не выбранного пакета contour.
   (Чтение базы данных … на данный момент установлено N файлов и каталогов.)
   Подготовка к распаковке /tmp/contour_X.Y.Z_arm64.deb…
   Распаковывается contour (X.Y.Z) …
   Настраивается пакет contour (X.Y.Z) …

   Пакет устанавливает исполняемый файл /opt/contour/contour_highlighter и файл конфигурации /opt/contour/config.yaml.

3. Включение и запуск сервиса

   sudo systemctl enable contour.service
   sudo systemctl start contour.service
   sudo systemctl status contour.service

3.3. Применение

После запуска сервиса приложение автоматически открывает USB-камеру, начинает обработку видеопотока в реальном времени и выводит результат на аналоговый монитор через композитный выход PAL. Движущиеся объекты подсвечиваются синими контурами и зелёными ограничивающими рамками.

Настройка параметров обнаружения выполняется редактированием файла /opt/contour/config.yaml. Доступные параметры:

После изменения конфигурации перезапустите сервис: sudo systemctl restart contour.service.