Материал из for iRidium developers
Перейти к: навигация, поиск
Other languages:
English • ‎русский

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


iRidium KNX Server (UMC Technology) - это программная реализация iRidium Server, которая запускается как демон или консольное приложение на контроллерах UMC Technology.

Для работы iRidium Server необходима лицензия iRidium 3

Купить контроллер UMC Technology

IRidiumServerUMCPicture.png

Технические характеристики:

  • Процессор 1GHz CPU FreeScale imx6
  • Память оперативная 512 MB
  • Память энергонезависимая (исполняемый код и данные) 1GB + 4GB microSD
  • Модель "UMC-C2": KNX TP1-256, LAN, USB A
  • Питание 12...30 В постоянного тока
  • Потребляемая мощность не более 2.5 Вт


Рекомендованная нагрузка:

  • до 20 панелей управления
  • 1000 тегов iRidium Server


iRidium Server подключается к оборудованию и передает ему команды от панелей управления. Панели управления подключаются к серверу для управления через него оборудованием, получения обратной связи, загрузки логов и базы данных.

База данных может хранить информацию о работе сервера и оборудования за весь период времени, когда сервер был запущен. Панель управления по данным из базы может выводить логи и строить графики изменения переменных сервера.

IRidiumServerHowItWorks.png


Первый запуск

Подключите Ethernet и питание (24В) к контроллеру UMC, подождите около 30 секунд после подачи питания. Не подключайте UMC напрямую к ПК.

На корпусе UMC указан его статический IP адрес. Используйте этот адрес, чтобы открыть web-интерфейс сервера в браузере:


Сервер получает лицензию и проект из облака, но, на сервере авторизуется не пользователь, а разработчик (интегратор) с помощью логина и пароля на сайте iRidium Mobile. Запустите сервер, откройте web-интерфейс и активируйте сервер:

  1. Введите логин и пароль аккаунта интегратора, в котором вы создали объект с серверным проектом
  2. Выберите сервисный пароль, чтобы заходить в настройки сервера. По умолчанию 2007
  3. Далее, вы увидите список объектов и серверных проектов из iRidium Cloud. Выберите проект, который должен работать на сервере и нажмите на него, чтобы скачать (пропустите этот шаг, если еще не пользовались облаком)
  4. В web-интерфейсе сервера, вкладка Cloud, вы можете скачать на сервер проект (см. Projects) или дезактивировать сервер (см. Deactivate Server). На сервер с включенным режимом Test Mode вы сможете загружать проекты из iRidium Transfer


CloudServerAuthorize.png
CloudServerServicePass.png
CloudServerProj.png
CloudServerWebCloudTools.png



Измените IP адрес сервера так, чтобы он подходил вашей сетевой инфраструктуре в Settings > Network:

# /etc/network/interfaces -- configuration file for ifup(8), ifdown(8)
 
# The loopback interface
auto lo
iface lo inet loopback
 
# Wired or wireless interfaces
auto eth0
# iface eth0 inet dhcp
iface eth0 inet static
hwaddress ether 70:B3:D5:22:60:56
address 192.168.0.99
netmask 255.255.255.0
gateway 192.168.0.1

Запустите на ПК программу iRidium Transfer и нажмите кнопку Поиск.

В результате поиска в Transfer появится новое устройство с именем <NAME> (Server)

SetupOBserver1.png

Включите опцию "Test Mode: ON" в настройках сервера, чтобы использовать его в режиме полной функциональности. Подробнее о режимах использования читайте в разделе Политика лицензирования.

ServerTestModeOn.png

С активным Test Mode вы можете тестировать работу облачных проектов и загружать проекты из iRidium Transfer (локально, без использования iRidium Cloud).


Настройка сервера

Когда сервер установлен, можно перейти к разработке его конфигурации и логики:


Гoтовый проект загружают на iRidium Server:


Настройка KNX функционала

Контроллер UMC может работать как устройство шины KNX - принимать и отправлять команды через интерфейс KNX TP1.

Также UMC может выполнять функцию KNX IP роутера, т.е. обеспечивает связь ETS с шиной, а также работу клиентов по протоколу KNXnet/IP (но только после настройки).


Для управления оборудованием шины

Контроллер UMC может подключиться к любому удаленному KNX IP интерфейсу или роутеру для управления по протоколу KNXnet/IP (UDP) - по сети. Но, если UMC подключен к шине по KNX TP1, необходимо выбрать связь с шиной с использованием именно этого интерфейса.

1 Подключите UMC к шине KNX с помощью интерфейса KNX TP1

2 Сохраните файл проекта в формате *.pr3, *.pr4, *,pr5, *.knxproj, *.csv. Желательно использовать английский язык в имени проекта. Язык Windows должен совпадать с языком проекта для корректного импорта имен групповых адресов.

3 В iRidium Studio создайте новый проект для iRidium Server: File> New > New Server Project...

4 В меню File > Import выберите ваш ETS проект и импортируйте его. На основе проекта ETS сформируется список доступных KNX IP интерфейсов и групповых адресов.

KNX import project ETS.png

5 После импорта проекта, измените настройку Driver Type драйвера на KNX (Serial) - это KNX драйвер, обеспечивающий связь UMC с интерфейсом с интерфейсом KNX TP1. Настройки подключения к KNX полностью изменятся. Оставьте их по умолчанию и укажите только Physical Address - физический адрес UMC, как устройства шины.

