1. ThingScale Developers
  2. Developer Portal

Getting Started

Created by Toru Murasawa
Last updated Jan 15, 2021

Introduction

Thips page gives an overall summary of the main ThingScale components that you need to configure in order to set up ThingScale to process device streams, and how to configure them through the ThingScale Management Console UI.Given below the main components in ThingScale:

  1. Device Connector : Providing device connectivity and Secure transport mechanism.

  2. Device Manager : Manage Device ID, Token Authentication and device status.

  3. Channel Manager : Manage stream related to the device. 

  4. Event Manager : Near-realtime stream processing happens based on streams.

You can create device,channel and event using the ThingScale Management Console,which is available at https://m.thingscale.io/console/

Optionally, you can directly create,modify,delete the object from REST APIs.

Creating an Device

In ThingScale there are two ways of device create method,

  • Manual Provision : To create device from Management Console or REST API

  • Auto Provision: To create device when the configured device is first connected.

ThingScale support Auto Provision to reduce the workload on the device registration tasks. 

To configure a device, you log in to the Management Console and select Device menu from left pane.

The UI looks as follows:

The device details that open for you to fill depend on the device you choose.For detail on how to create a device from REST API,see Device service.

Creating a channel

A channel is a time-series database which stores device's data streams. For a single channel, a single literal (eg temperature) or JSON object is stored.

To configure a channel, you log in to the Management Console and select Channel menu from left pane.

The UI looks as follows:

The channel details that open for you to fill depend on the channel you choose.For detail on how to create a channel from REST API,see Channel service.



Viewing device stream

To show a device stream, you log in to the Management Console and select Stream menu from left pane.

The UI looks as follows:

In the Stream section, there are three types of options:

  1. Source : Channel ID and name related to the device

  2. Range : time range of datapoint

  3. Reset : Reset to default time range(1 hour)

Creating Event

Event are another main part in ThingScale. All the processing(notification or HTTP_POST) happens based on streams.

For detail on how to working with a event,see Working with Event.