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

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

iRidium KNX server (UMC Technology)

Installation and launch of iRidium server on the UMC Technology hardware platform

the documentation is updated 22.2.2017


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

To use iRidium server you need a license for iRidium 3

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:

# /etc/network/interfaces -- configuration file for ifup(8), ifdown(8)
 
# The loopback interface
auto lo
iface lo inet loopback
 
# Wired or wireless interfaces
auto eth0
# iface eth0 inet dhcp
iface eth0 inet static
hwaddress ether 70:B3:D5:22:60:56
address 192.168.0.99
netmask 255.255.255.0
gateway 192.168.0.1

Start iRidium transfer on the PC and click Search.

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.


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


Emergency Update

If there are some problems at the installation or launch of the server, you can get access to the OS of the UMC controller for update and debugging:

Emergency Update of the UMC Server

Download and install all required software:

  1. Download the archive of the server firmware files. Unpack it after the download: you have to receive the iridiumserver folder with the set of files
  2. Download and install the WinSCP software
  3. Download and install the PuTTY software


Determine the server IP-address (with the help of the network scanning application or from the information on the router)

1 Start WinSCP. In the software interface set up:

SetupPiServer1.png
  • File Protocol: SCP
  • Host name: the IP-address of UMC
  • Port number: 22
  • User name: your login (by default: root)
  • Password: your password (by default: root)


2 Save the settings with the Save button. Connect to Raspberry by clicking the Login button. If the connection properties were indicated correctly, you will see the window in the right part of which there is a menu for working with files of your controller:

SetupUMCServer2.png

3 Copy the iridiumserver folder in the root catalog of UMC

4 Start PuTTY. In the software interface set up:

SetupPiServer4.png
  • Host Name (or IP address): the IP-address of your UMC
  • Port: 22 (by default)
  • Connection Type: SSH
  • Saved Session: input the name of the current setting and click Save
  • Close window on exit: Only on clean exit


5 In the set up PuTTY click Open to open the console.
Input the login and password for connection to the server (by default: root/root).

SetupPiServer5.png
the input password is not displayed on the console - it is ok. Click Enter when you finish the input

6 If the login and password are input correctly, you will see:

SetupUMCServer9.png

7 Go to the iridiumserver folder with the help of the cd /iridiumserver/ command. Check the folder content with the ls command. You must see the folders:

SetupUMCServer10.png

8 Give iridium full rights with the chmod +x iridium command

9 Launch the server. There are the following commands for that:

  • ./iridium - to launch the server. When closing the console, the server will close too
  • ./iridium --force --hidden - to launch the server in the background mode (as a daemon). When closing the console, the server will not close


The successful server launch:

SetupUMCServer11.png

In case of the successful launch you can add the server in Transfer, get access to it web-interface and work using the main instructions.