Настройка взаимодействия с Domintell

Материал из iRidium Mobile Wiki
Перейти к: навигация, поиск


Как это работает?

Для подключения iRidium App к Domintell используется UDP или TCP транспорт (преимущественно UDP).

Отправка и получение данных возможны, если панель и оборудование находятся в одной IP-подсети. Топология подключения iRidium App к оборудованию Domintell:


Domintell HowItWorks.png


  • Панель iRidium (iOS/Windows/Android/OS X) подключается к DETH02 напрямую (через ваш сетевой маршрутизатор), не используя для этого дополнительных серверов и не нуждаясь в доступе к Интернет. Панель обменивается данными с DETH02: отправляет команды и получает статус устройств в системе Domintell.
  • К DETH02 может быть подключена одна панель управления. Одновременное подключение нескольких панелей можно настроить только с помощью iRidium Gate.
  • Управление Domintell через модули DETH03, DETH04, DETH07 невозможно.



↑ К оглавлению

Подключение к Domintell

Добавьте драйвер Domintell из Базы iRidium в свой проект и настройте параметры подключения к оборудованию. Это можно сделать при помощи сканирования шины Domintell или вручную:

Сканирование Domintell

Используется для автоматического формирования списка устройств в шине и команд для этих устройств.


Создайте новый проект iRidium и запустите сканирование:

Domintell scan function.png

  • IP - локальный IP-адрес модуля DETH02
  • Port - порт сканирования. Совпадает с портом управления Domintell


Сохраните модули и переменные, которыми хотите управлять в проекте с помощью Domintell Light Protocol:

Domintell scan result.png


Параметры подключения к Domintell

Domintell connection.png

Параметры подключения:

  • Host - IP-адрес шлюза DETH02
  • Port - порт управления
  • Password - пароль для защищенного доступа
  • Update Time (мс) - частота принудительно опроса устройств Domintell (периодическое обновление статуса всех устройств)


Для работы через Интернет, в настройках подключения указывается публичный IP-адрес маршрутизатора, к которому подключен контроллер. Для маршрутизатора настраивается служба проброса порта (Port Forwarding), что делает возможным удаленное управление - обращение к локальному (приватному) адресу управляемого контроллера из сети Интернет.

Узнать публичный IP-адрес своего маршрутизатора Вы можете при помощи внешних сервисов, например Яндекс.Интернет 

Для работы драйвера Domintell нужна Лицензия iRidium


Параметры устройств Domintell

Устройства: диммеры, реле, LED дисплеи и др. управляются с помощью Domintell Light Protocol, чтобы обратиться к конкретному устройству в шине, нужно настроить его параметры: тип и серийный номер.

Настройка производится автоматически при сканировании шины.

Domintell sub devices.png
Name - имя модуля, выбирается произвольно
Module - тип модуля, определяет его назначение и доступные команды
Serial Number - серийный номер модуля в системе Domintell. Соответствует адресу модуля в Domintell Programmation. Указывается в десятичном виде.


Commands - список команд для отправки устройству
Feedbacks - список обратных связей, которые нужно получать от устройства


↑ К оглавлению

Переключение между Локальным и Интернет-соединением

Если панель управления не должна терять возможность соединения с системой, когда перемещается за пределы её Wi-Fi сети, то нужно настроить в проекте переключение интернет-локальная сеть.

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


Attention.png В iRidium переключение Wi-Fi/3G автоматически НЕ производится. Для переключения интернет-локальная сеть, в вашем проекте должны быть специально настроенные кнопки. Настройки см. далее.
Attention.png Чтобы управление системой работало удаленно, нужно открыть систему для внешнего доступа -
настроить службу Port Forwarding.
Attention.png Чтобы обезопасить оборудование от стороннего вмешательства, рекомендуем использовать защищенное соединение с удаленной системой (VPN)


Настроим переключение Wi-Fi/3G в проекте iRidium:

Scripts PpenTemplate.png

1. Откройте редактор скриптов в iRidium GUI Editor.

2. Скачайте и добавьте в проект шаблон переключения Wi-Fi/3G (Add Script from file):
скачать шаблон переключения Wi-Fi/3G

Переключение Wi-Fi/3G производится с помощью скриптовой функции SetParameters

Настроим параметры переключения Wi-Fi/3G:

function Internal_1() // Function name
{
IR.GetDevice('Domintell (UDP)').SetParameters({Host: '192.168.0.101', Port: '17481', Password: 'admin', UpdateTime: '1500'}); // Driver Name + Parameters
}
function External_1()
{
IR.GetDevice('Domintell (UDP)').SetParameters({Host: '220.115.10.10', Port: '17481', Password: 'admin', UpdateTime: '1500'});
}

В настройках команд укажем:

  • Function name – имя функции (команды) переключения. Две функции в одном проекте не должны называться одинаково
  • Driver Name – имя драйвера, у которого меняем параметры
  • Parameters – набор параметров подключения, который нужно применить к драйверу


Привяжем команды к кнопкам:

  1. Выберите кнопку, которая будет отвечать за переключение Wi-Fi/3G.
    Откройте свойства этой кнопки: Object Properties > Programming
  2. Откройте Macros Editor кнопки для события Press или Release
  3. Выберите команду Script Call и двойным кликом добавьте ее
  4. В выпадающем списке выберите имя функции, которую нужно вызвать. Создайте команду

