added some form of html isa documentation. Just converting the markdown one, which will stand as reference documentation and spec forever.

This commit is contained in:
Raphael Jacobs 2022-11-01 12:08:15 +01:00
parent 7e84414574
commit ff3e4ca380
3 changed files with 26 additions and 2 deletions

3
ISA.md
View File

@ -3,6 +3,9 @@
The register machine has a (in)finite number of registers which can store a 32 bit, unsigned integer.
Two registers play a special role: the **accumulator**, which is register number 0 by default, and the **program counter**, which defaults as register number 10.
The **accumulator** is a special register that most operations use.
The **program counter** keeps track of which instruction we're actually executing.
This interpreter reads a single text file with **one instruction per line**.
Whitespaces are ignored. Lines starting with # are treated as comments and are ignored.

View File

@ -4,4 +4,6 @@
wasm-pack build --target bundler
cd ..
}
rm js/*
npx webpack
pandoc ISA.md -o ISA.html

View File

@ -93,8 +93,27 @@ HALT
<!-- <button id="run1" type="button">Reset </button> -->
</div>
<details>
<summary>What is this??</summary>
<p>This is a register architecture machine emulator. The full specification can be found <a href="https://git.dekedin.me/raphy/RAM-emu/src/branch/master/ISA.md">here</a>.</p>
<summary>What is this? Click me to find out</summary>
<p>This is a register architecture machine emulator. The full specification can be found <a href="https://git.dekedin.me/raphy/RAM-emu/src/branch/master/ISA.md">here</a>.</p>
Here is the full spec, so you don't even need to follow the link:
<iframe src="/ISA.html" width="100%" height="100%">
Your browser doesnt support the iframe tag.
</iframe>
<h3>Okay, but how do I use this?</h3>
Write your program in the leftmost box you see.
Press LOAD to actually load the program. You should see the instructions you've just typed on the right now.
Press RUN to execute the whole program until it halts.
Press RUN SINGLE STEP to execute just one instruction.
Reset will... reset everything. No program, no input, no output.
<h3>I found a bug. What do I do?</h3>
<p>Contact info can be found on <a href="https://dekedin.me/about">this page.</a></p>
<h3>This website looks very ugly!! I am a web developer and I think I can do better.</h3>