README.md

Simple Architecture RISC Simulator

Outline

• Instruction length is only 8 bytes.
• Structure of this architecture is very simple.
• I drunk highball, that was delicious and made my brain smart (just for a moment.)

How to use

Assembler

python3 assembler.py <assembly.s>

example: python3 assembler.py test.s

Simulator

python3 simulator.py <programfile.bin>

example: python3 simulator.py examples/add.bin

Instruction

Format

All instructions have 8 bytes length.

Type A

Format: 00 00 00 00000000 00

• 1st byte: opcode
• 2nd byte: rA
• 3rd byte: rB
• 4-7th bytes: constant
• 8th byte: tail

Type B

Format: 00 00 00 00 00 00 00 00

• 1st byte: opcode
• 2nd byte: rA
• 3rd byte: rB
• 4th byte: rC
• 5th byte: rX
• 6th byte: rY
• 7th byte: rZ
• 8th byte: tail

Instruction set

SISD

Basic intruction-set.

opcode and tail (hex)	format (assembly)	format (bytecode)	Explain
00, FF	halt	00 FF FF 00000000 FF	halt
10, FF	nop	10 FF FF 00000000 FF	nop
20, FF	mread %rA,%rB,$constant	20 rA rB 00000000 FF	read from memory (addr: rA + constant, dest: rB)
21, FF	pop %rB	21 FF rB 00000000 FF	pop (dest: rB)
30, FF	mwrite %rA,%rB,$constant	30 rA rB 00000000 FF	write to memory (data: rA, dest: rB + constant)
31, FF	push %rA	31 rA FF 00000000 FF	push (data: rA)
40, FF	iread %rB,$constant	40 FF rB constant FF	constant to rB
41, FF	rcopy %rA,%rB	41 rA rB 00000000 FF	copy rA to rB
50, FF	add %rA,%rB	50 rA rB 00000000 FF	rB = rA + rB
51, FF	sub %rA,%rB	51 rA rB 00000000 FF	rB = rA - rB
52, FF	shr %rA,%rB	52 rA rB 00000000 FF	rB = rA >> rB
53, FF	shl %rA,%rB	53 rA rB 00000000 FF	rB = rA << rB
54, FF	and %rA,%rB	54 rA rB 00000000 FF	rB = rA & rB
55, FF	or %rA,%rB	55 rA rB 00000000 FF	rB = rA | rB
56, FF	not %rA,%rB	56 rA rB 00000000 FF	rB = ~rA
57, FF	xor %rA,%rB	57 rA rB 00000000 FF	rB = rA ^ rB
58, FF	cmp %rA,%rB	58 rA rB 00000000 FF	null = rA - rB
60, FF	jump %rB,$constant	60 FF rB constant FF	jump (dest: rB + constant)
61, FF	jl %rB,$constant	61 FF rB constant FF	jl (dest: rB + constant)
62, FF	jle %rB,$constant	62 FF rB constant FF	jle (dest: rB + constant)
63, FF	je %rB,$constant	63 FF rB constant FF	je (dest: rB + constant)
64, FF	jge %rB,$constant	64 FF rB constant FF	jge (dest: rB + constant)
65, FF	jg %rB,$constant	65 FF rB constant FF	jg (dest: rB + constant)
66, FF	jne %rB,$constant	66 FF rB constant FF	jne (dest: rB + constant)
70, FF	call %rB,$constant	70 FF rB constant FF	call (dest: rB + constant)
71, FF	ret	71 FF FF 00000000 FF	return
50, 01	addt %rA,%rB,%rC	50 rA rB rC 000000 01	rC = rA + rB
51, 01	subt %rA,%rB,%rC	51 rA rB rC 000000 01	rC = rA - rB
52, 01	shrt %rA,%rB,%rC	52 rA rB rC 000000 01	rC = rA >> rB
53, 01	shlt %rA,%rB,%rC	53 rA rB rC 000000 01	rC = rA << rB
54, 01	andt %rA,%rB,%rC	54 rA rB rC 000000 01	rC = rA & rB
55, 01	ort %rA,%rB,%rC	55 rA rB rC 000000 01	rC = rA | rB
56, 01	nott %rA,%rB,%rC	56 rA rB rC 000000 01	rC = ~rA
57, 01	xort %rA,%rB,%rC	57 rA rB rC 000000 01	rC = rA ^ rB
58, 02	cmpi %rA,$constant	58 rA FF 00000000 02	null = constant - rA

SIMD128

128bit(64x2) SIMD instruction-set

