← Modes du routeur | Sommaire | Suivant : Application principale →

5. APIs des modules et structures de données

5.1 API RouterController

Fichiers :
- components/acrouter_hal/include/RouterController.h
- components/acrouter_hal/src/RouterController.cpp

Patron de conception : Singleton

Obtenir l'instance

cpp

RouterController& router = RouterController::getInstance();

Initialisation

begin()

cpp

bool begin(DimmerHAL* dimmer, DimmerChannel channel = DimmerChannel::CHANNEL_1);

Description : Initialiser le contrôleur avec liaison au variateur.

Parameters:
- dimmer - pointer to initialized DimmerHAL
- channel - dimmer channel (CHANNEL_1 or CHANNEL_2)

Retourne : true en cas de succès, false en cas d'erreur

Exemple :

cpp

DimmerHAL& dimmer = DimmerHAL::getInstance();
RouterController& router = RouterController::getInstance();

dimmer.begin();
if (router.begin(&dimmer, DimmerChannel::CHANNEL_1)) {
    Serial.println("RouterController initialized");
} else {
    Serial.println("RouterController init failed");
}

Gestion des modes

setMode()

cpp

void setMode(RouterMode mode);

Description : Définir le mode de fonctionnement du contrôleur.

Parameters:
- mode - one of 6 modes (OFF=0, AUTO=1, ECO=2, OFFGRID=3, MANUAL=4, BOOST=5)

Exemple :

cpp

router.setMode(RouterMode::AUTO);    // Automatic mode
router.setMode(RouterMode::MANUAL);  // Manual mode

getMode()

cpp

RouterMode getMode() const;

Description : Obtenir le mode de fonctionnement actuel.

Retourne : RouterMode actuel

Exemple :

cpp

RouterMode current = router.getMode();
if (current == RouterMode::AUTO) {
    Serial.println("Running in AUTO mode");
}

Paramètres de régulation

setControlGain()

cpp

void setControlGain(float gain);

Description : Définir le coefficient proportionnel du régulateur (Kp).

Parameters:
- gain - gain coefficient (10.0 - 1000.0)

Effect:
- Lower Kp � faster response, possible oscillations
- Higher Kp � slower response, more stable

Exemple :

cpp

router.setControlGain(200.0f);  // Standard value
router.setControlGain(100.0f);  // Faster response
router.setControlGain(400.0f);  // Slower, more stable

getControlGain()

cpp

float getControlGain() const;

Retourne : Valeur Kp actuelle

setBalanceThreshold()

cpp

void setBalanceThreshold(float threshold);

Description : Définir le seuil d'équilibre en Watts.

Parameters:
- threshold - threshold in W (typically 5.0 - 50.0)

Effect:
- If |P_grid| < threshold, system is considered balanced
- Lower threshold � more accurate balance, more switching
- Higher threshold � less switching, less accurate balance

Exemple :

cpp

router.setBalanceThreshold(10.0f);  // �10 W considered balanced
router.setBalanceThreshold(20.0f);  // �20 W for larger loads

getBalanceThreshold()

cpp

float getBalanceThreshold() const;

Retourne : Seuil d'équilibre actuel (W)

Commande manuelle (mode MANUAL)

setManualLevel()

cpp

void setManualLevel(uint8_t percent);

Description : Définir un niveau fixe du variateur pour le mode MANUAL.

Parameters:
- percent - dimmer level 0-100%

Exemple :

cpp

router.setMode(RouterMode::MANUAL);
router.setManualLevel(75);  // Set to 75%

getManualLevel()

cpp

uint8_t getManualLevel() const;

Retourne : Niveau défini pour le mode MANUAL

Boucle de mise à jour principale

update()

cpp

void update(const PowerMeterADC::Measurements& measurements);

Description : Fonction de régulation principale. Appelée automatiquement depuis le callback PowerMeterADC toutes les 200 ms.

Parameters:
- measurements - structure with power measurements

Remarque : Généralement appelée automatiquement, l'appel manuel n'est pas nécessaire.

Logique interne :

cpp

void update(const Measurements& meas) {
    switch (mode) {
        case OFF:     processOffMode();           break;
        case AUTO:    processAutoMode(P_grid);    break;
        case ECO:     processEcoMode(P_grid);     break;
        case OFFGRID: processOffgridMode(meas);   break;
        case MANUAL:  processManualMode();        break;
        case BOOST:   processBoostMode();         break;
    }
}

