pnx/m16vm
1
0
Fork 0
mirror of https://github.com/pnx/m16vm synced 2026-07-03 11:43:39 +02:00
Code Releases Activity

move design.txt to README.md and clean up the text.

Browse source
This commit is contained in:
Henrik Hautakoski 2018-10-26 14:41:48 +02:00
parent 2ba17c52bd
commit 540e3b7fa6
2 changed files with 76 additions and 81 deletions
Download patch file Download diff file Expand all files Collapse all files

76
README.md Normal file
View file

@ -0,0 +1,76 @@
# m16vm - 16 bit processor virtual machine
This is a virtual machine for a RISC-processor designed for educational purposes.
The design is taken from the real world and tries to mimic existing RISC-architectures.
So it should in theory be possible to construct actual hardware based on the instruction set. Maybe not build a transistor-chip (it's hard, unless you know someone working at Intel/Amd or something) but by putting together a bunch of gate-chips on a breadboard.
The instruction set is by no means designed to be "fast" or "optimal" but focus
more on being easy to understand and modify/play with.
## Specification
The cpu has 16 general purpose registers, r0 - r15. Each register is 16-bit.
Memory addresses are aligned by 2 bytes (16 bit) and the machine has
a total of `4096` bytes of memory.
## instruction set overview
There are 16 different instructions.
| opcode | Name | Type | Description |
| ------ | -----| ---- | --------------------------------------- |
| 0000 | noop | - | No operation |
| 0001 | add | R | Addition |
| 0010 | movl | I | move value to register (lowest 8-bits) |
| 0011 | movh | I | move value to register (highest 8-bits) |
| 0100 | ld | R | load word |
| 0101 | sw | R | store word |
| 0110 | beq | RI | Branch on equal |
| 0111 | jmp | J | Jump |
| 1000 | jr | J | Jump (register) |
| 1001 | - | - | Reserved |
| 1010 | - | - | Reserved |
| 1011 | - | - | Reserved |
| 1100 | - | - | Reserved |
| 1101 | - | - | Reserved |
| 1110 | - | - | Reserved |
| 1111 | wr | I | I/O Write |
NOTE: Subtraction can be implemented via `add` and negative register values, so no
special opcode is needed.
## Instruction set format
Register operation (R):
opcode (4) | rs (4) | r0 (4) | r1 (4)
r0,r1 - Operand registers.
rs - save register
Register operation offset (RI):
opcode (4) | rs (4) | r0 (4) | offset (signed 4)
r0 - Operand registers.
offset - constant offset from r0 value.
rs - save register
Constant operation format (I):
opcode (4) | reg (4) | data (signed 8)
reg - Register
data - Constant data to insert into reg.
Jump format (J):
opcode (4) | addr (signed 12)
## Example programs.
in the `programs` directory, there is some example programs to run.

81
design.txt
View file

@ -1,81 +0,0 @@
* 8 16-bit registers
* Memory
4096 bytes. address aligned by 2 bytes (16 bit)
* instruction set (16 bit)
0001 - add
0010 - movl (move low byte)
0011 - movh (move high byte)
0100 - load word
0101 - store word
0110 - beq
0111 - jmp
1000 - jr (jump register)
1111 - I/O Write
I/O = only 8 bits, syscall?
--- Format ---
Register operation format (R):
opcode (4) | rs (4) | r0 (4) | r1 (4)
r0,r1 - Operand registers.
rs - save register
Register operation format (RI):
opcode (4) | rs (4) | r0 (4) | offset (signed 4)
r0 - Operand registers.
offset - constant offset from r0 value.
rs - save register
Constant operation format (I):
opcode (4) | reg (4) | data (signed 8)
reg - Register
data - Constant data to insert into reg.
Jump format (J):
opcode (4) | addr (signed 12)
* load ascii hex from file.
* jump, branch instructions
start:
add r0, r4 # r4 = 1
beq r0, r1
jmp 2
jmp 3
load r3
jr r3
write r0
if (r0 == r1)
jmp(b1);
else
jmp(b2);
b1:
load(r3);
jmpl(r3);
b2:
write(r0);
while (r0 == r1)
r0++;
beq r0 r1 #