thermal_model.hh revision 11442
111420Sdavid.guillen@arm.com/* 211420Sdavid.guillen@arm.com * Copyright (c) 2015 ARM Limited 311420Sdavid.guillen@arm.com * All rights reserved 411420Sdavid.guillen@arm.com * 511420Sdavid.guillen@arm.com * The license below extends only to copyright in the software and shall 611420Sdavid.guillen@arm.com * not be construed as granting a license to any other intellectual 711420Sdavid.guillen@arm.com * property including but not limited to intellectual property relating 811420Sdavid.guillen@arm.com * to a hardware implementation of the functionality of the software 911420Sdavid.guillen@arm.com * licensed hereunder. You may use the software subject to the license 1011420Sdavid.guillen@arm.com * terms below provided that you ensure that this notice is replicated 1111420Sdavid.guillen@arm.com * unmodified and in its entirety in all distributions of the software, 1211420Sdavid.guillen@arm.com * modified or unmodified, in source code or in binary form. 1311420Sdavid.guillen@arm.com * 1411420Sdavid.guillen@arm.com * Redistribution and use in source and binary forms, with or without 1511420Sdavid.guillen@arm.com * modification, are permitted provided that the following conditions are 1611420Sdavid.guillen@arm.com * met: redistributions of source code must retain the above copyright 1711420Sdavid.guillen@arm.com * notice, this list of conditions and the following disclaimer; 1811420Sdavid.guillen@arm.com * redistributions in binary form must reproduce the above copyright 1911420Sdavid.guillen@arm.com * notice, this list of conditions and the following disclaimer in the 2011420Sdavid.guillen@arm.com * documentation and/or other materials provided with the distribution; 2111420Sdavid.guillen@arm.com * neither the name of the copyright holders nor the names of its 2211420Sdavid.guillen@arm.com * contributors may be used to endorse or promote products derived from 2311420Sdavid.guillen@arm.com * this software without specific prior written permission. 2411420Sdavid.guillen@arm.com * 2511420Sdavid.guillen@arm.com * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 2611420Sdavid.guillen@arm.com * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 2711420Sdavid.guillen@arm.com * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR 2811420Sdavid.guillen@arm.com * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT 2911420Sdavid.guillen@arm.com * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 3011420Sdavid.guillen@arm.com * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT 3111420Sdavid.guillen@arm.com * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 3211420Sdavid.guillen@arm.com * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 3311420Sdavid.guillen@arm.com * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 3411420Sdavid.guillen@arm.com * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 3511420Sdavid.guillen@arm.com * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 3611420Sdavid.guillen@arm.com * 3711420Sdavid.guillen@arm.com * Authors: David Guillen Fandos 3811420Sdavid.guillen@arm.com */ 3911420Sdavid.guillen@arm.com 4011420Sdavid.guillen@arm.com#ifndef __SIM_THERMAL_MODEL_HH__ 4111420Sdavid.guillen@arm.com#define __SIM_THERMAL_MODEL_HH__ 4211420Sdavid.guillen@arm.com 4311420Sdavid.guillen@arm.com#include <vector> 4411420Sdavid.guillen@arm.com 4511420Sdavid.guillen@arm.com#include "base/statistics.hh" 4611420Sdavid.guillen@arm.com#include "params/ThermalCapacitor.hh" 4711420Sdavid.guillen@arm.com#include "params/ThermalModel.hh" 4811420Sdavid.guillen@arm.com#include "params/ThermalReference.hh" 4911420Sdavid.guillen@arm.com#include "params/ThermalResistor.hh" 5011420Sdavid.guillen@arm.com#include "sim/clocked_object.hh" 5111420Sdavid.guillen@arm.com#include "sim/power/thermal_entity.hh" 5211420Sdavid.guillen@arm.com#include "sim/sim_object.hh" 5311420Sdavid.guillen@arm.com 5411420Sdavid.guillen@arm.comclass ThermalDomain; 5511420Sdavid.guillen@arm.com 5611420Sdavid.guillen@arm.com 5711420Sdavid.guillen@arm.com/** 5811420Sdavid.guillen@arm.com * A ThermalNode is used to connect thermal entities, such as 5911420Sdavid.guillen@arm.com * resistors, capacitors, references and domains. It is the circuital 6011420Sdavid.guillen@arm.com * equivalent to a voltage node. 6111420Sdavid.guillen@arm.com */ 6211420Sdavid.guillen@arm.comclass ThermalNode : public SimObject 6311420Sdavid.guillen@arm.com{ 6411420Sdavid.guillen@arm.com public: 6511420Sdavid.guillen@arm.com typedef SimObjectParams Params; 6611420Sdavid.guillen@arm.com ThermalNode(const Params *p); 6711420Sdavid.guillen@arm.com 6811420Sdavid.guillen@arm.com int id; 6911420Sdavid.guillen@arm.com bool isref; 7011420Sdavid.guillen@arm.com double temp; 7111420Sdavid.guillen@arm.com}; 7211420Sdavid.guillen@arm.com 7311420Sdavid.guillen@arm.com/** 7411420Sdavid.guillen@arm.com * A ThermalResistor is used to model a thermal resistance between two 7511420Sdavid.guillen@arm.com * thermal domains. This domains can be either a reference (fixed temp.) or 7611420Sdavid.guillen@arm.com * a heat producer (power source). 7711420Sdavid.guillen@arm.com */ 7811420Sdavid.guillen@arm.comclass ThermalResistor : public SimObject, public ThermalEntity 7911420Sdavid.guillen@arm.com{ 8011420Sdavid.guillen@arm.com public: 8111420Sdavid.guillen@arm.com typedef ThermalResistorParams Params; 8211420Sdavid.guillen@arm.com ThermalResistor(const Params *p); 8311420Sdavid.guillen@arm.com 8411420Sdavid.guillen@arm.com void serialize(CheckpointOut &cp) const override; 8511420Sdavid.guillen@arm.com void unserialize(CheckpointIn &cp) override; 8611420Sdavid.guillen@arm.com 8711420Sdavid.guillen@arm.com void setNodes(ThermalNode * n1, ThermalNode * n2) { 8811420Sdavid.guillen@arm.com node1 = n1; 8911420Sdavid.guillen@arm.com node2 = n2; 9011420Sdavid.guillen@arm.com } 9111420Sdavid.guillen@arm.com 9211420Sdavid.guillen@arm.com LinearEquation getEquation(ThermalNode * tn, unsigned n, 9311442Sandreas.hansson@arm.com double step) const override; 9411420Sdavid.guillen@arm.com 9511420Sdavid.guillen@arm.com private: 9611420Sdavid.guillen@arm.com /* Resistance value in K/W */ 9711420Sdavid.guillen@arm.com double _resistance; 9811420Sdavid.guillen@arm.com /* Nodes connected to the resistor */ 9911420Sdavid.guillen@arm.com ThermalNode * node1, * node2; 10011420Sdavid.guillen@arm.com}; 10111420Sdavid.guillen@arm.com 10211420Sdavid.guillen@arm.com/** 10311420Sdavid.guillen@arm.com * A ThermalCapacitor is used to model a thermal capacitance between two 10411420Sdavid.guillen@arm.com * thermal domains. This domains can be either a reference (fixed temp.) or 10511420Sdavid.guillen@arm.com * a heat producer (power source). 10611420Sdavid.guillen@arm.com */ 10711420Sdavid.guillen@arm.comclass ThermalCapacitor : public SimObject, public ThermalEntity 10811420Sdavid.guillen@arm.com{ 10911420Sdavid.guillen@arm.com public: 11011420Sdavid.guillen@arm.com typedef ThermalCapacitorParams Params; 11111420Sdavid.guillen@arm.com ThermalCapacitor(const Params *p); 11211420Sdavid.guillen@arm.com 11311420Sdavid.guillen@arm.com void serialize(CheckpointOut &cp) const override; 11411420Sdavid.guillen@arm.com void unserialize(CheckpointIn &cp) override; 11511420Sdavid.guillen@arm.com 11611420Sdavid.guillen@arm.com LinearEquation getEquation(ThermalNode * tn, unsigned n, 11711442Sandreas.hansson@arm.com double step) const override; 11811420Sdavid.guillen@arm.com 11911420Sdavid.guillen@arm.com void setNodes(ThermalNode * n1, ThermalNode * n2) { 12011420Sdavid.guillen@arm.com node1 = n1; 12111420Sdavid.guillen@arm.com node2 = n2; 12211420Sdavid.guillen@arm.com } 12311420Sdavid.guillen@arm.com 12411420Sdavid.guillen@arm.com private: 12511420Sdavid.guillen@arm.com /* Capacitance value in J/K */ 12611420Sdavid.guillen@arm.com double _capacitance; 12711420Sdavid.guillen@arm.com /* Nodes connected to the resistor */ 12811420Sdavid.guillen@arm.com ThermalNode * node1, * node2; 12911420Sdavid.guillen@arm.com}; 13011420Sdavid.guillen@arm.com 13111420Sdavid.guillen@arm.com/** 13211420Sdavid.guillen@arm.com * A ThermalReference is a thermal domain with fixed temperature. 13311420Sdavid.guillen@arm.com * It's the homologue to the voltage source in a circuit. 13411420Sdavid.guillen@arm.com */ 13511420Sdavid.guillen@arm.comclass ThermalReference : public SimObject, public ThermalEntity 13611420Sdavid.guillen@arm.com{ 13711420Sdavid.guillen@arm.com public: 13811420Sdavid.guillen@arm.com typedef ThermalReferenceParams Params; 13911420Sdavid.guillen@arm.com ThermalReference(const Params *p); 14011420Sdavid.guillen@arm.com 14111420Sdavid.guillen@arm.com void setNode(ThermalNode * n) { 14211420Sdavid.guillen@arm.com node = n; 14311420Sdavid.guillen@arm.com } 14411420Sdavid.guillen@arm.com 14511420Sdavid.guillen@arm.com LinearEquation getEquation(ThermalNode * tn, unsigned n, 14611442Sandreas.hansson@arm.com double step) const override; 14711420Sdavid.guillen@arm.com 14811420Sdavid.guillen@arm.com void serialize(CheckpointOut &cp) const override; 14911420Sdavid.guillen@arm.com void unserialize(CheckpointIn &cp) override; 15011420Sdavid.guillen@arm.com 15111420Sdavid.guillen@arm.com /* Fixed temperature value in centigrate degrees */ 15211420Sdavid.guillen@arm.com double _temperature; 15311420Sdavid.guillen@arm.com /* Nodes connected to the resistor */ 15411420Sdavid.guillen@arm.com ThermalNode * node; 15511420Sdavid.guillen@arm.com}; 15611420Sdavid.guillen@arm.com 15711420Sdavid.guillen@arm.com 15811420Sdavid.guillen@arm.com/** 15911420Sdavid.guillen@arm.com * A ThermalModel is the element which ties all thermal objects 16011420Sdavid.guillen@arm.com * together and provides the thermal solver to the system. 16111420Sdavid.guillen@arm.com * It is reponsible for updating temperature for all Thermal 16211420Sdavid.guillen@arm.com * Domains over time by reading power from simobjects. 16311420Sdavid.guillen@arm.com */ 16411420Sdavid.guillen@arm.comclass ThermalModel : public ClockedObject 16511420Sdavid.guillen@arm.com{ 16611420Sdavid.guillen@arm.com public: 16711420Sdavid.guillen@arm.com typedef ThermalModelParams Params; 16811420Sdavid.guillen@arm.com ThermalModel(const Params *p); 16911420Sdavid.guillen@arm.com 17011420Sdavid.guillen@arm.com void addDomain(ThermalDomain * d); 17111420Sdavid.guillen@arm.com void addReference(ThermalReference * r); 17211420Sdavid.guillen@arm.com void addCapacitor(ThermalCapacitor * c); 17311420Sdavid.guillen@arm.com void addResistor(ThermalResistor * r); 17411420Sdavid.guillen@arm.com 17511420Sdavid.guillen@arm.com void addNode(ThermalNode * n) { nodes.push_back(n); } 17611420Sdavid.guillen@arm.com 17711420Sdavid.guillen@arm.com double getTemp() const; 17811420Sdavid.guillen@arm.com 17911442Sandreas.hansson@arm.com void startup() override; 18011420Sdavid.guillen@arm.com void doStep(); 18111420Sdavid.guillen@arm.com 18211420Sdavid.guillen@arm.com void serialize(CheckpointOut &cp) const override; 18311420Sdavid.guillen@arm.com void unserialize(CheckpointIn &cp) override; 18411420Sdavid.guillen@arm.com private: 18511420Sdavid.guillen@arm.com 18611420Sdavid.guillen@arm.com /* Keep track of all components used for the thermal model */ 18711420Sdavid.guillen@arm.com std::vector <ThermalDomain *> domains; 18811420Sdavid.guillen@arm.com std::vector <ThermalReference *> references; 18911420Sdavid.guillen@arm.com std::vector <ThermalCapacitor *> capacitors; 19011420Sdavid.guillen@arm.com std::vector <ThermalResistor *> resistors; 19111420Sdavid.guillen@arm.com 19211420Sdavid.guillen@arm.com std::vector <ThermalEntity *> entities; 19311420Sdavid.guillen@arm.com 19411420Sdavid.guillen@arm.com /* Keep a list of the instantiated nodes */ 19511420Sdavid.guillen@arm.com std::vector <ThermalNode*> nodes; 19611420Sdavid.guillen@arm.com std::vector <ThermalNode*> eq_nodes; 19711420Sdavid.guillen@arm.com 19811420Sdavid.guillen@arm.com /** Stepping event to update the model values */ 19911420Sdavid.guillen@arm.com EventWrapper<ThermalModel, &ThermalModel::doStep> stepEvent; 20011420Sdavid.guillen@arm.com 20111420Sdavid.guillen@arm.com /** Step in seconds for thermal updates */ 20211420Sdavid.guillen@arm.com double _step; 20311420Sdavid.guillen@arm.com 20411420Sdavid.guillen@arm.com}; 20511420Sdavid.guillen@arm.com 20611420Sdavid.guillen@arm.com#endif 207