Subversion Repositories eco32

Notes
-----

1. Installing JTAG cable drivers under Ubuntu:
   a) When installing ISE, do NOT install any cable drivers.
   b) sudo apt-get install \
        gitk git-gui libusb-dev build-essential libc6-dev fxload
   c) git clone git://git.zerfleddert.de/usb-driver
   d) cd usb-driver
   e) make
   f) ./setup_pcusb /opt/Xilinx/14.5/ISE_DS/ISE/

2. The configuration bitstring for the FPGA is stored in the
   "Platform Flash PROM" (XCF04S). The board must therefore
   be jumpered for "Master Serial Mode" (all 3 jumpers set).

3. Here is the command which burns the configuration bitstring
   into the Platform Flash PROM:
      /opt/Xilinx/14.5/ISE_DS/ISE/bin/lin/impact -batch ./program.cmd

4. The machine monitor is stored in the "StrataFlash Parallel NOR
   Flash PROM" (28F128J3), starting at address 0x000000. The ECO32
   CPU can access the machine monitor at virtual address 0xE0000000.
   The monitor's size must not exceed 16 MB (the size of the Flash PROM).

5. In order to program the Flash PROM with the machine monitor, proceed
   as follows (very briefly, the FPGA is used as a Flash PROM programmer):
   a) Connect a serial cable to the starter board. This is needed
      in order to communicate with the Flash programmer.
   b) Transfer the MCS file you wish to program into the Flash PROM
      (in our case the monitor, ../../monitor/s3e-500/monitor.mcs)
      to the computer to which the serial cable is connected.
   c) Start a serial communication program (e.g. minicom) on the
      computer at the other end of the serial cable. The communication
      parameters must be set as follows:
         - choose the serial port to which the cable is connected
           (this is /dev/??? on my computer)
         - 115200 baud
         - 8 bits, no parity, 1 stop bit ("8N1")
         - software flow control ("XON/XOFF protocol")
         - line wrap on (otherwise you won't see all chars of long lines)
         - add linefeed on (the programmer sends CR, but not LF)
         - local echo off (the programmer does echo itself)
   d) Here is the command that loads the FPGA with the programmer:
         /opt/Xilinx/14.5/ISE_DS/ISE/bin/lin/impact -batch ./flash-500.cmd
   e)
   f)

x. The two programming tasks (FPGA bistring into Platform Flash PROM
   and monitor into Parallel NOR Flash PROM) may be carried out in
   any sequence.