52 lines
1.3 KiB
Markdown
52 lines
1.3 KiB
Markdown
# 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
|
|
```
|