|| DeviceType | Eltex SC |
|| DeviceName | Интерфейс администратора. Описание |
|| fwversion | 1.19.4 |

О системе Eltex SC

Система Eltex Smart Control (далее Eltex SC) разработана для организации единой системы управления, конфигурирования и мониторинга устройств «Интернета вещей» (датчиков, электросчетчиков, веб-камер и т.п.). Использование данной системы с графическим веб-интерфейсом и мобильным приложением позволяет:

• управлять учетными записями пользователей (добавление, изменение, удаление);
• осуществлять мониторинг состояния устройств умного дома;
• получать уведомления о событиях;
• создавать сценарии работы устройств в доме.

Интерфейс администратора

Интерфейс администратора служит для управления учетными записями пользователей (создание, редактирование, удаление), получения информации о подключенных к платформе контроллерах Умного дома и помощи в настройке оборудования у пользователей.

Для доступа к платформе через веб-интерфейс используется порт по умолчанию 80/443, и строка в браузере выглядит следующим образом: 

http://<Адрес сервера Eltex SC>/

При переходе по введённому адресу откроется страница авторизации:

По умолчанию на сервере создана одна учетная запись администратора:

• Логин: admin
• Пароль: Test18plat34Form

После входа откроется интерфейс учетной записи администратора.

Управление учетными записями

Создание

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

В платформе Eltex SC присутствуют несколько стандартных типов пользователей (ролей):

• Абонент — учетная запись пользователя, которая является личным кабинетом абонента с доступом через веб-интерфейс и мобильное приложение;
• Администратор — учетная запись, которая управляет учетными записями пользователей, не имеет собственных домов, но может управлять настройками и содержимым домов абонентов (регистрировать контроллеры, подключать и удалять устройства при возникновении затруднений у пользователей);
• Управляющая компания — учетная запись, позволяющая просматривать отчеты и формировать калькуляцию;
• Инженер — учетная запись, позволяющая просматривать отчеты, формировать калькуляцию и производить настройку оборудования;
• Инженер охраны — учетная запись, через которую можно взаимодействовать с охранной системой;
• Пульт охраны — учетная запись, которая создаётся при добавлении пульта охраны (является уникальным id пульта охраны);
• Оператор охраны — учетная запись, позволяющая взаимодействовать с охранной системой (просматривать статус устройств, включать/отключать охрану);
• Житель — учетная запись, позволяющая просматривать данные только по счетчикам. 

Доступные для заполнения поля:

• Договор — в поле указывается номер договора в произвольной форме, который служит для связи абонента с его тарифным планом*;
• Логин — имя, под которым пользователь будет заходить на платформу;
• Пароль — секретная комбинация для подтверждения доступа абонента к учетной записи;
• Язык пользователя — выбор языка (RU или EN), на котором будут приходить уведомления;
• Фамилия, Имя, Отчество — информация об абоненте, которая используется при поиске в списке учетных записей;
• Телефон, Email — поля для ввода номера телефона и электронной почты для получения SMS-уведомлений и электронных писем от платформы.

После заполнения необходимых полей можно нажать одну из кнопок:

• Сохранить, чтобы вернуться к списку абонентов;
• Сохранить и настроить, чтобы остаться на странице. При этом учетная запись будет создана, а на странице появятся поля для добавления дома абонента;
• Отмена, чтобы вернуться к списку абонентов, не добавляя нового абонента.

Редактирование

В процессе эксплуатации платформы может возникнуть необходимость в изменении данных учетных записей. Для начала требуется найти необходимую учетную запись в списке на домашней странице интерфейса. Для этого можно воспользоваться поиском по номеру договора, ФИО или номеру телефона абонента. Когда запись найдена, выберите её и перейдите в режим редактирования.

Страница состоит из 4 блоков:

• Абонент;
• Видеоплатформа FLUSSONIC;
• Список домов;
• Операции.

В блоке Абонент содержатся поля, которые доступны при создании учетной записи. При необходимости их можно изменить, например, если у абонента сменился номер телефона или адрес электронной почты.

В блоке Видеоплатформа FLUSSONIC выбор доступной видеоплатформы указывает на то, какие камеры может добавлять пользователь для видеонаблюдения.

Список домов позволяет перейти к конкретному дому и взаимодействовать с ним через интерфейс пользователя. Для этого нужно нажать кнопку Перейти к дому.

