1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
|
PSIM 1.0 - Model of the PowerPC Environment
Copyright (C) 1994-1996, Andrew Cagney <cagney@highland.com.au>.
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
----------------------------------------------------------------------
PSIM is a program written in extended ANSI-C that implements an
instruction level simulation of the PowerPC environment.
The PowerPC Architecture is described as having three levels of
compliance:
UEA - User Environment Architecture
VEA - Virtual Environment Architecture
OEA - Operating Environment Architecture
PSIM implements all three levels of the PowerPC architecture and, in
addition, includes (for each level) a corresponding simulated run-time
environment.
In addition, PSIM, to the functional unit level, models the
performance of most of the current PowerPC implementations
(contributed by Michael Meissner). This detailed performance
monitoring (unlike many other simulators) resulting in only a
relatively marginal reduction in the simulators performance.
A description of how to build PSIM is contained in the file:
ftp://ftp.ci.com.au/pub/psim/INSTALL
or ftp://cambridge.cygnus.com/pub/psim/INSTALL
while an overview of how to use PSIM is in:
ftp://ftp.ci.com.au/pub/psim/RUN
or ftp://cambridge.cygnus.com/pub/psim/RUN
This file is found in:
ftp://ftp.ci.com.au/pub/psim/README
or ftp://cambridge.cygnus.com/pub/psim/README
Thanks goes firstly to:
Corinthian Engineering Pty Ltd
Highland Logic Pty Ltd
Cygnus Support
who provided the resources needed for making this software available
on the Internet.
More importantly I'd like to thank the following individuals who each
contributed in their own unique way:
Allen Briggs, Bett Koch, David Edelsohn, Gordon Irlam,
Michael Meissner, Bob Mercier, Richard Perini, Dale Rahn,
Richard Stallman, Mitchele Walker
Andrew Cagney
Feb, 1995
----------------------------------------------------------------------
What features does PSIM include?
Monitoring and modeling
PSIM includes (thanks to Michael Meissner)
a detailed model of most of the PowerPC
implementations to the functional unit level.
SMP
The PowerPC ISA defines SMP synchronizing instructions.
This simulator implements a limited, but functional,
subset of the PowerPC synchronization instructions
behaviour. Programs that restrict their synchronization
primitives to those that work with this functional
sub-set (eg P() and V()) are able to run on the SMP
version of PSIM.
People intending to use this system should study
the code implementing the lwarx instruction.
ENDIAN SUPPORT
PSIM implements the PowerPC's big and little (xor
endian) modes and correctly simulates code that
switches between these two modes.
In addition, psim can model a true little-endian
machine.
ISA (Instruction Set Architecture) models
PSIM includes a model of the UEA, VEA and OEA. This
includes the time base registers (VEA) and HTAB
and BATS (OEA).
In addition, a preliminary model of the 64 bit
PowerPC architecture is implemented.
IO Hardware
PSIM's internals are based around the concept
of a Device Tree. This tree intentionally
resembles that of the Device Tree found in
OpenBoot firmware. PSIM is flexible enough
to allow the user to fully configure this device
tree (and consequently the hardware model) at
run time.
Run-time environments:
PSIM's UEA model includes emulation for BSD
based UNIX system calls.
PSIM's OEA model includes emulation of either:
o OpenBoot client interface
o MOTO's BUG interface.
Floating point
Preliminary support for floating point is included.
Who would be interested in PSIM?
o the curious
Using psim, gdb, gcc and binutils the curious
user can construct an environment that allows
them to play with PowerPC Environment without
the need for real hardware.
o the analyst
PSIM includes many (contributed) monitoring
features which (unlike many other simulators)
do not come with a great penalty in performance.
Thus the performance analyst is able to use
this simulator to analyse the performance of
the system under test.
If PSIM doesn't monitor a components of interest,
the source code is freely available, and hence
there is no hinderance to changing things
to meet a specific analysts needs.
o the serious SW developer
PSIM models all three levels of the PowerPC
Architecture: UEA, VEA and OEA. Further,
the internal design is such that PSIM can
be extended to support additional requirements.
What performance analysis measurements can PSIM perform?
Below is the output from a recent analysis run
(contributed by Michael Meissner):
For the following program:
long
simple_rand ()
{
static unsigned long seed = 47114711;
unsigned long this = seed * 1103515245 + 12345;
seed = this;
/* cut-cut-cut - see the file RUN.psim */
}
Here is the current output generated with the -I switch on a P90
(the compiler used is the development version of GCC with a new
scheduler replacing the old one):
CPU #1 executed 41,994 AND instructions.
CPU #1 executed 519,785 AND Immediate instructions.
.
.
.
CPU #1 executed 1 System Call instruction.
CPU #1 executed 207,746 XOR instructions.
CPU #1 executed 23,740,856 cycles.
CPU #1 executed 10,242,780 stalls waiting for data.
CPU #1 executed 1 stall waiting for a function unit.
.
.
.
CPU #1 executed 3,136,229 branch functional unit instructions.
CPU #1 executed 16,949,396 instructions that were accounted for in timing info.
CPU #1 executed 871,920 data reads.
CPU #1 executed 971,926 data writes.
CPU #1 executed 221 icache misses.
CPU #1 executed 16,949,396 instructions in total.
Simulator speed was 250,731 instructions/second
What motivated PSIM?
As an idea, psim was first discussed seriously during mid
1994. At that time its main objectives were:
o good performance
Many simulators loose out by only providing
a binary interface to the internals. This
interface eventually becomes a bottle neck
in the simulators performance.
It was intended that PSIM would avoid this
problem by giving the user access to the
full source code.
Further, by exploiting the power of modern
compilers it was hoped that PSIM would achieve
good performance with out having to compromise
its internal design.
o practical portability
Rather than try to be portable to every
C compiler on every platform, it was decided
that PSIM would restrict its self to supporting
ANSI compilers that included the extension
of a long long type.
GCC is one such compiler, consequently PSIM
should be portable to any machine running GCC.
o flexibility in its design
PSIM should allow the user to select the
features required and customise the build
accordingly. By having the source code,
the compiler is able to eliminate any un
used features of the simulator.
After all, let the compiler do the work.
o SMP
A model that allowed the simulation of
SMP platforms with out the large overhead
often encountered with such models.
PSIM achieves each of these objectives.
Is PSIM PowerPC Platform (PPCP) (nee CHRP) Compliant?
No.
Among other things it does not have an Apple ROM socket.
Could PSIM be extended so that it models a CHRP machine?
Yes.
PSIM has been designed with the CHRP spec in mind. To model
a CHRP desktop the following would need to be added:
o An apple ROM socket :-)
o Model of each of the desktop IO devices
o An OpenPIC device.
o RTAS (Run Time Abstraction Services).
o A fully populated device tree.
Is the source code available?
Yes.
The source code to PSIM is available under the terms of
the GNU Public Licence. This allows you to distribute
the source code for free but with certain conditions.
See the file:
ftp://archie.au/gnu/COPYING
For details of the terms and conditions.
Where do I send bugs or report problems?
There is a mailing list (subscribe through majordomo@ci.com.au) at:
powerpc-psim@ci.com.au
If I get the ftp archive updated I post a note to that mailing list.
In addition your welcome to send bugs or problems either to me or to
that e-mail list.
This list currently averages zero articles a day.
Does PSIM have any limitations or problems?
PSIM can't run rs6000/AIX binaries - At present PSIM can only
simulate static executables. Since an AIX executable is
never static, PSIM is unable to simulate its execution.
PSIM is still under development - consequently there are going
to be bugs.
See the file BUGS (included in the distribution) for any
other outstanding issues.
|