// 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 SUNSPECLITHIUMIONMODULEMODEL_H #define SUNSPECLITHIUMIONMODULEMODEL_H #include #include "sunspecmodel.h" #include "sunspecmodelrepeatingblock.h" class SunSpecConnection; class SunSpecLithiumIonModuleModel; class SunSpecLithiumIonModuleModelRepeatingBlock : public SunSpecModelRepeatingBlock { Q_OBJECT public: enum Cellst { CellstCellIsBalancing = 0x1 }; Q_DECLARE_FLAGS(CellstFlags, Cellst) Q_FLAG(Cellst) explicit SunSpecLithiumIonModuleModelRepeatingBlock(quint16 blockIndex, quint16 blockSize, quint16 modbusStartRegister, SunSpecLithiumIonModuleModel *parent = nullptr); ~SunSpecLithiumIonModuleModelRepeatingBlock() override = default; SunSpecLithiumIonModuleModel *parentModel() const; QString name() const override; /* Cell terminal voltage. [V] */ float cellVoltage() const; /* Cell temperature. [C] */ float cellTemperature() const; /* Status of the cell. */ CellstFlags cellStatus() const; void processBlockData() override; protected: void initDataPoints() override; private: SunSpecLithiumIonModuleModel *m_parentModel = nullptr; float m_cellVoltage = 0; float m_cellTemperature = 0; CellstFlags m_cellStatus; }; class SunSpecLithiumIonModuleModel : public SunSpecModel { Q_OBJECT public: explicit SunSpecLithiumIonModuleModel(SunSpecConnection *connection, quint16 modbusStartRegister, quint16 modelLength, SunSpecDataPoint::ByteOrder byteOrder, QObject *parent = nullptr); ~SunSpecLithiumIonModuleModel() override; QString name() const override; QString description() const override; QString label() const override; /* Index of the string containing the module. */ quint16 stringIndex() const; /* Index of the module within the string. */ quint16 moduleIndex() const; /* Count of all cells in the module. */ quint16 moduleCellCount() const; /* Module state of charge, expressed as a percentage. [%] */ float moduleSoC() const; /* Depth of discharge for the module. [%] */ float depthOfDischarge() const; /* Module state of health, expressed as a percentage. [%] */ float moduleSoH() const; /* Count of cycles executed. */ quint32 cycleCount() const; /* Voltage of the module. [V] */ float moduleVoltage() const; /* Maximum voltage for all cells in the module. [V] */ float maxCellVoltage() const; /* Cell with the maximum voltage. */ quint16 maxCellVoltageCell() const; /* Minimum voltage for all cells in the module. [V] */ float minCellVoltage() const; /* Cell with the minimum voltage. */ quint16 minCellVoltageCell() const; /* Average voltage for all cells in the module. [V] */ float averageCellVoltage() const; /* Maximum temperature for all cells in the module. [C] */ float maxCellTemperature() const; /* Cell with the maximum cell temperature. */ quint16 maxCellTemperatureCell() const; /* Minimum temperature for all cells in the module. [C] */ float minCellTemperature() const; /* Cell with the minimum cell temperature. */ quint16 minCellTemperatureCell() const; /* Average temperature for all cells in the module. [C] */ float averageCellTemperature() const; /* Number of cells currently being balanced in the module. */ quint16 balancedCellCount() const; /* Serial number for the module. */ QString serialNumber() const; /* Scale factor for module state of charge. */ qint16 soC_SF() const; /* Scale factor for module state of health. */ qint16 soH_SF() const; /* Scale factor for module depth of discharge. */ qint16 doD_SF() const; /* Scale factor for module voltage. */ qint16 v_SF() const; /* Scale factor for cell voltage. */ qint16 cellV_SF() const; /* Scale factor for module temperature. */ qint16 tmp_SF() const; protected: quint16 m_fixedBlockLength = 42; quint16 m_repeatingBlockLength = 4; void initDataPoints(); void processBlockData() override; private: void setupRepeatingBlocks(); quint16 m_stringIndex = 0; quint16 m_moduleIndex = 0; quint16 m_moduleCellCount = 0; float m_moduleSoC = 0; float m_depthOfDischarge = 0; float m_moduleSoH = 0; quint32 m_cycleCount = 0; float m_moduleVoltage = 0; float m_maxCellVoltage = 0; quint16 m_maxCellVoltageCell = 0; float m_minCellVoltage = 0; quint16 m_minCellVoltageCell = 0; float m_averageCellVoltage = 0; float m_maxCellTemperature = 0; quint16 m_maxCellTemperatureCell = 0; float m_minCellTemperature = 0; quint16 m_minCellTemperatureCell = 0; float m_averageCellTemperature = 0; quint16 m_balancedCellCount = 0; QString m_serialNumber; qint16 m_soC_SF = 0; qint16 m_soH_SF = 0; qint16 m_doD_SF = 0; qint16 m_v_SF = 0; qint16 m_cellV_SF = 0; qint16 m_tmp_SF = 0; }; QDebug operator<<(QDebug debug, SunSpecLithiumIonModuleModel *model); #endif // SUNSPECLITHIUMIONMODULEMODEL_H