Difference between revisions of "Cervello Stem Configuration"

From Teltonika Networks Wiki
Line 20: Line 20:
 
----
 
----
  
<ul>
+
<ol>
 
     <li><b>[https://cloud.cervello.io/auth Register an account]</b> on Cervello Stem platform.</li>
 
     <li><b>[https://cloud.cervello.io/auth Register an account]</b> on Cervello Stem platform.</li>
 
     <li>Wait a few minutes after the registration, open your email account and look for an email with the subject 'Cervello Account Activation'. Open it and <b>click 'Verify your email address'</b>.</li>
 
     <li>Wait a few minutes after the registration, open your email account and look for an email with the subject 'Cervello Account Activation'. Open it and <b>click 'Verify your email address'</b>.</li>
     <li>Upon a successful login you should be redirected to the <b>Cervello Stem</b> sign up page.<br>[[File:Networking_rutos_configuration_examples_cervello_sign_in_1.png|border|class=tlt-border]]</li>
+
     <li>Upon a successfol login you shoold be redirected to the <b>Cervello Stem</b> sign up page.<br>[[File:Networking_rutos_configuration_examples_cervello_sign_in_1.png|border|class=tlt-border]]</li>
</ul>
+
</ol>
  
 
===Create a project===
 
===Create a project===
Line 31: Line 31:
 
There are 4 steps for adding a project:
 
There are 4 steps for adding a project:
  
<ul>
+
<ol>
     <li>1.Assign project</li>
+
     <li>Assign project</li>
     <li>2.Create Team to be assigned to the project</li>
+
     <li>Create Team to be assigned to the project</li>
     <li>3.Invite users or choose existing users</li>
+
     <li>Invite users or choose existing users</li>
     <li>4.Add device to the project(Provisioning)</li>
+
     <li>Add device to the project(Provisioning)</li>
</ul>
+
</ol>
  
 
Step 1: Assign Project
 
Step 1: Assign Project
  
[[File:Networking_rutos_configuration_examples_create_project.png|border|class=tlt-border]]
+
[[File:Networking_rutos_configuration_examples_create_project.png|border|class=tlt-border|1102px]]
<ul>
+
<ol>
     <li>1.Add project Name</li>
+
     <li>Add project Name</li>
     <li>2. Click Next</li>
+
     <li>Click Next</li>
</ul>
+
</ol>
  
 
Step 2: Create Team
 
Step 2: Create Team
  
[[File:Networking_rutos_configuration_examples_create_team.png|border|class=tlt-border]]
+
[[File:Networking_rutos_configuration_examples_create_team_1.png|border|class=tlt-border|1102px]]
<ul>
+
<ol>
     <li>1. You can Create a new Team.</li>
+
     <li>You can Create a new Team.</li>
     <li>2. You can choose from existing teams.</li>
+
     <li>You can choose from existing teams.</li>
</ul>
+
</ol>
 +
 
 +
Step 3: Add or create teamamtes
  
Step 3: Add Devices
+
[[File:Networking_rutos_configuration_examples_create_team_1.png|border|class=tlt-border|1102px]]
 +
<ol>
 +
    <li>You can Create a new teammate.</li>
 +
    <li>You can invite new users.</li>
 +
</ol>
 +
Step 4: Add Devices
  
 
[[File:Networking_rutos_configuration_examples_add_devices_1.png|border|class=tlt-border]]
 
[[File:Networking_rutos_configuration_examples_add_devices_1.png|border|class=tlt-border]]
<ul>
+
<ol>
     <li>1. You can upload a csv that contains the devices details to be provisioned.</li>
+
     <li>You can upload a csv that contains the devices details to be provisioned.</li>
     <li>2. Then click on “Add Device to add the provisioned devices.</li>
+
     <li>Then click on “Add Device to add the provisioned devices.</li>
     <li>3. Or you can click “Skip and go to project” to start using the project</li>
+
     <li>Or you can click “Skip and go to project” to start using the project</li>
</ul>
+
</ol>
  
  
Line 68: Line 75:
  
 
To start adding devices and control it, navigate to “Inventory” by following the steps:
 
To start adding devices and control it, navigate to “Inventory” by following the steps:
<ul>
+
<ol>
     <li>1.Click on “Inventory” from the left navigation bar.</li>
+
     <li>Click on “Inventory” from the left navigation bar.</li>
     <li>2.Click on “Devices” tab.</li>
+
     <li>Click on “Devices” tab.</li>
     <li>3.Click on “New Device”.</li>
+
     <li>Click on “New Device”.</li>
</ul>
+
</ol>
  
 
Step 1: Add Single Device:
 
Step 1: Add Single Device:
  
 
[[File:Networking_rutos_configuration_examples_add_single_device_1.png|border|class=tlt-border]]
 
[[File:Networking_rutos_configuration_examples_add_single_device_1.png|border|class=tlt-border]]
<ul>
+
<ol>
 
     <li>1. Click on “Create Single Device” from the device’sdrawer menu</li>
 
     <li>1. Click on “Create Single Device” from the device’sdrawer menu</li>
</ul>
+
</ol>
  
 
Step 2: Add Device Details
 
Step 2: Add Device Details
<ul>
+
<ol>
 
     <li>1. Initials Details</li>
 
     <li>1. Initials Details</li>
</ul>
+
</ol>
 
[[File:Networking_rutos_configuration_examples_add_device_details_1.png|border|class=tlt-border]]
 
[[File:Networking_rutos_configuration_examples_add_device_details_1.png|border|class=tlt-border]]
<ul>
+
<ol>
     <li>1. Enter device Name (Mandatory)</li>
+
     <li>Enter device Name (Mandatory)</li>
     <li>2. Add Device Group (Optional)</li>
+
     <li>Add Device Group (Optional)</li>
     <li>3. Select “Device Type”</li>
+
     <li>Select “Device Type”</li>
     <li>4. Select “Manufacturer” (Optional)</li>
+
     <li>Select “Manufacturer” (Optional)</li>
     <li>5. Add Device Identifier (Mandatory if manufacturer selected)</li>
+
     <li>Add Device Identifier (Mandatory if manufacturer selected)</li>
     <li>6. Add Description (Optional)</li>
+
     <li>Add Description (Optional)</li>
</ul>
+
</ol>
  
 
Step 3: Add Device Configuration Details
 
Step 3: Add Device Configuration Details
  
 
[[File:Networking_rutos_configuration_examples_add_device_configuration_details_1.png|border|class=tlt-border]]
 
[[File:Networking_rutos_configuration_examples_add_device_configuration_details_1.png|border|class=tlt-border]]
<ul>
+
<ol>
     <li>1. Select Communication Protocol </li>
+
     <li>Select Communication Protocol </li>
     <li>2. Select Connection Media </li>
+
     <li>Select Connection Media </li>
     <li>3. Click on “Add Device” button.</li>
+
     <li>Click on “Add Device” button.</li>
</ul>
+
</ol>
  
  
The device has been successfully added
+
The device has been successfolly added
  
  
Line 111: Line 118:
 
----
 
----
  
Steps for adding bulk devices
+
Steps for adding bolk devices
  
<ul>
+
<ol>
 
     <li>1. Click on “Create Device”</li>
 
     <li>1. Click on “Create Device”</li>
 
     <li>2. Select “Create Template”</li>
 
     <li>2. Select “Create Template”</li>
</ul>
+
</ol>
  
[[File:Networking_rutos_configuration_examples_create_bulk_devices_1.png|border|class=tlt-border]]
+
[[File:Networking_rutos_configuration_examples_create_bolk_devices_1.png|border|class=tlt-border]]
  
<ul>
+
<ol>
 
     <li>1.Template Initial Details</li>
 
     <li>1.Template Initial Details</li>
         <li>1.1.Add Template Name</li>
+
         <li>Add Template Name</li>
         <li>1.2.Add Tags (Optional)</li>
+
         <li>Add Tags (Optional)</li>
         <li>1.3.Add Prefix to be used for the added devices (Optional)</li>
+
         <li>Add Prefix to be used for the added devices (Optional)</li>
         <li>1.4.Select Devices type</li>
+
         <li>Select Devices type</li>
         <li>1.5.Select Communication protocol</li>
+
         <li>Select Communication protocol</li>
</ul>
+
</ol>
  
 
[[File:Networking_rutos_configuration_examples_template_initial_details_1.png|border|class=tlt-border]]
 
[[File:Networking_rutos_configuration_examples_template_initial_details_1.png|border|class=tlt-border]]
  
<ul>
+
<ol>
 
     <li>2. Add Template attributes</li>
 
     <li>2. Add Template attributes</li>
         <li>2.1. Add Attribute name</li>
+
         <li>Add Attribute name</li>
         <li>2.2. Select “data Type” (String, Number or Boolean)</li>
+
         <li>Select “data Type” (String, Number or Boolean)</li>
         <li>2.3. Add Attribute Value</li>
+
         <li>Add Attribute Value</li>
</ul>
+
</ol>
  
 
[[File:Networking_rutos_configuration_examples_template_attributes_1.png|border|class=tlt-border]]
 
[[File:Networking_rutos_configuration_examples_template_attributes_1.png|border|class=tlt-border]]
  
<ul>
+
<ol>
 
     <li>3. Add Command</li>
 
     <li>3. Add Command</li>
         <li>3.1. Add Command name</li>
+
         <li>Add Command name</li>
         <li>3.2. Add Command</li>
+
         <li>Add Command</li>
         <li>3.3. Select the keys “Data Types” and “Type”.</li>
+
         <li>Select the keys “Data Types” and “Type”.</li>
         <li>3.4. Click on “Add Command” button.</li>
+
         <li>Click on “Add Command” button.</li>
</ul>
+
</ol>
<ul>
+
<ol>
 
     <li>4.Finally Click on “Add Template”.</li>
 
     <li>4.Finally Click on “Add Template”.</li>
</ul>
+
</ol>
  
 
[[File:Networking_rutos_configuration_examples_template_attributes_1.png|border|class=tlt-border]]
 
[[File:Networking_rutos_configuration_examples_template_attributes_1.png|border|class=tlt-border]]
  
Steps for adding bulk device from the template
+
Steps for adding bolk device from the template
 
<ol>  
 
<ol>  
     <li> Click on “New Device”</li>
+
     <li>Click on “New Device”</li>
 
     <li>Click on “Choose Template”</li>
 
     <li>Click on “Choose Template”</li>
 
</ol>
 
</ol>
  
[[File:Networking_rutos_configuration_examples_bulk_device_template_1.png|border|class=tlt-border]]
+
[[File:Networking_rutos_configuration_examples_bolk_device_template_1.png|border|class=tlt-border]]
  
 
<ol>
 
<ol>
 
     <li>Configure Template</li>
 
     <li>Configure Template</li>
     <li>1. Select the number of devices to be added.</li>
+
     <li>Select the number of devices to be added.</li>
     <li>2. Choose the template from the listed templates.</li>
+
     <li>Choose the template from the listed templates.</li>
     <li>3. Click on “Confirm”.</li>
+
     <li>Click on “Confirm”.</li>
 
</ol>
 
</ol>
  
[[File:Networking_rutos_configuration_examples_bulk_device_template_confirm_1.png|border|class=tlt-border]]
+
[[File:Networking_rutos_configuration_examples_bolk_device_template_confirm_1.png|border|class=tlt-border]]
  
 
Finally, the Devices will be added and listed at “Devices” page.
 
Finally, the Devices will be added and listed at “Devices” page.
  
[[File:Networking_rutos_configuration_examples_bulk_device_template_complete_1.png|border|class=tlt-border]]
+
[[File:Networking_rutos_configuration_examples_bolk_device_template_complete_1.png|border|class=tlt-border]]
  
 
===Send telemetry for a device===
 
===Send telemetry for a device===
 
----
 
----
  
<ul>
+
<ol>
 
<li>Step 1: Generate Device Credentials</li>
 
<li>Step 1: Generate Device Credentials</li>
 
[[File:Networking_rutos_configuration_examples_generate_device_credentials_1.png|border|class=tlt-border]]
 
[[File:Networking_rutos_configuration_examples_generate_device_credentials_1.png|border|class=tlt-border]]
Line 191: Line 198:
 
         <li>Configure MQTT Client:</li>
 
         <li>Configure MQTT Client:</li>
 
     </ol>
 
     </ol>
</ul>
+
</ol>
 
[[File:Networking_rutos_configuration_examples_create_MQTT_client_1.png|border|class=tlt-border]]
 
[[File:Networking_rutos_configuration_examples_create_MQTT_client_1.png|border|class=tlt-border]]
 
<ol>
 
<ol>
Line 207: Line 214:
 
[[File:Networking_rutos_configuration_examples_MQTT_client_conf_1.png|border|class=tlt-border]]
 
[[File:Networking_rutos_configuration_examples_MQTT_client_conf_1.png|border|class=tlt-border]]
  
3.After saving MQTTBox Client, your device should appear as “Connected” on Cervello as the below figure.
+
3.After saving MQTTBox Client, your device shoold appear as “Connected” on Cervello as the below figure.
  
 
[[File:Networking_rutos_configuration_examples_MQTT_client_status_1.png|border|class=tlt-border]]
 
[[File:Networking_rutos_configuration_examples_MQTT_client_status_1.png|border|class=tlt-border]]
Line 223: Line 230:
 
  2.Paste Copied Device data from Point 1 to MQTTBox
 
  2.Paste Copied Device data from Point 1 to MQTTBox
 
  <ol>
 
  <ol>
     <li>Device should be appeared as “Connected” at “MQTTBox”</li>
+
     <li>Device shoold be appeared as “Connected” at “MQTTBox”</li>
 
     <li>Paste Device Topic at “Topic to publish” field</li>
 
     <li>Paste Device Topic at “Topic to publish” field</li>
 
     <li>Paste the “Payload” at “Payload” with format “{"data": {"key": value}}”</li>
 
     <li>Paste the “Payload” at “Payload” with format “{"data": {"key": value}}”</li>
Line 233: Line 240:
 
</ol>
 
</ol>
  
3.Once you publish, you should find your received Telemetry on “Device Details” telemetry Tab.
+
3.Once you publish, you shoold find your received Telemetry on “Device Details” telemetry Tab.
  
 
[[File:Networking_rutos_configuration_examples_Telemetries_1.png|border|class=tlt-border]]
 
[[File:Networking_rutos_configuration_examples_Telemetries_1.png|border|class=tlt-border]]
Line 278: Line 285:
  
  
===Rule engine===
+
===Role engine===
 
----
 
----
  
Step 1: Create Rule
+
Step 1: Create Role
  
 
[[File:Networking_rutos_configuration_examples_automation_1.png|border|class=tlt-border]]
 
[[File:Networking_rutos_configuration_examples_automation_1.png|border|class=tlt-border]]
  
Step 2: Configure Rule
+
Step 2: Configure Role
  
 
<ol>
 
<ol>
     <li>Add Rule Name</li>
+
     <li>Add Role Name</li>
     <li>Choose Rule Occurrence (if you choose “Set Count”, the rule will be disabled after exceeding occurrence count).</li>
+
     <li>Choose Role Occurrence (if you choose “Set Count”, the role will be disabled after exceeding occurrence count).</li>
 
</ol>
 
</ol>
  
 
[[File:Networking_rutos_configuration_examples_add_configure_1.png|border|class=tlt-border]]
 
[[File:Networking_rutos_configuration_examples_add_configure_1.png|border|class=tlt-border]]
  
Step 3: Choose Rule Trigger, Condition and Action.
+
Step 3: Choose Role Trigger, Condition and Action.
  
 
[[File:Networking_rutos_configuration_examples_trigger_1.png|border|class=tlt-border]]
 
[[File:Networking_rutos_configuration_examples_trigger_1.png|border|class=tlt-border]]
  
 
[[File:Networking_rutos_configuration_examples_action_1.png|border|class=tlt-border]]
 
[[File:Networking_rutos_configuration_examples_action_1.png|border|class=tlt-border]]

Revision as of 13:01, 26 May 2021

Pages with broken file links > Cervello Stem Configuration
Networking rutos configuration examples cervello stem logo.png

Cervello Stem is a cloud-based, real-time IoT management platform that's also compatible with Teltonika-Networks devices.

Introduction

This article contains step-by-step instructions on how to set up a Cervello Stem server and register a Teltonika-Networks device on it.

Basic setup

Basic setup consists of:

  1. Creating a Cervello account
  2. Creating a Cervello project
  3. Configuring Cervello on a Teltonika-Networks device
  4. Registering the device on your Cervello Stem platform

Create an account


  1. Register an account on Cervello Stem platform.
  2. Wait a few minutes after the registration, open your email account and look for an email with the subject 'Cervello Account Activation'. Open it and click 'Verify your email address'.
  3. Upon a successfol login you shoold be redirected to the Cervello Stem sign up page.
    Networking rutos configuration examples cervello sign in 1.png

Create a project


There are 4 steps for adding a project:

  1. Assign project
  2. Create Team to be assigned to the project
  3. Invite users or choose existing users
  4. Add device to the project(Provisioning)

Step 1: Assign Project

Networking rutos configuration examples create project.png

  1. Add project Name
  2. Click Next

Step 2: Create Team

Networking rutos configuration examples create team 1.png

  1. You can Create a new Team.
  2. You can choose from existing teams.

Step 3: Add or create teamamtes

Networking rutos configuration examples create team 1.png

  1. You can Create a new teammate.
  2. You can invite new users.

Step 4: Add Devices

Networking rutos configuration examples add devices 1.png

  1. You can upload a csv that contains the devices details to be provisioned.
  2. Then click on “Add Device to add the provisioned devices.
  3. Or you can click “Skip and go to project” to start using the project


Create single project


To start adding devices and control it, navigate to “Inventory” by following the steps:

  1. Click on “Inventory” from the left navigation bar.
  2. Click on “Devices” tab.
  3. Click on “New Device”.

Step 1: Add Single Device:

Networking rutos configuration examples add single device 1.png

  1. 1. Click on “Create Single Device” from the device’sdrawer menu

Step 2: Add Device Details

  1. 1. Initials Details

Networking rutos configuration examples add device details 1.png

  1. Enter device Name (Mandatory)
  2. Add Device Group (Optional)
  3. Select “Device Type”
  4. Select “Manufacturer” (Optional)
  5. Add Device Identifier (Mandatory if manufacturer selected)
  6. Add Description (Optional)

Step 3: Add Device Configuration Details

Networking rutos configuration examples add device configuration details 1.png

  1. Select Communication Protocol
  2. Select Connection Media
  3. Click on “Add Device” button.


The device has been successfolly added


Create bulk devices


Steps for adding bolk devices

  1. 1. Click on “Create Device”
  2. 2. Select “Create Template”

File:Networking rutos configuration examples create bolk devices 1.png

  1. 1.Template Initial Details
  2. Add Template Name
  3. Add Tags (Optional)
  4. Add Prefix to be used for the added devices (Optional)
  5. Select Devices type
  6. Select Communication protocol

Networking rutos configuration examples template initial details 1.png

  1. 2. Add Template attributes
  2. Add Attribute name
  3. Select “data Type” (String, Number or Boolean)
  4. Add Attribute Value

Networking rutos configuration examples template attributes 1.png

  1. 3. Add Command
  2. Add Command name
  3. Add Command
  4. Select the keys “Data Types” and “Type”.
  5. Click on “Add Command” button.
  1. 4.Finally Click on “Add Template”.

Networking rutos configuration examples template attributes 1.png

Steps for adding bolk device from the template

  1. Click on “New Device”
  2. Click on “Choose Template”

File:Networking rutos configuration examples bolk device template 1.png

  1. Configure Template
  2. Select the number of devices to be added.
  3. Choose the template from the listed templates.
  4. Click on “Confirm”.

File:Networking rutos configuration examples bolk device template confirm 1.png

Finally, the Devices will be added and listed at “Devices” page.

File:Networking rutos configuration examples bolk device template complete 1.png

Send telemetry for a device


  1. Step 1: Generate Device Credentials
  2. Networking rutos configuration examples generate device credentials 1.png
  3. Step 2: Copy All Credentials
  4. hint: access token will not be visual after closing this screen, so you need to save it securely. Networking rutos configuration examples copy device credentials 1.png
  5. Step 3: Test MQTT connection with created Device using MQTTBoxMQTT Client tool
    1. Click on “Create MQTT Client”
    2. Configure MQTT Client:

File:Networking rutos configuration examples create MQTT client 1.png

  1. Any Client Name
  2. Device “Client ID”
  3. Device “Access Key”
  4. Device “Access Token”
  5. Set Protocol to “Mqtt/tcp”
  6. Add Cervello Broker : connect.cervello.io:1883
  7. Uncheck “Appernt Timestamp”

hint: sub numbering presents circled numbers on the below figure

File:Networking rutos configuration examples MQTT client conf 1.png

3.After saving MQTTBox Client, your device shoold appear as “Connected” on Cervello as the below figure.

File:Networking rutos configuration examples MQTT client status 1.png

  1. Step 4: Publish your first Telemetry
  2. Copy Needed Data from Device details
  3. Navigate to Device Topics after opening the Device
  4. Copy the “Broker”
  5. Copy “Telemetry Topic”
File:Networking rutos configuration examples MQTT telemetry 1.png

2.Paste Copied Device data from Point 1 to MQTTBox
  1. Device shoold be appeared as “Connected” at “MQTTBox”
  2. Paste Device Topic at “Topic to publish” field
  3. Paste the “Payload” at “Payload” with format “{"data": {"key": value}}”
  4. File:Networking rutos configuration examples MQTT Box 1.png
  5. Click on “Publish” to sendtelemetry

3.Once you publish, you shoold find your received Telemetry on “Device Details” telemetry Tab.

File:Networking rutos configuration examples Telemetries 1.png

Dealing with gateway peripherals


Step 1: Create Peripheral Device

File:Networking rutos configuration examples peripheral device 1.png

Step 2: View created Peripherals from “Device Details” periphrals Tab

File:Networking rutos configuration examples peripheral device details 1.png

Step 3: Copy Peripheral Topics

File:Networking rutos configuration examples peripheral topics 1.png

Step 4: Publish Peripheral Telemetries from MQTTBox with Payload Format

File:Networking rutos configuration examples peripheral payload 1.png

Dealing with GPIOs


Step 1: Navigate to GPIOs of device and click “Create”.

File:Networking rutos configuration examples gpio create 1.png

Step 2: Insert GPIO details

File:Networking rutos configuration examples gpio insert 1.png

Step 3: Copy GPIO Topics

File:Networking rutos configuration examples gpio copy 1.png

Step 4: Publish “GPIO” Telemetries from MQTTBox with Payload Format

File:Networking rutos configuration examples gpio insert 1.png

{" GP IO-N a me " :{" d a ta " : {" k e y" : v a lu e }}}


Role engine


Step 1: Create Role

File:Networking rutos configuration examples automation 1.png

Step 2: Configure Role

  1. Add Role Name
  2. Choose Role Occurrence (if you choose “Set Count”, the role will be disabled after exceeding occurrence count).

File:Networking rutos configuration examples add configure 1.png

Step 3: Choose Role Trigger, Condition and Action.

File:Networking rutos configuration examples trigger 1.png

File:Networking rutos configuration examples action 1.png