CS152 Computer Architecture and Engineering

Lab #1: MIPS & Broken SPIM

John Lazzaro

Spring 2005

Lab 1 is due Monday, January 24th. Your lab report must be submitted by 11:59pm (Monday night) using the submit program (see below).

This lab is to be done individually. Get started early!

Lab Policy: Labs (including final reports) must be submitted by 11:59pm on the day that the lab is due. To submit the Lab 1 final report, run m:\bin\submit-spring2005.exe or at command prompt, type "submit-fall2005" then follow the instructions. Make sure you input the correct section number, group name (for lab 2-4) and directory to submit. Otherwise your lab/project grade will NOT be correctly recorded. The required format for lab reports is shown on the handouts page.

Remember, this lab is to be done individually. Get started early!

The software for this assignment is located in m:\bin and m:\lab1. The broken version of spim is called spim_broken. The good version is called spim.

Problem 1: Introduction to SPIM

This problem will give you a chance to get familiar with the MIPS instruction set, SPIM (a MIPS simulator) and the MIPS calling convention. You will learn SPIM's basic functionalities by simulating a MIPS assembly program at calculates the factorial of 5. You should read Chapter 2 and Appendix A (on the CD ROM) of P&H to prepare for this assignment. An on-line manual for SPIM can be found on the resources web-page.

Copy m:\lab1\fact.s to your home directory for this assignment. This program uses recursion to evaluate the factorial of 5 (f(N) = N * f (N - 1), f (0) = 1). Type spim (or m:\bin\spim) to start the windows version of the SPIM program. Load the assembly program fact.s by pressing the open button, typing the file name in the dialogue box, and clicking on 'open'. Observe that the instructions for your main program now appear in the Text Segments pane (Hint: you can go to the "Windows" drop down menu to select which pane you want to display). You are using the default mode of SPIM which supports the extended instruction set and has no delayed jumps or delayed loads.

In your lab report, reproduce the questions posed in the sections below and answer them.

1a) The program does not look exactly the same as in the fact.s file, because the some of the instructions are macros and SPIM translates them to bare machine instructions. However, the original codes are displayed as comments. What do the instructions "li" and "la" mean? How are "li" and "la" translated to bare machine instructions?

1b) What is the starting address of the 'main' routine of 'fact'? Single-step the code from start until it reaches the first instruction of 'main'. Note that R31 has been modified. Which is the instruction that modified R31? What is the purpose of having this instruction modify R31 in this way?

1c) Set a breakpoint at the first instruction of the 'fact' routine. Continue tracing through the program execution by using single-stepping and breakpoints. What are the registers sp and fp used for? Show the values on the stack when the first instruction of the fact procedure is about to be executed for the fourth time.

1d) Now it is time to switch from the virtual machine to the bare hardware. To run the bare machine, check the "bare machine" option in "Simulator->Settings". Then restart spim. This turns off the assembly language translations and imposes delayed jumps (and branches) as well as delayed loads.

Convert fact.s to use only the bare machine by translating the non-native instructions and by inserting NOPs after the jumps, branches, and loads. You will need to convert the call in main to fact back into a simple JAL. You might also need to take special actions to start executing the 'main' of 'fact'. Turn in this version along with program output that shows how it works.

(Note that this version of SPIM does not implement delayed loads, and so not adding NOPs before loads will not produce incorrect results; however, some of your labs will use delayed loads, and so we included it in this exercise)

If you are working on the sections of Problem 1 out of order, be sure to turn off "bare machine" mode after completing this section.

Problem 2: Writing diagnostic programs

Now we get to the hard part! You are given a buggy version of SPIM, called spim_broken (m:\bin\spim_broken). 5 of the 24 instructions you are asked to verify are buggy in some way or under some conditions. Your task is to write a set of diagnostic programs to identify these 5 bugs and describe the malfunction. (You will verify lots of other things work. Turn this in too.) You will need to work with the bare machine for this.

Here is a list of things you should check for:

Register zero always has the value zero.
All the branch and jump instructions should jump to the right address under the right condition.
All the branch and jump instructions with link should put the correct return address into the right register.
SLT(I) and STLU(I) must work properly with bit patterns representing negative two's complement integers or large natural numbers.
All the arithmetic and logical instructions with immediate field should extend it properly.
Make sure a load that follows a store to the same address reads the appropriate data.
Jump and branch instruction should have a delay slot.
Overflow should be detected correctly in arithmetic and logical instructions.
Shifting instructions work correctly and extend the MSB appropriately.

You should make sure that the fundamental things work before you test some other things that depend on them. Once you have verified that simple compares and branches work, you can build longer programs with a sequence of tests. After each test, you can use a compare followed by a branch to either go to the next test, or to a "failure label" which will put in an identifier for the failed test in a register. As long as there are no failures, it will sequence through all the tests. You can easily look at the "failure register" at the end of execution to determine which (if any) of the tests failed. Your test code should look something like the following:

test case a
beq caseA_result, expected_Result, go_to_caseB
jump to failure A

caseB:
test case b
...
...

failure A:
addiu $t0, $0, 1
j endOfTest

failure B:
addiu $t0, $0, 2
j endOfTest

...
...
endOfTest:

Writing diagnostic programs can deepen your understanding of the instruction sets. The main purpose of this assignment, however, is not only to learn MIPS and understand the diagnostic process, but to teach you how to create programs that can be used to validate your design later in the semester. Since the final project only requires you to implement only a subset of the MIPS instruction set, the diagnostic programs in this assignment will only be useful later in the semester if they are written using this limited set of instructions. Hence, you must write the diagnostics using only the MIPS instructions below:

arithmetic: addu, subu, addiu
logical: and, or, xor, andi, ori, xori, lui
shift: sll, sra, srl
compare: slt, slti, sltu, sltiu
control: beq, bne, j, jr, jal
data transfer: lw, sw

Turn in a description of the specific errors that you found, the test code that excited the errors. Make sure to give a complete description of your testing strategy (methodology). We expect you to describe your testing methodology carefully and give us a notion of how systematic it was and why you were able to detect the bugs that you did. We are looking for an actual methodology here, including tests that didn't find bugs. Be systematic!