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

Other languages:

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


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

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


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

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


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

С 01.06.2018 контроллеры UMC C2 по умолчанию получают IP-адрес автоматически от DHCP-сервера. В контроллерах, выпущенных ранее, настроен статический IP-адрес.

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

В маршрутизаторе должен быть активирован 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 на заводские настройки необходимо выполнить следующие действия.


  • для контроллеров с прошивкой с 01.06.2018:


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

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

3 Продолжайте удерживать нажатой белую кнопку FNC до тех пор, пока на контроллере не моргнёт светодиод OUT несколько раз и погаснет (через 20-30 сек).

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


  • для контроллеров со старыми прошивками до 01.06.2018:


1 На работающем контроллере нажмите белую кнопку FNC.

2 Удерживая белую кнопку FNC нажатой, однократно нажмите на красную кнопку RST.

3 Продолжайте удерживать нажатой белую кнопку FNC до тех пор, пока на контроллере не моргнут все светодиоды (через 30-40 сек).

4 После этого контроллер сбросится на заводские настройки: ему будет присвоен заводской IP-адрес, указанный на корпусе контроллера, либо активируется автоматическое получение адреса (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-cl install iridiumserver.ipk

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

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

Install UMC server1.png

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


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

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

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

Нажмите Login.

SetupUMCServerWinSCP01.png

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

Winscp copy.png

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

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

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

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

Install UMC server offline.png

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


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

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


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


Настройка интерфейса 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).