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

Subversion Repositories openrisc

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

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

Line No. Rev Author Line
1 82 jeremybenn
                              Or1ksim Test Suite
2
                              ==================
3
 
4
This is the Or1ksim test suite, which is now integrated with the main Or1ksim
5
development package. It operates using a standard DejaGNU framework within the
6
GNU autoconf/automake/libtool structure.
7
 
8 90 jeremybenn
A separate configuration file is needed for the OpenRISC programs used in
9
testing, since these use the OR1K tool chain, rather than the host tool
10
chain. This can be found in the "test-code-or1k" directory.
11 82 jeremybenn
 
12 90 jeremybenn
Tests are provided for the standalone simulator (or1ksim) and for the library
13
(libsim.a).
14 82 jeremybenn
 
15 460 jeremybenn
At the time of writing a total of 2,447 tests compile, run and pass. That
16
figure is broken down into 2,185 tests of the standalone simulator and 262
17 116 jeremybenn
tests of the library
18 90 jeremybenn
 
19 82 jeremybenn
Configuration and make files are provided for further test programs. These
20
come in three categories.
21
- Tests which compile correctly, but will not run to completion.
22
- Tests which compile, but will not run at all.
23
- Tests which will not compile correctly.
24
 
25
File Organization
26
=================
27
 
28 90 jeremybenn
Each test program has its own directory under test-code (for native tests,
29
typically of the library) or test-code-or1k (for OpenRISC code, which must use
30
the OpenRISC tool chain). This builds the test program. If necessary it copies
31
data files to the main build/testsuite directory.
32 82 jeremybenn
 
33 90 jeremybenn
Each test then has a DejaGNU expect script in or1ksim.tests (for standalone
34
tests) and libsim.tests (for library tests), which loads and runs the
35
test. Support script procedures are in lib/or1ksim.exp and lib/libsim.exp.
36 82 jeremybenn
 
37
Libraries
38
=========
39
 
40
Within the test-code there are several libraries:
41
 
42
support:    A minimal C library.
43
except:     Exception handling and startup code.
44
mc-common:  A library to support the memory controller tests.
45
 
46
Working tests
47
=============
48
 
49 460 jeremybenn
Tests of standalone Or1ksim:
50 104 jeremybenn
 
51 107 jeremybenn
basic:             8 tests of a wide range of instructions and registers.
52 460 jeremybenn
cache:            11 tests of the Or1ksim cache modeling
53 107 jeremybenn
cbasic:           19 tests of minimal C functionality
54
cfg:              12 tests of the OR1K configuration register
55
dhry:              1 Dhrystone 2.1 benchmark using Or1ksim's timing facility.
56
dmatest:           3 tests of DMA.
57
eth:              12 tests of the Ethernet interface.
58
except-test:       7 tests of OR1K exception handling
59
exit:              1 test that C program exits correctly
60
ext:             104 tests of the sign extension (l.ext) instructions.
61
fbtest:            1 test of the frame buffer.
62 460 jeremybenn
flag:              1 test of Supervision Register (SR) flag bits.
63 107 jeremybenn
fp               337 tests of floating point functionality (Feature 413).
64
functest:         11 tests of the C function calling interface.
65
inst-set-test:       A collection of tests of individual instructions
66 118 jeremybenn
  is-add-test    213 tests of the l.add* instructions (Bugs 1771, 1776)
67 124 jeremybenn
  is-and-test     80 tests of the l.and* instructions (Bugs 1782-1784)
68 118 jeremybenn
  is-div-test:   101 tests of the l.div and l.divu instructions (Bug 1770).
69 115 jeremybenn
  is-find-test:   14 tests of the l.ff1 and l.fl1 instructions (Bug 1772).
70 121 jeremybenn
  is-jump-test:   27 tests of the jump instructions (Bug 1775).
71 107 jeremybenn
  is-lws-test:    13 tests of the l.lws instruction (Bug 1767).
72 118 jeremybenn
  is-mac-test:   189 tests of the MAC instructions (Bugs 1773, 1777).
