Эта страница является переводом страницы IRidium Server UMC C3. Перевод выполнен на 100%.

---

iRidium server UMC C3

Инсталляция и запуск iRidium server для iRidium pro на базе контроллера UMC C3

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

Общие сведения

На данной странице описывается порядок работы с iRidium server UMC для iRidium pro, для работы с iRidium server UMC для iRidium lite перейдите по ссылке: i3 lite

Сравнение технических характеристик контроллеров семейства UMC:

Общая информация по контроллерам UMC Technology

Первое включение

1 Подключите контроллер UMC к локальной сети с ПК и маршрутизатором Ethernet-кабелем в разъём LAN. Подайте питание 24 В. Подождите около 30 секунд после подачи питания, должен загореться светодиод зелёным цветом.

В маршрутизаторе должен быть активирован DHCP-сервер.

2 С помощью приложения iRidium transfer или стандартным сканером LAN-сети (например, Advanced Port Scanner) определите IP-адрес контроллера UMC.

3 Используйте этот адрес, чтобы открыть веб-интерфейс сервера в браузере:

• http://192.168.1.254:8888/ (укажите адрес своего UMC контроллера!)

Сервер получает лицензию и проект из облака после авторизации разработчика (интегратора) в веб-интерфейсе сервера с учетной записью на сайте iridi.com. Для этого запустите сервер, откройте web-интерфейс и активируйте сервер:

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

Изменение IP-адреса

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

Вы можете назначить:

• Динамический адрес (DHCP) или
• Статический адрес

DHCP-адрес (выдаётся автоматически):

Статический IP-адрес:

Чтобы применить настройки, нажмите Save, вернитесь на главную страницу веб-интерфейса и нажмите кнопку Reboot System. Веб-интерфейс теперь станет доступен по новому адресу.

В случае потери доступа к веб-интерфейсу используйте инструкцию Сброс до заводских настроек, чтобы вернуть настройки IP-адреса по умолчанию.

MAC адрес должен быть уникален для каждого устройства!

Обновление сервера

Откройте веб-интерфейс сервера на вкладке System > Info, нажмите кнопку Update. Откроется поле ввода, в него вставьте ссылку на скачивание файла обновления сервера.

Ссылку можно скопировать на сайте iRidium mobile, в разделе Загрузки.

Ссылка на последнюю версию iRidium server UMC для iRidium pro:

https://www.iridiummobile.net/redirects/?go=iRidium_Server_UMC

Вставьте ссылку в поле ввода и нажмите кнопку UPDATE.

Веб-интерфейс сервера станет недоступен на несколько минут, затем обновлённый сервер запустится автоматически.

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

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

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

1 На отключенном контроллере нажмите кнопку Prog.

2 Удерживая кнопку Prog нажатой, подайте питание на контроллер.

3 Продолжайте удерживать нажатой кнопку Prog до тех пор, пока на контроллере светодиод трижды не изменит цвет в порядке: красный > зелёный > синий.

4 После этого контроллер сбросится на заводские настройки: активируется автоматическое получение адреса (DHCP).

Восстановление работоспособности

Если вы не можете открыть веб-интерфейс UMC (сервер не запускается, веб-интерфейс не работает), используйте инструкцию по аварийному запуску/обновлению/откату прошивки. Для этого необходимо получить доступ к устройству через консольную строку.

Получение доступа через консоль

1 Определите IP-адрес контроллера удобным способом (например, с помощью iRidium transfer или сканером LAN-сети).

2 Скачайте и запустите программу PuTTY.

3 Настройте программу следующим образом:

• Host Name (or IP address): <IP адрес контроллера UMC>
• Port: 22
• Connection Type: SSH

и нажмите Open.

4 В открывшейся консоли введите:

• Login as: root
• root@XXX.XXX.XXX.XXX's password: root (пароль не отображается во время ввода)

