new buzzer component

components/evse/include/evse_api.h

@@ -3,8 +3,10 @@
 
 #include <stdint.h>
 #include <stdbool.h>
-#include "evse_state.h"  // Tipos e estados
+#include "evse_state.h"
 #include "freertos/FreeRTOS.h"
+#include "evse_session.h"
+
 
 #ifdef __cplusplus
 extern "C" {
@@ -24,10 +26,17 @@ evse_state_t evse_get_state(void);
  */
 void evse_set_state(evse_state_t state);
 
+// ===============================
+// Charging Session Info
+// ===============================
+
 /**
- * @brief Get timestamp when the current session started (for timing limits).
+ * @brief Retrieve statistics of either the current ongoing session (if any)
+ *        or the last completed session.
+ * @param out pointer to evse_session_t to be filled
+ * @return true if there is a current or last session available
  */
-TickType_t evse_get_session_start(void);
+bool evse_get_session(evse_session_t *out);
 
 // ===============================
 // Charging Session Info

components/evse/include/evse_config.h

@@ -55,10 +55,6 @@ esp_err_t evse_set_rcm(bool rcm);
 uint8_t  evse_get_temp_threshold(void);
 esp_err_t evse_set_temp_threshold(uint8_t threshold);
 
-// Autenticação
-bool     evse_is_require_auth(void);
-void     evse_set_require_auth(bool require);
-
 // Disponibilidade
 bool     evse_config_is_available(void);
 void     evse_config_set_available(bool available);

components/evse/include/evse_meter.h

@@ -13,13 +13,13 @@ extern "C" {
 void evse_meter_init(void);
 
 /// Retorna a potência instantânea (soma das 3 fases, em watts)
-uint32_t evse_meter_get_instant_power(void);
+int evse_meter_get_instant_power(void);
 
 /// Retorna a energia total acumulada (em Wh)
-uint32_t evse_meter_get_total_energy(void);
+int evse_meter_get_total_energy(void);
 
 /// Retorna as potências instantâneas nas fases L1, L2 e L3 (em watts)
-void evse_meter_get_power(uint32_t power[EVSE_METER_PHASE_COUNT]);
+void evse_meter_get_power(int power[EVSE_METER_PHASE_COUNT]);
 
 /// Retorna as tensões medidas nas fases L1, L2 e L3 (em volts)
 void evse_meter_get_voltage(float voltage[EVSE_METER_PHASE_COUNT]);

components/evse/include/evse_session.h

@@ -0,0 +1,53 @@
+/*
+ * evse_session.h
+ * Module to track and retrieve charging session data (current or last completed),
+ * accumulating energy via periodic tick of instantaneous power.
+ */
+
+#ifndef EVSE_SESSION_H
+#define EVSE_SESSION_H
+
+#include <stdint.h>
+#include <stdbool.h>
+#include "freertos/FreeRTOS.h"
+
+/**
+ * @brief Charging session statistics
+ */
+typedef struct {
+    TickType_t start_tick;   ///< tick when session began
+    uint32_t    duration_s;  ///< total duration in seconds
+    uint32_t    energy_wh;   ///< total energy consumed in Wh
+    uint32_t    avg_power_w; ///< average power in W
+    bool        is_current;  ///< true if session still in progress
+} evse_session_t;
+
+/**
+ * @brief Initialize the session module
+ */
+void evse_session_init(void);
+
+/**
+ * @brief Mark the beginning of a charging session
+ */
+void evse_session_start(void);
+
+/**
+ * @brief Mark the end of the charging session and store it as "last session"
+ */
+void evse_session_end(void);
+
+/**
+ * @brief Periodic tick: must be called (e.g., each 1s) to accumulate energy from instant power
+ */
+void evse_session_tick(void);
+
+/**
+ * @brief Retrieve statistics of either the current ongoing session (if any) or
+ *        the last completed session.
+ * @param out pointer to evse_session_t to be filled
+ * @return true if there is a current or last session available, false otherwise
+ */
+bool evse_session_get(evse_session_t *out);
+
+#endif // EVSE_SESSION_H

components/evse/include/evse_state.h

@@ -53,11 +53,6 @@ evse_state_t evse_get_state(void);
  */
 void evse_set_state(evse_state_t state);
 
-/**
- * @brief Returns the tick count when the current charging session began.
- */
-TickType_t evse_get_session_start(void);
-
 /**
  * @brief Converts the state enum into a human-readable string.
  */