etm-powersync-energy-plugin.../energyplugin/nymeaenergyjsonhandler.h
pakutz79 67836b7234 feat: Installer Setup — LoadAdapterRegistry + adapter layer (v12)
Adds a thin adapter layer that maps installer-visible roles (EVCharger,
DHW, HeatPump, Battery, SolarMeter, GridMeter) to nymea Things and
applies Scheduler slot decisions to real hardware.

New files:
- energyplugin/types/loadrole.h — LoadRole enum + compat interface map
- energyplugin/adapters/iloadapter.h — abstract ILoadAdapter interface
- energyplugin/adapters/relayadapter.h/.cpp — binary on/off relay (DHW/HP)
- energyplugin/adapters/sgreadyadapter.h/.cpp — SG-Ready 2-relay HP (SG1–SG4)
- energyplugin/adapters/evchargeradapter.h/.cpp — EV charger W→A adapter
- energyplugin/adapters/batteryadapter.h/.cpp — battery charge/discharge/standby
- energyplugin/adapters/loadadapterregistry.h/.cpp — role→Thing→adapter registry
- energyplugin/adapters/adaptersettings.h/.cpp — persists to adapters.conf (INI)

Modified:
- SchedulerManager: optional LoadAdapterRegistry param; applyCurrentSlot()
  now calls adapter->applyPower() for DHW/HP/Battery roles
- NymeaEnergyJsonHandler: 6 new v12 methods (GetSetupStatus,
  GetCompatibleThings, AssignThingToRole, UnassignRole, SetRoleEnabled,
  TestRoleConnection) + 3 push notifications
- energypluginnymea.cpp: wires AdapterSettings + LoadAdapterRegistry,
  bumps JSON-RPC version to 12
- energyplugin.pri: adds 7 headers + 6 sources
- testscheduler: 4 new tests (detectAdapterType, AdapterSettings round-trip,
  null-registry no-crash, LoadRole serialization) — 15/15 pass
- doc.md: section 12 Installer Setup

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-02-24 09:15:06 +01:00

150 lines
6.4 KiB
C++

