// SPDX-License-Identifier: LGPL-3.0-or-later /* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * Copyright (C) 2013 - 2024, nymea GmbH * Copyright (C) 2024 - 2025, chargebyte austria GmbH * * This file is part of libnymea-sunspec. * * libnymea-sunspec is free software: you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public License * as published by the Free Software Foundation, either version 3 * of the License, or (at your option) any later version. * * libnymea-sunspec 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 Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public License * along with libnymea-sunspec. If not, see . * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */ #ifndef SUNSPECVOLTVARMODEL_H #define SUNSPECVOLTVARMODEL_H #include #include "sunspecmodel.h" #include "sunspecmodelrepeatingblock.h" class SunSpecConnection; class SunSpecVoltVarModel; class SunSpecVoltVarModelRepeatingBlock : public SunSpecModelRepeatingBlock { Q_OBJECT public: enum Deptref { DeptrefWMax = 1, DeptrefVArMax = 2, DeptrefVArAval = 3 }; Q_ENUM(Deptref) enum Readonly { ReadonlyReadwrite = 0, ReadonlyReadonly = 1 }; Q_ENUM(Readonly) explicit SunSpecVoltVarModelRepeatingBlock(quint16 blockIndex, quint16 blockSize, quint16 modbusStartRegister, SunSpecVoltVarModel *parent = nullptr); ~SunSpecVoltVarModelRepeatingBlock() override = default; SunSpecVoltVarModel *parentModel() const; QString name() const override; /* Number of active points in array. */ quint16 actPt() const; QModbusReply *setActPt(quint16 actPt); /* Meaning of dependent variable: 1=%WMax 2=%VArMax 3=%VArAval. */ Deptref deptRef() const; QModbusReply *setDeptRef(Deptref deptRef); /* Point 1 Volts. [% VRef] */ float v1() const; QModbusReply *setV1(float v1); /* Point 1 VARs. */ float vAr1() const; QModbusReply *setVAr1(float vAr1); /* Point 2 Volts. [% VRef] */ float v2() const; QModbusReply *setV2(float v2); /* Point 2 VARs. */ float vAr2() const; QModbusReply *setVAr2(float vAr2); /* Point 2 Volts. [% VRef] */ float v3() const; QModbusReply *setV3(float v3); /* Point 3 VARs. */ float vAr3() const; QModbusReply *setVAr3(float vAr3); /* Point 4 Volts. [% VRef] */ float v4() const; QModbusReply *setV4(float v4); /* Point 4 VARs. */ float vAr4() const; QModbusReply *setVAr4(float vAr4); /* Point 5 Volts. [% VRef] */ float v5() const; QModbusReply *setV5(float v5); /* Point 5 VARs. */ float vAr5() const; QModbusReply *setVAr5(float vAr5); /* Point 6 Volts. [% VRef] */ float v6() const; QModbusReply *setV6(float v6); /* Point 6 VARs. */ float vAr6() const; QModbusReply *setVAr6(float vAr6); /* Point 7 Volts. [% VRef] */ float v7() const; QModbusReply *setV7(float v7); /* Point 7 VARs. */ float vAr7() const; QModbusReply *setVAr7(float vAr7); /* Point 8 Volts. [% VRef] */ float v8() const; QModbusReply *setV8(float v8); /* Point 8 VARs. */ float vAr8() const; QModbusReply *setVAr8(float vAr8); /* Point 9 Volts. [% VRef] */ float v9() const; QModbusReply *setV9(float v9); /* Point 9 VARs. */ float vAr9() const; QModbusReply *setVAr9(float vAr9); /* Point 10 Volts. [% VRef] */ float v10() const; QModbusReply *setV10(float v10); /* Point 10 VARs. */ float vAr10() const; QModbusReply *setVAr10(float vAr10); /* Point 11 Volts. [% VRef] */ float v11() const; QModbusReply *setV11(float v11); /* Point 11 VARs. */ float vAr11() const; QModbusReply *setVAr11(float vAr11); /* Point 12 Volts. [% VRef] */ float v12() const; QModbusReply *setV12(float v12); /* Point 12 VARs. */ float vAr12() const; QModbusReply *setVAr12(float vAr12); /* Point 13 Volts. [% VRef] */ float v13() const; QModbusReply *setV13(float v13); /* Point 13 VARs. */ float vAr13() const; QModbusReply *setVAr13(float vAr13); /* Point 14 Volts. [% VRef] */ float v14() const; QModbusReply *setV14(float v14); /* Point 14 VARs. */ float vAr14() const; QModbusReply *setVAr14(float vAr14); /* Point 15 Volts. [% VRef] */ float v15() const; QModbusReply *setV15(float v15); /* Point 15 VARs. */ float vAr15() const; QModbusReply *setVAr15(float vAr15); /* Point 16 Volts. [% VRef] */ float v16() const; QModbusReply *setV16(float v16); /* Point 16 VARs. */ float vAr16() const; QModbusReply *setVAr16(float vAr16); /* Point 17 Volts. [% VRef] */ float v17() const; QModbusReply *setV17(float v17); /* Point 17 VARs. */ float vAr17() const; QModbusReply *setVAr17(float vAr17); /* Point 18 Volts. [% VRef] */ float v18() const; QModbusReply *setV18(float v18); /* Point 18 VARs. */ float vAr18() const; QModbusReply *setVAr18(float vAr18); /* Point 19 Volts. [% VRef] */ float v19() const; QModbusReply *setV19(float v19); /* Point 19 VARs. */ float vAr19() const; QModbusReply *setVAr19(float vAr19); /* Point 20 Volts. [% VRef] */ float v20() const; QModbusReply *setV20(float v20); /* Point 20 VARs. */ float vAr20() const; QModbusReply *setVAr20(float vAr20); /* Optional description for curve. (Max 16 chars) */ QString crvNam() const; QModbusReply *setCrvNam(const QString &crvNam); /* The time of the PT1 in seconds (time to accomplish a change of 95%). [Secs] */ quint16 rmpTms() const; QModbusReply *setRmpTms(quint16 rmpTms); /* The maximum rate at which the VAR value may be reduced in response to changes in the voltage value. %refVal is %WMax %VArMax or %VArAval depending on value of DeptRef. [% ref_value/min] */ float rmpDecTmm() const; QModbusReply *setRmpDecTmm(float rmpDecTmm); /* The maximum rate at which the VAR value may be increased in response to changes in the voltage value. %refVal is %WMax %VArMax or %VArAval depending on value of DeptRef. [% ref_value/min] */ float rmpIncTmm() const; QModbusReply *setRmpIncTmm(float rmpIncTmm); /* Boolean flag indicates if curve is read-only or can be modified. */ Readonly readOnly() const; void processBlockData() override; protected: void initDataPoints() override; private: SunSpecVoltVarModel *m_parentModel = nullptr; quint16 m_actPt = 0; Deptref m_deptRef; float m_v1 = 0; float m_vAr1 = 0; float m_v2 = 0; float m_vAr2 = 0; float m_v3 = 0; float m_vAr3 = 0; float m_v4 = 0; float m_vAr4 = 0; float m_v5 = 0; float m_vAr5 = 0; float m_v6 = 0; float m_vAr6 = 0; float m_v7 = 0; float m_vAr7 = 0; float m_v8 = 0; float m_vAr8 = 0; float m_v9 = 0; float m_vAr9 = 0; float m_v10 = 0; float m_vAr10 = 0; float m_v11 = 0; float m_vAr11 = 0; float m_v12 = 0; float m_vAr12 = 0; float m_v13 = 0; float m_vAr13 = 0; float m_v14 = 0; float m_vAr14 = 0; float m_v15 = 0; float m_vAr15 = 0; float m_v16 = 0; float m_vAr16 = 0; float m_v17 = 0; float m_vAr17 = 0; float m_v18 = 0; float m_vAr18 = 0; float m_v19 = 0; float m_vAr19 = 0; float m_v20 = 0; float m_vAr20 = 0; QString m_crvNam; quint16 m_rmpTms = 0; float m_rmpDecTmm = 0; float m_rmpIncTmm = 0; Readonly m_readOnly; }; class SunSpecVoltVarModel : public SunSpecModel { Q_OBJECT public: enum Modena { ModenaEnabled = 0x1 }; Q_DECLARE_FLAGS(ModenaFlags, Modena) Q_FLAG(Modena) explicit SunSpecVoltVarModel(SunSpecConnection *connection, quint16 modbusStartRegister, quint16 modelLength, SunSpecDataPoint::ByteOrder byteOrder, QObject *parent = nullptr); ~SunSpecVoltVarModel() override; QString name() const override; QString description() const override; QString label() const override; /* Index of active curve. 0=no active curve. */ quint16 actCrv() const; QModbusReply *setActCrv(quint16 actCrv); /* Is Volt-VAR control active. */ ModenaFlags modEna() const; QModbusReply *setModEna(ModenaFlags modEna); /* Time window for volt-VAR change. [Secs] */ quint16 winTms() const; QModbusReply *setWinTms(quint16 winTms); /* Timeout period for volt-VAR curve selection. [Secs] */ quint16 rvrtTms() const; QModbusReply *setRvrtTms(quint16 rvrtTms); /* The time of the PT1 in seconds (time to accomplish a change of 95%). [Secs] */ quint16 rmpTms() const; QModbusReply *setRmpTms(quint16 rmpTms); /* Number of curves supported (recommend 4). */ quint16 nCrv() const; /* Number of curve points supported (maximum of 20). */ quint16 nPt() const; /* Scale factor for percent VRef. */ qint16 vSf() const; /* scale factor for dependent variable. */ qint16 deptRefSf() const; qint16 rmpIncDec_SF() const; protected: quint16 m_fixedBlockLength = 10; quint16 m_repeatingBlockLength = 54; void initDataPoints(); void processBlockData() override; private: void setupRepeatingBlocks(); quint16 m_actCrv = 0; ModenaFlags m_modEna; quint16 m_winTms = 0; quint16 m_rvrtTms = 0; quint16 m_rmpTms = 0; quint16 m_nCrv = 0; quint16 m_nPt = 0; qint16 m_vSf = 0; qint16 m_deptRefSf = 0; qint16 m_rmpIncDec_SF = 0; }; QDebug operator<<(QDebug debug, SunSpecVoltVarModel *model); #endif // SUNSPECVOLTVARMODEL_H