Как создать серверный проект в iRidium Studio

Ridium Server Project – это файл проекта, созданный в iRidium Studio.

Состоит из драйверной части (команд управления

оборудованием), виртуальных серверных команд и каналов и файлов скриптов (не обязательно). Проекты iRidium имеют

формат *.SIRPZ, загружается на iRidium Server.



Описание создания серверного проекта осуществляется на примере ранее созданной и уже работающей инсталляции на оборудовании KNX. Драйвер для управления импортирован из ранее созданного в iRidium GUI Editor V.2.* проекта.



Создание проекта iRidium Server состоит из этапов:



ServerPrincipalSceemDriverLayer.png
  1. Сформировать на сервере список оборудования, которым нужно управлять: настроить драйверы, создать список команд и каналов обратной связи
  2. Все команды и каналы будут автоматически спроецированы на переменные сервера. К этим переменным сможет обратиться панель управления iRidium
  3. Настроить скрипты: создать функции-модификаторы для преобразования информации в переменных сервера и др.
  4. Перенести список переменных сервера в проект для панели управления. Переменные будут доступны как драйвер "iRidium Server"
  5. Настроить скрипты для панели управления (если необходимо)



1. Создать файл серверного проекта

В Меню выбрать пункт меню "New Server Project"



Image 8767


2. Назвать проект.

Дать имя новому проекту, либо оставить по-умолчанию.



3. Указать настройки подключения к серверу.

Внесите основную информацию о проекте, а так же указать настройки подключения к серверу (можно указать позже).



Image 8803



Для удобства дальнейшей работы заполните поля в разделе Settings:

  • Server host - IP адрес сервера
  • Server port - порт подключения к серверу (по-умолчанию: 30464)
  • Login (функционал в разработке) - логин для подключения панелей к серверу
  • Password (бфункционал в разработке) - пароль для подключения панелей к серверу
  • System ID (функционал в разработке) - уникальный идентификатор сервера, будет использован в системе push нотификаций и DDNS сервере
На этапе формирования панельных проектов, привязанных к вашему серверному проекту, эти настройки автоматически будут импортированы, что позволит вам не вводить настройки вручную в каждый из панельных проектов.
О назначении других полей прочитайте здесь.


4. Перейти в рабочую вкладку I/O

(подробнее о назначении вкладок здесь):
Project Overview позволяет перемещаться между окнами настроек сервера:



Editor window Server Project Overview.png



Project Overview:







5. Добавить необходимые драйвера в проект

В серверном проекте драйвера хранятся на панели Driver Tags. Добавление драйверов осуществляется аналогично добавлению драйверов в панельный проект:



1. Добавление из базы (Device Base)

Доступно для всех драйверов, поддерживаемых iRidium.
Представляет собой drag-n-drop драйвера из вкладки DEVICE BASE в свободное пространство панели DRIVERS (в область ПОД виртуальными тегами).



Image 8770



2. Импорт

Доступ к функции импорта осуществляется из меню File->Import и по кнопке на панели DRIVERS:
Image 8843



Функция позволяет импортировать в проект:

  • ETS Project - список групповых адресов или датапоинтов, сформированный в ETS;
  • Simple project - джойны из Crestron SIMPL™ Windows® Software.
  • Clipsal project - групповые адреса из C-Bus Toolkit.
  • Iridium Archive Project (*irpz) - драйвера из ранее созданных проектов iRIdium. Например, вы можете добавить в серверный проект драйвера, созданные в iRidium GUI Editor v2.*, что позволит вам наиболее быстро перенести рабочий проект на сервер.
  • Modbus CSV (*.csv) - каналы для драйвера Modbus, сформированные в Microsoft Excel.
3. Сканирование



Доступ к функции сканирования осуществляется по кнопке на панели DRIVERS
Image 8844
Функция сканирует вашу локальную сеть и формирует драйвера для управления следующими устройствами

  • HDL-BUS Pro.
  • Duotecno.
  • Domintell.

5. Указать настройки подключения к оборудованию:

Если вы импортировали драйвера из проекта *.irpz, ранее созданного в iRidium GUI Editor, настройки уже будут заполнены.
Image 8846



6. Настроить команды управления оборудованием и каналы обратной связи:


