URL https://opencores.org/ocsvn/openrisc_2011-10-31/openrisc_2011-10-31/trunk

Subversion Repositories openrisc_2011-10-31

[/] [openrisc/] [trunk/] [or1ksim/] [README] - Blame information for rev 162

Go to most recent revision | Details | Compare with Previous | View Log


              Or1ksim: The OpenRISC 1000 Architectural Simulator
              ==================================================
 
 
What is this stuff?
===================
 
This is OpenRISC 1000 architectural simulator. See the file COPYING
for copying permission. To contact the authors, see the AUTHORS file.
 
This simulator loads an assembly file for one of the both architectures
and it simulates the operation of instructions.
 
 
Pre-requisites
==============
 
The GNU toolchain for OpenRISC 1000 is required to compile programs for use
with Or1ksim. Instructions how to build these GNU tools can be found on
www.opencores.org
 
Both the tool chain and DejaGnu are need to run the test suite.
 
 
Installation
============
 
See the file INSTALL for generic installation instructions. Full details are
in the user guide, which can be found in the 'doc' subdirectory.
 
 
GNU Tools
=========
 
Instructions how to build GNU tools can be found on www.opencores.org, or in
the Embecosm Application Note EAN2: "The OpenCores OpenRISC 1000 Simulator and
Tool Chain: Installation Guide" .
 
 
Simulator test
==============
 
Or1ksim can be tested with "make check", but this requires the GNU tool chain
to be installed (using the same target specification) and DejaGNU to be
installed. Full details of the tests can be found in the 'testsuite'
sub-directory.
 
 
Help
====
 
Run sim with --help option for list of command line options and help in
interactive mode, to list the commands.
 
A user guide may be found in the 'doc' sub-directory.
 
If doxygen and dot are installed, structured documentation of the code base
may be obtained by running the command:
 
  doxygen doxygen.config
 
from the top level directory.
 
 
OpenRISC and OpenCores
======================
 
This project is licensed under the GNU Public License version 3. See the file
COPYING for details.
 
About the same idea as with GNU project except we want free and open source
IP (intellectual property) cores. We design open source, synthesizable
cores. OpenRISC is one such core. It is a 32-bit RISC microprocessor that
will run GNU/Linux.
 
For more information visit us at http://www.opencores.org.
 
 
Upated by Jeremy Bennett (jeremy.bennett@embecosm.com)
22 June 2010

Line No.	Rev	Author	Line
1	19	jeremybenn	`Or1ksim: The OpenRISC 1000 Architectural Simulator`
2			`==================================================`
3
4
5			`What is this stuff?`
6			`===================`
7
8			`This is OpenRISC 1000 architectural simulator. See the file COPYING`
9			`for copying permission. To contact the authors, see the AUTHORS file.`
10
11			`This simulator loads an assembly file for one of the both architectures`
12	82	jeremybenn	`and it simulates the operation of instructions.`
13	19	jeremybenn
14
15			`Pre-requisites`
16			`==============`
17
18			`The GNU toolchain for OpenRISC 1000 is required to compile programs for use`
19			`with Or1ksim. Instructions how to build these GNU tools can be found on`
20			`www.opencores.org`
21
22	104	jeremybenn	`Both the tool chain and DejaGnu are need to run the test suite.`
23	19	jeremybenn
24	104	jeremybenn
25	19	jeremybenn	`Installation`
26			`============`
27
28	104	jeremybenn	`See the file INSTALL for generic installation instructions. Full details are`
29			`in the user guide, which can be found in the 'doc' subdirectory.`
30	19	jeremybenn
31
32			`GNU Tools`
33			`=========`
34
35			`Instructions how to build GNU tools can be found on www.opencores.org, or in`
36			`the Embecosm Application Note EAN2: "The OpenCores OpenRISC 1000 Simulator and`
37			`Tool Chain: Installation Guide" .`
38
39
40			`Simulator test`
41			`==============`
42
43	82	jeremybenn	`Or1ksim can be tested with "make check", but this requires the GNU tool chain`
44			`to be installed (using the same target specification) and DejaGNU to be`
45			`installed. Full details of the tests can be found in the 'testsuite'`
46			`sub-directory.`
47	19	jeremybenn
48
49			`Help`
50			`====`
51
52			`Run sim with --help option for list of command line options and help in`
53			`interactive mode, to list the commands.`
54
55	82	jeremybenn	`A user guide may be found in the 'doc' sub-directory.`
56	19	jeremybenn
57			`If doxygen and dot are installed, structured documentation of the code base`
58			`may be obtained by running the command:`
59
60			`doxygen doxygen.config`
61
62			`from the top level directory.`
63
64
65			`OpenRISC and OpenCores`
66			`======================`
67
68			`This project is licensed under the GNU Public License version 3. See the file`
69			`COPYING for details.`
70
71			`About the same idea as with GNU project except we want free and open source`
72			`IP (intellectual property) cores. We design open source, synthesizable`
73			`cores. OpenRISC is one such core. It is a 32-bit RISC microprocessor that`
74			`will run GNU/Linux.`
75
76			`For more information visit us at http://www.opencores.org.`
77
78
79			`Upated by Jeremy Bennett (jeremy.bennett@embecosm.com)`
80	134	jeremybenn	`22 June 2010`

Browse

Tools

Subversion Repositories openrisc_2011-10-31

[/] [openrisc/] [trunk/] [or1ksim/] [README] - Blame information for rev 162