Kaa Cloud Getting Started

Overview

In this tutorial we will look at how to get started with Kaa Cloud:

  1. How to connect a device simulator to the Kaa Cloud server.
  2. How to send and visualize device simulated data in Web Dashboard.

Prerequisites

  1. You have an account on Kaa Cloud.
  2. Python 2.7 is installed on your machine.

Playbook

1. Let’s go to devices dashboard in your Kaa Cloud account.

Devices dashboard

As you can see from empty Endpoint List widget, there are no connected devices yet. Let’s connect one.

2. Clone device simulator from here.

The simulator consists of two files:

  • client.py - device simulator code written in Python 2.7.
  • location.json - geographical location data for device live location simulation.

Both files must be placed together in one directory.

3. Register device digital twin, which is called “endpoint” in Kaa terminology, in Kaa Cloud.

Device creation. First step

Enter the desired endpoint token, device name and description. You will use the token in a bit to connect your device. You can leave the token empty and let Kaa generate one for you.

Device creation. Second step

Remember the endpoint token – we will need it later.

Device creation. Third step

4. Go to the dashboard of the just created endpoint and copy its application version.

Device dashboard

5. Run the cloned simulator from a terminal.

Enter the directory with the cloned simulator (where client.py and location.json files are located). Enter the next command replacing {mySecretToken} and {myAppVersionName} with your token and application version name respectively:

$ python --token {mySecretToken} --appVersionName {myAppVersionName} client.py

After hitting the command you should see simulator logs.

Simulator logs

6. Go back to dashboard of the just connected endpoint and view simulated data.

Device dashboard of connected simulator

Congratulations, you have connected your first device simulator to the Kaa Cloud! We encourage you to experiment with the simulator source code, modify the dashboards, and get back to us with the feedback!

Next steps