ThingsBoard-TTGO-T-Beam-GeoTracker-Telemetry

This project seeks to collect and send any kind of telemetry to the ThingsBoard platform. It's purpose is to geotrace each data point, with the initial work of tracking temperature and humidity changes and compare them with the urban aspect of that data set.

At least two TTGO T-Beam are required to run this project, one or more Telemetry unities (Which collect the data and send them via LoRa to the Gateway) and the Gateway itself (Which is responsible to gather the LoRa data from multiple Telemetry Units and send it to the ThingsBoard, using the ThingsBoard SDK). It is possible to collect data from other sensors, it is only necessary to add the telemetry to the JSON at the Telemetry Unit code, associate it to a new variable at the Gateway code and send it to the ThingsBoard.

Tutorial on how to upload sketches to the ESP32 TTGO T-Beam Board.

• Before you start:

  • CONECT THE LORA ANTENNA TO THE BOARD, DO NOT POWER ON THE BOARD WITHOUT THE LORA ANTENNA OR YOU MIGHT DAMAGE IT!
  • Install the following driver on your computer:
    • Silicon Labs - CP210x: Download here

      This driver is used by your computer to open a serial comunitation with your board.

  • Environment setup:
    • Arduino IDE:

      • Add the following url in "Additional Board Manager URLs" at File -> Preferences:

        https://dl.espressif.com/dl/package_esp32_index.json

        then click Ok, go to Tools -> Board -> Boards Manager, search and install "ESP32 by Espressif Systems", or follow this guide.

      • After you install the board software, just select on the boards menu "T-Beam", set the upload speed to 115200, leave the rest as is and you are going to be able to upload sketches to your TTGO board.

Additional information

• At least two TTGO T-Beam boards are required to run this project. One for the gateway and one or more for the Telemetry Unit.

• A new device shall be created on ThingsBoard for each Telemetry Unit. However, tokens are set on utilities.h of the Gateway code.

• The Gateway Board must be connected to a network that can be accessed by the ThingsBoard Instance at all time. Otherwise, data will be lost.

• The Wi-Fi SSID and Password must be defined at utilities.h of the Gateway code.

• The ThingsBoard Dashboard and Widget configuration must be made by yourself, but a guide is offered (in portuguese). Check the PDF file of this repository.