Difference between revisions of "Template:Networking rut cloud of things"

From Teltonika Networks Wiki
(23 intermediate revisions by the same user not shown)
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 RUT2xx, RUT9xx and RUTXxx series routers.
+
'''Telekom Cloud of Things''' is now compatible with Teltonika RUT routers.
 
==Description==
 
==Description==
  
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.
+
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.
  
 
==Summary==
 
==Summary==
  
This example will provide steps on how to connect your device to Cloud of Things
+
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:
  
There are many things that you can monitor via this platform:
+
Device Model, Revision and Serial Number
  
Device Data - Device Model, Revision and Serial Number
+
Mobile Cell ID, ICCID, IMEI, Connection Type, Operator, Signal Strength
  
Mobile data - Mobile Cell ID, ICCID, IMEI, Connection Type, Operator, Signal Strength
+
WAN Type and IP
  
Network info - IP
+
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.
  
Availability
 
  
And other...
+
????????????????????????????????
 +
 
 
==Creating an account==
 
==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:
+
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 31: Line 29:
 
[[Image:Cloud of things cockpit.png]]
 
[[Image:Cloud of things cockpit.png]]
  
==RUT2xx / RUT9xx - Package installing and device registering==
+
==Package installing and device registering==
  
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.'''
+
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.'''
  
  
Line 39: Line 37:
  
  
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.
+
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.
  
  
Line 45: Line 43:
  
  
Then it will ask for your confirmation, whether you want to install the package. Press '''OK''' to continue.
+
Then it will ask your confirmation, whether you want to install the package. Press '''OK''' to continue.
  
  
Line 63: Line 61:
  
  
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 73: Line 71:
 
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.
  
==RUTX - Package installing and device registering==
+
==Adding devices on Cloud of Things platform==
 +
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'''. 
  
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.'''
+
[[Image:Cloud of things adding device 1.png]]
  
 +
Then select '''Devices''' and press '''Registration'''.
  
[[Image:Cloud of things rutx package installing 1.png]]
+
[[Image:Cloud of things adding device 2.png]]
  
 +
