p12dev is a hardware and sofware development environment for p1516 and p2223 soft processors. It includes verilog models of the processors, implementation ready code for a microcomputer equipped with a monitor program, and software development tools, including an assembler and function library.
- 64 bit operating system (Windows or *nix like OS)
- GNU Make
- Icarus verilog
- GtkWave (on windows inlcuded in Icarus)
- PHP-CLI
- uCsim
- TeraTerm (on windows), xfce4-terminal and telnet (on *nix)
- Vivado
Open prj.mk file with a text editor and set project parameters:
-
PRGname of the assembly source file, without .asm extension. If it is in a subdirectory, path must be used. -
INSTSnumber of instructions to simulate.
Create a file with name used in PRG parameter and with .asm
extension and develop your software. Use CPU instructions documented in
and use assembler features and directives according to
Open a command window, navigate to development system root directory, and issue
make
command. It will
- compile your assembly source
- compile hardware model
- run verilog simulation and generate VCD file
- open VCD file viewer (gtkwave).
The compilation finishes when you close gtkwave window, then you will got the command prompt back.
make progs ; compile monitor and examples
make sw ; compile your app only
make hw ; compile hardware model only
make compile ; compile hw and sw without simulation
make sim ; run simulation
make show ; open gtkwave and show VCD file
make iss ; run uCsim to simulate your app
make emu ; run uCsim showing FPGA display
make clean ; delete compiled files
Besides hardware simulation, the system can be simulated in software level using uCsim simulator. It can be started with
make iss
command. It starts the simulation and opens three terminal windows, titled with UART, cmd1, and cmd2. The UART window is connected to simulated uart, press ENTER in this window to get the monitor prompt. To start your program, issue
g startaddress
monitor command, using hexadecimal address. cmd1 and cmd2 windows can be used to control the simulator, documentation can be found at:
See documentation for detailed instructions how to compile and download system to an FPGA board: