const { logMemory, num2hex } = require('./logging.js'); const { INITIAL_IP_ADDRESS, POINTER_TO_START_OF_DISPLAY_MEM } = require('./machine.config.js'); // 1 = verbose // 2 = what i'm currently focusing on // 3 = always print // 4 = silent const DEBUG_LEVEL = 2; let DEBUG = false; // Turn debugging on/off -- set by assemble() exports.assemble = (str, debug = false) => { DEBUG = debug; return decodeInstructions(str); } const mnemonicsWithOptionalArgs = ['end', 'cfc', 'chp', 'nop']; const mnemonics2opcodes = { end: { direct: 0, indirect: 0 }, sto: { direct: 1, indirect: 2 }, lda: { direct: 3, indirect: 4 }, add: { direct: 5, indirect: 6 }, sub: { direct: 7, indirect: 8 }, hop: { direct: 9, indirect: 10 }, jmp: { direct: 11, indirect: 12 }, cfc: { direct: 13, indirect: 13 }, chp: { direct: 14, indirect: 14 }, nop: { direct: 15, indirect: 15 }, }; /** * @param {String} line - One line of assembly to decode **/ function decodeInstructions(line) { let lines = line.split(/\n/); // returns an array of lines let machineCode = new Array(INITIAL_IP_ADDRESS).fill(0); machineCode[0] = POINTER_TO_START_OF_DISPLAY_MEM; let labels = {}; let constants = {}; let IP = INITIAL_IP_ADDRESS; for (let i = 0; i < lines.length; i++) { dbg(2, ''); dbgGroup(1, `Input line ${i}, IP ${num2hex(IP)}`); dbg(3, `> ${lines[i]}`); let line = stripWhitespaceFromEnds(stripComments(lines[i])); // Handle blank lines if (line.length === 0) { dbg(3, `IP: $${num2hex(IP)}, new code: none`); dbg(1, 'blank'); dbgGroupEnd(1, 'Input line'); continue; } // HANDLE OPS // Handle label definitions if (line.startsWith('@')) { // TODO: validate label // validateLabel(line); let label = line.substring(1); // strip '@' if (label in labels) { labels[label].pointsToByte = IP; } else { labels[label] = { pointsToByte: IP, bytesToReplace: [], }; } dbg(2, `pointsToByte: ${labels[label].pointsToByte}`); dbg(2, `bytesToReplace: ${labels[label].bytesToReplace}`); dbg(3, `IP: $${num2hex(IP)}, new code: none`); dbgGroupEnd(1, 'Input line'); continue; } let op_arg_array = line.split(" "); // split line into an array of [op, arg] let opName = op_arg_array[0].toLowerCase(); let arg_str = op_arg_array[1]; let arg_num = null; let addressingMode = 'direct'; // Must be "direct" or "indirect" // Handle constant definitions if (opName.startsWith('=')) { // TODO: validate constant let constantName = opName.substring(1); // strip '>' let constantValue = arg_str; constants[constantName] = constantValue; dbg(2, `constants:`); dbg(2, constants); continue; } // Handle mnemonics without arguments (eg END) ... if (typeof arg_str === 'undefined') { if (mnemonicsWithOptionalArgs.indexOf(opName) < 0) { console.error(`Missing opcode: ${line}`); throw new Error("Missing opcode"); } arg_num = 0; // HANDLE ARGUMENTS // Handle references to labels } else if (arg_str.startsWith('@')) { // TODO: validate label // validateLabel(line); let label = arg_str.substring(1); // strip '@' arg_num = 0; if (label in labels) { dbg(1, `'${label}' already in labels object`); labels[label].bytesToReplace.push(IP + 1); } else { dbg(1, `'${label}' NOT in labels object`); labels[label] = { bytesToReplace: [IP + 1], }; } dbg(2, `pointsToByte: ${labels[label].pointsToByte}`); dbg(2, `bytesToReplace: ${labels[label].bytesToReplace}`); // Handle references to constants } else if (arg_str.startsWith('=')) { arg_str = arg_str.substring(1) // strip '>' dbg(2, `argument references '${arg_str}'`); arg_str = constants[arg_str]; dbg(2, `arg_str from '${arg_str}`); // Handle references to constants in indirect mode } else if (arg_str.startsWith("(=")) { addressingMode = "indirect"; arg_str = arg_str.replace("(=", ""); arg_str = arg_str.replace(")", ""); dbg(2, `INDY - argument references '${arg_str}'`); arg_str = constants[arg_str]; // Handle indirect expressions } else if (arg_str.startsWith("(")) { addressingMode = "indirect"; arg_str = arg_str.replace("(", ""); arg_str = arg_str.replace(")", ""); } // Handle numeric operands if (arg_num === null) { if (arg_str.startsWith("$")) { // Handle hex arg_str = arg_str.replace("$", ""); arg_num = hex2num(arg_str); } else { // Accept decimal i guess arg_num = parseInt(arg_str); } } // DECODE! const op = mnemonics2opcodes[opName][addressingMode]; machineCode.push(op); machineCode.push(arg_num); dbg(3, `IP: $${num2hex(IP)}, new code: $${num2hex(op)} $${num2hex(arg_num)}`); IP += 2; dbgGroupEnd(1, 'Input line'); }; dbg(1, ''); dbgGroup(1, 'Memory before filling in label constants'); dbgExec(1, () => logMemory(new Uint8Array(machineCode))); dbgGroupEnd(1, 'Memory before filling in label constants'); // Backfill label references for (let k of Object.keys(labels)) { dbgGroup(2, `@${k}`); let label = labels[k]; dbg(2, `pointsToByte: ${label.pointsToByte}`); dbg(2, `bytesToReplace: ${label.bytesToReplace}`); dbgGroupEnd(2, `label`); for (let j = 0; j < label.bytesToReplace.length; j++) { machineCode[label.bytesToReplace[j]] = label.pointsToByte; } } // Add an END at the end machineCode.push('0'); machineCode.push('0'); return new Uint8Array(machineCode); } function stripComments(line) { return line.replace(/;.+/,""); } function stripWhitespaceFromEnds(line) { line = line.replace(/^\s+/,""); line = line.replace(/\s+$/,""); return line; } function hex2num(hex) { return parseInt(hex, 16) }; // Debug helpers const dbg = (lvl, s) => { if (DEBUG && (lvl >= DEBUG_LEVEL)) console.log(s) }; const dbgGroup = (lvl, s) => { if (DEBUG && (lvl >= DEBUG_LEVEL)) console.group(s) }; const dbgGroupEnd = (lvl, s) => { if (DEBUG && (lvl >= DEBUG_LEVEL)) console.groupEnd() }; const dbgExec = (lvl, func) => { if (DEBUG && (lvl >= DEBUG_LEVEL)) func(); }