OpenCores
URL https://opencores.org/ocsvn/openrisc/openrisc/trunk

Subversion Repositories openrisc

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

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

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

powered by: WebSVN 2.1.0

© copyright 1999-2024 OpenCores.org, equivalent to Oliscience, all rights reserved. OpenCores®, registered trademark.