5 Если логин и пароль введены верно, вы увидите приветственное сообщение UMC. Станет доступна консольная строка, с помощью которой можно выполнить принудительный запуск сервера, обновление и откат сервера.

Принудительный запуск сервера

1 Откройте папку /iridiumserver/:
cd /iridiumserver/

2 Введите команду запуска сервера в фоновом режиме (чтобы сервер не закрылся при закрытии PuTTY)
./iridium --force --hidden

3 В случае успеха сервер запустится и будет готов к работе.

Обновление и откат версии

Данные действия выполняются в случае полной потери доступа к веб-интерфейсу сервера. Если доступ к интернету отсутствует, то воспользуйтесь инструкцией Обновление и откат версии при отсутствии доступа к интернету.

1 Загрузите последнюю версию Iridium Server UMC в корневую папку контроллера:
wget -O iridiumserver.ipk http://www.iridiummobile.net/redirects/?go=iRidium_Server_UMC

For i3 lite server:
wget -O iridiumserver.ipk http://www.iridiummobile.net/redirects/?go=iRidium_Server_UMC_Lite

2 Проверьте содержимое папки (убедитесь, что файл .ipk присутствует в папке):
ls

3 Запустите установку более новой или такой же версии сервера:
opkg install iridiumserver.ipk

Или откатите версию сервера до более старой:
opkg install --force-downgrade iridiumserver.ipk

Если при установке более старой версии не использовать ключ --force-downgrade, установка не будет произведена.

4 После установки сервер запустится автоматически. Сервер готов к работе.

Обновление и откат версии при отсутствии доступа к интернету

1 Установите и запустите WinSCP:

• Нажмите на вкладку New Site, настройте:
• File Protocol: SCP
• Host name: <IP-адрес контроллера UMC>
• Port number: 22
• User name: root
• Password: root

Нажмите Login.

2 Скопируйте файл установки сервера UMC (.ipk) в корневую папку /root контроллера UMC, используя WinSCP.

3 В консольной строке проверьте содержимое корневой папки (убедитесь, что файл .ipk присутствует):
ls

4 Запустите установку более новой или такой же версии сервера:
opkg install <file-name>.ipk

Или откатите версию сервера до более старой:
opkg install --force-downgrade <file-name>.ipk

Если при установке более старой версии не использовать ключ --force-downgrade, установка не будет произведена.

5 После установки сервер запустится автоматически. Сервер готов к работе.

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

Когда сервер подготовлен, перейдите к разработке его конфигурации и логики: Серверный проект в iRidium studio

Готовый проект загрузите на iRidium server: Запуск конфигурации iRidium server

Настройка интерфейса RS485

Контроллер UMC C3 имеет встроенный порт RS485, который можно использовать, например, для обмена данными по протоколу Modbus RTU или Modbus ASCII.

Основной порт RS485 контроллера UMC C3 не имеет гальванической развязки. Используйте опциональный порт (в верхней части устройства), если вам нужна гальваническая развязка.

Далее приводится пример настройки интерфейса RS485 для работы по протоколу Modbus RTU. Другие протоколы (драйверы) настраиваются аналогично.

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

2 Добавьте драйвер Modbus RTU в проект:

3 Настройте параметры соединения:

• Host: номер порта в ОС Linux (/dev/ttymxc2 или /dev/ttymxc3)
• Update Time: время обновления данных в миллисекундах
• Baud Rate: скорость передачи данных, бит/с (зависит от настройки устройств на шине)
• Data Bits: число бит данных (зависит от настройки устройств на шине, стандартно 8)
• Parity: проверка чётности (зависит от настройки устройств на шине, стандартно Even)
• Stop bits: число стоповых битов (зависит от настройки устройств на шине, стандартно 1)
• Coil Write Function: тип Modbus-функции для отправки бинарных данных в шину (зависит от наличия поддержки multiple-функции Modbus в устройствах на шине)
• Holding Write Function: тип Modbus-функции для отправки аналоговых данных в шину (зависит от наличия поддержки multiple-функции Modbus в устройствах на шине)

