spo/ass2/simulator_SIC_XE
2025-12-07 11:33:03 +01:00
..
gui/qt saved snapshot for naloga2 2025-12-07 11:33:03 +01:00
include saved snapshot for naloga2 2025-12-07 11:33:03 +01:00
src saved snapshot for naloga2 2025-12-07 11:33:03 +01:00
.gitignore saved snapshot for naloga2 2025-12-07 11:33:03 +01:00
CMakeLists.txt saved snapshot for naloga2 2025-12-07 11:33:03 +01:00
Makefile saved snapshot for naloga2 2025-12-07 11:33:03 +01:00
README.md saved snapshot for naloga2 2025-12-07 11:33:03 +01:00

SIC/XE Simulator

A complete SIC/XE architecture simulator with instruction execution, device I/O, and memory management.

Quick Start

The easiest way to build and run the simulator:

make run

This single command will:

  • Configure the build system (if needed)
  • Compile all source files
  • Link the executable
  • Run the simulator

Build Commands

Command Description
make Build the project
make build Build the project
make run Build run the simulator
make clean Clean build artifacts
make run Clean build artifacts, build and run the simulator

Project Structure

simulator_SIC_XE/
├── include/          # Header files (.h)
├── src/             # Source files (.cpp)
├── target/bin/      # Build output (executables, libraries)
└── build/           # CMake build directory

Features

  • SIC/XE Architecture: Complete register set (A, X, L, B, S, T, F, PC, SW)
  • Instruction Execution: Format 1, 2, and 3/4 instruction support
  • Device I/O: Input, output, and file device management
  • Memory Management: 24-bit address space with proper bounds checking

Development

The project uses CMake with a convenient Makefile wrapper. All build artifacts are placed in target/bin/ for easy access.

For manual CMake usage:

cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build -j