This page is a
translated version of the page
IRidium Server UMC C2 and the translation is 100% complete.
iRidium server UMC C2
Installation and launch of iRidium server for iRidium pro on the UMC С2 controller
The documentation was updated on 21.7.2021
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 iridi.com web site. Launch the server, open the web-interface and activate the server:
- Input the login and password of the integrator account where you created the object with the server project
- Select the service password to access the server settings. It is 2007 by default.
- 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).
- In the server web-interface (the Cloud tab) you can download project for the server (Projects) or deactivate the server (Deactivate Server). At the server with an active Test Mode you can download projects from iRidium Transfer.
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):
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.
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
.
4 The console that appears enter:
- Login as: root
- root@XXX.XXX.XXX.XXX's password: root (password is not diplayed during entering)
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.
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.
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
.
2 Copy the file to install UMC server (.ipk) to the root folder /root
of UMC controller, using WinSCP.
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.
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:
Server Projects in iRidium studio
You have to upload the ready project to iRidium server:
Launch of iRidium server configuration
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.
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.
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.
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.
There must be no driver of "KNX Serial" type in the project.
The server can't work as a KNX device in this case.
Scanning and monitoring KNX bus
To monitor and scan the bus set server as KNX/IP-gateway.
After it launch ETS app to set and debug KNX devices and go to the Bus tab. Connect a required interface.
Scanning KNX bus
Scanning the bus allows to see devices connected to one bus of KNX network.
To do it, go to the corresponding tab of the menu:
Fill in Line Address field and select data transfer medium
Click Scan.
The server scans the bus and displays on the screen addressed of all devices connected to the bus.
Monitoring KNX bus
There are 2 types of monitoring in ETS
- monitoring of group operations;
- monitoring of the bus.
Monitoring of group operations allows to read the current state of a definite device and write a new value in it.
To do it, go to the Group Monitor tab and click Start.
To read a value or to write a value to a device, enter the device address in the Group Address field.
When Read button is clicked, a value from a device in the bus appears in the table
To change this value, write a new value in the Value field and click Write.
Monitoring of the bus displays all data packets sent in the bus.
To do it go to the Bus Monitor tab and click Start
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)
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.
Check if the Test Mode is activated by clicking a button in the bottom left corner.
With the activated Test Mode you can also test work of cloud projects and upload projects from iRidium transfer (locally, without iRidium cloud).