Changes

Line 1: Line 1:  
[[File:Networking rut telekom logo.png|right|160px]]
 
[[File:Networking rut telekom logo.png|right|160px]]
'''Telekom Cloud of Things''' is now compatible with Teltonika RUT routers.
+
'''Telekom Cloud of Things''' is now compatible with Teltonika RUT2xx, RUT9xx and RUTXxx series routers.
 
==Description==
 
==Description==
   −
The '''Cloud of Things''' is cloud platform for the Internet of Things. It allows you to remotely monitor, manage and control your connected devices and machines – plug-and-play, without extensive installation.
+
The '''Cloud of Things''' is a cloud platform for the Internet of Things. It allows you to remotely monitor, manage and control your connected devices and machines – plug-and-play, without extensive installation.
    
==Summary==
 
==Summary==
   −
This example application streams some information from the router device. Once it is enabled you should be able to the following things in Cloud of Things Cockpit the following information from your router:
+
This example will provide steps on how to connect your device to Cloud of Things
   −
Device Model, Revision and Serial Number
+
There are many things that you can monitor via this platform:
   −
Mobile Cell ID, ICCID, IMEI, Connection Type, Operator, Signal Strength
+
Device Data - Device Model, Revision and Serial Number
   −
WAN Type and IP
+
Mobile data - Mobile Cell ID, ICCID, IMEI, Connection Type, Operator, Signal Strength
   −
Mobile and WAN information are sent from “stream” Lua script, while Device information - from stream application. This information (except Device) is being sent to the main Cumulocity server continuously: at 10 seconds interval.
+
Network info - IP
    +
Availability
   −
????????????????????????????????
+
And other...
 +
==Creating an account==
 +
First of all, you need to create an account. After registration, you will receive free 60 days Cloud of Things trial. Registration form can be found here: https://support.ram.m2m.telekom.com/apps/demotenant/index.html#/ . Below you can see a picture of the registration form:
   −
==Creating an account==
  −
First of all, you need to create an account. After registration, you will receive free 60 days Cloud of Things trial. Registration form can be found here: https://support.ram.m2m.telekom.com/apps/demotenant/index.html#/ . Below you can see registration form:
      
[[Image:CoT_Demo_Account.png]]
 
[[Image:CoT_Demo_Account.png]]
 +
    
After successful registration you will receive an email with your account details (URL, username, password) and after logging in, you will be redirected to Cloud of Things Cockpit portal, see below:
 
After successful registration you will receive an email with your account details (URL, username, password) and after logging in, you will be redirected to Cloud of Things Cockpit portal, see below:
Line 29: Line 31:  
[[Image:Cloud of things cockpit.png]]
 
[[Image:Cloud of things cockpit.png]]
   −
==Package installing and device registering==
+
==RUT2xx / RUT9xx - Package installing and device registering==
   −
Cloud of Things IoT platform is not included in standart software package. So it order to use it you will need to install it first. Go to '''System>Package Manager.'''
+
Cloud of Things IoT platform is not included in standart software package, so in order to use the feature you will need to install it first. To do so, go to '''System>Package Manager.'''
      Line 37: Line 39:       −
There you will find all the available packages. The one you need is called '''Cloud of Things'''. In order to install it press '''Install''' button.
+
There you will find all the available packages. The one you need is called '''Cloud of Things'''. In order to install it just press the '''Install''' button.
      Line 43: Line 45:       −
Then it will ask your confirmation, whether you want to install the package. Press '''OK''' to continue.
+
Then it will ask for your confirmation, whether you want to install the package. Press '''OK''' to continue.
      Line 61: Line 63:       −
In order to use the feature you will need to enable it, write '''Server Address''' and press '''Save.''' The server address is the link which was provided by '''Cloud of Things'''.
+
In order to use the feature, you will need to enable it, write '''Server Address''' and press '''Save.''' The server address is the link which was provided by '''Cloud of Things'''.
    
(E.g. example.example.example.telekom.com)
 
(E.g. example.example.example.telekom.com)
Line 71: Line 73:  
P.S. In order to re-register a device on Cloud of Things platform, you need to press '''Reset Auth''' button. If you are registering the device for the first time, pressing the button is not necessary.
 
P.S. In order to re-register a device on Cloud of Things platform, you need to press '''Reset Auth''' button. If you are registering the device for the first time, pressing the button is not necessary.
   −
==Adding devices on Cloud of Things platform==
+
==RUTX - Package installing and device registering==
After successfully installing the package and making the required configuration on the router, you now can add the device on Cloud of Things platform. After logging in to the website you are forwarded to Cockpit page. There press '''Device manager'''. 
     −
[[Image:Cloud of things adding device 1.png]]
+
Cloud of Things IoT platform is not included in standart software package, so in order to use the feature you will need to install it first. To do so, go to '''System>Package Manager.'''
   −
Then select '''Devices''' and press '''Registration'''.
     −
[[Image:Cloud of things adding device 2.png]]
+
[[Image:Cloud of things rutx package installing 1.png]]
   −
Press '''Register device'''.
     −
[[Image:Cloud of things adding device 3.png]]
+
There you will find all the available packages. The one you need is called '''Cloud of Things'''. In order to install it just press the '''Install''' button.
 +
[[Image:Cloud of things rutx package installing 2.png]]
   −
There are two ways to register your device(s) '''Bulk''' and '''General'''. Bulk is used when you are registering a lot of devices at once. In this example we will be using the '''General''' option.
     −
[[Image:Cloud of things adding device 4.png]]
+
Then it will ask for your confirmation, whether you want to install the package. Press '''YES''' to continue.
   −
