🖥️ LC3 Simulator

The project is an LC3 Simulator, which includes both an assembler and a hardware simulator for the LC3 architecture. The LC3 (Little Computer 3) is a simple educational computer architecture used to teach computer organization and assembly language programming.

Note: This project is still under development and may not be fully functional. in soon we will release the first version.

📥 Getting Started

1. prerequisites

   • QT6.7

2. clone the repository

   If you have Git installed:

   git clone https://github.com/Mr-MRF-Dev/LC3-Simulator.git

   If you have GitHub CLI installed:

   gh repo clone Mr-MRF-Dev/LC3-Simulator

   Navigate to the Project Directory

   cd LC3-Simulator

3. Build the Project

   mkdir build
   cd build
   cmake ..
   make

4. Run the Project

   ./LC3-Simulator

⌨️ Code With VS Code

1. Install the CMake Tools extension for Visual Studio Code.

2. install the Qt for VS Code extension for Visual Studio Code.

3. Add the QT root path in the QT extension settings.

4. Press Ctrl + Shift + P and select CMake: Configure to configure the project.

5. Press Ctrl + Shift + P and select CMake: Build to build the project.

📁 Folder Structure

The project directory is structured as follows:

LC3-Simulator/
├── build/              # Directory for build output
├── src/                # Source code for the simulator and assembler
│   ├── main/           # Gui Main application code (Qt)
│   ├── Assembly/       # Assembly language code
│   ├── Assembler/      # Assembler-specific code
│   └── simulator/      # Simulator-specific code
├── CMakeLists.txt      # CMake build configuration file
└── README.md           # Project README file

🤝 Contributing

We welcome any contributions you may have. If you're interested in helping out, please fork the repository and create an Issue or Pull Request. We'll be happy to review your contributions.

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.