![\"ESP32](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2022\/04\/ESP32-ESP8266-BME280-InfluxDB.jpg?quality=100&strip=all&ssl=1\")
<\/a><\/figure><\/div>\n\n\nUpdated 14 May 2024<\/em><\/p>\n\n\n\n By the end of this tutorial, you’ll be able to build a dashboard as shown below to display all your sensor readings over time.<\/p>\n\n\n\n At the moment, dashboards are not compatible with InfluxdDB serverless<\/a>. You must use InfluxDB 2 (running on a Raspberry Pi, for example\u2014see this post to set InfluxDB on Raspberry Pi<\/a>.)<\/p>\n\n\n To get started with InfluxDB, read one of the following guides:<\/p>\n\n\n\n InfluxDB is an open-source high-performance time series database (TSDB) that can store large amounts of data per second. Each data point you submit to the database is associated with a particular timestamp. So, it is ideal for IoT datalogging projects like storing data from your weather station sensors.<\/p>\n\n\n\n You can run InfluxDB in InfluxDB Cloud<\/a>, or locally on your laptop or Raspberry Pi<\/a>.<\/p>\n\n\n\n “Why use InfluxDB Cloud?<\/strong> It’s a fast, elastic, serverless real-time monitoring platform, dashboarding engine, analytics service and event and metrics processor.”<\/p>\nhttps:\/\/www.influxdata.com\/products\/influxdb-cloud\/<\/cite><\/blockquote>\n\n\n\n For a more in-depth introduction to InfluxDB, check the following tutorials before proceeding:<\/p>\n\n\n\n Set up InfluxDB. You have two options:<\/p>\n\n\n\n After setting up your account, you can proceed to the next section.<\/p>\n\n\n\n 1)<\/strong> Click on Load Data<\/strong> <\/strong><\/strong>icon and select Sources<\/strong><\/strong><\/strong>.<\/p>\n\n\n 2)<\/strong> Scroll down until you find the Arduino <\/strong>option under the Client Libraries<\/strong> section.<\/p>\n\n\n 3)<\/strong> Click on Initialize Client.<\/p>\n\n\n The page that opens allows you to create buckets, and it also shows some sample code to interface the ESP8266 or ESP32 boards with InfluxDB.<\/p>\n\n\n\n 4)<\/strong> Create a new bucket to store your data. Click on + Create Bucket<\/strong> to create a new bucket for this example. You can use the settings by default, or you can customize them.<\/p>\n\n\n 5)<\/strong> Get your InfluxDB URL* and other details you’ll need later. Scroll down to the Configure InfluxDB profile<\/em> snippet. Then, copy the INFLUXDB_URL<\/span>, INFLUXDB_TOKEN<\/span>, INFLUXDB_ORG<\/span>, and INFLUXDB_BUCKET<\/span>.<\/p>\n\n\n * if you’re running InfluxDB locally on a Raspberry Pi, the URL will be the Raspberry Pi IP address on port 8086. For example 192.168.1.106:8086<\/span>.<\/p>\n\n\n\n If you’ve followed the previous steps, InfluxDB cloud has already created an API token for you that you could find in the snippet presented in the previous step. If you go to the Load Data icon and select API Tokens, you’ll find the previously generated API token. <\/p>\n\n\n On this page, you can generate a new API token if needed.<\/p>\n\n\n\n At this moment, you should have saved the following:<\/p>\n\n\n\n In this section, we’ll program the ESP32 and ESP8266 boards to send BME280 temperature, humidity, and pressure readings to InfluxDB.<\/p>\n\n\n\n For this project, you need the following parts*:<\/p>\n\n\n\n * you can also test the project with random values instead of sensor readings, or you can use any other sensor you’re familiar with.<\/p>\n\n\n You can use the preceding links or go directly to MakerAdvisor.com\/tools<\/a> to find all the parts for your projects at the best price!<\/p> In this tutorial, we’ll send BME280 sensor readings to InfluxDB. So, you need to wire the BME280 sensor to your board. Follow one of the next schematic diagrams.<\/p>\n\n\n\n We’re going to use I2C communication with the BME280 sensor module. Wire the sensor to the default ESP32 SCL (GPIO 22<\/span>) and SDA (GPIO 21<\/span>) pins, as shown in the following schematic diagram.<\/p>\n\n\n Not familiar with the BME280 with the ESP32? Read this tutorial: ESP32 with BME280 Sensor using Arduino IDE (Pressure, Temperature, Humidity)<\/strong><\/a>.<\/p>\n\n\n\n We’re going to use I2C communication with the BME280 sensor module. For that, wire the sensor to the ESP8266 SDA (GPIO 4<\/span>) and SCL (GPIO 5<\/span>) pins, as shown in the following schematic diagram.<\/p>\n\n\n Not familiar with the BME280 with the ESP8266? Read this tutorial: ESP8266 with BME280 using Arduino IDE (Pressure, Temperature, Humidity)<\/strong><\/a>.<\/p>\n\n\n\n For this project, you need to install the following libraries:<\/p>\n\n\n\n If you\u2019re using Arduino IDE, follow the next steps to install the library.<\/p>\n\n\n\n Note: <\/strong> we are using ESP8266 Boards version 3.0.1<\/strong> and ESP32 Boards version 2.0.1<\/strong> Check your boards’ version in Tools <\/strong>> Board <\/strong>> Boards Manager<\/strong>. Then, search for ESP8266<\/strong> or ESP32<\/strong> and upgrade to one of those versions. (I found some issues with the newest 3.0.2 and 2.0.2 versions)<\/p>\n\n\n\n If you’re using VS Code with the PlatformIO extension, start by creating an Arduino project for your ESP32 or ESP8266 board.<\/p>\n\n\n\n Then, click on the PIO Home<\/strong> icon and then select the Libraries tab<\/strong>. Search for \u201cinfluxdb<\/strong>\u201c. Select the ESP8266 Influxdb<\/strong> by Tobias Sch\u00fcrg.<\/p>\n\n\n Follow the same procedure for the Adafruit BME280 library and Adafruit Unified Sensor library.<\/p>\n\n\n\n Your plaformio.ini<\/span> file should look as follows (we also added a line to change the Serial Monitor baud rate to 115200).<\/p>\n\n\n\n Copy the following code to the Arduino IDE or to the main.cpp<\/span> file if you’re using VS Code with the PlatformIO extension. The code is compatible with both the ESP32 and ESP8266 boards.<\/p>\n\n\n\n This code is based on this library example<\/a>. We made a few modifications to include the BME280 sensor readings.<\/p>\n\n\n View raw code<\/a><\/p>\n\n\n\n Before uploading the code to your board, you need to insert your network credentials, the database URL, token, organization, and bucket name. Also, don’t forget to insert your timezone. Check this document to search for your timezone<\/a> in the right format.<\/p>\n\n\n\n Start by including the required libraries and setting the DEVICE<\/span> name accordingly to the selected board (ESP32<\/span> or ESP8266<\/span>).<\/p>\n\n\n\n Insert your network credentials on the following variables so that the ESP32 or ESP8266 boards can connect to the internet using your local network.<\/p>\n\n\n\n Insert the InfluxDB server URL on the following lines\u2014the one you’ve gotten in this step<\/a>:<\/p>\n\n\n\n Note: <\/strong> if you’re running InfluxDB locally on a Raspberry Pi, the URL will be the Raspberry Pi IP address on port 8086. For example 192.168.1.106:8086<\/span>.<\/p>\n\n\n\n Insert your InfluxDB token\u2014saved in this step<\/a>:<\/p>\n\n\n\n Add your InfluxDB organization name\u2014check this step<\/a>.<\/p>\n\n\n\n Finally, add your InfluxDB bucket name:<\/p>\n\n\n\n You must set your timezone accordingly to these instructions<\/a>. The easiest way is to check this table and copy your timezone from there<\/a>.<\/strong> In my case, it’s Lisbon timezone:<\/p>\n\n\n\n<\/figure><\/div>\n\n\n\n
What is InfluxDB?<\/h2>\n\n\n
<\/figure><\/div>\n\n\n\n
\n
Setting Up Influx DB<\/h2>\n\n\n\n
\n
Loading Data in InfluxDB<\/h2>\n\n\n\n
<\/figure><\/div>\n\n\n<\/figure><\/div>\n\n\n<\/a><\/figure><\/div>\n\n\nCreating an InfluxDB Bucket<\/h3>\n\n\n\n
<\/figure><\/div>\n\n\nGetting InfluxDB URL and API Token<\/h3>\n\n\n\n
<\/figure><\/div>\n\n\nAPI Tokens<\/h3>\n\n\n\n
<\/figure><\/div>\n\n\n\n
\n\n\n\nESP32\/ESP8266 Send Sensor Readings to InfluxDB<\/h2>\n\n\n\n
Parts Required<\/h3>\n\n\n\n
\n
<\/a><\/p>\n\n\n\nSchematic Diagram<\/h3>\n\n\n\n
ESP32 with BME280<\/h4>\n\n\n\n
<\/figure><\/div>\n\n\nESP8266 with BME280 <\/h4>\n\n\n\n
<\/figure><\/div>\n\n\nInstalling Libraries<\/h3>\n\n\n\n
\n
Installation \u2013 Arduino IDE<\/h4>\n\n\n\n
\n
<\/figure><\/div>\n\n\nInstallation \u2013 VS Code<\/h4>\n\n\n\n
<\/figure><\/div>\n\n\nmonitor_speed = 115200\nlib_deps = \n\ttobiasschuerg\/ESP8266 Influxdb@^3.12.0\n\tadafruit\/Adafruit BME280 Library@^2.2.2\n\tadafruit\/Adafruit Unified Sensor@^1.1.5<\/code><\/pre>\n\n\n\nSend Sensor Readings to InfluxDB\u2014Code<\/h3>\n\n\n\n
\/*\r\n Rui Santos\r\n Complete project details at our blog: https:\/\/RandomNerdTutorials.com\/\r\n Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files.\r\n The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.\r\n*\/\r\n\/\/ Based on this library example: https:\/\/github.com\/tobiasschuerg\/InfluxDB-Client-for-Arduino\/blob\/master\/examples\/SecureBatchWrite\/SecureBatchWrite.ino\r\n\r\n#include <Arduino.h>\r\n#include <Wire.h>\r\n#include <Adafruit_Sensor.h>\r\n#include <Adafruit_BME280.h>\r\n\r\n#if defined(ESP32)\r\n #include <WiFiMulti.h>\r\n WiFiMulti wifiMulti;\r\n #define DEVICE "ESP32"\r\n#elif defined(ESP8266)\r\n #include <ESP8266WiFiMulti.h>\r\n ESP8266WiFiMulti wifiMulti;\r\n #define DEVICE "ESP8266"\r\n #define WIFI_AUTH_OPEN ENC_TYPE_NONE\r\n#endif\r\n\r\n#include <InfluxDbClient.h>\r\n#include <InfluxDbCloud.h>\r\n\r\n\/\/ WiFi AP SSID\r\n#define WIFI_SSID "REPLACE_WITH_YOUR_SSID"\r\n\/\/ WiFi password\r\n#define WIFI_PASSWORD "REPLACE_WITH_YOUR_PASSWORD"\r\n\/\/ InfluxDB v2 server url, e.g. https:\/\/eu-central-1-1.aws.cloud2.influxdata.com (Use: InfluxDB UI -> Load Data -> Client Libraries)\r\n#define INFLUXDB_URL "REPLACE_WITH_YOUR_DATABASE_URL"\r\n\/\/ InfluxDB v2 server or cloud API authentication token (Use: InfluxDB UI -> Load Data -> Tokens -> <select token>)\r\n#define INFLUXDB_TOKEN "REPLACE_WITH_YOUR_TOKEN"\r\n\/\/ InfluxDB v2 organization id (Use: InfluxDB UI -> Settings -> Profile -> <name under tile> )\r\n#define INFLUXDB_ORG "REPLACE_WITH_YOUR_ORG"\r\n\/\/ InfluxDB v2 bucket name (Use: InfluxDB UI -> Load Data -> Buckets)\r\n#define INFLUXDB_BUCKET "SENSOR"\r\n\/\/ Set timezone string according to https:\/\/www.gnu.org\/software\/libc\/manual\/html_node\/TZ-Variable.html\r\n\/\/ Examples:\r\n\/\/ Pacific Time: "PST8PDT"\r\n\/\/ Eastern: "EST5EDT"\r\n\/\/ Japanesse: "JST-9"\r\n\/\/ Central Europe: "CET-1CEST,M3.5.0,M10.5.0\/3"\r\n#define TZ_INFO "WET0WEST,M3.5.0\/1,M10.5.0"\r\n\r\n\/\/ InfluxDB client instance with preconfigured InfluxCloud certificate\r\nInfluxDBClient client(INFLUXDB_URL, INFLUXDB_ORG, INFLUXDB_BUCKET, INFLUXDB_TOKEN, InfluxDbCloud2CACert);\r\n\/\/ InfluxDB client instance without preconfigured InfluxCloud certificate for insecure connection \r\n\/\/InfluxDBClient client(INFLUXDB_URL, INFLUXDB_ORG, INFLUXDB_BUCKET, INFLUXDB_TOKEN);\r\n\r\n\/\/ Data point\r\nPoint sensorReadings("measurements");\r\n\r\n\/\/BME280\r\nAdafruit_BME280 bme; \/\/ I2C\r\n\r\nfloat temperature;\r\nfloat humidity;\r\nfloat pressure;\r\n\r\n\/\/ Initialize BME280\r\nvoid initBME(){\r\n if (!bme.begin(0x76)) {\r\n Serial.println("Could not find a valid BME280 sensor, check wiring!");\r\n while (1);\r\n }\r\n}\r\n\r\nvoid setup() {\r\n Serial.begin(115200);\r\n\r\n \/\/ Setup wifi\r\n WiFi.mode(WIFI_STA);\r\n wifiMulti.addAP(WIFI_SSID, WIFI_PASSWORD);\r\n\r\n Serial.print("Connecting to wifi");\r\n while (wifiMulti.run() != WL_CONNECTED) {\r\n Serial.print(".");\r\n delay(500);\r\n }\r\n Serial.println();\r\n \r\n \/\/Init BME280 sensor\r\n initBME();\r\n \r\n \/\/ Add tags\r\n sensorReadings.addTag("device", DEVICE);\r\n sensorReadings.addTag("location", "office");\r\n sensorReadings.addTag("sensor", "bme280");\r\n\r\n \/\/ Accurate time is necessary for certificate validation and writing in batches\r\n \/\/ For the fastest time sync find NTP servers in your area: https:\/\/www.pool.ntp.org\/zone\/\r\n \/\/ Syncing progress and the time will be printed to Serial.\r\n timeSync(TZ_INFO, "pool.ntp.org", "time.nis.gov");\r\n\r\n \/\/ Check server connection\r\n if (client.validateConnection()) {\r\n Serial.print("Connected to InfluxDB: ");\r\n Serial.println(client.getServerUrl());\r\n } else {\r\n Serial.print("InfluxDB connection failed: ");\r\n Serial.println(client.getLastErrorMessage());\r\n }\r\n}\r\n\r\nvoid loop() {\r\n \/\/ Get latest sensor readings\r\n temperature = bme.readTemperature();\r\n humidity = bme.readHumidity();\r\n pressure = bme.readPressure()\/100.0F;\r\n\r\n \/\/ Add readings as fields to point\r\n sensorReadings.addField("temperature", temperature);\r\n sensorReadings.addField("humidity", humidity);\r\n sensorReadings.addField("pressure", pressure);\r\n\r\n \/\/ Print what are we exactly writing\r\n Serial.print("Writing: ");\r\n Serial.println(client.pointToLineProtocol(sensorReadings));\r\n \r\n \/\/ Write point into buffer\r\n client.writePoint(sensorReadings);\r\n\r\n \/\/ Clear fields for next usage. Tags remain the same.\r\n sensorReadings.clearFields();\r\n\r\n \/\/ If no Wifi signal, try to reconnect it\r\n if (wifiMulti.run() != WL_CONNECTED) {\r\n Serial.println("Wifi connection lost");\r\n }\r\n\r\n \/\/ Wait 10s\r\n Serial.println("Wait 10s");\r\n delay(10000);\r\n}\r\n<\/code><\/pre>\n\tHow the Code Works<\/h3>\n\n\n\n
#include <Arduino.h>\n#include <Wire.h>\n#include <Adafruit_Sensor.h>\n#include <Adafruit_BME280.h>\n\n#if defined(ESP32)\n #include <WiFiMulti.h>\n WiFiMulti wifiMulti;\n #define DEVICE \"ESP32\"\n#elif defined(ESP8266)\n #include <ESP8266WiFiMulti.h>\n ESP8266WiFiMulti wifiMulti;\n #define DEVICE \"ESP8266\"\n #define WIFI_AUTH_OPEN ENC_TYPE_NONE\n#endif\n\n#include <InfluxDbClient.h>\n#include <InfluxDbCloud.h><\/code><\/pre>\n\n\n\n\/\/ WiFi AP SSID\n#define WIFI_SSID \"REPLACE_WITH_YOUR_SSID\"\n\/\/ WiFi password\n#define WIFI_PASSWORD \"REPLACE_WITH_YOUR_PASSWORD\"<\/code><\/pre>\n\n\n\n\/\/ InfluxDB v2 server url, e.g. https:\/\/eu-central-1-1.aws.cloud2.influxdata.com (Use: InfluxDB UI -> Load Data -> Client Libraries)\n#define INFLUXDB_URL \"REPLACE_WITH_YOUR_INFLUXDB_URL\"<\/code><\/pre>\n\n\n\n#define INFLUXDB_TOKEN \"REPLACE_WITH_YOUR_INFLUXDB_TOKEN\"<\/code><\/pre>\n\n\n\n#define INFLUXDB_ORG \"REPLACE_WITH_YOUR_INFLUXXDB_ORGANIZATION_ID\"<\/code><\/pre>\n\n\n\n#define INFLUXDB_BUCKET \"REPLACE_WITH_YOUR_BUCKET_NAME\"<\/code><\/pre>\n\n\n\nSetting your Timezone<\/h4>\n\n\n\n
#define TZ_INFO \"WET0WEST,M3.5.0\/1,M10.5.0\"<\/code><\/pre>\n\n\n\nInfluxDB Client<\/h4>\n\n\n\n