Видеовходы: от одного до четырёх

Видеовходы: от одного до четырёх

Vidicap сам находит входы на плате захвата, до четырёх: USB-граббер, плата PCIe с несколькими входами, USB-камера зала. Техник даёт входам понятные имена («Эндоскоп», «Камера зала»), ставит их по порядку и выключает лишние. Врач на экране «Видео» (раньше «Архивация» и «Трансляция») выбирает основной вход и, если входов три или четыре, вход для картинки в картинке.

Обе обновляются с экрана: «Платформа» → «Проверить обновления». После обновления перезагрузите Vidicap: виртуальные копии входов переезжают на новые номера только после перезагрузки.

Устройство с двумя входами после обновления выглядит как раньше: те же две кнопки «SDI 1» и «SDI 2», картинка в картинке показывает второй вход.

Подключение на ходу (Vidicap Touch 2.0)

С версии 2.60.0 Vidicap Touch 2.0 подхватывает входы сам, пока работает. Перезагрузка и «Найти заново» не нужны.

1. Подключите граббер или камеру к Vidicap. Через пару секунд внизу экрана появится подсказка «Подключён видеовход SDI 3 (модель)».
2. На экране «Видео» появится новая кнопка с меткой «НОВЫЙ». Ею сразу можно пользоваться.
3. Запись и трансляция при этом не прерываются: работающие входы не перезапускаются.
4. Чтобы дать входу имя, откройте «Настройки» → «Видеовходы». После выхода из этого экрана метка «НОВЫЙ» пропадает.

Новый вход встаёт после уже работающих и сохраняет своё место после перезагрузки. Вход, который техник выключил в «Видеовходах», при подключении остаётся выключенным. Если работают уже четыре входа, пятый виден в «Видеовходах», но не используется: выключите лишний вход и нажмите «Применить».

Если вход выдернуть, его кнопка остаётся на месте с надписью «нет сигнала», и номера остальных входов не сдвигаются. Воткните его обратно (в тот же разъём), и через пару секунд картинка вернётся сама. Убрать такой вход из кнопок врача: «Видеовходы» → «Применить» или перезагрузка.

Плата, драйвер которой загрузился позже программы, тоже подхватывается сама: Vidicap перестаёт использовать входы из файла настроек и переходит на входы платы.

Vidicap Touch 1.0: подключение на ходу недоступно. Эти устройства обновляются только с готовых устройств с той же платой, новое оборудование к ним не подключают. Входы Touch 1.0 находит сам при включении, как и раньше: после подключения новой платы перезагрузите Vidicap.

Какие платы подходят

Любая плата или камера, которую Linux видит как устройство видеозахвата (V4L2): USB 3.0 грабберы UVC (драйвер не нужен), USB-камеры (AVer CAM520 Pro3 и подобные), платы PCIe с драйвером V4L2 (MZ0380, TC-750N4, TC-410N4 и другие). Проверить, что видит система: v4l2-ctl --list-devices.

Vidicap не считает входами: - служебные узлы USB-грабберов (метаданные: у каждого USB-входа их два, видео идёт только по первому); - кодеки видеокарты; - собственные виртуальные копии входов (/dev/video20…27).

У платы MZ0380 (Vidicap Touch 1.0) на каждый вход два узла. Входами сразу включаются /dev/video0 и /dev/video2, как было; остальные узлы видны в списке выключенными.

Настройка: «Настройки» → «Видеовходы»

1. В главном меню нажмите «Настройки». Если включён вход по RFID-меткам, приложите метку техника.
2. Слева, в группе «Изображение», нажмите «Видеовходы». Справа список всего, что найдено на плате: имя, модель платы или камеры и устройство (/dev/videoN).
3. Имя: нажмите «Имя» у входа и введите название, например «Эндоскоп». Его видят врачи на кнопках входов и в подписи на экране. Пустое имя — «SDI 1», «SDI 2»… по порядку.
4. Порядок: кнопки «↑» и «↓». Первый вход в списке открывается на экранах записи и трансляции по умолчанию.
5. Вкл. / Выкл.: выключите вход, к которому ничего не подключено. Выключенный вход не показывается врачам и не нагружает процессор. Хотя бы один вход остаётся включённым.
6. Нажмите «Применить». Копирование входов перезапускается за пару секунд, кнопки на экранах записи и трансляции сразу обновляются.

«Найти заново» перечитывает плату, например после подключения ещё одной камеры.

