https://github.com/v1bh475u/fix8
8-bit fixed length instructions assembler and emulator
https://github.com/v1bh475u/fix8
assembler emulator isa
Last synced: 3 months ago
JSON representation
8-bit fixed length instructions assembler and emulator
- Host: GitHub
- URL: https://github.com/v1bh475u/fix8
- Owner: v1bh475u
- License: mit
- Created: 2024-11-09T09:27:03.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2024-11-25T09:43:05.000Z (10 months ago)
- Last Synced: 2025-03-13T09:40:43.600Z (7 months ago)
- Topics: assembler, emulator, isa
- Language: C++
- Homepage:
- Size: 201 KB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Fix8: An 8-bit ISA with Assembler and Emulator
Fix8 is a simple 8-bit Instruction Set Architecture (ISA) implementation, featuring an assembler and emulator. It allows writing, assembling, and emulating programs using the Fix8 ISA.
## Features
- **Custom ISA**: A fixed-length 8-bit ISA with 16 instructions.
- **Assembler**: Converts Fix8 assembly code into machine code.
- **Emulator**: Executes the machine code with debugging output.
## Building the Project
1. Clone the repository:
```bash
git clone https://github.com/v1bh475u/Fix8.git
```
2. Navigate to the project directory:
```bash
cd Fix8
```
3. Build the project:
```bash
make
```
## Running the Assembler and Emulator
1. Place assembly files (`.asm`) in the `asm/` directory.
2. Go to the `build` directory and run the program:
```bash
cd build/
./Fix8
```
3. Follow the menu to assemble and emulate programs.
## Project Structure
- `include/`: Header files.
- `src/`: Source code.
- `asm/`: Assembly files.
- `programs/`: Compiled machine code.
- `docs/`: Documentation.
- `ISA definition/`: Definition of the ISA.