Arrêt d'urgence

emergencyStop()

cpp

void emergencyStop();

Description : Arrêt immédiat du variateur (0%) et passage en mode OFF.

When to use:
- System overheating
- Sensor error
- Critical situation

Exemple :

cpp

if (temperature > 80.0f) {
    router.emergencyStop();
    Serial.println("EMERGENCY STOP: Overheating!");
}

Obtenir le statut

getStatus()

cpp

RouterStatus getStatus() const;

Description : Obtenir les informations complètes sur l'état du contrôleur.

Retourne : Structure RouterStatus

Exemple :

cpp

RouterStatus status = router.getStatus();

Serial.printf("Mode: %d\n", static_cast(status.mode));
Serial.printf("State: %d\n", static_cast(status.state));
Serial.printf("Dimmer: %d%%\n", status.dimmer_percent);
Serial.printf("P_grid: %.1f W\n", status.power_grid);
Serial.printf("Kp: %.1f\n", status.control_gain);

Structures de données

RouterStatus

cpp

struct RouterStatus {
    RouterMode mode;                    // Current mode
    RouterState state;                  // State (IDLE, INCREASING, etc.)
    uint8_t dimmer_percent;             // Dimmer level (0-100%)
    float target_level;                 // Target level (float for smoothness)
    float power_grid;                   // Current grid power (W)
    float control_gain;                 // Kp coefficient
    float balance_threshold;            // Balance threshold (W)
    uint32_t last_update_ms;            // Last update timestamp
    bool valid;                         // Status is valid
};

RouterMode

cpp

enum class RouterMode : uint8_t {
    OFF = 0,        // Disabled
    AUTO,           // Automatic Solar Router
    ECO,            // Economic (anti-export)
    OFFGRID,        // Autonomous
    MANUAL,         // Manual
    BOOST           // Forced 100%
};

RouterState

cpp

enum class RouterState : uint8_t {
    IDLE,           // No action
    INCREASING,     // Increasing dimmer (exporting)
    DECREASING,     // Decreasing dimmer (importing)
    AT_MAXIMUM,     // At maximum (100%)
    AT_MINIMUM,     // At minimum (0%)
    ERROR           // Error state
};

5.2 API PowerMeterADC

Fichiers :
- components/acrouter_hal/include/PowerMeterADC.h
- components/acrouter_hal/src/PowerMeterADC.cpp

Patron de conception : Singleton

Obtenir l'instance

cpp

PowerMeterADC& powerMeter = PowerMeterADC::getInstance();

Initialisation

begin()

cpp

bool begin();

Description : Initialiser le DMA ADC et créer la tâche de traitement FreeRTOS.

Retourne : true en cas de succès

Exemple :

cpp

PowerMeterADC& powerMeter = PowerMeterADC::getInstance();

if (powerMeter.begin()) {
    Serial.println("PowerMeterADC initialized");
} else {
    Serial.println("PowerMeterADC init failed");
}

Contrôle des mesures

start()

cpp

bool start();

Description : Démarrer les mesures DMA ADC en continu.

Retourne : true si démarré avec succès

Exemple :

cpp

if (powerMeter.start()) {
    Serial.println("Measurements started");
}

stop()

cpp

void stop();

Description : Arrêter les mesures.

Exemple :

cpp

powerMeter.stop();
Serial.println("Measurements stopped");

isRunning()

cpp

bool isRunning() const;

Description : Vérifier si les mesures sont en cours.

Retourne : true si les mesures sont actives

Callback de résultats

setCallback()

cpp

void setCallback(std::function callback);

Description : Définir la fonction callback appelée toutes les 200 ms avec les résultats RMS.

Parameters:
- callback - function of type void callback(const Measurements& meas)

Exemple :

cpp

// Option 1: Lambda
powerMeter.setCallback([](const PowerMeterADC::Measurements& meas) {
    Serial.printf("V: %.1f V, I_grid: %.2f A, P_grid: %.1f W\n",
                  meas.voltage_rms,
                  meas.current_rms[PowerMeterADC::CURRENT_GRID],
                  meas.power_active[PowerMeterADC::CURRENT_GRID]);
});

// Option 2: Global function
void onMeasurements(const PowerMeterADC::Measurements& meas) {
    // Process measurements
}
powerMeter.setCallback(onMeasurements);

