P8X32A Emulation on DE2-115 and DE0-Nano
----------------------------------------

There are three sub-directories in this .zip file: one
for the DE2-115, one for the DE0-Nano, and one for the
BeMicroCV. They each contain an identical set of Verilog
and AHDL files, along with unique .qsf and .cof files to
differentiate the pinouts and programming images for the
three different FPGA boards.

To compile for an FPGA board, go into the appropriate
directory and follow the instructions in the readme.txt
file. After compilation and download, the FPGA board will
behave like a P8X32A Propeller chip, according to the
pinout shown in the .png file. The emulated P8X32A chip
will behave as if a 5MHz input is fed into the XI pin.
This allows normal 80MHz operation when PLL16X is used.
You can progam the 'chip' via the normal Propeller Tool
software by plugging a PropPlug into the pins outlined
in the .png file.

If you've ever wondered how the Propeller chip actually
works, it's all in front of you now, and malleable.

In this directory are the original .src files which
contain the program code that exists in the P8X32A's
ROM. You must rename them to .spin files and put a
'PUB anyname' at their top before compiling them in
the Propeller Tool. They are not directly executable,
but are provided to show you what went into the ROM:

interpreter.src		begins at $F004
booter.src		begins at $F800
runner.src		butts up against $FFFF

To properly view the Verilog and AHDL source files, be
sure to set the tab size to 4 spaces in Quartus II via:

Tools | Options... | Text Editor



Revision Notes:
---------------

08/11/2014 - Fixed bug in reset for dira register (cog.v).
             Added support for the BeMicroCV board.
08/06/2014 - First public release.