Также к дому можно привязать учетную запись другого пользователя, чтобы он получил возможность взаимодействовать с данным домом. Для этого следует указать логин абонента, которому будет дан доступ в дом, его права и нажать Привязать пользователя.

После этого в настройках у привязанного абонента появится соответствующий дом. Для отмены привязки следует нажать кнопку Отвязать дом.

Блок Операции позволяет посмотреть журнал событий пользователя по кнопке Действия пользователя и удалить учетную запись с помощью кнопки Удалить пользователя.

Генерация аккаунтов

Функционал, необходимый для генерации большого числа абонентов или жителей.

Используется при вводе объекта в коммерческую фазу, для выдачи доступов всем жильцам.

Для генерации аккаунтов необходимо выбрать пункт "Генерация аккаунтов" на странице Абоненты.

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

После выбора типа создаваемого аккаунта необходимо указать следующую информацию:

• Количество абонентов, которое нужно сгенерировать;
• Логин (основная часть логина, к которой будет дописываться номер квартиры);
• Почта, куда будут отправлены данные сгенерированных аккаунтов.

На указанную почту будет отправлено письмо с темой "Multiple user creation". К нему будет прикреплен xlsx-файл с таблицей.

Пример содержимого файла: 

После входа пользователя в выданный ему аккаунт ему будет предложено указать свой e-mail адрес для создания нового пароля. На этот адрес придет письмо со ссылкой на смену пароля.

Журнал администратора

Чтобы увидеть действия администратора, нужно в меню слева выбрать вкладку Журнал. 

Журнал позволяет просматривать операции, выполненные администратором:

• создание и удаление учетных записей;
• создание домов;
• назначение доступа пользователей к домам.

Сверху от списка событий находится календарь, с помощью которого можно перейти к событиям, произошедшим за предыдущие дни.

Список контроллеров

Во вкладке меню Контроллеры можно посмотреть, какие контроллеры зарегистрированы в платформе, подключены или недоступны.

С этой страницы можно выполнить привязку контроллера к пользователю и его дому. Для того чтобы привязать контроллер, заполните поля Логин и Дом напротив его имени и нажмите на иконку . Вместе с контроллером у дома появляются все устройства, которые были к нему привязаны. Если требуется отвязать контроллер, нажмите иконку . В этом случае вместе с контроллером исчезнут и все привязанные к нему устройства.

В столбце Действия присутствуют следующие кнопки:

•  — обновить данные;
•  — удалить контроллер;
•  — сбросить настройки Z-Wave контроллера до заводских¹;
•  — перезагрузить Z-Wave контроллер¹.

Для поиска контроллера по его параметрам нужно ввести интересующее значение в соответствующее поле и нажать Применить фильтр.

Для сброса фильтра необходимо нажать на кнопку Сбросить фильтр.

Настройка опроса цифровых ПУ

На этой странице настраивается время и дата опроса текущих показаний из памяти устройства.

Доступна настройка как в продвинутом режиме через Cron-выражение, так и с помощью установки временного промежутка (Минута, Час, День, Неделя, Месяц, Год)

Сценарии для устройств

На вкладке Шаблоны сценариев представлен список сценариев для подключаемых к дому устройств.

При обнаружении нового подключенного устройства платформа определяет его тип и предлагает пользователю добавить сценарий поведения этого устройства. Администратор может удалять стандартные сценарии и создавать собственные. Для создания нужно нажать кнопку Добавить новый шаблон.

Платформа откроет страницу с формой для заполнения параметров нового шаблона сценария.

Например, создадим сценарий на случай разряда батареи устройства:

1. Введите название сценария: например "Заряд батареи", заполните поле Описание;
2. Нажмите кнопку Добавить правило и заполните условие; 
3. Нажмите кнопку Добавить действие и выберите тип действия "Отправка уведомления";
4. Введите текст уведомления: например "Батарея почти разряжена".

В результате получится сценарий как на рисунке ниже:

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

Сценарии с двумя и более условиями (логическое И)

Для того чтобы создать сценарий, в котором действие происходит при выполнении двух и более условий (логическое И), следует добавить одно правило, а затем нажать кнопку Добавить условие, после чего заполнить появившиеся поля для условия. Пример такого сценария изображен ниже:

В этом сценарии платформа отправит уведомление, только когда уровень заряда батареи будет меньше 10%, и пользователь будет находиться дома.

Сценарии при выполнении хотя бы одного из условий (логическое ИЛИ)