// Option 3: Class method
powerMeter.setCallback([this](const auto& meas) {
    this->handleMeasurements(meas);
});

Calibrage des capteurs

setVoltageCalibration()

cpp

void setVoltageCalibration(float multiplier, float offset = 0.0f);

Description : Définir les coefficients de calibrage pour le capteur de tension.

Parameters:
- multiplier - multiplier (V/V_adc)
- offset - offset (V)

Formule : V_real = V_adc * multiplier + offset

Exemple :

cpp

// ZMPT107: 230V � 1V (scale 1:230)
powerMeter.setVoltageCalibration(230.0f, 0.0f);

// With offset correction
powerMeter.setVoltageCalibration(235.0f, -2.5f);

setCurrentCalibration()

cpp

void setCurrentCalibration(CurrentChannel channel, float multiplier, float offset = 0.0f);

Description : Définir les coefficients de calibrage pour le capteur de courant.

Parameters:
- channel - channel (CURRENT_LOAD, CURRENT_GRID, CURRENT_SOLAR)
- multiplier - multiplier (A/V_adc)
- offset - offset (A)

Formule : I_real = I_adc * multiplier + offset

Exemple :

cpp

// SCT-013-030: 30A � 1V
powerMeter.setCurrentCalibration(PowerMeterADC::CURRENT_GRID, 30.0f, 0.0f);

// ACS-712-20A: 0A=2.5V, sensitivity 100mV/A
powerMeter.setCurrentCalibration(PowerMeterADC::CURRENT_LOAD, 10.0f, -25.0f);

Récupération des données

getPowerData()

cpp

Measurements getPowerData() const;

Description : Obtenir les dernières mesures (thread-safe).

Retourne : Structure Measurements

Exemple :

cpp

PowerMeterADC::Measurements data = powerMeter.getPowerData();

if (data.valid) {
    Serial.printf("Voltage: %.1f V\n", data.voltage_rms);
    Serial.printf("Current Grid: %.2f A\n", data.current_rms[PowerMeterADC::CURRENT_GRID]);
    Serial.printf("Power Grid: %.1f W\n", data.power_active[PowerMeterADC::CURRENT_GRID]);
}

getVoltageRMS()

cpp

float getVoltageRMS() const;

Description : Obtenir uniquement la tension RMS.

Retourne : Tension en Volts

getCurrentRMS()

cpp

float getCurrentRMS(CurrentChannel channel) const;

Description : Obtenir le courant RMS pour le canal spécifié.

Parameters:
- channel - CURRENT_LOAD, CURRENT_GRID or CURRENT_SOLAR

Retourne : Courant en Ampères

Exemple :

cpp

float i_grid = powerMeter.getCurrentRMS(PowerMeterADC::CURRENT_GRID);
float i_solar = powerMeter.getCurrentRMS(PowerMeterADC::CURRENT_SOLAR);

Serial.printf("Grid: %.2f A, Solar: %.2f A\n", i_grid, i_solar);

getPower()

cpp

float getPower(CurrentChannel channel) const;

Description : Obtenir la puissance active pour le canal spécifié.

Parameters:
- channel - CURRENT_LOAD, CURRENT_GRID or CURRENT_SOLAR

Retourne : Puissance en Watts

Exemple :

cpp

float p_grid = powerMeter.getPower(PowerMeterADC::CURRENT_GRID);

if (p_grid < 0) {
    Serial.println("Exporting to grid");
} else {
    Serial.println("Importing from grid");
}

Structures de données

Measurements

cpp

struct Measurements {
    float voltage_rms;                  // RMS voltage (V)
    float current_rms[3];               // RMS currents [LOAD, GRID, SOLAR] (A)
    float power_active[3];              // Active power [LOAD, GRID, SOLAR] (W)
    float power_reactive[3];            // Reactive power (VAR) - Phase 2
    float power_apparent[3];            // Apparent power (VA) - Phase 2
    float power_factor[3];              // Power factor - Phase 2
    uint32_t timestamp_ms;              // Timestamp
    bool valid;                         // Data is valid
};

CurrentChannel

cpp

enum CurrentChannel : uint8_t {
    CURRENT_LOAD = 0,    // Load current (dimmer)
    CURRENT_GRID = 1,    // Grid current (import/export)
    CURRENT_SOLAR = 2,   // Solar panel current
    CURRENT_COUNT = 3
};

5.3 API DimmerHAL

