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 or obsolete.

pdp11/
      ChangeLog                   Short log of changes
      LICENSE                     Your rights
      Makefile                    Makefile for assembler sources
      Models                      Documentation for reference

      blockramX.t1                Blockram template header - the blockram contents are generated
      blockramX.t2                Blockram template footer
      blockramt25.mac             Ancient test source - based on ZDKJ
      ..
      blockramt42.mac             Terminal source code

      cpu.vhd                     Source of the CPU
      cpuregs.vhd                 CPU register file
      cr.vhd                      Control registers - PSW, PIRQ, CER, etc
      csdr.vhd                    Switch/Display register
      fpuregs.vhd                 FP11 register file
      kw11l.vhd                   KW11L Line clock

      m9312XX.t1                  Templates for m9312-style blockrams
      m9312XX.t2                  Templates for m9312-style blockrams
      m9312h44.mac                Old PDP2011 style triple-boot: boot first present of RK, RL, RP
      m9312X46.mac                Original DEC M9312 boot code modified to accept lower case input
      m9312X47.mac                PDP2011 boot code - scan IO page and boot first present of RK, RL, RP

      mmu.vhd                     Source of the Memory Management Unit
      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
      kl11.vhd                    Serial line controller - KL11

      unibus.vhd                  Unibus - 'backplane' for CPU, MMU, peripherals and glue logic

      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

      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

      dr11c.vhd                   DR11C 'General Device' universal peripheral
      xxdp25XXXX                  Sample output from MAINDEC test runs

      de0/                        DE0 board directory
         /de0.qpf                 Quartus project file for DE0
         /pll.ppf                 PLL
         /pll.qip                 PLL
         /pll.vhd                 PLL
         /ssegdecoder.vhd         7-segment display driver
         /top.qsf                 Quartus settings file for DE0
         /top.vhd                 Top level source for DE0

      de0n/                       DE0-Nano board directory
          /de0nano.qpf            Quartus project file for DE0-Nano
          /pll.ppf                PLL
          /pll.qip                PLL
          /pll.vhd                PLL
          /top.qsf                Quartus settings file for DE0
          /top.vhd                Top level source for DE0

      de1/                        DE1 board directory
         /clkdiv50k.vhd           Obsolete?
         /pdp11w.qpf              Quartus project file for DE1
         /pll.ppf                 PLL
         /pll.qip                 PLL
         /pll.vhd                 PLL
         /ssegdecoder.vhd         7-segment display driver
         /top.qsf                 Quartus settings file for DE1
         /top.vhd                 Top level source for DE1

      de1dram/                    DE1 board directory - DRAM version
         /clkdiv50k.vhd           Obsolete?
         /pdp11d.qpf              Quartus project file for DE1
         /pll.ppf                 PLL
         /pll.qip                 PLL
         /pll.vhd                 PLL
         /ssegdecoder.vhd         7-segment display driver
         /top.qsf                 Quartus settings file
         /top.vhd                 Top level source

      de270/                      DE2-70 board directory
           /clkdiv250k.vhd        Obsolete?
           /clkdiv50k.vhd         Obsolete?
           /pdp11de2.qpf          Quartus project file for DE2-70
           /pll.ppf               PLL
           /pll.qip               PLL
           /pll.vhd               PLL
           /ssegdecoder.vhd       7-segment display driver
           /top.qsf               Quartus settings file for DE2-70
           /top.vhd               Top level source for DE2-70

      n2b1200/                    Nexys-2 1200 board directory
             /clkdiv50k.vhd
             /n2b1200.ucf         UCF for board
             /n2b1200.xise        ISE settings file
             /qsseg.vhd           7-segment driver
             /top.vhd             Top level source

      s3b1000/                    Spartan-3 board directory, -1000 chip
             /clkdiv50k.vhd
             /dsseg.vhd           7-segment driver - Digilent PMOD
             /qsseg.vhd           7-segment driver - onboard
             /s3b1000.xise        ISE settings file
             /top.ucf             UCF for board
             /top.vhd             Top level source

      s3b200/                     Spartan-3 board directory, -200 chip
            /clkdiv50k.vhd
            /qsseg.vhd            7-segment driver
            /s3b200.xise          ISE settings file
            /top.ucf              UCF for board
            /top.vhd              Top level source

      s3e500/                     Spartan-3E board directory - incomplete
            /top.ucf              UCF for board
            /top.vhd              Top level source

      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