Перейти к основному содержимому
Подсказка

iRidium для Clipsal

набор инструментов для создания интерфейсов управления оборудованием Clipsal

документация обновлена 01.01.2024

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

обучение:
вебинары и видео-уроки >>

скачать:

Описание

iRidium для Clipsal - это набор инструментов, позволяющий создать интерфейс для управления домом или офисом на базе оборудования Clipsal.

iRidium для Clipsal позволяет панели управления (iOS, Android, Windows, Mac) подключиться к оборудованию напрямую, через через CNI Ethernet интерфейс, или через программу C-Gate. При работе через CNI Ethernet интерфейс, Clipsal поддерживает 1 подключение (1 панель управления в единицу времени). При работе через C-Gate, число подключений регулируется в настройках программы. Увеличить количество подключений через CNI Ethernet интерфейс можно с помощью iRidium Server.


Подключение

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

Способы подключения к Clipsal

Разные способы связи обеспечивают локальную работу и работу через Интернет

Clipsal_scheme.png

  1. CNI Ethernet интерфейс

    Clipsal_Inet_scheme.png

  2. C-Gate

1. CNI Ethernet интерфейс (драйвер Clipsal) позволяет подключиться к C-Bus напрямую, но обеспечивает работу только одной панели управления одновременно

2. C-Gate (драйвер Clipsal Gate) требует установки программного обеспечения на ПК, но обеспечивает работу нескольких панелей управления одновременно.

Оба способа связи дают возможность подключения к C-Bus через Интернет.


Добавление драйвера Clipsal в iRidium

Импортируем список устройств, которыми можно управлять, из *.xml файла C-Bus Toolkit.

Создайте и настройте проект управления Clipsal в C-Bus Toolkit. Названия команд будут формироваться как "Приложение_Имя группы > Lighting_Group 1" Clipsal1.png

Файл проекта расположен в папке ПО Clipsal: Clipsal\C-Gate2\tag и имеет формат .xml Clipsal2.png

Выберите способ подключения: Clipsal (CNI Ethernet интерфейс) или Clipsal Gate (C-Gate)

Clipsal3.png При работе через Clipsal (CNI Ethernet интерфейс) можно выбрать только 1 Network

Clipsal4.png При работе через Clipsal Gate (C-Gate) можно выбрать только несколько Networks

Clipsal5.png Поставьте галочку рядом с драйвером, чтобы добавить его в проект. Нажмите ОК.

Настройки драйверов Clipsal:

Clipsal8.png

  • Log Level - уровень логирования;
  • Host - IP-адрес контроллера;
  • Port - TCP порт подключения (10001);
  • Keep Alive - интервал проверки TCP соединения. В случае отсутствия ответа на запрос Keep Alive, драйвер будет принудительно переведён в состояние отключен. Параметр сделан для корректного отображения онлайн-статуса при экстренном / неправильном отключении клиента. 0 - отключение настройки;

Clipsal6.png

  • Log Level - уровень логирования;
  • Host - IP-адрес контроллера;
  • Port - TCP порт для подключения (20023);
  • Parameters - имя проекта в C-Bus Toolkit с учетом регистра.

Commands & Feedbacks

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

Команда Clipsal в iRidium Studio:

Clipsal9.png

Clipsal

  • Name - имя команды
  • Unit Address - номер модуля, которому адресована команда (Network/Units/Address в C-Bus Toolkit)
  • Application - приложение из C-Bus Toolkit
  • Application Number - номер приложения из C-Bus Toolkit (при использовании приложения не по-умолчанию)
  • Group - групповой адрес из C-Bus Toolkit
  • Command - команда, отправляемая на групповой адрес
  • Parameter - дополнительное условие для команды (используется не со всеми приложениями)
  • ParamArg - аргумент параметра (используется не со всеми приложениями)

Clipsal7.png

Clipsal Gate

  • Name - имя команды
  • Unit Address - номер модуля, которому адресована команда (Network/Units/Address в C-Bus Toolkit)
  • Network ID - номер сети в проекте из C-Bus Toolkit
  • Application - приложение из C-Bus Toolkit
  • Application Number - номер приложения из C-Bus Toolkit (при использовании приложения не по-умолчанию)
  • Group - групповой адрес из C-Bus Toolkit
  • Command - команда, отправляемая на групповой адрес
  • Parameter - дополнительное условие для команды (используется не со всеми приложениями)
  • ParamArg - аргумент параметра (используется не со всеми приложениями)

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

  • Команда привязывается к графическому элементу с указанием значения, которое нужно передать в регистр при нажатии на графический элемент
  • Канал обратной привяжите к графическому элементу, чтобы отобразить состояние регистра

Чтобы связать команду или канал с графическим элементом, используйте метод drag&drop - перетягивание.

  • чтобы быстро создать Feedback с теми же настройками, что у Command, нажмите на Command правой кнопкой мыши и выберите опцию "Create Feedback". Создать Feedback можно сразу для нескольких регистров.

Настройка C-Gate

C-Gate разрешает подключение только тех IP-адресов, что заранее указаны в его настройках. Добавьте IP-адрес панели управления в список разрешенных: файл access.txt в директории ПО Clipsal: Clipsal\C-Gate2\config .

Каждая панель управления должна быть описана в файле как новая строка: Clipsal_access.png interface 192.168.0.1 Program

Сохраните изменения в файле и перезапустите службу C-Gate через меню Пуск: Clipsal_cgate_restart.png


Смена настроек подключения


Управление оборудованием

SendRecieve.png

Для управления оборудованием настройте команды (Commands) и каналы обратной связи (Feedbacks). Чтобы отправить команду, перетяните ее на графический элемент и укажите значение (Value), которое необходимо отправить. Чтобы отобразить значение с канала обратной связи, перетащите Feedback на графический элемент, и укажите, каким образом вывести значение (Value).

Подробнее о работе с графическими элементами написано в статье "Типы графических элементов".

Возможные настройки команд и каналов обратной связи представлены далее:


Lighting

В Application Lighting можно отправить одну из команд, перечисленных в списке Command:

Command:

Network ID1...nномер сети в проекте C-Bus Toolkit
ApplicationLightingприложение C-Bus Toolkit
Group0...7групповой адерс C-Bus Toolkit
Command *Onвключить
Offвыключить
Rampнарастить до указанного значения
Terminate Rampпрервать наращивание (Ramp)
ParamArginstantaneouslyустановить значение яркости - применяется сразу
over N seconds / N minutesустановить значение яркости с нарастанием в течение указанного времени
Value *-для Command: On, Off, Terminate Ramp оставьте Value пустым
0...255для Command: Ramp яркость изменяется в диапазоне 0...255.

*Value - укажите при перетягивании команды на графический элемент

Feedback:

Обратную связь следует получать именно с этими настройками:

Network ID1...nномер сети в проекте C-Bus Toolkit
ApplicationLightingприложение C-Bus Toolkit
Group0...7групповой адерс C-Bus Toolkit
Command *Rampполучить текущую яркость
ParamArginstantaneouslyполучить значение яркости
Value *0...255текущая яркость
  • Value - приходит в канал обратной связи, используйте для отображения на элементах