Fichiers :
- components/acrouter_hal/include/DimmerHAL.h
- components/acrouter_hal/src/DimmerHAL.cpp

Patron de conception : Singleton

Obtenir l'instance

cpp

DimmerHAL& dimmer = DimmerHAL::getInstance();

Initialisation

begin()

cpp

bool begin();

Description : Initialiser le variateur avec détecteur de passage par zéro.

Retourne : true en cas de succès

Exemple :

cpp

DimmerHAL& dimmer = DimmerHAL::getInstance();

if (dimmer.begin()) {
    Serial.println("DimmerHAL initialized");
} else {
    Serial.println("DimmerHAL init failed");
}

Contrôle de puissance

setPower()

cpp

void setPower(DimmerChannel channel, uint8_t percent);

Description : Définir la puissance du variateur instantanément.

Parameters:
- channel - CHANNEL_1 or CHANNEL_2
- percent - power 0-100%

Exemple :

cpp

dimmer.setPower(DimmerChannel::CHANNEL_1, 75);  // 75%
dimmer.setPower(DimmerChannel::CHANNEL_2, 50);  // 50% on second channel

setPowerSmooth()

cpp

void setPowerSmooth(DimmerChannel channel, uint8_t percent, uint32_t transition_ms);

Description : Définir la puissance avec transition progressive.

Parameters:
- channel - CHANNEL_1 or CHANNEL_2
- percent - target power 0-100%
- transition_ms - transition time in milliseconds

Exemple :

cpp

// Smoothly transition to 80% over 2 seconds
dimmer.setPowerSmooth(DimmerChannel::CHANNEL_1, 80, 2000);

// Smooth shutdown over 1 second
dimmer.setPowerSmooth(DimmerChannel::CHANNEL_1, 0, 1000);

getPower()

cpp

uint8_t getPower(DimmerChannel channel) const;

Description : Obtenir la puissance actuelle du canal.

Retourne : Puissance 0-100%

Exemple :

cpp

uint8_t current_power = dimmer.getPower(DimmerChannel::CHANNEL_1);
Serial.printf("Dimmer 1: %d%%\n", current_power);

Commande rapide

turnOff()

cpp

void turnOff(DimmerChannel channel);

Description : Éteindre rapidement un canal (0%).

Exemple :

cpp

dimmer.turnOff(DimmerChannel::CHANNEL_1);

turnOffAll()

cpp

void turnOffAll();

Description : Éteindre tous les canaux.

Exemple :

cpp

dimmer.turnOffAll();  // Emergency shutdown

Courbe de puissance

setCurve()

cpp

void setCurve(DimmerChannel channel, DimmerCurve curve);

Description : Définir le type de courbe de puissance.

Parameters:
- channel - CHANNEL_1 or CHANNEL_2
- curve - LINEAR, RMS or LOGARITHMIC

Recommendations:
- RMS - for resistive loads (heaters, water heaters) - recommended
- LINEAR - linear dependency
- LOGARITHMIC - for LED lamps

Exemple :

cpp

// RMS curve for heater (recommended)
dimmer.setCurve(DimmerChannel::CHANNEL_1, DimmerCurve::RMS);

// Linear curve
dimmer.setCurve(DimmerChannel::CHANNEL_1, DimmerCurve::LINEAR);

Statut et informations

getStatus()

cpp

DimmerStatus getStatus(DimmerChannel channel) const;

Description : Obtenir le statut détaillé du canal.

Retourne : Structure DimmerStatus

Exemple :

cpp

DimmerStatus status = dimmer.getStatus(DimmerChannel::CHANNEL_1);

Serial.printf("Initialized: %s\n", status.initialized ? "Yes" : "No");
Serial.printf("Active: %s\n", status.active ? "Yes" : "No");
Serial.printf("Power: %d%%\n", status.power_percent);
Serial.printf("Target: %d%%\n", status.target_percent);

isInitialized()

cpp

bool isInitialized() const;

Description : Vérifier si le variateur est initialisé.

Retourne : true si initialisé

Structures de données

DimmerChannel

cpp

enum class DimmerChannel : uint8_t {
    CHANNEL_1 = 0,      // First channel (GPIO 19)
    CHANNEL_2 = 1       // Second channel (GPIO 23)
};

DimmerCurve

cpp

enum class DimmerCurve : uint8_t {
    LINEAR,         // Linear
    RMS,            // RMS-compensated (recommended)
    LOGARITHMIC     // Logarithmic
};

