refactor: improve code structure and formatting (#9)

* feat: add example environment configuration header file

* feat: add example environment configuration header

* feat: migrate env.h.example to include directory and remove old files

* refactor: move InfluxDB functionality and logging utilities into separate header files

* refactor: move utility functions into separate module

* refactor: move weather data functions into separate modules

* pre-commit run --all-files

* fix: move InfluxDB function from header to source file

* refactor InfluxDB integration and add docs

* feat: add toggle for Weather Underground data sending

* docs: add docstring for `send_to_wunderground`

* refactor: standardize function naming to snake_case

* docs: unifies naming and improves documentation for sensor data

* docs: clarifies sensor variable naming

* chore: clean up imports

Author: paulinek13

main/env.h.example include/env.h.examplemain/env.h.example renamed to include/env.h.example

@@ -15,9 +15,12 @@
 
 #define INFLUXDB_HOSTNAME "actual_influxdb_hostname"
 #define INFLUXDB_ORG_ID "actual_influxdb_orgid"
+#define INFLUXDB_BUCKET "actual_influxdb_bucket"
 #define INFLUXDB_API_TOKEN "actual_influxdb_api_token"
 
 #define WEATHER_UNDERGROUND_STATION_ID "station_ID"
 #define WEATHER_UNDERGROUND_API_KEY "API_key"
 
+#define SEND_TO_WEATHER_UNDERGROUND 1
+
 #endif

include/influxdb.h

@@ -0,0 +1,7 @@
+#ifndef INFLUXDB_H
+#define INFLUXDB_H
+
+void send_to_influx_db(float temperature, float humidity, float pressure, float dew_point,
+    float illumination, float battery_voltage, float solar_panel_voltage);
+
+#endif // INFLUXDB_H

include/utils.h

@@ -0,0 +1,21 @@
+#ifndef UTILS_H
+#define UTILS_H
+
+#include <Arduino.h>
+
+extern String log_buffer;
+
+void serial_log(String message);
+
+float calculate_dew_point(float temperature, float humidity);
+
+void isolate_all_rtc_gpio();
+
+void connect_to_wifi();
+
+void send_log();
+
+void send_to_database(float temperature, float humidity, float pressure, float dew_point,
+    float illumination, float battery_voltage, float solar_panel_voltage);
+
+#endif // UTILS_H

include/wunderground.h

@@ -0,0 +1,6 @@
+#ifndef WUNDERGROUND_H
+#define WUNDERGROUND_H
+
+void send_to_wunderground(float temperature, int humidity, float baromin, float dew_point);
+
+#endif // WUNDERGROUND_H

src/env.h.example

@@ -0,0 +1,67 @@
+#include "env.h"
+#include "utils.h"
+
+#include <HTTPClient.h>
+#include <WiFi.h>
+
+/**
+ * Sends weather sensor data to InfluxDB using HTTP POST request
+ *
+ * This function constructs an InfluxDB line protocol payload with sensor readings
+ * and transmits it to the configured InfluxDB instance via HTTP API v2.
+ *
+ * Link to InfluxDB API documentation:
+ * https://docs.influxdata.com/influxdb3/cloud-serverless/get-started/write/?t=v2+API#write-line-protocol-to-influxdb
+ *
+ * @param temperature Temperature in Celsius
+ * @param humidity Relative humidity percentage
+ * @param pressure Atmospheric pressure
+ * @param dew_point Dew point in Celsius
+ * @param illumination Light intensity measurement
+ * @param battery_voltage Battery voltage level
+ * @param solar_panel_voltage Solar panel voltage output
+ *
+ * @note Requires active WiFi connection. Function will log error if WiFi disconnected.
+ * @note Uses InfluxDB API v2 with token-based authentication.
+ */
+void send_to_influx_db(float temperature, float humidity, float pressure, float dew_point,
+    float illumination, float battery_voltage, float solar_panel_voltage)
+{
+    if (WiFi.status() == WL_CONNECTED) {
+        HTTPClient http;
+
+        String request_url = String(INFLUXDB_HOSTNAME) + "/api/v2/write?"
+            + "bucket=" + String(INFLUXDB_BUCKET) + "&precision=ns";
+
+        serial_log("Sending data to InfluxDB...");
+
+        http.begin(request_url);
+        http.setTimeout(10000); // 10s
+
+        http.addHeader("Authorization", "Token " + String(INFLUXDB_API_TOKEN));
+        http.addHeader("Content-Type", "text/plain; charset=utf-8");
+        http.addHeader("Accept", "application/json");
+
+        // Format: "weather temperature=XX.XX,humidity=XX.X,pressure=XX.XX,..."
+        String payload = String("weather ") + "temperature=" + String(temperature, 2) + ","
+            + "humidity=" + String(humidity, 1) + "," + "pressure=" + String(pressure, 2) + ","
+            + "illumination=" + String(illumination, 1) + "," + "dew_point=" + String(dew_point, 1)
+            + "," + "battery_voltage=" + String(battery_voltage, 2) + ","
+            + "solar_panel_voltage=" + String(solar_panel_voltage, 2);
+
+        int response_code = http.POST(payload);
+        serial_log(payload);
+
+        if (response_code > 0) {
+            serial_log("HTTP Response Code: ");
+            serial_log(String(response_code));
+        } else {
+            serial_log("Error in HTTP request: ");
+            serial_log(String(response_code));
+        }
+
+        http.end();
+    } else {
+        serial_log("WiFi not connected");
+    }
+}