From 290dd40d99adb6db4f5838bc97df3e9ea18e1b96 Mon Sep 17 00:00:00 2001 From: wfjm Date: Sun, 27 May 2018 11:19:30 +0200 Subject: [PATCH] use --- -## 2014-06-06: w11a_V0.60 - svn rev 25(oc) 559+(wfjm) +## 2014-06-06: w11a_V0.60 - svn rev 25(oc) 559+(wfjm) ### Summary - many documentation updates; no functional changes @@ -61,7 +61,7 @@ --- -## 2014-05-29: w11a_V0.581 - svn rev 22(oc) 556(wfjm) +## 2014-05-29: w11a_V0.581 - svn rev 22(oc) 556(wfjm) ### Summary - new reference system @@ -117,7 +117,7 @@ --- -## 2013-05-12: w11a_V0.58 - svn rev 21(oc) 518+(wfjm) +## 2013-05-12: w11a_V0.58 - svn rev 21(oc) 518+(wfjm) ### Summary - C++ and Tcl based backend server now fully functional, supports with @@ -155,7 +155,7 @@ --- -## 2013-04-27: w11a_V0.57 - svn rev 20(oc) 511(wfjm) +## 2013-04-27: w11a_V0.57 - svn rev 20(oc) 511(wfjm) ### Summary - new C++ and Tcl based backend server supports now RK11 handling @@ -188,7 +188,7 @@ --- -## 2013-04-13: w11a_V0.562 - svn rev 19(oc) 505(wfjm) +## 2013-04-13: w11a_V0.562 - svn rev 19(oc) 505(wfjm) ### Summary - V0.53 introduced a new C++ and Tcl based backend server, but only the @@ -230,7 +230,7 @@ --- -## 2013-01-06: w11a_V0.561 - svn rev 18(oc) 472(wfjm) +## 2013-01-06: w11a_V0.561 - svn rev 18(oc) 472(wfjm) ### Summary - Added simple simulation model of Cypress FX2 and test benches for @@ -254,7 +254,7 @@ --- -## 2013-01-02: w11a_V0.56 - svn rev 17(oc) 467(wfjm) +## 2013-01-02: w11a_V0.56 - svn rev 17(oc) 467(wfjm) ### Summary - re-organized handling of board and derived clocks in test benches @@ -316,7 +316,7 @@ The version of several key tools and libraries changed: --- -## 2011-12-23: w11a_V0.55 - svn rev 16(oc) 442(wfjm) +## 2011-12-23: w11a_V0.55 - svn rev 16(oc) 442(wfjm) ### Summary - added xon/xoff (software flow control) support to serport library @@ -352,7 +352,7 @@ The version of several key tools and libraries changed: --- -## 2011-12-04: w11a_V0.54 - svn rev 15(oc) 436(wfjm) +## 2011-12-04: w11a_V0.54 - svn rev 15(oc) 436(wfjm) ### Summary - added support for nexys3 board for w11a @@ -374,7 +374,7 @@ The version of several key tools and libraries changed: --- -## 2011-11-20: w11a_V0.532 - svn rev 14(oc) 428(wfjm) +## 2011-11-20: w11a_V0.532 - svn rev 14(oc) 428(wfjm) ### Summary - generalized the 'human I/O' interface for s3board,nexys2/3 and atlys @@ -401,7 +401,7 @@ The version of several key tools and libraries changed: --- -## 2011-09-11: w11a_V0.531 - svn rev 12(oc) 409(wfjm) +## 2011-09-11: w11a_V0.531 - svn rev 12(oc) 409(wfjm) ### Summary - Many small changes to prepare upcoming support for @@ -432,7 +432,7 @@ The version of several key tools and libraries changed: --- -## 2011-04-17: w11a_V0.53 - svn rev 11(oc) 376(wfjm) +## 2011-04-17: w11a_V0.53 - svn rev 11(oc) 376(wfjm) ### Summary - Introduce C++ and Tcl based backend server. A set of C++ classes provide @@ -482,7 +482,7 @@ The version of several key tools and libraries changed: --- -## 2011-01-02: w11a_V0.52 - svn rev 9(oc) 352(wfjm) +## 2011-01-02: w11a_V0.52 - svn rev 9(oc) 352(wfjm) ### Summary - Introduce rbus protocol V3 @@ -558,7 +558,7 @@ The version of several key tools and libraries changed: --- -## 2010-11-28: w11a_V0.51 - svn rev 8(oc) 341(wfjm) +## 2010-11-28: w11a_V0.51 - svn rev 8(oc) 341(wfjm) ### Summary - Introduce ibus protocol V2 @@ -599,7 +599,7 @@ The version of several key tools and libraries changed: --- -## 2010-07-23: w11a_V0.5 +## 2010-07-23: w11a_V0.5 ### Initial release with - w11a CPU core diff --git a/doc/CHANGELOG-w11a_V0.60-w11a_V0.70.md b/doc/CHANGELOG-w11a_V0.60-w11a_V0.70.md index eab417e7..d40ac578 100644 --- a/doc/CHANGELOG-w11a_V0.60-w11a_V0.70.md +++ b/doc/CHANGELOG-w11a_V0.60-w11a_V0.70.md @@ -31,7 +31,7 @@ --- -## 2015-06-21: w11a_V0.70 - svn rev 33(oc) 693(wfjm) +## 2015-06-21: w11a_V0.70 - svn rev 33(oc) 693(wfjm) ### Preface - resolved known issue V0.66-2: operation with multiple RP or RM disks @@ -86,7 +86,7 @@ --- -## 2015-06-05: w11a_V0.66 - svn rev 31(oc) 687(wfjm) +## 2015-06-05: w11a_V0.66 - svn rev 31(oc) 687(wfjm) ### Preface - Since the previous release a full set of small, medium and large sized @@ -161,7 +161,7 @@ --- -## 2015-05-14: w11a_V0.65 - svn rev 30(oc) 681(wfjm) +## 2015-05-14: w11a_V0.65 - svn rev 30(oc) 681(wfjm) ### Preface - With small RK05 or RL02 sized disks only quite reduced OS setups could @@ -290,7 +290,7 @@ --- -## 2015-03-01: w11a_V0.64 - svn rev 29(oc) 655(wfjm) +## 2015-03-01: w11a_V0.64 - svn rev 29(oc) 655(wfjm) ### Preface - The w11 project started on a Spartan-3 based Digilent S3board, and soon @@ -439,7 +439,7 @@ --- -## 2015-01-04: w11a_V0.63 - svn rev 28(oc) 629(wfjm) +## 2015-01-04: w11a_V0.63 - svn rev 28(oc) 629(wfjm) ### Summary - the w11a rbus interface used so far a narrow dynamically adjusted @@ -495,7 +495,7 @@ --- -## 2014-12-20: w11a_V0.62 - svn rev 27(oc) 614(wfjm) +## 2014-12-20: w11a_V0.62 - svn rev 27(oc) 614(wfjm) ### Summary - migrate to rlink protocol version 4 @@ -581,7 +581,7 @@ Notes: --- -## 2014-08-08: w11a_V0.61 - svn rev 25(oc) 579(wfjm) +## 2014-08-08: w11a_V0.61 - svn rev 25(oc) 579(wfjm) ### Summary - The `div` instruction gave wrong results in some corner cases when either divisor or quotient were the largest negative integer (100000 or -32768). diff --git a/doc/CHANGELOG-w11a_V0.70-w11a_V0.74.md b/doc/CHANGELOG-w11a_V0.70-w11a_V0.74.md index 4bfb2cf0..9235b93f 100644 --- a/doc/CHANGELOG-w11a_V0.70-w11a_V0.74.md +++ b/doc/CHANGELOG-w11a_V0.70-w11a_V0.74.md @@ -28,7 +28,7 @@ --- -## 2016-10-02: w11a_V0.74 - svn rev 37(oc) 811(wfjm) +## 2016-10-02: w11a_V0.74 - svn rev 37(oc) 811(wfjm) ### Preface - the current version of the memory controller for the micron `mt45w8mw16b` 'cellular ram' used on nexys2, nexys3, and nexys4 uses the asynchronous @@ -183,7 +183,7 @@ --- -## 2016-06-26: w11a_V0.73 - svn rev 36(oc) 779(wfjm) +## 2016-06-26: w11a_V0.73 - svn rev 36(oc) 779(wfjm) ### Preface - the 'basic vivado support' added with V0.64 was a minimal effort port of the code base used under ISE, leading to sub-optimal results under vivado. @@ -390,7 +390,7 @@ --- -## 2016-03-19: w11a_V0.72 - svn rev 35(oc) 746(wfjm) +## 2016-03-19: w11a_V0.72 - svn rev 35(oc) 746(wfjm) ### Preface - The new low-cost Digilent Arty board is a very attractive platform. The DDR3 memory will take some time to integrate, in this release thus @@ -498,7 +498,7 @@ --- -## 2015-12-30: w11a_V0.71 - svn rev 34(oc) 722(wfjm) +## 2015-12-30: w11a_V0.71 - svn rev 34(oc) 722(wfjm) ### Preface - the w11a so far lacked any 'hardware debugger' support, which made the debugging of CPU core issues a bit tedious. This release added a first diff --git a/doc/CHANGELOG.md b/doc/CHANGELOG.md index 22175a4f..81e006c3 100644 --- a/doc/CHANGELOG.md +++ b/doc/CHANGELOG.md @@ -10,7 +10,7 @@ --- -## HEAD +## HEAD ### General Proviso The HEAD version shows the current development. No guarantees that software or firmware builds or that the documentation is consistent. @@ -22,7 +22,7 @@ The full set of tests is only run for tagged releases. They are now consistent with the License.txt file, which refers to GPL V3. - Added Unix 7th Edition oskit; rename 5th Edition kit - u5ed_rk: renamed from unix-v5_rk - - u7ed_rp: added, very preliminary, boots on CmodA7, further testing be be done + - u7ed_rp: added, very preliminary, boots on CmodA7, further testing needed - Add Digilent Cmod A7 (35 die size) support - general board support - c7_sram_memctl: SRAM memory controller (incl tb) @@ -55,7 +55,7 @@ The full set of tests is only run for tagged releases. --- -## 2017-06-04: [w11a_V0.75](https://github.com/wfjm/w11/releases/tag/w11a_V0.75) - rev 904(wfjm) +## 2017-06-04: [w11a_V0.75](https://github.com/wfjm/w11/releases/tag/w11a_V0.75) - rev 904(wfjm) ### Summary - the only device class missing so far for the w11 was *network interfaces*. @@ -237,7 +237,7 @@ The full set of tests is only run for tagged releases. --- -## 2017-01-07: [w11a_V0.742](https://github.com/wfjm/w11/releases/tag/w11a_V0.742) - rev 841(wfjm) +## 2017-01-07: [w11a_V0.742](https://github.com/wfjm/w11/releases/tag/w11a_V0.742) - rev 841(wfjm) ### Summary - fixes for Vivado 2016.4; all designs build under vivado 2016.4 @@ -249,7 +249,7 @@ The full set of tests is only run for tagged releases. --- -## 2016-12-23: [w11a_V0.741](https://github.com/wfjm/w11/releases/tag/w11a_V0.741) - rev 826(wfjm) +## 2016-12-23: [w11a_V0.741](https://github.com/wfjm/w11/releases/tag/w11a_V0.741) - rev 826(wfjm) ### Summary - moved w11 repository from OpenCores to GitHub [wfjm/w11](https://github.com/wfjm/w11/) diff --git a/doc/INSTALL.md b/doc/INSTALL.md index c96b9ec4..d2f73d10 100644 --- a/doc/INSTALL.md +++ b/doc/INSTALL.md @@ -14,7 +14,7 @@ - [Available bitkits with bit and log files](#user-content-bitkits) - [Generate Doxygen based source code view](#user-content-build-doxy) -### Download +### Download All instructions below assume that the project files reside in a working directory with the name represented as `` @@ -43,7 +43,7 @@ Prior to October 2016 the project was maintained on OpenCores, access to the legacy svn repository is described in [INSTALL_from_opencores.md](INSTALL_from_opencores.md). -### System requirements +### System requirements This project contains not only VHDL code but also support software. Therefore quite a few software packages are expected to be installed. The following @@ -78,7 +78,7 @@ distributions should be straight forward. required, version 1.8.3.1 or later -### Setup environment variables +### Setup environment variables The make flows for building test benches (ghdl, Vivado xsim or ISE ISim based) and FPGA bit files (with Vivado or ISE) as well as the support software @@ -121,7 +121,7 @@ read next section. For Cypress FX2 (on Nexys2/3) related setup see [INSTALL_fx2_support.md](INSTALL_fx2_support.md). -### Compile UNISIM/UNIMACRO/SIMPRIM libraries for ghdl +### Compile UNISIM/UNIMACRO/SIMPRIM libraries for ghdl The build system for test benches also supports test benches run against the gate level models derived after synthesis or place&route. In this case ghdl @@ -130,9 +130,9 @@ The details are described in - [README_buildsystem_Vivado.md](README_buildsystem_Vivado.md#user-content-ghdllibs) - [README_buildsystem_ISE.md](README_buildsystem_ISE.md#user-content-ghdllibs) -### Compile and install the support software +### Compile and install the support software -#### Compile sharable libraries +#### Compile sharable libraries Note: some `c++11` features are used in the code @@ -175,7 +175,7 @@ To cleanup, e.g. before a re-build rm_dep make realclean -#### Setup Tcl environment +#### Setup Tcl environment The Tcl files are organized in several packages. To create the Tcl package files (`pkgIndex.tcl`) @@ -200,7 +200,7 @@ To use them simply copy them into your home directory (or soft link them) ln -s $RETROBASE/tools/tcl/.tclshrc . ln -s $RETROBASE/tools/tcl/.wishrc . -### The build system +### The build system The generation of FPGA firmware and test benches is based on make flows. @@ -215,7 +215,7 @@ can be found under - [README_buildsystem_ISE.md](README_buildsystem_ISE.md) for Spartan-3 and Spartan-6 based designs -### Available designs +### Available designs Ready to build designs are organized in the directories @@ -242,7 +242,7 @@ with in most cases - `` = `` - `` = 2 letter abbreviation for the board, e.g. n4 for nexys4. -### Available bitkits with bit and log files +### Available bitkits with bit and log files Tarballs with ready to use bit files and all logfiles from the tool chain can be downloaded from @@ -281,7 +281,7 @@ file names contain information about release, Xlinix tool, and design: xtwi config_wrapper --board=s3board iconfig .bit -### Generate Doxygen based source code view +### Generate Doxygen based source code view Currently there is not much real documentation included in the source files. The doxygen generated html output is nevertheless very useful diff --git a/doc/INSTALL_fx2_support.md b/doc/INSTALL_fx2_support.md index a1bf7c21..ae31c485 100644 --- a/doc/INSTALL_fx2_support.md +++ b/doc/INSTALL_fx2_support.md @@ -12,7 +12,7 @@ installation of tools, environment setup and generation of the FX2 firmware. - [Setup USB access](#user-content-usb-access) - [Rebuild Cypress FX2 firmware](#user-content-fx2-firmware) -### System requirements +### System requirements the download contains pre-build firmware images for the Cypress FX2 USB Interface. Re-building them requires @@ -23,7 +23,7 @@ USB Interface. Re-building them requires is **broken in Ubuntu 16.04**. See [INSTALL_urjtag.md](INSTALL_urjtag.md) for installation from sources !! -### Setup environment variables +### Setup environment variables The default USB VID and PID is defined by two environment variables. For internal lab use one can use @@ -36,7 +36,7 @@ For internal lab use one can use > misuse of the defaults provided with the project sources. > Usage of this VID/PID in any commercial product is forbidden.** -### Setup USB access +### Setup USB access For using the Cypress FX2 USB interface on Digilent Nexys2, Nexys3 and Atlys boards `udev` rules must be setup to allow user level access to @@ -51,7 +51,7 @@ Notes: described above. If a different VID/PID is used the file must be modified. - your user account must be in group `plugdev` (should be the default). -### Rebuild Cypress FX2 firmware +### Rebuild Cypress FX2 firmware The download includes pre-build firmware images for the Cypress FX2 USB interface used on the Digilent Nexys2, Nexys3 and Atlys Boards. diff --git a/doc/README_buildsystem_ISE.md b/doc/README_buildsystem_ISE.md index 979f903b..ceb5124d 100644 --- a/doc/README_buildsystem_ISE.md +++ b/doc/README_buildsystem_ISE.md @@ -14,7 +14,7 @@ - [Configuring FPGAs (directly via config_wrapper)](#user-content-config-wrap) - [Note on Artix-7 based designs](#user-content-artix) -### Concept +### Concept This projects uses GNU make to - generate bit files (synthesis with xst and place&route with par) @@ -58,9 +58,9 @@ maintained. For more details on vbomconv consult the man page. -### Setup system environment +### Setup system environment -#### Setup environment variables +#### Setup environment variables The build flows require the environment variables: - `RETROBASE`: must refer to the installation root directory @@ -78,7 +78,7 @@ Notes: - don't run the ISE setup scripts ..../settings(32|64).sh in your working shell. Setup only `XTWI_PATH` ! -#### Compile UNISIM/UNIMACRO/SIMPRIM libraries for ghdl +#### Compile UNISIM/UNIMACRO/SIMPRIM libraries for ghdl A few entities use `UNISIM` or `UNIMACRO` primitives, and models derived after the par step require also `SIMPRIM` primitives. In these cases ghdl has to @@ -99,13 +99,13 @@ Two helper scripts will create these libraries: Run these scripts for each ISE version which is installed. -### Building test benches +### Building test benches The build flows support two simulators - ghdl -> open source, with VHPI support, doesn't accept sdf files - ISE ISim -> limited to 50k lines in WebPack, no VHPI support -#### With ghdl +#### With ghdl To compile a ghdl based test bench named `` all is needed is @@ -138,7 +138,7 @@ Notes: - post-par simulations without timing annotation often fail, most likely due to clocking and delta cycle issues due to inserted clock buffers. -#### With ISE ISim +#### With ISE ISim To compile a ISE ISim based test bench named `` all is needed is @@ -165,7 +165,7 @@ Notes: Since VHPI is used in the rlink simulation all system test benches with an rlink interface, thus most, will only run with ghdl and not with ISim. -### Building FPGA bit files +### Building FPGA bit files To generate a bit file for a system named `` all is needed is @@ -203,7 +203,7 @@ use the make target after a re-build. -### Configuring FPGAs (via make flow) +### Configuring FPGAs (via make flow) The make flow supports also loading the bitstream into FPGAs, either via Xilinx Impact, or via the Cypress FX2 USB controller is available. @@ -223,7 +223,7 @@ to a version matching the FPGA design, generate a .svf file from the .bit file, and configure the FPGA. In case the bit file is out-of-date the whole design will be re-implemented before. -### Configuring FPGAs (directly via `config_wrapper`) +### Configuring FPGAs (directly via `config_wrapper`) The make flow described above uses two scripts @@ -233,7 +233,7 @@ The make flow described above uses two scripts which can be used directly for loading available bit or svf files into the FPGA. For detailed documentation see the respective man pages. -### Note on Artix-7 based designs +### Note on Artix-7 based designs The development for Nexys4 started with ISE, but has now fully moved to Vivado. The make files for the ISE build flows have been kept for comparison diff --git a/doc/README_buildsystem_Vivado.md b/doc/README_buildsystem_Vivado.md index fcc7dee8..de58d4f5 100644 --- a/doc/README_buildsystem_Vivado.md +++ b/doc/README_buildsystem_Vivado.md @@ -14,7 +14,7 @@ - [Configuring FPGAs (via make flow)](#user-content-config-fpga) - [Note on ISE](#user-content-ise) -### Concept +### Concept This projects uses GNU `make` to - generate bit files (with Vivado synthesis) @@ -60,9 +60,9 @@ maintained. For more details on `vbomconv` consult the man page. -### Setup system environment +### Setup system environment -#### Setup environment variables +#### Setup environment variables The build flows require the environment variables: - `RETROBASE`: must refer to the installation root directory @@ -77,7 +77,7 @@ Notes: - don't run the Vivado setup scripts ..../settings(32|64).sh in your working shell. Setup only XTWV_PATH ! -#### Compile UNISIM/UNIMACRO libraries for ghdl +#### Compile UNISIM/UNIMACRO libraries for ghdl A few entities use `UNISIM` or `UNIMACRO` primitives, and post synthesis models require also `UNISIM` primitives. In these cases ghdl has to link against a @@ -103,11 +103,11 @@ Notes: However: under ISE `SIMPRIM` was available in vhdl, but ghdl did never accept the sdf files, making ghdl timing simulations impossible under ISE too. -### Building test benches +### Building test benches The build flows currently supports ghdl and the vivado simulator xsim. -#### With ghdl +#### With ghdl To compile a ghdl based test bench named `` all is needed is @@ -143,7 +143,7 @@ Notes: - Many post-synthesis functional currently fail due to startup and initialization problems (see issue V0.73-2). -#### With Vivado xsim +#### With Vivado xsim To compile a Vivado xsim based test bench named all is needed is @@ -174,7 +174,7 @@ Notes: simulations currently fail due to startup and initialization problems (see issue V0.73-2). -### Building FPGA bit files +### Building FPGA bit files To generate a bit file for a system named `` all is needed is @@ -215,7 +215,7 @@ If only the post synthesis, optimize or route design checkpoints are wanted make _opt.dcp make _rou.dcp -### Building vivado projects, creating gate level models +### Building vivado projects, creating gate level models Vivado is used in 'project mode', whenever one of the targets mentioned above is build a vivado project is freshly created in the directory @@ -250,7 +250,7 @@ Specifically For timing model verilog file an associated sdf file is also generated. -### Configuring FPGAs +### Configuring FPGAs The make flow supports also loading the bitstream into FPGAs via the Vivado hardware server. Simply use @@ -259,7 +259,7 @@ Vivado hardware server. Simply use Note: works with Arty, Basys3, and Nexys4, only one board must connected. -### Note on ISE +### Note on ISE The development for Nexys4 started with ISE, but has now fully moved to Vivado. The make files for the ISE build flows have been kept for comparison diff --git a/doc/w11a_known_issues.md b/doc/w11a_known_issues.md index 438c71a8..91535eba 100644 --- a/doc/w11a_known_issues.md +++ b/doc/w11a_known_issues.md @@ -11,7 +11,7 @@ This file descibes issues of the w11 CPU. - [Known limitations](#user-content-lim) - [Known bugs](#user-content-bug) -### Known differences between w11a and KB11-C (11/70) +### Known differences between w11a and KB11-C (11/70) - the `SPL` instruction in the 11/70 always fetched the next instruction regardless of pending device or even console interrupts. This is known @@ -43,7 +43,7 @@ All four points relate to very 11/70 specific behaviour, no operating system depends on them, therefore they are considered acceptable implementation differences. -### Known limitations +### Known limitations - some programs use timing loops based on the execution speed of the original processors. This can lead to spurious timeouts, especially @@ -56,7 +56,7 @@ differences. **--> a 'watch dog' mechanism will be added in a future version which suspends the CPU when the server doesn't respond fast enough.** -### Known bugs +### Known bugs - **TCK-038 pri=H: DL11: output chars lost** Part of the output can be lost when `xxdp` test `eqkce1` is run on FPGA, also diff --git a/doc/w11a_os_guide.md b/doc/w11a_os_guide.md index 6bf3e6a7..a747f12c 100644 --- a/doc/w11a_os_guide.md +++ b/doc/w11a_os_guide.md @@ -10,7 +10,7 @@ - [Unix systems](#user-content-oskits-unix) - [DEC operating systems](#user-content-oskits-dec) -### I/O emulation setup +### I/O emulation setup All UNIBUS peripherals which exchange data (currently DL11, LP11, PC11, RK11, RL11, RPRH, TM11, and DENUA ) are currently emulated via a backend process. The @@ -61,7 +61,7 @@ Recommended setup for best performance (boards ordered by vintage): | Nexys2 | Cypress FX2 USB | USB2.0 speed | 30000 kB/sec | | S3board | RS232+USB-RS232 cable | 460k Baud | 41 kB/sec | -### FPGA Board setup +### FPGA Board setup Recommended setups @@ -95,7 +95,7 @@ Recommended setups - connect a JTAG programmer (e.g. Xilinx USB Cable II) to JTAG pins - to configure via ISE Impact `make .iconfig` -### Rlink and Backend Server setup +### Rlink and Backend Server setup All examples below use the same basic setup @@ -190,7 +190,7 @@ All examples below use the same basic setup 0 -> DISPREG 1 -> DR emulation -### simh simulator setup +### simh simulator setup Sometimes it is good to compare the w11a behavior with the PDP-11 software emulator from the simh project (see http://simh.trailing-edge.com/). @@ -222,7 +222,7 @@ All examples below use the same basic setup pdp11 _boot.scmd -### oskits +### oskits Ready to be used 'oskits' are provided under @@ -231,7 +231,7 @@ Ready to be used 'oskits' are provided under The tarballs with the disk images are provided from a web server and have to be installed separately. -### Unix systems +### Unix systems #### Legal and license issues @@ -258,7 +258,7 @@ Several oskits are provided: For further details consult the `README.md` file in the oskit directory. -### DEC operating systems +### DEC operating systems #### Legal and license issues diff --git a/doc/w11a_tb_guide.md b/doc/w11a_tb_guide.md index 137de0cb..ebadafca 100644 --- a/doc/w11a_tb_guide.md +++ b/doc/w11a_tb_guide.md @@ -18,7 +18,7 @@ - For timing simulations only Vivado xsim can be used. - ISE isim is also available, but considered legacy support -### Tests bench environment +### Tests bench environment All test benches have the same simple structure: @@ -53,7 +53,7 @@ All test benches have the same simple structure: of the vivado flow and [README_buildsystem_ISE.md](README_buildsystem_ISE.md) for the ISE flow. -### Unit test benches +### Unit test benches All unit test are executed via `tbw` (test bench warpper) script. @@ -73,7 +73,7 @@ All unit test are executed via `tbw` (test bench warpper) script. tbw|tbfilt pipe. This script also checks with `make` whether the test bench is up-to-date or must be (re)-compiled. -### System test benches +### System test benches The system tests allow to verify to verify a full system design. In this case vhdl test bench code contains @@ -93,7 +93,7 @@ In general the script `tbrun_tbwrri` is used to generate the quite lengthy command to properly setup the tbw|tbfilt pipe. This script also checks with `make` whether the test bench is up-to-date or must be (re)-compiled. -### Test bench driver +### Test bench driver All available tests (unit and system test benches) are described in a set of descriptor files, usually called `tbrun.yml`. The top level file @@ -123,7 +123,7 @@ selection via `--tag`. Very helpful is which gives a listing of all available test. The tag list as well as the shell commands to execute the test are shown. -### Execute all available tests +### Execute all available tests As stated above it is in general better to to separate the model building (make phase) made model execution (run phase). The currently recommended @@ -162,7 +162,7 @@ It should look like 76m 0m00.083s c 1121 0 PASS tb_pdp11core_bsim_ubmap.log 76m 0m00.068s c 1031 0 PASS tb_rlink_tba_pdp11core_bsim_ibdr.log -### Available unit test benches +### Available unit test benches tbrun --tag=comlib # comlib unit tests tbrun --tag=serport # serport unit tests @@ -173,7 +173,7 @@ It should look like tbrun --tag=cram_memctl # CRAM controller unit tests tbrun --tag=w11a # w11a unit tests -### Available system test benches +### Available system test benches tbrun --tag=sys_tst_serloop.* # all sys_tst_serloop designs tbrun --tag=sys_tst_rlink # all sys_tst_rlink designs