Изучите руководства по эксплуатации остальных устройств на шине RS485: настройте одинаковую скорость передачи данных на всех устройствах, задайте одинаковые параметры Data Bits, Parity, Stop Bits. Помимо этого, каждое устройство на шине должно иметь уникальный идентификатор (Device ID).

4 Настройте необходимое количество каналов. В каждом канале необходимо задать параметры Modbus RTU:

• Device ID: идентификационный номер slave-устройства
• Type: тип данных (Coil, Discrete Input, Holding Register, Input Register)
• Address: адрес, по которому размещаются данные в slave-устройстве

5 После этого проект настроен для передачи данных по протоколу Modbus RTU.

Настройка интерфейса HDL Buspro

Порты RS485 и LAN можно использовать для реализации обмена данными по протоколу HDL Buspro.

Основной порт RS485 контроллера UMC C3 не имеет гальванической развязки. Используйте опциональный порт (в верхней части устройства), если вам нужна гальваническая развязка.

Активация HDL-шлюза через веб-интерфейс

HDL-шлюз - это связь между портами LAN и RS485: при включенном HDL-шлюзе устройства, находящиеся на шине RS485, могут обмениваться данными с устройствами, находящимися в сети Ethernet, как будто бы они все находятся на одной шине. На стороне Ethernet-сети используется протокол UDP.

Самый простой способ - активировать режим HDL-шлюза в веб-интерфейсе сервера на вкладке Network > SYSTEM > Other > Server working mode.

Драйверы типа "HDL-BUS Pro (Serial)" и "HDL-BUS Pro (UDP)" должны отсутствовать в проекте.

В этом случае сервер не сможет управлять устройствами HDL Buspro, так как будут отсутствовать необходимые драйверы в проекте.

Фильтр HDL-шлюза

HDL-шлюз может фильтровать передачу команд, передающихся по шине, по идентификатору подсети Subnet ID.
Для использования этой функции необходимо:

• перейти в веб интерфейс сервера на вкладку System/Other

• в поле Server working mode установить значение HDL

• установить значение Enable в поле Gateway HDL filter
• в поле Gateway HDL subnetid filter вписать значение Subnet ID, по которому будет производиться фильтрация.

Теперь сервер при получении данных будет проверять Subnet ID устройства, которому эти данные принадлежат, и, если Subnet ID совпадает с указанным в фильтре, сервер обработает данные, если нет - проигнорирует их.

Настройка HDL Buspro на стороне RS485

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

2 Добавьте драйвер HDL Buspro Network (RS232) и необходимое количество устройств HDL Buspro в проект:

3 Настройте общие параметры шины:

• Host: номер порта в ОС Linux (/dev/ttymxc2 или /dev/ttymxc3)
• Baud Rate: 9600
• Data Bits: 8
• Parity: Even
• Stop bits: 1
• Send Timeout: период отправки данных на шину HDL Buspro в миллисекундах

4 Настройте параметры каждого устройства на шине HDL Buspro.

• Subnet ID: номер подсети
• Device ID: уникальный идентификатор устройства

Каждое устройство в пределах подсети шины должно иметь уникальный идентификатор (Device ID).

5 Задайте параметры каждого канала:

Наиболее важные параметры Command и Feedback драйвера HDL Buspro:

• Operation code: операция (команда протокола HDL Buspro)
• Option: опция операции
• Channel: канал многоканального устройства
• Parameter: параметр многофункционального устройства
• Need confirm: требуется подтверждение (рекомендуется установить Disable)
• Use Timer: циклическая отправка команды (true - включить, false - отключить)
• Timer, s: период циклической отправки команды в секундах

Изучите руководство по эксплуатации устройства HDL Buspro, чтобы правильно настроить сервер для обмена данными с ним.

6 После этого проект настроен для передачи данных по протоколу HDL Buspro через порт RS485.

Настройка HDL Buspro на стороне LAN