DimmerStatus

cpp

struct DimmerStatus {
    bool initialized;           // Initialized
    bool active;                // Active
    uint8_t power_percent;      // Current power (0-100%)
    uint8_t target_percent;     // Target power (during transition)
    DimmerCurve curve;          // Curve type
    uint32_t last_update_ms;    // Last update time
};

5.4 API ConfigManager

Fichiers :
- components/utils/include/ConfigManager.h
- components/utils/src/ConfigManager.cpp

Patron de conception : Singleton

Espace de noms NVS : "acrouter"

Obtenir l'instance

cpp

ConfigManager& config = ConfigManager::getInstance();

Initialisation

begin()

cpp

bool begin();

Description : Initialiser NVS et charger la configuration.

Retourne : true en cas de succès

Exemple :

cpp

ConfigManager& config = ConfigManager::getInstance();

if (config.begin()) {
    Serial.println("ConfigManager initialized");
    Serial.printf("Router mode: %d\n", config.getConfig().router_mode);
}

Obtenir la configuration

getConfig()

cpp

const SystemConfig& getConfig() const;

Description : Obtenir la référence vers la configuration actuelle.

Retourne : Référence const vers SystemConfig

Exemple :

cpp

const SystemConfig& cfg = config.getConfig();

Serial.printf("Mode: %d\n", cfg.router_mode);
Serial.printf("Kp: %.1f\n", cfg.control_gain);
Serial.printf("Threshold: %.1f W\n", cfg.balance_threshold);

Définir les paramètres

setRouterMode()

cpp

bool setRouterMode(uint8_t mode);

Description : Définir le mode du routeur (sauvegardé automatiquement dans NVS).

Parameters:
- mode - mode 0-5

Retourne : true si sauvegardé avec succès

Exemple :

cpp

config.setRouterMode(1);  // AUTO mode

setControlGain()

cpp

bool setControlGain(float gain);

Description : Définir le coefficient Kp.

Parameters:
- gain - coefficient (10.0 - 1000.0)

Exemple :

cpp

config.setControlGain(200.0f);

setBalanceThreshold()

cpp

bool setBalanceThreshold(float threshold);

Description : Définir le seuil d'équilibre.

Parameters:
- threshold - threshold in Watts (0.0 - 100.0)

Exemple :

cpp

config.setBalanceThreshold(10.0f);

setManualLevel()

cpp

bool setManualLevel(uint8_t level);

Description : Définir le niveau pour le mode MANUAL.

Parameters:
- level - level 0-100%

Exemple :

cpp

config.setManualLevel(75);

setVoltageCoefficient()

cpp

bool setVoltageCoefficient(float coef);

Description : Définir le coefficient de calibrage de tension.

Exemple :

cpp

config.setVoltageCoefficient(230.0f);

setCurrentCoefficient()

cpp

bool setCurrentCoefficient(float coef);

Description : Définir le coefficient de calibrage de courant.

Exemple :

cpp

config.setCurrentCoefficient(30.0f);  // SCT-013-030

Opérations par lot

saveAll()

cpp

bool saveAll();

Description : Sauvegarder tous les paramètres dans NVS.

Remarque : Généralement non nécessaire car chaque méthode set*() sauvegarde automatiquement.

loadAll()

cpp

bool loadAll();

Description : Recharger la configuration depuis NVS.

resetToDefaults()

cpp

bool resetToDefaults();

Description : Réinitialiser tous les paramètres aux valeurs d'usine et sauvegarder dans NVS.

Exemple :

cpp

if (config.resetToDefaults()) {
    Serial.println("Config reset to defaults");
}

Structures de données

SystemConfig

cpp

struct SystemConfig {
    // Router parameters
    uint8_t router_mode;        // RouterMode (0-5)
    float control_gain;         // Kp (10.0 - 1000.0)
    float balance_threshold;    // Balance threshold (W)
    uint8_t manual_level;       // MANUAL level (0-100%)

    // Sensor calibration
    float voltage_coef;         // Voltage coefficient
    float current_coef;         // Current coefficient (A/V)
    float current_threshold;    // Minimum current (A)
    float power_threshold;      // Minimum power (W)
};

5.5 API HardwareConfigManager

Fichiers :
- components/utils/include/HardwareConfigManager.h
- components/utils/src/HardwareConfigManager.cpp