Зелёная точка — вход найден сейчас. Жёлтая — вход был назван раньше, но сейчас не найден: проверьте кабель и плату. Имя такого входа не теряется: когда вход появится, он займёт своё место в списке.

Пока идёт запись или трансляция, входы изменить нельзя: кнопки неактивны, на экране подсказка.

Имена и порядок запоминаются по разъёму, к которому подключён вход, а не по номеру /dev/videoN. Номер может поменяться после перезагрузки, а «Эндоскоп» останется эндоскопом.

Настройка входа: разъём и картинка

У каждого входа платы захвата в «Видеовходах» есть кнопка «Настройка». Она открывает настройки самого драйвера платы: какой разъём платы использовать и какой будет картинка. Окно ничего не знает о плате заранее: оно показывает то, что отдаёт драйвер именно этой платы. На другой плате набор будет другим.

1. Откройте «Настройки» → «Видеовходы» и нажмите «Настройка» у нужного входа.
2. Источник сигнала (разъём платы). Кнопки разъёмов, которые есть у платы. У YUAN SC5C0 (MZ0380) это HDMI, DVI-D, компонент (YPbPr), DVI-A (VGA), SDI, композит и S-Video. Точка ● у кнопки — на этом разъёме сейчас есть сигнал. При смене разъёма вход перезапускается на секунду-две. Пока идёт запись или трансляция, разъём сменить нельзя. Если у платы один разъём, этой строки нет.
3. Картинка. Ползунки и переключатели драйвера: яркость, контраст, насыщенность, оттенок, резкость, автоусиление и усиление (у MZ0380). Картинка меняется сразу и видна справа в окне, в том числе во время записи. Усиление можно двигать, только когда автоусиление выключено.
4. «Сбросить к заводским» возвращает значения самого драйвера (у MZ0380 контраст 100, резкость 16, усиление 120). Выбранный разъём остаётся.
5. Нажмите «Готово».

Настройки хранятся на Vidicap для этого входа (по разъёму, как имена) и ставятся заново при каждом запуске: драйвер MZ0380 после перезагрузки их забывает. Запись и трансляция идут с уже настроенной картинкой. У потока из сети кнопка неактивна: его картинку настраивают в самой камере. Если драйвер не даёт никаких настроек, окно так и пишет.

Для инженера: окно спрашивает драйвер так же, как v4l2-ctl -d /dev/video0 --list-inputs --list-ctrls-menus, и меняет так же, как v4l2-ctl -i N и v4l2-ctl -c brightness=140. Сохранённое лежит в ~/.config/vidicap/inputs-tune.json.

Поток из сети (IP-камера)

Входом может быть и видеопоток IP-камеры по сети (RTSP), например поворотной камеры зала. Он занимает одно из четырёх мест, как плата захвата, и его можно записывать, транслировать и ставить в угол кадра.

1. Узнайте адрес потока камеры. Он есть в инструкции камеры, например rtsp://admin:пароль@192.168.0.100/stream1. Если стоит модуль «Управление камерой», адрес находит кнопка «Найти в сети» в «Настройки» → «Управление камерой».
2. Откройте «Настройки» → «Видеовходы» и нажмите «+ Поток из сети (IP-камера)».
3. Впишите имя («Поворотная камера») и адрес. Адрес начинается с rtsp://, rtsps://, http://, https:// или srt://; неверный адрес подсвечивается красным.
4. Нажмите «Добавить», затем «Применить». Через несколько секунд вход появится на экране «Видео».

Чтобы поменять адрес или убрать поток, нажмите «Изменить» у его строки. Пароль из адреса на экране и в журналах заменяется звёздочками.

Если связь с камерой пропала, Vidicap переподключается сам. Камера должна быть в той же сети, что и Vidicap; поток берётся по TCP.

На Vidicap Touch 1.0 каждый поток из сети распаковывается процессором. Берите поток камеры с разрешением не выше 1920×1080 и проверьте нагрузку в «Проверка Vidicap».

Модуль «Управление камерой»: выберите в его настройках «Вход Vidicap» и номер этого входа. Тогда поток камеры открывается один раз, и для записи, и для пульта камеры.

Запись и трансляция

1. Откройте «Видео».
2. В карточке «Видеовходы» выберите основной вход (кнопку удерживайте полсекунды, как и раньше).
3. Чтобы добавить второй вход в угол кадра, включите «PIP ВКЛ.» в карточке «Доп. управление».
4. Если входов три или четыре, под «PIP ВКЛ.» появятся кнопки остальных входов: выберите, какой из них будет в углу. Основной вход здесь не показывается.