1 Добавьте драйвер HDL Buspro Network (UDP) и необходимое количество устройств HDL Buspro в проект:

2 Настройте общие параметры сети:

• Send timeout: период отправки данных в сеть HDL Buspro в миллисекундах
• Connect mode: способ подключения к сети HDL Buspro (Local - в локальной сети, Internet - с авторизацией по логину и паролю, Remote Server - с использованием удалённого сервера HDL Remote Server)
• Broadcast: маска IP-адресов широковещательной рассылки
• Fast Feedback: получение быстрого отклика без ожидания отклика от реального устройства
• Host: IP-адрес сервера
• Port: порт сервера
• Remote Server Priority: приоритет удалённого сервера (рекомендуется значение true)
• Login: логин для доступа к HDL Remote Server или в интернет
• Password: пароль для доступа к HDL Remote Server или в интернет
• External Port: удалённый порт
• Project Name: имя проекта
• Group Name: имя группы

3 Настройте параметры каждого устройства на шине HDL Buspro и параметры каждого его канала (по аналогии с предыдущим разделом).

4 После этого проект настроен для передачи данных по протоколу HDL Buspro через порт LAN.

Активация HDL-шлюза с помощью скрипта

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

IR.AddListener(IR.EVENT_START, 0, function() 
{                                   
   var HDL_UDP = IR.GetDevice("HDL Buspro Network (UDP)"); //name of HDL Buspro (UDP) driver in your project
   var HDL_Serial = IR.GetDevice("HDL Buspro Network (RS232)"); //name of HDL Buspro (RS232) driver in your project
 
    if (HDL_UDP && HDL_Serial) { //check for drivers existence in project
      HDL_UDP.SetParameters({RouteDevice: HDL_Serial.Name});
      HDL_Serial.SetParameters({RouteDevice: HDL_UDP.Name});
   }; 
});

После запуска проекта с настроенным драйверами HDL Buspro Network (UDP), HDL Buspro Network (RS232) и скриптом вы сможете использовать порт LAN контроллера UMC как интерфейс доступа в последовательной шине HDL Buspro.

Так как HDL-шлюз обеспечивает логическое объединение двух типов шин (Ethernet/UDP и RS485), нет разницы, через какой интерфейс контроллер UMC будет управлять устройствами: команды и отклики будут беспрепятственно проходить через шлюз. Достаточно каналы настроить только на одном из двух драйверов.

Сканирование устройств HDL Buspro в сети Ethernet

iRidium studio имеет удобный функционал, который избавляет от необходимости определять каждое устройство в проекте вручную. iRidium studio опрашивает статус всех устройств в сети Ethernet по протоколу HDL Buspro, получает ответы и сохраняет конфигурацию сети и параметры каждого устройства в проекте.

1 Чтобы сканировать устройства, нажмите кнопку Scan в панели Драйверы, затем нажмите Scan HDL-Bus Pro Net (UDP):

2 После этого запустится процесс сканирования и через несколько секунд появятся найденные устройства:

3 Путём установки галочек можно выбрать устройства, какие из них будут добавлены в проект, а какие - нет. После нажатия на кнопку OK выбранные устройства со всеми своими параметрами запишутся в проект, в драйвер HDL Buspro Network (UDP).

Если в проекте отсутствует заранее созданный драйвер HDL Buspro Network (UDP), то он будет создан автоматически.

Если в контроллере UMC активирован HDL-шлюз, то при сканировании его LAN-порта будут найдены все устройства HDL Buspro, находящиеся на шине RS485. Для этого нужно подать питание на контроллер и на устройства.

Настройка интерфейса KNX

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

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

Сервер как KNX-устройство

Контроллер 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 интерфейсов и групповых адресов.

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

6 Настройте параметры:

• Host: /dev/ttymxc1
• Baud Rate: 19200
• Data Bits: 8
• Parity: Even
• Stop Bits: 1
• Physical Address: физический адрес UMC как устройства шины

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

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

