89406495a8
Adds a fronius vendor and a froniusConnection thing class alongside the
generic sunspec and solarEdge ones, following the SolarEdge mechanism but
none of its workarounds - no proprietary battery block and no PV
production computed by difference, since the GEN24 exposes model 160.
FroniusRules holds the vendor decisions as pure functions:
- discovery only keeps devices announcing Fronius as manufacturer;
- the byte order is the SunSpec default, not the forced big endian that
is specific to SolarEdge, and no endianness parameter is exposed;
- meterSlaveId defaults to 200, 0 meaning no meter on this connection;
- a hard 7 s floor on the poll interval. Polling faster can push the
inverter offline towards the vendor portal, and recovery needs an
AC+DC power cycle on site, so this is a guard in the code rather than
a configurable default;
- the registers the inverter accepts and then silently ignores are
refused before anything reaches the wire;
- the six HEMS battery modes map onto ChaGriSet, StorCtl_Mod, InWRte and
OutWRte, negative meaning charge;
- model 160 blocks are classified by IDStr, never by index: on a three
or four MPPT inverter the battery blocks are not in position 3 and 4.
Storages under a Fronius connection default revertTime to 300 s.
Setpoints now reread the scale factor before writing and read the written
registers back afterwards, reporting a mismatch through a new
controlHealthy state - the only defence against writes that are accepted
and then ignored without a Modbus exception.
Byte order and the revert timer semantics on model 124 are inferences, not
measurements; see specs/fronius-sunspec.md, H-2 and H-3.
140 lines
5.5 KiB
C++
140 lines
5.5 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-plugins-modbus.
|
|
*
|
|
* nymea-plugins-modbus is 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-plugins-modbus is 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-plugins-modbus. If not, see <https://www.gnu.org/licenses/>.
|
|
*
|
|
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
|
|
|
|
#ifndef INTEGRATIONPLUGINSUNSPEC_H
|
|
#define INTEGRATIONPLUGINSUNSPEC_H
|
|
|
|
#include <integrations/integrationplugin.h>
|
|
#include <network/networkdevicemonitor.h>
|
|
#include <plugintimer.h>
|
|
|
|
#include <sunspecconnection.h>
|
|
#include <models/sunspecmodelfactory.h>
|
|
|
|
#include "sunspecthing.h"
|
|
#include "sunspecstoragelogic.h"
|
|
#include "froniusrules.h"
|
|
#include "extern-plugininfo.h"
|
|
|
|
#include <QUuid>
|
|
|
|
class IntegrationPluginSunSpec: public IntegrationPlugin
|
|
{
|
|
Q_OBJECT
|
|
|
|
Q_PLUGIN_METADATA(IID "io.nymea.IntegrationPlugin" FILE "integrationpluginsunspec.json")
|
|
Q_INTERFACES(IntegrationPlugin)
|
|
|
|
public:
|
|
explicit IntegrationPluginSunSpec();
|
|
|
|
void init() override;
|
|
void discoverThings(ThingDiscoveryInfo *info) override;
|
|
void setupThing(ThingSetupInfo *info) override;
|
|
void postSetupThing(Thing *thing) override;
|
|
void thingRemoved(Thing *thing) override;
|
|
void executeAction(ThingActionInfo *info) override;
|
|
|
|
private:
|
|
// SunSpec Connection params map
|
|
QHash<ThingClassId, ParamTypeId> m_connectionDiscoverySlaveIdParamTypeIds;
|
|
QHash<ThingClassId, ParamTypeId> m_connectionMacAddressParamTypeIds;
|
|
QHash<ThingClassId, ParamTypeId> m_connectionAddressParamTypeIds;
|
|
QHash<ThingClassId, ParamTypeId> m_connectionHostNameParamTypeIds;
|
|
QHash<ThingClassId, ParamTypeId> m_connectionPortParamTypeIds;
|
|
QHash<ThingClassId, ParamTypeId> m_connectionSlaveIdParamTypeIds;
|
|
|
|
// SunSpec thing params map
|
|
QHash<ThingClassId, ParamTypeId> m_modelIdParamTypeIds;
|
|
QHash<ThingClassId, ParamTypeId> m_modbusAddressParamTypeIds;
|
|
QHash<ThingClassId, ParamTypeId> m_manufacturerParamTypeIds;
|
|
QHash<ThingClassId, ParamTypeId> m_deviceModelParamTypeIds;
|
|
QHash<ThingClassId, ParamTypeId> m_serialNumberParamTypeIds;
|
|
|
|
PluginTimer *m_refreshTimer = nullptr;
|
|
|
|
QHash<Thing *, NetworkDeviceMonitor *> m_monitors;
|
|
|
|
QHash<ThingId, SunSpecConnection *> m_sunSpecConnections;
|
|
QHash<Thing *, SunSpecThing *> m_sunSpecThings;
|
|
|
|
QHash<Thing *, SunSpecModel *> m_sunSpecInverters;
|
|
QHash<Thing *, SunSpecModel *> m_sunSpecMeters;
|
|
QHash<Thing *, SunSpecModel *> m_sunSpecStorages;
|
|
|
|
|
|
Thing *getThingForSunSpecModel(uint modelId, uint modbusAddress, const ThingId &parentId);
|
|
bool sunspecThingAlreadyAdded(uint modelId, uint modbusAddress, const ThingId &parentId);
|
|
void processDiscoveryResult(Thing *thing, SunSpecConnection *connection);
|
|
|
|
// SunSpec things
|
|
SunSpecConnection *createConnection(Thing *thing);
|
|
|
|
// Custom types
|
|
void setupSolarEdgeBattery(ThingSetupInfo *info);
|
|
|
|
// Discover SolarEdge batteries
|
|
void searchSolarEdgeBatteries(SunSpecConnection *connection);
|
|
void searchSolarEdgeBattery(SunSpecConnection *connection, const ThingId &parentThingId, quint16 startRegister);
|
|
|
|
// SolarEdge
|
|
double calculateSolarEdgePvProduction(Thing *thing, double acPower, double dcPower);
|
|
|
|
void autocreateSunSpecModelThing(const ThingClassId &thingClassId, const QString &thingName, const ThingId &parentId, SunSpecModel *model);
|
|
|
|
QString getInverterStateString(quint16 state);
|
|
QString getInverterErrorString(quint32 flag);
|
|
|
|
double fixValueSign(double targetValue, double powerValue);
|
|
bool hasManufacturer(const QStringList &manufacturers, const QString &manufacturer);
|
|
void markThingStatesDisconnected(Thing *thing);
|
|
|
|
// Fronius
|
|
bool isFroniusChild(const ThingId &parentId);
|
|
int effectiveUpdateInterval();
|
|
|
|
// Storage setpoints
|
|
void executeSetpointPlan(ThingActionInfo *info, SunSpecStorageModel *storage, const SunSpecStorageLogic::SetpointPlan &plan);
|
|
void executeSetpointWrite(ThingActionInfo *info, SunSpecStorageModel *storage, const SunSpecStorageLogic::SetpointPlan &plan, int index);
|
|
QModbusReply *writeSetpointRegister(SunSpecStorageModel *storage, const SunSpecStorageLogic::Write &write);
|
|
double readSetpointRegister(SunSpecStorageModel *storage, SunSpecStorageLogic::Register reg);
|
|
void refreshStorageBlock(ThingActionInfo *info, SunSpecStorageModel *storage, const std::function<void()> &continuation);
|
|
void verifySetpointPlan(ThingActionInfo *info, SunSpecStorageModel *storage, const SunSpecStorageLogic::SetpointPlan &plan);
|
|
|
|
private slots:
|
|
void onRefreshTimer();
|
|
void onPluginConfigurationChanged(const ParamTypeId ¶mTypeId, const QVariant &value);
|
|
|
|
void onInverterBlockUpdated();
|
|
void onMeterBlockUpdated();
|
|
void onStorageBlockUpdated();
|
|
void onSolarEdgeBatteryBlockUpdated();
|
|
|
|
void evaluateEnergyProducedValue(Thing *inverterThing, float energyProduced);
|
|
|
|
|
|
};
|
|
#endif // INTEGRATIONPLUGINSUNSPEC_H
|
|
|