Patron de conception : Singleton

Espace de noms NVS : "hw_config"

Obtenir l'instance

cpp

HardwareConfigManager& hwConfig = HardwareConfigManager::getInstance();

Initialisation

begin()

cpp

bool begin();

Description : Initialiser et charger la configuration matérielle depuis NVS.

Exemple :

cpp

HardwareConfigManager& hwConfig = HardwareConfigManager::getInstance();

if (hwConfig.begin()) {
    Serial.println("HardwareConfigManager initialized");
}

Configuration des canaux ADC

setADCChannel()

cpp

bool setADCChannel(uint8_t channel, const ADCChannelConfig& config);

Description : Configurer un canal ADC.

Parameters:
- channel - channel number (0-3)
- config - channel configuration

Retourne : true en cas de succès

Exemple :

cpp

ADCChannelConfig voltage_cfg;
voltage_cfg.gpio = 35;
voltage_cfg.type = SensorType::VOLTAGE_AC;
voltage_cfg.multiplier = 230.0f;
voltage_cfg.offset = 0.0f;
voltage_cfg.enabled = true;

hwConfig.setADCChannel(0, voltage_cfg);

getADCChannel()

cpp

ADCChannelConfig getADCChannel(uint8_t channel) const;

Description : Obtenir la configuration d'un canal ADC.

Exemple :

cpp

ADCChannelConfig cfg = hwConfig.getADCChannel(0);
Serial.printf("ADC0: GPIO%d, Type=%d, Mult=%.1f\n",
              cfg.gpio, static_cast(cfg.type), cfg.multiplier);

Configuration du variateur

setDimmerChannel()

cpp

bool setDimmerChannel(uint8_t channel, const DimmerChannelConfig& config);

Description : Configurer un canal du variateur.

Parameters:
- channel - 0 (Channel 1) or 1 (Channel 2)
- config - configuration

Exemple :

cpp

DimmerChannelConfig dim_cfg;
dim_cfg.gpio = 19;
dim_cfg.enabled = true;

hwConfig.setDimmerChannel(0, dim_cfg);

Configuration du passage par zéro

setZeroCross()

cpp

bool setZeroCross(uint8_t gpio, bool enabled = true);

Description : Configurer la broche du détecteur de passage par zéro.

Exemple :

cpp

hwConfig.setZeroCross(18, true);  // GPIO18, enabled

Configuration des relais

setRelayChannel()

cpp

bool setRelayChannel(uint8_t channel, const RelayChannelConfig& config);

Description : Configurer un canal relais.

Parameters:
- channel - 0 or 1
- config - relay configuration

Exemple :

cpp

RelayChannelConfig relay_cfg;
relay_cfg.gpio = 15;
relay_cfg.active_high = true;  // Active HIGH
relay_cfg.enabled = true;

hwConfig.setRelayChannel(0, relay_cfg);

Configuration des LED

setStatusLED()

cpp

bool setStatusLED(uint8_t gpio);

Description : Configurer le GPIO pour la LED de statut.

Exemple :

cpp

hwConfig.setStatusLED(17);

setLoadLED()

cpp

bool setLoadLED(uint8_t gpio);

Description : Configurer le GPIO pour la LED indicatrice de charge.

Validation

validate()

cpp

bool validate(String* error_msg = nullptr) const;

Description : Vérifier la configuration pour détecter les erreurs.

Parameters:
- error_msg - pointer to String for error message (optional)

Retourne : true si la configuration est valide

Checks:
- GPIO conflicts (one pin = one function)
- Pin validity for ADC (ADC1 only: 32-39)
- Input-only pins (34,35,36,39 cannot be outputs)

Exemple :

cpp

String error;
if (!hwConfig.validate(&error)) {
    Serial.printf("Validation failed: %s\n", error.c_str());
} else {
    Serial.println("Configuration is valid");
}

Opérations par lot

saveAll()

cpp

bool saveAll();

Description : Sauvegarder la configuration complète dans NVS.

loadAll()

cpp

bool loadAll();

Description : Charger la configuration depuis NVS.

resetToDefaults()

cpp

bool resetToDefaults();

Description : Réinitialiser aux valeurs d'usine.

printConfig()

cpp

void printConfig() const;

Description : Afficher la configuration sur Serial.

Exemple :

cpp

