7709057335
Morceaux 0-2 implémentés et compilés (0 erreur / 0 warning) : - M0 : LoadAction.force=false (bypass verrous anti-rebond sécurité) - M1 : EcsRelayAdapter (.h+.cpp) — N paliers powerswitch, anti-rebond, etm.pri - M2 : buildContext() — SurplusMeter brut, loads EV+ECS, registerEcsAdapter() AGENTS.md : section PLAN 3C ajoutée avec corrections A+B intégrées. Corrections A (déduction EV unique dans scheduler) et B (recrédit conso propre anti-clignotement) documentées avant implémentation morceau 3. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
119 lines
4.7 KiB
C++
119 lines
4.7 KiB
C++
// SPDX-License-Identifier: GPL-3.0-or-later
|
|
// Copyright (C) 2025 - 2026, Patrick Schurig / ETM PowerSync
|
|
#pragma once
|
|
|
|
#include "../smartchargingmanager.h"
|
|
#include "scheduler/ischeduler.h"
|
|
#include "types/surpluscontext.h"
|
|
#include "types/plan.h"
|
|
|
|
class EvAdapter;
|
|
class EcsRelayAdapter;
|
|
class RuleBasedScheduler;
|
|
|
|
/*!
|
|
* \brief Arbitre central ETM — remplace SmartChargingManager::update() (ETM_ARBITRATOR).
|
|
*
|
|
* Hérite de SmartChargingManager pour conserver la compatibilité API complète avec
|
|
* NymeaEnergyJsonHandler sans modifier le code amont.
|
|
* Seul update() est surchargé : préparation → sécurité → planificateur → adapters.
|
|
*
|
|
* \invariant UN seul arbitre : EnergyArbitrator décide, les EvAdapter exécutent (règle 1).
|
|
* \invariant verifyOverloadProtection() est toujours appelée avant la planification (règle 4).
|
|
* \invariant Toute LoadAction transmise aux adapters a un \c reason non vide (règle 7).
|
|
* \invariant L'absence du root meter n'empêche pas le démarrage — cycle ignoré silencieusement.
|
|
*/
|
|
class EnergyArbitrator : public SmartChargingManager
|
|
{
|
|
Q_OBJECT
|
|
public:
|
|
explicit EnergyArbitrator(EnergyManager *energyManager, ThingManager *thingManager,
|
|
SpotMarketManager *spotMarketManager,
|
|
EnergyManagerConfiguration *configuration,
|
|
QObject *parent = nullptr);
|
|
|
|
/*!
|
|
* \brief Déclenche planSurplusCharging() (protégée) — appelé par RuleBasedScheduler.
|
|
* \param now Instant courant du cycle.
|
|
*/
|
|
void runSurplusPlanning(const QDateTime &now);
|
|
|
|
/*!
|
|
* \brief Déclenche planSpotMarketCharging() (protégée) — appelé par RuleBasedScheduler.
|
|
* \param now Instant courant du cycle.
|
|
*/
|
|
void runSpotMarketPlanning(const QDateTime &now);
|
|
|
|
/*!
|
|
* \brief Actions planifiées (résultat de runSurplus/SpotMarket).
|
|
* \return Référence constante vers la table EvCharger* → ChargingActions.
|
|
* \note Valide seulement après runSurplusPlanning() / runSpotMarketPlanning().
|
|
*/
|
|
const QHash<EvCharger *, ChargingActions> &scheduledActions() const;
|
|
|
|
/*!
|
|
* \brief Pont d'exécution pour EvAdapter — délègue à executeChargingAction() protégée.
|
|
* \param charger Borne EV cible.
|
|
* \param action ChargingAction à appliquer.
|
|
* \param now Instant de l'action (pour les locks anti-rebond).
|
|
*/
|
|
void doExecuteChargingAction(EvCharger *charger, const ChargingAction &action, const QDateTime &now);
|
|
|
|
/*!
|
|
* \brief Liste des EvCharger enregistrés (lecture seule).
|
|
* \return Table ThingId → EvCharger*.
|
|
*/
|
|
const QHash<ThingId, EvCharger *> ®isteredEvChargers() const;
|
|
|
|
/*!
|
|
* \brief Root meter courant.
|
|
* \return Pointeur ou nullptr si aucun compteur principal n'est enregistré.
|
|
*/
|
|
RootMeter *registeredRootMeter() const;
|
|
|
|
/*!
|
|
* \brief Enregistre un EcsRelayAdapter pour inclusion dans le contexte et le dispatch.
|
|
*
|
|
* Appelé par le test (setup) ou la configuration de production.
|
|
* L'adaptateur est adopté comme enfant Qt de l'arbitre.
|
|
* \param adapter Adaptateur à enregistrer. Son \c descriptor().id doit être unique.
|
|
*/
|
|
void registerEcsAdapter(EcsRelayAdapter *adapter);
|
|
|
|
protected:
|
|
/*!
|
|
* \brief Boucle principale ETM — surcharge SmartChargingManager::update().
|
|
*
|
|
* Ordre garanti :
|
|
* 1. updateManualSoCsWithoutMeter()
|
|
* 2. prepareInformation()
|
|
* 3. verifyOverloadProtection() + verifyOverloadProtectionRecovery()
|
|
* 4. m_scheduler->getPlan() → log des decisionReason
|
|
* 5. adjustEvChargers() → dispatch matériel + mise à jour états
|
|
*
|
|
* \param currentDateTime Instant courant (timer ou simulation).
|
|
*/
|
|
void update(const QDateTime ¤tDateTime) override;
|
|
|
|
private:
|
|
/*!
|
|
* \brief Construit le SurplusContext §5 : meter brut + loads EV + loads ECS.
|
|
*
|
|
* \c ctx.meter.exportW = mesure brute du compteur (AGENTS invariant 8 — aucune
|
|
* déduction interne). La déduction evReservedW est faite dans le scheduler.
|
|
*/
|
|
SurplusContext buildContext(const QDateTime &now) const;
|
|
|
|
/*!
|
|
* \brief Synchronise m_adapters avec les EvCharger actuellement enregistrés.
|
|
* Crée les adapters manquants, supprime les adapters obsolètes.
|
|
* \note Découverte ECS via interface 'ecsrelay' ThingManager — déféré 3g config.
|
|
* En beta, les EcsRelayAdapters sont enregistrés via registerEcsAdapter().
|
|
*/
|
|
void syncAdapters();
|
|
|
|
RuleBasedScheduler *m_scheduler = nullptr;
|
|
QHash<QString, EvAdapter *> m_adapters; //!< loadId (ThingId string) → EvAdapter*.
|
|
QHash<QString, EcsRelayAdapter *> m_ecsAdapters; //!< loadId → EcsRelayAdapter*.
|
|
};
|