Для того чтобы создать сценарий, в котором действие происходит при выполнении одного из правил (логическое ИЛИ), следует добавить правило, а затем еще раз нажать кнопку Добавить правило, после чего заполнить поля для условия в этих правилах. Пример такого сценария представлен ниже:

В этом сценарии действие будет выполнено, когда уровень заряда батареи будет меньше 10%, или когда сработает датчик движения.

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

Для удаления сценария нажмите на иконку  на странице со списком сценариев либо зайдите в сценарий и нажмите кнопку Удалить.

После этого подтвердите удаление во всплывающем окне.

Лицензии

Время использования платформы и количество добавляемых устройств ограничивается типом лицензии, которая приобретается заказчиком.

Описание работы модуля лицензий

1. Заказчик передает файл лицензии администратору платформы Eltex SC.

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

3. Администратор нажимает Добавить лицензию и загружает полученный от пользователя файл в открывшемся окне загрузки. 

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

5. При удачном прохождении валидации отображается статус Лицензия действительна. В противном случае отображается статус Лицензия не действительна.

Пример: добавим новое устройство "Пульсар" и посмотрим, как изменится счетчик лицензии.

1. Во время добавления устройства был отправлен запрос на сервер лицензий для валидации добавляемого устройства.
2. Сервер лицензий проверяет лицензию.
3. Поскольку есть квота на добавляемые устройства (в данном случае можно добавить 3 устройства), сервер возвращает корректный ответ, и устройство добавляется на платформу.

Права и роли

Роль — это набор прав, которые даются пользователю. Для настройки ролей используется Конструктор ролей — гибкий инструмент, с которым взаимодействует администратор платформы.

Для управления ролями следует перейти во вкладку Управление ролями. 

По умолчанию платформа уже содержит несколько стандартных ролей:

• Абонент
• Администратор
• Житель
• Инженер
• Инженер охраны
• Оператор охраны
• Пульт охраны
• Управляющая компания

Их описание приведено в "Управление учетными записями".

Редактирование роли

При выборе определённой роли появляется форма редактирования, состоящая из нескольких частей. 

В строчках Название и Описание можно задать название роли и дать ее краткое описание (для чего данная роль нужна).

В разделе Доступные страницы можно выбрать страницы/вкладки, которые будут доступны выбранной роли. При нажатии на иконку  можно сделать данную страницу стартовой при авторизации под данной ролью.

В разделе Порядок Меню можно менять размещение элементов навигации бокового меню. Для этого зажмите элемент и начните тянуть, перемещая его.

Следующим разделом являются Разрешения. Они влияют на поведение веб-интерфейса.

Ниже представлено описание доступных разрешений:

• Редактор переменных в хедере — показать редактор переменных в хедере (в правом верхнем углу веб-интерфейса появляется кнопка, позволяющая управлять режимами переменных):

• Список пользователей на странице дома — показать карточку с пользователями дома на странице конкретного дома.
• Ссылка на "Пределы потребления" на странице дома — показать ссылку на редактор пороговых значений на странице дома.
• Ссылка на "События дома" на странице дома — показать ссылку на события дома на странице дома.
• Поддержка типов объектов — при редактировании дома доступен выбор типа объекта (дом, здание, школа и т.д.).
• Доступ к странице дома — если у роли нет доступной страницы "Управление домами", то данное разрешение нужно для доступа к странице редактирования дома/объекта.
• Доступ к странице создания дома — если у роли нет доступной страницы "Управление домами", то данное разрешение нужно для доступа к странице редактирования дома/объекта.
• Доступ к странице контроллеров дома — если у роли нет доступной страницы "Управление домами", то данное разрешение нужно для доступа к странице управления контроллерами.
• Доступ к странице переменных дома — если у роли нет доступной страницы "Управление домами", то данное разрешение нужно для доступа к странице управления переменными дома.
• Доступ к странице местоположений дома — если у роли нет доступной страницы "Местоположения", то данное разрешение нужно для доступа к странице управления местоположениями.
• Доступ к странице устройства — если у роли нет доступной страницы "Устройства", то данное разрешение нужно для доступа к странице редактирования устройства.
• Показать отчет по адресам — показать на странице "Калькуляция" отчет по адресам.
• Все показания — добавляется переключатель "все показания" рядом с заголовком на странице "Счетчики", чтобы получить развернутые показания.
• Доступ к аналитике устройств — добавляет доступ к просмотру, редактированию аналитики приборов учета. А также к настройке пороговых значений min/max у графиков.
• Доступ к странице шаблонов устройств — добавляет доступ к просмотру, редактированию шаблонов устройств на странице редактирования дома, раздел "Шаблоны данных".
• Пользователь может принудительно удалить устройство Z-Way — пользователь может принудительно удалять устройства Z-Way, даже если он не является владельцем. В этом случае показывается соответствующая кнопка на странице устройства.
• Пользователь не может редактировать устройства — на странице устройства все поля заблокированы, а кнопки сохранения скрыты.
• Сворачивать информацию об устройстве при наличии графиков — на странице редактирования устройства, информация об устройстве будет в свернутом виде, если присутствуют графики у устройства.
• Требуется вычисление страницы по умолчанию — на основе количества домов, контроллеров и устройств определяется страница по умолчанию: если нет домов — страница домов; если дом один, и нет контроллеров — страница этого дома; если нет устройств — страница устройств.
• Может управлять правами групп объектов — добавляет доступ к просмотру, редактированию планов помещений на странице редактирования дома, раздел "Местоположения".
• Обработка персональной информации  — если пункт отмечен, вся личная информация пользователя скрывается (ФИО).
• Пользователь является администратором — появляется доступ к страницам: Множественное добавление устройств, Текущие показания, Рабочий стол, Устройства, Устройство, Редактор переменных дома, Местоположение, Счетчики, Счетчик, Отчеты, Калькуляция, Скрипты, Скрипт, а также к странице редактирования скрипта.

