spo/simulator_SIC_XE/README.md
2025-11-11 11:03:25 +01:00

1.3 KiB

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 run Build and run the simulator
make clean Clean build artifacts

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