params.py revision 7743
13101Sstever@eecs.umich.edu# Copyright (c) 2004-2006 The Regents of The University of Michigan 27534Ssteve.reinhardt@amd.com# Copyright (c) 2010 Advanced Micro Devices, Inc. 33101Sstever@eecs.umich.edu# All rights reserved. 43101Sstever@eecs.umich.edu# 53101Sstever@eecs.umich.edu# Redistribution and use in source and binary forms, with or without 63101Sstever@eecs.umich.edu# modification, are permitted provided that the following conditions are 73101Sstever@eecs.umich.edu# met: redistributions of source code must retain the above copyright 83101Sstever@eecs.umich.edu# notice, this list of conditions and the following disclaimer; 93101Sstever@eecs.umich.edu# redistributions in binary form must reproduce the above copyright 103101Sstever@eecs.umich.edu# notice, this list of conditions and the following disclaimer in the 113101Sstever@eecs.umich.edu# documentation and/or other materials provided with the distribution; 123101Sstever@eecs.umich.edu# neither the name of the copyright holders nor the names of its 133101Sstever@eecs.umich.edu# contributors may be used to endorse or promote products derived from 143101Sstever@eecs.umich.edu# this software without specific prior written permission. 153101Sstever@eecs.umich.edu# 163101Sstever@eecs.umich.edu# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 173101Sstever@eecs.umich.edu# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 183101Sstever@eecs.umich.edu# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR 193101Sstever@eecs.umich.edu# A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT 203101Sstever@eecs.umich.edu# OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 213101Sstever@eecs.umich.edu# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT 223101Sstever@eecs.umich.edu# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 233101Sstever@eecs.umich.edu# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 243101Sstever@eecs.umich.edu# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 253101Sstever@eecs.umich.edu# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 263101Sstever@eecs.umich.edu# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 273101Sstever@eecs.umich.edu# 283101Sstever@eecs.umich.edu# Authors: Steve Reinhardt 293101Sstever@eecs.umich.edu# Nathan Binkert 303101Sstever@eecs.umich.edu 313101Sstever@eecs.umich.edu##################################################################### 323101Sstever@eecs.umich.edu# 333101Sstever@eecs.umich.edu# Parameter description classes 343101Sstever@eecs.umich.edu# 353101Sstever@eecs.umich.edu# The _params dictionary in each class maps parameter names to either 363101Sstever@eecs.umich.edu# a Param or a VectorParam object. These objects contain the 373101Sstever@eecs.umich.edu# parameter description string, the parameter type, and the default 383101Sstever@eecs.umich.edu# value (if any). The convert() method on these objects is used to 393101Sstever@eecs.umich.edu# force whatever value is assigned to the parameter to the appropriate 403101Sstever@eecs.umich.edu# type. 413101Sstever@eecs.umich.edu# 423101Sstever@eecs.umich.edu# Note that the default values are loaded into the class's attribute 433101Sstever@eecs.umich.edu# space when the parameter dictionary is initialized (in 443101Sstever@eecs.umich.edu# MetaSimObject._new_param()); after that point they aren't used. 453101Sstever@eecs.umich.edu# 463101Sstever@eecs.umich.edu##################################################################### 473101Sstever@eecs.umich.edu 483885Sbinkertn@umich.eduimport copy 493885Sbinkertn@umich.eduimport datetime 504762Snate@binkert.orgimport re 513885Sbinkertn@umich.eduimport sys 523885Sbinkertn@umich.eduimport time 537528Ssteve.reinhardt@amd.comimport math 543885Sbinkertn@umich.edu 554380Sbinkertn@umich.eduimport proxy 564167Sbinkertn@umich.eduimport ticks 573102Sstever@eecs.umich.edufrom util import * 583101Sstever@eecs.umich.edu 594762Snate@binkert.orgdef isSimObject(*args, **kwargs): 604762Snate@binkert.org return SimObject.isSimObject(*args, **kwargs) 614762Snate@binkert.org 624762Snate@binkert.orgdef isSimObjectSequence(*args, **kwargs): 634762Snate@binkert.org return SimObject.isSimObjectSequence(*args, **kwargs) 644762Snate@binkert.org 654762Snate@binkert.orgdef isSimObjectClass(*args, **kwargs): 664762Snate@binkert.org return SimObject.isSimObjectClass(*args, **kwargs) 674762Snate@binkert.org 685033Smilesck@eecs.umich.eduallParams = {} 695033Smilesck@eecs.umich.edu 705033Smilesck@eecs.umich.educlass MetaParamValue(type): 715033Smilesck@eecs.umich.edu def __new__(mcls, name, bases, dct): 725033Smilesck@eecs.umich.edu cls = super(MetaParamValue, mcls).__new__(mcls, name, bases, dct) 735033Smilesck@eecs.umich.edu assert name not in allParams 745033Smilesck@eecs.umich.edu allParams[name] = cls 755033Smilesck@eecs.umich.edu return cls 765033Smilesck@eecs.umich.edu 775033Smilesck@eecs.umich.edu 783101Sstever@eecs.umich.edu# Dummy base class to identify types that are legitimate for SimObject 793101Sstever@eecs.umich.edu# parameters. 803101Sstever@eecs.umich.educlass ParamValue(object): 815033Smilesck@eecs.umich.edu __metaclass__ = MetaParamValue 823101Sstever@eecs.umich.edu 837673Snate@binkert.org @classmethod 847673Snate@binkert.org def cxx_predecls(cls, code): 857673Snate@binkert.org pass 867673Snate@binkert.org 877673Snate@binkert.org @classmethod 887673Snate@binkert.org def swig_predecls(cls, code): 897673Snate@binkert.org pass 903101Sstever@eecs.umich.edu 913101Sstever@eecs.umich.edu # default for printing to .ini file is regular string conversion. 923101Sstever@eecs.umich.edu # will be overridden in some cases 933101Sstever@eecs.umich.edu def ini_str(self): 943101Sstever@eecs.umich.edu return str(self) 953101Sstever@eecs.umich.edu 963101Sstever@eecs.umich.edu # allows us to blithely call unproxy() on things without checking 973101Sstever@eecs.umich.edu # if they're really proxies or not 983101Sstever@eecs.umich.edu def unproxy(self, base): 993101Sstever@eecs.umich.edu return self 1003101Sstever@eecs.umich.edu 1013101Sstever@eecs.umich.edu# Regular parameter description. 1023101Sstever@eecs.umich.educlass ParamDesc(object): 1036656Snate@binkert.org file_ext = 'ptype' 1046656Snate@binkert.org 1053101Sstever@eecs.umich.edu def __init__(self, ptype_str, ptype, *args, **kwargs): 1063101Sstever@eecs.umich.edu self.ptype_str = ptype_str 1073101Sstever@eecs.umich.edu # remember ptype only if it is provided 1083101Sstever@eecs.umich.edu if ptype != None: 1093101Sstever@eecs.umich.edu self.ptype = ptype 1103101Sstever@eecs.umich.edu 1113101Sstever@eecs.umich.edu if args: 1123101Sstever@eecs.umich.edu if len(args) == 1: 1133101Sstever@eecs.umich.edu self.desc = args[0] 1143101Sstever@eecs.umich.edu elif len(args) == 2: 1153101Sstever@eecs.umich.edu self.default = args[0] 1163101Sstever@eecs.umich.edu self.desc = args[1] 1173101Sstever@eecs.umich.edu else: 1183101Sstever@eecs.umich.edu raise TypeError, 'too many arguments' 1193101Sstever@eecs.umich.edu 1203101Sstever@eecs.umich.edu if kwargs.has_key('desc'): 1213101Sstever@eecs.umich.edu assert(not hasattr(self, 'desc')) 1223101Sstever@eecs.umich.edu self.desc = kwargs['desc'] 1233101Sstever@eecs.umich.edu del kwargs['desc'] 1243101Sstever@eecs.umich.edu 1253101Sstever@eecs.umich.edu if kwargs.has_key('default'): 1263101Sstever@eecs.umich.edu assert(not hasattr(self, 'default')) 1273101Sstever@eecs.umich.edu self.default = kwargs['default'] 1283101Sstever@eecs.umich.edu del kwargs['default'] 1293101Sstever@eecs.umich.edu 1303101Sstever@eecs.umich.edu if kwargs: 1313101Sstever@eecs.umich.edu raise TypeError, 'extra unknown kwargs %s' % kwargs 1323101Sstever@eecs.umich.edu 1333101Sstever@eecs.umich.edu if not hasattr(self, 'desc'): 1343101Sstever@eecs.umich.edu raise TypeError, 'desc attribute missing' 1353101Sstever@eecs.umich.edu 1363101Sstever@eecs.umich.edu def __getattr__(self, attr): 1373101Sstever@eecs.umich.edu if attr == 'ptype': 1385033Smilesck@eecs.umich.edu ptype = SimObject.allClasses[self.ptype_str] 1396656Snate@binkert.org assert isSimObjectClass(ptype) 1405033Smilesck@eecs.umich.edu self.ptype = ptype 1415033Smilesck@eecs.umich.edu return ptype 1425033Smilesck@eecs.umich.edu 1433101Sstever@eecs.umich.edu raise AttributeError, "'%s' object has no attribute '%s'" % \ 1443101Sstever@eecs.umich.edu (type(self).__name__, attr) 1453101Sstever@eecs.umich.edu 1463101Sstever@eecs.umich.edu def convert(self, value): 1473101Sstever@eecs.umich.edu if isinstance(value, proxy.BaseProxy): 1483101Sstever@eecs.umich.edu value.set_param_desc(self) 1493101Sstever@eecs.umich.edu return value 1503101Sstever@eecs.umich.edu if not hasattr(self, 'ptype') and isNullPointer(value): 1513101Sstever@eecs.umich.edu # deferred evaluation of SimObject; continue to defer if 1523101Sstever@eecs.umich.edu # we're just assigning a null pointer 1533101Sstever@eecs.umich.edu return value 1543101Sstever@eecs.umich.edu if isinstance(value, self.ptype): 1553101Sstever@eecs.umich.edu return value 1563102Sstever@eecs.umich.edu if isNullPointer(value) and isSimObjectClass(self.ptype): 1573101Sstever@eecs.umich.edu return value 1583101Sstever@eecs.umich.edu return self.ptype(value) 1593101Sstever@eecs.umich.edu 1607673Snate@binkert.org def cxx_predecls(self, code): 1617673Snate@binkert.org self.ptype.cxx_predecls(code) 1623101Sstever@eecs.umich.edu 1637673Snate@binkert.org def swig_predecls(self, code): 1647673Snate@binkert.org self.ptype.swig_predecls(code) 1653101Sstever@eecs.umich.edu 1667673Snate@binkert.org def cxx_decl(self, code): 1677673Snate@binkert.org code('${{self.ptype.cxx_type}} ${{self.name}};') 1683101Sstever@eecs.umich.edu 1693101Sstever@eecs.umich.edu# Vector-valued parameter description. Just like ParamDesc, except 1703101Sstever@eecs.umich.edu# that the value is a vector (list) of the specified type instead of a 1713101Sstever@eecs.umich.edu# single value. 1723101Sstever@eecs.umich.edu 1733101Sstever@eecs.umich.educlass VectorParamValue(list): 1745033Smilesck@eecs.umich.edu __metaclass__ = MetaParamValue 1755475Snate@binkert.org def __setattr__(self, attr, value): 1765475Snate@binkert.org raise AttributeError, \ 1775475Snate@binkert.org "Not allowed to set %s on '%s'" % (attr, type(self).__name__) 1785475Snate@binkert.org 1793101Sstever@eecs.umich.edu def ini_str(self): 1803101Sstever@eecs.umich.edu return ' '.join([v.ini_str() for v in self]) 1813101Sstever@eecs.umich.edu 1824762Snate@binkert.org def getValue(self): 1834762Snate@binkert.org return [ v.getValue() for v in self ] 1844762Snate@binkert.org 1853101Sstever@eecs.umich.edu def unproxy(self, base): 1863101Sstever@eecs.umich.edu return [v.unproxy(base) for v in self] 1873101Sstever@eecs.umich.edu 1887528Ssteve.reinhardt@amd.comclass SimObjectVector(VectorParamValue): 1897528Ssteve.reinhardt@amd.com # support clone operation 1907528Ssteve.reinhardt@amd.com def __call__(self, **kwargs): 1917528Ssteve.reinhardt@amd.com return SimObjectVector([v(**kwargs) for v in self]) 1927528Ssteve.reinhardt@amd.com 1937528Ssteve.reinhardt@amd.com def clear_parent(self, old_parent): 1943101Sstever@eecs.umich.edu for v in self: 1957528Ssteve.reinhardt@amd.com v.clear_parent(old_parent) 1967528Ssteve.reinhardt@amd.com 1977528Ssteve.reinhardt@amd.com def set_parent(self, parent, name): 1987528Ssteve.reinhardt@amd.com if len(self) == 1: 1997528Ssteve.reinhardt@amd.com self[0].set_parent(parent, name) 2007528Ssteve.reinhardt@amd.com else: 2017528Ssteve.reinhardt@amd.com width = int(math.ceil(math.log(len(self))/math.log(10))) 2027528Ssteve.reinhardt@amd.com for i,v in enumerate(self): 2037528Ssteve.reinhardt@amd.com v.set_parent(parent, "%s%0*d" % (name, width, i)) 2047528Ssteve.reinhardt@amd.com 2057528Ssteve.reinhardt@amd.com def get_parent(self): 2067528Ssteve.reinhardt@amd.com parent_set = set(v._parent for v in self) 2077528Ssteve.reinhardt@amd.com if len(parent_set) != 1: 2087528Ssteve.reinhardt@amd.com raise RuntimeError, \ 2097528Ssteve.reinhardt@amd.com "SimObjectVector elements have inconsistent parent value." 2107528Ssteve.reinhardt@amd.com return parent_set.pop() 2117528Ssteve.reinhardt@amd.com 2127528Ssteve.reinhardt@amd.com # return 'cpu0 cpu1' etc. for print_ini() 2137528Ssteve.reinhardt@amd.com def get_name(self): 2147528Ssteve.reinhardt@amd.com return ' '.join([v._name for v in self]) 2157528Ssteve.reinhardt@amd.com 2167528Ssteve.reinhardt@amd.com # By iterating through the constituent members of the vector here 2177528Ssteve.reinhardt@amd.com # we can nicely handle iterating over all a SimObject's children 2187528Ssteve.reinhardt@amd.com # without having to provide lots of special functions on 2197528Ssteve.reinhardt@amd.com # SimObjectVector directly. 2207528Ssteve.reinhardt@amd.com def descendants(self): 2217528Ssteve.reinhardt@amd.com for v in self: 2227528Ssteve.reinhardt@amd.com for obj in v.descendants(): 2237528Ssteve.reinhardt@amd.com yield obj 2243101Sstever@eecs.umich.edu 2253101Sstever@eecs.umich.educlass VectorParamDesc(ParamDesc): 2266656Snate@binkert.org file_ext = 'vptype' 2276656Snate@binkert.org 2283101Sstever@eecs.umich.edu # Convert assigned value to appropriate type. If the RHS is not a 2293101Sstever@eecs.umich.edu # list or tuple, it generates a single-element list. 2303101Sstever@eecs.umich.edu def convert(self, value): 2313101Sstever@eecs.umich.edu if isinstance(value, (list, tuple)): 2323101Sstever@eecs.umich.edu # list: coerce each element into new list 2333101Sstever@eecs.umich.edu tmp_list = [ ParamDesc.convert(self, v) for v in value ] 2343101Sstever@eecs.umich.edu else: 2354762Snate@binkert.org # singleton: coerce to a single-element list 2364762Snate@binkert.org tmp_list = [ ParamDesc.convert(self, value) ] 2374762Snate@binkert.org 2384762Snate@binkert.org if isSimObjectSequence(tmp_list): 2397528Ssteve.reinhardt@amd.com return SimObjectVector(tmp_list) 2404762Snate@binkert.org else: 2414762Snate@binkert.org return VectorParamValue(tmp_list) 2424762Snate@binkert.org 2437673Snate@binkert.org def swig_predecls(self, code): 2447677Snate@binkert.org code('%import "vptype_${{self.ptype_str}}.i"') 2454762Snate@binkert.org 2467673Snate@binkert.org def swig_decl(self, code): 2477675Snate@binkert.org code('%{') 2487675Snate@binkert.org self.ptype.cxx_predecls(code) 2497675Snate@binkert.org code('%}') 2507675Snate@binkert.org code() 2517675Snate@binkert.org self.ptype.swig_predecls(code) 2527675Snate@binkert.org code() 2537673Snate@binkert.org code('%include "std_vector.i"') 2547675Snate@binkert.org code() 2557675Snate@binkert.org 2567675Snate@binkert.org ptype = self.ptype_str 2577675Snate@binkert.org cxx_type = self.ptype.cxx_type 2587675Snate@binkert.org 2597673Snate@binkert.org code('''\ 2607675Snate@binkert.org%typemap(in) std::vector< $cxx_type >::value_type { 2617675Snate@binkert.org if (SWIG_ConvertPtr($$input, (void **)&$$1, $$1_descriptor, 0) == -1) { 2627675Snate@binkert.org if (SWIG_ConvertPtr($$input, (void **)&$$1, 2637675Snate@binkert.org $$descriptor($cxx_type), 0) == -1) { 2647675Snate@binkert.org return NULL; 2657675Snate@binkert.org } 2667675Snate@binkert.org } 2677675Snate@binkert.org} 2687675Snate@binkert.org 2697675Snate@binkert.org%typemap(in) std::vector< $cxx_type >::value_type * { 2707675Snate@binkert.org if (SWIG_ConvertPtr($$input, (void **)&$$1, $$1_descriptor, 0) == -1) { 2717675Snate@binkert.org if (SWIG_ConvertPtr($$input, (void **)&$$1, 2727675Snate@binkert.org $$descriptor($cxx_type *), 0) == -1) { 2737675Snate@binkert.org return NULL; 2747675Snate@binkert.org } 2757675Snate@binkert.org } 2767673Snate@binkert.org} 2777673Snate@binkert.org''') 2783101Sstever@eecs.umich.edu 2797675Snate@binkert.org code('%template(vector_$ptype) std::vector< $cxx_type >;') 2807675Snate@binkert.org 2817673Snate@binkert.org def cxx_predecls(self, code): 2827673Snate@binkert.org code('#include <vector>') 2837673Snate@binkert.org self.ptype.cxx_predecls(code) 2843101Sstever@eecs.umich.edu 2857673Snate@binkert.org def cxx_decl(self, code): 2867673Snate@binkert.org code('std::vector< ${{self.ptype.cxx_type}} > ${{self.name}};') 2873101Sstever@eecs.umich.edu 2883101Sstever@eecs.umich.educlass ParamFactory(object): 2893101Sstever@eecs.umich.edu def __init__(self, param_desc_class, ptype_str = None): 2903101Sstever@eecs.umich.edu self.param_desc_class = param_desc_class 2913101Sstever@eecs.umich.edu self.ptype_str = ptype_str 2923101Sstever@eecs.umich.edu 2933101Sstever@eecs.umich.edu def __getattr__(self, attr): 2943101Sstever@eecs.umich.edu if self.ptype_str: 2953101Sstever@eecs.umich.edu attr = self.ptype_str + '.' + attr 2963101Sstever@eecs.umich.edu return ParamFactory(self.param_desc_class, attr) 2973101Sstever@eecs.umich.edu 2983101Sstever@eecs.umich.edu # E.g., Param.Int(5, "number of widgets") 2993101Sstever@eecs.umich.edu def __call__(self, *args, **kwargs): 3003101Sstever@eecs.umich.edu ptype = None 3013101Sstever@eecs.umich.edu try: 3025033Smilesck@eecs.umich.edu ptype = allParams[self.ptype_str] 3035033Smilesck@eecs.umich.edu except KeyError: 3043101Sstever@eecs.umich.edu # if name isn't defined yet, assume it's a SimObject, and 3053101Sstever@eecs.umich.edu # try to resolve it later 3063101Sstever@eecs.umich.edu pass 3073101Sstever@eecs.umich.edu return self.param_desc_class(self.ptype_str, ptype, *args, **kwargs) 3083101Sstever@eecs.umich.edu 3093101Sstever@eecs.umich.eduParam = ParamFactory(ParamDesc) 3103101Sstever@eecs.umich.eduVectorParam = ParamFactory(VectorParamDesc) 3113101Sstever@eecs.umich.edu 3123101Sstever@eecs.umich.edu##################################################################### 3133101Sstever@eecs.umich.edu# 3143101Sstever@eecs.umich.edu# Parameter Types 3153101Sstever@eecs.umich.edu# 3163101Sstever@eecs.umich.edu# Though native Python types could be used to specify parameter types 3173101Sstever@eecs.umich.edu# (the 'ptype' field of the Param and VectorParam classes), it's more 3183101Sstever@eecs.umich.edu# flexible to define our own set of types. This gives us more control 3193101Sstever@eecs.umich.edu# over how Python expressions are converted to values (via the 3203101Sstever@eecs.umich.edu# __init__() constructor) and how these values are printed out (via 3213101Sstever@eecs.umich.edu# the __str__() conversion method). 3223101Sstever@eecs.umich.edu# 3233101Sstever@eecs.umich.edu##################################################################### 3243101Sstever@eecs.umich.edu 3253101Sstever@eecs.umich.edu# String-valued parameter. Just mixin the ParamValue class with the 3263101Sstever@eecs.umich.edu# built-in str class. 3273101Sstever@eecs.umich.educlass String(ParamValue,str): 3283101Sstever@eecs.umich.edu cxx_type = 'std::string' 3297673Snate@binkert.org 3307673Snate@binkert.org @classmethod 3317673Snate@binkert.org def cxx_predecls(self, code): 3327673Snate@binkert.org code('#include <string>') 3337673Snate@binkert.org 3347673Snate@binkert.org @classmethod 3357673Snate@binkert.org def swig_predecls(cls, code): 3367673Snate@binkert.org code('%include "std_string.i"') 3374762Snate@binkert.org 3384762Snate@binkert.org def getValue(self): 3394762Snate@binkert.org return self 3403101Sstever@eecs.umich.edu 3413101Sstever@eecs.umich.edu# superclass for "numeric" parameter values, to emulate math 3423101Sstever@eecs.umich.edu# operations in a type-safe way. e.g., a Latency times an int returns 3433101Sstever@eecs.umich.edu# a new Latency object. 3443101Sstever@eecs.umich.educlass NumericParamValue(ParamValue): 3453101Sstever@eecs.umich.edu def __str__(self): 3463101Sstever@eecs.umich.edu return str(self.value) 3473101Sstever@eecs.umich.edu 3483101Sstever@eecs.umich.edu def __float__(self): 3493101Sstever@eecs.umich.edu return float(self.value) 3503101Sstever@eecs.umich.edu 3513714Sstever@eecs.umich.edu def __long__(self): 3523714Sstever@eecs.umich.edu return long(self.value) 3533714Sstever@eecs.umich.edu 3543714Sstever@eecs.umich.edu def __int__(self): 3553714Sstever@eecs.umich.edu return int(self.value) 3563714Sstever@eecs.umich.edu 3573101Sstever@eecs.umich.edu # hook for bounds checking 3583101Sstever@eecs.umich.edu def _check(self): 3593101Sstever@eecs.umich.edu return 3603101Sstever@eecs.umich.edu 3613101Sstever@eecs.umich.edu def __mul__(self, other): 3623101Sstever@eecs.umich.edu newobj = self.__class__(self) 3633101Sstever@eecs.umich.edu newobj.value *= other 3643101Sstever@eecs.umich.edu newobj._check() 3653101Sstever@eecs.umich.edu return newobj 3663101Sstever@eecs.umich.edu 3673101Sstever@eecs.umich.edu __rmul__ = __mul__ 3683101Sstever@eecs.umich.edu 3693101Sstever@eecs.umich.edu def __div__(self, other): 3703101Sstever@eecs.umich.edu newobj = self.__class__(self) 3713101Sstever@eecs.umich.edu newobj.value /= other 3723101Sstever@eecs.umich.edu newobj._check() 3733101Sstever@eecs.umich.edu return newobj 3743101Sstever@eecs.umich.edu 3753101Sstever@eecs.umich.edu def __sub__(self, other): 3763101Sstever@eecs.umich.edu newobj = self.__class__(self) 3773101Sstever@eecs.umich.edu newobj.value -= other 3783101Sstever@eecs.umich.edu newobj._check() 3793101Sstever@eecs.umich.edu return newobj 3803101Sstever@eecs.umich.edu 3813101Sstever@eecs.umich.edu# Metaclass for bounds-checked integer parameters. See CheckedInt. 3825033Smilesck@eecs.umich.educlass CheckedIntType(MetaParamValue): 3833101Sstever@eecs.umich.edu def __init__(cls, name, bases, dict): 3843101Sstever@eecs.umich.edu super(CheckedIntType, cls).__init__(name, bases, dict) 3853101Sstever@eecs.umich.edu 3863101Sstever@eecs.umich.edu # CheckedInt is an abstract base class, so we actually don't 3873101Sstever@eecs.umich.edu # want to do any processing on it... the rest of this code is 3883101Sstever@eecs.umich.edu # just for classes that derive from CheckedInt. 3893101Sstever@eecs.umich.edu if name == 'CheckedInt': 3903101Sstever@eecs.umich.edu return 3913101Sstever@eecs.umich.edu 3923101Sstever@eecs.umich.edu if not (hasattr(cls, 'min') and hasattr(cls, 'max')): 3933101Sstever@eecs.umich.edu if not (hasattr(cls, 'size') and hasattr(cls, 'unsigned')): 3943101Sstever@eecs.umich.edu panic("CheckedInt subclass %s must define either\n" \ 3955822Ssaidi@eecs.umich.edu " 'min' and 'max' or 'size' and 'unsigned'\n", 3965822Ssaidi@eecs.umich.edu name); 3973101Sstever@eecs.umich.edu if cls.unsigned: 3983101Sstever@eecs.umich.edu cls.min = 0 3993101Sstever@eecs.umich.edu cls.max = 2 ** cls.size - 1 4003101Sstever@eecs.umich.edu else: 4013101Sstever@eecs.umich.edu cls.min = -(2 ** (cls.size - 1)) 4023101Sstever@eecs.umich.edu cls.max = (2 ** (cls.size - 1)) - 1 4033101Sstever@eecs.umich.edu 4043101Sstever@eecs.umich.edu# Abstract superclass for bounds-checked integer parameters. This 4053101Sstever@eecs.umich.edu# class is subclassed to generate parameter classes with specific 4063101Sstever@eecs.umich.edu# bounds. Initialization of the min and max bounds is done in the 4073101Sstever@eecs.umich.edu# metaclass CheckedIntType.__init__. 4083101Sstever@eecs.umich.educlass CheckedInt(NumericParamValue): 4093101Sstever@eecs.umich.edu __metaclass__ = CheckedIntType 4103101Sstever@eecs.umich.edu 4113101Sstever@eecs.umich.edu def _check(self): 4123101Sstever@eecs.umich.edu if not self.min <= self.value <= self.max: 4133101Sstever@eecs.umich.edu raise TypeError, 'Integer param out of bounds %d < %d < %d' % \ 4143101Sstever@eecs.umich.edu (self.min, self.value, self.max) 4153101Sstever@eecs.umich.edu 4163101Sstever@eecs.umich.edu def __init__(self, value): 4173101Sstever@eecs.umich.edu if isinstance(value, str): 4183102Sstever@eecs.umich.edu self.value = convert.toInteger(value) 4193714Sstever@eecs.umich.edu elif isinstance(value, (int, long, float, NumericParamValue)): 4203101Sstever@eecs.umich.edu self.value = long(value) 4213714Sstever@eecs.umich.edu else: 4223714Sstever@eecs.umich.edu raise TypeError, "Can't convert object of type %s to CheckedInt" \ 4233714Sstever@eecs.umich.edu % type(value).__name__ 4243101Sstever@eecs.umich.edu self._check() 4253101Sstever@eecs.umich.edu 4267673Snate@binkert.org @classmethod 4277673Snate@binkert.org def cxx_predecls(cls, code): 4287673Snate@binkert.org # most derived types require this, so we just do it here once 4297673Snate@binkert.org code('#include "base/types.hh"') 4307673Snate@binkert.org 4317673Snate@binkert.org @classmethod 4327673Snate@binkert.org def swig_predecls(cls, code): 4337673Snate@binkert.org # most derived types require this, so we just do it here once 4347673Snate@binkert.org code('%import "stdint.i"') 4357673Snate@binkert.org code('%import "base/types.hh"') 4367673Snate@binkert.org 4374762Snate@binkert.org def getValue(self): 4384762Snate@binkert.org return long(self.value) 4394762Snate@binkert.org 4403101Sstever@eecs.umich.educlass Int(CheckedInt): cxx_type = 'int'; size = 32; unsigned = False 4413101Sstever@eecs.umich.educlass Unsigned(CheckedInt): cxx_type = 'unsigned'; size = 32; unsigned = True 4423101Sstever@eecs.umich.edu 4433101Sstever@eecs.umich.educlass Int8(CheckedInt): cxx_type = 'int8_t'; size = 8; unsigned = False 4443101Sstever@eecs.umich.educlass UInt8(CheckedInt): cxx_type = 'uint8_t'; size = 8; unsigned = True 4453101Sstever@eecs.umich.educlass Int16(CheckedInt): cxx_type = 'int16_t'; size = 16; unsigned = False 4463101Sstever@eecs.umich.educlass UInt16(CheckedInt): cxx_type = 'uint16_t'; size = 16; unsigned = True 4473101Sstever@eecs.umich.educlass Int32(CheckedInt): cxx_type = 'int32_t'; size = 32; unsigned = False 4483101Sstever@eecs.umich.educlass UInt32(CheckedInt): cxx_type = 'uint32_t'; size = 32; unsigned = True 4493101Sstever@eecs.umich.educlass Int64(CheckedInt): cxx_type = 'int64_t'; size = 64; unsigned = False 4503101Sstever@eecs.umich.educlass UInt64(CheckedInt): cxx_type = 'uint64_t'; size = 64; unsigned = True 4513101Sstever@eecs.umich.edu 4523101Sstever@eecs.umich.educlass Counter(CheckedInt): cxx_type = 'Counter'; size = 64; unsigned = True 4533101Sstever@eecs.umich.educlass Tick(CheckedInt): cxx_type = 'Tick'; size = 64; unsigned = True 4543101Sstever@eecs.umich.educlass TcpPort(CheckedInt): cxx_type = 'uint16_t'; size = 16; unsigned = True 4553101Sstever@eecs.umich.educlass UdpPort(CheckedInt): cxx_type = 'uint16_t'; size = 16; unsigned = True 4563101Sstever@eecs.umich.edu 4573101Sstever@eecs.umich.educlass Percent(CheckedInt): cxx_type = 'int'; min = 0; max = 100 4583101Sstever@eecs.umich.edu 4593101Sstever@eecs.umich.educlass Float(ParamValue, float): 4604446Sbinkertn@umich.edu cxx_type = 'double' 4613101Sstever@eecs.umich.edu 4625468Snate@binkert.org def __init__(self, value): 4635468Snate@binkert.org if isinstance(value, (int, long, float, NumericParamValue, Float)): 4645468Snate@binkert.org self.value = float(value) 4655468Snate@binkert.org else: 4665468Snate@binkert.org raise TypeError, "Can't convert object of type %s to Float" \ 4675468Snate@binkert.org % type(value).__name__ 4685468Snate@binkert.org 4694762Snate@binkert.org def getValue(self): 4704762Snate@binkert.org return float(self.value) 4714762Snate@binkert.org 4723101Sstever@eecs.umich.educlass MemorySize(CheckedInt): 4733101Sstever@eecs.umich.edu cxx_type = 'uint64_t' 4743101Sstever@eecs.umich.edu size = 64 4753101Sstever@eecs.umich.edu unsigned = True 4763101Sstever@eecs.umich.edu def __init__(self, value): 4773101Sstever@eecs.umich.edu if isinstance(value, MemorySize): 4783101Sstever@eecs.umich.edu self.value = value.value 4793101Sstever@eecs.umich.edu else: 4803102Sstever@eecs.umich.edu self.value = convert.toMemorySize(value) 4813101Sstever@eecs.umich.edu self._check() 4823101Sstever@eecs.umich.edu 4833101Sstever@eecs.umich.educlass MemorySize32(CheckedInt): 4844168Sbinkertn@umich.edu cxx_type = 'uint32_t' 4853101Sstever@eecs.umich.edu size = 32 4863101Sstever@eecs.umich.edu unsigned = True 4873101Sstever@eecs.umich.edu def __init__(self, value): 4883101Sstever@eecs.umich.edu if isinstance(value, MemorySize): 4893101Sstever@eecs.umich.edu self.value = value.value 4903101Sstever@eecs.umich.edu else: 4913102Sstever@eecs.umich.edu self.value = convert.toMemorySize(value) 4923101Sstever@eecs.umich.edu self._check() 4933101Sstever@eecs.umich.edu 4943101Sstever@eecs.umich.educlass Addr(CheckedInt): 4953101Sstever@eecs.umich.edu cxx_type = 'Addr' 4963101Sstever@eecs.umich.edu size = 64 4973101Sstever@eecs.umich.edu unsigned = True 4983101Sstever@eecs.umich.edu def __init__(self, value): 4993101Sstever@eecs.umich.edu if isinstance(value, Addr): 5003101Sstever@eecs.umich.edu self.value = value.value 5013101Sstever@eecs.umich.edu else: 5023101Sstever@eecs.umich.edu try: 5033102Sstever@eecs.umich.edu self.value = convert.toMemorySize(value) 5043101Sstever@eecs.umich.edu except TypeError: 5053101Sstever@eecs.umich.edu self.value = long(value) 5063101Sstever@eecs.umich.edu self._check() 5073584Ssaidi@eecs.umich.edu def __add__(self, other): 5083584Ssaidi@eecs.umich.edu if isinstance(other, Addr): 5093584Ssaidi@eecs.umich.edu return self.value + other.value 5103584Ssaidi@eecs.umich.edu else: 5113584Ssaidi@eecs.umich.edu return self.value + other 5123101Sstever@eecs.umich.edu 5133101Sstever@eecs.umich.edu 5145033Smilesck@eecs.umich.educlass MetaRange(MetaParamValue): 5153101Sstever@eecs.umich.edu def __init__(cls, name, bases, dict): 5163101Sstever@eecs.umich.edu super(MetaRange, cls).__init__(name, bases, dict) 5173101Sstever@eecs.umich.edu if name == 'Range': 5183101Sstever@eecs.umich.edu return 5193101Sstever@eecs.umich.edu cls.cxx_type = 'Range< %s >' % cls.type.cxx_type 5203101Sstever@eecs.umich.edu 5213101Sstever@eecs.umich.educlass Range(ParamValue): 5223101Sstever@eecs.umich.edu __metaclass__ = MetaRange 5233101Sstever@eecs.umich.edu type = Int # default; can be overridden in subclasses 5243101Sstever@eecs.umich.edu def __init__(self, *args, **kwargs): 5253101Sstever@eecs.umich.edu def handle_kwargs(self, kwargs): 5263101Sstever@eecs.umich.edu if 'end' in kwargs: 5273101Sstever@eecs.umich.edu self.second = self.type(kwargs.pop('end')) 5283101Sstever@eecs.umich.edu elif 'size' in kwargs: 5293101Sstever@eecs.umich.edu self.second = self.first + self.type(kwargs.pop('size')) - 1 5303101Sstever@eecs.umich.edu else: 5313101Sstever@eecs.umich.edu raise TypeError, "Either end or size must be specified" 5323101Sstever@eecs.umich.edu 5333101Sstever@eecs.umich.edu if len(args) == 0: 5343101Sstever@eecs.umich.edu self.first = self.type(kwargs.pop('start')) 5353101Sstever@eecs.umich.edu handle_kwargs(self, kwargs) 5363101Sstever@eecs.umich.edu 5373101Sstever@eecs.umich.edu elif len(args) == 1: 5383101Sstever@eecs.umich.edu if kwargs: 5393101Sstever@eecs.umich.edu self.first = self.type(args[0]) 5403101Sstever@eecs.umich.edu handle_kwargs(self, kwargs) 5413101Sstever@eecs.umich.edu elif isinstance(args[0], Range): 5423101Sstever@eecs.umich.edu self.first = self.type(args[0].first) 5433101Sstever@eecs.umich.edu self.second = self.type(args[0].second) 5445219Ssaidi@eecs.umich.edu elif isinstance(args[0], (list, tuple)): 5455219Ssaidi@eecs.umich.edu self.first = self.type(args[0][0]) 5465219Ssaidi@eecs.umich.edu self.second = self.type(args[0][1]) 5473101Sstever@eecs.umich.edu else: 5483101Sstever@eecs.umich.edu self.first = self.type(0) 5493101Sstever@eecs.umich.edu self.second = self.type(args[0]) - 1 5503101Sstever@eecs.umich.edu 5513101Sstever@eecs.umich.edu elif len(args) == 2: 5523101Sstever@eecs.umich.edu self.first = self.type(args[0]) 5533101Sstever@eecs.umich.edu self.second = self.type(args[1]) 5543101Sstever@eecs.umich.edu else: 5553101Sstever@eecs.umich.edu raise TypeError, "Too many arguments specified" 5563101Sstever@eecs.umich.edu 5573101Sstever@eecs.umich.edu if kwargs: 5583101Sstever@eecs.umich.edu raise TypeError, "too many keywords: %s" % kwargs.keys() 5593101Sstever@eecs.umich.edu 5603101Sstever@eecs.umich.edu def __str__(self): 5613101Sstever@eecs.umich.edu return '%s:%s' % (self.first, self.second) 5623101Sstever@eecs.umich.edu 5637673Snate@binkert.org @classmethod 5647673Snate@binkert.org def cxx_predecls(cls, code): 5657675Snate@binkert.org cls.type.cxx_predecls(code) 5667673Snate@binkert.org code('#include "base/range.hh"') 5677675Snate@binkert.org 5687675Snate@binkert.org @classmethod 5697675Snate@binkert.org def swig_predecls(cls, code): 5707675Snate@binkert.org cls.type.swig_predecls(code) 5717675Snate@binkert.org code('%import "python/swig/range.i"') 5727673Snate@binkert.org 5733101Sstever@eecs.umich.educlass AddrRange(Range): 5743101Sstever@eecs.umich.edu type = Addr 5757673Snate@binkert.org 5764762Snate@binkert.org def getValue(self): 5777675Snate@binkert.org from m5.internal.range import AddrRange 5784762Snate@binkert.org 5794762Snate@binkert.org value = AddrRange() 5804762Snate@binkert.org value.start = long(self.first) 5814762Snate@binkert.org value.end = long(self.second) 5824762Snate@binkert.org return value 5833101Sstever@eecs.umich.edu 5843101Sstever@eecs.umich.educlass TickRange(Range): 5853101Sstever@eecs.umich.edu type = Tick 5867673Snate@binkert.org 5874762Snate@binkert.org def getValue(self): 5887675Snate@binkert.org from m5.internal.range import TickRange 5894762Snate@binkert.org 5904762Snate@binkert.org value = TickRange() 5914762Snate@binkert.org value.start = long(self.first) 5924762Snate@binkert.org value.end = long(self.second) 5934762Snate@binkert.org return value 5943101Sstever@eecs.umich.edu 5953101Sstever@eecs.umich.edu# Boolean parameter type. Python doesn't let you subclass bool, since 5963101Sstever@eecs.umich.edu# it doesn't want to let you create multiple instances of True and 5973101Sstever@eecs.umich.edu# False. Thus this is a little more complicated than String. 5983101Sstever@eecs.umich.educlass Bool(ParamValue): 5993101Sstever@eecs.umich.edu cxx_type = 'bool' 6003101Sstever@eecs.umich.edu def __init__(self, value): 6013101Sstever@eecs.umich.edu try: 6023102Sstever@eecs.umich.edu self.value = convert.toBool(value) 6033101Sstever@eecs.umich.edu except TypeError: 6043101Sstever@eecs.umich.edu self.value = bool(value) 6053101Sstever@eecs.umich.edu 6064762Snate@binkert.org def getValue(self): 6074762Snate@binkert.org return bool(self.value) 6084762Snate@binkert.org 6093101Sstever@eecs.umich.edu def __str__(self): 6103101Sstever@eecs.umich.edu return str(self.value) 6113101Sstever@eecs.umich.edu 6123101Sstever@eecs.umich.edu def ini_str(self): 6133101Sstever@eecs.umich.edu if self.value: 6143101Sstever@eecs.umich.edu return 'true' 6153101Sstever@eecs.umich.edu return 'false' 6163101Sstever@eecs.umich.edu 6173101Sstever@eecs.umich.edudef IncEthernetAddr(addr, val = 1): 6183101Sstever@eecs.umich.edu bytes = map(lambda x: int(x, 16), addr.split(':')) 6193101Sstever@eecs.umich.edu bytes[5] += val 6203101Sstever@eecs.umich.edu for i in (5, 4, 3, 2, 1): 6213101Sstever@eecs.umich.edu val,rem = divmod(bytes[i], 256) 6223101Sstever@eecs.umich.edu bytes[i] = rem 6233101Sstever@eecs.umich.edu if val == 0: 6243101Sstever@eecs.umich.edu break 6253101Sstever@eecs.umich.edu bytes[i - 1] += val 6263101Sstever@eecs.umich.edu assert(bytes[0] <= 255) 6273101Sstever@eecs.umich.edu return ':'.join(map(lambda x: '%02x' % x, bytes)) 6283101Sstever@eecs.umich.edu 6294380Sbinkertn@umich.edu_NextEthernetAddr = "00:90:00:00:00:01" 6304380Sbinkertn@umich.edudef NextEthernetAddr(): 6314380Sbinkertn@umich.edu global _NextEthernetAddr 6323101Sstever@eecs.umich.edu 6334380Sbinkertn@umich.edu value = _NextEthernetAddr 6344380Sbinkertn@umich.edu _NextEthernetAddr = IncEthernetAddr(_NextEthernetAddr, 1) 6354380Sbinkertn@umich.edu return value 6363101Sstever@eecs.umich.edu 6373101Sstever@eecs.umich.educlass EthernetAddr(ParamValue): 6383101Sstever@eecs.umich.edu cxx_type = 'Net::EthAddr' 6397673Snate@binkert.org 6407673Snate@binkert.org @classmethod 6417673Snate@binkert.org def cxx_predecls(cls, code): 6427673Snate@binkert.org code('#include "base/inet.hh"') 6437673Snate@binkert.org 6447673Snate@binkert.org @classmethod 6457673Snate@binkert.org def swig_predecls(cls, code): 6467673Snate@binkert.org code('%include "python/swig/inet.i"') 6477673Snate@binkert.org 6483101Sstever@eecs.umich.edu def __init__(self, value): 6493101Sstever@eecs.umich.edu if value == NextEthernetAddr: 6503101Sstever@eecs.umich.edu self.value = value 6513101Sstever@eecs.umich.edu return 6523101Sstever@eecs.umich.edu 6533101Sstever@eecs.umich.edu if not isinstance(value, str): 6543101Sstever@eecs.umich.edu raise TypeError, "expected an ethernet address and didn't get one" 6553101Sstever@eecs.umich.edu 6563101Sstever@eecs.umich.edu bytes = value.split(':') 6573101Sstever@eecs.umich.edu if len(bytes) != 6: 6583101Sstever@eecs.umich.edu raise TypeError, 'invalid ethernet address %s' % value 6593101Sstever@eecs.umich.edu 6603101Sstever@eecs.umich.edu for byte in bytes: 6617743Sgblack@eecs.umich.edu if not 0 <= int(byte) <= 0xff: 6623101Sstever@eecs.umich.edu raise TypeError, 'invalid ethernet address %s' % value 6633101Sstever@eecs.umich.edu 6643101Sstever@eecs.umich.edu self.value = value 6653101Sstever@eecs.umich.edu 6663101Sstever@eecs.umich.edu def unproxy(self, base): 6673101Sstever@eecs.umich.edu if self.value == NextEthernetAddr: 6684380Sbinkertn@umich.edu return EthernetAddr(self.value()) 6693101Sstever@eecs.umich.edu return self 6703101Sstever@eecs.umich.edu 6714762Snate@binkert.org def getValue(self): 6727677Snate@binkert.org from m5.internal.params import EthAddr 6734762Snate@binkert.org return EthAddr(self.value) 6744762Snate@binkert.org 6754380Sbinkertn@umich.edu def ini_str(self): 6764380Sbinkertn@umich.edu return self.value 6773101Sstever@eecs.umich.edu 6783932Sbinkertn@umich.edutime_formats = [ "%a %b %d %H:%M:%S %Z %Y", 6793932Sbinkertn@umich.edu "%a %b %d %H:%M:%S %Z %Y", 6803932Sbinkertn@umich.edu "%Y/%m/%d %H:%M:%S", 6813932Sbinkertn@umich.edu "%Y/%m/%d %H:%M", 6823932Sbinkertn@umich.edu "%Y/%m/%d", 6833932Sbinkertn@umich.edu "%m/%d/%Y %H:%M:%S", 6843932Sbinkertn@umich.edu "%m/%d/%Y %H:%M", 6853932Sbinkertn@umich.edu "%m/%d/%Y", 6863932Sbinkertn@umich.edu "%m/%d/%y %H:%M:%S", 6873932Sbinkertn@umich.edu "%m/%d/%y %H:%M", 6883932Sbinkertn@umich.edu "%m/%d/%y"] 6893932Sbinkertn@umich.edu 6903932Sbinkertn@umich.edu 6913885Sbinkertn@umich.edudef parse_time(value): 6923932Sbinkertn@umich.edu from time import gmtime, strptime, struct_time, time 6933932Sbinkertn@umich.edu from datetime import datetime, date 6943885Sbinkertn@umich.edu 6953932Sbinkertn@umich.edu if isinstance(value, struct_time): 6963932Sbinkertn@umich.edu return value 6973932Sbinkertn@umich.edu 6983932Sbinkertn@umich.edu if isinstance(value, (int, long)): 6993932Sbinkertn@umich.edu return gmtime(value) 7003932Sbinkertn@umich.edu 7013932Sbinkertn@umich.edu if isinstance(value, (datetime, date)): 7023932Sbinkertn@umich.edu return value.timetuple() 7033932Sbinkertn@umich.edu 7043932Sbinkertn@umich.edu if isinstance(value, str): 7053932Sbinkertn@umich.edu if value in ('Now', 'Today'): 7063932Sbinkertn@umich.edu return time.gmtime(time.time()) 7073932Sbinkertn@umich.edu 7083932Sbinkertn@umich.edu for format in time_formats: 7093932Sbinkertn@umich.edu try: 7103932Sbinkertn@umich.edu return strptime(value, format) 7113932Sbinkertn@umich.edu except ValueError: 7123932Sbinkertn@umich.edu pass 7133885Sbinkertn@umich.edu 7143885Sbinkertn@umich.edu raise ValueError, "Could not parse '%s' as a time" % value 7153885Sbinkertn@umich.edu 7163885Sbinkertn@umich.educlass Time(ParamValue): 7174762Snate@binkert.org cxx_type = 'tm' 7187673Snate@binkert.org 7197673Snate@binkert.org @classmethod 7207673Snate@binkert.org def cxx_predecls(cls, code): 7217673Snate@binkert.org code('#include <time.h>') 7227673Snate@binkert.org 7237673Snate@binkert.org @classmethod 7247673Snate@binkert.org def swig_predecls(cls, code): 7257673Snate@binkert.org code('%include "python/swig/time.i"') 7267673Snate@binkert.org 7273885Sbinkertn@umich.edu def __init__(self, value): 7283932Sbinkertn@umich.edu self.value = parse_time(value) 7293885Sbinkertn@umich.edu 7304762Snate@binkert.org def getValue(self): 7317677Snate@binkert.org from m5.internal.params import tm 7324762Snate@binkert.org 7334762Snate@binkert.org c_time = tm() 7344762Snate@binkert.org py_time = self.value 7354762Snate@binkert.org 7364762Snate@binkert.org # UNIX is years since 1900 7374762Snate@binkert.org c_time.tm_year = py_time.tm_year - 1900; 7384762Snate@binkert.org 7394762Snate@binkert.org # Python starts at 1, UNIX starts at 0 7404762Snate@binkert.org c_time.tm_mon = py_time.tm_mon - 1; 7414762Snate@binkert.org c_time.tm_mday = py_time.tm_mday; 7424762Snate@binkert.org c_time.tm_hour = py_time.tm_hour; 7434762Snate@binkert.org c_time.tm_min = py_time.tm_min; 7444762Snate@binkert.org c_time.tm_sec = py_time.tm_sec; 7454762Snate@binkert.org 7464762Snate@binkert.org # Python has 0 as Monday, UNIX is 0 as sunday 7474762Snate@binkert.org c_time.tm_wday = py_time.tm_wday + 1 7484762Snate@binkert.org if c_time.tm_wday > 6: 7494762Snate@binkert.org c_time.tm_wday -= 7; 7504762Snate@binkert.org 7514762Snate@binkert.org # Python starts at 1, Unix starts at 0 7524762Snate@binkert.org c_time.tm_yday = py_time.tm_yday - 1; 7534762Snate@binkert.org 7544762Snate@binkert.org return c_time 7554762Snate@binkert.org 7563885Sbinkertn@umich.edu def __str__(self): 7574762Snate@binkert.org return time.asctime(self.value) 7583885Sbinkertn@umich.edu 7593885Sbinkertn@umich.edu def ini_str(self): 7603932Sbinkertn@umich.edu return str(self) 7613885Sbinkertn@umich.edu 7623101Sstever@eecs.umich.edu# Enumerated types are a little more complex. The user specifies the 7633101Sstever@eecs.umich.edu# type as Enum(foo) where foo is either a list or dictionary of 7643101Sstever@eecs.umich.edu# alternatives (typically strings, but not necessarily so). (In the 7653101Sstever@eecs.umich.edu# long run, the integer value of the parameter will be the list index 7663101Sstever@eecs.umich.edu# or the corresponding dictionary value. For now, since we only check 7673101Sstever@eecs.umich.edu# that the alternative is valid and then spit it into a .ini file, 7683101Sstever@eecs.umich.edu# there's not much point in using the dictionary.) 7693101Sstever@eecs.umich.edu 7703101Sstever@eecs.umich.edu# What Enum() must do is generate a new type encapsulating the 7713101Sstever@eecs.umich.edu# provided list/dictionary so that specific values of the parameter 7723101Sstever@eecs.umich.edu# can be instances of that type. We define two hidden internal 7733101Sstever@eecs.umich.edu# classes (_ListEnum and _DictEnum) to serve as base classes, then 7743101Sstever@eecs.umich.edu# derive the new type from the appropriate base class on the fly. 7753101Sstever@eecs.umich.edu 7764762Snate@binkert.orgallEnums = {} 7773101Sstever@eecs.umich.edu# Metaclass for Enum types 7785033Smilesck@eecs.umich.educlass MetaEnum(MetaParamValue): 7794762Snate@binkert.org def __new__(mcls, name, bases, dict): 7804762Snate@binkert.org assert name not in allEnums 7814762Snate@binkert.org 7824762Snate@binkert.org cls = super(MetaEnum, mcls).__new__(mcls, name, bases, dict) 7834762Snate@binkert.org allEnums[name] = cls 7844762Snate@binkert.org return cls 7854762Snate@binkert.org 7863101Sstever@eecs.umich.edu def __init__(cls, name, bases, init_dict): 7873101Sstever@eecs.umich.edu if init_dict.has_key('map'): 7883101Sstever@eecs.umich.edu if not isinstance(cls.map, dict): 7893101Sstever@eecs.umich.edu raise TypeError, "Enum-derived class attribute 'map' " \ 7903101Sstever@eecs.umich.edu "must be of type dict" 7913101Sstever@eecs.umich.edu # build list of value strings from map 7923101Sstever@eecs.umich.edu cls.vals = cls.map.keys() 7933101Sstever@eecs.umich.edu cls.vals.sort() 7943101Sstever@eecs.umich.edu elif init_dict.has_key('vals'): 7953101Sstever@eecs.umich.edu if not isinstance(cls.vals, list): 7963101Sstever@eecs.umich.edu raise TypeError, "Enum-derived class attribute 'vals' " \ 7973101Sstever@eecs.umich.edu "must be of type list" 7983101Sstever@eecs.umich.edu # build string->value map from vals sequence 7993101Sstever@eecs.umich.edu cls.map = {} 8003101Sstever@eecs.umich.edu for idx,val in enumerate(cls.vals): 8013101Sstever@eecs.umich.edu cls.map[val] = idx 8023101Sstever@eecs.umich.edu else: 8033101Sstever@eecs.umich.edu raise TypeError, "Enum-derived class must define "\ 8043101Sstever@eecs.umich.edu "attribute 'map' or 'vals'" 8053101Sstever@eecs.umich.edu 8064762Snate@binkert.org cls.cxx_type = 'Enums::%s' % name 8073101Sstever@eecs.umich.edu 8083101Sstever@eecs.umich.edu super(MetaEnum, cls).__init__(name, bases, init_dict) 8093101Sstever@eecs.umich.edu 8103101Sstever@eecs.umich.edu # Generate C++ class declaration for this enum type. 8113101Sstever@eecs.umich.edu # Note that we wrap the enum in a class/struct to act as a namespace, 8123101Sstever@eecs.umich.edu # so that the enum strings can be brief w/o worrying about collisions. 8137673Snate@binkert.org def cxx_decl(cls, code): 8146654Snate@binkert.org name = cls.__name__ 8157673Snate@binkert.org code('''\ 8167673Snate@binkert.org#ifndef __ENUM__${name}__ 8177673Snate@binkert.org#define __ENUM__${name}__ 8187673Snate@binkert.org 8197673Snate@binkert.orgnamespace Enums { 8207673Snate@binkert.org enum $name { 8217673Snate@binkert.org''') 8227673Snate@binkert.org code.indent(2) 8234762Snate@binkert.org for val in cls.vals: 8247673Snate@binkert.org code('$val = ${{cls.map[val]}},') 8257673Snate@binkert.org code('Num_$name = ${{len(cls.vals)}},') 8267673Snate@binkert.org code.dedent(2) 8277673Snate@binkert.org code('''\ 8287673Snate@binkert.org }; 8297673Snate@binkert.orgextern const char *${name}Strings[Num_${name}]; 8307673Snate@binkert.org} 8314762Snate@binkert.org 8327673Snate@binkert.org#endif // __ENUM__${name}__ 8337673Snate@binkert.org''') 8347673Snate@binkert.org 8357673Snate@binkert.org def cxx_def(cls, code): 8366654Snate@binkert.org name = cls.__name__ 8377673Snate@binkert.org code('''\ 8387677Snate@binkert.org#include "enums/$name.hh" 8397673Snate@binkert.orgnamespace Enums { 8407673Snate@binkert.org const char *${name}Strings[Num_${name}] = 8417673Snate@binkert.org { 8427673Snate@binkert.org''') 8437673Snate@binkert.org code.indent(2) 8444762Snate@binkert.org for val in cls.vals: 8457673Snate@binkert.org code('"$val",') 8467673Snate@binkert.org code.dedent(2) 8477673Snate@binkert.org code(''' 8487673Snate@binkert.org }; 8497673Snate@binkert.org/* namespace Enums */ } 8507673Snate@binkert.org''') 8513101Sstever@eecs.umich.edu 8523101Sstever@eecs.umich.edu# Base class for enum types. 8533101Sstever@eecs.umich.educlass Enum(ParamValue): 8543101Sstever@eecs.umich.edu __metaclass__ = MetaEnum 8553101Sstever@eecs.umich.edu vals = [] 8563101Sstever@eecs.umich.edu 8573101Sstever@eecs.umich.edu def __init__(self, value): 8583101Sstever@eecs.umich.edu if value not in self.map: 8593101Sstever@eecs.umich.edu raise TypeError, "Enum param got bad value '%s' (not in %s)" \ 8603101Sstever@eecs.umich.edu % (value, self.vals) 8613101Sstever@eecs.umich.edu self.value = value 8623101Sstever@eecs.umich.edu 8637675Snate@binkert.org @classmethod 8647675Snate@binkert.org def cxx_predecls(cls, code): 8657675Snate@binkert.org code('#include "enums/$0.hh"', cls.__name__) 8667675Snate@binkert.org 8677675Snate@binkert.org @classmethod 8687675Snate@binkert.org def swig_predecls(cls, code): 8697677Snate@binkert.org code('%import "python/m5/internal/enum_$0.i"', cls.__name__) 8707675Snate@binkert.org 8714762Snate@binkert.org def getValue(self): 8724762Snate@binkert.org return int(self.map[self.value]) 8734762Snate@binkert.org 8743101Sstever@eecs.umich.edu def __str__(self): 8753101Sstever@eecs.umich.edu return self.value 8763101Sstever@eecs.umich.edu 8773101Sstever@eecs.umich.edu# how big does a rounding error need to be before we warn about it? 8783101Sstever@eecs.umich.edufrequency_tolerance = 0.001 # 0.1% 8793101Sstever@eecs.umich.edu 8804167Sbinkertn@umich.educlass TickParamValue(NumericParamValue): 8813101Sstever@eecs.umich.edu cxx_type = 'Tick' 8827673Snate@binkert.org 8837673Snate@binkert.org @classmethod 8847673Snate@binkert.org def cxx_predecls(cls, code): 8857673Snate@binkert.org code('#include "base/types.hh"') 8867673Snate@binkert.org 8877673Snate@binkert.org @classmethod 8887673Snate@binkert.org def swig_predecls(cls, code): 8897673Snate@binkert.org code('%import "stdint.i"') 8907673Snate@binkert.org code('%import "base/types.hh"') 8914167Sbinkertn@umich.edu 8924762Snate@binkert.org def getValue(self): 8934762Snate@binkert.org return long(self.value) 8944762Snate@binkert.org 8954167Sbinkertn@umich.educlass Latency(TickParamValue): 8963101Sstever@eecs.umich.edu def __init__(self, value): 8974167Sbinkertn@umich.edu if isinstance(value, (Latency, Clock)): 8984167Sbinkertn@umich.edu self.ticks = value.ticks 8994167Sbinkertn@umich.edu self.value = value.value 9004167Sbinkertn@umich.edu elif isinstance(value, Frequency): 9014167Sbinkertn@umich.edu self.ticks = value.ticks 9024167Sbinkertn@umich.edu self.value = 1.0 / value.value 9034167Sbinkertn@umich.edu elif value.endswith('t'): 9044167Sbinkertn@umich.edu self.ticks = True 9054167Sbinkertn@umich.edu self.value = int(value[:-1]) 9064167Sbinkertn@umich.edu else: 9074167Sbinkertn@umich.edu self.ticks = False 9084167Sbinkertn@umich.edu self.value = convert.toLatency(value) 9093101Sstever@eecs.umich.edu 9103101Sstever@eecs.umich.edu def __getattr__(self, attr): 9113101Sstever@eecs.umich.edu if attr in ('latency', 'period'): 9123101Sstever@eecs.umich.edu return self 9133101Sstever@eecs.umich.edu if attr == 'frequency': 9143101Sstever@eecs.umich.edu return Frequency(self) 9153101Sstever@eecs.umich.edu raise AttributeError, "Latency object has no attribute '%s'" % attr 9163101Sstever@eecs.umich.edu 9174762Snate@binkert.org def getValue(self): 9184762Snate@binkert.org if self.ticks or self.value == 0: 9194762Snate@binkert.org value = self.value 9204762Snate@binkert.org else: 9214762Snate@binkert.org value = ticks.fromSeconds(self.value) 9224762Snate@binkert.org return long(value) 9234762Snate@binkert.org 9243101Sstever@eecs.umich.edu # convert latency to ticks 9253101Sstever@eecs.umich.edu def ini_str(self): 9264762Snate@binkert.org return '%d' % self.getValue() 9273101Sstever@eecs.umich.edu 9284167Sbinkertn@umich.educlass Frequency(TickParamValue): 9293101Sstever@eecs.umich.edu def __init__(self, value): 9304167Sbinkertn@umich.edu if isinstance(value, (Latency, Clock)): 9314167Sbinkertn@umich.edu if value.value == 0: 9324167Sbinkertn@umich.edu self.value = 0 9334167Sbinkertn@umich.edu else: 9344167Sbinkertn@umich.edu self.value = 1.0 / value.value 9354167Sbinkertn@umich.edu self.ticks = value.ticks 9364167Sbinkertn@umich.edu elif isinstance(value, Frequency): 9374167Sbinkertn@umich.edu self.value = value.value 9384167Sbinkertn@umich.edu self.ticks = value.ticks 9394167Sbinkertn@umich.edu else: 9404167Sbinkertn@umich.edu self.ticks = False 9414167Sbinkertn@umich.edu self.value = convert.toFrequency(value) 9423101Sstever@eecs.umich.edu 9433101Sstever@eecs.umich.edu def __getattr__(self, attr): 9443101Sstever@eecs.umich.edu if attr == 'frequency': 9453101Sstever@eecs.umich.edu return self 9463101Sstever@eecs.umich.edu if attr in ('latency', 'period'): 9473101Sstever@eecs.umich.edu return Latency(self) 9483101Sstever@eecs.umich.edu raise AttributeError, "Frequency object has no attribute '%s'" % attr 9493101Sstever@eecs.umich.edu 9504167Sbinkertn@umich.edu # convert latency to ticks 9514762Snate@binkert.org def getValue(self): 9524762Snate@binkert.org if self.ticks or self.value == 0: 9534762Snate@binkert.org value = self.value 9544762Snate@binkert.org else: 9554762Snate@binkert.org value = ticks.fromSeconds(1.0 / self.value) 9564762Snate@binkert.org return long(value) 9574762Snate@binkert.org 9583101Sstever@eecs.umich.edu def ini_str(self): 9594762Snate@binkert.org return '%d' % self.getValue() 9603101Sstever@eecs.umich.edu 9613101Sstever@eecs.umich.edu# A generic frequency and/or Latency value. Value is stored as a latency, 9623101Sstever@eecs.umich.edu# but to avoid ambiguity this object does not support numeric ops (* or /). 9633101Sstever@eecs.umich.edu# An explicit conversion to a Latency or Frequency must be made first. 9643101Sstever@eecs.umich.educlass Clock(ParamValue): 9653101Sstever@eecs.umich.edu cxx_type = 'Tick' 9667673Snate@binkert.org 9677673Snate@binkert.org @classmethod 9687673Snate@binkert.org def cxx_predecls(cls, code): 9697673Snate@binkert.org code('#include "base/types.hh"') 9707673Snate@binkert.org 9717673Snate@binkert.org @classmethod 9727673Snate@binkert.org def swig_predecls(cls, code): 9737673Snate@binkert.org code('%import "stdint.i"') 9747673Snate@binkert.org code('%import "base/types.hh"') 9757673Snate@binkert.org 9763101Sstever@eecs.umich.edu def __init__(self, value): 9774167Sbinkertn@umich.edu if isinstance(value, (Latency, Clock)): 9784167Sbinkertn@umich.edu self.ticks = value.ticks 9794167Sbinkertn@umich.edu self.value = value.value 9804167Sbinkertn@umich.edu elif isinstance(value, Frequency): 9814167Sbinkertn@umich.edu self.ticks = value.ticks 9824167Sbinkertn@umich.edu self.value = 1.0 / value.value 9834167Sbinkertn@umich.edu elif value.endswith('t'): 9844167Sbinkertn@umich.edu self.ticks = True 9854167Sbinkertn@umich.edu self.value = int(value[:-1]) 9864167Sbinkertn@umich.edu else: 9874167Sbinkertn@umich.edu self.ticks = False 9884167Sbinkertn@umich.edu self.value = convert.anyToLatency(value) 9893101Sstever@eecs.umich.edu 9903101Sstever@eecs.umich.edu def __getattr__(self, attr): 9913101Sstever@eecs.umich.edu if attr == 'frequency': 9923101Sstever@eecs.umich.edu return Frequency(self) 9933101Sstever@eecs.umich.edu if attr in ('latency', 'period'): 9943101Sstever@eecs.umich.edu return Latency(self) 9953101Sstever@eecs.umich.edu raise AttributeError, "Frequency object has no attribute '%s'" % attr 9963101Sstever@eecs.umich.edu 9974762Snate@binkert.org def getValue(self): 9984762Snate@binkert.org return self.period.getValue() 9994762Snate@binkert.org 10003101Sstever@eecs.umich.edu def ini_str(self): 10013101Sstever@eecs.umich.edu return self.period.ini_str() 10023101Sstever@eecs.umich.edu 10033101Sstever@eecs.umich.educlass NetworkBandwidth(float,ParamValue): 10043101Sstever@eecs.umich.edu cxx_type = 'float' 10053101Sstever@eecs.umich.edu def __new__(cls, value): 10064167Sbinkertn@umich.edu # convert to bits per second 10074167Sbinkertn@umich.edu val = convert.toNetworkBandwidth(value) 10083101Sstever@eecs.umich.edu return super(cls, NetworkBandwidth).__new__(cls, val) 10093101Sstever@eecs.umich.edu 10103101Sstever@eecs.umich.edu def __str__(self): 10113101Sstever@eecs.umich.edu return str(self.val) 10123101Sstever@eecs.umich.edu 10134762Snate@binkert.org def getValue(self): 10144167Sbinkertn@umich.edu # convert to seconds per byte 10154167Sbinkertn@umich.edu value = 8.0 / float(self) 10164167Sbinkertn@umich.edu # convert to ticks per byte 10174762Snate@binkert.org value = ticks.fromSeconds(value) 10184762Snate@binkert.org return float(value) 10194762Snate@binkert.org 10204762Snate@binkert.org def ini_str(self): 10214762Snate@binkert.org return '%f' % self.getValue() 10223101Sstever@eecs.umich.edu 10233101Sstever@eecs.umich.educlass MemoryBandwidth(float,ParamValue): 10243101Sstever@eecs.umich.edu cxx_type = 'float' 10255469Snate@binkert.org def __new__(cls, value): 10267743Sgblack@eecs.umich.edu # convert to bytes per second 10273102Sstever@eecs.umich.edu val = convert.toMemoryBandwidth(value) 10283101Sstever@eecs.umich.edu return super(cls, MemoryBandwidth).__new__(cls, val) 10293101Sstever@eecs.umich.edu 10303101Sstever@eecs.umich.edu def __str__(self): 10313101Sstever@eecs.umich.edu return str(self.val) 10323101Sstever@eecs.umich.edu 10334762Snate@binkert.org def getValue(self): 10344167Sbinkertn@umich.edu # convert to seconds per byte 10355468Snate@binkert.org value = float(self) 10365468Snate@binkert.org if value: 10375468Snate@binkert.org value = 1.0 / float(self) 10384167Sbinkertn@umich.edu # convert to ticks per byte 10394762Snate@binkert.org value = ticks.fromSeconds(value) 10404762Snate@binkert.org return float(value) 10414762Snate@binkert.org 10424762Snate@binkert.org def ini_str(self): 10434762Snate@binkert.org return '%f' % self.getValue() 10443101Sstever@eecs.umich.edu 10453101Sstever@eecs.umich.edu# 10463101Sstever@eecs.umich.edu# "Constants"... handy aliases for various values. 10473101Sstever@eecs.umich.edu# 10483101Sstever@eecs.umich.edu 10493102Sstever@eecs.umich.edu# Special class for NULL pointers. Note the special check in 10503102Sstever@eecs.umich.edu# make_param_value() above that lets these be assigned where a 10513102Sstever@eecs.umich.edu# SimObject is required. 10523102Sstever@eecs.umich.edu# only one copy of a particular node 10533102Sstever@eecs.umich.educlass NullSimObject(object): 10543102Sstever@eecs.umich.edu __metaclass__ = Singleton 10553102Sstever@eecs.umich.edu 10563102Sstever@eecs.umich.edu def __call__(cls): 10573102Sstever@eecs.umich.edu return cls 10583102Sstever@eecs.umich.edu 10593102Sstever@eecs.umich.edu def _instantiate(self, parent = None, path = ''): 10603102Sstever@eecs.umich.edu pass 10613102Sstever@eecs.umich.edu 10623102Sstever@eecs.umich.edu def ini_str(self): 10633102Sstever@eecs.umich.edu return 'Null' 10643102Sstever@eecs.umich.edu 10653102Sstever@eecs.umich.edu def unproxy(self, base): 10663102Sstever@eecs.umich.edu return self 10673102Sstever@eecs.umich.edu 10683102Sstever@eecs.umich.edu def set_path(self, parent, name): 10693102Sstever@eecs.umich.edu pass 10704762Snate@binkert.org 10713102Sstever@eecs.umich.edu def __str__(self): 10723102Sstever@eecs.umich.edu return 'Null' 10733102Sstever@eecs.umich.edu 10744762Snate@binkert.org def getValue(self): 10754762Snate@binkert.org return None 10764762Snate@binkert.org 10773102Sstever@eecs.umich.edu# The only instance you'll ever need... 10783102Sstever@eecs.umich.eduNULL = NullSimObject() 10793102Sstever@eecs.umich.edu 10803102Sstever@eecs.umich.edudef isNullPointer(value): 10813102Sstever@eecs.umich.edu return isinstance(value, NullSimObject) 10823102Sstever@eecs.umich.edu 10833101Sstever@eecs.umich.edu# Some memory range specifications use this as a default upper bound. 10843101Sstever@eecs.umich.eduMaxAddr = Addr.max 10853101Sstever@eecs.umich.eduMaxTick = Tick.max 10863101Sstever@eecs.umich.eduAllMemory = AddrRange(0, MaxAddr) 10873101Sstever@eecs.umich.edu 10883101Sstever@eecs.umich.edu 10893101Sstever@eecs.umich.edu##################################################################### 10903101Sstever@eecs.umich.edu# 10913101Sstever@eecs.umich.edu# Port objects 10923101Sstever@eecs.umich.edu# 10933101Sstever@eecs.umich.edu# Ports are used to interconnect objects in the memory system. 10943101Sstever@eecs.umich.edu# 10953101Sstever@eecs.umich.edu##################################################################### 10963101Sstever@eecs.umich.edu 10973101Sstever@eecs.umich.edu# Port reference: encapsulates a reference to a particular port on a 10983101Sstever@eecs.umich.edu# particular SimObject. 10993101Sstever@eecs.umich.educlass PortRef(object): 11003105Sstever@eecs.umich.edu def __init__(self, simobj, name): 11013105Sstever@eecs.umich.edu assert(isSimObject(simobj) or isSimObjectClass(simobj)) 11023101Sstever@eecs.umich.edu self.simobj = simobj 11033101Sstever@eecs.umich.edu self.name = name 11043101Sstever@eecs.umich.edu self.peer = None # not associated with another port yet 11053101Sstever@eecs.umich.edu self.ccConnected = False # C++ port connection done? 11063105Sstever@eecs.umich.edu self.index = -1 # always -1 for non-vector ports 11073101Sstever@eecs.umich.edu 11083103Sstever@eecs.umich.edu def __str__(self): 11093105Sstever@eecs.umich.edu return '%s.%s' % (self.simobj, self.name) 11103103Sstever@eecs.umich.edu 11113105Sstever@eecs.umich.edu # for config.ini, print peer's name (not ours) 11123105Sstever@eecs.umich.edu def ini_str(self): 11133105Sstever@eecs.umich.edu return str(self.peer) 11143105Sstever@eecs.umich.edu 11153105Sstever@eecs.umich.edu def __getattr__(self, attr): 11163105Sstever@eecs.umich.edu if attr == 'peerObj': 11173105Sstever@eecs.umich.edu # shorthand for proxies 11183105Sstever@eecs.umich.edu return self.peer.simobj 11193105Sstever@eecs.umich.edu raise AttributeError, "'%s' object has no attribute '%s'" % \ 11203105Sstever@eecs.umich.edu (self.__class__.__name__, attr) 11213105Sstever@eecs.umich.edu 11223105Sstever@eecs.umich.edu # Full connection is symmetric (both ways). Called via 11233105Sstever@eecs.umich.edu # SimObject.__setattr__ as a result of a port assignment, e.g., 11243109Sstever@eecs.umich.edu # "obj1.portA = obj2.portB", or via VectorPortElementRef.__setitem__, 11253105Sstever@eecs.umich.edu # e.g., "obj1.portA[3] = obj2.portB". 11263105Sstever@eecs.umich.edu def connect(self, other): 11273105Sstever@eecs.umich.edu if isinstance(other, VectorPortRef): 11283105Sstever@eecs.umich.edu # reference to plain VectorPort is implicit append 11293105Sstever@eecs.umich.edu other = other._get_next() 11303105Sstever@eecs.umich.edu if self.peer and not proxy.isproxy(self.peer): 11313105Sstever@eecs.umich.edu print "warning: overwriting port", self, \ 11323105Sstever@eecs.umich.edu "value", self.peer, "with", other 11335578SSteve.Reinhardt@amd.com self.peer.peer = None 11343101Sstever@eecs.umich.edu self.peer = other 11353109Sstever@eecs.umich.edu if proxy.isproxy(other): 11363109Sstever@eecs.umich.edu other.set_param_desc(PortParamDesc()) 11373109Sstever@eecs.umich.edu elif isinstance(other, PortRef): 11383109Sstever@eecs.umich.edu if other.peer is not self: 11393109Sstever@eecs.umich.edu other.connect(self) 11403109Sstever@eecs.umich.edu else: 11413109Sstever@eecs.umich.edu raise TypeError, \ 11423109Sstever@eecs.umich.edu "assigning non-port reference '%s' to port '%s'" \ 11433109Sstever@eecs.umich.edu % (other, self) 11443101Sstever@eecs.umich.edu 11453105Sstever@eecs.umich.edu def clone(self, simobj, memo): 11463105Sstever@eecs.umich.edu if memo.has_key(self): 11473105Sstever@eecs.umich.edu return memo[self] 11483101Sstever@eecs.umich.edu newRef = copy.copy(self) 11493105Sstever@eecs.umich.edu memo[self] = newRef 11503105Sstever@eecs.umich.edu newRef.simobj = simobj 11513101Sstever@eecs.umich.edu assert(isSimObject(newRef.simobj)) 11523105Sstever@eecs.umich.edu if self.peer and not proxy.isproxy(self.peer): 11533179Sstever@eecs.umich.edu peerObj = self.peer.simobj(_memo=memo) 11543105Sstever@eecs.umich.edu newRef.peer = self.peer.clone(peerObj, memo) 11553105Sstever@eecs.umich.edu assert(not isinstance(newRef.peer, VectorPortRef)) 11563101Sstever@eecs.umich.edu return newRef 11573101Sstever@eecs.umich.edu 11583105Sstever@eecs.umich.edu def unproxy(self, simobj): 11593105Sstever@eecs.umich.edu assert(simobj is self.simobj) 11603105Sstever@eecs.umich.edu if proxy.isproxy(self.peer): 11613105Sstever@eecs.umich.edu try: 11623105Sstever@eecs.umich.edu realPeer = self.peer.unproxy(self.simobj) 11633105Sstever@eecs.umich.edu except: 11643105Sstever@eecs.umich.edu print "Error in unproxying port '%s' of %s" % \ 11653105Sstever@eecs.umich.edu (self.name, self.simobj.path()) 11663105Sstever@eecs.umich.edu raise 11673105Sstever@eecs.umich.edu self.connect(realPeer) 11683105Sstever@eecs.umich.edu 11693101Sstever@eecs.umich.edu # Call C++ to create corresponding port connection between C++ objects 11703101Sstever@eecs.umich.edu def ccConnect(self): 11717677Snate@binkert.org from m5.internal.params import connectPorts 11724762Snate@binkert.org 11733101Sstever@eecs.umich.edu if self.ccConnected: # already done this 11743101Sstever@eecs.umich.edu return 11753101Sstever@eecs.umich.edu peer = self.peer 11765578SSteve.Reinhardt@amd.com if not self.peer: # nothing to connect to 11775578SSteve.Reinhardt@amd.com return 11787526Ssteve.reinhardt@amd.com try: 11797526Ssteve.reinhardt@amd.com connectPorts(self.simobj.getCCObject(), self.name, self.index, 11807526Ssteve.reinhardt@amd.com peer.simobj.getCCObject(), peer.name, peer.index) 11817526Ssteve.reinhardt@amd.com except: 11827526Ssteve.reinhardt@amd.com print "Error connecting port %s.%s to %s.%s" % \ 11837526Ssteve.reinhardt@amd.com (self.simobj.path(), self.name, 11847526Ssteve.reinhardt@amd.com peer.simobj.path(), peer.name) 11857526Ssteve.reinhardt@amd.com raise 11863101Sstever@eecs.umich.edu self.ccConnected = True 11873101Sstever@eecs.umich.edu peer.ccConnected = True 11883101Sstever@eecs.umich.edu 11893105Sstever@eecs.umich.edu# A reference to an individual element of a VectorPort... much like a 11903105Sstever@eecs.umich.edu# PortRef, but has an index. 11913105Sstever@eecs.umich.educlass VectorPortElementRef(PortRef): 11923105Sstever@eecs.umich.edu def __init__(self, simobj, name, index): 11933105Sstever@eecs.umich.edu PortRef.__init__(self, simobj, name) 11943105Sstever@eecs.umich.edu self.index = index 11953105Sstever@eecs.umich.edu 11963105Sstever@eecs.umich.edu def __str__(self): 11973105Sstever@eecs.umich.edu return '%s.%s[%d]' % (self.simobj, self.name, self.index) 11983105Sstever@eecs.umich.edu 11993105Sstever@eecs.umich.edu# A reference to a complete vector-valued port (not just a single element). 12003105Sstever@eecs.umich.edu# Can be indexed to retrieve individual VectorPortElementRef instances. 12013105Sstever@eecs.umich.educlass VectorPortRef(object): 12023105Sstever@eecs.umich.edu def __init__(self, simobj, name): 12033105Sstever@eecs.umich.edu assert(isSimObject(simobj) or isSimObjectClass(simobj)) 12043105Sstever@eecs.umich.edu self.simobj = simobj 12053105Sstever@eecs.umich.edu self.name = name 12063105Sstever@eecs.umich.edu self.elements = [] 12073105Sstever@eecs.umich.edu 12083109Sstever@eecs.umich.edu def __str__(self): 12093109Sstever@eecs.umich.edu return '%s.%s[:]' % (self.simobj, self.name) 12103109Sstever@eecs.umich.edu 12113105Sstever@eecs.umich.edu # for config.ini, print peer's name (not ours) 12123105Sstever@eecs.umich.edu def ini_str(self): 12133105Sstever@eecs.umich.edu return ' '.join([el.ini_str() for el in self.elements]) 12143105Sstever@eecs.umich.edu 12153105Sstever@eecs.umich.edu def __getitem__(self, key): 12163105Sstever@eecs.umich.edu if not isinstance(key, int): 12173105Sstever@eecs.umich.edu raise TypeError, "VectorPort index must be integer" 12183105Sstever@eecs.umich.edu if key >= len(self.elements): 12193105Sstever@eecs.umich.edu # need to extend list 12203105Sstever@eecs.umich.edu ext = [VectorPortElementRef(self.simobj, self.name, i) 12213105Sstever@eecs.umich.edu for i in range(len(self.elements), key+1)] 12223105Sstever@eecs.umich.edu self.elements.extend(ext) 12233105Sstever@eecs.umich.edu return self.elements[key] 12243105Sstever@eecs.umich.edu 12253105Sstever@eecs.umich.edu def _get_next(self): 12263105Sstever@eecs.umich.edu return self[len(self.elements)] 12273105Sstever@eecs.umich.edu 12283105Sstever@eecs.umich.edu def __setitem__(self, key, value): 12293105Sstever@eecs.umich.edu if not isinstance(key, int): 12303105Sstever@eecs.umich.edu raise TypeError, "VectorPort index must be integer" 12313105Sstever@eecs.umich.edu self[key].connect(value) 12323105Sstever@eecs.umich.edu 12333105Sstever@eecs.umich.edu def connect(self, other): 12343109Sstever@eecs.umich.edu if isinstance(other, (list, tuple)): 12353109Sstever@eecs.umich.edu # Assign list of port refs to vector port. 12363109Sstever@eecs.umich.edu # For now, append them... not sure if that's the right semantics 12373109Sstever@eecs.umich.edu # or if it should replace the current vector. 12383109Sstever@eecs.umich.edu for ref in other: 12393109Sstever@eecs.umich.edu self._get_next().connect(ref) 12403109Sstever@eecs.umich.edu else: 12413109Sstever@eecs.umich.edu # scalar assignment to plain VectorPort is implicit append 12423109Sstever@eecs.umich.edu self._get_next().connect(other) 12433109Sstever@eecs.umich.edu 12443109Sstever@eecs.umich.edu def clone(self, simobj, memo): 12453109Sstever@eecs.umich.edu if memo.has_key(self): 12463109Sstever@eecs.umich.edu return memo[self] 12473109Sstever@eecs.umich.edu newRef = copy.copy(self) 12483109Sstever@eecs.umich.edu memo[self] = newRef 12493109Sstever@eecs.umich.edu newRef.simobj = simobj 12503109Sstever@eecs.umich.edu assert(isSimObject(newRef.simobj)) 12513109Sstever@eecs.umich.edu newRef.elements = [el.clone(simobj, memo) for el in self.elements] 12523109Sstever@eecs.umich.edu return newRef 12533105Sstever@eecs.umich.edu 12543105Sstever@eecs.umich.edu def unproxy(self, simobj): 12553105Sstever@eecs.umich.edu [el.unproxy(simobj) for el in self.elements] 12563105Sstever@eecs.umich.edu 12573105Sstever@eecs.umich.edu def ccConnect(self): 12583105Sstever@eecs.umich.edu [el.ccConnect() for el in self.elements] 12593105Sstever@eecs.umich.edu 12603101Sstever@eecs.umich.edu# Port description object. Like a ParamDesc object, this represents a 12613101Sstever@eecs.umich.edu# logical port in the SimObject class, not a particular port on a 12623101Sstever@eecs.umich.edu# SimObject instance. The latter are represented by PortRef objects. 12633101Sstever@eecs.umich.educlass Port(object): 12643105Sstever@eecs.umich.edu # Port("description") or Port(default, "description") 12653105Sstever@eecs.umich.edu def __init__(self, *args): 12663105Sstever@eecs.umich.edu if len(args) == 1: 12673105Sstever@eecs.umich.edu self.desc = args[0] 12683105Sstever@eecs.umich.edu elif len(args) == 2: 12693105Sstever@eecs.umich.edu self.default = args[0] 12703105Sstever@eecs.umich.edu self.desc = args[1] 12713105Sstever@eecs.umich.edu else: 12723105Sstever@eecs.umich.edu raise TypeError, 'wrong number of arguments' 12733105Sstever@eecs.umich.edu # self.name is set by SimObject class on assignment 12743105Sstever@eecs.umich.edu # e.g., pio_port = Port("blah") sets self.name to 'pio_port' 12753101Sstever@eecs.umich.edu 12763101Sstever@eecs.umich.edu # Generate a PortRef for this port on the given SimObject with the 12773101Sstever@eecs.umich.edu # given name 12783105Sstever@eecs.umich.edu def makeRef(self, simobj): 12793105Sstever@eecs.umich.edu return PortRef(simobj, self.name) 12803101Sstever@eecs.umich.edu 12813101Sstever@eecs.umich.edu # Connect an instance of this port (on the given SimObject with 12823101Sstever@eecs.umich.edu # the given name) with the port described by the supplied PortRef 12833105Sstever@eecs.umich.edu def connect(self, simobj, ref): 12843105Sstever@eecs.umich.edu self.makeRef(simobj).connect(ref) 12853101Sstever@eecs.umich.edu 12863101Sstever@eecs.umich.edu# VectorPort description object. Like Port, but represents a vector 12873101Sstever@eecs.umich.edu# of connections (e.g., as on a Bus). 12883101Sstever@eecs.umich.educlass VectorPort(Port): 12893105Sstever@eecs.umich.edu def __init__(self, *args): 12903105Sstever@eecs.umich.edu Port.__init__(self, *args) 12913101Sstever@eecs.umich.edu self.isVec = True 12923101Sstever@eecs.umich.edu 12933105Sstever@eecs.umich.edu def makeRef(self, simobj): 12943105Sstever@eecs.umich.edu return VectorPortRef(simobj, self.name) 12953105Sstever@eecs.umich.edu 12963109Sstever@eecs.umich.edu# 'Fake' ParamDesc for Port references to assign to the _pdesc slot of 12973109Sstever@eecs.umich.edu# proxy objects (via set_param_desc()) so that proxy error messages 12983109Sstever@eecs.umich.edu# make sense. 12993109Sstever@eecs.umich.educlass PortParamDesc(object): 13003109Sstever@eecs.umich.edu __metaclass__ = Singleton 13013109Sstever@eecs.umich.edu 13023109Sstever@eecs.umich.edu ptype_str = 'Port' 13033109Sstever@eecs.umich.edu ptype = Port 13043105Sstever@eecs.umich.edu 13056654Snate@binkert.orgbaseEnums = allEnums.copy() 13066654Snate@binkert.orgbaseParams = allParams.copy() 13076654Snate@binkert.org 13086654Snate@binkert.orgdef clear(): 13096654Snate@binkert.org global allEnums, allParams 13106654Snate@binkert.org 13116654Snate@binkert.org allEnums = baseEnums.copy() 13126654Snate@binkert.org allParams = baseParams.copy() 13136654Snate@binkert.org 13143101Sstever@eecs.umich.edu__all__ = ['Param', 'VectorParam', 13153101Sstever@eecs.umich.edu 'Enum', 'Bool', 'String', 'Float', 13163101Sstever@eecs.umich.edu 'Int', 'Unsigned', 'Int8', 'UInt8', 'Int16', 'UInt16', 13173101Sstever@eecs.umich.edu 'Int32', 'UInt32', 'Int64', 'UInt64', 13183101Sstever@eecs.umich.edu 'Counter', 'Addr', 'Tick', 'Percent', 13193101Sstever@eecs.umich.edu 'TcpPort', 'UdpPort', 'EthernetAddr', 13203101Sstever@eecs.umich.edu 'MemorySize', 'MemorySize32', 13214167Sbinkertn@umich.edu 'Latency', 'Frequency', 'Clock', 13223101Sstever@eecs.umich.edu 'NetworkBandwidth', 'MemoryBandwidth', 13233101Sstever@eecs.umich.edu 'Range', 'AddrRange', 'TickRange', 13243101Sstever@eecs.umich.edu 'MaxAddr', 'MaxTick', 'AllMemory', 13253885Sbinkertn@umich.edu 'Time', 13263102Sstever@eecs.umich.edu 'NextEthernetAddr', 'NULL', 13273101Sstever@eecs.umich.edu 'Port', 'VectorPort'] 13286654Snate@binkert.org 13296654Snate@binkert.orgimport SimObject 1330