Далее, следует раздел Сущности. 

Здесь можно устанавливать доступ на чтение/редактирование устройств, контроллеров и домов.

Для сохранения изменений нажмите кнопку Сохранить. Для удаления роли — Удалить. Системную роль удалить нельзя.

Сброс к исходным настройкам роли осуществляется через кнопку Сбросить к исходным настройкам.

Создание новой роли

Для создания новой роли нажмите кнопку Добавить роль.

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

Один из примеров представлен ниже.

Выбраны пункты "Устройства", "Калькуляция", "Счетчики", "Отчеты",  "Аварии".

Теперь можно создать пользователя с новой ролью.

После создания пользователя и настройки роли список доступных страниц отобразится на панели слева: "Устройства", "Калькуляция", "Счетчики", "Отчеты",  "Аварии". 

Статистика

Раздел меню, позволяющий проанализировать данные по платформе.

Страница разделена на три раздела:

• Выбор промежутка времени выборки;
• Общая статистика;
• Статистика по конкретным объектам (домам).

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

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

Обновление ПО (прошивки)

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

Для обновления прошивки устройства или нескольких устройств следует выполнить следующие действия:

1. Добавить группу;
2. Добавить правило;
3. Добавить задачу;
4. Запустить задачу.

Более детально эти действия описаны ниже.

Добавление группы

1. В выпадающем списке Администрирование выберите раздел Группы и на появившейся странице нажмите кнопку Добавить группу.  Появляется форма для создания группы. Данный функционал позволяет объединять устройства по некоторым параметрам и в дальнейшем работать именно с созданной выборкой устройств.

2. Выберите соответствующий тип прошивки в зависимости от того, на каком устройстве необходимо обновить ПО. На данный момент доступны типы: Прошивка RG35 и Прошивка ZWay устройства. По умолчанию выбран тип Прошивка RG35 и поиск по адресу дома.

   В процессе разработки находится функционал динамического поиска, который позволит искать устройства по их IP/MAC-адресам и другим параметрам.

   
   

3. В форме Поиск по адресу введите произвольное название группы, по которому будет осуществляться дальнейший поиск, и адрес дома, к которому привязан контроллер.

   Поле поиска чувствительно к регистру, поэтому будьте внимательны при вводе адреса.

   После заполнения полей и нажатия иконки поиска  (или клавиши Enter) появляются результаты поиска. Для сохранения результатов следует установить флаг напротив соответствующего контроллера и нажать Сохранить.

   В случае, когда к одному дому привязано несколько контроллеров, в результатах поиска отобразятся все. Отметьте флажком те устройства, которые необходимо объединить в группу.

   При выборе вкладки Прошивка ZWay устройства появляется идентичная форма поиска. Создание группы осуществляется таким же способом, но в поиске отображаются лишь устройства со статусом "online". 
   После сохранения в разделе Группы появляется строка созданной группы с введенным ранее названием.

   Функционал редактирования и удаления групп находится в процессе разработки.

   
   

Добавление правила

