Что такое PrimeCast

PrimeCast — аппаратно-программная система защищённого удалённого просмотра видеосигнала. Аппаратный модуль принимает HDMI, кодирует видео и передаёт поток на медиареле. Пользователь получает изображение через защищённый веб-интерфейс или приложение.

Эта база знаний описывает полный жизненный цикл системы: подготовку оборудования, подключение цифрового и аналогового источника видео, первое включение модуля, настройку сети и качества трансляции, подключение клиентов, работу с аккаунтами и группами, диагностику неполадок, резервное копирование и обновление. Материал построен как практический маршрут: сначала проверяется физическое подключение, затем состояние модуля, сеть, видеозахват, доставка потока, сервер и только после этого клиентское приложение.

Важно. В примерах используются условные значения: YOUR_SERVER, PCS-XXXX-XXXX, DEVICE_PASSWORD. Никогда не публикуйте настоящие пароли, токены, SRT-парольные фразы, приватные ключи и рабочие конфигурации в Git, задачах общего доступа или публичных чатах.

Основной путь сигнала

Источник HDMI
    │
    ▼
USB HDMI-захват
    │
    ▼
Raspberry Pi + primecast-agent
    │
    │ SRT
    ▼
MediaMTX
    │
    │ WHEP / WebRTC
    ▼
Caddy + PrimeCast API
    │
    ├── Браузер
    ├── Android
    ├── Windows
    └── Linux

Путь аналогового FPV-сигнала

Аналоговая FPV-камера
    │
    ▼
Передатчик 5,8 ГГц
    │
    ▼
FPV-приёмник / монитор Hawkeye
    │ VIDEO OUT, композитный AV
    ▼
Активный конвертер AV2HDMI
    │ HDMI OUT
    ▼
HDMI-захват PrimeCast

Важно. Нужен именно активный преобразователь AV2HDMI: аналоговый AV на входе, HDMI на выходе. Устройство HDMI2AV работает в обратную сторону и для этой задачи не подходит.

Основные компоненты

Компонент	Назначение
Raspberry Pi	Управление модулем, кодирование и передача потока
USB HDMI-захват	Преобразование HDMI в видеоустройство Linux V4L2
primecast-agent	Захват, кодирование и публикация потока
primecast-osd	Экран состояния и локальное меню настроек
NetworkManager	Управление Wi‑Fi, Ethernet и мобильными профилями
MediaMTX	Приём SRT и выдача WebRTC/WHEP или HLS
PrimeCast API	Аутентификация, роли, группы, устройства и медиадоступ
Caddy	HTTPS, защитные заголовки и маршрутизация запросов
Web/Android/Desktop	Пользовательские клиенты

Эталонный аппаратный модуль

Проверенная конфигурация на момент подготовки документации:

• Raspberry Pi 4 Model B;
• Debian 12 Bookworm, 64-bit;
• USB UVC HDMI-захват;
• TFT 320×240 на контроллере ILI9342/ILI9341;
• сенсор XPT2046;
• пятикнопочный джойстик;
• Wi‑Fi и Ethernet;
• поддержка сохранённых профилей мобильного модема;
• MediaMTX 1.19.1;
• агент PrimeCast 0.1.0-dev.

Версии конкретного устройства всегда проверяются командами из раздела Диагностика модуля по SSH, а не определяются по внешнему виду корпуса.

Роли

Пользователь

Пользователь может:

• войти в выданный аккаунт;
• изменить собственный пароль;
• открыть доступную ему группу;
• подключиться к разрешённому устройству;
• смотреть трансляцию;
• пользоваться чатом и голосовым каналом;
• сообщить IT-специалисту точное состояние, показанное модулем.

Пользователь не должен изменять Linux-конфигурацию, системные службы, сертификаты или параметры медиареле.

Модератор компании

Модератор — IT-специалист организации, использующей PrimeCast. Он может:

• создавать и удалять группы своей компании;
• добавлять устройства в группы;
• выдавать доступ пользователям;
• создавать пользовательские аккаунты;
• сбрасывать временные пароли;
• проверять локальную сеть и физическое подключение;
• собирать диагностические данные;
• передавать инцидент системному администратору PrimeCast.

Системный администратор PrimeCast

Системный администратор — специалист технической поддержки PrimeCast. Он имеет наибольший уровень доступа и отвечает за:

• регистрацию и подготовку аппаратных модулей;
• сервер платформы и медиареле;
• системные аккаунты и модераторов компаний;
• сертификаты и ключи;
• обновление агента, OSD и клиентов;
• резервное копирование;
• восстановление после сбоев;
• расследование инцидентов безопасности.

Внутренние идентификаторы ролей

Роль в документации	Внутренний идентификатор	Назначение
Системный администратор	admin	Полное администрирование платформы
Модератор компании	manager	Управление пользователями и группами компании
Пользователь	user	Просмотр и совместная работа

В отдельных версиях интерфейса manager может отображаться как «Руководитель». Для технической поддержки это та же роль модератора компании.

Три типа учётных данных

В PrimeCast есть несколько независимых наборов данных доступа. Их нельзя смешивать.

Тип доступа	Что вводится	Где используется
Аккаунт платформы	Имя пользователя и пароль	Вход в приложение PrimeCast
Доступ к устройству	Номер/ключ вида PCS-… и пароль устройства	Просмотр конкретной трансляции
Технический доступ	Linux-пользователь и SSH-пароль/ключ	Обслуживание Raspberry Pi

Аккаунт платформы выдаётся администрацией. При первом входе пользователь может быть обязан заменить временный пароль.

Ключ устройства идентифицирует конкретный аппаратный модуль, а пароль устройства разрешает просмотр его трансляции. На эталонном устройстве они доступны через экранное меню Настройки → Доступ: там показываются IP-адрес, ключ / логин устройства и пароль для просмотра. Подробности — в разделе Доступ к устройству и трансляция.

SSH нужен только технической поддержке. SSH-пароль не является паролем трансляции и не должен передаваться обычному пользователю.

Важно. Не используйте один и тот же пароль для аккаунта, устройства, SSH, медиареле и серверных секретов.