hwConfig.printConfig();
// Output:
// === Hardware Configuration ===
// ADC0: GPIO35, VOLTAGE_AC, mult=230.0, enabled
// ADC1: GPIO39, CURRENT_LOAD, mult=30.0, enabled
// ...

Structures de données

ADCChannelConfig

cpp

struct ADCChannelConfig {
    uint8_t gpio;               // GPIO pin (32-39 for ADC1)
    SensorType type;            // Sensor type
    float multiplier;           // Calibration multiplier
    float offset;               // Offset
    bool enabled;               // Channel enabled
};

DimmerChannelConfig

cpp

struct DimmerChannelConfig {
    uint8_t gpio;               // GPIO pin
    bool enabled;               // Channel enabled
};

RelayChannelConfig

cpp

struct RelayChannelConfig {
    uint8_t gpio;               // GPIO pin
    bool active_high;           // true=Active HIGH, false=Active LOW
    bool enabled;               // Channel enabled
};

SensorType

cpp

enum class SensorType : uint8_t {
    NONE = 0,           // Not used
    VOLTAGE_AC,         // ZMPT107 (AC voltage)
    CURRENT_LOAD,       // ACS-712 (dimmer load current)
    CURRENT_GRID,       // SCT-013 (grid current)
    CURRENT_SOLAR,      // SCT-013 (solar current)
    CURRENT_AUX1,       // Auxiliary channel 1
    CURRENT_AUX2        // Auxiliary channel 2
};

5.6 API WiFiManager

Fichiers :
- components/comm/include/WiFiManager.h
- components/comm/src/WiFiManager.cpp

Patron de conception : Singleton

Obtenir l'instance

cpp

WiFiManager& wifi = WiFiManager::getInstance();

Initialisation

begin()

cpp

bool begin();

Description : Initialiser le WiFi. Démarre automatiquement l'AP si aucun identifiant STA n'est disponible.

Retourne : true en cas de succès

Exemple :

cpp

WiFiManager& wifi = WiFiManager::getInstance();

if (wifi.begin()) {
    Serial.println("WiFiManager initialized");

    WiFiStatus status = wifi.getStatus();
    Serial.printf("AP IP: %s\n", status.ap_ip.toString().c_str());
}

Mode AP

startAP()

cpp

bool startAP(const char* ssid = nullptr, const char* password = nullptr);

Description : Démarrer le point d'accès.

Parameters:
- ssid - network SSID (nullptr = auto: "ACRouter_XXXXXX")
- password - password (nullptr = "12345678")

Exemple :

cpp

// With auto-generated SSID
wifi.startAP();

// With custom SSID
wifi.startAP("MyACRouter", "mypassword123");

stopAP()

cpp

void stopAP();

Description : Arrêter le point d'accès.

isAPActive()

cpp

bool isAPActive() const;

Retourne : true si l'AP est actif

Mode STA

connectSTA()

cpp

bool connectSTA(const char* ssid, const char* password);

Description : Se connecter à un réseau WiFi.

Parameters:
- ssid - network SSID
- password - password

Retourne : true si connecté

Exemple :

cpp

if (wifi.connectSTA("HomeNetwork", "password123")) {
    Serial.println("Connected to WiFi");

    WiFiStatus status = wifi.getStatus();
    Serial.printf("STA IP: %s\n", status.sta_ip.toString().c_str());
}

disconnectSTA()

cpp

void disconnectSTA();

Description : Se déconnecter du réseau STA.

isSTAConnected()

cpp

bool isSTAConnected() const;

Retourne : true si connecté en STA

Analyse des réseaux

scanNetworks()

cpp

std::vector scanNetworks();

Description : Scanner les réseaux WiFi disponibles.

Retourne : Vecteur de structures WiFiNetwork

Exemple :

cpp

std::vector networks = wifi.scanNetworks();

Serial.printf("Found %d networks:\n", networks.size());
for (const auto& net : networks) {
    Serial.printf("  %s (RSSI: %d, Encrypted: %s)\n",
                  net.ssid.c_str(),
                  net.rssi,
                  net.encrypted ? "Yes" : "No");
}

Statut

getStatus()

cpp

WiFiStatus getStatus() const;

Description : Obtenir le statut WiFi complet.

Exemple :

cpp

WiFiStatus status = wifi.getStatus();

Serial.printf("State: %d\n", static_cast(status.state));
Serial.printf("STA connected: %s\n", status.sta_connected ? "Yes" : "No");
Serial.printf("AP active: %s\n", status.ap_active ? "Yes" : "No");

