1bb1d0908b9cecdbe8f3654e25bea0d415b4e822
haas/spring2026/comporg/projects/btt0.md
| ... | ... | @@ -0,0 +1,63 @@ |
| 1 | +# CSCS2650 Computer Organization |
|
| 2 | + |
|
| 3 | +# PROJECT: btt0 |
|
| 4 | + |
|
| 5 | +## OBJECTIVE |
|
| 6 | + |
|
| 7 | +Our explorations this semester will target the `Vircon32` fantasy |
|
| 8 | +console, an Open Source 32-bit emulator with development toolchain. |
|
| 9 | + |
|
| 10 | +The purpose of this project is to ensure everyone in the class gets the |
|
| 11 | +latest version of `Vircon32` built, installed, and running on their local |
|
| 12 | +development system. |
|
| 13 | + |
|
| 14 | +## REFERENCE |
|
| 15 | + |
|
| 16 | +Be sure to check out the [Vircon32 Assembly Reference](https://github.com/g7n-org/v32ref), especially its [Internet Resources](https://github.com/g7n-org/v32ref?tab=readme-ov-file#internet-resources) section to facilitate finding the needed `Vircon32` archives. |
|
| 17 | + |
|
| 18 | +## TASK |
|
| 19 | + |
|
| 20 | +Download the latest SOURCE CODE release of the `Vircon32` |
|
| 21 | +**ComputerSoftware** repository (latest version as of writing is |
|
| 22 | +**v25.10.29**). Either grab that (or any newer release), or clone the |
|
| 23 | +**ComputerSoftware.git** repository (which should be as new or newer than |
|
| 24 | +the latest release). |
|
| 25 | + |
|
| 26 | +NOTE: If you are running a release OLDER than **v25.10.29** you will want |
|
| 27 | +to update, as there were some important bugs resolved and updates with |
|
| 28 | +this release. |
|
| 29 | + |
|
| 30 | +Please do **NOT** place the `Vircon32` SOURCE CODE in any of existing |
|
| 31 | +repository (not your SEMESTER repo, not the class repo). Place it |
|
| 32 | +someplace entirely independent of version control. |
|
| 33 | + |
|
| 34 | +Reading the provided `README`, go through the build process (installing |
|
| 35 | +any needed supporting packages) to build `Vircon32` FROM SOURCE and then |
|
| 36 | +INSTALL it on your local system. |
|
| 37 | + |
|
| 38 | +Once you have a working, installed `Vircon32` (**DesktopEmulator** AND |
|
| 39 | +**DevTools**), grab the "Hello, World!" C example available on lab46 as a |
|
| 40 | +grabit, and test things out (build it, run the cartridge, verify it all |
|
| 41 | +works). |
|
| 42 | + |
|
| 43 | +Then, modify that "Hello, World!" C program in some meaningful way, |
|
| 44 | +verify it still builds, runs, and works as expected. |
|
| 45 | + |
|
| 46 | +You will be submitting that `C` SOURCE file, the supporting `XML` file, |
|
| 47 | +along with the built `v32` cartridge file. |
|
| 48 | + |
|
| 49 | +### SUBMISSION CRITERIA |
|
| 50 | + |
|
| 51 | +``` |
|
| 52 | +52:btt0:final tally of results (52/52) |
|
| 53 | +*:btt0:grabit of project files before Sunday prior to due date [13/13] |
|
| 54 | +*:btt0:adequate modification of source code beyond default state [13/13] |
|
| 55 | +*:btt0:code compiles cleanly, cartridge builds with no errors [13/13] |
|
| 56 | +*:btt0:the C SOURCE, XML, and v32 cartridge files submitted [13/13] |
|
| 57 | +``` |
|
| 58 | + |
|
| 59 | +Additionally: |
|
| 60 | + * Solutions not abiding by spirit of project will be subject to a 25% overall deduction |
|
| 61 | + * Solutions not utilizing descriptive why and how comments will be subject to a 25% overall deduction |
|
| 62 | + * Solutions not utilizing indentation to promote scope and clarity will be subject to a 25% overall deduction |
|
| 63 | + * Solutions not organized and easy to read (assume a terminal at least 90 characters wide, 40 characters tall) are subject to a 25% overall deduction |