fix ade7758

components/evse/include/evse_limits.h

@@ -9,47 +9,58 @@
 extern "C" {
 #endif
 
-// ========================
-// Limit state control
-// ========================
+// ============================
+// Limit Status & Evaluation
+// ============================
 
 /**
- * @brief Sets the 'limit reached' flag. Used internally when a session exceeds defined thresholds.
+ * @brief Sets the internal 'limit reached' flag.
+ * Called internally when a limit condition is triggered.
  */
 void evse_set_limit_reached(bool value);
 
 /**
- * @brief Returns whether any session limit has been reached (energy, time or power).
+ * @brief Returns true if any runtime charging limit has been reached.
  */
 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.
+ * @brief Checks if any session limit has been exceeded (energy, time or power).
+ * Should be called periodically during charging.
  */
 void evse_limits_check(void);
 
-// ========================
-// Runtime limit configuration
-// ========================
+// ============================
+// Runtime Limit Configuration
+// ============================
 
+/**
+ * @brief Get/set energy consumption limit (in Wh).
+ */
 uint32_t evse_get_consumption_limit(void);
-void     evse_set_consumption_limit(uint32_t value); // in Wh
+void     evse_set_consumption_limit(uint32_t value);
 
+/**
+ * @brief Get/set maximum charging time (in seconds).
+ */
 uint32_t evse_get_charging_time_limit(void);
-void     evse_set_charging_time_limit(uint32_t value); // in seconds
+void     evse_set_charging_time_limit(uint32_t value);
 
+/**
+ * @brief Get/set minimum acceptable power level (in Watts).
+ * If the power remains below this for a long time, the session may be interrupted.
+ */
 uint16_t evse_get_under_power_limit(void);
-void     evse_set_under_power_limit(uint16_t value); // in Watts
+void     evse_set_under_power_limit(uint16_t value);
 
-// ========================
-// Default (persistent) limits
-// ========================
+// ============================
+// Default (Persistent) Limits
+// ============================
 
+/**
+ * @brief Default values used after system boot or reset.
+ * These can be restored from NVS or fallback values.
+ */
 uint32_t evse_get_default_consumption_limit(void);
 void     evse_set_default_consumption_limit(uint32_t value);