Teltonika Networks Wiki

Changes

Cumulocity Configuration (view source)

Revision as of 14:49, 3 October 2023

2,080 bytes removed ,  14:49, 3 October 2023
no edit summary
Line 22: Line 22:  
<ul>
 
<ul>
 
     <li><b>[https://signup.softwareag.cloud/#/?product=cumulocity Register an account]</b> on Cumulocity.</li>
 
     <li><b>[https://signup.softwareag.cloud/#/?product=cumulocity Register an account]</b> on Cumulocity.</li>
−
     <li>Wait a few minutes after the registration and open your email account. You should have received an email with the subject 'Welcome to Cumulocity IoT'. Open the email and <b>click 'Login to Cumulocity IoT'</b>.<br>[[File:Networking_rutos_configuration_examples_cumulocity_1.png|border|class=tlt-border]]</li>
+
     <li>Wait a few minutes after the registration, open your email account and look for an email with the subject 'Welcome to Cumulocity IoT'. Open it and <b>click 'Login to Cumulocity IoT'</b>.<br>[[File:Networking_rutos_configuration_examples_cumulocity_1.png|border|class=tlt-border]]</li>
 
     <li>Upon a successful login you should be redirected to the <b>Cumulocity Cockpit</b>.<br>[[File:Networking_rutos_configuration_examples_cumulocity_2.png|border|class=tlt-border]]</li>
 
     <li>Upon a successful login you should be redirected to the <b>Cumulocity Cockpit</b>.<br>[[File:Networking_rutos_configuration_examples_cumulocity_2.png|border|class=tlt-border]]</li>
 
</ul>
 
</ul>
Line 32: Line 32:  
<ul>
 
<ul>
 
     <li>Log in to your device's WebUI.</li>
 
     <li>Log in to your device's WebUI.</li>
−
     <li><b>Go to Services → Package Manager</b> and install Cumulocity.<br>[[File:Networking_rutos_configuration_examples_cumulocity_3.png|border|class=tlt-border]]</li>
+
     <li><b>Go to System → Package Manager</b> and install Cumulocity.<br>[[File:Networking_rutos_configuration_examples_cumulocity_3.png|border|class=tlt-border]]</li>
 
     <li></b>Go to Services → Cloud Solutions → Cumulocity</b> and configure it as follows.
 
     <li></b>Go to Services → Cloud Solutions → Cumulocity</b> and configure it as follows.
 
         <ol>
 
         <ol>
 
             <li>Enable Cumulocity</li>
 
             <li>Enable Cumulocity</li>
 +
            <li>Enable SSL/TLS</li>
 
             <li>Specify your Cumulocity server's address in the 'Server Address' field.</li>
 
             <li>Specify your Cumulocity server's address in the 'Server Address' field.</li>
 
             <li>Set a connection frequency interval (at least 1 minute).</li>
 
             <li>Set a connection frequency interval (at least 1 minute).</li>
 
             <li>Click 'Save & Apply'.</li>
 
             <li>Click 'Save & Apply'.</li>
−
         </ol>[[File:Networking_rutos_configuration_examples_cumulocity_4.png|border|class=tlt-border]]
+
         </ol>[[File:Networking_rutos_configuration_examples_cumulocity_4_v2.png|border|class=tlt-border]]
 
     </li>
 
     </li>
 
</ul>
 
</ul>
Line 56: Line 57:  
         </ol>[[File:Networking_rutos_configuration_examples_cumulocity_7.png]]
 
         </ol>[[File:Networking_rutos_configuration_examples_cumulocity_7.png]]
 
     </li>
 
     </li>
−
     <li>If the device connects successfully, you should see an indication similar to the one below. Click 'Complete' to finish the registration.</li>
+
     <li>If the device connects successfully, you should see an indication similar to the one below. Click 'Complete' to finish the registration.<br>[[File:Networking_rutos_configuration_examples_cumulocity_8.png|border|class=tlt-border]]</li>
 
</ul>
 
</ul>
−
<!--
  −
==Installing example application==
     −
First, you need to install Cumulocity. Go to System -> Package manager:
+
==Explanation of example application==
−
 
  −
[[File:Package manager.jpg]]
  −
 
  −
When you open package manager you will see a list of packages. You need click install on Cumulocity, see below:
  −
 
  −
 
  −
[[File:Screenshot from 2019-11-27 16-00-24.png]]
  −
 
  −
==Configuring and launching example application==
  −
After you successfully installed Cumulocity, in „Services“ tab there should be an option called „IoT Platforms“.
     −
[[File:cumiot.png]]
  −
  −
[[File:cumiotwindow.png]]
  −
  −
Only single field is required, which is Server Address. This is the same URL of Cumulocity Cockpit website. In this example, it is myservername.cumulocity.com.
  −
  −
Explanation of other options:
  −
  −
Use SSL/TLS – connection will use TLS, however, you need to have a signed SSL certificate, otherwise application would not be able to connect to the Cumulocity server.
  −
  −
Reset Auth – once device has been removed from the Cumulocity Device Management, you will need to reset authentication in order to re-register device.
  −
  −
Also click „Enable“ to enable example application. See below:
  −
  −
[[File:cumiotvalues.png]]
  −
  −
Now click „Save“ and if everything is correct – example application will successfully connect to the Cumulocity server.
  −
  −
Now you need to register device on Device Management in Cumulocity Cockpit.
  −
  −
Device registration is done by writing down device's serial number. In order to obtain your device's serial number, look at the backplate of it or navigate to your device's control panel and then to „Status → Device“ page:
  −
  −
[[File:cumdevice.png]]
  −
  −
In this case, serial number is 09516845.
  −
  −
Now log into your Cumulocity Cockpit portal, in this example URL is https://myservername.cumulocity.com.
  −
  −
Go to the Device Management page:
  −
  −
[[File:cumcockpit.png]]
  −
  −
[[File:cumdevicemanagement.png]]
  −
  −
Then navigate to Registration page:
  −
  −
[[File:cumdevicepage.png]]
  −
  −
Click „Register device“:
  −
  −
[[File:cumdeviceregister.png]]
  −
  −
Click „General device registration“:
  −
  −
[[File:cumnewdevice.png]]
  −
  −
Write device’s serial number in „Device ID“ field and click „Next“:
  −
  −
[[File:cumdeviceregistration.png]]
  −
  −
As shown below, registration is successful:
  −
  −
[[File:cumsuccessresgister.png]]
  −
  −
Click „Finish“ to  close this pop-up. Now if everything is correct, a new device widget should show up with a status „PENDING ACCEPTANCE“:
  −
  −
[[File:cumpendingdevice.png]]
  −
  −
Click „Accept“ button to accept this device.
  −
  −
Now navigate to „All devices“ page:
  −
  −
[[File:cumalldevices.png]]
  −
  −
Here you should be able to see list of all registered devices:
  −
  −
[[File:cumallregistereddevices.png]]
  −
  −
Click on „TLT-RUT955 Router“ name to get into information page:
  −
  −
[[File: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“:
  −
  −
[[File:cumdevicecontrol.png]]
  −
  −
You can go back to Cumulocity Cockpit page the same way you entered Device managemant page:
  −
  −
[[File:cumnavigatecockpit.png]]
  −
  −
Then navigate to „Home“ page:
  −
  −
[[File:cumnavigatehome.png]]
  −
  −
And then click „Add widget“:
  −
  −
[[File:cumaddwidget.png]]
  −
  −
Select „Asset properties“ widget and type title, then select „TLT-RUT955 Router“ in „Target Assets or Devices“:
  −
  −
[[File: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:
  −
  −
[[File:cumtotalprops.png]]
  −
  −
Then click „Save“ and you should be able to see widget with properties you have set:
  −
  −
[[File:cumdevicewidgetinfo.png]]
  −
  −
==Explanation of example application==
   
There are two steps when adding new properties:
 
There are two steps when adding new properties:
   Line 349: Line 227:     
For more information about Lua API, download Cumulocity C++ SDK: https://bitbucket.org/m2m/cumulocity-sdk-c/downloads and look up inside „sdk/doc/lua.html“ with a browser.
 
For more information about Lua API, download Cumulocity C++ SDK: https://bitbucket.org/m2m/cumulocity-sdk-c/downloads and look up inside „sdk/doc/lua.html“ with a browser.
 +
 +
<!--==Configuring and launching example application==
 +
 +
If everything is correct with adding the device, a new device widget should show up with a status „PENDING ACCEPTANCE“:
 +
 +
[[File:cumpendingdevice.png]]
 +
 +
Click „Accept“ button to accept this device.
 +
 +
Now navigate to „All devices“ page:
 +
 +
[[File:cumalldevices.png]]
 +
 +
Here you should be able to see list of all registered devices:
 +
 +
[[File:cumallregistereddevices.png]]
 +
 +
Click on „TLT-RUT955 Router“ name to get into information page:
 +
 +
[[File: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“:
 +
 +
[[File:cumdevicecontrol.png]]
 +
 +
You can go back to Cumulocity Cockpit page the same way you entered Device managemant page:
 +
 +
[[File:cumnavigatecockpit.png]]
 +
 +
Then navigate to „Home“ page:
 +
 +
[[File:cumnavigatehome.png]]
 +
 +
And then click „Add widget“:
 +
 +
[[File:cumaddwidget.png]]
 +
 +
Select „Asset properties“ widget and type title, then select „TLT-RUT955 Router“ in „Target Assets or Devices“:
 +
 +
[[File: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:
 +
 +
[[File:cumtotalprops.png]]
 +
 +
Then click „Save“ and you should be able to see widget with properties you have set:
 +
 +
[[File:cumdevicewidgetinfo.png]]
    
==External Links==
 
==External Links==
Line 360: Line 296:  
{{Template: trademark disclaimer}}
 
{{Template: trademark disclaimer}}
 
-->
 
-->
−
[[Category:IoT]]
+
[[Category:IoT platforms]]
Retrieved from "https://wiki.teltonika-networks.com/view/Special:MobileDiff/69966...112435"