created sicxe emulator project

simulator_SIC_XE/README.md

@@ -0,0 +1,52 @@
+# 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
+```