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

Subversion Repositories openrisc

[/] [openrisc/] [trunk/] [or1ksim/] [doc/] [or1ksim.info] - Diff between revs 110 and 112

Go to most recent revision | Show entire file | Details | Blame | View Log

Rev 110 Rev 112
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-uclinux-or1ksim).      The OpenRISC 1000 Architectural
* Or1ksim: (or32-uclinux-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-06-06.tar.bz2
     tar jxf or1ksim-2010-06-09.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-06/configure --target=or32-uclinux ...
     ../or1ksim-2010-06-09/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 139... Line 139...
`--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.
 
 
`--enable-ov-flag'
 
`--disable-ov-flag'
 
     If enabled, this option causes instructions to set the overflow
 
     flag.  The instructions affected by this are `l.add', `l.addc',
 
     `l.addi', `l.and', `l.andi', `l.div', `l.divu', `l.mul', `l.muli',
 
     `l.or', `l.ori', `l.sll', `l.slli', `l.srl', `l.srli', `l.sra',
 
     `l.srai', `l.sub', `l.xor' and `l.xori'.
 
 
 
     The default is for this to be disabled.
 
 
 
          Caution: This appears a very dangerous option, to the extent
 
          of arguably being a bug.  Whether or not flags are set is
 
          part of the OpenRISC 1000 architectural specification.
 
          Within the above list, the arithmetic instructions (`l.add',
 
          `l.addc', `l.addi', `l.div', `l.divu', `l.mul', `l.muli' and
 
          `l.sub'), together with `l.addic' which is missed out, set
 
          the overflow flag.  All the others (`l.and', `l.andi',
 
          `l.or', `l.ori', `l.sll', `l.slli', `l.srl', `l.srli',
 
          `l.sra', `l.srai', `l.xor' and `l.xori') do not.
 
 
 
          Thus it is impossible to get correct behavior whichever way
 
          this option is set.
 
 
 
`--enable-arith-flag'
`--enable-arith-flag'
`--disable-arith-flag'
`--disable-arith-flag'
     If enabled, this option causes instructions to set the flag (`F'
     If enabled, this option causes instructions to set the flag (`F'
     bit) in the supervision register.  The instructions affected by
     bit) in the supervision register.  The instructions affected by
     this are `l.add', `l.addc', `l.addi', `l.and' and `l.andi'.
     this are `l.add', `l.addc', `l.addi', `l.and' and `l.andi'.
Line 207... Line 184...
 
 
     This flag is intended for those working on the test package, who
     This flag is intended for those working on the test package, who
     wish to get the missing test(s) working.
     wish to get the missing test(s) working.
 
 
 
 
 
A number of configuration flags have been removed since version 0.3.0,
 
because they led to invalid behavior of Or1ksim. Those removed include
 
 
 
`--enable-ov-flag'
 
`--disable-ov-flag'
 
     This flag used to cause certain instructions to set the overflow
 
     flag.  If not, those instructions would not set the overflow flat.
 
     The instructions affected by this were `l.add', `l.addc',
 
     `l.addi', `l.and', `l.andi', `l.div', `l.divu', `l.mul', `l.muli',
 
     `l.or', `l.ori', `l.sll', `l.slli', `l.srl', `l.srli', `l.sra',
 
     `l.srai', `l.sub', `l.xor' and `l.xori'.
 
 
 
     This guaranteed incorrect behavior.  The OpenRISC 1000 architecture
 
     specification defines which flags are set by which instructions.
 
 
 
     Within the above list, the arithmetic instructions (`l.add',
 
     `l.addc', `l.addi', `l.div', `l.divu', `l.mul', `l.muli' and
 
     `l.sub'), together with `l.addic' which is missed out, set the
 
     overflow flag.  All the others (`l.and', `l.andi', `l.or',
 
     `l.ori', `l.sll', `l.slli', `l.srl', `l.srli', `l.sra', `l.srai',
 
     `l.xor' and `l.xori') do not.
 
 
 
 


File: or1ksim.info,  Node: Build and Install,  Next: Known Issues,  Prev: Configuring the Build,  Up: Installation
File: or1ksim.info,  Node: Build and Install,  Next: Known Issues,  Prev: Configuring the Build,  Up: Installation
 
 
1.3 Building and Installing
1.3 Building and Installing
===========================
===========================
Line 246... Line 246...
 
 
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-06.  The OpenRISC tracker may be used to see the current state
2010-06-09.  The OpenRISC tracker may be used to see the current state
of these issues and to raise new problems and feature requests.  It may
of these issues and to raise new problems and feature requests.  It may
be found at `http://www.opencores.org/ptracker.cgi/view/or1k/398'.
be 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
Line 3424... Line 3424...
 
 
* --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 133)
                                                              (line 110)
* --disable-arith-flag:                  Configuring the Build.
* --disable-arith-flag:                  Configuring the Build.
                                                              (line  98)
                                                              (line  75)
* --disable-debug:                       Configuring the Build.
* --disable-debug:                       Configuring the Build.
                                                              (line 126)
                                                              (line 103)
* --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  75)
                                                              (line 123)
* --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  69)
                                                              (line  69)
* --enable-all-tests:                    Configuring the Build.
* --enable-all-tests:                    Configuring the Build.
                                                              (line 132)
                                                              (line 109)
* --enable-arith-flag:                   Configuring the Build.
* --enable-arith-flag:                   Configuring the Build.
                                                              (line  97)
                                                              (line  74)
* --enable-debug:                        Configuring the Build.
* --enable-debug:                        Configuring the Build.
                                                              (line 125)
                                                              (line 102)
* --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  74)
                                                              (line 122)
* --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 3522... Line 3522...
                                                              (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 133)
                                                              (line 110)
* Argtable2 debugging:                   Configuring the Build.
* Argtable2 debugging:                   Configuring the Build.
                                                              (line 126)
                                                              (line 103)
* 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 3677... Line 3677...
                                                              (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 126)
                                                              (line 103)
* 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 3804... Line 3804...
* 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  98)
                                                              (line  75)
* 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 3960... Line 3960...
* 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  75)
                                                              (line 123)
* 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 4214... Line 4214...
* 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 133)
                                                              (line 110)
* 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 4292... Line 4292...
                                                              (line  50)
                                                              (line  50)
 
 
 
 


Tag Table:
Tag Table:
Node: Top830
Node: Top814
Node: Installation1240
Node: Installation1224
Node: Preparation1487
Node: Preparation1471
Node: Configuring the Build1782
Node: Configuring the Build1766
Node: Build and Install7506
Node: Build and Install7464
Node: Known Issues8352
Node: Known Issues8310
Node: Usage11414
Node: Usage11372
Node: Standalone Simulator11628
Node: Standalone Simulator11586
Node: Profiling Utility14531
Node: Profiling Utility14489
Node: Memory Profiling Utility15441
Node: Memory Profiling Utility15399
Node: Simulator Library16806
Node: Simulator Library16764
Node: Configuration24584
Node: Configuration24542
Node: Configuration File Format25193
Node: Configuration File Format25151
Node: Configuration File Preprocessing25485
Node: Configuration File Preprocessing25443
Node: Configuration File Syntax25856
Node: Configuration File Syntax25814
Node: Simulator Configuration28641
Node: Simulator Configuration28599
Node: Simulator Behavior28932
Node: Simulator Behavior28890
Node: Verification API Configuration32976
Node: Verification API Configuration32934
Node: CUC Configuration34916
Node: CUC Configuration34874
Node: Core OpenRISC Configuration36833
Node: Core OpenRISC Configuration36791
Node: CPU Configuration37335
Node: CPU Configuration37293
Node: Memory Configuration41453
Node: Memory Configuration41411
Node: Memory Management Configuration47911
Node: Memory Management Configuration47869
Node: Cache Configuration50288
Node: Cache Configuration50246
Node: Interrupt Configuration52674
Node: Interrupt Configuration52632
Node: Power Management Configuration53410
Node: Power Management Configuration53368
Node: Branch Prediction Configuration54687
Node: Branch Prediction Configuration54645
Node: Debug Interface Configuration56047
Node: Debug Interface Configuration56005
Node: Peripheral Configuration60267
Node: Peripheral Configuration60225
Node: Memory Controller Configuration60893
Node: Memory Controller Configuration60851
Node: UART Configuration64307
Node: UART Configuration64265
Node: DMA Configuration67826
Node: DMA Configuration67784
Node: Ethernet Configuration69693
Node: Ethernet Configuration69651
Node: GPIO Configuration73669
Node: GPIO Configuration73627
Node: Display Interface Configuration75302
Node: Display Interface Configuration75260
Node: Frame Buffer Configuration77611
Node: Frame Buffer Configuration77569
Node: Keyboard Configuration79475
Node: Keyboard Configuration79433
Node: Disc Interface Configuration81713
Node: Disc Interface Configuration81671
Node: Generic Peripheral Configuration86656
Node: Generic Peripheral Configuration86614
Node: Interactive Command Line88951
Node: Interactive Command Line88909
Node: Verification API95925
Node: Verification API95883
Node: Code Internals100355
Node: Code Internals100313
Node: Coding Conventions100938
Node: Coding Conventions100896
Node: Global Data Structures105365
Node: Global Data Structures105323
Node: Concepts108022
Node: Concepts107980
Ref: Output Redirection108167
Ref: Output Redirection108125
Node: Internal Debugging108706
Node: Internal Debugging108664
Node: Regression Testing109230
Node: Regression Testing109188
Node: GNU Free Documentation License113025
Node: GNU Free Documentation License112983
Node: Index135432
Node: Index135390


End Tag Table
End Tag Table

powered by: WebSVN 2.1.0

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