opcode and tail (hex)	format (assembly)	format (bytecode)	Explain
41, 10	rcopyss128 %rA,%rB	41 rA rB 00000000 10	copy rA to rB (both are SIMD128 registers)
42, 10	rcopyns128 %rA,%rB	42 rA rB 00000000 10	copy rA(basic) to rB(SIMD128 segment)
43, 10	rcopysn128 %rA,%rB	43 rA rB 00000000 10	copy rA(SIMD128 segment) to rB(basic)
44, 10	rcopyns128all %rA,%rB	44 rA rB 00000000 10	copy and fill rA(basic) to rB(SIMD128)
50, 10	addts128 %rA,%rB,%rC	50 rA rB rC 000000 10	rC = rA + rB
51, 10	subts128 %rA,%rB,%rC	51 rA rB rC 000000 10	rC = rA - rB
52, 10	shrts128 %rA,%rB,%rC	52 rA rB rC 000000 10	rC = rA >> rB
53, 10	shlts128 %rA,%rB,%rC	53 rA rB rC 000000 10	rC = rA << rB
54, 10	andts128 %rA,%rB,%rC	54 rA rB rC 000000 10	rC = rA & rB
55, 10	orts128 %rA,%rB,%rC	55 rA rB rC 000000 10	rC = rA | rB
56, 10	notts128 %rA,%rB,%rC	56 rA rB rC 000000 10	rC = ~rA
57, 10	xorts128 %rA,%rB,%rC	57 rA rB rC 000000 10	rC = rA ^ rB
42, 11	rcopyns128d %rA,%rB,%rC	42 rA rB rC 000000 11	copy (rA, rB)(basic) to rC(SIMD128)
43, 11	rcopysn128d %rA,%rB,%rC	43 rA rB rC 000000 11	copy rA(SIMD128) to (rB, rC)(basic)

SIMD256

256bit(64x4) SIMD instruction-set

opcode and tail (hex)	format (assembly)	format (bytecode)	Explain
41, 20	rcopyss256 %rA,%rB	41 rA rB 00000000 20	copy rA to rB (both are SIMD256 registers)
42, 20	rcopyns256 %rA,%rB	42 rA rB 00000000 20	copy rA(basic) to rB(SIMD256 segment)
43, 20	rcopysn256 %rA,%rB	43 rA rB 00000000 20	copy rA(SIMD256 segment) to rB(basic)
44, 20	rcopyns256all %rA,%rB	44 rA rB 00000000 20	copy and fill rA(basic) to rB(SIMD256)
50, 20	addts256 %rA,%rB,%rC	50 rA rB rC 000000 20	rC = rA + rB
51, 20	subts256 %rA,%rB,%rC	51 rA rB rC 000000 20	rC = rA - rB
52, 20	shrts256 %rA,%rB,%rC	52 rA rB rC 000000 20	rC = rA >> rB
53, 20	shlts256 %rA,%rB,%rC	53 rA rB rC 000000 20	rC = rA << rB
54, 20	andts256 %rA,%rB,%rC	54 rA rB rC 000000 20	rC = rA & rB
55, 20	orts256 %rA,%rB,%rC	55 rA rB rC 000000 20	rC = rA | rB
56, 20	notts256 %rA,%rB,%rC	56 rA rB rC 000000 20	rC = ~rA
57, 20	xorts256 %rA,%rB,%rC	57 rA rB rC 000000 20	rC = rA ^ rB
42, 21	rcopyns256q %rA,%rB,%rC,%rX,%rY	42 rA rB rC rX rZ 00 21	copy (rA, rB, rC, rX)(basic) to rY(SIMD256)
43, 21	rcopysn256q %rA,%rB,%rC,%rX,%rY	43 rA rB rC rX rZ 00 21	copy rA(SIMD256) to (rB, rC, rX, rY)(basic)

Registers

• Generic Registers: 00-FD

Index (hex)	Name	Explain
00 - 1F	main0-1f	main
20 - 3F	cycl0-1f	cycle
40 - 5F	data0-1f	data
60 - 7F	addr0-1f	memory address
80 - 9F	args0-1f	arguments of function
A0 - BF	func0-1f	for inside of function
C0 - CF	iovr0-1f	IO data
E0 - FD	sysm0-1d	system variable
FE	stck	stack point
FF	null	null (constant of 0)
PC	-	Program Counter

• SIMD128 Registers: 00-7F
• The high or low segment flag mask: 0x80
• The segment of registers are used only rcopyns128 and rcopysn128 instructions.

Index (hex)	Name	Explain
0 - 7F	s128b0-7f	SIMD128 registers
0 - 7F	s128b0-7fh	high segment of SIMD128 registers
80 - FF	s128b0-7fl	low segment of SIMD128 registers

• SIMD256 Registers: 00-3F
• The w, x, y, z segment flag mask: 0xC0
• The segment of registers are used only rcopyns256 and rcopysn256 instructions.

Index (hex)	Name	Explain
0 - 3F	s256b0-3f	SIMD256 registers
0 - 3F	s256b0-3fw	w segment of SIMD256 registers
40 - 7F	s256b0-3fx	x segment of SIMD256 registers
80 - BF	s256b0-3fy	y segment of SIMD256 registers
C0 - FF	s256b0-3fz	z segment of SIMD256 registers

TODO

• Add more examples
• Implement half width SIMD instructions.
• Make GUI simulator.