| Line 1... |
Line 1... |
This is ../../or1ksim/doc/or1ksim.info, produced by makeinfo version
|
This is ../../doc/or1ksim.info, produced by makeinfo version 4.13 from
|
4.13 from ../../or1ksim/doc/or1ksim.texi.
|
../../doc/or1ksim.texi.
|
|
|
INFO-DIR-SECTION Embedded development
|
INFO-DIR-SECTION Embedded development
|
START-INFO-DIR-ENTRY
|
START-INFO-DIR-ENTRY
|
* Or1ksim: (or32-elf-or1ksim). The OpenRISC 1000 Architectural
|
* Or1ksim: (or32-elf-or1ksim). The OpenRISC 1000 Architectural
|
Simulator
|
Simulator
|
| Line 62... |
Line 62... |
===============
|
===============
|
|
|
Unpack the software and create a _separate_ directory in which to build
|
Unpack the software and create a _separate_ directory in which to build
|
it:
|
it:
|
|
|
tar jxf or1ksim-2010-12-08.tar.bz2
|
tar jxf or1ksim-2010-12-15.tar.bz2
|
mkdir builddir_or1ksim
|
mkdir builddir_or1ksim
|
cd builddir_or1ksim
|
cd builddir_or1ksim
|
|
|
|
|
File: or1ksim.info, Node: Configuring the Build, Next: Build and Install, Prev: Preparation, Up: Installation
|
File: or1ksim.info, Node: Configuring the Build, Next: Build and Install, Prev: Preparation, Up: Installation
|
| Line 79... |
Line 79... |
|
|
The most significant argument is `--target', which should specify the
|
The most significant argument is `--target', which should specify the
|
OpenRISC 1000 32-bit architecture. If this argument is omitted, it will
|
OpenRISC 1000 32-bit architecture. If this argument is omitted, it will
|
default to OpenRISC 1000 32-bit with a warning
|
default to OpenRISC 1000 32-bit with a warning
|
|
|
../or1ksim-2010-12-08/configure --target=or32-elf ...
|
../or1ksim-2010-12-15/configure --target=or32-elf ...
|
|
|
There are several other options available, many of which are standard
|
There are several other options available, many of which are standard
|
to GNU `configure' scripts. Use `configure --help' to see all the
|
to GNU `configure' scripts. Use `configure --help' to see all the
|
options. The most useful is `--prefix' to specify a directory for
|
options. The most useful is `--prefix' to specify a directory for
|
installation of the tools.
|
installation of the tools.
|
| Line 518... |
Line 518... |
|
|
An execution trace can be generated at run time with options passed by
|
An execution trace can be generated at run time with options passed by
|
the command line, or via the operating system's signal passing
|
the command line, or via the operating system's signal passing
|
mechanism.
|
mechanism.
|
|
|
|
The following, passed at run time, can be used to create an execution
|
|
dump.
|
|
|
`-t'
|
`-t'
|
`--trace'
|
`--trace'
|
Dump instruction just executed and any register/memory location
|
Dump instruction just executed and any register/memory location
|
chaged after each instruction (one line per instruction).
|
chaged after each instruction (one line per instruction).
|
|
|
|
Passing a signal `SIGUSR1' while the simulator is running toggles trace
|
|
generation. This can be done with the following command, assuming
|
|
Or1ksim's executable name is `or32-elf-sim':
|
|
|
|
pkill -SIGUSR1 or32-elf-sim
|
|
|
|
This is useful in the case where trace output is desired after a
|
|
significant amount of simulation time, where it would be inconvenient to
|
|
generate trace up to that point.
|
|
|
|
If the `pkill' utility is not available, the `kill' utility can be used
|
|
if Or1ksim's process number is known. Use the following to determine
|
|
the process ID of the `or32-elf-sim' and then send the `SIGUSR1'
|
|
command to toggle execution trace generation:
|
|
|
|
ps a | grep or32-elf-sim
|
|
kill -SIGUSR1 _process-number_
|
|
|
|
|
File: or1ksim.info, Node: Simulator Library, Next: Ethernet TUN/TAP Interface, Prev: Trace Generation, Up: Usage
|
File: or1ksim.info, Node: Simulator Library, Next: Ethernet TUN/TAP Interface, Prev: Trace Generation, Up: Usage
|
|
|
2.5 Simulator Library
|
2.5 Simulator Library
|
=====================
|
=====================
|
| Line 3823... |
Line 3844... |
(line 91)
|
(line 91)
|
* --srv: Standalone Simulator.
|
* --srv: Standalone Simulator.
|
(line 60)
|
(line 60)
|
* --strict-npc: Standalone Simulator.
|
* --strict-npc: Standalone Simulator.
|
(line 100)
|
(line 100)
|
* --trace <1>: Trace Generation. (line 12)
|
* --trace <1>: Trace Generation. (line 15)
|
* --trace: Standalone Simulator.
|
* --trace: Standalone Simulator.
|
(line 39)
|
(line 39)
|
* --verbose: Standalone Simulator.
|
* --verbose: Standalone Simulator.
|
(line 33)
|
(line 33)
|
* --version: Standalone Simulator.
|
* --version: Standalone Simulator.
|
| Line 3857... |
Line 3878... |
* -m: Standalone Simulator.
|
* -m: Standalone Simulator.
|
(line 70)
|
(line 70)
|
* -q <1>: Profiling Utility. (line 30)
|
* -q <1>: Profiling Utility. (line 30)
|
* -q: Standalone Simulator.
|
* -q: Standalone Simulator.
|
(line 29)
|
(line 29)
|
* -t <1>: Trace Generation. (line 12)
|
* -t <1>: Trace Generation. (line 15)
|
* -t: Standalone Simulator.
|
* -t: Standalone Simulator.
|
(line 39)
|
(line 39)
|
* -V: Standalone Simulator.
|
* -V: Standalone Simulator.
|
(line 33)
|
(line 33)
|
* -v: Standalone Simulator.
|
* -v: Standalone Simulator.
|
| Line 4684... |
Line 4705... |
(line 50)
|
(line 50)
|
|
|
|
|
|
|
Tag Table:
|
Tag Table:
|
Node: Top826
|
Node: Top810
|
Node: Installation1236
|
Node: Installation1220
|
Node: Preparation1483
|
Node: Preparation1467
|
Node: Configuring the Build1778
|
Node: Configuring the Build1762
|
Node: Build and Install7918
|
Node: Build and Install7902
|
Node: Known Issues8684
|
Node: Known Issues8668
|
Node: Usage9739
|
Node: Usage9723
|
Node: Standalone Simulator10005
|
Node: Standalone Simulator9989
|
Node: Profiling Utility14565
|
Node: Profiling Utility14549
|
Node: Memory Profiling Utility15471
|
Node: Memory Profiling Utility15455
|
Node: Trace Generation16831
|
Node: Trace Generation16815
|
Node: Simulator Library17286
|
Node: Simulator Library18057
|
Node: Ethernet TUN/TAP Interface27718
|
Node: Ethernet TUN/TAP Interface28489
|
Node: Setting Up a Persistent TAP device28801
|
Node: Setting Up a Persistent TAP device29572
|
Node: Establishing a Bridge29476
|
Node: Establishing a Bridge30247
|
Node: Opening the Firewall31159
|
Node: Opening the Firewall31930
|
Node: Disabling Ethernet Filtering31650
|
Node: Disabling Ethernet Filtering32421
|
Node: Networking from OpenRISC Linux and BusyBox32275
|
Node: Networking from OpenRISC Linux and BusyBox33046
|
Node: Tearing Down a Bridge33937
|
Node: Tearing Down a Bridge34708
|
Node: Configuration34680
|
Node: Configuration35451
|
Node: Configuration File Format35292
|
Node: Configuration File Format36063
|
Node: Configuration File Preprocessing35677
|
Node: Configuration File Preprocessing36448
|
Node: Configuration File Syntax35974
|
Node: Configuration File Syntax36745
|
Node: Simulator Configuration38759
|
Node: Simulator Configuration39530
|
Node: Simulator Behavior39050
|
Node: Simulator Behavior39821
|
Node: Verification API Configuration43631
|
Node: Verification API Configuration44402
|
Node: CUC Configuration45571
|
Node: CUC Configuration46342
|
Node: Core OpenRISC Configuration47563
|
Node: Core OpenRISC Configuration48334
|
Node: CPU Configuration48065
|
Node: CPU Configuration48836
|
Node: Memory Configuration52184
|
Node: Memory Configuration52955
|
Node: Memory Management Configuration58906
|
Node: Memory Management Configuration59677
|
Node: Cache Configuration61283
|
Node: Cache Configuration62054
|
Node: Interrupt Configuration63669
|
Node: Interrupt Configuration64440
|
Node: Power Management Configuration65502
|
Node: Power Management Configuration66273
|
Node: Branch Prediction Configuration66779
|
Node: Branch Prediction Configuration67550
|
Node: Debug Interface Configuration68139
|
Node: Debug Interface Configuration68910
|
Node: Peripheral Configuration70482
|
Node: Peripheral Configuration71253
|
Node: Memory Controller Configuration71108
|
Node: Memory Controller Configuration71879
|
Node: UART Configuration74888
|
Node: UART Configuration75659
|
Node: DMA Configuration78407
|
Node: DMA Configuration79178
|
Node: Ethernet Configuration80274
|
Node: Ethernet Configuration81045
|
Node: GPIO Configuration84919
|
Node: GPIO Configuration85690
|
Node: Display Interface Configuration86552
|
Node: Display Interface Configuration87323
|
Node: Frame Buffer Configuration88861
|
Node: Frame Buffer Configuration89632
|
Node: Keyboard Configuration90725
|
Node: Keyboard Configuration91496
|
Node: Disc Interface Configuration92963
|
Node: Disc Interface Configuration93734
|
Node: Generic Peripheral Configuration98067
|
Node: Generic Peripheral Configuration98838
|
Node: Interactive Command Line100362
|
Node: Interactive Command Line101133
|
Node: Verification API107336
|
Node: Verification API108107
|
Node: Code Internals111766
|
Node: Code Internals112537
|
Node: Coding Conventions112349
|
Node: Coding Conventions113120
|
Node: Global Data Structures116776
|
Node: Global Data Structures117547
|
Node: Concepts119433
|
Node: Concepts120204
|
Ref: Output Redirection119578
|
Ref: Output Redirection120349
|
Ref: Interrupts Internal120116
|
Ref: Interrupts Internal120887
|
Node: Internal Debugging121269
|
Node: Internal Debugging122040
|
Node: Regression Testing121793
|
Node: Regression Testing122564
|
Node: GNU Free Documentation License125582
|
Node: GNU Free Documentation License126353
|
Node: Index147989
|
Node: Index148760
|
|
|
End Tag Table
|
End Tag Table
|
