XUM MIPS32-R1 Release - 14 Oct 2012
-----------------------------------

!!! Update January 1, 2014
!!! This project has moved to GitHub. No updates will be committed
!!! to the OpenCores repository, and the repository itself may become
!!! unavailable at a later time.
!!!
!!! Please visit https://github.com/grantea/mips32r1 for the latest project.


This is an OpenCores release of the XUM MIPS32 processor
from release 2.0 of the XUM project at the University of Utah.

This project provides all of the hardware and software needed to build
a MIPS32-compliant processor and several I/O peripherals all from scratch
and implement them on an FPGA. It contains a GCC- and binutils-based
cross-compiler toolchain to allow custom code to be compiled and run
on the hardware.


Directory Layout
----------------

   Hardware:
      -> MIPS32_Standalone: Processor HDL only. Top file is "Processor.v".
      
      -> XUPV5-LX110T_SoC:  Full System-on-Chip for XUPV5 board and Xilinx ISE 14.1
                            Project Navigator. Useful as a starting point for other
                            boards as well. See "HOWTO" in this directory for more
                            information.
   
   Software:
      -> demos:             Software demos for XUM
      -> toolchain:         Instructions for creating a MIPS crosscompiler toolchain
      -> xum_bootloader:    A C# implementation of the XUM bootloader.


Legal
-----

All software and hardware included in this distribution is licensed under
the GNU LGPL. See the file 'LEGAL' in this same directory for more information.


Enjoy!