Difference between revisions of "Cervello Stem Configuration"

From Teltonika Networks Wiki
Line 83: Line 83:
 
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|1102px]]
 
<ol>
 
<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>

Revision as of 14:11, 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 teammates 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 bulk devices

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

Networking rutos configuration examples create bulk 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 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. Select the number of devices to be added.
  3. Choose the template from the listed templates.
  4. 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


  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