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

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

the documentation is updated 03.4.2017


iRidium Server UMC - it is a software implementation of iRidium server. It is launched as a daemon or a console application on UMC Technology controllers.

iridiumserver.com Certified only for Russia and CIS

IRidiumServerUMCPicture.png

Specification:

  • Processor 1GHz CPU FreeScale imx6
  • RAM 512 Mb
  • Non-volatile memory (executable code and data) 1GB + 4GB microSD
  • UMC-C2 model: KNX TP1-256, LAN, USB A
  • Power supply 12...30 VDC
  • Power consumption max 2.5 W


Recommended load:

  • up to 20 control panels
  • 1000 iRidium server tags


iRidium server connects to equipment and sends commands from control panels to it. The control panels connect to the server to control the equipment through it, get feedback, download logs and databases.

The database can store information about server work for the time since the server was launched. The control panels can output logs from the database and build graphs of changes in server variables.

IRidiumServerHowItWorks.png


Initial Start-up

Connect Ethernet and power (24V) to your UMC controller, wait about 30 seconds after supplying power. Do not connect UMC directly to your PC.

On the UMC body you can find its static IP-address. 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



Change the server IP-address to fit your network infrastructure in Settings > Network:


IP-address change

UMC has the static IP-address by default. You can find in on the UMC body. Change the server IP-address to fit your network infrastructure in Settings > Network:

DHCP адрес:

UMC StaticAddr.png

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

UMC DHCPAddr.png

To allow the settings press Save and go to the main page of the web interface. Press the "Reboot System" button. The web-interface will be available by the new address.

'To reset the settings use the instruction

MAC address of your UMC device are unique for each device, do not copy it.


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

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


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-up of KNX Functions

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

Also, UMC can perform the function of a KNX IP router, i.e. it provides connection of ETS with the bus and work of clients by the KNXnet/IP protocol (only after the setting-up).


To Control Bus Equipment

A UMC controller can connect to any remote KNX IP interface or router 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 English 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 the UMC in the mode of a KNX IP router. You need the settings described below for it.


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


To Set the KNX IP Router Function

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

  • 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 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 add the script in it:

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

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

Support > iRidium pro > Downloads > 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 with the new firmware.

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!


Emergency stast, update, downgrade

If you cannot open the UMC web-interface, you can use this instruction to force start, update or downgrade the server firmware. To access the UMC operating system:

download and start PuTTY.

Determine the IP-address of UMC in an accessible way (network scanner). If you reset the UMC to the factory settings use the default address from the UMC body.

Start PuTTY

SetupUMCServer01.png
SetupUMCServer02.png
  • Host Name (or IP address): <UMC IP-address>
  • Port: 22
  • Connection Type: SSH
  • Saved Session: any name
  • Close window on exit: Only on clean exit
  • Press "Save"
  • Press "Open"
SetupUMCServer03.png

Type to the console:

  • Login: root
  • Password: root (you cannot see the password when type)

If the login and password are correct you'll see the UMC welcome message:

1 Force start of Server

SetupUMCServer04.png

Open the iridiumserver folder:
cd /iridiumserver/

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

If success you'll see that the server starts. Open the web-interface of Server by the normal way and use the basic instructions.

2 Reinstall, firmware downgrade

SetupUMCServerWinSCP01.png
SetupUMCServerWinSCP02.png

Install and start WinSCP:

  • Press the "New Site" tab
  • File Protocol: SCP
  • Host name: <UMC IP-address>
  • Port number: 22
  • User name: root
  • Password: root
  • Press "Save"
  • Press "Login"

Download and copy the installation file (*.ipk) to the iridiumserver folder with help of WinSCP.


Start PuTTY and authorize on UMC.

SetupUMCServerPuttyUPD01.png

Open the iridiumserver folder:
cd /iridiumserver/

Get the names of files in folder (to be sure that the *.ipk file is there)
ls

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 you will not use --force-downgrade when install the older version the installation will not be finished)

The server starts automatically after installing (see the image). Open the web-interface of Server by the normal way and use the basic instructions.


Factory Reset

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

  1. On the PLC that turned on press and hold the white button FUNC
  2. Keep hold the white FUNC button, press the red button RES once!
  3. Keep hold the white FUNC button untill you see that all the LED lamps blink (it will take 30-40 sec)
  4. Then the PLC will be reset on factory defaults with the factory IP-address that you can see at PLC body