In this repository I will create a cloud-based IoT system that collects information from a set of virtual environmental sensors using the MQTT protocol. I will also create a simple web site to display the data collected from the sensors.
I will create 2 different Thingsboard setup:
- on premise: using Docker for development
- on cloud: using Digital Ocean for production
You have different user roles: sysadmin, tenant, user and customer. See this link to check default email and password
docker run -it -p 9090:9090 -p 1883:1883 -p 5683:5683/udp -v ~/.mytb-data:/data -v ~/.mytb-logs:/var/log/thingsboard --name mytb --restart always thingsboard/tb-postgresPorts:
- Admin Panel:
-p 9090:9090- connect local port 9090 to exposed internal HTTP port 9090 - MQTT Broker:
-p 1883:1883- connect local port 1883 to exposed internal MQTT port 1883 - CoAP Gateway:
-p 5683:5683- connect local port 5683 to exposed internal COAP port 5683
The complete guide is available at this link
https://thingsboard.io/docs/reference/mqtt-api/I used Mosquitto_pub to test wheather MQTT broker works. Once I have tested it, I stopped the mosquitto service. Otherwise, the 1883 port remains used by Mosquitto.
sudo apt install mosquitto mosquitto-cSlients
export ACCESS_TOKEN='A1_TEST_TOKEN'Download file (or write yourself)
mosquitto_pub -d -h "127.0.0.1" -t "v1/devices/me/telemetry" -u "$ACCESS_TOKEN" -f "telemetry-data-as-object.json"Parameters:
-u, --username
Provide a username to be used for authenticating with the broker. This requires a
broker that supports MQTT v3.1. See also the --pw argument.
After have tested that mosquitto_pub communicates with Thingsboard you can start to run your fake-iot-device. In this short tutorial is simply a small Python script.
Check if ports is free:
sudo netstat -tulpn | grep LISTEN
In my case I have been installed mosquitto hence I need to stop it.
sudo service mosquitto stop
sudo kill -9 <PID>otherwise I can just swap mqtt binding port on docker command.
In order to have a clear vision of How Thingsboard works you can see this complete video: link
it would have been impossible to briefly explain all the steps via UI, to complete the setup I highly recommend you to see see my short video on YouTube.
In the video, I show you how to:
- Create device
- Create asset and setup Relations
- Setup Rule chains :
Input -> Message Type Switch -> Post Telemetry -> Save Timeseries - Setup Entity aliases used to Datasource into the widgets.
- Create dashboards which are linked together
- Add Widgets into Dashboard
- Build custom data-processing code to manipulate data
Moreover, it is mandatory to change DEFAULT PASSWORD if your solutions is online.
Clone this repositort and install all dependencies, I suggest you to use venv:
git clone https://github.com/fcolasante/thingsboard-tutorial.git
cd device
pip install -r requirements.txt
mv secrets.example.py secrets.py
Update secrets.py setting OPEN_WHEATER_API and ACCESS_TOKEN. Each device should have a different ACCESS_TOKEN.
Go to Thingsboard panel and copy it.
N.B. In order to simplify teacher's testing, I have also versioned (for a limited period) mysecrets.py. To rapidly deploy my configuration, launch:
mv mysecrets.py secrets.pyIn the fake-iot-device.py you can setup many parameters:
city: to choose the OpenWheater cityProduction: ifTruedata are pushed onPUBLIC_IP, otherwise it sends data tolocalhost.generate_data(openWeather=False):ifTruedata are fetched byOpenWeather API, otherwise it produces random data.sleep_time: time between 2 different telemetry datas.
cd virtual
python3 fake-iot-device.pyYou can check if it works accessing as customer (Email: [email protected] Password: customer) visualizing Dashboard demo.
To run different devices you need to edit getDeviceToken.
I choose to not enter the token by the keyboard because it is not user-friendly and you should copy it every time.
In order to run a set of devices on the same script, run fake-asset.py. You have to configure the array CITIES into the file secrets.py. The example below does not work,it is for illustration purposes only, tokens are invented.
CITIES = [['V12mMG95NmrJ8Wu4asd', 'Chieti'],
['TldN65VTzMukZnAWasdf', 'Francavilla al Mare'],
['ssWgp3cschyZJf3asdf', "L\'Aquila"],
['qZdNlOVhuMKf7fRasdf', 'Teramo']
]The first element represents the ACCESS TOKEN of the corresponding thingsboard device, the second element is used by the OpenWheater API to fetch real environmental data of the CITY.
python3 fake-asset.pyYou can check if it works accessing as customer (Email: [email protected] Password: customer) visualizing Dashboard > Dati comuni abruzzesi.
Get your 50$ from Education Github ad link In order to setup Thingsborad on Digital Ocean follow this steps:
- https://thingsboard.io/docs/user-guide/install/digital-ocean/
- https://www.digitalocean.com/docs/droplets/how-to/connect-with-ssh/openssh/
- https://thingsboard.io/docs/user-guide/install/ubuntu/
You can access on my Thingsboard solution hosted on Digital Ocean Droplet by this Public IP. The public credentials are:
- Email:
[email protected] - Password:
customer
Read my article and see the video in order to have a better view of this project.
Check the Tutorial #2 available at link.
It provides:
- riot firmware
- MQTT-SN configuration
- iot-lab hands-on
Check the Tutorial #3 available at link.
It provides:
- LoRaWAN connection
- TheThingsNetwork getting started
- MQTT gateway
- iot-lab testbed
Check the Tutorial #3 available at link.
It provides:
- Crowd sensing
- Human recognition activity
- Generic Sensor API
- Thingsboard Dashboard
- HTML5 + Javascript web application
- cloud / edge architecture
Tutorials of the Internet of Things course 2020, part of the MSc on Computer Engineering, Department of Computer, Control and Management Engineering (DIAG), Sapienza University of Rome.