KNX UMC DeviceType-OnServer.png

На этом настройка закончена. При запуске проекта на сервере UMC будет установлена связь с шиной через интерфейс TP1, UMC будет определяться как устройство шины (будет иметь свой физический адрес), хотя не будет иметь собственных групповых адресов.

Эта настройка не обеспечит работы UMC в режиме KNX IP роутера. Для него вам нужны настройки, описанные далее.


О дальнейшей настройке iRidium Server и драйвера KNX читайте в разделах:


Для настройки функции KNX IP роутера

После специальной настройки UMC может выполнять функции KNX IP роутера:

  • обеспечивает связь ETS с шиной (ищется и добавляется в ETS как KNX интерфейс)
  • обеспечивает подключение к шине клиентов по протоколу KNXnet/IP
  • обеспечивает передачу в шину мультикаст пакетов от других KNX IP интерфейсов (роутинг)


1 Подключите UMC к шине KNX с помощью интерфейса KNX TP1

2 В iRidium Studio создайте новый проект для iRidium Server: File> New > New Server Project...

3 Импортируйте и настройте (см. предыдущий раздел) или настройте вручную драйвер KNX Serial для связи UMC с шиной через KNX TP1. Укажите свободный физический адрес для UMC

KNX ass Serial UMC.png

4 Создайте пустой файл скрипта (иконка JS на верхней панели инструментов + New Script) и добавьте в него скрипт:

IR.AddListener(IR.EVENT_START,0,function() 
{
   var KNXSerial = "KNXIPClientSerial";   // name of KNX Serial driver in your project
 
   if(IR.GetDevice(KNXSerial)) { 
      IR.GetDevice(KNXSerial).SetParameters({ServerDevice: "iRidium Server"});
   }
   IR.CreateDevice(IR.DEVICE_KNX_IP_SERVER, 
                  "iRidium Server", {Port: 3671, 
                  ClientDevice: KNXSerial,
                  Routing: false // true - to turn Routing on
                  });
});

После запуска проекта с настроенным драйвером и скриптом на UMC, вы сможете найти UMC в ETS и использовать как интерфейс доступа в шине.


Сброс до заводских настроек

Для сброса контроллера UMC до заводских настроек необходимо выполнить следующие действия:

  1. На работающем контроллере нажмите белую кнопку FUNC
  2. Удерживая белую кнопку FUNC нажатой, однократно нажмите на красную кнопку RES
  3. Продолжайте удерживать нажатой белую кнопку FUNC, пока на контроллере не моргнут все светодиоды (30-40 сек.)
  4. После этого контроллер будет сброшен до заводских настроек, и ему будет присвоен заводской IP адрес, указанный на корпусе контроллера.


Аварийное обновление

Если при установке и запуске сервера возникли проблемы, вы можете получить доступ к операционной системе контроллера UMC для обновления и исправления ошибок:

Аварийное обновление UMC Server

Скачайте и установите необходимое ПО:

  1. Скачайте архив с файлами прошивки сервера. Распакуйте его после скачивания: вы должны получить папку iridiumserver с набором файлов
  2. Скачайте и установите программу WinSCP
  3. Скачайте и установите программу PuTTY


Определите IP адрес сервера доступным способом (приложением - сканером сети или по информации на роутере)

1 Запустите WinSCP. В интерфейсе программы настройте:

SetupPiServer1.png
  • File Protocol: SCP
  • Host name: IP адрес UMC
  • Port number: 22
  • User name: ваш логин (по умолчанию root)
  • Password: ваш пароль (по умолчанию root)


2 Сохраните настройки клавишей Save. Подключитесь к UMC нажав кнопку Login. Если параметры подключения были указаны верно, вы увидите окно, в правой части которого находится меню работы с файлами контроллера:

SetupUMCServer2.png

3 Скопируйте папку iridiumserver в корневой каталог UMC

4 Запустите PuTTY. В интерфейсе программы настройте:

SetupPiServer4.png
  • Host Name (or IP address): IP адрес вашего UMC
  • Port: 22 (по умолчанию)
  • Connection Type: SSH
  • Saved Session: вводим имя текущей настройки и нажимаем Save
  • Close window on exit: Only on clean exit


5 В настроенном PuTTY нажмите Open - откроется консоль.
Введите логин и пароль подключения к серверу (root/root по умолчанию).

SetupPiServer5.png
вводимый пароль не отображается в консоли - это нормально. Нажмите Enter, когда закончите ввод

6 Если логин и пароль введены верно, вы увидите:

SetupUMCServer9.png

7 Перейдите в папку iridiumserver командой cd /iridiumserver/. Проверьте содержимое папки командой ls. Вы должны увидеть папки:

SetupUMCServer10.png

8 Присвойте iridium полные права командой chmod +x iridium

9 Запустите Сервер. Для этого есть команды:

  • ./iridium - запустить сервер. При закрытии консоли сервер закроется
  • ./iridium --force --hidden - запустить сервер в фоновом режиме (как демон). При закрытии консоли сервер не закроется


Успешный запуск сервера:

SetupUMCServer11.png

В случае успешного запуска вы можете добавить сервер в Transfer, получить доступ к его web-интерфейсу и работать по основной инструкции.