You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
higepi 6c0debd407 projet 1 year ago
..
BUGS projet 1 year ago
ChangeLog-2021 projet 1 year ago
INSTALL projet 1 year ago
Makefile.in projet 1 year ago
README projet 1 year ago
RUN projet 1 year ago
aclocal.m4 projet 1 year ago
altivec.igen projet 1 year ago
altivec_expression.h projet 1 year ago
altivec_registers.h projet 1 year ago
basics.h projet 1 year ago
bits.c projet 1 year ago
bits.h projet 1 year ago
cap.c projet 1 year ago
cap.h projet 1 year ago
config.in projet 1 year ago
configure projet 1 year ago
configure.ac projet 1 year ago
corefile-n.h projet 1 year ago
corefile.c projet 1 year ago
corefile.h projet 1 year ago
cpu.c projet 1 year ago
cpu.h projet 1 year ago
dc-complex projet 1 year ago
dc-simple projet 1 year ago
dc-stupid projet 1 year ago
dc-test.01 projet 1 year ago
dc-test.02 projet 1 year ago
debug.c projet 1 year ago
debug.h projet 1 year ago
defs.h projet 1 year ago
device.c projet 1 year ago
device.h projet 1 year ago
device_table.c projet 1 year ago
device_table.h projet 1 year ago
dgen.c projet 1 year ago
double.c projet 1 year ago
dp-bit.c projet 1 year ago
e500.igen projet 1 year ago
e500_expression.h projet 1 year ago
e500_registers.h projet 1 year ago
emul_bugapi.c projet 1 year ago
emul_bugapi.h projet 1 year ago
emul_chirp.c projet 1 year ago
emul_chirp.h projet 1 year ago
emul_generic.c projet 1 year ago
emul_generic.h projet 1 year ago
emul_netbsd.c projet 1 year ago
emul_netbsd.h projet 1 year ago
emul_unix.c projet 1 year ago
emul_unix.h projet 1 year ago
events.c projet 1 year ago
events.h projet 1 year ago
filter.c projet 1 year ago
filter.h projet 1 year ago
filter_filename.c projet 1 year ago
filter_filename.h projet 1 year ago
gdb-sim.c projet 1 year ago
gen-icache.c projet 1 year ago
gen-icache.h projet 1 year ago
gen-idecode.c projet 1 year ago
gen-idecode.h projet 1 year ago
gen-itable.c projet 1 year ago
gen-itable.h projet 1 year ago
gen-model.c projet 1 year ago
gen-model.h projet 1 year ago
gen-semantics.c projet 1 year ago
gen-semantics.h projet 1 year ago
gen-support.c projet 1 year ago
gen-support.h projet 1 year ago
hw_com.c projet 1 year ago
hw_core.c projet 1 year ago
hw_cpu.c projet 1 year ago
hw_cpu.h projet 1 year ago
hw_disk.c projet 1 year ago
hw_eeprom.c projet 1 year ago
hw_glue.c projet 1 year ago
hw_htab.c projet 1 year ago
hw_ide.c projet 1 year ago
hw_init.c projet 1 year ago
hw_iobus.c projet 1 year ago
hw_memory.c projet 1 year ago
hw_nvram.c projet 1 year ago
hw_opic.c projet 1 year ago
hw_pal.c projet 1 year ago
hw_phb.c projet 1 year ago
hw_phb.h projet 1 year ago
hw_register.c projet 1 year ago
hw_sem.c projet 1 year ago
hw_shm.c projet 1 year ago
hw_trace.c projet 1 year ago
hw_vm.c projet 1 year ago
idecode_branch.h projet 1 year ago
idecode_expression.h projet 1 year ago
idecode_fields.h projet 1 year ago
igen.c projet 1 year ago
igen.h projet 1 year ago
inline.c projet 1 year ago
inline.h projet 1 year ago
interrupts.c projet 1 year ago
interrupts.h projet 1 year ago
ld-cache.c projet 1 year ago
ld-cache.h projet 1 year ago
ld-decode.c projet 1 year ago
ld-decode.h projet 1 year ago
ld-insn.c projet 1 year ago
ld-insn.h projet 1 year ago
lf.c projet 1 year ago
lf.h projet 1 year ago
local.mk projet 1 year ago
main.c projet 1 year ago
misc.c projet 1 year ago
misc.h projet 1 year ago
mon.c projet 1 year ago
mon.h projet 1 year ago
options.c projet 1 year ago
options.h projet 1 year ago
os_emul.c projet 1 year ago
os_emul.h projet 1 year ago
pk_disklabel.c projet 1 year ago
ppc-instructions projet 1 year ago
ppc-spr-table projet 1 year ago
ppc.mt projet 1 year ago
psim.c projet 1 year ago
psim.h projet 1 year ago
psim.texinfo projet 1 year ago
registers.c projet 1 year ago
registers.h projet 1 year ago
sim-endian-n.h projet 1 year ago
sim-endian.c projet 1 year ago
sim-endian.h projet 1 year ago
sim-main.h projet 1 year ago
sim_callbacks.h projet 1 year ago
sim_calls.c projet 1 year ago
std-config.h projet 1 year ago
table.c projet 1 year ago
table.h projet 1 year ago
tree.c projet 1 year ago
tree.h projet 1 year ago
vm.c projet 1 year ago
vm.h projet 1 year ago
vm_n.h projet 1 year ago
words.h projet 1 year ago

README


		PSIM 1.0.1 - Model of the PowerPC Environments


    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 3 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, see <http://www.gnu.org/licenses/>.
 

    ----------------------------------------------------------------------


PSIM is a program written in extended ANSI-C that implements an
instruction level simulation of the PowerPC environment.  It is freely
available in source code form under the terms of the GNU General
Public License (version 3 or later).

The PowerPC Architecture is described as having three levels of
compliance:

	UEA - User Environment Architecture
	VEA - Virtual Environment Architecture
	OEA - Operating Environment Architecture

PSIM both implements all three levels of the PowerPC and includes (for
each level) a corresponding simulated run-time environment.

In addition, PSIM, to the execution 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
	Cygnus Support
	Highland Logic Pty Ltd

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.