fjudith / docker-thingsboard-demo

Dockerized ThingsBoard MQTT demo script running amd64/node official image

ThingsBoard Demo

This container image aims to simulate temperature and humidity sensors metrics sent by a device via MQTT protocol to ThingsBoard.

ThingsBoard is an open-source IoT platform for data collection, processing, visualization, and device management. it supports various messaging protocols such as:

• MQTT
• CoAP
• HTTP
• OPC-UA (ThingsBoard IoT Gateway)
• Sigfox (ThingsBoard IoT Gateway)

Description

The Dockerfile builds from the official Node.js image "amd64/node:latest" (see https://hub.docker.com/r/amd64/node/)

This image does not leverage embedded database nor persistent data.

Quick Start

Create a device from the ThingsBoard dashboard and copy the access token from the credential panel. Run the following command with the appropriates host name and access token.

docker container run --rm --name=tbdemo \
-e THINGSBOARD_HOST='thingsboard.example.com' \
-e DEVICE_ACCESS_TOKEN='v3ry1nS3cur3T0k3n' \
-e FREQUENCY="100" \
fjudith/thingsboard-demo

Metrics will be shipped to ThingsBoard's MQTT listener every 100 milliseconds.

Environment variables

Variable	Description	Default value
THINGSBOARD_HOST	Hostname, IP address or Fully Qualified name of the ThingsBoard MQTT listener	demo.thingsboard.io
DEVICE_ACCESS_TOKEN	Access token provisionned from the Thingsboard Devices pannel	empty
MINIMUM_TEMPERATURE	Simulated minimum temperature	17.5
MAXIMUM_TEMPERATURE	Simulated maximum temperature	30
MINIMUM_HUMIDITY	Simulated minimum humidity	12
MAXIMUM_HUMIDITY	Simulated maximum humidity	90
MINIMUM_LATITUDE	Simulated minimum latitude	48.8534100 (Paris)
MAXIMUM_LATITUDE	Simulated maximum latitude	48.856438 (Paris)
MINIMUM_LONGITUDE	Simulated maximum longitude	2.3488000 (Paris)
MAXIMUM_LONGITUDE	Simulated maximum longitude	2.352456 (Paris)
FIRMWARE_VERSION	Custom firmware version	$(uname -s)
SERIAL_NUMBER	Custom serial number	$(uname -r)
FREQUENCY	Metrics publishing frequency in milliseconds	1000 (1s)
VARIABILITY	Percent of randomization between min. and max	0.03 (3%)

Reference

• https://www.youtube.com/watch?v=dIKXFxpfB_Q