Press '''Register device'''.
  
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 adding device 3.png]]
[[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.
  
Then it will ask for your confirmation, whether you want to install the package. Press '''YES''' to continue.
+
[[Image:Cloud of things adding device 4.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.[[Image:Cloud of things adding device 5.png]]
  
[[Image:Cloud of things rutx package installing 3.png]]
+
If everything was done correctly, it will show you that the registration was successful.  
  
 +
[[Image:Cloud of things adding device 6.png]]
  
It will take a moment to install, but when it is done, you will receive a message.
+
Then you will need to '''Accept''' the '''Pending Acceptance'''.  
  
 +
[[Image:Cloud of things adding device 7.png]]
  
[[Image:Cloud of things rutx package installing 4 v1.png]]
+
Finally you will receive a message showing that the device has been accepted.d.
  
  
When the package is installed, a new window in '''Services>Cloud Solutions''' section will appear, '''Cloud of Things'''.
+
[[Image:Cloud of things adding device 8.png]]
  
 +
== Device monitoring ==
 +
[[Image:Cloud of things adding device 9.png]]
  
[[Image:Cloud of things rutx package installing 5.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)
 
  
 +
Click „Accept“ button to accept this device.
  
[[Image:Cloud of things rutx package installing 6 v1.png]]
+
Now navigate to „All devices“ page:
  
 +
[[File:cumalldevices.png]]
  
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.
+
Here you should be able to see list of all registered devices:
  
==Adding device(s) on Cloud of Things==
+
[[File:cumallregistereddevices.png]]
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'''. 
 
  
[[Image:Cloud of things adding device 1.png]]
+
Click on „TLT-RUT955 Router“ name to get into information page:
  
Then select '''Devices''' and press '''Registration'''.
+
[[File:cumdeviceinfo.png]]
  
[[Image:Cloud of things adding device 2.png]]
+
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“:
  
Press '''Register device'''.
+
[[File:cumdevicecontrol.png]]
  
[[Image:Cloud of things adding device 3.png]]
+
You can go back to Cumulocity Cockpit page the same way you entered Device managemant page:
  
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.
+
[[File:cumnavigatecockpit.png]]
  
[[Image:Cloud of things adding device 4.png]]
+
Then navigate to „Home“ page:
  
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.
+
[[File:cumnavigatehome.png]]
  
[[Image:Cloud of things adding device 5.png]]
+
And then click „Add widget“:
  
If everything was done correctly, it will show you that the registration was successful.  
+
[[File:cumaddwidget.png]]
  
[[Image:Cloud of things adding device 6.png]]
+
Select „Asset properties“ widget and type title, then select „TLT-RUT955 Router“ in „Target Assets or Devices“:
  
Then you will need to '''Accept''' the '''Pending Acceptance'''.  
+
[[File:cumcreatewidget.png]]
  
[[Image:Cloud of things adding device 7.png]]
+
To add more information into widget, click „Add property“ and click on „Show“ to add that property.
  
Finally you will receive a message indicating that the device has been accepted.
+
In example application, these properties are used:
  
 +
Hardware – Model, Revision, Serial Number
  
[[Image:Cloud of things adding device 8.png]]
+
Mobile – Cell ID, Connection Type, Current Operator, ICCID, IMEI and Signal
  
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.
+
WAN – IP and Wan Type
  
[[Image:Cloud of things adding device 9.png]]
+
Total properties:
  
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.
+
[[File:cumtotalprops.png]]
  
[[Image:Cloud of things monitoring device 1.png]]
+
Then click „Save“ and you should be able to see widget with properties you have set:
  
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
+
[[File:cumdevicewidgetinfo.png]]
  
 
==External Links==
 
==External Links==
 +
https://www.cumulocity.com/try-for-free
 +
 +
https://www.cumulocity.com/guides/reference/smartrest
  
https://iot.telekom.com/en/platform
+
https://bitbucket.org/m2m/cumulocity-sdk-c/downloads
  
 
{{Template: trademark disclaimer}}
 
{{Template: trademark disclaimer}}

Revision as of 17:06, 27 November 2019

Networking rut telekom logo.png

Telekom Cloud of Things is now compatible with Teltonika RUT routers.

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.

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:

Device Model, Revision and Serial Number

Mobile Cell ID, ICCID, IMEI, Connection Type, Operator, Signal Strength

WAN Type and IP

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.


????????????????????????????????

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:

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:

Cloud of things cockpit.png

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 package installing 1.png


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.


Cloud of things package installing 2.png


Then it will ask your confirmation, whether you want to install the package. Press OK to continue.


Cloud of things package installing 3.png


It will take a moment to install, but when it is done, you will receive a message.


Cloud of things package installing 4.png


When the package is installed, a new window in Services section will appear, IoT Platforms.


Cloud of things package installing 5.png


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)


Cloud of things package installing 6.png


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

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.

Cloud of things adding device 1.png

Then select Devices and press Registration.

Cloud of things adding device 2.png

Press Register device.

Cloud of things adding device 3.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.

Cloud of things adding device 4.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.Cloud of things adding device 5.png

If everything was done correctly, it will show you that the registration was successful.

Cloud of things adding device 6.png

Then you will need to Accept the Pending Acceptance.

Cloud of things adding device 7.png

Finally you will receive a message showing that the device has been accepted.d.


Cloud of things adding device 8.png

Device monitoring

Cloud of things adding device 9.png



Click „Accept“ button to accept this device.

Now navigate to „All devices“ page:

Cumalldevices.png

Here you should be able to see list of all registered devices:

Cumallregistereddevices.png

Click on „TLT-RUT955 Router“ name to get into information page:

Cumdeviceinfo.png

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

Cumdevicecontrol.png

You can go back to Cumulocity Cockpit page the same way you entered Device managemant page:

Cumnavigatecockpit.png

Then navigate to „Home“ page:

Cumnavigatehome.png

And then click „Add widget“:

Cumaddwidget.png

Select „Asset properties“ widget and type title, then select „TLT-RUT955 Router“ in „Target Assets or Devices“:

Cumcreatewidget.png

To add more information into widget, click „Add property“ and click on „Show“ to add that property.

In example application, these properties are used:

Hardware – Model, Revision, Serial Number

Mobile – Cell ID, Connection Type, Current Operator, ICCID, IMEI and Signal

WAN – IP and Wan Type

Total properties:

Cumtotalprops.png

Then click „Save“ and you should be able to see widget with properties you have set:

Cumdevicewidgetinfo.png

External Links

https://www.cumulocity.com/try-for-free

https://www.cumulocity.com/guides/reference/smartrest

https://bitbucket.org/m2m/cumulocity-sdk-c/downloads

Disclaimer:

Any of the trademarks, service marks, collective marks, design rights or similar rights that are mentioned, used or cited in the articles are the property of their respective owners.