Если выбрать основным вход, который сейчас в углу, они меняются местами. Угол и размер малого окна задаются как раньше: «Настройки» → «Картинка в картинке».

На Vidicap Touch 1.0 при четырёх входах кнопки стоят в два столбца.

Драйверы: проверяются и собираются сами

Чтобы входы работали, нужны два драйвера ядра Linux: - драйвер видеокопий входов (v4l2loopback): делает копии /dev/video20…27, с которых пишут, транслируют и считает ИИ; - драйвер платы захвата YUAN SC5C0 (MZ0380), если такая плата стоит.

При каждом запуске Vidicap служба vidicap-drivers проверяет оба драйвера под текущее ядро, ещё до открытия программы: - Видеокопии. На Vidicap Touch 1.0 нет готового пакета, поэтому драйвер собирается на самом устройстве из исходников версии 0.12.7, которые лежат в выпуске программы. Заголовки ядра 5.0.0-37 для сборки тоже лежат в выпуске, интернет не нужен. Собранный драйвер ставится поверх прежнего, собранного вручную. После смены ядра он собирается заново сам. На Vidicap Touch 2.0 драйвер ставится из пакетов Ubuntu (v4l2loopback-dkms) и пересобирается системой. - Плата YUAN SC5C0. Производитель дал только готовый файл драйвера под ядро 5.0.0-37, без исходников, поэтому собрать его под другое ядро нельзя. Служба возвращает его на место, если он пропал, и закрепляет ядро 5.0.0-37, чтобы обновления Ubuntu его не сменили. На другом ядре она пишет, что драйвера нет.

Результат виден внизу страницы «Настройки» → «Видеовходы»: зелёная точка — работает, жёлтая — нет, с причиной. То же видно на платформе: «Устройства» → устройство → «Журнал», строка «Драйверы». Журнал сборки попадает в «Журнал для поддержки» и в логи, которые запрашивают с платформы.

Установить на работающий Vidicap Touch 1.0 (один раз)

Новые установки (install-rev1.sh) ставят службу сами. На уже работающем Touch 1.0 её один раз ставит техник: 1. Скачайте на платформе в «Выпуски для устройств» архив программы Touch 1.0 vidicap-rev1-1.78.0.zip (или новее) на флешку. 2. На Vidicap откройте терминал («Настройки» → «Сеть и версия» → «Терминал», уровень доступа техника) и распакуйте архив: cd ~ && unzip -o /media/<флешка>/vidicap-rev1-1.78.0.zip. 3. Выполните sudo bash ~/vidicap-rev1/drivers/install-drivers.sh. Скрипт сразу соберёт драйвер (около минуты) и покажет итог. 4. Перезагрузите Vidicap: sudo reboot.

Проверить вручную: vidicap-drivers status. Собрать заново: sudo vidicap-drivers check. Журнал сборки: /var/log/vidicap-drivers.log.

Модули

Модули «ИИ-эндоскопия», «VR (тест)» и «Вывод видео» (второй монитор) сами видят все включённые входы и их имена. Отдельно настраивать их не нужно.

Как это устроено (для инженера)

На каждый вход работает один процесс ffmpeg. Он копирует сигнал платы в две виртуальные копии (v4l2loopback):

Номера начинаются с 20, чтобы третий и четвёртый вход платы их не заняли. Раньше копии были на /dev/video10…13 (Touch 2.0) и /dev/video4…7 (Touch 1.0): установщик Touch 2.0 сам переносит их в /etc/vidicap/config.toml.

Где хранятся настройки входов: ~/.config/vidicap/inputs.json пользователя программы. Какие входы копируются сейчас (имя и копии), программа пишет в ~/.local/state/vidicap/inputs-now.json: по нему модули берут только работающие входы. Сведений о пациенте в этих файлах нет. Поток из сети хранится в inputs.json строкой с ключом net:N и полем url; ffmpeg берёт его по RTSP/TCP (-rtsp_transport tcp, тайм-аут 5 с) и копирует в те же виртуальные копии, а при обрыве перезапускается.

Vidicap Touch 2.0: чтобы задать входы вручную, в /etc/vidicap/config.toml поставьте detect = false в разделе [video] и перечислите входы блоками [[video.inputs]]. Эти же блоки используются, если на плате ничего не найдено.

Неполадки

← Settings on the Vidicap screen On-screen training on Vidicap →