О других настройках iRidium server и драйвера KNX читайте в разделах:

• Серверный проект в iRidium studio
• iRidium для KNX

Сервер как 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) для связи UMC с шиной через KNX TP1.

• Host: /dev/ttymxc1
• Baud Rate: 19200
• Data Bits: 8
• Parity: Even
• Stop Bits: 1
• Physical Address: физический адрес UMC как устройства шины

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

IR.AddListener(IR.EVENT_START,0,function() 
{
   var KNXSerial = "KNX Serial (UMC)";   // name of KNX Serial driver in your project
 
   if(IR.GetDevice(KNXSerial)) { 
      IR.GetDevice(KNXSerial).SetParameters({ServerDevice: "KNX IP"});
   }
   IR.CreateDevice(IR.DEVICE_KNX_IP_SERVER, 
                  "KNX IP",
                  {Port: 3671, 
                  ClientDevice: KNXSerial
                  });
});

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

Сервер как KNX/IP-шлюз

Существует также возможность более простой активации функции KNX/IP-шлюза без создания драйвера и скрипта (так как описано выше). Нужно лишь активировать режим KNX/IP-шлюза в веб-интерфейсе сервера на вкладке Network > SYSTEM > Other > Server working mode.

Драйвер типа "KNX Serial" должен отсутствовать в проекте.

В этом варианте сервер не сможет работать как KNX-устройство.

Сканирование и мониторинг шины KNX

Для мониторинга и сканирования шины необходимо настроить сервер как KNX/IP-шлюз.
После этого запустите приложение ETS для настройки и отладки устройств KNX и перейдите на вкладку Bus. Подключите необходимый интерфейс.

Сканирование шины KNX

Сканирование линии позволяет увидеть устройства, подключенные к одной из линии сети KNX.
Для этого перейдите в соответствующую вкладку в меню:

Заполните поле Line Address и выберите среду передачи данных

Нажмите кнопку Scan.
Сервер просканирует линию и выведет на экран все адреса устройств, подключенных к ней.

Мониторинг шины KNX

В ETS есть два типа мониторинга:

• мониторинг групповых операций;
• мониторинг шины.

Мониторинг групповых операций позволяет считывать нынешнее значение определенного устройства, а также присвоить ему новое значение. Для этого перейдите во вкладку Group Monitor и нажмите кнопку Start.

Для того чтобы считывать или записывать значение в устройство в поле Group Address нужно вписать адрес нашего устройства

при нажатии на кнопку Read в таблице появится значение устройства из шины

Для изменения этого значения укажите новое значение в поле Value и нажмите на кнопку Write.

Мониторинг шины отображает все пакеты данных, проходящие через шину.
Для этого перейдите на вкладку Bus Monitor и нажмите кнопку Start.

Запуск проекта в тестовом режиме

Тестовый режим - это возможность загружать на сервер и тестировать проекты прямо из iRidium studio, без покупки лицензий. Если загружать проект на сервер из iRidium cloud - он использует коммерческую или Trial лицензию.

Загрузку проекта из studio на сервер обеспечивает программа iRidium transfer и включенный тестовый режим на сервере.

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

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

Проверьте, действительно ли активирован режим Test Mode, нажав на кнопку в нижнем левом углу.

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

Мониторинг шины KNX с помощью ETS

iRidium server версии pro 1.2.11 и старше поддерживает мониторинг шины KNX с помощью ПО Engineering Tool Software (ETS). Для этого необходимо активировать KNX/IP-шлюз, как описано в инструкции Сервер как KNX/IP-шлюз.

1 Запустите ETS. Перейдите на вкладку Diagnostics.

2 Далее перейдите на вкладку Bus Monitor.

3 Выберите из списка тот интерфейс GatewayKNXServerIP, который хотите мониторить.

4 Нажмите кнопку Start. Вы в реальном времени увидите все данные, которые проходят через KNX/IP-шлюз.