| 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-15.tar.bz2
|
tar jxf or1ksim-2011-01-05.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-15/configure --target=or32-elf ...
|
../or1ksim-2011-01-05/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 286... |
Line 286... |
* Profiling Utility::
|
* Profiling Utility::
|
* Memory Profiling Utility::
|
* Memory Profiling Utility::
|
* Trace Generation::
|
* Trace Generation::
|
* Simulator Library::
|
* Simulator Library::
|
* Ethernet TUN/TAP Interface::
|
* Ethernet TUN/TAP Interface::
|
|
* l.nop Support::
|
|
|
|
|
File: or1ksim.info, Node: Standalone Simulator, Next: Profiling Utility, Up: Usage
|
File: or1ksim.info, Node: Standalone Simulator, Next: Profiling Utility, Up: Usage
|
|
|
2.1 Standalone Simulator
|
2.1 Standalone Simulator
|
| Line 793... |
Line 794... |
|
|
* Add the library directory to `/etc/ld.so.conf'
|
* Add the library directory to `/etc/ld.so.conf'
|
|
|
|
|
|
|
File: or1ksim.info, Node: Ethernet TUN/TAP Interface, Prev: Simulator Library, Up: Usage
|
File: or1ksim.info, Node: Ethernet TUN/TAP Interface, Next: l.nop Support, Prev: Simulator Library, Up: Usage
|
|
|
2.6 Ethernet TUN/TAP Interface
|
2.6 Ethernet TUN/TAP Interface
|
==============================
|
==============================
|
|
|
When an Ethernet peripheral is configured (*note Ethernet
|
When an Ethernet peripheral is configured (*note Ethernet
|
| Line 976... |
Line 977... |
Caution: The TAP interface should not be in use when running this
|
Caution: The TAP interface should not be in use when running this
|
command. For example any OpenRISC Linux/BusyBox sessions should be
|
command. For example any OpenRISC Linux/BusyBox sessions should be
|
closed first.
|
closed first.
|
|
|
|
|
|
File: or1ksim.info, Node: l.nop Support, Prev: Ethernet TUN/TAP Interface, Up: Usage
|
|
|
|
2.7 l.nop Opcode Support
|
|
========================
|
|
|
|
The OpenRISC `l.nop' opcode can take a parameter. This has no effect
|
|
on the semantics of the opcode, but can be used to trigger side effect
|
|
behavior in a simulator. Within Or1ksim, the following parameters are
|
|
supported.
|
|
|
|
`l.nop 0'
|
|
The equivalent to `l.nop' with no parameter. Has no side effects.
|
|
|
|
`l.nop 1'
|
|
Execution of Or1ksim is terminated. This is used to implement the
|
|
library `exit' functions.
|
|
|
|
`l.nop 2'
|
|
Report the value in `r3' on the console as a 32-bit hex value.
|
|
|
|
`l.nop 3'
|
|
In earlier versions of Or1ksim this treated `r3' as a pointer to a
|
|
`printf' style format string, and regsiters `r4' through `r8' as
|
|
parameters for that format string.
|
|
|
|
This opcode is no longer supported, and has no effect if used.
|
|
|
|
`l.nop 4'
|
|
The value in `r3' is printed to standard output as an ASCII
|
|
character. All library output routines are implemented using this
|
|
opcode.
|
|
|
|
`l.nop 5'
|
|
The statistics counters are reset.
|
|
|
|
`l.nop 6'
|
|
The number of clock ticks since start of execution (a 64-bit
|
|
value) is returned in `r11' (low 32 bits) and `r12' (high 32 bits).
|
|
|
|
`l.nop 7'
|
|
The number of picoseconds per clock cycle is returned in `r11'.
|
|
This is used with `l.nop 6' to implement timing functions.
|
|
|
|
`l.nop 8'
|
|
Instruction tracing is turned on.
|
|
|
|
`l.nop 9'
|
|
Instruction tracing is turned off.
|
|
|
|
|
|
|
File: or1ksim.info, Node: Configuration, Next: Interactive Command Line, Prev: Usage, Up: Top
|
File: or1ksim.info, Node: Configuration, Next: Interactive Command Line, Prev: Usage, Up: Top
|
|
|
3 Configuration
|
3 Configuration
|
***************
|
***************
|
|
|
| Line 4283... |
Line 4335... |
* irq (VGA configuration): Display Interface Configuration.
|
* irq (VGA configuration): Display Interface Configuration.
|
(line 37)
|
(line 37)
|
* jitter (UART configuration): UART Configuration. (line 78)
|
* jitter (UART configuration): UART Configuration. (line 78)
|
* keyboard configuration: Keyboard Configuration.
|
* keyboard configuration: Keyboard Configuration.
|
(line 6)
|
(line 6)
|
|
* l.nop 0: l.nop Support. (line 12)
|
|
* l.nop 1 (end simulation): l.nop Support. (line 15)
|
|
* l.nop 2 (report): l.nop Support. (line 19)
|
|
* l.nop 3 (printf, now obsolete): l.nop Support. (line 22)
|
|
* l.nop 4 (putc): l.nop Support. (line 29)
|
|
* l.nop 5 (reset statistics counters): l.nop Support. (line 34)
|
|
* l.nop 6 (get clock ticks): l.nop Support. (line 37)
|
|
* l.nop 7 (get picoseconds per cycle): l.nop Support. (line 41)
|
|
* l.nop 8 (turn on tracing): l.nop Support. (line 45)
|
|
* l.nop 9 (turn off tracing): l.nop Support. (line 48)
|
|
* l.nop opcode effects: l.nop Support. (line 6)
|
* library version of Or1ksim: Simulator Library. (line 6)
|
* library version of Or1ksim: Simulator Library. (line 6)
|
* license for Or1ksim: GNU Free Documentation License.
|
* license for Or1ksim: GNU Free Documentation License.
|
(line 6)
|
(line 6)
|
* Linux (OpenRISC) and Ethernet: Networking from OpenRISC Linux and BusyBox.
|
* Linux (OpenRISC) and Ethernet: Networking from OpenRISC Linux and BusyBox.
|
(line 6)
|
(line 6)
|
| Line 4729... |
Line 4792... |
Node: Preparation1467
|
Node: Preparation1467
|
Node: Configuring the Build1762
|
Node: Configuring the Build1762
|
Node: Build and Install7902
|
Node: Build and Install7902
|
Node: Known Issues8668
|
Node: Known Issues8668
|
Node: Usage9723
|
Node: Usage9723
|
Node: Standalone Simulator9989
|
Node: Standalone Simulator10007
|
Node: Profiling Utility14549
|
Node: Profiling Utility14567
|
Node: Memory Profiling Utility15455
|
Node: Memory Profiling Utility15473
|
Node: Trace Generation16815
|
Node: Trace Generation16833
|
Node: Simulator Library18057
|
Node: Simulator Library18075
|
Node: Ethernet TUN/TAP Interface28489
|
Node: Ethernet TUN/TAP Interface28507
|
Node: Setting Up a Persistent TAP device29572
|
Node: Setting Up a Persistent TAP device29612
|
Node: Establishing a Bridge30247
|
Node: Establishing a Bridge30287
|
Node: Opening the Firewall31930
|
Node: Opening the Firewall31970
|
Node: Disabling Ethernet Filtering32421
|
Node: Disabling Ethernet Filtering32461
|
Node: Networking from OpenRISC Linux and BusyBox33046
|
Node: Networking from OpenRISC Linux and BusyBox33086
|
Node: Tearing Down a Bridge34708
|
Node: Tearing Down a Bridge34748
|
Node: Configuration35451
|
Node: l.nop Support35491
|
Node: Configuration File Format36063
|
Node: Configuration37001
|
Node: Configuration File Preprocessing36448
|
Node: Configuration File Format37613
|
Node: Configuration File Syntax36745
|
Node: Configuration File Preprocessing37998
|
Node: Simulator Configuration39530
|
Node: Configuration File Syntax38295
|
Node: Simulator Behavior39821
|
Node: Simulator Configuration41080
|
Node: Verification API Configuration44402
|
Node: Simulator Behavior41371
|
Node: CUC Configuration46342
|
Node: Verification API Configuration45952
|
Node: Core OpenRISC Configuration48334
|
Node: CUC Configuration47892
|
Node: CPU Configuration48836
|
Node: Core OpenRISC Configuration49884
|
Node: Memory Configuration52955
|
Node: CPU Configuration50386
|
Node: Memory Management Configuration59677
|
Node: Memory Configuration54505
|
Node: Cache Configuration62054
|
Node: Memory Management Configuration61227
|
Node: Interrupt Configuration64440
|
Node: Cache Configuration63604
|
Node: Power Management Configuration66273
|
Node: Interrupt Configuration65990
|
Node: Branch Prediction Configuration67550
|
Node: Power Management Configuration67823
|
Node: Debug Interface Configuration68910
|
Node: Branch Prediction Configuration69100
|
Node: Peripheral Configuration71253
|
Node: Debug Interface Configuration70460
|
Node: Memory Controller Configuration71879
|
Node: Peripheral Configuration72803
|
Node: UART Configuration75659
|
Node: Memory Controller Configuration73429
|
Node: DMA Configuration79178
|
Node: UART Configuration77209
|
Node: Ethernet Configuration81045
|
Node: DMA Configuration80728
|
Node: GPIO Configuration86324
|
Node: Ethernet Configuration82595
|
Node: Display Interface Configuration87957
|
Node: GPIO Configuration87874
|
Node: Frame Buffer Configuration90266
|
Node: Display Interface Configuration89507
|
Node: Keyboard Configuration92130
|
Node: Frame Buffer Configuration91816
|
Node: Disc Interface Configuration94368
|
Node: Keyboard Configuration93680
|
Node: Generic Peripheral Configuration99472
|
Node: Disc Interface Configuration95918
|
Node: Interactive Command Line101767
|
Node: Generic Peripheral Configuration101022
|
Node: Verification API108741
|
Node: Interactive Command Line103317
|
Node: Code Internals113171
|
Node: Verification API110291
|
Node: Coding Conventions113754
|
Node: Code Internals114721
|
Node: Global Data Structures118181
|
Node: Coding Conventions115304
|
Node: Concepts120838
|
Node: Global Data Structures119731
|
Ref: Output Redirection120983
|
Node: Concepts122388
|
Ref: Interrupts Internal121521
|
Ref: Output Redirection122533
|
Node: Internal Debugging122674
|
Ref: Interrupts Internal123071
|
Node: Regression Testing123198
|
Node: Internal Debugging124224
|
Node: GNU Free Documentation License126987
|
Node: Regression Testing124748
|
Node: Index149394
|
Node: GNU Free Documentation License128537
|
|
Node: Index150944
|
|
|
End Tag Table
|
End Tag Table
|
