1 |
12 |
wfjm |
# $Id: README.txt 408 2011-09-12 19:48:36Z mueller $
|
2 |
5 |
wfjm |
|
3 |
|
|
Release notes for w11a
|
4 |
|
|
|
5 |
|
|
Table of content:
|
6 |
|
|
|
7 |
|
|
1. Documentation
|
8 |
|
|
2. Files
|
9 |
|
|
3. Change Log
|
10 |
|
|
|
11 |
|
|
|
12 |
9 |
wfjm |
1. Documentation -------------------------------------------------------------
|
13 |
5 |
wfjm |
|
14 |
|
|
More detailed information on installation, build and test can be found
|
15 |
|
|
in the doc directory, specifically
|
16 |
|
|
|
17 |
|
|
* README.txt: release notes
|
18 |
|
|
* INSTALL.txt: installation and building test benches and systems
|
19 |
|
|
* w11a_tb_guide.txt: running test benches
|
20 |
|
|
* w11a_os_guide.txt: booting operating systems
|
21 |
6 |
wfjm |
* w11a_known_issues.txt: known differences, limitations and issues
|
22 |
5 |
wfjm |
|
23 |
9 |
wfjm |
2. Files ---------------------------------------------------------------------
|
24 |
5 |
wfjm |
|
25 |
|
|
doc Documentation
|
26 |
|
|
rtl VHDL sources
|
27 |
|
|
rtl/bplib - board and component support libs
|
28 |
|
|
rtl/bplib/issi - for ISSI parts
|
29 |
|
|
rtl/bplib/micron - for Micron parts
|
30 |
|
|
rtl/bplib/nexys2 - for Digilent Nexsy2 board
|
31 |
|
|
rtl/bplib/s3board - for Digilent S3BOARD
|
32 |
|
|
rtl/ibus - ibus devices (UNIBUS peripherals)
|
33 |
|
|
rtl/sys_gen - top level designs
|
34 |
11 |
wfjm |
rtl/sys_gen/tst_rlink - top level designs for an rlink tester
|
35 |
|
|
rtl/sys_gen/tst_rlink/nexys2 - rlink tester system for Digilent Nexsy2
|
36 |
5 |
wfjm |
rtl/sys_gen/w11a - top level designs for w11a SoC
|
37 |
|
|
rtl/sys_gen/w11a/nexys2 - w11a SoC for Digilent Nexsy2
|
38 |
|
|
rtl/sys_gen/w11a/s3board - w11a SoC for Digilent S3BOARD
|
39 |
|
|
rtl/vlib - VHDL component libs
|
40 |
|
|
rtl/vlib/comlib - communication
|
41 |
|
|
rtl/vlib/genlib - general
|
42 |
|
|
rtl/vlib/memlib - memory
|
43 |
9 |
wfjm |
rtl/vlib/rbus - rri: rbus
|
44 |
|
|
rtl/vlib/rlink - rri: rlink
|
45 |
5 |
wfjm |
rtl/vlib/serport - serial port (UART)
|
46 |
|
|
rtl/vlib/simlib - simulation helper lib
|
47 |
|
|
rtl/vlib/xlib - Xilinx specific components
|
48 |
|
|
rtl/w11a - w11a core
|
49 |
|
|
tools helper programs
|
50 |
|
|
tools/bin - scripts and binaries
|
51 |
11 |
wfjm |
tools/dox - Doxygen documentation configuration
|
52 |
|
|
tools/make - make includes
|
53 |
|
|
tools/src - C++ sources
|
54 |
|
|
tools/src/librlink - basic rlink interface
|
55 |
|
|
tools/src/librlinktpp - C++ to tcl binding for rlink interface
|
56 |
|
|
tools/src/librtools - general support classes and methods
|
57 |
|
|
tools/src/librtcltools - support classes to implement Tcl bindings
|
58 |
|
|
tools/src/librutiltpp - Tcl support commands implemented in C++
|
59 |
|
|
tools/tcl - Tcl scripts
|
60 |
5 |
wfjm |
|
61 |
9 |
wfjm |
3. Change Log ----------------------------------------------------------------
|
62 |
5 |
wfjm |
|
63 |
12 |
wfjm |
- trunk (2011-09-11: svn rev 12(oc) 408(wfjm); untagged w11a_V0.531) +++++++++
|
64 |
|
|
|
65 |
|
|
- Summary
|
66 |
|
|
- Many small changes to prepare upcoming support for
|
67 |
|
|
- Spartan-6 boards (nexys3 and atlys)
|
68 |
|
|
- usage of Cypress FX2 USB interface on nexys2/3 and atlys boards
|
69 |
|
|
- no functional change of w11a CPU core or any test systems
|
70 |
|
|
|
71 |
|
|
- Changes
|
72 |
|
|
- use boost libraries instead of custom coding:
|
73 |
|
|
- boost/function and /bind for callbacks, retire RmethDscBase and RmethDsc
|
74 |
|
|
- boost/foreach for some iterator loops
|
75 |
|
|
Note: boost 1.35 and gcc 4.3 or newer is required, see INSTALL.txt
|
76 |
|
|
- module renames:
|
77 |
|
|
bplib/s3board/s3_rs232_iob_int -> bplib/bpgen/bp_rs232_2line_iob
|
78 |
|
|
bplib/s3board/s3_rs232_iob_ext -> bplib/bpgen/bp_rs232_4line_iob
|
79 |
|
|
bplib/s3board/s3_dispdrv -> bplib/bpgen/sn_4x7segctl
|
80 |
|
|
bplib/s3board/s3_humanio -> bplib/bpgen/sn_humanio
|
81 |
|
|
bplib/s3board/s3_humanio_rbus -> bplib/bpgen/sn_humanio_rbus
|
82 |
|
|
- other renames:
|
83 |
|
|
tools/bin/impact_wrapper -> tools/bin/config_wrapper
|
84 |
|
|
- reorganize Makefile includes and xflow option files
|
85 |
|
|
rtl/vlib/Makefile.ghdl -> rtl/make/generic_ghdl.mk
|
86 |
|
|
rtl/vlib/Makefile.isim -> rtl/make/generic_isim.mk
|
87 |
|
|
rtl/vlib/Makefile.xflow -> rtl/make/generic_xflow.mk
|
88 |
|
|
rtl/vlib/xst_vhdl.opt -> rtl/make/syn_s3_speed.opt
|
89 |
|
|
rtl/vlib/balanced.opt -> rtl/make/imp_s3_speed.opt
|
90 |
|
|
|
91 |
11 |
wfjm |
- trunk (2011-04-17: svn rev 11(oc) 376(wfjm); untagged w11a_V0.53) ++++++++++
|
92 |
6 |
wfjm |
|
93 |
9 |
wfjm |
- Summary
|
94 |
11 |
wfjm |
- Introduce C++ and Tcl based backend server. A set of C++ classes provide
|
95 |
|
|
the basic rlink communication promitives. Additional glue classes provide
|
96 |
|
|
a Tcl binding. This first phase contains the basic functionality needed
|
97 |
|
|
to control simple test benches.
|
98 |
|
|
- add an 'rlink exerciser' (tst_rlink) and a top level design for a Nexys2
|
99 |
|
|
board (sys_tst_rlink_n2) and a test suite implemented in Tcl.
|
100 |
|
|
|
101 |
|
|
- Note: No functional changes in w11a core and I/O system at this point!
|
102 |
|
|
The w11a demonstrator systems are still operated with the old
|
103 |
|
|
backend code (pi_rri).
|
104 |
|
|
|
105 |
|
|
- New features
|
106 |
|
|
- new directory trees for
|
107 |
|
|
- C++ sources of backend (plus make and doxygen documentation support)
|
108 |
|
|
- tools/dox - Doxygen documentation configuration
|
109 |
|
|
- tools/make - make includes
|
110 |
|
|
- tools/src/librlink - basic rlink interface
|
111 |
|
|
- tools/src/librlinktpp - C++ to tcl binding for rlink interface
|
112 |
|
|
- tools/src/librtools - general support classes and methods
|
113 |
|
|
- tools/src/librtcltools - support classes to implement Tcl bindings
|
114 |
|
|
- tools/src/librutiltpp - Tcl support commands implemented in C++
|
115 |
|
|
- VHDL sources of an 'rlink exerciser'
|
116 |
|
|
- rtl/sys_gen/tst_rlink - top level designs for an rlink tester
|
117 |
|
|
- rtl/sys_gen/tst_rlink/nexys2 - rlink tester system for Nexsy2 board
|
118 |
|
|
- Tcl sources of 'rlink exerciser'
|
119 |
|
|
- tools/tcl/rlink - defs and proc's for basic rlink functions
|
120 |
|
|
- tools/tcl/rutil - general support procs
|
121 |
|
|
- tools/tcl/rbtest - defs and proc's for rbd_tester
|
122 |
|
|
- tools/tcl/rbbram - defs and proc's for rbd_bram
|
123 |
|
|
- tools/tcl/rbmoni - defs and proc's for rbd_rbmon
|
124 |
|
|
- tools/tcl/rbs3hio - defs and proc's for s3_humanio_rbus
|
125 |
|
|
- tools/tcl/tst_rlink - defs and proc's for tst_rlink
|
126 |
|
|
- new modules
|
127 |
|
|
- rtl/vlib/rbus
|
128 |
|
|
- rbd_bram - rbus bram test target
|
129 |
|
|
- rbd_eyemon - eye monitor for serport's
|
130 |
|
|
- rbd_rbmon - rbus monitor
|
131 |
|
|
- rbd_tester - rbus tester
|
132 |
|
|
- rbd_timer - usec precision timer
|
133 |
|
|
- rtl/vlib/memlib
|
134 |
|
|
- additional wrappers for distributed and block memories added
|
135 |
|
|
- tools/bin
|
136 |
|
|
- ti_rri: Tcl driver for rlink tests and servers (will replace pi_rri)
|
137 |
|
|
|
138 |
|
|
- trunk (2011-01-02: svn rev 9(oc) 352(wfjm); untagged w11a_V0.52) +++++++++++
|
139 |
|
|
|
140 |
|
|
- Summary
|
141 |
|
|
- Introduce rbus protocol V3
|
142 |
9 |
wfjm |
- reorganize rbus and rlink modules, many renames
|
143 |
|
|
|
144 |
8 |
wfjm |
- Changes
|
145 |
|
|
- module renames:
|
146 |
9 |
wfjm |
- the rri (remote-register-interface) components were re-organized and
|
147 |
|
|
cleanly separated into rbus and rlink components:
|
148 |
|
|
rri/rb_sres_or_* -> rbus/rb_sres_or_*
|
149 |
|
|
rri/rri_core -> rlink/rlink_core
|
150 |
|
|
rri/rri_base_serport -> rlink/rlink_base_serport
|
151 |
|
|
rri/rrilib -> rbus/rblib
|
152 |
|
|
-> rlink/rlinklib
|
153 |
|
|
rri/rri_serport -> rlink/rlink_serport
|
154 |
|
|
rri/tb/rritb_sres_or_mon -> rbus/rb_sres_or_mon
|
155 |
|
|
- the rri test bench monitors were reorganized and renamed
|
156 |
|
|
rri/tb/rritb_cpmon -> rlink/rlink_mon
|
157 |
|
|
rri/tb/rritb_cpmon_sb -> rlink/rlink_mon_sb
|
158 |
|
|
rri/tb/rritb_rbmon -> rbus/rb_mon
|
159 |
|
|
rri/tb/rritb_rbmon_sb -> rbus/rb_mon_sb
|
160 |
|
|
- the rri low level test bench were also renamed
|
161 |
|
|
rri/tb/tb_rri -> rlink/tb/tb_rlink
|
162 |
|
|
rri/tb/tb_rri_core -> rlink/tb/tb_rlink_direct
|
163 |
|
|
rri/tb/tb_rri_serport -> rlink/tb/tb_rlink_serport
|
164 |
|
|
- the base modules for rlink+cext based test benches were renamed
|
165 |
|
|
rri/tb/rritb_core_cm -> rlink/tb/tbcore_rlink_dcm
|
166 |
|
|
rri/tb/rritb_core -> rlink/tb/tbcore_rlink
|
167 |
|
|
rri/tb/vhpi_rriext -> rlink/tb/rlink_cext_vhpi
|
168 |
|
|
rri/tb/cext_rriext.c -> rlink/tb/rlink_cext.c
|
169 |
|
|
|
170 |
|
|
- other rri/rbus related renames
|
171 |
|
|
bplib/s3board/s3_humanio_rri -> s3_humanio_rbus
|
172 |
|
|
w11a/pdp11_core_rri -> pdp11_core_rbus
|
173 |
|
|
|
174 |
|
|
- other renames
|
175 |
|
|
w11a/tb/tb_pdp11_core -> tb_pdp11core
|
176 |
|
|
|
177 |
|
|
- signal renames:
|
178 |
|
|
- rlink interface (defined in rlink/rlinklib.vhd):
|
179 |
|
|
- rename rlink port signals:
|
180 |
|
|
CP_* -> RL_*
|
181 |
|
|
- rename status bit names to better reflect their usage in v3:
|
182 |
|
|
ccrc -> cerr - indicates cmd crc error or other cmd level abort
|
183 |
|
|
dcrc -> derr - indicates data crc error or other data level abort
|
184 |
|
|
ioto -> rbnak - indicates rbus abort, either no ack or timeout
|
185 |
|
|
ioerr -> rberr - indicates that rbus err flag was set
|
186 |
|
|
|
187 |
|
|
- migrate to rbus protocol verion 3
|
188 |
|
|
- in rb_mreq use now aval,re,we instead of req,we
|
189 |
|
|
- basic rbus transaction now takes 2 cycles, one for address select, one
|
190 |
|
|
for data exchange. Same concept and reasoning behind as in ibus V2.
|
191 |
|
|
|
192 |
|
|
- vlib/rlink/rlink_core
|
193 |
|
|
- cerr and derr state flags now set on command or data crc errors as well
|
194 |
|
|
as on eop/nak aborts when command or wblk data is received.
|
195 |
|
|
- has now 'monitor port', RL_MONI.
|
196 |
|
|
- RL_FLUSH port removed, the flush logic is now in rlink_serport
|
197 |
|
|
|
198 |
|
|
- restructured rlink modules
|
199 |
|
|
- rlink_core is the rlink protocol engine with a 9 bit wide interface
|
200 |
|
|
- rlink_rlb2rl (new) is an adapter to a byte wide interface
|
201 |
|
|
- rlink_base (new) combines rlink_core and rlink_rlb2rl
|
202 |
|
|
- rlink_serport (re-written) is an adapter to a serial interface
|
203 |
|
|
- rlink_base_serport (renamed) combines rlink_base and rlink_serport
|
204 |
|
|
|
205 |
|
|
- New features
|
206 |
|
|
- vlib/rbus
|
207 |
|
|
- added several rbus devices useful for debugging
|
208 |
|
|
- rbd_tester: test target, used for example in test benches
|
209 |
|
|
|
210 |
11 |
wfjm |
- trunk (2010-11-28: svn rev 8(oc) 341(wfjm); untagged w11a_V0.51) +++++++++++
|
211 |
9 |
wfjm |
|
212 |
|
|
- Summary
|
213 |
11 |
wfjm |
- Introduce ibus protocol V2
|
214 |
9 |
wfjm |
- Nexys2 systems use DCM
|
215 |
|
|
- sys_w11a_n2 now runs with 58 MHz
|
216 |
|
|
|
217 |
|
|
- Changes
|
218 |
|
|
- module renames:
|
219 |
8 |
wfjm |
- in future 'box' is used for large autonomous blocks, therefore use
|
220 |
|
|
the term unit for purely sequential logic modules:
|
221 |
|
|
pdp11_abox -> pdp11_ounit
|
222 |
|
|
pdp11_dbox -> pdp11_aunit
|
223 |
|
|
pdp11_lbox -> pdp11_lunit
|
224 |
|
|
pdp11_mbox -> pdp11_munit
|
225 |
6 |
wfjm |
|
226 |
8 |
wfjm |
- signal renames:
|
227 |
|
|
- renamed RRI_LAM -> RB_LAM in all ibus devices
|
228 |
|
|
- renamed CLK -> I_CLK50 in all top level nexys2 and s3board designs
|
229 |
|
|
|
230 |
|
|
- migrate to ibus protocol verion 2
|
231 |
|
|
- in ib_mreq use now aval,re,we,rmw instead of req,we,dip
|
232 |
|
|
- basic ibus transaction now takes 2 cycles, one for address select, one
|
233 |
9 |
wfjm |
for data exchange. This avoids too long logic paths in the ibus logic.
|
234 |
8 |
wfjm |
|
235 |
|
|
- New features
|
236 |
|
|
- ibus
|
237 |
|
|
- added ib_sres_or_mon to check for miss-behaving ibus devices
|
238 |
|
|
- added ib_sel to encapsulate address select logic
|
239 |
|
|
- nexys2 systems
|
240 |
|
|
- now DCM derived system clock supported
|
241 |
|
|
- sys_gen/w11a/nexys2
|
242 |
|
|
- sys_w11a_n2 now runs with 58 MHz clksys
|
243 |
|
|
|
244 |
|
|
- Bug fixes
|
245 |
|
|
- rtl/vlib/Makefile.xflow: use default .opt files under rtl/vlib again.
|
246 |
|
|
|
247 |
11 |
wfjm |
- w11a_V0.5 (2010-07-23) +++++++++++++++++++++++++++++++++++++++++++++++++++++
|
248 |
6 |
wfjm |
|
249 |
5 |
wfjm |
Initial release with
|
250 |
|
|
- w11a CPU core
|
251 |
|
|
- basic set of peripherals: kw11l, dl11, lp11, pc11, rk11/rk05
|
252 |
|
|
- just for fun: iist (not fully implemented and tested yet)
|
253 |
|
|
- two complete system configurations with
|
254 |
|
|
- for a Digilent S3BOARD rtl/sys_gen/w11a/s3board/sys_w11a_s3
|
255 |
|
|
- for a Digilent Nexys2 rtl/sys_gen/w11a/nexys2/sys_w11a_n2
|