1. В выпадающем списке Администрирование выберите раздел Правила и нажмите кнопку Добавить правило.  Откроется форма для создания правила:
2. Заполните поле Имя правила, из выпадающего списка выберите соответствующий тип прошивки (в данном примере выбран тип Прошивка RG35). После нажатия кнопки Файл прошивки появится окно, в котором нужно выбрать файл прошивки и нажать Ок. Теперь имя файла отображается справа от кнопки, но он ещё не загружен. Загрузка начнется после нажатия кнопки Загрузить. В случае удачной загрузки появится подтверждающая надпись.

3. Чтобы сохранить правило, нажмите кнопку Сохранить. Для закрытия формы без сохранения достаточно кликнуть вне её области или нажать Esc.
   При выборе типа Прошивка ZWay устройства форма не меняется. Создание правила осуществляется таким же способом.
   После сохранения в разделе Правила появляется строка созданного правила с введённым ранее названием и именем прикреплённого файла.
   

   Функционал редактирования и удаления правил находится в процессе разработки.

   
   

Добавление задачи

Для упорядочивания выполнения обновлений на устройствах применяется планировщик событий.

1. В выпадающем списке Администрирование выберите раздел Планировщик или нажмите на иконку .
2. На появившейся странице нажмите кнопку Добавить задачу. Появится форма для создания задачи:

   

3. Заполните поле Название задачи и выберите из выпадающего списка соответствующий Тип задачи. Для контроллеров — Прошивка RG35 (в данном примере выбран именно этот тип), для Z-Way устройств —  Прошивка Устройств (OTA). 
4. Следующим шагом является выбор времени запуска. В случае Немедленного запуска задачи выполнение начнется через 10 секунд после добавления задачи. Для отложенного старта в поле Настройка времени запуска откройте календарь и выберите дату и время запуска.
5. В настройках задачи выберите ранее созданные правило и группу.

   
   

   Правила и группы в пункте Настройки задачи отфильтровываются по типу задачи.

   
   

6. Чтобы сохранить задачу, нажмите кнопку Сохранить. Для закрытия формы без сохранения достаточно кликнуть вне её области или нажать Esc.
   При выборе типа задачи Прошивка Устройств (OTA) форма не меняется. Создание задачи осуществляется таким же способом.
   После сохранения в разделе Планировщик появляется строка созданной задачи. Задача находится в статусе Ожидает.

   Параметр Статус относится только к планировщику, показывая состояние запуска задачи, т.е. он не является показателем того, удачно закончилось обновление или нет.

   
   

Запуск задачи

Когда наступает время старта, или истекает 10 секунд в случае немедленного запуска, задача запускается. При этом статус меняется на Успешно, в колонке Время старта отображается время запуска, а в колонке Действия появляется иконка .

При переходе в Действия отображается следующая страница:

Задачи делятся на два типа:

• родительская задача — ищет по группам и собирает всю необходимую информацию;
• дочерняя задача — запускается после родительской (может быть несколько штук в зависимости от числа контроллеров).

Каждая дочерняя задача содержит следующие атрибуты:

• шаг — действие со стороны платформы ¹;
• статус — Успешно/Выполняется/Ошибка/NONAME ²;
• параметры — служебная информация о процессе выполнения шага.

Для получения актуальной информации о процессе обновления нажмите кнопку Обновить данные. Если необходимо прервать выполнение операции, нажмите кнопку Отмена.

Общий статус задачи связан со значениями статусов шагов. При выполнении всех шагов (даже с некритическими ошибками) общий статус приобретает значение Успешно.

При наличии критических ошибок общий статус меняется на Ошибка, как показано ниже:

Повторная авторизация

Страница обновления прошивок может потребовать повторную авторизацию при следующих условиях:

• На странице длительное время отсутствует какая-либо активность;
• Осуществлен выход из учётной записи администратора (например из продублированной вкладки браузера).

В этих случаях на странице обновления прошивок отобразится форма авторизации.

Введите логин и пароль в соответствующие поля и нажмите Login. Откроется страница обновления прошивок, с которой работали ранее (до появления формы авторизации).

Предложения по улучшению функционала и пожелания

Все предложения по улучшениям рассматриваются Коммерческим отделом ЭЛТЕКС. Для разработки нового функционала требуется проводить обсуждения с заказчиком и Коммерческим отделом.

Мелкие улучшения и доработки будут рассмотрены Сервисным центром ЭЛТЕКС, и в дальнейшем могут быть включены в новую версию платформы.