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

Other languages:
English • ‎русский

the documentation is updated 31.5.2018


General information

This article describes the order of work with iRidium server UMC for iRidium pro, to read about iRidium server UMC for iRidium lite click the link: i3 lite


Comparison of UMC controllers:

General information about UMC Technology controllers


First start

Starting on June 1, 2018 UMC C2 controllers get the IP address automatically from DHCP-server by default. Controllers manufactured earlier have a static IP address.

1 Connect UMC controller to the local net with a PC and a router with the help of Ethernet-cable to LAN port, supply 24 V power. Wait for about 30 seconds after the power supply, a green LED PWR must be lit.

DHCP-server must be active on the router.

2 Define the IP address of UMC controller with the help of iRidium transfer app or a standard scanner of LAN (for example, Advanced Port Scanner).

3 Use this address to open the web-interface of iRidium server in web-browser:


The server receives the license and the project from the cloud but the developer (integrator) NOT the user must authorize on the server using the login and password on the iRidium Mobile web site. Launch the server, open the web-interface and activate the server:

  1. Input the login and password of the integrator account where you created the object with the server project
  2. Select the service password to access the server settings. It is 2007 by default.
  3. Then you will see the list of objects and server projects. Select the project which has to work on the server and click on it to download (skip this step if you didn't use iRidium Cloud yet).
  4. n the server web-interface (the Cloud tab) you can download project for the server (see Projects) or deactivate the server (see Deactivate Server). At the server with an active Test Mode you can download projects from iRidium Transfer


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



Changing IP address

Change the IP address of the controller to suit your net infrastructure. The settings are available in the server web-interface on the following page System > Network.

You can set:

  • Dinamic address (DHCP) or
  • Static address


DHCP address (given automatically):

UMC StaticAddr2.png

Static IP address:

UMC DHCPAddr.png

To save settings click Save, go to the main page of the web-interface and click Reboot System. The web-interface will become available on the new address.

If you lose access to the web-interface, use this manual Reset to defaults, to return the default settings of IP address.

MAC address must be unique for every device!


Server Update

Open the web-interface of Server on the System > Info tab and press the button Update. You'll see the edit-box where you have to add the link to the file of update.

You can find the update link on iRidium mobile web-site in Downloads tab.

Link to the latest version of iRidium server UMC software for iRidium pro:

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

Paste the link to the edit-box and press the UPDATE button.

UMCWebUpdate.png

The web-interface of iRidium server will be unavailable for some time and then server will be started automatically.

Do not turn off the power supply of iRidium server when the update process occurs. For the UMC with the big database the update process may take about half an hour!


Factory Reset

To reset the UMC controller to factory settings you must perform the following steps:


  • for controllers with firmware after June 1, 2018:


1 Press the white button FNC on the turned off controller .

2 When holding the white button FNC supply power to the controller.

3 Hold the white buttonFNC until a LED<co de>OUT</code> on the controller blinks several times and is off (in about 20-30 seconds).

4 After it the controller has default settings: automatic getting the IP address is activated (DHCP).


  • for controllers with firmware before June 1, 2018:


1 Press the white button FNC on the working controller .

2 When holding the white button FNC press the red button RST one time .

3 Hold the white button FNC until all LEDs on the controller blink (in 30-40 seconds).

4 After it the controller has default settings: it has the original IP address written on the body of the controller or automatical getting the IP address is activated (DHCP).


Trouble shooting

If you can't open the web-interface of iRidum server UMC (the server won't start, the web-interface doesn't work), use the manual on emergency launch/update/downgrade of the software. To do it, access to a device via a console line is required.


Getting access via a console

1 Define the IP address of the controller in any convenient way (for example, with the help of iRidium transfer or a scanner of LAN).


2 Download and launch the following program PuTTY.


3 Make the following settings:

  • Host Name (or IP address): <IP address of UMC controller>
  • Port: 22
  • Connection Type: SSH

and click Open.

SetupUMCServer01.png
SetupUMCServer02.png


4 The console that appears enter:

  • Login as: root
  • root@XXX.XXX.XXX.XXX's password: root (password is not diplayed during entering)
SetupUMCServer03.png

5 If the login and password are entered correctly, you'll see a welcome message from iRidium server UMC. A console line becomes available and with its help forced start, update and downgrade can be done.


Force start of server

1 Open the iridiumserver folder:
cd /iridiumserver/

2 Type the command of server launch in background mode (to make it work all the time)
./iridium --force --hidden

3 If everything is successful, the server will start and be ready for work.

SetupUMCServer04 2.png


Update and downgrade of firmware

The following actions are done if all access to the server web-interface is lost. If there is no Internet access, use this manual Update and downgrade of firmware if there is no access to the Internet.

1 Download the latest version of iRidium server UMC firmware to the root folder of the controller:
wget -O iridiumserver.ipk http://www.iridiummobile.net/redirects/?go=iRidium_Server_UMC

2 Check the folder contents (make sure that the folder has .ipk file):
ls

3 Start installing a newer or the same version of iRidium server:
opkg-cl install iridiumserver.ipk

Or downgrade the version to the older one:
opkg-cl install --force-downgrade iridiumserver.ipk

If --force-downgrade key is not used when installing an older version, installation won't be done.

Install UMC server1.png

4 After installation the server starts automatically. The server is ready to work.


Update and downgrade of firmware if there is no Internet access

1 Install and start WinSCP:

  • Click New Site folder and set:
  • File Protocol: SCP
  • Host name: <IP address of UMC controller>
  • Port number: 22
  • User name: root
  • Password: root

Click Login.

SetupUMCServerWinSCP01.png

2 Copy the file to install UMC server (.ipk) to the root folder /root of UMC controller, using WinSCP.

Winscp copy.png

3 Check the contents of the root folder in the console line (make sure that the .ipk file is there):
ls

4 Start the install of newer or the same version of server:
opkg-cl install <file-name>.ipk

Downgrade the version to the older one:
opkg-cl install --force-downgrade <file-name>.ipk

If --force-downgrade key is not used when installing an older version, installation won't be done.

Install UMC server offline.png

5 After installation the server starts automatically. The server is ready to work.


Server Setting-up

When the server is installed, you can start developing its configuration and logic:


You have to upload the ready project to iRidium server:


Setting KNX interface

A UMC controller can work as a KNX bus device: it can receive and send commands via the KNX TP1 interface.

UMC controller can also function as a KNX/IP gateway, i.e. to provide connection of Engineering Tool Software (ETS) with the bus and work as client via the KNXnet/IP protocol (only after setting-up).


Server as KNX device

A UMC controller can connect to any remote KNX IP interface or gateway to control it by the KNXnet/IP protocol (UDP) through the network. But, if the UMC is connected to the bus via KNX TP1, it is necessary to choose the bus communication using this particular interface.

1 Connect the UMC to the KNX bus through the KNX TP1 interface

2 Save the project file in one of the formats: *.pr3, *.pr4, *,pr5, *.knxproj, *.csv. It is recommended to use Latin when giving the name to the project. The Windows language has to be the same with the project language to import names of group addresses correctly.

3 Create a new project for iRidium server in iRidium studio: File> New > New Server Project...

4 Select your ETS project in the menu File > Import and import it. The list of available KNX IP interfaces and group addresses will be formed on the base of the ETS project.

KNX import project ETS.png

5 After you import the project, change the driver setting Type Driver to KNX (Serial) - it is a KNX driver which provides communication between the UMC and the KNX TP1 interface. Settings of connection to KNX will change completely. Leave them by default and specify only the Physical Address - the physical address of the UMC as a bus device.

KNX UMC DeviceType-OnServer.png

Now the setup is complete. When you start the project on the UMC server the connection will be established to the bus via the TP1 interface, the UMC will be shown as a bus device (it will have its physical address) although it will not have its own group addresses.

This setup will not provide work of UMC controller in the mode of a KNX/IP gateway. You have to do the settings described below.


Read about the further setting up of iRidium server and the KNX driver in the following sections:


Server as KNX-device and KNX/IP gateway

After the special setting up the UMC can perform functions of a KNX/IP gateway:

  • it provides connection of ETS with the bus (it is searched and added to ETS as a KNX interface)
  • it provides connection of clients to the bus by the KNXnet/IP protocol
  • it provides transfer of multicast packets from other KNX IP interfaces to the bus (routing)


1 Connect the UMC to the KNX bus through the KNX TP1 interface

2 Create a new project for iRidium server in iRidium studio: File> New > New Server Project...

3 Import and configure (see the previous section or manually) the driver KNX Serial (UMC) for communication of the UMC with the bus via KNX TP1. Indicate an unused physical address for the UMC.

KNX ass Serial UMC.png

4 Create an empty script file (JS icon on the top toolbar + New Script) and paste the script in it:

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

After the project with the configured driver and script is launched on the UMC, you will be able to find the UMC in ETS and use it as an interface to access the bus.


Server as KNX/IP gateway

There is an easier way to activate the KNX/IP gateway function without creating a driver or scripts as described above. All that has to be done is to activate the KNX/IP gateway mode in the web-interface in the following folder Network > SYSTEM > Other > Server working mode.

KNX gate.png

There must be no driver of "KNX Serial" type in the project.

The server can't work as a KNX device in this case.


Starting a project in test mode

Test mode allows you to upload and test the projects from iRidium studio without buying of license. When you upload the project from iRidium cloud it uses commercial or Trial license.


You can upload the project from iRIdium Studio to the Server with help of iRidium transfer software. The "Test mode" on Server must be turned on.

In iRidium transfer press Search button when the server are ready. As a result of the search you will see a new device in Transfer with the name <NAME> (Server)

SetupOBserver1.png

Activate the option "Test Mode: ON" in the server settings to use it in the fully functional mode. You can see more information about the use modes in the section Licensing Policy.

ServerTestModeOn.png

Check if the Test Mode is activated by clicking a button in the bottom left corner.

Test mode checking.png

With the activated Test Mode you can also test work of cloud projects and upload projects from iRidium transfer (locally, without iRidium cloud).