CIS 351

Lab 5: Introduction to Assembly

Fall 2021

For this lab, you are going to write some assembly code and test it using using the MUnit testing framework. Begin by watching this video .

Step 1: Learn how to test your code

Before writing any code, you first need to learn how to write and run MUnit tests. Follow these steps:

Follow this GitHubClassroom link and clone the resulting repository.
Download munit.jar into the directory for this repo (or, copy it from /home/kurmasz/public/CIS351/AssemblyIntro). The file mars.jar is in the repository's .gitignore so that GitHub doesn't have to store hundreds of copies of this file. This is why you have to download it separately, and why you won't see it on the GitHub page.
Download Mars. This file is also listed in .gitignore so that it is not stored by GitHub.
Launch Mars, open assemblyIntroSample.asm and see if you can spot the bug.
From the command line, run javac -cp munit.jar AssemblyIntroSampleTest.java. (If you are doing this on your own machine, make sure the javac executable is in your path.)
Now, run java -jar munit.jar assemblyIntroSample.asm AssemblyIntroSampleTest.class. (Notice that you are specifying the name of the class file, not the name of the class.)

At this point, you should see the following output:

MIPSUnit::MUnit version 1.1 built Sun Apr 08 14:26:21 EDT 2018.
Built with MARS version 4.4

	Failure: triples_positive_number(AssemblyIntroSampleTest): expected:<6> but was:<4>
	Failure: triples_negative_numbers(AssemblyIntroSampleTest): expected:<-18> but was:<-12>
Tests run: 6, Failures: 2

These tests fail because there is a bug in triple. Edit assemblyIntroSample.asm and fix the bug. When you have fixed the bug, you will see

MIPSUnit::MUnit version 1.1 built Sun Apr 08 14:26:21 EDT 2018.
Built with MARS version 4.4

All tests (6) passed.

Do not continue until you have (1) figured out how to run my test code, and (2) have found and fixed the bug in triple!

Step 2: Write some Java

Go to CodingBat and solve these three problems:

Do not continue until CodingBat has indicated that you have solved all three problems correctly. If you don't know how to code these problems in Java or Python, you certainly won't be able to do it in assembly!

Step 3: Write and test some MIPS assembly

Now solve each problem using MIPS assembly. Use assemblyIntro.asm as your starting point. In order for your solution to work with my testing software, you must follow these rules:

The first two lines of your source file must be
.globl monkeyTrouble sleepIn posNeg .text
(Notice the spelling of .globl.)
Your three procedures must be named (i.e., labeled with) monkeyTrouble, sleepIn, and posNeg respectively.
Use labels if you want to store data in global memory. (You shouldn't need to load or store data for this assignment.)
The method parameters will be placed in registers a0, a1, and a2.
Each method must end with the instruction jr $ra.
Use the literal value 1 for true and 0 for false.

To test your code, edit AssemblyIntroTest.java then compile and run using the instructions from step 1. These tests are not complete; you will need to add some of your own.

Submission and grading

When your code and tests are complete and correct (i.e., passes the automated tests), commit everything with "[Grade Me]" in the commit message.

You must have a complete set of test cases for each problem. That means four tests for monkeyTrouble and sleepIn, and eight tests for posNeg.

Hints:

To compute !a0, do the following:
not $a0, $a0
andi $a0, $a0, 1
(The extra andi instruction makes sure that only the least-significant bit has a value other than 0.)
You are welcome to use branch statements (e.g., beq and bne), but you don't need them to complete this assignment. Anything you think you need a branch for can be done using slt and slti.

Updated Monday, 11 October 2021, 1:44 PM