# 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:

```bash
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:
```bash
cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build -j
```