Files

This page gives a short description of the files in the source distribution. ‘X’ in the filenames mark a wildcard, and files not mentioned are mostly test stuff, for a very specific purpose, or obsolete.

Source and data files
pdp11/
      ChangeLog                   Short log of changes
      LICENSE                     Your rights

Base components
      cpu.vhd                     Source of the CPU
      cpuregs.vhd                 CPU register file
      fpuregs.vhd                 FP11 register file
      cr.vhd                      Control registers - PSW, PIRQ, CER, etc
      csdr.vhd                    Switch/Display register
      kl11.vhd                    Serial line controller - KL11      
      kw11l.vhd                   KW11L Line clock
      mmu.vhd                     Source of the Memory Management Unit
      unibus.vhd                  Unibus - 'backplane' for CPU, MMU, and peripherals

Bootstraps
      m9312X46.mac                DEC M9312 boot code modified to accept lower case input
      m9312X47.mac                PDP2011 boot code - scan IO page and boot RK, RL, or RP

Disk controllers
      rh11.vhd                    RH11/RH70 mass buss controller and RP or RM disk
      rk11.vhd                    RK11 controller for upto 8 RK05 disks
      rl11.vhd                    RL11 controller for upto 4 RL02 disks
      sdspi.vhd                   Common SD card backend for the disk controllers
      
Embedded terminal
      ps2.vhd                     PS2 keyboard interface for terminal
      vga.vhd                     VGA controller for terminal
      vgacr.vhd                   VGA controller control registers for terminal
      vt.vhd                      Terminal source
      blockramt42.mac             Terminal microcode source

DEUNA Ethernet
      xu.vhd                      DEUNA controller main source
      xubl.vhd                    DEUNA controller-to-spi busmaster
      xubm.vhd                    DEUNA controller-to-main memory busmaster
      xubrt45.mac                 DEUNA microcode

MINC
      mncad.vhd                   MINC adc - frontend for adc hardware
      mnckw.vhd                   MINC clock
      mncaa.vhd                   MINC dac - frontend for dac hardware
      mncdi.vhd                   MINC digital input
      mncdo.vhd                   MINC digital output

Board directories for current boards with PiDP-11 
      cons-c1k-basic/             Board directory for Trenz CYC1000 board
      cons-c1k-rk/                CYC1000 board build variants
      cons-c1k-rl/
      cons-c1k-rh/
      cons-c1k-rhxu/

      cons-de0n-basic/            DE0-Nano with PiDP console

Board directories (other Altera/Intel)
      de0/                        DE0 (*)
      de0n/                       DE0-Nano
      de1/                        DE1 (*)
      de10l                       DE10-Lite
      de1dram/                    DE1 - DRAM version (*)
      de2/                        DE2 (**)
      de270/                      DE2-70
      
Board directories (Xilinx)
      n2b1200/                    Nexys-2 (*)
      n3b/                        Nexys-3 (*)
      s3b1000/                    Spartan-3, -1000 chip (***)
      s3b200/                     Spartan-3, -200 chip (***)
      s3e500/                     Spartan-3E (***)

      (*)                         No longer maintained but should work - but likely with limitations on model and peripherals to fit the FPGA
      (**)                        Not recently tested; I don't have access to a board
      (***)                       Obsolete, may not run current versions

Misc
      Makefile                    Makefile for assembler sources - bootstraps and VT/XU microcode
      Models                      Documentation of model differences for quick reference
      blockramX.t1                Blockram template header - the blockram contents are generated
      blockramX.t2                Blockram template footer
      blockramt25.mac             Ancient test source - based on ZKDJ

Utilities
      tools/                      Macro-11 and sdfmt - and many support files
           /INSTALL               generic GNU autoconf/automake instructions
           /bootstrap             run this script first to generate a configure script for your system
           /configure.ac          autoconf input - see bootstrap
           /dumpobj.c             Macro-11 part
           /genblkram.c           Modified Macro-11 backend that generates blockram output
           /license               your rights - note Macro-11 copyright
           /macro11.c             Macro-11 main source
           /sdfmt.c               sdfmt - stuff RL sectors into SD Card sector format