...
| Scroll Ignore | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||
Версия платформы — 1.18 |
Оглавление printable false
Введение
Eltex Smart Control (далее Eltex SC) разработан для организации единой системы управления, конфигурирования и мониторинга устройств «интернета вещей» (датчиков, электросчетчиков, веб-камер и т.п.). Использование данной системы с графическим веб-интерфейсом и мобильным приложением позволяет:
- Управлять учетными записями пользователей (добавление, изменение, удаление);
- Осуществлять мониторинг состояния устройств умного дома;
- Получать уведомления о событиях;
- Создавать сценарии работы устройств в доме.
Интерфейс администратора
Интерфейс администратора служит для управления учетными записями пользователей (создание, редактирование, удаление), получения информации о подключенных к платформе контроллерах Умного дома и помощи в настройке оборудования у пользователей.
...
При переходе по введённому адресу вы попадаете на страницу авторизации.
По умолчанию на сервере создана одна учетная запись администратора:
...
После входа появляется интерфейс учетной записи администратора.Scroll Pagebreak
Управление учетными записями
Создание
Чтобы создать учетную запись для нового пользователя, нужно нажать кнопку Добавить нового абонента. После этого откроется форма для заполнения данных о новом пользователе.
| Scroll Pagebreak |
|---|
...
| Информация | ||
|---|---|---|
| ||
Более подробная информация о создании и редактировании ролей описана в разделе Права и роли. |
Доступные для заполнения поля:
...
- Сохранить, чтобы вернуться к списку абонентов;
- Сохранить и перейти к добавлению дома, чтобы остаться на странице. При этом учетная запись будет создана, а на странице появятся поля для добавления дома абонента;
- Отмена, чтобы вернуться к списку абонентов, не добавляя нового абонента.
Редактирование
В процессе эксплуатации платформы может возникнуть необходимость в изменении данных учетных записей. Для начала требуется найти необходимую учетную запись в списке на домашней странице интерфейса. Для этого можно воспользоваться поиском по номеру договора, ФИО или номеру телефона абонента. Когда запись найдена, выбираем её и переходим в режим редактирования.
Страница состоит из 4 блоков:
...
Также к дому можно привязать учетную запись другого пользователя, чтобы он получил возможность взаимодействовать с данным домом. Для этого следует указать логин абонента, которому будет дан доступ в дом, его права и нажать Привязать пользователя.
| Информация | ||
|---|---|---|
| ||
У каждого дома могут быть пользователи с правами:
|
...
После этого в настройках у привязанного абонента появится соответствующий дом. Для отмены привязки следует нажать кнопку Отвязать дом.
Блок Операции позволяет посмотреть журнал событий пользователя по кнопке Действия пользователя и удалить учетную запись с помощью кнопки Удалить пользователя.
| Информация | ||
|---|---|---|
| ||
На платформе реализовано каскадное удаление сущностей. Если удалить учетную запись, с которой связан дом, то он будет также удален вместе со всеми зарегистрированными в нем устройствами. |
Генерация аккаунтов
Функционал необходимый для генерации большого числа абонентов или жителей.
...
Для генерации аккаунтов необходимо выбрать пункт "Генерация аккаунтов" на странице абоненты.
После перенаправления на страницу "Генерации аккаунтов" необходимо выбрать желаемый тип аккаунта для генерации.Scroll Pagebreak
После выбора типа создаваемых аккаунтов, необходимо указать следующую информацию:
- Количество абонентов, которых нужно сгенерировать;
- Логин (основная часть логина, к которой будет дописываться номер квартиры);
- Почта, куда отправятся данные сгенерированных аккаунтов.
На почту вы получите письмо с темой "Multiple user creation". К письму будет прикреплен xlsx файл таблицы.
Пример таблицы ниже:
После входа пользователя в выданный ему аккаунт, будет предложено указать свой e-mail адрес для создания нового пароля. Далее на почту пользователя придет письмо с ссылкой для установки нового пароля.
Журнал событий
Чтобы увидеть действия администратора, нужно в меню слева выбрать вкладку Журнал.
Журнал событий позволяет просматривать операции, выполненные администратором:
...
Сверху от списка событий находится календарь, с помощью которого можно перейти к событиям в предыдущие дни.
Список контроллеров
Во вкладке меню Контроллеры можно посмотреть, какие контроллеры зарегистрированы в платформе, подключены или недоступны.
С этой страницы можно выполнить привязку контроллера к пользователю и его дому. Для того чтобы привязать контроллер, нужно заполнить поля Логин и Дом напротив его имени и нажать на иконку 
. Вместе с контроллером у дома появляются все устройства, которые были к нему привязаны. Если требуется отвязать контроллер, нужно нажать иконку 
. В этом случае вместе с контроллером исчезнут и все привязанные к нему устройства.
В столбце Действия присутствуют следующие кнопки:
-
— обновить данные; -
— удалить контроллер; -
— сбросить настройки Z-Wave контроллера до заводских1; -
— перезагрузить Z-Wave контроллер1.
| Примечание | ||||||
|---|---|---|---|---|---|---|
|
...
Для сброса фильтра необходимо нажать на кнопку Сбросить фильтр.Scroll Pagebreak
Настройка опроса цифровых ПУ
На этой странице настраивается время и дата опроса текущих показаний и из памяти устройства.
Доступна настройка как в продвинутом режиме через Cron-выражение, так и через временной промежуток (Минута, Час, День, Неделя, Месяц, Год)
Scroll Pagebreak
Сценарии для устройств
На вкладке Шаблоны сценариев представлен список сценариев для подключаемых к дому устройств.
При обнаружении нового подключенного устройства платформа определяет его тип и предлагает пользователю добавить сценарий поведения этого устройства. Администратор может удалять стандартные сценарии и создавать собственные. Для создания нужно нажать кнопку Добавить новый шаблон.
Платформа откроет страницу с формой для заполнения параметров нового шаблона сценария.
Например, создадим сценарий на случай разряда батареи устройства:
...
В результате получится сценарий как на рисунке ниже:
| Информация | ||
|---|---|---|
| ||
Сценарии могут содержать несколько условий, правил и действий. |
Далее нужно нажать кнопку Сохранить, чтобы сценарий добавился в базу данных платформы.
Сценарии с двумя и более условиями (логическое И) Scroll Pagebreak
Для того чтобы создать сценарий, в котором действие происходит при выполнении двух и более условий (логическое И), следует добавить одно правило, а затем нажать кнопку Добавить условие, после чего заполнить появившиеся условия. Пример такого сценария изображен ниже:
В этом сценарии платформа отправит уведомление, только когда уровень заряда батареи будет меньше 10%, и пользователь будет находиться дома.
...
Для того чтобы создать сценарий, в котором действие происходит при выполнении одного из правил (логическое ИЛИ), следует добавить правило, а затем еще раз нажать кнопку Добавить правило, после чего заполнить условия в этих правилах. Пример такого сценария представлен ниже:
В этом сценарии действие будет выполнено, когда уровень заряда батареи будет меньше 10%, или когда сработает датчик движения.
Для того чтобы создать сценарий, в котором происходит несколько действий, следует нажать кнопку Добавить действие соответствующее количество раз и заполнить их. Пример показан ниже.
Для удаления сценария достаточно нажать иконку 
на странице со списком сценариев либо зайти в сценарий и нажать кнопку Удалить.
После этого подтвердите удаление во всплывающем окне.
Лицензии
Время использования платформы и количество добавляемых устройств ограничивается типом лицензии, которая приобретается заказчиком.
Описание работы модуля лицензий
- Заказчик передает файл лицензии администратору платформы Eltex SC.
- Администратор заходит под своей учетной записью и в левом боковом меню выбирает вкладку Лицензии. Платформа переходит на страницу добавления лицензий.
- Администратор нажимает Добавить лицензию и загружает полученный от пользователя файл в открывшемся окне загрузки.
- Загруженный файл лицензии проходит этап верификации на сервере лицензий: при загрузке лицензии отправляется запрос на сервер лицензий для её валидации (подтверждения). Проверяется корректность лицензии, её срок, тип и другие параметры. После загрузки лицензия переходит в активированный режим.
- При удачном прохождении валидации отображается статус Лицензия действительна. В противном случае отображается статус Лицензия не действительна.
Пример: добавим одно новое устройство "Пульсар" и посмотрим, как изменится счетчик лицензии.
- Во время добавления устройства был отправлен запрос на сервер лицензий для валидации добавляемого устройства.
- Сервер лицензий проверяет лицензию.
- Поскольку есть квота на добавляемые устройства (в данном случае можно добавить 3 устройства), сервер возвращает корректный ответ, и устройство добавляется на платформу.
...
| Предупреждение |
|---|
ВАЖНО! Модуль лицензии не является конечной реализацией и может быть подвергнут изменением в будущем. |
Якорь Rules_roles Rules_roles
Права и роли
| Rules_roles | |
| Rules_roles |
Введение
Роль — это набор прав, которые даются пользователю. Для настройки ролей используется Конструктор ролей — гибкий инструмент, с которым взаимодействует администратор платформы.
Вкладка управления ролями
Для управления ролями следует перейти во вкладку Управление ролями.
По умолчанию платформа уже содержит несколько стандартных ролей:
...
Их описание приведено в "Управление учетными записями".
Редактирование
При выборе определённой роли появляется форма редактирования, состоящая из нескольких частей.
В строчках Название и Описание можно задать название роли и дать ее краткое описание (для чего данная роль нужна).
В разделе Доступные страницы можно выбрать те страницы/вкладки, которые будут доступны выбранной роли. При нажатии на иконку 
можно сделать данную страницу стартовой при авторизации под данной ролью.
В разделе Порядок Меню можно менять размещение элементов навигации бокового меню. Для этого зажмите элемент и начните тянуть, перемещая его.
Следующим разделом являются Разрешения. Они влияют на поведение веб-интерфейса.Scroll Pagebreak
Scroll Pagebreak
...
- Редактор переменных в хедере — показать редактор переменных в хедере (в правом верхнем углу веб-интерфейса появляется кнопка, позволяющая управлять режимами переменных):
- Список пользователей на странице дома — показать карточку с пользователями дома на странице конкретного дома.
- Ссылка на "Пределы потребления" на странице дома — показать ссылку на редактор пороговых значений на странице дома.
- Ссылка на "События дома" на странице дома — показать ссылку на события дома на странице дома.
- Поддержка типов объектов — при редактировании дома доступен выбор типа объекта (дом, здание, школа и т.д.).
- Доступ к странице дома — если у роли нет доступной страницы "Управление домами", то данное разрешение нужно для доступа к странице редактирования дома/объекта.
- Доступ к странице создания дома — если у роли нет доступной страницы "Управление домами", то данное разрешение нужно для доступа к странице редактирования дома/объекта.
- Доступ к странице контроллеров дома — если у роли нет доступной страницы "Управление домами", то данное разрешение нужно для доступа к странице управления контроллерами.
- Доступ к странице переменных дома — если у роли нет доступной страницы "Управление домами", то данное разрешение нужно для доступа к странице управления переменными дома.
- Доступ к странице местоположения — если у роли нет доступной страницы "Местоположения", то данное разрешение нужно для доступа к странице управления местоположениями.
- Доступ к странице устройства — если у роли нет доступной страницы "Устройства", то данное разрешение нужно для доступа к странице редактирования устройства.
- Показать отчет по адресам — показать на странице "Калькуляция" отчет по адресам.
- Все показания — добавляется переключатель "все показания" рядом с заголовком на странице "Счетчики", чтобы получить развернутые показания.
- Доступ к аналитике устройств — добавляет доступ к просмотру, редактированию аналитики приборов учета. А так же для настройки пороговых значений у графиков min/max.
- Доступ к странице шаблонов устройств — добавляет доступ к просмотру, редактированию шаблонов устройств на странице редактирования дома, раздел "Шаблоны данных".
- Пользователь может принудительно удалить устройство Z-Way — пользователь может принудительно удалять устройства Z-Way, даже если он не является владельцем. В этом случае показывается соответствующая кнопка на странице устройства.
- Пользователь не может редактировать устройства — на странице устройства все поля заблокированы, а кнопки сохранения скрыты.
- Сворачивать информацию об устройстве при наличии графиков — на странице редактирования устройства, информация об устройстве будет в свернутом виде, если присутствуют графики у устройства.
- Требуется вычисление страницы по умолчанию — на основе количества домов, контроллеров и устройств определяется страница по умолчанию: если нет домов — страница домов; если дом один, и нет контроллеров — страница этого дома; если нет устройств — страница устройств.
- Может управлять правами групп объектов — добавляет доступ к просмотру, редактированию планов помещений на странице редактирования дома, раздел "Местоположения".
- Обработка персональной информации — если пункт не отмечен, вся личная информация пользователя скрывается (ФИО).
- Пользователь является администратором — появляется доступ к страницам: Множественное добавление устройств, Текущие показания, Рабочий стол, Устройства, Устройство, Редактор переменных дома, Местоположение, Счетчики, Счетчик, Отчеты, Калькуляция, Скрипты, Скрипт, а также к странице редактирования скрипта.
Далее следует раздел Сущности.
Здесь можно устанавливать доступ на чтение/редактирование устройств, контроллеров и домов.
Для сохранения изменений необходимо нажать кнопку Сохранить. Для удаления роли — Удалить. Системную роль удалить нельзя. Scroll Pagebreak
Сброс к исходным настройкам роли осуществляется через кнопку Сбросить к исходным настройкам.
Создание новой роли
Для создания новой роли необходимо нажать кнопку Добавить роль.
Scroll Pagebreak
После этого появится чистая форма редактирования, которую можно модифицировать. Один из примеров представлен ниже.
Теперь можно создать пользователя с новой ролью.
Scroll Pagebreak
После создания пользователя и настройки роли список доступных страниц отобразится на панели слева:
Статистика
Раздел меню позволяющий проанализировать данные по платформе.
Страница разделена на три раздела:
...
| Scroll Pagebreak |
|---|
При нажатии на кнопку "Пользователи" под диаграммой будет раскрыт список пользователей и подробная информация о сессии.
Scroll Pagebreak
Обновление ПО (прошивки)
Данный функционал позволяет обновлять программное обеспечение на подключенных к платформе устройствах. При нажатии вкладки Прошивки платформа переходит на страницу обновления прошивок в раздел Планировщик.
| Информация |
|---|
Для перехода обратно к интерфейсу администратора следует нажать иконку |
Для обновления прошивки устройства или нескольких устройств следует выполнить следующие действия:
...
Более детально эти действия описаны ниже.
Scroll Pagebreak
Добавление группы
- В выпадающем списке Администрирование выберите раздел Группы и на появившейся странице нажмите кнопку Добавить группу.
Появляется форма для создания группы. Данный функционал позволяет объединять устройства по некоторым параметрам и в дальнейшем работать именно со сделанной выборкой устройств. 
Выберите соответствующий тип прошивки в зависимости от того, на каком устройстве необходимо обновить ПО. На данный момент доступны типы: Прошивка RG35 и Прошивка ZWay устройства. По умолчанию выбран тип Прошивка RG35 и поиск по адресу дома.
Информация В процессе разработки находится функционал динамического поиска, который позволит искать устройства по их IP/MAC-адресам и другим параметрам.
В форме Поиск по адресу введите произвольное название группы, по которому будет осуществляться дальнейший поиск, и адрес дома, к которому привязан контроллер.
Информация Поле поиска чувствительно к регистру, поэтому будьте внимательны при вводе адреса.
После заполнения полей и нажатия иконки поиска
(или клавиши Enter) появляются результаты поиска. 
Для сохранения результатов следует установить флаг напротив соответствующего контроллера и нажать Сохранить.Информация В случае, когда к одному дому привязано несколько контроллеров, в результатах поиска отобразятся все. Отметьте флажком те устройства, которые необходимо объединить в группу.
При выборе вкладки Прошивка ZWay устройства появляется идентичная форма поиска. Создание группы осуществляется таким же способом, но в поиске отображаются лишь те устройства, статус которых "online".
После сохранения в разделе Группы появляется строка созданной группы с введенным ранее названием.
Информация Функционал редактирования и удаления групп находится в процессе разработки.
Scroll Pagebreak
Добавление правила
- В выпадающем списке Администрирование выберите раздел Правила и нажмите кнопку Добавить правило.
Появится форма для создания правила: 
- Заполните поле Имя правила, из выпадающего списка выберите соответствующий тип прошивки (в данном примере выбран тип Прошивка RG35). После нажатия кнопки Файл прошивки появляется окно, в котором нужно выбрать файл прошивки и нажать Ок. Теперь имя файла отображается справа от кнопки, но он ещё не загружен. Загрузка начнется после нажатия кнопки Загрузить. В случае удачной загрузки появится подтверждающая надпись.
Чтобы сохранить правило, нажмите кнопку Сохранить. Для закрытия формы без сохранения достаточно кликнуть вне её области или нажать Esc.
При выборе типа Прошивка ZWay устройства форма не меняется. Создание правила осуществляется таким же способом.
После сохранения в разделе Правила появляется строка созданного правила с введённым ранее названием и именем прикреплённого файла.
Информация Функционал редактирования и удаления правил находится в процессе разработки.
Добавление задачи
Для упорядочивания выполнения обновлений на устройствах применяется планировщик событий.
- В выпадающем списке Администрирование выберите раздел Планировщик или нажмите на иконку
. - На появившейся странице нажмите кнопку Добавить задачу.
Появится форма для создания задачи: 
Scroll Pagebreak - Заполните поле Название задачи, соответствующий Тип задачи выберите из выпадающего списка. Для контроллеров — Прошивка RG35 (в данном примере выбран именно этот тип), для ZWay устройств — Прошивка Устройств (OTA).
- Следующим шагом является выбор времени запуска. В случае Немедленного запуска задачи выполнение начнется через 10 секунд после добавления задачи. Для отложенного старта в поле Настройка времени запуска откройте календарь, выберите дату и время запуска.
- В настройках задачи выберите ранее созданные правило и группу.
Информация Правила и группы в пункте Настройки задачи отфильтровываются по типу задачи.
Чтобы сохранить задачу, нажмите кнопку Сохранить. Для закрытия формы без сохранения достаточно кликнуть вне её области или нажать Esc.
При выборе типа задачи Прошивка Устройств (OTA) форма не меняется. Создание задачи осуществляется таким же способом.
После сохранения в разделе Планировщик появляется строка созданной задачи. Задача находится в статусе Ожидает.
Информация Параметр Статус относится только к планировщику, показывая состояние запуска задачи, т.е. он не является показателем того, удачно закончилось обновление или нет.
Запуск задачи
Когда наступает время старта (или истекает 10 секунд в случае немедленного запуска), задача запускается. При этом статус меняется на Успешно, в колонке Время старта отображается время запуска, а в колонке Действия появляется иконка 
.
При переходе в Действия появляется следующая страница:
Scroll Pagebreak
...
- шаг — действие со стороны платформы1;
- статус — Успешно/Выполняется/Ошибка/NONAME2;
- параметры — служебная информация о процессе выполнения шага.
...
Общий статус задачи связан со значениями статусов шагов. При выполнении всех шагов (даже с некритическими ошибками) общий статус приобретает значение Успешно.
Scroll Pagebreak
При наличии критических ошибок общий статус меняется на Ошибка, как показано ниже:
| Информация |
|---|
Для отслеживания выполнения шагов дочерней задачи следует обновлять страницу. Функционал проверки в реальном времени находится в процессе разработки. |
Повторная авторизация
Страница обновления прошивок может потребовать повторную авторизацию при следующих условиях:
...
В этих случаях на странице обновления прошивок появится форма авторизации.
Введите логин и пароль в соответствующие поля и нажмите Login. Появится страница обновления прошивок, с которой работали ранее (до появления формы авторизации).
Предложения по улучшению функционала и пожелания
Все предложения по улучшениям рассматриваются коммерческим отделом. Для разработки нового функционала требуется проводить обсуждения с заказчиком и коммерческим отделом.
...