From 14c6f67c9df2eaca82a479e10ac44d16ac0f6e88 Mon Sep 17 00:00:00 2001
From: feng-arch <feng-arch@outlook.com>
Date: Wed, 13 Nov 2024 09:37:18 +0800
Subject: [PATCH] add initial file to this repos

---
 Makefile                                      |   3 +
 autograder_test/autograder.o.hold             | Bin 0 -> 18264 bytes
 autograder_test/autograder_makefile           |   2 +
 makefiletest.sh                               |  92 +++++++
 .../dmem_fact_ec.sol                          |  36 +++
 obj files for student testing/os.sol          | 248 ++++++++++++++++++
 obj files for student testing/test1.sol       |   8 +
 obj files for student testing/test11.sol      |  13 +
 obj files for student testing/test2.sol       |  49 ++++
 obj files for student testing/test2_.sol      |  49 ++++
 obj files for student testing/testc.sol       |   4 +
 obj files for student testing/testc1.sol      |  12 +
 obj files for student testing/testc2.sol      |  12 +
 obj files for student testing/testlabel.sol   |   3 +
 obj files for student testing/testone.sol     |   2 +
 obj files for student testing/tests.sol       |  18 ++
 obj files for student testing/user_draw.sol   |  23 ++
 .../user_string_ec.sol                        |  69 +++++
 submit/Makefile                               |  27 ++
 submit/lc4.c                                  |  55 ++++
 submit/lc4_disassembler.c                     |  18 ++
 submit/lc4_disassembler.h                     |  25 ++
 submit/lc4_loader.c                           |  27 ++
 submit/lc4_loader.h                           |  32 +++
 submit/lc4_memory.c                           |  94 +++++++
 submit/lc4_memory.h                           |  43 +++
 26 files changed, 964 insertions(+)
 create mode 100644 Makefile
 create mode 100644 autograder_test/autograder.o.hold
 create mode 100644 autograder_test/autograder_makefile
 create mode 100755 makefiletest.sh
 create mode 100644 obj files for student testing/dmem_fact_ec.sol
 create mode 100644 obj files for student testing/os.sol
 create mode 100644 obj files for student testing/test1.sol
 create mode 100644 obj files for student testing/test11.sol
 create mode 100644 obj files for student testing/test2.sol
 create mode 100644 obj files for student testing/test2_.sol
 create mode 100644 obj files for student testing/testc.sol
 create mode 100644 obj files for student testing/testc1.sol
 create mode 100644 obj files for student testing/testc2.sol
 create mode 100644 obj files for student testing/testlabel.sol
 create mode 100644 obj files for student testing/testone.sol
 create mode 100644 obj files for student testing/tests.sol
 create mode 100644 obj files for student testing/user_draw.sol
 create mode 100644 obj files for student testing/user_string_ec.sol
 create mode 100644 submit/Makefile
 create mode 100644 submit/lc4.c
 create mode 100644 submit/lc4_disassembler.c
 create mode 100644 submit/lc4_disassembler.h
 create mode 100644 submit/lc4_loader.c
 create mode 100644 submit/lc4_loader.h
 create mode 100644 submit/lc4_memory.c
 create mode 100644 submit/lc4_memory.h

diff --git a/Makefile b/Makefile
new file mode 100644
index 0000000..b6e416d
--- /dev/null
+++ b/Makefile
@@ -0,0 +1,3 @@
+all:
+	@echo 'remember to use the "cd submit" command before running make'
+				
\ No newline at end of file
diff --git a/autograder_test/autograder.o.hold b/autograder_test/autograder.o.hold
new file mode 100644
index 0000000000000000000000000000000000000000..9398e375d0f7be23cae5a09d8afdacc3b803841d
GIT binary patch
literal 18264
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

literal 0
HcmV?d00001

