Troubleshooting

Что проверить, если что-то не работает. Команды выполняются на устройстве по SSH (Vidicap Touch 2.0) или в терминале (Vidicap Touch 1.0). Логи можно получить и не подходя к устройству: на платформе «Журнал и логи устройства» → «Запросить логи».

Установка Vidicap Touch 2.0 остановилась

Повторный запуск установщика безопасен: он ставит программу заново и сохраняет настройки.

Нет видео

v4l2-ctl --list-devices          # видны ли входы платы захвата
lsmod | grep -i -e mz0380 -e v4l2loopback
journalctl -u vidicap-kiosk -n 100 --no-pager

• Плата MZ0380 на Vidicap Touch 2.0: её драйвер собран под ядро 5.0.0-37 Vidicap Touch 1.0. На Ubuntu 24.04 нужен драйвер под текущее ядро от производителя платы или плата с драйвером в ядре (USB / UVC) — в мастере выберите «драйвер в ядре».
• Неверный вход или вход не тот: «Настройки» → «Видеовходы» (Touch 2.0 2.49.0+, Touch 1.0 1.44.0+): включите нужный, поставьте его первым, «Применить». Подробно: инструкция «Видеовходы: от одного до четырёх». Вручную на Touch 2.0: detect = false и [[video.inputs]] в /etc/vidicap/config.toml, затем sudo systemctl restart vidicap-kiosk.
• Vidicap Touch 1.0 (программа 1.9.0 и новее): пропавшее видео со входа запускается снова само. Если картинки нет дольше минуты, посмотрите tail ~/.cache/vidicap/video.log: частые строки «остановился» значат, что на входе нет сигнала или неисправен кабель.
• Vidicap Touch 1.0 (программа 1.11.0 и новее): трансляцию раздаёт MediaMTX. Если на платформе нет видео при включённой трансляции, проверьте grep "сервер трансляции" ~/.cache/vidicap/video.log и перезагрузите устройство; вернуть прежний ffserver — раздел «Сервер трансляции MediaMTX» инструкции Vidicap Touch 1.0.

Нет связи с платформой

vidicap-agent status             # к какой точке подключено, последняя связь (секрет не показывается)
journalctl -u vidicap-agent -n 100 --no-pager
cat /home/vidicap/.local/share/vidicap-agent/agent.log

• «нет связи с сервером»: проверьте сеть и доступ из больницы к vidicap.cloud (порты 443/TCP, 8890/UDP для Vidicap Touch 2.0, 8322/TCP для Vidicap Touch 1.0).
• «server no longer knows this device»: устройство отключили на платформе — подключите заново кодом.
• Трансляция не идёт на платформу: она должна быть запущена на самом устройстве; ошибка видна в «Платформа» / Настройки → Платформа и в журнале устройства на сайте.

Без сети: журнал для поддержки и обновление с флешки

Агент 1.97.0 и новее, Vidicap Touch 2.0 2.116.0 и новее: в «Платформа» (Touch 1.0) и в Настройки → Платформа (Touch 2.0) под причиной «нет связи» есть два блока.

Журнал для поддержки — когда связь пропадает время от времени или не работает ИИ на Vidicap AI Server:

1. Перед тестом нажмите «Начать запись». Каждые 10 секунд записывается строка: сеть и адрес, шлюз, связь с платформой и причина, Vidicap AI Server каждого модуля ИИ.
2. Проведите тест как обычно. Запись идёт и после перезагрузки, через 12 часов останавливается сама.
3. Вставьте флешку и нажмите «Остановить и сохранить на флешку». На флешке появится vidicap-log-ДАТА-ВРЕМЯ.tgz: журнал программы, строки записи, настройки модулей ИИ, системный журнал. Секрет устройства и имена папок пациентов в архив не попадают.
4. Пришлите архив в поддержку. «Сохранить журнал сейчас» сохраняет то же без записи.

Обновление с флешки — когда платформа недоступна:

1. На платформе с любого компьютера: «Выпуски для устройств», скачайте архивы (vidicap-legacy-….zip и vidicap-rev1-….zip для Touch 1.0, vidicap2-….tar.gz для Touch 2.0) и запишите их на флешку в корень или в одну папку.
2. Вставьте флешку в Vidicap. В блоке «Обновление с флешки» видны версии на устройстве и на флешке.
3. «Установить с флешки», затем подтвердите. Touch 1.0: после установки «Перезагрузить». Touch 2.0: установка 10–30 минут, потом устройство перезагрузится само; не во время трансляции.

Интерфейс не запускается (Vidicap Touch 2.0)

systemctl status vidicap-kiosk
journalctl -u vidicap-kiosk -b --no-pager | tail -50

Частая причина — ошибка в /etc/vidicap/config.toml: в журнале будет строка config: … — using defaults с указанием неверной опции.

Vidicap Touch 1.0: нет кнопки «Платформа»

grep -n "vidicap platform add-on" ~/Vidicap_Touch/VidicapTouch.py   # блок на месте?
systemctl status vidicap-agent

• Нет блока — повторите install-addon.sh.
• В выводе программы platform add-on not loaded: … — причина в этой строке; программа при этом работает как раньше.

Vidicap Touch 1.0: интерфейс не по размеру экрана

Признаки: справа торчит край другой страницы (с ползунком), снизу видна надпись «Vidicap Tech Inc.», или верхняя панель уходит за край и надписи обрезаны. Старая программа нарисована под 1920×1080 без дока и верхней панели Ubuntu. С кнопкой «Платформа» 1.3.2 и новее она раскладывается на весь экран и масштабируется под монитор сама.

vidicap-agent --version                                      # 1.3.2 или новее
grep -c "vidicap screen fit" ~/Vidicap_Touch/VidicapTouch.py   # больше 0: блок подгонки на месте
xrandr --current | head -1                                   # размер экрана: current 1920 x 1080

• Версия ниже или блока нет — обновите кнопку «Платформа» (install-addon.sh) и перезагрузите.
• В выводе программы screen fit not applied: … — причина в этой строке; программа работает как раньше.
• Масштаб вручную: "screen_fit": 0.75 в /opt/vidicap/addon/config.json ("off" — без масштаба); "fill_screen": false — раскладка как раньше, по рабочей области. Затем перезапуск.

Нет связи со светом или столом

Это дополнительные модули — причины и что делать: инструкции «Хирургический свет» и «Хирургический стол», раздел «Неполадки».

Сменить язык без экрана

• Vidicap Touch 2.0: [ui] language = "en" в /etc/vidicap/config.toml действует, пока язык не выбран на устройстве; выбранный на устройстве хранится в /home/vidicap/.config/Vidicap/VidicapTouch.conf ([ui] language=…).
• Vidicap Touch 1.0: "language": "en" в /opt/vidicap/addon/config.json, затем перезапуск программы.

← Site languages and the visitor's country Platform server →