| 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-06-15.tar.bz2
|
tar jxf or1ksim-0.4.0rc2.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-06-15/configure --target=or32-uclinux ...
|
../or1ksim-0.4.0rc2/configure --target=or32-uclinux ...
|
|
|
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 133... |
Line 133... |
fields in the `ethernet' section of the configuration file. *Note
|
fields in the `ethernet' section of the configuration file. *Note
|
Ethernet Configuration: Ethernet Configuration.
|
Ethernet Configuration: Ethernet Configuration.
|
|
|
The default is for this to be disabled.
|
The default is for this to be disabled.
|
|
|
|
`--enable-unsigned-xori'
|
|
`--disable-unsigned-xori'
|
|
Historically, `l.xori', has sign extended its operand. This is
|
|
inconsistent with the other logical opcodes (`l.andi', `l.ori'),
|
|
but in the absence of `l.not', it allows a register to be inverted
|
|
in a single instruction using:
|
|
|
|
`l.xori rD,rA,-1'
|
|
|
|
This flag causes Or1ksim to treat the immediate operand as
|
|
unsigned (i.e to zero-extend rather than sign-extend).
|
|
|
|
The default is to sign-extend, so that existing code will continue
|
|
to work.
|
|
|
|
Caution: The GNU compiler tool chain makes heavy use of this
|
|
instruction. Using unsigned behavior will require the
|
|
compiler to be modified accordingly.
|
|
|
|
This option is provided for experimentation. A future
|
|
version of OpenRISC may adopt this more consistent behavior
|
|
and also provide a `l.not' opcode.
|
|
|
`--enable-range-stats'
|
`--enable-range-stats'
|
`--disable-range-stats'
|
`--disable-range-stats'
|
If enabled, this option allows statistics to be collected to
|
If enabled, this option allows statistics to be collected to
|
analyse register access over time. The default is for this to be
|
analyse register access over time. The default is for this to be
|
disabled.
|
disabled.
|
| Line 233... |
Line 256... |
|
|
1.4 Known Problems and Issues
|
1.4 Known Problems and Issues
|
=============================
|
=============================
|
|
|
The following problems and issues are known about with Or1ksim
|
The following problems and issues are known about with Or1ksim
|
2010-06-15. The OpenRISC tracker may be used to see the current state
|
0.4.0rc2. The OpenRISC tracker may be used to see the current state of
|
of these issues and to raise new problems and feature requests. It may
|
these issues and to raise new problems and feature requests. It may be
|
be found at `http://www.opencores.org/ptracker.cgi/view/or1k/398'.
|
found at `http://www.opencores.org/ptracker.cgi/view/or1k/398'.
|
|
|
* The Supervision Register Little Endian Enable (LEE) bit is
|
* The Supervision Register Little Endian Enable (LEE) bit is
|
ignored. Or1ksim can be built for either little endian or big
|
ignored. Or1ksim can be built for either little endian or big
|
endian use, but that behavior cannot be changed dynamically.
|
endian use, but that behavior cannot be changed dynamically.
|
|
|
| Line 3411... |
Line 3434... |
|
|
* --cumulative: Profiling Utility. (line 26)
|
* --cumulative: Profiling Utility. (line 26)
|
* --debug-config: Standalone Simulator.
|
* --debug-config: Standalone Simulator.
|
(line 48)
|
(line 48)
|
* --disable-all-tests: Configuring the Build.
|
* --disable-all-tests: Configuring the Build.
|
(line 82)
|
(line 105)
|
* --disable-arith-flag: Configuring the Build.
|
* --disable-arith-flag: Configuring the Build.
|
(line 95)
|
(line 118)
|
* --disable-debug: Configuring the Build.
|
* --disable-debug: Configuring the Build.
|
(line 75)
|
(line 98)
|
* --disable-ethphy: Configuring the Build.
|
* --disable-ethphy: Configuring the Build.
|
(line 59)
|
(line 59)
|
* --disable-ov-flag: Configuring the Build.
|
* --disable-ov-flag: Configuring the Build.
|
(line 110)
|
(line 133)
|
* --disable-profiling: Configuring the Build.
|
* --disable-profiling: Configuring the Build.
|
(line 30)
|
(line 30)
|
* --disable-range-stats: Configuring the Build.
|
* --disable-range-stats: Configuring the Build.
|
|
(line 92)
|
|
* --disable-unsigned-xori: Configuring the Build.
|
(line 69)
|
(line 69)
|
* --enable-all-tests: Configuring the Build.
|
* --enable-all-tests: Configuring the Build.
|
(line 81)
|
(line 104)
|
* --enable-arith-flag: Configuring the Build.
|
* --enable-arith-flag: Configuring the Build.
|
(line 94)
|
(line 117)
|
* --enable-debug: Configuring the Build.
|
* --enable-debug: Configuring the Build.
|
(line 74)
|
(line 97)
|
* --enable-ethphy: Configuring the Build.
|
* --enable-ethphy: Configuring the Build.
|
(line 58)
|
(line 58)
|
* --enable-execution: Configuring the Build.
|
* --enable-execution: Configuring the Build.
|
(line 37)
|
(line 37)
|
* --enable-mprofile: Standalone Simulator.
|
* --enable-mprofile: Standalone Simulator.
|
(line 77)
|
(line 77)
|
* --enable-ov-flag: Configuring the Build.
|
* --enable-ov-flag: Configuring the Build.
|
(line 109)
|
(line 132)
|
* --enable-profile: Standalone Simulator.
|
* --enable-profile: Standalone Simulator.
|
(line 74)
|
(line 74)
|
* --enable-profiling: Configuring the Build.
|
* --enable-profiling: Configuring the Build.
|
(line 29)
|
(line 29)
|
* --enable-range-stats: Configuring the Build.
|
* --enable-range-stats: Configuring the Build.
|
|
(line 91)
|
|
* --enable-unsigned-xori: Configuring the Build.
|
(line 68)
|
(line 68)
|
* --file: Standalone Simulator.
|
* --file: Standalone Simulator.
|
(line 24)
|
(line 24)
|
* --filename: Memory Profiling Utility.
|
* --filename: Memory Profiling Utility.
|
(line 51)
|
(line 51)
|
| Line 3509... |
Line 3536... |
(line 62)
|
(line 62)
|
* 0x04 UART VAPI sub-command (UART verification): Verification API.
|
* 0x04 UART VAPI sub-command (UART verification): Verification API.
|
(line 66)
|
(line 66)
|
* 16550 (UART configuration): UART Configuration. (line 73)
|
* 16550 (UART configuration): UART Configuration. (line 73)
|
* all tests enabled: Configuring the Build.
|
* all tests enabled: Configuring the Build.
|
(line 82)
|
(line 105)
|
* Argtable2 debugging: Configuring the Build.
|
* Argtable2 debugging: Configuring the Build.
|
(line 75)
|
(line 98)
|
* ATA/ATAPI configuration: Disc Interface Configuration.
|
* ATA/ATAPI configuration: Disc Interface Configuration.
|
(line 6)
|
(line 6)
|
* ATA/ATAPI device configuration: Disc Interface Configuration.
|
* ATA/ATAPI device configuration: Disc Interface Configuration.
|
(line 88)
|
(line 88)
|
* base_vapi_id (GPIO configuration - deprecated): GPIO Configuration.
|
* base_vapi_id (GPIO configuration - deprecated): GPIO Configuration.
|
| Line 3664... |
Line 3691... |
(line 151)
|
(line 151)
|
* debug unit configuration: Debug Interface Configuration.
|
* debug unit configuration: Debug Interface Configuration.
|
(line 6)
|
(line 6)
|
* Debug Unit verification (VAPI): Verification API. (line 34)
|
* Debug Unit verification (VAPI): Verification API. (line 34)
|
* debugging enabled (Argtable2): Configuring the Build.
|
* debugging enabled (Argtable2): Configuring the Build.
|
(line 75)
|
(line 98)
|
* DejaGnu board configurations: Regression Testing. (line 35)
|
* DejaGnu board configurations: Regression Testing. (line 35)
|
* DejaGnu configuration: Regression Testing. (line 21)
|
* DejaGnu configuration: Regression Testing. (line 21)
|
* DejaGNU tests directories: Regression Testing. (line 50)
|
* DejaGNU tests directories: Regression Testing. (line 50)
|
* DejaGnu tool specific configuration: Regression Testing. (line 39)
|
* DejaGnu tool specific configuration: Regression Testing. (line 39)
|
* delayr (memory configuration): Memory Configuration.
|
* delayr (memory configuration): Memory Configuration.
|
| Line 3758... |
Line 3785... |
* Ethernet configuration: Ethernet Configuration.
|
* Ethernet configuration: Ethernet Configuration.
|
(line 6)
|
(line 6)
|
* Ethernet verification (VAPI): Verification API. (line 78)
|
* Ethernet verification (VAPI): Verification API. (line 78)
|
* Ethernet via socket, enabling: Configuring the Build.
|
* Ethernet via socket, enabling: Configuring the Build.
|
(line 59)
|
(line 59)
|
|
* exclusive-OR immediate operand: Configuring the Build.
|
|
(line 69)
|
* exe_log (simulator configuration): Simulator Behavior. (line 49)
|
* exe_log (simulator configuration): Simulator Behavior. (line 49)
|
* exe_log_end (simulator configuration): Simulator Behavior. (line 89)
|
* exe_log_end (simulator configuration): Simulator Behavior. (line 89)
|
* exe_log_file (simulator configuration): Simulator Behavior. (line 97)
|
* exe_log_file (simulator configuration): Simulator Behavior. (line 97)
|
* exe_log_fn (simulator configuration - deprecated): Simulator Behavior.
|
* exe_log_fn (simulator configuration - deprecated): Simulator Behavior.
|
(line 97)
|
(line 97)
|
| Line 3791... |
Line 3820... |
* filename (VGA configuration - deprecated): Display Interface Configuration.
|
* filename (VGA configuration - deprecated): Display Interface Configuration.
|
(line 47)
|
(line 47)
|
* firmware (ATA/ATAPI device configuration): Disc Interface Configuration.
|
* firmware (ATA/ATAPI device configuration): Disc Interface Configuration.
|
(line 117)
|
(line 117)
|
* flag setting by instructions: Configuring the Build.
|
* flag setting by instructions: Configuring the Build.
|
(line 95)
|
(line 118)
|
* floating point multiply and add: Known Issues. (line 56)
|
* floating point multiply and add: Known Issues. (line 56)
|
* floating point support: Known Issues. (line 42)
|
* floating point support: Known Issues. (line 42)
|
* frame buffer configuration: Frame Buffer Configuration.
|
* frame buffer configuration: Frame Buffer Configuration.
|
(line 6)
|
(line 6)
|
* gdb_enabled (debug interface configuration): Debug Interface Configuration.
|
* gdb_enabled (debug interface configuration): Debug Interface Configuration.
|
| Line 3947... |
Line 3976... |
* or1ksim_reset_duration: Simulator Library. (line 62)
|
* or1ksim_reset_duration: Simulator Library. (line 62)
|
* or1ksim_run: Simulator Library. (line 57)
|
* or1ksim_run: Simulator Library. (line 57)
|
* or1ksim_set_time_point: Simulator Library. (line 73)
|
* or1ksim_set_time_point: Simulator Library. (line 73)
|
* output rediretion: Concepts. (line 7)
|
* output rediretion: Concepts. (line 7)
|
* overflow flag setting by instructions: Configuring the Build.
|
* overflow flag setting by instructions: Configuring the Build.
|
(line 110)
|
(line 133)
|
* packet (ATA/ATAPI device configuration): Disc Interface Configuration.
|
* packet (ATA/ATAPI device configuration): Disc Interface Configuration.
|
(line 113)
|
(line 113)
|
* pagesize (MMU configuration): Memory Management Configuration.
|
* pagesize (MMU configuration): Memory Management Configuration.
|
(line 27)
|
(line 27)
|
* patching memory (Interactive CLI): Interactive Command Line.
|
* patching memory (Interactive CLI): Interactive Command Line.
|
| Line 4042... |
Line 4071... |
(line 41)
|
(line 41)
|
* reg_sim_reset: Concepts. (line 13)
|
* reg_sim_reset: Concepts. (line 13)
|
* register display (Interactive CLI): Interactive Command Line.
|
* register display (Interactive CLI): Interactive Command Line.
|
(line 14)
|
(line 14)
|
* register over time statistics: Configuring the Build.
|
* register over time statistics: Configuring the Build.
|
(line 69)
|
(line 92)
|
* register patching (Interactive CLI): Interactive Command Line.
|
* register patching (Interactive CLI): Interactive Command Line.
|
(line 28)
|
(line 28)
|
* regression testing: Regression Testing. (line 6)
|
* regression testing: Regression Testing. (line 6)
|
* Remote Serial Protocol: Debug Interface Configuration.
|
* Remote Serial Protocol: Debug Interface Configuration.
|
(line 20)
|
(line 20)
|
| Line 4170... |
Line 4199... |
* stall (Interactive CLI): Interactive Command Line.
|
* stall (Interactive CLI): Interactive Command Line.
|
(line 72)
|
(line 72)
|
* stall the processor (Interactive CLI): Interactive Command Line.
|
* stall the processor (Interactive CLI): Interactive Command Line.
|
(line 72)
|
(line 72)
|
* statistics, register over time: Configuring the Build.
|
* statistics, register over time: Configuring the Build.
|
(line 69)
|
(line 92)
|
* statistics, simulation (Interactive CLI): Interactive Command Line.
|
* statistics, simulation (Interactive CLI): Interactive Command Line.
|
(line 83)
|
(line 83)
|
* stats (Interactive CLI): Interactive Command Line.
|
* stats (Interactive CLI): Interactive Command Line.
|
(line 83)
|
(line 83)
|
* stepping code (Interactive CLI): Interactive Command Line.
|
* stepping code (Interactive CLI): Interactive Command Line.
|
| Line 4201... |
Line 4230... |
* test code for target: Regression Testing. (line 63)
|
* test code for target: Regression Testing. (line 63)
|
* test make file: Regression Testing. (line 27)
|
* test make file: Regression Testing. (line 27)
|
* test README: Regression Testing. (line 32)
|
* test README: Regression Testing. (line 32)
|
* testing: Regression Testing. (line 6)
|
* testing: Regression Testing. (line 6)
|
* tests, all enabled.: Configuring the Build.
|
* tests, all enabled.: Configuring the Build.
|
(line 82)
|
(line 105)
|
* timings_file (CUC configuration): CUC Configuration. (line 46)
|
* timings_file (CUC configuration): CUC Configuration. (line 46)
|
* timings_fn (CUC configuration - deprecated): CUC Configuration.
|
* timings_fn (CUC configuration - deprecated): CUC Configuration.
|
(line 46)
|
(line 46)
|
* toggle breakpoint (Interactive CLI): Interactive Command Line.
|
* toggle breakpoint (Interactive CLI): Interactive Command Line.
|
(line 57)
|
(line 57)
|
| Line 4282... |
Line 4311... |
|
|
Tag Table:
|
Tag Table:
|
Node: Top814
|
Node: Top814
|
Node: Installation1224
|
Node: Installation1224
|
Node: Preparation1471
|
Node: Preparation1471
|
Node: Configuring the Build1766
|
Node: Configuring the Build1764
|
Node: Build and Install6975
|
Node: Build and Install7876
|
Node: Known Issues7821
|
Node: Known Issues8722
|
Node: Usage10883
|
Node: Usage11782
|
Node: Standalone Simulator11097
|
Node: Standalone Simulator11996
|
Node: Profiling Utility14000
|
Node: Profiling Utility14899
|
Node: Memory Profiling Utility14910
|
Node: Memory Profiling Utility15809
|
Node: Simulator Library16275
|
Node: Simulator Library17174
|
Node: Configuration24053
|
Node: Configuration24952
|
Node: Configuration File Format24662
|
Node: Configuration File Format25561
|
Node: Configuration File Preprocessing24954
|
Node: Configuration File Preprocessing25853
|
Node: Configuration File Syntax25325
|
Node: Configuration File Syntax26224
|
Node: Simulator Configuration28110
|
Node: Simulator Configuration29009
|
Node: Simulator Behavior28401
|
Node: Simulator Behavior29300
|
Node: Verification API Configuration32445
|
Node: Verification API Configuration33344
|
Node: CUC Configuration34385
|
Node: CUC Configuration35284
|
Node: Core OpenRISC Configuration36302
|
Node: Core OpenRISC Configuration37201
|
Node: CPU Configuration36804
|
Node: CPU Configuration37703
|
Node: Memory Configuration40922
|
Node: Memory Configuration41821
|
Node: Memory Management Configuration47380
|
Node: Memory Management Configuration48279
|
Node: Cache Configuration49757
|
Node: Cache Configuration50656
|
Node: Interrupt Configuration52143
|
Node: Interrupt Configuration53042
|
Node: Power Management Configuration52879
|
Node: Power Management Configuration53778
|
Node: Branch Prediction Configuration54156
|
Node: Branch Prediction Configuration55055
|
Node: Debug Interface Configuration55516
|
Node: Debug Interface Configuration56415
|
Node: Peripheral Configuration59736
|
Node: Peripheral Configuration60635
|
Node: Memory Controller Configuration60362
|
Node: Memory Controller Configuration61261
|
Node: UART Configuration63776
|
Node: UART Configuration64675
|
Node: DMA Configuration67295
|
Node: DMA Configuration68194
|
Node: Ethernet Configuration69162
|
Node: Ethernet Configuration70061
|
Node: GPIO Configuration73138
|
Node: GPIO Configuration74037
|
Node: Display Interface Configuration74771
|
Node: Display Interface Configuration75670
|
Node: Frame Buffer Configuration77080
|
Node: Frame Buffer Configuration77979
|
Node: Keyboard Configuration78944
|
Node: Keyboard Configuration79843
|
Node: Disc Interface Configuration81182
|
Node: Disc Interface Configuration82081
|
Node: Generic Peripheral Configuration86125
|
Node: Generic Peripheral Configuration87024
|
Node: Interactive Command Line88420
|
Node: Interactive Command Line89319
|
Node: Verification API95394
|
Node: Verification API96293
|
Node: Code Internals99824
|
Node: Code Internals100723
|
Node: Coding Conventions100407
|
Node: Coding Conventions101306
|
Node: Global Data Structures104834
|
Node: Global Data Structures105733
|
Node: Concepts107491
|
Node: Concepts108390
|
Ref: Output Redirection107636
|
Ref: Output Redirection108535
|
Node: Internal Debugging108175
|
Node: Internal Debugging109074
|
Node: Regression Testing108699
|
Node: Regression Testing109598
|
Node: GNU Free Documentation License112494
|
Node: GNU Free Documentation License113393
|
Node: Index134901
|
Node: Index135800
|
|
|
End Tag Table
|
End Tag Table
|
