Subversion Repositories ion

Summary of the directories and files in this project.

./

================================================================================

./files.txt                 This file

./doc                       Documentation

================================================================================

ion_project.txt             Provisional documentation in plain ascii.

./src                       C and assembler sources for some tests and demos

================================================================================

readme.txt                  Short usage instructions for the code samples

bin2hdl.py                  Python script that builds vhdl tables from bin files

ion_noxram.lds              Load script for default bare system configuration

mips_mpu_template.vhdl      Template for mpu system used in hardware demo

mips_tb1_template.vhdl      Template for simulation test bench (main template)

mips_tb0_template.vhdl      Template for sim. test bench (single memory block)

mips_tb2_template.vhdl      Template for sim. test bench (dummy cache)

./src/common                Source files common to all samples

--------------------------------------------------------------------------------

makefile                    Makefile included from all other makefiles

boot.s                      Startup code

plasma.h                    System definitions (lifted from Plasma project)

rtos.h                      More system definitions (lifted from Plasma project)

math.c                      Floating point & mul/div replacement functions

no_os.c                     Replacement for some common libc functions

./src/opcodes

--------------------------------------------------------------------------------

makefile                    Makefile

opcodes.s                   Opcode test source file

readme.txt                  Instructions

./src/hello                 Hello World sample

--------------------------------------------------------------------------------

makefile                    Makefile

hello.c                     Prints a welcome message on a terminal

readme.txt                  Instructions

./vhdl                      VHDL sources

================================================================================

mips_pkg.vhdl               Package with declarations common to all modules

mips_cpu.vhdl               Main CPU core module (excludes caches)

mips_shifter.vhdl           Barrel shifter module

mips_alu.vhdl               ALU module

mips_mult.vhdl              Multiplier/divider mudule (from Plasma)

mips_cache_stub.vhdl        'Stub', empty cache module

./vhdl/tb                   VHDL source for simulation test bench

--------------------------------------------------------------------------------

txt_util.vhdl               Utility functions for string handling

mips_tb1.vhdl               Simulation test bench (see ./doc/ion_project.txt)

mips_tb2.vhdl               Simulation test bench (see ./doc/ion_project.txt)

./vhdl/demo                 Source files for hardware demo on DE-1 board

--------------------------------------------------------------------------------

c2sb_demo.csv               Assignments file to be imported from Altera IDE

c2sb_demo.vhdl              Top level source of demo

mips_mpu.vhdl               Basic MPU system (see ./doc/ion.project.txt)

rx232_rx.vhdl               Barebones UART module for RX

rx232_tx.vhdl               Barebones UART module for TX

./sim                       Simulation scripts for Modelsim (tcl)

================================================================================

mips_tb1.do                 Runs test bench /vhdl/tb/mips_tb1.vhdl

mips_tb1_wave.do            Sub-script used to set-up Modelsim's wave window

mips_tb2.do                 Runs test bench /vhdl/tb/mips_tb2.vhdl

mips_tb2_wave.do            Sub-script used to set-up Modelsim's wave window

./syn                       Simulation and synthesis runtime stuff

================================================================================

Simulation scripts are assumed to run from here (see ./sim/readme.txt).

Besides, here is where I put the synthesis stuff.

This directory is versioned but contents are not.