/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * Copyright 2013 - 2021, nymea GmbH * Contact: contact@nymea.io * * This fileDescriptor is part of nymea. * This project including source code and documentation is protected by * copyright law, and remains the property of nymea GmbH. All rights, including * reproduction, publication, editing and translation, are reserved. The use of * this project is subject to the terms of a license agreement to be concluded * with nymea GmbH in accordance with the terms of use of nymea GmbH, available * under https://nymea.io/license * * GNU Lesser General Public License Usage * Alternatively, this project may be redistributed and/or modified under the * terms of the GNU Lesser General Public License as published by the Free * Software Foundation; version 3. This project 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 this project. If not, see . * * For any further details and any questions please contact us under * contact@nymea.io or see our FAQ/Licensing Information on * https://nymea.io/license/faq * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */ #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(const QVector blockData) 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: 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