Cervello Stem Configuration

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.
   

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

1. Add project Name
2. Click Next

Step 2: Create Team

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

Step 3: Add or create teamamtes

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

Step 4: Add Devices

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 source

---

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.
2. Go to Services → Modbus TCP slave page.
3. Enable Modbus TCP slave.
4. Go to Modbus TCP master page and add new slave device.
5. Configure Modbus TCP master's slave device as shown below to return device's uptime value.

Configuring data to server with HTTP protocol

---

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.

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.

https://broker.cervello.io:7443?t=/device/{ACCESSKEY}/telemetry'

4. Add value to Custom header.

Content-Type:application/json

x-client-id: {ACCESSKEY}

Authorization: Basic {hash generated from Access Key as username and Access Token as password} 

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:

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

Step 2: Add Device Details

1. 1. Initials Details

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

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”

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

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

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”.

Steps for adding bulk device from the template

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

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

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

Send telemetry for a device

---

1. Step 1: Generate Device Credentials

2. Step 2: Copy All Credentials
hint: access token will not be visual after closing this screen, so you need to save it securely.

3. Step 3: Test MQTT connection with created Device using MQTTBoxMQTT Client tool
1. Click on “Create MQTT Client”
2. Configure MQTT Client:

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

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

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}}”
File:Networking rutos configuration examples MQTT Box 1.png
4. Click on “Publish” to sendtelemetry

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