From aaab1dc559a53409be6fc703f4e45b89d06cf824 Mon Sep 17 00:00:00 2001 From: mrbobbyguy <84521318+somerandomviolinkid@users.noreply.github.com> Date: Sat, 5 Sep 2026 21:37:01 -0500 Subject: [PATCH] better docs --- main.c | 59 ++++++++++++++++++++++++++++++++++++++++++++++++---------- 1 file changed, 49 insertions(+), 10 deletions(-) diff --git a/main.c b/main.c index 1392ff2..e7668f9 100644 --- a/main.c +++ b/main.c @@ -4,51 +4,90 @@ you are free to use and modify this but PLEASE credit me (at least retain the name in some way) **** INSTRUCTION SEMANTICS **** + (instructions are in order of hex code) NOP: does nothing ADD (normal normal): r[dst] = r[src1] + r[src2] - ADD (normal immediate): r[dst] = r[src1] + imm[4] - ADD (in place normal): r[dst] += r[src1] - ADD (in place immediate): r[dst] += imm[7] + ex. add r0 r1 r2 - ADD (normal normal): r[dst] = r[src1] & r[src2] - ADD (normal immediate): r[dst] = r[src1] & imm[4] - ADD (in place normal): r[dst] &= r[src1] - ADD (in place immediate): r[dst] &= imm[7] + ADD (normal immediate): r[dst] = r[src1] + imm[4] + ex. add r0 r1 4 + + ADD (in place normal): r[dst] += r[src1] + ex. add r0 r1 + + ADD (in place immediate): r[dst] += imm[7] + ex. add r0 4 + + AND (normal normal): r[dst] = r[src1] & r[src2] + ex. and r0 r1 r2 + + AND (normal immediate): r[dst] = r[src1] & imm[4] + ex. and r0 r1 4 + + AND (in place normal): r[dst] &= r[src1] + ex. and r0 r1 + + AND (in place immediate): r[dst] &= imm[7] + ex. and r0 4 NOT (normal): r[dst] = !r[src] + ex. not r0 r1 + NOT (immediate): !r[dst] + ex. not r1 LD: r[dst] <= memory[pc + imm[9]] + ex. ld r0 15 + LDI: r[dst] <= memory[memory[pc + imm[9]] + ex. ldi r0 15 + LDR: r[dst] <= memory[r[src] + imm[6]] + ex. ldr r0 r1 15 ST: r[src] => memory[pc + imm[9]] + ex. st r0 15 + STI: r[src] => memory[memory[pc + imm[9]] + ex. sti r0 15 + STR: r[src] => memory[r[dst] + imm[6]] + ex. str r0 r1 15 BR: if condition codes match any of the nzp flags, pc += imm[9] - (basm code would look like br np 60 or something like that) + ex. br np 50 + (jumps to incremented pc + 50 if condition codes n or p are 1) JMP: pc = r[src] + ex. jmp r0 JSR: r[7] = pc, pc += imm[11] + ex. jsr 50 + JSRR: r[7] = pc, pc = r[src] + ex. jsrr r0 LEA: r[src] = pc + ex. lea r0 RET: pc = r[7] + ex. ret TRAP (vector 0): halts program TRAP (vector 1): prints ascii character in r[0] TRAP (vector 2): r[7] = pc, pc = r[0], prints null terminated ascii string TRAP (vector 3): r[7] = pc, pc = r[0], gets user inputted string with max length stored in r[1] and stores it sequentially at address in r[0] + ex. trap 0 + **** NOTES **** any immediate values in assembly will clamp to be within bounds, e.g. for ADD normal immediate, if you put 60 as the immediate value it will clamp to 15 any unused bits in a machine code instruction will be set to 0 strings are NOT packed!!! + pc is *always* incremented at the start of execution, so instructions that change or use pc such as jmp will use the incremented pc as the base + sext stands for sign extend and not anything else */ #include @@ -409,7 +448,7 @@ int assemble() { return -4; } - if (sscanf(tokens[1], "%hX", &instruction) != 1) { + if (sscanf(tokens[1], "%hx", &instruction) != 1) { printf("Wrong token on line %d!\n", lineCount); return -3; } @@ -886,4 +925,4 @@ int main(int argc, char** argv) { } return 0; -} +} \ No newline at end of file