AWM-8 Emulator

A simple virtual CPU emulator that simulates a fictional 8-bit processor.

Features

• 8-bit virtual CPU emulation
• 255 bytes of memory
• Basic assembly instruction support
• Fictional instruction set architecture

Instruction Set

Instruction	Opcode	Description
TST	0x01	Prints test output
JMP	0x02	Jumps to specified address
ALV	0x03	Increments L register
PUT	0x04	Loads value into P register
OUT	0x05	Prints value from P register
HLT	0xFF	Halts program execution

Building

Simply run the run.sh file or Compile project yourself:

g++ -I./headers src/*.cpp -o build/emulator

Usage

1. Run the emulator:

./build/emulator

2. Enter path to your assembly file
3. The program will automatically compile and execute

Example Program

PUT H OUT
PUT e OUT
PUT l OUT
PUT l OUT
PUT o OUT
PUT ! OUT
HLT

Technical Note

This is a fictional CPU architecture created for educational purposes. It does not represent any real hardware and is designed as a simple emulation environment for learning basic computer architecture concepts.

Requirements

• G++ compiler
• C++11 or higher

License

This project is open source.