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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Project Overview:

• I/O - входы/выходы; открывает для редактирования теги сервера и теги драйвера
• Config - настройки серверного проекта

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

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

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

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

2. Импорт

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

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

• 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

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

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

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

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

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

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

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

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

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

• Name - короткое имя (по-умолчанию: имя команды драйвера)
• Full Name - полное имя серверного канала для обращения из скрипта
• Description - описание (опционально)
• Script - выполнить JavaScript функцию без аргументов каждый раз при активации канала

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

• 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 витруальный тег по ПКМ:

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 необходимой команды выберите нужную функцию для обоих команд.

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

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

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

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