// SPDX-License-Identifier: GPL-3.0-or-later
/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
*
* Copyright (C) 2013 - 2024, nymea GmbH
* Copyright (C) 2024 - 2025, chargebyte austria GmbH
*
* This file is part of nymea-energy-plugin-nymea.
*
* nymea-energy-plugin-nymea.s free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* nymea-energy-plugin-nymea.s distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with nymea-energy-plugin-nymea. If not, see <https://www.gnu.org/licenses/>.
*
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
#ifndef NYMEAENERGYJSONHANDLER_H
#define NYMEAENERGYJSONHANDLER_H
#include <QObject>
#include <jsonrpc/jsonhandler.h>
#include "types/scoreentry.h"
#include "types/energytimeslot.h"
#include "types/manualslotconfig.h"
#include "adapters/loadadapterregistry.h"
class SmartChargingManager;
class SpotMarketManager;
class SchedulerManager;
class NymeaEnergyJsonHandler : public JsonHandler
{
Q_OBJECT
public:
explicit NymeaEnergyJsonHandler(SpotMarketManager *spotMarketManager,
SmartChargingManager *smartChargingManager,
SchedulerManager *schedulerManager,
LoadAdapterRegistry *adapterRegistry = nullptr,
QObject *parent = nullptr);
QString name() const override;
Q_INVOKABLE JsonReply *GetPhasePowerLimit(const QVariantMap &params);
Q_INVOKABLE JsonReply *SetPhasePowerLimit(const QVariantMap &params);
Q_INVOKABLE JsonReply *GetAcquisitionTolerance(const QVariantMap &params);
Q_INVOKABLE JsonReply *SetAcquisitionTolerance(const QVariantMap &params);
Q_INVOKABLE JsonReply *GetBatteryLevelConsideration(const QVariantMap &params);
Q_INVOKABLE JsonReply *SetBatteryLevelConsideration(const QVariantMap &params);
Q_INVOKABLE JsonReply *GetChargingInfos(const QVariantMap &params);
Q_INVOKABLE JsonReply *SetChargingInfo(const QVariantMap &params, const JsonContext &context);
Q_INVOKABLE JsonReply *GetLockOnUnplug(const QVariantMap &params);
Q_INVOKABLE JsonReply *SetLockOnUnplug(const QVariantMap &params);
Q_INVOKABLE JsonReply *GetAvailableSpotMarketProviders(const QVariantMap &params);
Q_INVOKABLE JsonReply *GetSpotMarketConfiguration(const QVariantMap &params);
Q_INVOKABLE JsonReply *SetSpotMarketConfiguration(const QVariantMap &params);
Q_INVOKABLE JsonReply *GetSpotMarketScoreEntries(const QVariantMap &params);
Q_INVOKABLE JsonReply *GetChargingSchedules(const QVariantMap &params);
// --- Scheduler API (NymeaEnergy v10) ---
// Timeline visualisation
Q_INVOKABLE JsonReply *GetEnergyTimeline(const QVariantMap &params);
Q_INVOKABLE JsonReply *GetFlexibleLoads(const QVariantMap &params);
Q_INVOKABLE JsonReply *GetSchedulerStatus(const QVariantMap &params);
// Scheduler configuration
Q_INVOKABLE JsonReply *SetSchedulerStrategy(const QVariantMap &params);
Q_INVOKABLE JsonReply *SetSchedulerConfig(const QVariantMap &params);
Q_INVOKABLE JsonReply *SetLoadConfig(const QVariantMap &params);
Q_INVOKABLE JsonReply *OverrideSlot(const QVariantMap &params);
// --- Manual slot API (NymeaEnergy v11) ---
Q_INVOKABLE JsonReply *GetManualSlots(const QVariantMap &params);
Q_INVOKABLE JsonReply *SetManualSlot(const QVariantMap &params);
Q_INVOKABLE JsonReply *RemoveManualSlot(const QVariantMap &params);
Q_INVOKABLE JsonReply *ClearManualSlots(const QVariantMap &params);
// --- Installer Setup API (NymeaEnergy v12) ---
Q_INVOKABLE JsonReply *GetSetupStatus(const QVariantMap &params);
Q_INVOKABLE JsonReply *GetCompatibleThings(const QVariantMap &params);
Q_INVOKABLE JsonReply *AssignThingToRole(const QVariantMap &params);
Q_INVOKABLE JsonReply *UnassignRole(const QVariantMap &params);
Q_INVOKABLE JsonReply *SetRoleEnabled(const QVariantMap &params);
Q_INVOKABLE JsonReply *TestRoleConnection(const QVariantMap &params);
signals:
void PhasePowerLimitChanged(const QVariantMap &params);
void AcquisitionToleranceChanged(const QVariantMap &params);
void LockOnUnplugChanged(const QVariantMap &params);
void ChargingInfoAdded(const QVariantMap &params);
void ChargingInfoRemoved(const QVariantMap &params);
void ChargingInfoChanged(const QVariantMap &params);
void SpotMarketConfigurationChanged(const QVariantMap &params);
void SpotMarketScoreEntriesChanged(const QVariantMap &params);
void ChargingSchedulesChanged(const QVariantMap &params);
void BatteryLevelConsiderationChanged(const QVariantMap &params);
// Scheduler push notifications
void TimelineUpdated(const QVariantMap &params);
void SlotActivated(const QVariantMap &params);
void OverrideConflict(const QVariantMap &params);
// Manual slot push notification
void ManualSlotActivated(const QVariantMap &params);
// Installer setup push notifications (v12)
void SetupStatusChanged(const QVariantMap &params);
void ConnectionTestResult(const QVariantMap &params);
void ThingBecameCompatible(const QVariantMap &params);
private:
SpotMarketManager *m_spotMarketManager;
SmartChargingManager *m_smartChargingManager = nullptr;
SchedulerManager *m_schedulerManager = nullptr;
LoadAdapterRegistry *m_adapterRegistry = nullptr;
void sendSpotMarketConfigurationChangedNotification();
QVariantMap buildTimelineSummary(const QList<EnergyTimeSlot> &timeline) const;
// Helper: convert a timeline slot to QVariantMap for JSON-RPC
QVariantMap slotToVariantMap(const EnergyTimeSlot &slot) const;
// Helper: access the registered ManualStrategy (null if not registered)
class ManualStrategy *manualStrategy() const;
// Installer setup serialization helpers
QVariantMap setupStatusToVariant(const SetupStatus &status) const;
QVariantMap roleStatusToVariant(const RoleStatus &rs) const;
QVariantMap thingInfoToVariant(const ThingInfo &info) const;
};
#endif // NYMEAENERGYJSONHANDLER_H