In '''Device ID''' section write the serial number of your router. You can add more than one item by pressing '''Add another device''' button. There is a possibility to assign your routers to groups, but we are not doing that in this example.[[Image:Cloud of things adding device 5.png]]
     −
If everything was done correctly, it will show you that the registration was successful.  
+
[[Image:Cloud of things rutx package installing 3.png]]
   −
[[Image:Cloud of things adding device 6.png]]
     −
Then you will need to '''Accept''' the '''Pending Acceptance'''.  
+
It will take a moment to install, but when it is done, you will receive a message.
   −
[[Image:Cloud of things adding device 7.png]]
     −
Finally you will receive a message showing that the device has been accepted.d.
+
[[Image:Cloud of things rutx package installing 4 v1.png]]
      −
[[Image:Cloud of things adding device 8.png]]
+
When the package is installed, a new window in '''Services>Cloud Solutions''' section will appear, '''Cloud of Things'''.
       +
[[Image:Cloud of things rutx package installing 5.png]]
   −
[[Image:Cloud of things adding device 9.png]]
      +
In order to use the feature, you will need to enable it, write '''Server Address''' select '''Interface''' name and press '''Save & Apply.''' The server address is the link which was provided by '''Cloud of Things'''.
    +
(E.g. example.example.example.telekom.com)
       +
[[Image:Cloud of things rutx package installing 6 v1.png]]
   −
Click „Accept“ button to accept this device.
     −
Now navigate to „All devices“ page:
+
P.S. In order to re-register a device on Cloud of Things platform, you need to press '''Reset Auth''' button. If you are registering the device for the first time, pressing the button is not necessary.
   −
[[File:cumalldevices.png]]
+
==Adding device(s) on Cloud of Things==
 +
After successfully installing the package and making the required configuration on the router, you now can add the device on '''Cloud of Things''' platform, steps for RUT and RUTX series routers are the same. After logging in to the website you are forwarded to Cockpit page. There press '''Device manager'''. 
   −
Here you should be able to see list of all registered devices:
+
[[Image:Cloud of things adding device 1.png]]
   −
[[File:cumallregistereddevices.png]]
+
Then select '''Devices''' and press '''Registration'''.
   −
Click on „TLT-RUT955 Router“ name to get into information page:
+
[[Image:Cloud of things adding device 2.png]]
   −
[[File:cumdeviceinfo.png]]
+
Press '''Register device'''.
   −
Notice „Device Data“ widget, it contains information from the router device. By navigating to „Control“ tab, you can restart device by clicking „More → Restart Device“:
+
[[Image:Cloud of things adding device 3.png]]
   −
[[File:cumdevicecontrol.png]]
+
There are two ways to register your device(s) '''Bulk''' and '''General'''. Bulk is used when you are registering many devices at once. In this example we will be using the '''General''' option.
   −
You can go back to Cumulocity Cockpit page the same way you entered Device managemant page:
+
[[Image:Cloud of things adding device 4.png]]
   −
[[File:cumnavigatecockpit.png]]
+
In '''Device ID''' section write the serial number of your router. You can add more than one item by pressing '''Add another device''' button. There is a possibility to assign your routers to groups, but we are not doing that in this example.
   −
Then navigate to „Home“ page:
+
[[Image:Cloud of things adding device 5.png]]
   −
[[File:cumnavigatehome.png]]
+
If everything was done correctly, it will show you that the registration was successful.  
   −
And then click „Add widget“:
+
[[Image:Cloud of things adding device 6.png]]
   −
[[File:cumaddwidget.png]]
+
Then you will need to '''Accept''' the '''Pending Acceptance'''.  
   −
Select „Asset properties“ widget and type title, then select „TLT-RUT955 Router“ in „Target Assets or Devices“:
+
[[Image:Cloud of things adding device 7.png]]
   −
[[File:cumcreatewidget.png]]
+
Finally you will receive a message indicating that the device has been accepted.
   −
To add more information into widget, click „Add property“ and click on „Show“ to add that property.
     −
In example application, these properties are used:
+
[[Image:Cloud of things adding device 8.png]]
   −
Hardware – Model, Revision, Serial Number
+
After successful device registration, there is one more thing that you need to do in order to start monitoring your equipment. Find your router at '''All devices''' page. Then simply press the name of the item and you will be forwarded to the info window.
   −
Mobile – Cell ID, Connection Type, Current Operator, ICCID, IMEI and Signal
+
[[Image:Cloud of things adding device 9.png]]
 
  −
WAN – IP and Wan Type
  −
 
  −
Total properties:
     −
[[File:cumtotalprops.png]]
+
Here you will need to set the '''Required interval'''. This parameter defines how often you expect to hear from the device. If, for example, you set the required interval to 60, you expect the device at least to communicate once in an hour with Cloud of Things. RUT device sends data to the server every 10sec.
   −
Then click „Save“ and you should be able to see widget with properties you have set:
+
[[Image:Cloud of things monitoring device 1.png]]
   −
[[File:cumdevicewidgetinfo.png]]
+
If everything was done correctly you should now be able to monitoring your device on Cloud of Things. For more information about this platform visit this website: https://iot.telekom.com/en/platform
    
==External Links==
 
==External Links==
https://www.cumulocity.com/try-for-free
  −
  −
https://www.cumulocity.com/guides/reference/smartrest
     −
https://bitbucket.org/m2m/cumulocity-sdk-c/downloads
+
https://iot.telekom.com/en/platform
    
{{Template: trademark disclaimer}}
 
{{Template: trademark disclaimer}}
0

edits