Настройте команды и каналы обратной связи на панели DRIVERS, точно так же, как и во вкладке Project Device Panel панельного проекта. Инструкции по каждому драйверу можно найти на Wiki V.2
Если вы импортировали ранее созданный проект, то команды и каналы обратной связи уже настроены.



7. Настроить привязанные к драйверу серверные каналы и теги:


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



Поля, которые можно настроить у серверного канала (для записи):
Image 8847

  • Name - короткое имя (по-умолчанию: имя команды драйвера)
  • Full Name - полное имя серверного канала для обращения из скрипта
  • Description - описание (опционально)
  • Script - выполнить JavaScript функцию без аргументов каждый раз при активации канала
Поля, которые можно настроить у серверного тега (для чтения):
Image 8799
  • Name - короткое имя (по-умолчанию: имя канала обратной связи драйвера)
  • Full Tag Name - полное имя серверного тега для обращения из скрипта
  • Description - описание (опционально)
  • Store In DB - сохранение всех измененных значений в базу данных
  • Access - тип переменной: Public - можно изменить с панели управления, Private - можно изменить только с сервера
  • Deadband - погрешность изменения, которую не нужно учитывать при построении графика на основании данных тега. Например, при Deadband: 0.5, изменение переменной на 0.3 не отобразится на графике в приложении-клиенте. (Параметр разделения целой части числа берется от настроенных на вашем компьютере региональных настроек, в случае если у вас стоит "Символ разделения" запятая, то будет выглядеть следующим образом 0,3 и 0,5. В случае с точкой 0.3 и 0.5)
  • Script - выполнить JavaScript функцию без аргументов каждый раз при активации тега


!В текущей версии iRidium Studio beta нет возможности синхронизировать имена 
драйвера, каналов и тегов - т.о. дайте им окончательные имена при текущей 
настройке. Т.е., если вы уже начнете настраивать панельный проект, а после 
этого решите переименовать драйвер, каналы или теги в панели IRIDIUM 
SERVER, то при синхронизации они добавятся как новый драйвер, или как 
новый канал или фитбек и вам придется заново связывать их с элементами 
графического интерфейса.

8. Создать виртуальные переменные (опционально):


Виртуальные переменные (Virtual) - переменные, в которые можно записывать любые данные, полученные в результате работы скриптов (числа, строки, массивы). Виртуальные переменные доступны для изменения с панели управления.



  • VIrtual > Channels - переменные, доступные для записи
  • VIrtual > Tags - переменные, доступные для чтения
Для примера, создадим 2 виртуальных серверных канала (с именами External KNX IP и Internal KNX IP), которые при активации будут вызывать функцию SetParameters и переключать настройки драйвера с внешних на внутренние и наоборот. А также виртуальный серверный тег "Status", в который мы будем записывать текст из скрипта:



1. Создайте 2 виртуальный канала и 1 витруальный тег по ПКМ:



Image 8801
2. Перейдите в редактор JS-скриптов. Создайте файл скрипта с необходимыми функциями:

function Internal_KNX_IP()
{
 IR.Log("Internal KNX IP"); //выводит в лог сервера
 IR.GetDevice("KNX").SetParameters({Host: "192.168.0.152", Port: "3671", ConnectTime: "120000", SendTime: "0", PingTime: "60000"}); // меняет настройки подключения к драйверу
 IR.SetVariable("Server.Tags.Status","We try to connect to Internal KNX IP"); //записывает в виртуальный тег Status текст
};
function External_KNX_IP()
{
 IR.Log("External KNX IP"); //выводит в лог сервера
 IR.GetDevice("KNX").SetParameters({Host: "213.114.30.30", Port: "3671", ConnectTime: "120000", SendTime: "0", PingTime: "60000"}); // меняет настройки подключения к драйверу
 IR.SetVariable("Server.Tags.Status","We try to connect to External KNX IP"); //записывает в виртуальный тег Status текст
};
3. В поле Script необходимой команды выберите нужную функцию для обоих команд.



Image 8802

9. Написать необходимые скрипты (опционально).

Как обращаться к каналам и тегам серверного проекта описано тут .



10. Сохранить проект.

Test KNX Project.sirpz
Далее, читайте статью, как связать серверный проект с панельным проектом.

Dit artikel is nuttig voor 8 personen. Is dit artikel nuttig voor u?