new meter

components/evse/include/evse_limits.h

@@ -9,24 +9,47 @@
 extern "C" {
 #endif
 
-/// Estado dos limites
-void     evse_set_limit_reached(uint8_t value);
-bool     evse_is_limit_reached(void);
+// ========================
+// Limit state control
+// ========================
 
-/// Verifica e aplica lógica de limites com base no estado atual do EVSE
-void     evse_limits_check(evse_state_t state);
+/**
+ * @brief Sets the 'limit reached' flag. Used internally when a session exceeds defined thresholds.
+ */
+void evse_set_limit_reached(bool value);
+
+/**
+ * @brief Returns whether any session limit has been reached (energy, time or power).
+ */
+bool evse_get_limit_reached(void);
+
+// ========================
+// Limit checking
+// ========================
+
+/**
+ * @brief Evaluates if the session has exceeded any configured limits.
+ * Should be called periodically while in charging state.
+ */
+void evse_limits_check(void);
+
+// ========================
+// Runtime limit configuration
+// ========================
 
-/// Limites ativos (runtime)
 uint32_t evse_get_consumption_limit(void);
-void     evse_set_consumption_limit(uint32_t value);
+void     evse_set_consumption_limit(uint32_t value); // in Wh
 
 uint32_t evse_get_charging_time_limit(void);
-void     evse_set_charging_time_limit(uint32_t value);
+void     evse_set_charging_time_limit(uint32_t value); // in seconds
 
 uint16_t evse_get_under_power_limit(void);
-void     evse_set_under_power_limit(uint16_t value);
+void     evse_set_under_power_limit(uint16_t value); // in Watts
+
+// ========================
+// Default (persistent) limits
+// ========================
 
-/// Limites padrão (persistentes)
 uint32_t evse_get_default_consumption_limit(void);
 void     evse_set_default_consumption_limit(uint32_t value);