Cervello Stem Configuration

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.

IntroductionEdit

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 setupEdit

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 accountEdit


  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 projectEdit


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

Configuring data sourceEdit


Different data streams can be selected depending on the device's supported functionality's. In this example we will be using Modbus TCP slave with native Modbus TCP master functionality.

1. First, change WEBUI mode from basic to advanced.
Networking rutx manual webui basic advanced mode.gif 2. Go to Services → Modbus TCP slave page.
3. Enable Modbus TCP slave.
Thingboards io Modbus TCP slave.png 4. Go to Modbus TCP master page and add new slave device.
Thingboards io Modbus TCP master.png 5. Configure Modbus TCP master's slave device as shown below to return device's uptime value.
Thingboards io Modbus TCP master device.png

Configuring data to server with HTTP protocolEdit


After configuring the data source, you can add a data sender configuration. Data sender functionality is located Services → Data to server. You can add data sender by clicking Add button.

File:Networking rutos configuration examples cervello Data to server HTTP.png

File:Networking rutos configuration examples cervello data sender configuration.png

  1. Set name for the Data sender.
  2. Set desirable name for your data variable. Make sure that your chosen parameter is shown below JSON format field.
  3. Paste connection string with your own Access key.
  4. https://broker.cervello.io:7443?t=/device/{ACCESSKEY}/telemetry'
  5. Add value to Custom header.
  6. Content-Type:application/json
    x-client-id: {ACCESSKEY}
    Authorization: Basic {hash generated from Access Key as username and Access Token as password} 

Create single projectEdit


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 devicesEdit


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 deviceEdit


  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