if (status.sta_connected) {
    Serial.printf("STA IP: %s\n", status.sta_ip.toString().c_str());
    Serial.printf("RSSI: %d dBm\n", status.rssi);
}

if (status.ap_active) {
    Serial.printf("AP IP: %s\n", status.ap_ip.toString().c_str());
    Serial.printf("Clients: %d\n", status.sta_clients);
}

Structures de données

WiFiState

cpp

enum class WiFiState : uint8_t {
    IDLE,               // Not initialized
    AP_ONLY,            // AP only
    STA_CONNECTING,     // Connecting to STA
    STA_CONNECTED,      // Connected to STA
    AP_STA,             // Both modes
    STA_FAILED          // STA failed
};

WiFiStatus

cpp

struct WiFiStatus {
    WiFiState state;
    bool sta_connected;
    bool ap_active;
    IPAddress sta_ip;
    IPAddress ap_ip;
    String sta_ssid;
    String ap_ssid;
    int8_t rssi;
    uint8_t sta_clients;        // Clients on AP
};

WiFiNetwork

cpp

struct WiFiNetwork {
    String ssid;
    int8_t rssi;
    bool encrypted;
};

5.7 API WebServerManager

Fichiers :
- components/comm/include/WebServerManager.h
- components/comm/src/WebServerManager.cpp

Patron de conception : Singleton

Obtenir l'instance

cpp

WebServerManager& webServer = WebServerManager::getInstance();

Initialisation

begin()

cpp

bool begin(uint16_t http_port = 80);

Description : Initialiser le serveur HTTP.

Parameters:
- http_port - HTTP port (default 80)

Exemple :

cpp

WebServerManager& webServer = WebServerManager::getInstance();

if (webServer.begin(80)) {
    Serial.println("WebServer started on port 80");
}

Contrôle

start()

cpp

void start();

Description : Démarrer le serveur web.

stop()

cpp

void stop();

Description : Arrêter le serveur web.

isRunning()

cpp

bool isRunning() const;

Retourne : true si le serveur est en cours d'exécution

Traitement des requêtes

handleClient()

cpp

void handleClient();

Description : Traiter les requêtes HTTP entrantes. À appeler depuis loop().

Exemple :

cpp

void loop() {
    webServer.handleClient();
    // ... rest of code
}

Points de terminaison REST API

Pour la liste complète des points de terminaison, voir Section 8 : Points de terminaison GET et Section 9 : Points de terminaison POST.

Groupes principaux :

Pages web : /, /wifi, /settings/hardware
Statut : /api/status, /api/metrics, /api/config
Contrôle : /api/mode, /api/manual, /api/calibrate
WiFi : /api/wifi/*
Matériel : /api/hardware/*
Système : /api/system/reboot

← Modes du routeur | Sommaire | Suivant : Application principale →

Produits

En Vedette

Commencer

Intégrations

Guides & Articles

ACRouter

Vitrine de Projets

Commencer

Intégrations

Variateurs AC

DimmerLink

ACRouter

GitHub

5. APIs des modules et structures de données

5.1 API RouterController

Obtenir l'instance

Initialisation

begin()

Gestion des modes

setMode()

getMode()

Paramètres de régulation

setControlGain()

getControlGain()

setBalanceThreshold()

getBalanceThreshold()

Commande manuelle (mode MANUAL)

setManualLevel()

getManualLevel()

Boucle de mise à jour principale

update()

Arrêt d'urgence

emergencyStop()

Obtenir le statut

getStatus()

Structures de données

RouterStatus

RouterMode

RouterState

5.2 API PowerMeterADC

Obtenir l'instance

Initialisation

begin()

Contrôle des mesures

start()

stop()

isRunning()

Callback de résultats

setCallback()

Calibrage des capteurs

setVoltageCalibration()

setCurrentCalibration()

Récupération des données

getPowerData()

getVoltageRMS()

getCurrentRMS()

getPower()

Structures de données

Measurements

CurrentChannel

5.3 API DimmerHAL

Obtenir l'instance

Initialisation

begin()

Contrôle de puissance

setPower()

setPowerSmooth()

getPower()

Commande rapide

turnOff()

turnOffAll()

Courbe de puissance

setCurve()

Statut et informations

getStatus()

isInitialized()

Structures de données

DimmerChannel

DimmerCurve

DimmerStatus