Версия платформы — 1.17.1

Введение

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

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

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

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

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

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

При переходе по введённому адресу вы попадаете на страницу авторизации.

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

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

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

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

Создание

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

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

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

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

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

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

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

В форме Быстрый вход через мобильное приложение осуществляется генерация QR-кода, по которому абонент, получивший этот код, сможет зайти в мобильное приложение без ввода адреса сервера, логина и пароля*. Адрес сервера генерируется автоматически. Платформа подставляет те параметры, которые были указаны при установке.

Раскрыв форму Оповещения, можно выбрать события, о которых будут приходить уведомления.

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

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

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

• Абонент;
• Быстрый вход в мобильное приложение;
• Оповещения;
• Добавление видеоплатформ;
• Список домов;
• Операции.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Пример таблицы ниже: 

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

Журнал событий

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Лицензии

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

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

1. Заказчик передает файл лицензии администратору платформы Eltex SC.
2. Администратор заходит под своей учетной записью и в левом боковом меню выбирает вкладку Лицензии. Платформа переходит на страницу добавления лицензий.
3. Администратор нажимает Добавить лицензию и загружает полученный от пользователя файл в открывшемся окне загрузки. 
4. Загруженный файл лицензии проходит этап верификации на сервере лицензий: при загрузке лицензии отправляется запрос на сервер лицензий для её валидации (подтверждения). Проверяется корректность лицензии, её срок, тип и другие параметры. После загрузки лицензия переходит в активированный режим. 
5. При удачном прохождении валидации отображается статус Лицензия действительна. В противном случае отображается статус Лицензия не действительна.

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

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

Права и роли

Введение 

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

Вкладка управления ролями

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

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

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

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

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

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

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

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

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

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

На данный момент присутствуют следующие разрешения:

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

• Список пользователей на странице дома — показать карточку с пользователями дома на странице конкретного дома.
• Ссылка на "Пределы потребления" на странице дома — показать ссылку на редактор пороговых значений на странице дома.
• Ссылка на "События дома" на странице дома — показать ссылку на события дома на странице дома.
• Поддержка типов объектов — при редактировании дома доступен выбор типа объекта (дом, здание, школа и т.д.).
• Доступ к странице дома — если у роли нет доступной страницы "Управление домами", то данное разрешение нужно для доступа к странице редактирования дома/объекта.
• Доступ к странице создания дома — если у роли нет доступной страницы "Управление домами", то данное разрешение нужно для доступа к странице редактирования дома/объекта.
• Доступ к странице контроллеров дома — если у роли нет доступной страницы "Управление домами", то данное разрешение нужно для доступа к странице управления контроллерами.
• Доступ к странице переменных дома — если у роли нет доступной страницы "Управление домами", то то данное разрешение нужно для доступа к странице управления переменными дома.
• Доступ к странице местоположения — если у роли нет доступной страницы "Местоположения", то то данное разрешение нужно для доступа к странице управления местоположениями.
• Доступ к странице устройства — если у роли нет доступной страницы "Устройства", то данное разрешение нужно для доступа к странице редактирования устройства.
• Показать отчет по адресам — показать на странице "Калькуляция" отчет по адресам.
• Все показания — добавляется переключатель "все показания" рядом с заголовком на странице "Счетчики", чтобы получить развернутые показания.
• Доступ к аналитике устройств — добавляет доступ к просмотру, редактированию аналитики приборов учета. 
• Доступ к странице шаблонов устройств — добавляет доступ к просмотру, редактированию шаблонов устройств на странице редактирования дома, раздел "Шаблоны данных".
• Пользователь может принудительно удалить устройство 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 (в данном примере выбран именно этот тип), для ZWay устройств —  Прошивка Устройств (OTA) . 
4. Следующим шагом является выбор времени запуска. В случае Немедленного запуска задачи выполнение начнется через 10 секунд после добавления задачи. Для отложенного старта в поле Настройка времени запуска откройте календарь, выберите дату и время запуска.
5. В настройках задачи выберите ранее созданные правило и группу.

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

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

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

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

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

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

Здесь присутствуют два типа задач:

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

Каждая дочерняя задача содержит такие колонки как:

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

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

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

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

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

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

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

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

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

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

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

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