Материал из for iRidium developers
Перейти к: навигация, поиск
Эта страница является переводом страницы IRidium Server UMC C3. Перевод выполнен на 100%.

Other languages:

iRidium server UMC C3

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


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


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

На данной странице описывается порядок работы с 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 Используйте этот адрес, чтобы открыть веб-интерфейс сервера в браузере:


Сервер получает лицензию и проект из облака, но, на сервере авторизуется не пользователь, а разработчик (интегратор) с помощью логина и пароля на сайте 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-адреса

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

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

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


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

UMC StaticAddr2.png

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

UMC DHCPAddr.png

Чтобы применить настройки, нажмите 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.

UMCWebUpdate.png

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

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


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

Для сброса контроллера 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.

SetupUMCServer01.png
SetupUMCServer02.png


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

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

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


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

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

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

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

SetupUMCServer04 2.png


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

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

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

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

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

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

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

Cl server update online.png

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


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

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

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

Нажмите Login.

Winscp login.png

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

Winscp copy c3.png

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

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

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

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

Cl server update offline.png

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


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

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


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


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

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

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

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

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

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

Modbus RTU add.png

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

  • Host: номер порта в ОС Linux (/dev/ttymxc0 или /dev/ttymxc1)
  • 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-устройстве
Modbus RTU channel params.png

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 gate.png

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

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


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

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

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

HDL Buspro add.png

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

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


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

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

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

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

HDL Command params.png

Наиболее важные параметры 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 в проект:

HDL Buspro UDP add.png

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):

Drivers scan.png

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

HDL Found devices.png

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

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-устройство и 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. Укажите свободный физический адрес для UMC.

KNX ass Serial UMC.png

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
                  });
});

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


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

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

KNX gate.png

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

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


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

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


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

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

SetupOBserver1.png

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

ServerTestModeOn.png

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

Test mode checking.png

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