Skip to content

Latest commit

 

History

History
188 lines (99 loc) · 8.75 KB

thingsboard_setup.md

File metadata and controls

188 lines (99 loc) · 8.75 KB

Back to software_installation.md

Table of Contents

This document describes the setup of ThingsBoard.

About Live Track

ThingsBoard is an open source dashboard platform. It is free to use and is one of the few platforms that can display tracks and paths (used as routes) on a map.

The dashboard can be viewed from the web(Live Demo server) and from the application.

For more details, see ThingsBoard Documentation and Getting Started with ThingsBoard.

dashboards

Three types of dashboards are currently provided.

Screenshot_20230618-095206

Screenshot_20230624-071451

Screenshot_20230104-080601~2

Create an account

Go to ThingsBoard and create a free account with "Live Demo" of Community Edition.

Create a device

Login to Live Demo server(demo.thingsboard.io).

Click "Entities" > "Devices" in the menu.

thingsboard-01-02-devices

Click "+" > "Add new device"

thingsboard-03-01-add_device

Input "Pizero Bikecomputer" in "Name" field and click "Add".

thingsboard-03-02-add_device

Now, the device is added. Click this.

thingsboard-03-03-added_device

Click "Copy access token" and paste THINGSBOARD_API section of setting.conf.

thingsboard-03-04-get_token

Import dashboards

Upload the dashboards provided.

Click "Dashboards" in the menu.

thingsboard-01-01-dashboard

Click "+" > "Import dashboard". For example, upload "pizero_bikecomputer_w_track_.json".

thingsboard-02-01-empty

Now, the dashboard is added. Click this.

thingsboard-02-02-imported

Connect the device to the dashboard

Allow the imported dashboard to retrieve values for the device you just created.

Click edit button.

thingsboard-02-03-dashboard

Click "Entity aliases" button.

thingsboard-02-04-click_entity

Click edit button.

thingsboard-03-05-set_device

Click "Device" to see the devices created. Select this and save.

thingsboard-03-06-set_device

Click "Save" button.

thingsboard-03-07-save_device

Click check button to save.

thingsboard-03-08-save_dashboard

Check the dashboard

Now you have the dashboard which works with the program. Check to see if the dashboard works. Run the program in demo mode.

$ python3 pizero_bikecomputer.py --demo

First, make sure that the value of Power, HR(heartrate) or Speed is available(not 0 or NaN). If you don't see any values, disable ANT+ in setting.conf.

Then click start button.

demo-01

Turn on Live Track from the menu.

livetrack-on

Open "Devices" section in "Entities" menu. The state of your device changed to "Active". Click it.

thingsboard-04-01-device_is_active

Click "Latest telemetry" tab. Values sent from the program are displayed.

thingsboard-04-02-device_is_active

Also, graph values(heartrate/power) are displayed.

thingsboard-04-03-device_is_active

Make the dashboard public

To allow others to see your dashboard, publish your device and dashboard.

Click submenu button and "Make device public" from "Devices" menu.

thingsboard-05-01-public_device

Click "Yes".

thingsboard-05-02-public_device

Then, click submenu button and "Make dashboard public" from "Dashboards" menu.

thingsboard-05-03-public_dashboard

You can get the public URL. Click "OK".

thingsboard-05-04-public_dashboard

If you want to make it private again, do the reverse operation.

Option

Change default location in the map

The default location is Tokyo in Japan. If you want to change it, edit your dashboard.

thingsboard-02-03-dashboard

Then click edit button in the map widget.

thingsboard-06-01-change_default_location

Click "Advanced" tab and "Advanced settings" under "Common map settings".

thingsboard-06-02-change_default_location

Change the value of "Default map center position". The format is "latitude,longitude".

thingsboard-06-03-change_default_location

Back to software_installation.md