simulate.py (5773:7434b2271b0c) simulate.py (6001:00251eb95de7)
1# Copyright (c) 2005 The Regents of The University of Michigan
2# All rights reserved.
3#
4# Redistribution and use in source and binary forms, with or without
5# modification, are permitted provided that the following conditions are
6# met: redistributions of source code must retain the above copyright
7# notice, this list of conditions and the following disclaimer;
8# redistributions in binary form must reproduce the above copyright
9# notice, this list of conditions and the following disclaimer in the
10# documentation and/or other materials provided with the distribution;
11# neither the name of the copyright holders nor the names of its
12# contributors may be used to endorse or promote products derived from
13# this software without specific prior written permission.
14#
15# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
16# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
17# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
18# A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
19# OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
20# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
21# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
22# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
23# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
24# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
25# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
26#
27# Authors: Nathan Binkert
28# Steve Reinhardt
29
30import atexit
31import os
32import sys
33
34# import the SWIG-wrapped main C++ functions
35import internal
1# Copyright (c) 2005 The Regents of The University of Michigan
2# All rights reserved.
3#
4# Redistribution and use in source and binary forms, with or without
5# modification, are permitted provided that the following conditions are
6# met: redistributions of source code must retain the above copyright
7# notice, this list of conditions and the following disclaimer;
8# redistributions in binary form must reproduce the above copyright
9# notice, this list of conditions and the following disclaimer in the
10# documentation and/or other materials provided with the distribution;
11# neither the name of the copyright holders nor the names of its
12# contributors may be used to endorse or promote products derived from
13# this software without specific prior written permission.
14#
15# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
16# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
17# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
18# A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
19# OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
20# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
21# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
22# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
23# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
24# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
25# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
26#
27# Authors: Nathan Binkert
28# Steve Reinhardt
29
30import atexit
31import os
32import sys
33
34# import the SWIG-wrapped main C++ functions
35import internal
36import core
37import stats
36from main import options
37import SimObject
38import ticks
39import objects
40
41# The final hook to generate .ini files. Called from the user script
42# once the config is built.
43def instantiate(root):
44 # we need to fix the global frequency
45 ticks.fixGlobalFrequency()
46
47 root.unproxy_all()
48
49 if options.dump_config:
50 ini_file = file(os.path.join(options.outdir, options.dump_config), 'w')
51 root.print_ini(ini_file)
52 ini_file.close()
53
54 # Initialize the global statistics
38from main import options
39import SimObject
40import ticks
41import objects
42
43# The final hook to generate .ini files. Called from the user script
44# once the config is built.
45def instantiate(root):
46 # we need to fix the global frequency
47 ticks.fixGlobalFrequency()
48
49 root.unproxy_all()
50
51 if options.dump_config:
52 ini_file = file(os.path.join(options.outdir, options.dump_config), 'w')
53 root.print_ini(ini_file)
54 ini_file.close()
55
56 # Initialize the global statistics
55 internal.stats.initSimStats()
57 stats.initSimStats()
56
57 # Create the C++ sim objects and connect ports
58 root.createCCObject()
59 root.connectPorts()
60
61 # Do a second pass to finish initializing the sim objects
58
59 # Create the C++ sim objects and connect ports
60 root.createCCObject()
61 root.connectPorts()
62
63 # Do a second pass to finish initializing the sim objects
62 internal.core.initAll()
64 core.initAll()
63
64 # Do a third pass to initialize statistics
65
66 # Do a third pass to initialize statistics
65 internal.core.regAllStats()
67 core.regAllStats()
66
68
67 # Check to make sure that the stats package is properly initialized
68 internal.stats.check()
69 # We're done registering statistics. Enable the stats package now.
70 stats.enable()
69
70 # Reset to put the stats in a consistent state.
71
72 # Reset to put the stats in a consistent state.
71 internal.stats.reset()
73 stats.reset()
72
73def doDot(root):
74 dot = pydot.Dot()
75 instance.outputDot(dot)
76 dot.orientation = "portrait"
77 dot.size = "8.5,11"
78 dot.ranksep="equally"
79 dot.rank="samerank"
80 dot.write("config.dot")
81 dot.write_ps("config.ps")
82
83need_resume = []
84need_startup = True
85def simulate(*args, **kwargs):
86 global need_resume, need_startup
87
88 if need_startup:
89 internal.core.SimStartup()
90 need_startup = False
91
92 for root in need_resume:
93 resume(root)
94 need_resume = []
95
96 return internal.event.simulate(*args, **kwargs)
97
98# Export curTick to user script.
99def curTick():
100 return internal.core.cvar.curTick
101
102# Python exit handlers happen in reverse order. We want to dump stats last.
103atexit.register(internal.stats.dump)
104
105# register our C++ exit callback function with Python
106atexit.register(internal.core.doExitCleanup)
107
108# This loops until all objects have been fully drained.
109def doDrain(root):
110 all_drained = drain(root)
111 while (not all_drained):
112 all_drained = drain(root)
113
114# Tries to drain all objects. Draining might not be completed unless
115# all objects return that they are drained on the first call. This is
116# because as objects drain they may cause other objects to no longer
117# be drained.
118def drain(root):
119 all_drained = False
120 drain_event = internal.event.createCountedDrain()
121 unready_objects = root.startDrain(drain_event, True)
122 # If we've got some objects that can't drain immediately, then simulate
123 if unready_objects > 0:
124 drain_event.setCount(unready_objects)
125 simulate()
126 else:
127 all_drained = True
128 internal.event.cleanupCountedDrain(drain_event)
129 return all_drained
130
131def resume(root):
132 root.resume()
133
134def checkpoint(root, dir):
135 if not isinstance(root, objects.Root):
136 raise TypeError, "Checkpoint must be called on a root object."
137 doDrain(root)
138 print "Writing checkpoint"
139 internal.core.serializeAll(dir)
140 resume(root)
141
142def restoreCheckpoint(root, dir):
143 print "Restoring from checkpoint"
144 internal.core.unserializeAll(dir)
145 need_resume.append(root)
146
147def changeToAtomic(system):
148 if not isinstance(system, (objects.Root, objects.System)):
149 raise TypeError, "Parameter of type '%s'. Must be type %s or %s." % \
150 (type(system), objects.Root, objects.System)
151 if system.getMemoryMode() != objects.params.atomic:
152 doDrain(system)
153 print "Changing memory mode to atomic"
154 system.changeTiming(objects.params.atomic)
155
156def changeToTiming(system):
157 if not isinstance(system, (objects.Root, objects.System)):
158 raise TypeError, "Parameter of type '%s'. Must be type %s or %s." % \
159 (type(system), objects.Root, objects.System)
160
161 if system.getMemoryMode() != objects.params.timing:
162 doDrain(system)
163 print "Changing memory mode to timing"
164 system.changeTiming(objects.params.timing)
165
166def switchCpus(cpuList):
167 print "switching cpus"
168 if not isinstance(cpuList, list):
169 raise RuntimeError, "Must pass a list to this function"
170 for item in cpuList:
171 if not isinstance(item, tuple) or len(item) != 2:
172 raise RuntimeError, "List must have tuples of (oldCPU,newCPU)"
173
174 for old_cpu, new_cpu in cpuList:
175 if not isinstance(old_cpu, objects.BaseCPU):
176 raise TypeError, "%s is not of type BaseCPU" % old_cpu
177 if not isinstance(new_cpu, objects.BaseCPU):
178 raise TypeError, "%s is not of type BaseCPU" % new_cpu
179
180 # Now all of the CPUs are ready to be switched out
181 for old_cpu, new_cpu in cpuList:
182 old_cpu._ccObject.switchOut()
183
184 for old_cpu, new_cpu in cpuList:
185 new_cpu.takeOverFrom(old_cpu)
186
187from internal.core import disableAllListeners
74
75def doDot(root):
76 dot = pydot.Dot()
77 instance.outputDot(dot)
78 dot.orientation = "portrait"
79 dot.size = "8.5,11"
80 dot.ranksep="equally"
81 dot.rank="samerank"
82 dot.write("config.dot")
83 dot.write_ps("config.ps")
84
85need_resume = []
86need_startup = True
87def simulate(*args, **kwargs):
88 global need_resume, need_startup
89
90 if need_startup:
91 internal.core.SimStartup()
92 need_startup = False
93
94 for root in need_resume:
95 resume(root)
96 need_resume = []
97
98 return internal.event.simulate(*args, **kwargs)
99
100# Export curTick to user script.
101def curTick():
102 return internal.core.cvar.curTick
103
104# Python exit handlers happen in reverse order. We want to dump stats last.
105atexit.register(internal.stats.dump)
106
107# register our C++ exit callback function with Python
108atexit.register(internal.core.doExitCleanup)
109
110# This loops until all objects have been fully drained.
111def doDrain(root):
112 all_drained = drain(root)
113 while (not all_drained):
114 all_drained = drain(root)
115
116# Tries to drain all objects. Draining might not be completed unless
117# all objects return that they are drained on the first call. This is
118# because as objects drain they may cause other objects to no longer
119# be drained.
120def drain(root):
121 all_drained = False
122 drain_event = internal.event.createCountedDrain()
123 unready_objects = root.startDrain(drain_event, True)
124 # If we've got some objects that can't drain immediately, then simulate
125 if unready_objects > 0:
126 drain_event.setCount(unready_objects)
127 simulate()
128 else:
129 all_drained = True
130 internal.event.cleanupCountedDrain(drain_event)
131 return all_drained
132
133def resume(root):
134 root.resume()
135
136def checkpoint(root, dir):
137 if not isinstance(root, objects.Root):
138 raise TypeError, "Checkpoint must be called on a root object."
139 doDrain(root)
140 print "Writing checkpoint"
141 internal.core.serializeAll(dir)
142 resume(root)
143
144def restoreCheckpoint(root, dir):
145 print "Restoring from checkpoint"
146 internal.core.unserializeAll(dir)
147 need_resume.append(root)
148
149def changeToAtomic(system):
150 if not isinstance(system, (objects.Root, objects.System)):
151 raise TypeError, "Parameter of type '%s'. Must be type %s or %s." % \
152 (type(system), objects.Root, objects.System)
153 if system.getMemoryMode() != objects.params.atomic:
154 doDrain(system)
155 print "Changing memory mode to atomic"
156 system.changeTiming(objects.params.atomic)
157
158def changeToTiming(system):
159 if not isinstance(system, (objects.Root, objects.System)):
160 raise TypeError, "Parameter of type '%s'. Must be type %s or %s." % \
161 (type(system), objects.Root, objects.System)
162
163 if system.getMemoryMode() != objects.params.timing:
164 doDrain(system)
165 print "Changing memory mode to timing"
166 system.changeTiming(objects.params.timing)
167
168def switchCpus(cpuList):
169 print "switching cpus"
170 if not isinstance(cpuList, list):
171 raise RuntimeError, "Must pass a list to this function"
172 for item in cpuList:
173 if not isinstance(item, tuple) or len(item) != 2:
174 raise RuntimeError, "List must have tuples of (oldCPU,newCPU)"
175
176 for old_cpu, new_cpu in cpuList:
177 if not isinstance(old_cpu, objects.BaseCPU):
178 raise TypeError, "%s is not of type BaseCPU" % old_cpu
179 if not isinstance(new_cpu, objects.BaseCPU):
180 raise TypeError, "%s is not of type BaseCPU" % new_cpu
181
182 # Now all of the CPUs are ready to be switched out
183 for old_cpu, new_cpu in cpuList:
184 old_cpu._ccObject.switchOut()
185
186 for old_cpu, new_cpu in cpuList:
187 new_cpu.takeOverFrom(old_cpu)
188
189from internal.core import disableAllListeners