Установка и эксплуатация

Развёртывание Flussonic Iris на IP-камере и порядок работы с программным обеспечением

Способ установки

Установка Flussonic Iris выполняется прошивкой IP-камеры готовым бинарным образом (iris-firmware.bin или .img), собранным под конкретную модель устройства и аппаратную платформу HiSilicon. Отдельная установка компонентов Iris на произвольную операционную систему не предусмотрена.

Состав поставки прошивки:

  • загрузчик и разметка разделов flash-памяти;
  • ядро Linux, адаптированное под SoC камеры;
  • базовая операционная система (BusyBox, системные библиотеки);
  • исполняемые файлы и конфигурация Flussonic Iris;
  • веб-интерфейс управления камерой.

Поддерживаемые устройства

Прошивка выпускается для конкретных моделей IP-камер, оснащённых процессорами HiSilicon. Образ прошивки несовместим между разными аппаратными платформами — для каждой модели камеры используется отдельная сборка.

Процедура прошивки

  1. Получить файл прошивки, соответствующий модели камеры.
  2. Подключить камеру к сети и компьютеру в соответствии с инструкцией производителя устройства.
  3. Записать образ прошивки во flash-память камеры через штатный интерфейс обновления прошивки (web-интерфейс загрузчика или UART — в зависимости от модели).
  4. Дождаться перезагрузки устройства. После успешной прошивки камера запускает Flussonic Iris автоматически.

Перед прошивкой рекомендуется сохранить резервную копию заводской прошивки камеры.

При неудачной прошивке камера может перестать загружаться. Для восстановления потребуется программатор flash-памяти и клещи (clip) для прямого подключения к SPI-микросхеме на плате камеры — без них запись образа напрямую в микросхему невозможна.

Первичная настройка после установки

После установки прошивки камера получает сетевой адрес (по DHCP или из заводских настроек) и начинает обслуживать HTTP-запросы на порту 80.

  • открыть веб-интерфейс камеры в браузере по IP-адресу устройства;
  • войти с учётными данными администратора;
  • настроить сеть, видеопотоки, пользователей и прочие параметры через веб-интерфейс или HTTP API.

Конфигурация сохраняется в файле /etc/iris/iris.conf на устройстве.

Эксплуатация

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

Загрузка и запуск программы

Программа загружается и запускается на камере автоматически:

  1. Подать электропитание на IP-камеру (PoE или штатный блок питания).
  2. Загрузчик инициализирует flash-память и запускает ядро Linux.
  3. Ядро монтирует файловую систему и выполняет стартовые скрипты, которые запускают Flussonic Iris без участия пользователя.
  4. Программа считывает конфигурацию /etc/iris/iris.conf, инициализирует сенсор и видеокодировщик, открывает сетевые порты: HTTP — 80, RTSP — 554.
  5. Убедиться в готовности программы: открыть в браузере веб-интерфейс http://<IP-адрес камеры>/ — должна отобразиться страница входа.

Управление выполнением программы

Управление выполняется командами HTTP API (стандарт PSIA) из веб-интерфейса или любой HTTP-программы, например curl. Перед выполнением команд требуется аутентификация. Формат ответов — JSON; признак успеха — "statusCode": 1, "statusString": "OK".

Аутентификация и получение сессионной cookie:

$ curl -s -c cookies -X POST \
    -d 'username=admin&password=***' \
    http://192.168.1.10/auth/login
{"resultCode": 0}

Получение сведений об устройстве и версии программы:

$ curl -s -b cookies \
    http://192.168.1.10/PSIA/System/deviceInfo
{"deviceName": "Iris", "model": "…", "firmwareVersion": "…"}

Просмотр и изменение конфигурации (GET — прочитать, PUT — заменить; применяется без перезагрузки):

$ curl -s -b cookies \
    http://192.168.1.10/PSIA/System/configurationData
{"…": "текущая конфигурация JSON…"}

$ curl -s -b cookies -X PUT \
    --data-binary @new.conf \
    http://192.168.1.10/PSIA/System/configurationData
{"requestURL": "/PSIA/System/configurationData",
 "statusCode": 1, "statusString": "OK"}

Получение видеопотока (ответ программы — поток H.264):

$ ffplay rtsp://admin:***@192.168.1.10/PSIA/streaming/channels/1

Чтение журнала работы программы:

$ curl -s -b cookies \
    http://192.168.1.10/PSIA/System/logging/messages
{"…": "записи журнала…"}

Полный перечень групп команд (конфигурация, потоки, сеть, изображение, пользователи, PTZ) приведён в разделе «Функциональные характеристики».

Завершение работы программы

  1. Завершение выполняется командой перезагрузки из веб-интерфейса или запросом GET /PSIA/System/reboot — программа корректно останавливается, сохраняя конфигурацию, затем камера перезагружается и Flussonic Iris запускается снова:
$ curl -s -b cookies \
    http://192.168.1.10/PSIA/System/reboot
{"requestURL": "/PSIA/System/reboot",
 "statusCode": 1, "statusString": "OK"}
  1. Полное отключение программы — обесточивание камеры. Конфигурация хранится во flash-памяти и не теряется при отключении питания.