1/* Copyright (c) 2012 Massachusetts Institute of Technology
2 *
3 * Permission is hereby granted, free of charge, to any person obtaining a copy
4 * of this software and associated documentation files (the "Software"), to deal
5 * in the Software without restriction, including without limitation the rights
6 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
7 * copies of the Software, and to permit persons to whom the Software is
8 * furnished to do so, subject to the following conditions:
9 *
10 * The above copyright notice and this permission notice shall be included in
11 * all copies or substantial portions of the Software.
12 *
13 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
14 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
15 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
16 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
17 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
18 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
19 * THE SOFTWARE.
20 */
21
22#ifndef __DSENT_MODEL_STD_CELLS_STDCELL_H__
23#define __DSENT_MODEL_STD_CELLS_STDCELL_H__
24
25#include "util/CommonType.h"
26#include "model/ElectricalModel.h"
27
28namespace DSENT
29{
30    class StdCell : public ElectricalModel
31    {
32        public:
33            StdCell(const String& instance_name_, const TechModel* tech_model_);
34            virtual ~StdCell();
35
36        public:
37            // Set a list of parameters needed to construct model
38            virtual void initParameters();
39            // Set a list of properties needed to update model
40            virtual void initProperties();
41
42            // Get PMOS to NMOS ratio
43            double getPToNRatio() const;
44            void setPToNRatio(double p_to_n_ratio_);
45            // Get height of the standard cell taken by active transistors
46            double getActiveHeight() const;
47            void setActiveHeight(double active_height_);
48            // Get total height of the standard cell including overheads
49            double getTotalHeight() const;
50            void setTotalHeight(double total_height_);
51
52            // Construct the full model of the standard cell and cache
53            // its contents to use for future copies of the standard cell
54            virtual void cacheStdCell(StdCellLib* cell_lib_, double drive_strength_) = 0;
55
56        protected:
57            // Build the model, note that this is only available if the
58            // standard cell has been cached (via cacheStdCellModel)
59            virtual void constructModel() = 0;
60            virtual void updateModel() = 0;
61
62        private:
63            // The PMOS to NMOS ratio
64            double m_p_to_n_ratio_;
65            // The height of the standard cell taken by active transitors
66            double m_active_height_;
67            // The total height of the standard cell including overheads
68            double m_total_height_;
69
70    }; // class StdCell
71} // namespace DSENT
72
73#endif // __DSENT_MODEL_STD_CELLS_STDCELL_H__
74
75