MS-Agent или Агент - это прошивка для камер со встроенным ПО, которая используется для подключения камер к сервису из сетей без статического IP-адреса. Использование Агента максимально упростит подключение - достаточно выполнить предварительную подготовку самой камеры, после чего её сразу же можно подключить в Личном Кабинете сервиса.
Установка Агента невозможна без обновления прошивки камеры. Для установки прошивки со встроенным Агентом нужно определить модель платы и версию прошивки, установленной в камере. Модель платы можно узнать в документации к камере (указывают не все производители и вендоры), или обратившись к производителю / вендору напрямую.
ВНИМАНИЕ!
Установка прошивки с Агентом на неподходящую плату или сбой при установке (пропало интернет-соединение, отключение электроэнергии, завис компьютер и т.д.) могут повлечь поломку как платы, так и камеры в целом. Перед началом установки прошивки обязательно ознакомьтесь со списком поддерживаемых плат и проверьте, совпадают ли спецификации. В случае поломки платы или камеры сервис ответственности не несет.
В случае, если интеграция прошивки с Агентом невозможна для вашей камеры, можно воспользоваться ретранслятором MS-Gate, он также предназначен для подключения к сервису камер из сетей без статического IP-адреса.
MS-Agent v.1 - первая версия прошивки с базовым функционалом передачи видео- и аудиопотоков. На текущий момент может быть неактуальна по причине того, что платы, для которых разрабатывалась прошивка, были сняты производителем с производства. Прошивка первой версии предлагается к использованию "как есть", дальнейшая работа над ней прекращена.
MS-Agent v.2 - актуальная версия прошивки с полным функционалом приема видеопотоков и поддержкой авторизации, разработанная для актуальных плат, имеющих поддержку производителя в долгосрочной перспективе.
Список поддерживаемых плат и готовых камер от производителей
Работа камеры с установленным паролем на камере с прошивкой MS-Agent v.2 поддерживается только на стримере с версией от 5.4.25 nightly и выше. Для установки обновленной версии стримера ознакомьтесь с инструкцией или обратитесь в службу технической поддержки.
Внимание! Определить версию прошивки для платфомы ХМ можно через web-интерфейс камеры (пункт меню "Версия", строка "Системная версия"). В строке с версией есть запись вида: V4.02.R12.ХХХХХХХХ.10010.1407 - сегмент ХХХХХХХХ - это и есть искомая версия
Далее представлен список производителей и моделей камер, подходящих для установки прошивки с Агентом.
ВНИМАНИЕ!
Обязательно проверяйте (запрашивайте у производителя перед покупкой) версию прошивки! Производители могут изменять технические характеристики устройств и, в лучшем случае, вы можете получить неподходящую камеру, а в худшем - установка неподходящей прошивки может повлечь неисправность камеры.
ЕС "Мой Двор" не несет ответственности за возможные неисправности камер и иных устройств, если выполнялась установка заведомо несовместимой версии прошивки.
В списке присутствуют камеры, поддерживающие разрешение более 2 mpx. Прошивка с агентом оптимизирована для работы именно в режиме 2 mpx. Обратите на это особое внимание, т.к. при выборе более высокого разрешения, работа агента может быть нестабильной.
Если камера не из этого списка и Вам неизвестны ее характеристики, необходимо выполнить следующие действия:
Узнайте, кто производитель камеры. Обратившись к производителю, уточните у него, на базе какой платформы работает камера
Если платформа есть в списке поддерживаемых, уточните у производителя модель платы, процессора и сенсора
Перейдя в web-интерфейс камеры или получив доступ к настройкам через ПО от производителя, посмотрите версию прошивки
Если все параметры: платформа, модель платы, модель процессора, сенсора и версия прошивки совпадают со списком поддерживаемых, Вы можете установить прошивку c Агентом.
Установка прошивки выполняется стандартным способом. Рассмотрим на примере платы HI3516EV300_83H50AI:
Подключите камеру в локальной сети с ПК и зайдите в ее стандарный web-интерфейс или используя специализированное ПО от производителя, если в нём есть возможность обновления прошивки (подробно о вариантах доступа к настройкам и учетным данным (логин и пароль) для вашей камеры, если они вам неизвестны, нужно уточнить в инструкции производителя или обратившись к производителю напрямую)
Перейдите в меню Версия и проверьте версию прошивки, она должна соответствовать 000589C9
Чтобы камеры с агентом могли подключится к серверу нужно:
Проверить службу vtun командой
systemctl status vtund_ipcam.service
Если служба активна и работает, то переходим ко второму пункту.
Если нет, то требуется обновить стример командой
curl -sSfL http://get.dvor24.com/ms/download/install.sh | sudo sh
Сделать доступным для входящих подключений порт 5000 для сервера (проброс порта и/или настройка межсетевого экрана).Если так получилось, что внешний (доступный из интернета) порт вам необходимо изменить на другой, то нужно его также изменить в карточке сервера в личном кабинете на cloud.dvor24.com
После установки прошивки с Агентом, при первом подключениии камеры к сети Интернет, будет сгенерирован уникальный ID (UUID), он используется для связи с удаленным сервером и передачи видеопотока на сервер.
Процесс присвоения UUID:
Выполните сетевые настройки на камере в ее стандарном web-интерфейсе для доступа к интернет-соединению. Этот пункт обязателен, т.к. в противном случае подключить камеру к сервису будет невозможно.
ВНИМАНИЕ!
Некоторые камеры получают сетевые настройки по DHCP автоматически. В этом случае, если адрес камеры в сети не имеет значения, можно сразу же переходить к следующему пункту.
После выполнения сетевых настроек перезагрузите камеру любым доступным способом (через меню настроек камеры или по питанию).
Скопируйте UUID камеры, он указан на странице: local_cam_ip/uuid.html (параметр local_cam_ip - замените на локальный IP-адрес вашей камеры). Если IP-адрес был присвоен по DHCP, воспользуйтесь стандартными средствами поиска камеры в сети, подходящими под вашу модель.
Подключение камеры к облачному сервису:
Выполните настройку стримера и роутера по инструкции под спойлером ниже.
Отредактируйте файлы конфигурации и выполните проброс rtsp-порта:
По пути: /opt/main-streamer/ms.conf Измените параметр "rtsp_output": { "enabled": "false" на значение "true"
После изменения файла конфигурации выполните рестарт службы стримера:
sudo service main-streamer restart
По пути: /opt/main-streamer/programms/rtsp-simple-server/rtsp-simple-server.yml Проверьте, что указанный в файле порт совпадает с портом, указанным выше.
rtsp-simple-server.yml
"rtspAddress": "8554"
Выполните проброс порта 8554 в роутере (порт устанавливается по умолчанию и может быть изменен, в случае изменения его надо поменять и в конфигурационных файлах).
Выполните проброс порта 5000 (при использовании прошивки MS-Agent v.2). Порт используется по умолчанию, доступен для изменения в настройках карточки сервера в Личном Кабинете.
Перейдите в ваш Личный Кабинет сервиса
Перейдите в карточку сервера на который будет добавлена камера и убедитесь, что в поле RTSP-порт указан тот же порт, что и в конфигурационных файлах стримера (п.4)
Откройте добавление новой камеры
Выберите добавление камеры со встроенным агентом - MS-Agent
Внесите ранее скопированный UUID камеры
Завершите добавление камеры с указанием всех требуемых параметров (с помощью того же алгоритма, что при подключении обычной новой камеры)
Готово. В течение пары минут камера будет инициализирована и доступна для просмотра.
ВНИМАНИЕ!
Камеры с прошивкой MS-Agent предназначены для подключения из удаленно расположенной сети. Если подключить камеру с прошивкой локально, используя один и тот же шлюз, что и сервер, для доступа к сети Интернет, возможны проблемы с получением видеопотока для трансляции.
После подключения камеры к сервису в настройках будет доступно удаленное управление состоянием камеры: кнопки RESET и REBOOT:
RESET - выполняет удаленный сброс настроек качества, детекции движения и т.д., с последующим переподключением к серверу. UUID и сетевые настройки камеры сохраняются.
REBOOT - выполняет перезагрузку камеры без сброса настроек.
При использовании прошивки MS-Agent предварительная настройка камер для детекции движения не требуется, так как в прошивке детекция уже включена по умолчнанию, по протоколу TCP.
Прошивка была протестирована и подготовлена для работы с определенными параметрами качества изображения:
Разрешение - 2 mpx (FullHD, 1920x1080) или ниже
Битрейт - не более 3 mbit/sec. или меньше, тип битрейта - CBR
При использовании параметров, отличающихся в большую сторону от рекомендованных (более высокое разрешение или битрейт), все настройки производятся на ваш риск, корректная работа камеры не гарантируется.
Обратите внимание:
Во избежание проблем с трансляцией рекомендуется забирать поток с камеры не более двух раз. Например, ссылка на поток может быть добавлена в сервис и на регистратор. В случае, если запись потока ведется на большее количество устройств, могут проявляться проблемы (фризы, артефакты изображения), к которым сервис отношения не имеет.