104 lines
2.4 KiB
C
Executable File
104 lines
2.4 KiB
C
Executable File
#ifndef EVSE_STATE_H
|
|
#define EVSE_STATE_H
|
|
|
|
#include <stdbool.h>
|
|
#include "freertos/FreeRTOS.h"
|
|
#include "evse_events.h"
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
// ============================
|
|
// EVSE Pilot Signal States
|
|
// ============================
|
|
|
|
typedef enum {
|
|
EVSE_STATE_A, // EV Not Connected (12V)
|
|
EVSE_STATE_B1, // EV Connected (9V, Not Authorized)
|
|
EVSE_STATE_B2, // EV Connected (9V, Authorized and Ready)
|
|
EVSE_STATE_C1, // Charging Requested (6V, Relay Off)
|
|
EVSE_STATE_C2, // Charging Active (6V, Relay On)
|
|
EVSE_STATE_D1, // Ventilation Required (3V, Relay Off)
|
|
EVSE_STATE_D2, // Ventilation Active (3V, Relay On)
|
|
EVSE_STATE_E, // Error: Pilot Short to Ground (0V)
|
|
EVSE_STATE_F // Fault: No Pilot or EVSE Unavailable
|
|
} evse_state_t;
|
|
|
|
// ============================
|
|
// Initialization
|
|
// ============================
|
|
|
|
/**
|
|
* @brief Initializes the EVSE state machine and default state.
|
|
*/
|
|
void evse_state_init(void);
|
|
|
|
/**
|
|
* @brief Periodic tick for state handling (optional hook).
|
|
*/
|
|
void evse_state_tick(void);
|
|
|
|
// ============================
|
|
// State Access & Control
|
|
// ============================
|
|
|
|
/**
|
|
* @brief Returns the current EVSE state.
|
|
*/
|
|
evse_state_t evse_get_state(void);
|
|
|
|
/**
|
|
* @brief Sets the current EVSE state and emits a change event if needed.
|
|
*/
|
|
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.
|
|
*/
|
|
const char* evse_state_to_str(evse_state_t state);
|
|
|
|
// ============================
|
|
// State Evaluation Helpers
|
|
// ============================
|
|
|
|
/**
|
|
* @brief True if EV is in an active session (B2, C1, C2).
|
|
*/
|
|
bool evse_state_is_session(evse_state_t state);
|
|
|
|
/**
|
|
* @brief True if EV is actively charging (C1, C2).
|
|
*/
|
|
bool evse_state_is_charging(evse_state_t state);
|
|
|
|
/**
|
|
* @brief True if EV is physically plugged in (B1 and beyond).
|
|
*/
|
|
bool evse_state_is_plugged(evse_state_t state);
|
|
|
|
// ============================
|
|
// Authorization Control
|
|
// ============================
|
|
|
|
/**
|
|
* @brief Sets whether the EV is authorized to charge.
|
|
*/
|
|
void evse_state_set_authorized(bool authorized);
|
|
|
|
/**
|
|
* @brief Gets whether the EV is currently authorized.
|
|
*/
|
|
bool evse_state_get_authorized(void);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif // EVSE_STATE_H
|