73
  is-mul-test:   186 tests of the l.mul* instructions (Bug 1774).
74 124 jeremybenn
  is-or-test      80 tests of the l.or* instructions (Bugs 1782-1784)
75 122 jeremybenn
  is-ror-test:    36 tests of the l.ror and l.rori instructions (Bug 1778).
76 124 jeremybenn
  is-shift-test: 344 tests of the shift instructions (Bug 1782-1784).
77 123 jeremybenn
  is-spr-test:    28 tests of the l.mfspr and l.mtspr instructions (Bug 1779).
78 124 jeremybenn
  is-sub-test     58 tests of the l.sub instruction (Bugs 1782-1784)
79
  is-xor-test     80 tests of the l.xor* instructions (Bugs 1782-1784)
80 460 jeremybenn
int-test:         88 tests of the programmable interrupt controller.
81
kbdtest:          26 tests of the PS2 keyboard interface.
82
local-global:      1 test of C local and global variables.
83 107 jeremybenn
mem-test:         16 tests of simple memory access.
84 460 jeremybenn
mmu:              12 tests of the MMU.
85 107 jeremybenn
mul:               5 tests of the multiply functionality.
86
mycompress:        1 test using a compression program.
87 234 jeremybenn
testfloat         40 tests of detailed floating point behavior
88 107 jeremybenn
tick:             19 tests of the OR1K tick timer.
89 556 julius
pcu:              27 tests of the OR1K performance counters unit.
90 104 jeremybenn
 
91 460 jeremybenn
Tests of the libsim library:
92 82 jeremybenn
 
93 104 jeremybenn
int-edge:               6 tests of edge triggered interrupts.
94 432 jeremybenn
int-level:              3 tests of level triggered interrupts.
95 104 jeremybenn
lib-iftest:             1 test  of the basic library interface functions.
96 98 jeremybenn
jtag-basic:            17 tests of JTAG reset and instruction selection
97
jtag-go-command-read:  60 tests of JTAG GO_COMMAND for reading
98
jtag-go-command-write: 54 tests of JTAG GO_COMMAND for writing
99
jtag-read-command:     18 tests of JTAG READ_COMMAND
100 104 jeremybenn
jtag-read-control:      8 tests of JTAG READ_CONTROL
101 98 jeremybenn
jtag-select-module:    20 tests of JTAG module selection
102
jtag-write-command:    58 tests of JTAG WRITE_COMMAND
103
jtag-write-control:    13 tests of JTAG WRITE_CONTROL
104 104 jeremybenn
upcalls:                2 tests of the upcall interface.
105 93 jeremybenn
 
106 82 jeremybenn
Tests which build, but do not run to completion
107
===============================================
108
 
109 93 jeremybenn
The following tests of standalone Or1ksim rely on VAPI in Or1ksim, so need a
110
client to provide test data over TCP/IP.
111 82 jeremybenn
 
112
acv-gpio:  a test of the GPIO.
113
acv-uart:  a test of the UART
114
 
115
Tests which build, but do not run at all
116
========================================
117
 
118 93 jeremybenn
These tests of standalone Or1ksim (which are built by the make file), do not
119
appear to run at all. The problem is in the linker script and/or the
120
configuration for Or1ksim.
121 82 jeremybenn
 
122
mc-async:  a test of the memory controller with asynchronous memory.
123
mc-dram:   a test of the memory controller with DRAM.
124
mc-ssram:  a test of the memory controller with SSRAM.
125
mc-sync:   a test of the memory controller with synchronous memory.
126
uOS:       a microKernel.
127
 
128
Tests which do not build
129
========================
130
 
131 93 jeremybenn
The following test of standalone Or1ksim builds with a myriad of warnings.
132 82 jeremybenn
 
133
inst-set-test:  a comprehensive test of the instruction set using C.
134
 
135
 
136 93 jeremybenn
Updated by Jeremy Bennett (jeremy@jeremybennett.com)
137 556 julius
Updated by Julius Baxter (julius@opencores.org)
138
6 June 2011

powered by: WebSVN 2.1.0

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