Script call internal-external.png


Настроим доступ к оборудованию из Интернета:

Для этого откроем порты оборудования для удаленного доступа.


Загрузить пример переключения Wi-Fi/3G (проект) >>

↑ К оглавлению

Принципы отправки команд

Для отправки команд и получения данных о состоянии оборудования системы, драйвер Domintell имеет 2 вкладки:

  • Commands - команды для установки значений управляемых переменных
  • Feedbacks - каналы получения обратной связи от управляемых переменных

Информация по управлению оборудованием Domintell доступна в разделе 

Примеры управления оборудованием Domintell


Модули с поддержкой Domintell Light Protocol

Список модулей, которыми можно управлять напрямую из iRidium:

Эмуляция нажатия (кнопка, модуль ввода)
DPBUT1 (BU1), DPBUT2 (BU2), DPBUT4 (BU4), DPBUT6 (BU6), DISM04 (IS4), DISM08 (IS8)
Звуковой модуль
DAMPLI01 (AMP)
Релейная функция
DBIR01 (BIR), DMR01 (DMR), DTRP01 (TRP), DLED01 (LED)
Шторы (реверсивный привод)
DTRV01 (TRV), DTRP02 (TPV), DTRVBT01 (V24)
Диммерная функция
DDIM01 (DIM), DOUT10V01 (D10)
Температура: чтение статуса и установка режима
DLCD03 (LC3), DPBTLCD0x (PBL), DTEM01 (TE1), DTEM02 (TE2), DTSC01_03 (TSB), DTSC04 (LT4)
Отображение статусов
DMOV01 (DET), DIN10V01 (I10), DISM04 (IS4), DISM08 (IS8)
Системные функции
SOFT_VAR (VAR), SYS_VAR (SYS), MEM (MEM), SFE (SFE), ZON (ZON)
Фанкойлы
FAN01 (FAN)


Работа с модулями, не входящими в список Domintell Light Protocol:

Если вы не нашли один из своих модулей в списке Light Protocol, это означает, что управление модулем напрямую не поддерживается.
Необходимо отправлять команду "%I" на Input, который управляет интересующим вас модулем: симулировать нажатие на клавиши, настроенные для контроля модуля в системе Domintell.
Например, один из модулей, не поддерживающих прямое управление через Domintell Light Protocol - это DIREMIT01. Чтобы отправить ИК команды через этот модуль, необходимо настроить связи между DIREMIT01 и Input (через Domintell Programation). Таким образом, достаточно просто симулировать активацию Input.

↑ К оглавлению

Эмуляция работы проекта

Эмулятор (Emulator)

- это приложение iRidium для Windows, которое можно запустить из редактора GUI Editor для проверки своего проекта. Эмулятор может работать с лицензией (с подключением к оборудованию) и без лицензии, когда активна только графическая часть проекта.


Режимы работы Эмулятора (см. GUI Editor > Tools > Options > Emulator):

Без лицензии (Demo Mode: on) – подключение к оборудованию не будет работать
С лицензией (License Path: [...]) – когда файл лицензии выбран, Эмулятор работает в режиме полной функциональности, с возможностью подключения к оборудованию.


Укажите путь к файлу лицензии для Эмулятора (GUI Editor > Tools > Options > Emulator):

Path to the license.png

* При активной опции Demo Mode, GUI Editor не будет показывать предупреждение о том, что проект запускается без подключения к оборудованию (без лицензии). Проверьте наличие лицензии, когда настраиваете свой проект.


Горячие клавиши и настройки Эмулятора

Нажмите F5, чтобы запустить Эмулятор.
Нажимте F8, чтобы открыть настройки Эмулятора (пароль: 2007)
Нажмите F4, чтобы открыть лог Эмулятора.


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

При активации лицензии для iPad/iPhone/Android/Mac, вы не получаете лицензии для ПК, где установлена среда разработки iRidium Mobile. Лицензия для ПК нужна, чтобы клиент iRidium на ПК (в том числе, клиент-Эмулятор) работал в режиме полной функциональности. Ее нужно приобрести отдельно (или использовать бесплатный Trial)


Логирование на Windows

Log window.png

iRidium Log - окно, куда в текстовом виде выводится информация о работе iRidium, уведомления, сообщения об ошибках и логи iRidium Script (IR.Log).


Нажмите F4, чтобы запустить лог iRidium на Windows

↑ К оглавлению

Запуск проекта на управляющей панели

Загрузка и запуск проекта iRdidium на управляющей панели производится при помощи приложения iRidium Transfer, установленного на Ваш ПК. Также Вы можете загрузить проект на панель из редактора посредством Transfer.

  • Инструкция по загрузке проекта iRidium на управляющую панель: iRidium Transfer.
  • Инструкция по настройке проекта iRidium на управляющей панели: iRidium App

↑ К оглавлению

Источник — «http://wiki2.iridiummobile.ru/index.php?title=Настройка_взаимодействия_с_Domintell&oldid=9105»