diff --git a/autograder_test/autograder_makefile b/autograder_test/autograder_makefile
new file mode 100644
index 0000000..f200b5a
--- /dev/null
+++ b/autograder_test/autograder_makefile
@@ -0,0 +1,2 @@
+autograder: 
+	@clang -g autograder.o autograder_helpers.o lc4_memory.o lc4_disassembler.o lc4_loader.o -o autograder
\ No newline at end of file
diff --git a/makefiletest.sh b/makefiletest.sh
new file mode 100755
index 0000000..540c2c6
--- /dev/null
+++ b/makefiletest.sh
@@ -0,0 +1,92 @@
+#!/bin/bash
+
+remove_compiled () {
+    rm -f autograder*
+    rm -f lc4
+    rm -f *.o
+}
+
+ERR='\033[1;31m'
+NC='\033[0m' # No Color
+
+cd submit
+
+required_files=( "lc4.c" "lc4_disassembler.c" "lc4_disassembler.h" \
+                 "lc4_loader.c" "lc4_loader.h" "lc4_memory.c" "lc4_memory.h" "Makefile")
+
+for file in "${required_files[@]}"
+do
+    if [ ! -f $file ]; then
+        echo -e "${ERR}Required file ${file} does not exist!${NC}"
+        exit 1
+    fi
+done
+
+if [ $1 == "lc4" ]; then
+    make lc4
+
+    if [ $? -ne 0 ]; then
+        echo -e "${ERR}LC4 Makefile failed!${NC}"
+        remove_compiled
+        exit
+    fi
+
+    echo -e "${NC}LC4 Makefile successful!${NC}"
+    remove_compiled
+elif [ $1 == "integration" ]; then
+    remove_compiled
+    cp ../autograder_test/* .
+    make lc4
+    
+		echo -e "${NC}running lc4 on testone.obj and comparing results with correct solution${NC}"
+
+    cp ../obj*/testone.* .
+    ./lc4 testone.obj
+    
+    if [ $? -ne 0 ]; then
+        echo -e "${ERR}lc4 failed!${NC}"
+        remove_compiled
+        exit
+    fi
+    
+    cat testone.sol
+    
+    make -f autograder_makefile autograder
+
+    if [ $? -ne 0 ]; then
+        echo -e "${ERR}Compilation failed!${NC}"
+        remove_compiled
+        exit
+    fi
+
+    ./autograder search_opcode 998
+    if [ $? -ne 0 ]; then
+        echo -e "${NC}Compilation passed, but ${ERR}search opcode unit test failed!${NC}"
+        remove_compiled
+        exit
+    fi
+
+    ./autograder reverse_assemble 999
+    if [ $? -ne 0 ]; then
+        echo -e "${NC}Compilation passed, but ${ERR}reverse assembler unit test failed!${NC}"
+        remove_compiled
+        exit
+    fi
+    
+    ./autograder add_to_list 999
+    if [ $? -ne 0 ]; then
+        echo -e "${NC}Compilation passed, but ${ERR}add to list unit test failed!${NC}"
+        remove_compiled
+        exit
+    fi
+    
+
+    echo -e "${NC}Successfully compiled, sample unit tests passed!${NC}"
+		echo -e "${NC}This is only a subset of the full tests. Remember to test your lc4 program with the sample .obj files${NC}"
+    remove_compiled
+else
+    echo -e "${ERR}Invalid or missing argument!${NC}"
+    echo "Usage:"
+    echo "    ./makefiletest.sh <lc4|integration>"
+    exit 1
+fi
diff --git a/obj files for student testing/dmem_fact_ec.sol b/obj files for student testing/dmem_fact_ec.sol
new file mode 100644
index 0000000..411b639
--- /dev/null
+++ b/obj files for student testing/dmem_fact_ec.sol	
@@ -0,0 +1,36 @@
+<label>                  <address> <contents> <assembly>
+MAIN                     0000      9420          
+                         0001      D540          
+                         0002      16A5       ADD R3, R2, #5
+FOR_LOOP                 0003      2403          
+                         0004      0603          
+                         0005      4801          
+                         0006      14A1       ADD R2, R2, #1
+                         0007      CFFB          
+END_FOR_LOOP             0008      C81B          
+SUB_FACTORIAL            0010      6080          
+                         0011      2100          
+                         0012      0A02          
+                         0013      9201          
+                         0014      C80D          
+END_IF1                  0015      0202          
+                         0016      93FF          
+                         0017      C80A          
+END_IF2                  0018      2107          
+                         0019      0C02          
+                         001A      93FF          
+                         001B      C806          
+END_IF3                  001C      1220       ADD R1, R0, #0
+LOOP                     001D      2101          
+                         001E      0C03          
+                         001F      103F       ADD R0, R0, #-1
+                         0020      1248       MUL R1, R1, R0
+                         0021      CFFB          
+END_SUB_FACTORIAL        0022      7280          
+                         0023      C1C0          
+END                      0024      0000          
+VALUES                   4020      0006          
+                         4021      0005          
+                         4022      0008          
+                         4023      000A          
+                         4024      FFFB          
diff --git a/obj files for student testing/os.sol b/obj files for student testing/os.sol
new file mode 100644
index 0000000..0b7e509
--- /dev/null
+++ b/obj files for student testing/os.sol	
@@ -0,0 +1,248 @@
+<label>                  <address> <contents> <assembly>
+                         8000      CA01          
+                         8001      CA08          
+                         8002      CA0F          
+                         8003      CA34          
+                         8004      CA4A          
+                         8005      CA5B          
+OS_START                 8200      9E00          
+                         8201      8000          
+TRAP_GETC                8202      9000          
+                         8203      D1FE          
+                         8204      6000          
+                         8205      07FC          
+                         8206      9002          
+                         8207      D1FE          
+                         8208      6000          
+                         8209      8000          
+TRAP_PUTC                820A      9204          
+                         820B      D3FE          
+                         820C      6240          
+                         820D      07FC          
+                         820E      9206          
+                         820F      D3FE          
+                         8210      7040          
+                         8211      8000          
+TRAP_GETS                8212      9200          
+                         8213      9800          
+                         8214      D920          
+                         8215      2004          
+                         8216      0820          
+                         8217      98FF          
+                         8218      D97F          
+                         8219      2004          
+                         821A      021C          
+                         821B      9800          
+                         821C      9800          
+READ                     821D      9400          
+                         821E      D5FE          
+                         821F      6480          
+                         8220      07FC          
+                         8221      9602          
+                         8222      D7FE          
+                         8223      6AC0          
+                         8224      9C00          
+                         8225      DD0D          
+                         8226      2A06          
+                         8227      040A          
+                         8228      9C0A          
+                         8229      2A06          
+                         822A      0407          
+                         822B      9C00          
+                         822C      2A06          
+                         822D      0404          
+                         822E      1801       ADD R4, R0, R1
+                         822F      7B00          
+                         8230      1261       ADD R1, R1, #1
+                         8231      0FEB          
+DONE_GETS                8232      9C00          
+                         8233      DD00          
+                         8234      1801       ADD R4, R0, R1
+                         8235      1921       ADD R4, R4, #1
+                         8236      7D00          
+DONE_GETS_NO_WRITE       8237      8000          
+TRAP_PUTS                8238      9800          
+                         8239      D920          
+                         823A      2004          
+                         823B      0812          
+                         823C      98FF          
+                         823D      D97F          
+                         823E      2004          
+                         823F      020E          
+                         8240      9800          
+LOAD                     8241      1500       ADD R2, R4, R0
+                         8242      6280          
+                         8243      2300          
+                         8244      0409          
+                         8245      9404          
+                         8246      D5FE          
+                         8247      6480          
+                         8248      07F8          
+                         8249      9606          
+                         824A      D7FE          
+                         824B      72C0          
+                         824C      1921       ADD R4, R4, #1
+                         824D      0FF3          
+DONE_PUTS                824E      8000          
+TRAP_GETC_TIMER          824F      920A          
+                         8250      D3FE          
+                         8251      9608          
+                         8252      D7FE          
+                         8253      94D0          
+                         8254      D507          
+                         8255      7440          
+AWAIT_LOOP               8256      68C0          
+                         8257      0808          
+                         8258      9000          
+                         8259      D1FE          
+                         825A      6000          
+                         825B      0801          
+                         825C      05F9          
+READY_TO_READ            825D      9002          
+                         825E      D1FE          
+                         825F      6000          
+DONE_WAITING             8260      8000          
+TRAP_DRAW_RECT           8261      7FBE          
+                         8262      7BBD          
+                         8263      1DBD       ADD R6, R6, #-3
+                         8264      1BA0       ADD R5, R6, #0
+                         8265      1DBB       ADD R6, R6, #-5
+                         8266      717F          
+                         8267      737E          
+                         8268      757D          
+                         8269      777C          
+                         826A      797B          
+                         826B      2500          
+                         826C      0C31          
+                         826D      2700          
+                         826E      0C2F          
+                         826F      2300          
+                         8270      0C2D          
+                         8271      9E7C          
+                         8272      2607          
+                         8273      022A          
+                         8274      9E80          
+                         8275      2407          
+                         8276      0227          
+                         8277      2100          
+                         8278      0825          
+                         8279      2300          
+                         827A      0823          
+                         827B      16C1       ADD R3, R3, R1
+                         827C      1480       ADD R2, R2, R0
+VALIDATE_SIZE_AND_POSITION_Y  827D      9E7C          
+                         827E      2607          
+                         827F      0204          
+VALIDATE_SIZE_AND_POSITION_X  8280      9E80          
+                         8281      2407          
+                         8282      0205          
+                         8283      0C07          
+FIX_Y                    8284      1ED7       SUB R7, R3, R7
+                         8285      1017       SUB R0, R0, R7
+                         8286      16D7       SUB R3, R3, R7
+                         8287      0FF8          
+FIX_X                    8288      1E97       SUB R7, R2, R7
+                         8289      1017       SUB R0, R0, R7
+                         828A      1497       SUB R2, R2, R7
+SET_UP_NEW_ROW           828B      9E80          
+                         828C      1E4F       MUL R7, R1, R7
+                         828D      9800          
+                         828E      D9C0          
+                         828F      1FC0       ADD R7, R7, R0
+                         8290      1FC4       ADD R7, R7, R4
+                         8291      1820       ADD R4, R0, #0
+                         8292      0E06          
+DRAW_COLUMN              8293      757D          
+                         8294      657B          
+                         8295      75C0          
+                         8296      657D          
+                         8297      1921       ADD R4, R4, #1
+                         8298      1FE1       ADD R7, R7, #1
+UPDATE_ROW_IF_DONE       8299      2802          
+                         829A      09F8          
+                         829B      1261       ADD R1, R1, #1
+                         829C      2203          
+                         829D      09ED          
+DONE_DRAWING             829E      1D60       ADD R6, R5, #0
+                         829F      1DA3       ADD R6, R6, #3
+                         82A0      6BBD          
+                         82A1      6FBE          
+                         82A2      8000          
+OS_GLOBALS_MEM           A000      0000          
+                         A001      0000          
+                         A002      0000          
+                         A003      0000          
+                         A004      0000          
+                         A005      0000          
+                         A006      0000          
+                         A007      0000          
+                         A008      0000          
+                         A009      0000          
+                         A00A      0000          
+                         A00B      0000          
+                         A00C      0000          
+                         A00D      0000          
+                         A00E      0000          
+                         A00F      0000          
+OS_VIDEO_MEM             C000      0000          
+                         C001      0000          
+                         C002      0000          
+                         C003      0000          
+                         C004      0000          
+                         C005      0000          
+                         C006      0000          
+                         C007      0000          
+                         C008      0000          
+                         C009      0000          
+                         C00A      0000          
+                         C00B      0000          
+                         C00C      0000          
+                         C00D      0000          
+                         C00E      0000          
+                         C00F      0000          
+                         C010      0000          
+                         C011      0000          
+                         C012      0000          
+                         C013      0000          
+                         C014      0000          
+                         C015      0000          
+                         C016      0000          
+                         C017      0000          
+                         C018      0000          
+                         C019      0000          
+                         C01A      0000          
+                         C01B      0000          
+                         C01C      0000          
+                         C01D      0000          
+                         C01E      0000          
+                         C01F      0000          
+                         C020      0000          
+                         C021      0000          
+                         C022      0000          
+                         C023      0000          
+                         C024      0000          
+                         C025      0000          
+                         C026      0000          
+                         C027      0000          
+                         C028      0000          
+                         C029      0000          
+                         C02A      0000          
+                         C02B      0000          
+                         C02C      0000          
+                         C02D      0000          
+                         C02E      0000          
+                         C02F      0000          
+                         C030      0000          
+                         C031      0000          
+                         C032      0000          
+                         C033      0000          
+                         C034      0000          
+                         C035      0000          
+                         C036      0000          
+                         C037      0000          
+                         C038      0000          
+                         C039      0000          
+                         C03A      0000          
+                         C03B      0000          
+                         C03C      0000          
+                         C03D      0000          
diff --git a/obj files for student testing/test1.sol b/obj files for student testing/test1.sol
new file mode 100644
index 0000000..cca9676
--- /dev/null
+++ b/obj files for student testing/test1.sol	
@@ -0,0 +1,8 @@
+<label>                  <address> <contents> <assembly>
+BEGINING                 000A      1201       ADD R1, R0, R1
+                         000B      1449       MUL R2, R1, R1
+                         000C      1691       SUB R3, R2, R1
+END                      000D      0000          
+VALUES                   4020      0001          
+                         4021      0002          
+                         4022      0003          
diff --git a/obj files for student testing/test11.sol b/obj files for student testing/test11.sol
new file mode 100644
index 0000000..24824d2
--- /dev/null
+++ b/obj files for student testing/test11.sol	
@@ -0,0 +1,13 @@
+<label>                  <address> <contents> <assembly>
+L1                       0000      1201       ADD R1, R0, R1
+                         0001      0000          
+                         0002      1449       MUL R2, R1, R1
+                         0003      1691       SUB R3, R2, R1
+L2                       000A      12DA       DIV R1, R3, R2
+                         000B      5283          
+                         000C      52D2          
+                         000D      52DA          
+L3                       000E      0000          
+L4                       4020      000A          
+                         4021      000B          
+                         4022      000C          
diff --git a/obj files for student testing/test2.sol b/obj files for student testing/test2.sol
new file mode 100644
index 0000000..5539e4a
--- /dev/null
+++ b/obj files for student testing/test2.sol	
@@ -0,0 +1,49 @@
+<label>                  <address> <contents> <assembly>
+INIT                     0000      F001          
+                         0001      90FF          
+                         0002      D1FF          
+                         0003      8000          
+START                    0005      1042       ADD R0, R1, R2
+                         0006      170D       MUL R3, R4, R5
+                         0007      1DD0       SUB R6, R7, R0
+                         0008      12DA       DIV R1, R3, R2
+IMMS_XB                  000B      112F       ADD R0, R4, #15
+                         000C      1FF0       ADD R7, R7, #-16
+BRANCH                   000D      081B          
+                         000E      0DFC          
+                         000F      0BF5          
+                         0010      0403          
+                         0011      0607          
+                         0012      03FA          
+                         0013      0FF1          
+LOGICALS                 0014      5283          
+                         0015      52D2          
+                         0016      52DA          
+                         0017      52BF          
+                         0018      51C8          
+COMPARES                 0019      2001          
+                         001A      2483          
+                         001B      2940          
+                         001C      2B3F          
+                         001D      2DFF          
+                         001E      2F80          
+DMEM                     001F      629F          
+                         0020      72A0          
+SHIFTERS_MOD             0021      A70F          
+                         0022      AB90          
+                         0023      AE2A          
+                         0024      A2BB          
+                         0025      0000          
+JUMPS                    0026      480F          
+                         0027      4000          
+                         0028      C040          
+END                      0029      0000          
+SUBROUTINE               00F0      102A       ADD R0, R0, #10
+                         00F1      CF2F          
+END_SUBROUTINE           00F2      0000          
+VALUES                   2000      8000          
+                         2001      7FFF          
+                         2002      52D2          
+                         2003      1042
+                         2004      0DFC          
+                         2005      297B          
diff --git a/obj files for student testing/test2_.sol b/obj files for student testing/test2_.sol
new file mode 100644
index 0000000..5539e4a
--- /dev/null
+++ b/obj files for student testing/test2_.sol	
@@ -0,0 +1,49 @@
+<label>                  <address> <contents> <assembly>
+INIT                     0000      F001          
+                         0001      90FF          
+                         0002      D1FF          
+                         0003      8000          
+START                    0005      1042       ADD R0, R1, R2
+                         0006      170D       MUL R3, R4, R5
+                         0007      1DD0       SUB R6, R7, R0
+                         0008      12DA       DIV R1, R3, R2
+IMMS_XB                  000B      112F       ADD R0, R4, #15
+                         000C      1FF0       ADD R7, R7, #-16
+BRANCH                   000D      081B          
+                         000E      0DFC          
+                         000F      0BF5          
+                         0010      0403          
+                         0011      0607          
+                         0012      03FA          
+                         0013      0FF1          
+LOGICALS                 0014      5283          
+                         0015      52D2          
+                         0016      52DA          
+                         0017      52BF          
+                         0018      51C8          
+COMPARES                 0019      2001          
+                         001A      2483          
+                         001B      2940          
+                         001C      2B3F          
+                         001D      2DFF          
+                         001E      2F80          
+DMEM                     001F      629F          
+                         0020      72A0          
+SHIFTERS_MOD             0021      A70F          
+                         0022      AB90          
+                         0023      AE2A          
+                         0024      A2BB          
+                         0025      0000          
+JUMPS                    0026      480F          
+                         0027      4000          
+                         0028      C040          
+END                      0029      0000          
+SUBROUTINE               00F0      102A       ADD R0, R0, #10
+                         00F1      CF2F          
+END_SUBROUTINE           00F2      0000          
+VALUES                   2000      8000          
+                         2001      7FFF          
+                         2002      52D2          
+                         2003      1042
+                         2004      0DFC          
+                         2005      297B          
diff --git a/obj files for student testing/testc.sol b/obj files for student testing/testc.sol
new file mode 100644
index 0000000..c439793
--- /dev/null
+++ b/obj files for student testing/testc.sol	
@@ -0,0 +1,4 @@
+<label>                  <address> <contents> <assembly>
+                         4020      000A          
+                         4021      000B          
+                         4022      000C          
diff --git a/obj files for student testing/testc1.sol b/obj files for student testing/testc1.sol
new file mode 100644
index 0000000..0a42777
--- /dev/null
+++ b/obj files for student testing/testc1.sol	
@@ -0,0 +1,12 @@
+<label>                  <address> <contents> <assembly>
+L1                       0000      1201       ADD R1, R0, R1
+                         0001      1449       MUL R2, R1, R1
+                         0002      1691       SUB R3, R2, R1
+L2                       000A      12DA       DIV R1, R3, R2
+                         000B      5283          
+                         000C      52D2          
+                         000D      52DA          
+L3                       000E      0000          
+L4                       4020      000A          
+                         4021      000B          
+                         4022      000C          
diff --git a/obj files for student testing/testc2.sol b/obj files for student testing/testc2.sol
new file mode 100644
index 0000000..0a42777
--- /dev/null
+++ b/obj files for student testing/testc2.sol	
@@ -0,0 +1,12 @@
+<label>                  <address> <contents> <assembly>
+L1                       0000      1201       ADD R1, R0, R1
+                         0001      1449       MUL R2, R1, R1
+                         0002      1691       SUB R3, R2, R1
+L2                       000A      12DA       DIV R1, R3, R2
+                         000B      5283          
+                         000C      52D2          
+                         000D      52DA          
+L3                       000E      0000          
+L4                       4020      000A          
+                         4021      000B          
+                         4022      000C          
diff --git a/obj files for student testing/testlabel.sol b/obj files for student testing/testlabel.sol
new file mode 100644
index 0000000..d96594c
--- /dev/null
+++ b/obj files for student testing/testlabel.sol	
@@ -0,0 +1,3 @@
+<label>                  <address> <contents> <assembly>
+INIT                     0000      1283       ADD R1, R2, R3
+END1                     0001      0000          
diff --git a/obj files for student testing/testone.sol b/obj files for student testing/testone.sol
new file mode 100644
index 0000000..899fef9
--- /dev/null
+++ b/obj files for student testing/testone.sol	
@@ -0,0 +1,2 @@
+<label>                  <address> <contents> <assembly>
+                         0000      1283       ADD R1, R2, R3
diff --git a/obj files for student testing/tests.sol b/obj files for student testing/tests.sol
new file mode 100644
index 0000000..01d93a8
--- /dev/null
+++ b/obj files for student testing/tests.sol	
@@ -0,0 +1,18 @@
+<label>                  <address> <contents> <assembly>
+BEGIN                    0000      5283          
+                         0001      5448          
+                         0002      5291          
+                         0003      541B          
+                         0004      5B27          
+                         0005      5B39          
+START                    000A      0000          
+INIT                     0010      1041       ADD R0, R1, R1
+                         0011      14CC       MUL R2, R3, R4
+                         0012      1F95       SUB R7, R6, R5
+                         0013      165A       DIV R3, R1, R2
+                         0014      10A5       ADD R0, R2, #5
+                         0015      10BB       ADD R0, R2, #-5
+CONST1                   4000      0010          
+                         4001      0005          
+                         4002      0004          
+CONST2                   4003      0000          
diff --git a/obj files for student testing/user_draw.sol b/obj files for student testing/user_draw.sol
new file mode 100644
index 0000000..2d573b2
--- /dev/null
+++ b/obj files for student testing/user_draw.sol	
@@ -0,0 +1,23 @@
+<label>                  <address> <contents> <assembly>
+MAIN                     0000      9032          
+                         0001      9205          
+                         0002      940A          
+                         0003      9605          
+                         0004      9800          
+                         0005      D97C          
+                         0006      F009          
+                         0007      900A          
+                         0008      920A          
+                         0009      9432          
+                         000A      9628          
+                         000B      98D0          
+                         000C      D903          
+                         000D      F009          
+                         000E      9078          
+                         000F      9264          
+                         0010      941B          
+                         0011      960A          
+                         0012      98E0          
+                         0013      D97F          
+                         0014      F009          
+END                      0015      0000          
diff --git a/obj files for student testing/user_string_ec.sol b/obj files for student testing/user_string_ec.sol
new file mode 100644
index 0000000..d48ac39
--- /dev/null
+++ b/obj files for student testing/user_string_ec.sol	
@@ -0,0 +1,69 @@
+<label>                  <address> <contents> <assembly>
+MAIN                     0000      9000          
+                         0001      D140          
+                         0002      F003          
+ECHO_LOOP                0003      90D0          
+                         0004      D107          
+                         0005      F005          
+                         0006      9200          
+                         0007      D342          
+                         0008      7040          
+                         0009      2100          
+                         000A      0407          
+                         000B      F001          
+                         000C      9200          
+                         000D      D342          
+                         000E      6040          
+                         000F      218A          
+                         0010      0406          
+                         0011      CFF1          
+TIMED_OUT                0012      900A          
+                         0013      F001          
+                         0014      901A          
+                         0015      D140          
+                         0016      F003          
+END                      0017      0000          
+PROMPT                   4000      0054          
+                         4001      0079          
+                         4002      0070          
+                         4003      0065          
+                         4004      0020          
+                         4005      0048          
+                         4006      0065          
+                         4007      0072          
+                         4008      0065          
+                         4009      0020          
+                         400A      0028          
+                         400B      0045          
+                         400C      004E          
+                         400D      0054          
+                         400E      0045          
+                         400F      0052          
+                         4010      0020          
+                         4011      0074          
+                         4012      006F          
+                         4013      0020          
+                         4014      0065          
+                         4015      006E          
+                         4016      0064          
+                         4017      0029          
+                         4018      003E          
+                         4019      0000          
+TIME_OUT_STR             401A      0053          
+                         401B      006F          
+                         401C      0072          
+                         401D      0072          
+                         401E      0079          
+                         401F      0020          
+                         4020      0074          
+                         4021      0069          
+                         4022      006D          
+                         4023      0065          
+                         4024      006F          
+                         4025      0075          
+                         4026      0074          
+                         4027      0020          
+                         4028      002E          
+                         4029      002E          
+                         402A      002E          
+                         402B      0000          
diff --git a/submit/Makefile b/submit/Makefile
new file mode 100644
index 0000000..89b8b20
--- /dev/null
+++ b/submit/Makefile
@@ -0,0 +1,27 @@
+#########################################################
+#  file name   : Makefile                               #
+#  description : Makefile to automate compiling         #
+#                and linking                            #
+#########################################################
+#
+#
+
+all: lc4
+
+lc4_disassembler.o: lc4_disassembler.h lc4_disassembler.c
+	clang -c -g lc4_disassembler.c
+	
+lc4_loader.o: lc4_loader.h lc4_loader.c
+	clang -c -g lc4_loader.c
+	
+lc4_memory.o: lc4_memory.h lc4_memory.c
+	clang -c -g lc4_memory.c
+
+lc4: lc4.c lc4_memory.o lc4_loader.o lc4_disassembler.o
+	clang lc4.c -g lc4_memory.o lc4_loader.o lc4_disassembler.o -o lc4
+
+clean:
+	rm -rf *.o
+
+clobber: clean
+	rm -rf lc4
\ No newline at end of file
diff --git a/submit/lc4.c b/submit/lc4.c
new file mode 100644
index 0000000..22e6438
--- /dev/null
+++ b/submit/lc4.c
@@ -0,0 +1,55 @@
+/************************************************************************/
+/* File Name : lc4.c 													*/
+/* Purpose   : This file contains the main() for this project			*/
+/*             main() will call the loader and disassembler functions	*/
+/*             															*/
+/* Author(s) : tjf and you												*/
+/************************************************************************/
+
+#include <stdio.h>
+#include "lc4_memory.h"
+#include "lc4_loader.h"
+#include "lc4_disassembler.h"
+
+/* program to mimic pennsim loader and disassemble object files */
+
+int main (int argc, char** argv) {
+  
+/* leave plenty of room for the filename */
+  
+  char filename[100];
+
+	/**
+	 * main() holds the linked list &
+	 * only calls functions in other files
+	 */
+
+	/* step 1: create head pointer to linked list: memory 	*/
+	/* do not change this line - there should no be malloc calls in main() */
+	
+	row_of_memory* memory = NULL ;
+
+
+	/* step 2: determine filename, then open it		*/
+	/*   TODO: extract filename from argv, pass it to open_file() */
+
+
+	/* step 3: call function: parse_file() in lc4_loader.c 	*/
+	/*   TODO: call function & check for errors		*/
+
+
+	/* step 4: call function: reverse_assemble() in lc4_disassembler.c */
+	/*   TODO: call function & check for errors		*/
+
+
+	/* step 5: call function: print_list() in lc4_memory.c 	*/
+	/*   TODO: call function 				*/
+
+
+	/* step 6: call function: delete_list() in lc4_memory.c */
+	/*   TODO: call function & check for errors		*/
+
+
+	/* only return 0 if everything works properly */
+	return 0 ;
+}
diff --git a/submit/lc4_disassembler.c b/submit/lc4_disassembler.c
new file mode 100644
index 0000000..815be17
--- /dev/null
+++ b/submit/lc4_disassembler.c
@@ -0,0 +1,18 @@
+/************************************************************************/
+/* File Name : lc4_disassembler.c 										*/
+/* Purpose   : This file implements the reverse assembler 				*/
+/*             for LC4 assembly.  It will be called by main()			*/
+/*             															*/
+/* Author(s) : tjf and you												*/
+/************************************************************************/
+
+#include <stdio.h>
+#include "lc4_memory.h"
+
+int reverse_assemble (row_of_memory* memory)
+{
+  /* if you use binary constants, they should be proceeded by a 0b as in 0b011 for decimal 3 */
+	/* without the 0b, constants with leading zeroes will be considered octal constants, not binary */
+	/* hex constants starting with 0x can also be used */
+	return 0 ;
+}
diff --git a/submit/lc4_disassembler.h b/submit/lc4_disassembler.h
new file mode 100644
index 0000000..aaac6c7
--- /dev/null
+++ b/submit/lc4_disassembler.h
@@ -0,0 +1,25 @@
+/************************************************************************/
+/* File Name : lc4_disassembler.h 										*/
+/* Purpose   : This function declares functions for lc4_dissembler.c	*/
+/*      																*/
+/*             															*/
+/* Author(s) : tjf 														*/
+/************************************************************************/
+
+#include <stdio.h>
+#include "lc4_memory.h"
+
+/*
+ * declarations of functions that must defined in lc4_disassembler.c
+ */
+
+
+
+/**
+ * translates the hex representation of arithmetic instructions
+ * into their assembly equivalent in the given linked list.
+ *
+ * returns 0 upon success, and non-zero if an error occurs.
+ */
+int reverse_assemble (row_of_memory* memory) ;
+
diff --git a/submit/lc4_loader.c b/submit/lc4_loader.c
new file mode 100644
index 0000000..78939a3
--- /dev/null
+++ b/submit/lc4_loader.c
@@ -0,0 +1,27 @@
+/************************************************************************/
+/* File Name : lc4_loader.c		 										*/
+/* Purpose   : This file implements the loader (ld) from PennSim		*/
+/*             It will be called by main()								*/
+/*             															*/
+/* Author(s) : tjf and you												*/
+/************************************************************************/
+
+#include <stdio.h>
+#include "lc4_memory.h"
+
+/* declarations of functions that must defined in lc4_loader.c */
+
+FILE* open_file(char* file_name)
+{
+	return NULL ;
+}
+
+int parse_file (FILE* my_obj_file, row_of_memory** memory)
+  
+/* remember to adjust 16-bit values read from the file for endiannness
+ * remember to check return values from fread() and/or fgetc()
+ */
+  
+{
+	return 0 ;
+}
diff --git a/submit/lc4_loader.h b/submit/lc4_loader.h
new file mode 100644
index 0000000..5a3dc1b
--- /dev/null
+++ b/submit/lc4_loader.h
@@ -0,0 +1,32 @@
+/************************************************************************/
+/* File Name : lc4_loader.h		 										*/
+/* Purpose   : This file declares the functions for lc4_loader.c		*/
+/*             															*/
+/*             															*/
+/* Author(s) : tjf														*/
+/************************************************************************/
+
+#include <stdio.h>
+#include "lc4_memory.h"
+
+/* declarations of functions that must defined in lc4_loader.c */
+
+
+
+/**
+ * opens up name of the file passed in, returns a pointer
+ * to the open file
+ *
+ * returns the FILE pointer upon success, else NULL.
+ */
+FILE* open_file(char* file_name) ;
+
+
+
+/**
+ * parses the given input file into an ordered (by memory address)
+ * linked list with the passed in row_of_memory as the head.
+ *
+ * returns 0 upon successs, non-zero if an error occurs.
+ */
+int parse_file (FILE* my_obj_file, row_of_memory** memory) ;
diff --git a/submit/lc4_memory.c b/submit/lc4_memory.c
new file mode 100644
index 0000000..65d30a2
--- /dev/null
+++ b/submit/lc4_memory.c
@@ -0,0 +1,94 @@
+/************************************************************************/
+/* File Name : lc4_memory.c		 										*/
+/* Purpose   : This file implements the linked_list helper functions	*/
+/* 			   to manage the LC4 memory									*/
+/*             															*/
+/* Author(s) : tjf and you												*/
+/************************************************************************/
+
+#include <stdio.h>
+#include "lc4_memory.h"
+
+
+/*
+ * adds a new node to a linked list pointed to by head
+ */
+int add_to_list (row_of_memory** head,
+		 short unsigned int address,
+		 short unsigned int contents)
+{
+
+    /* check to see if there is already an entry for this address and update the contents.  no additional steps required in this case */
+    
+    /* allocate memory for a single node */
+
+	/* populate fields in newly allocated node w/ address&contents, NULL for label and assembly */
+	/* do not malloc() storage for label and assembly here - do it in parse_file() and reverse_assemble() */
+
+	/* if *head is NULL, node created is the new head of the list! */
+
+	/* otherwise, insert node into the list in address ascending order */
+
+	/* return 0 for success, -1 if malloc fails */
+
+	return 0 ;
+}
+
+
+
+/*
+ * search linked list by address field, returns node if found
+ */
+row_of_memory* search_address (row_of_memory* head,
+			       short unsigned int address )
+{
+	/* traverse linked list, searching each node for "address"  */
+
+	/* return pointer to node in the list if item is found */
+
+	/* return NULL if list is empty or if "address" isn't found */
+
+	return NULL ;
+}
+
+/*
+ * search linked list by opcode field, returns node if found
+ */
+row_of_memory* search_opcode  (row_of_memory* head,
+				      short unsigned int opcode  )
+{
+    /* opcode parameter is in the least significant 4 bits of the short int and ranges from 0-15 */
+		/* see assignment instructions for a detailed description */
+    
+    /* traverse linked list until node is found with matching opcode in the most significant 4 bits
+	   AND "assembly" field of node is NULL */
+
+	/* return pointer to node in the list if item is found */
+
+	/* return NULL if list is empty or if no matching nodes */
+
+	return NULL ;
+}
+
+
+void print_list (row_of_memory* head )
+{
+	/* make sure head isn't NULL */
+
+	/* print out a header */
+    
+	/* traverse linked list, print contents of each node */
+
+	return ;
+}
+
+/*
+ * delete entire linked list
+ */
+int delete_list    (row_of_memory** head )
+{
+	/* delete entire list node by node */
+	/* set the list head pointer to NULL upon deletion */
+
+	return 0 ;
+}
diff --git a/submit/lc4_memory.h b/submit/lc4_memory.h
new file mode 100644
index 0000000..59b9541
--- /dev/null
+++ b/submit/lc4_memory.h
@@ -0,0 +1,43 @@
+/************************************************************************/
+/* File Name : lc4_memory.h		 										*/
+/* Purpose   : This program contains the structure for the LC4 memory's	*/
+/* 			   linked list and the declarations of the helper functions */
+/*             															*/
+/* Author(s) : tjf 														*/
+/************************************************************************/
+
+#ifndef LC4_MEMORY_H
+#define LC4_MEMORY_H
+
+/*
+ * definition of linked list node
+ */
+
+typedef struct row_of_memory_struct {
+	short unsigned int address ;
+	char * label ;
+	short unsigned int contents ;
+	char * assembly ;
+	struct row_of_memory_struct *next ;
+} row_of_memory ;
+
+
+/*
+ * declaration of linked list helper functions
+ */
+
+int add_to_list    	      (row_of_memory** head,
+			       short unsigned int address,
+			       short unsigned int contents) ;
+
+row_of_memory* search_address (row_of_memory* head,
+			       short unsigned int address ) ;
+
+row_of_memory* search_opcode  (row_of_memory* head,
+			       short unsigned int opcode  ) ;
+
+void print_list		      (row_of_memory* head ) ;
+
+int delete_list    	      (row_of_memory** head ) ;
+
+#endif