Difference between revisions of "Cervello Stem Configuration"

From Teltonika Networks Wiki
Line 170: Line 170:
 
[[File:Networking_rutos_configuration_examples_bulk_device_template_confirm_1.png|border|class=tlt-border]]
 
[[File:Networking_rutos_configuration_examples_bulk_device_template_confirm_1.png|border|class=tlt-border]]
  
Page | 25Finally, 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_bulk_device_template_complete_1.png|border|class=tlt-border]]
Line 176: Line 176:
 
===Send telemetry for a device===
 
===Send telemetry for a device===
 
----
 
----
 +
 
<ul>
 
<ul>
 
<li>Step 1: Generate Device Credentials</li>
 
<li>Step 1: Generate Device Credentials</li>
Line 237: Line 238:
  
 
===Dealing with gateway peripherals===
 
===Dealing with gateway peripherals===
 +
----
  
 
Step 1: Create Peripheral Device
 
Step 1: Create Peripheral Device
Line 255: Line 257:
  
 
===Dealing with GPIOs===
 
===Dealing with GPIOs===
 +
----
  
 
Step 1: Navigate to GPIOs of device and click “Create”.
 
Step 1: Navigate to GPIOs of device and click “Create”.
Line 272: Line 275:
 
[[File:Networking_rutos_configuration_examples_gpio_insert_1.png|border|class=tlt-border]]
 
[[File:Networking_rutos_configuration_examples_gpio_insert_1.png|border|class=tlt-border]]
  
>{" GP IO-N a me " :{" d a ta " : {" k e y" : v a lu e }}}
+
{" GP IO-N a me " :{" d a ta " : {" k e y" : v a lu e }}}
 +
 
 +
 
 +
===Rule engine===
 +
----
 +
 
 +
Step 1: Create Rule
 +
 
 +
[[File:Networking_rutos_configuration_examples_automation_1.png|border|class=tlt-border]]
 +
 
 +
Step 2: Configure Rule
 +
 
 +
<ol>
 +
    <li>Add Rule Name</li>
 +
    <li>Choose Rule Occurrence (if you choose “Set Count”, the rule will be disabled after exceeding occurrence count).</li>
 +
</ol>
 +
 
 +
[[File:Networking_rutos_configuration_examples_add_configure_1.png|border|class=tlt-border]]
 +
 
 +
Step 3: Choose Rule Trigger, Condition and Action.
 +
 
 +
[[File:Networking_rutos_configuration_examples_trigger_1.png|border|class=tlt-border]]
 +
 
 +
[[File:Networking_rutos_configuration_examples_action_1.png|border|class=tlt-border]]

Revision as of 11:40, 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


  • Register an account on Cervello Stem platform.
  • 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'.
  • Upon a successful login you should 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

File:Networking rutos configuration examples create team.png

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

Step 3: 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. Click on “Create Single Device” from the device’sdrawer menu

Step 2: Add Device Details

  • 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 successfully added


Create bulk devices


Steps for adding bulk devices

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

Networking rutos configuration examples create bulk devices 1.png

  • 1.Template Initial Details
  • 1.1.Add Template Name
  • 1.2.Add Tags (Optional)
  • 1.3.Add Prefix to be used for the added devices (Optional)
  • 1.4.Select Devices type
  • 1.5.Select Communication protocol

Networking rutos configuration examples template initial details 1.png

  • 2. Add Template attributes
  • 2.1. Add Attribute name
  • 2.2. Select “data Type” (String, Number or Boolean)
  • 2.3. Add Attribute Value

Networking rutos configuration examples template attributes 1.png

  • 3. Add Command
  • 3.1. Add Command name
  • 3.2. Add Command
  • 3.3. Select the keys “Data Types” and “Type”.
  • 3.4. Click on “Add Command” button.
  • 4.Finally Click on “Add Template”.

Networking rutos configuration examples template attributes 1.png

Steps for adding bulk device from the template

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

Networking rutos configuration examples bulk device template 1.png

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

Networking rutos configuration examples bulk device template confirm 1.png

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

Networking rutos configuration examples bulk device template complete 1.png

Send telemetry for a device


  • Step 1: Generate Device Credentials
  • Networking rutos configuration examples generate device credentials 1.png
  • Step 2: Copy All Credentials
  • 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
  • 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 should 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 should 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 should 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 }}}


Rule engine


Step 1: Create Rule

File:Networking rutos configuration examples automation 1.png

Step 2: Configure Rule

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

File:Networking rutos configuration examples add configure 1.png

Step 3: Choose Rule Trigger, Condition and Action.

File:Networking rutos configuration examples trigger 1.png

File:Networking rutos configuration examples action 1.png