https://github.com/auth0x78/compiler85
A lightweight compiler for Intel 8085 assembly.
https://github.com/auth0x78/compiler85
assembler assembly code-generator compiler educational-project intel-8085 lexer-parser
Last synced: 7 months ago
JSON representation
A lightweight compiler for Intel 8085 assembly.
- Host: GitHub
- URL: https://github.com/auth0x78/compiler85
- Owner: Auth0x78
- License: gpl-3.0
- Created: 2025-09-16T18:51:12.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2025-10-01T08:16:07.000Z (7 months ago)
- Last Synced: 2025-10-01T10:18:21.411Z (7 months ago)
- Topics: assembler, assembly, code-generator, compiler, educational-project, intel-8085, lexer-parser
- Language: C++
- Homepage:
- Size: 103 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
ο»Ώ# Compiler 8085
A simple compiler for Intel 8085 opcodes.
It takes 8085 assembly code as input and produces the corresponding machine code or raw binary as output.
Designed as an educational project to explore compiler phases like lexing, parsing, code generation, and symbol resolution.
## Build Instructions
```bash
git clone https://github.com/Auth0x78/Compiler85.git
cd Compiler85
mkdir build && cd build
cmake ..
cmake --build .
````
## Usage
### Debug build
In **Debug mode**, the compiler is interactive β no command line arguments required.
```text
$> c85
Debug mode: No command line arguments required.
Enter the filepath of the source file:
Enter the filepath of the output file:
```
Hereβs an updated and polished version of your README section:
---
### Release Build
In **Release mode**, the compiler is run from the command line with the following syntax:
```bash
$> c85 [options]
```
#### Arguments
* ``: Path to the input 8085 assembly (`.asm`) file. Can be relative or absolute.
* ``: Path where the compiled machine code will be written. Can be relative or absolute.
* `[options]` (optional flags):
| Flag | Description |
| -------------- | ------------------------------------------------------------------ |
| `-r` | Output raw binary (`.bin`) instead of the default Intel HEX format |
| `-d` | Generate a human-readable memory dump of the compiled program |
| `-h`, `--help` | Show this help message |
## π§ͺ Adding Test Cases
Each instruction in the Intel 8085 has its own test case .asm file and a golden .dump file.
- `test_.asm` file in `tests/test_input/` β contains the mnemonic
- `expect_.dump` file in `tests/test_expect/` β contains expected opcode bytes
### Creating new test case
1. Create a `test_.asm` file in `tests/test_input/` with the mnemonic.
2. Create the matching `expect_.dump` file in `tests/test_expect/` with expected hex bytes.
NOTE: Replace test_case_name with the name of the test you want to give to it
### Example
`test_HLT.asm`:
```asm
HLT
````
`expect_HLT.dump`:
```
0 <- Expected return code of the binary
0000: 76 <- Expected output/memory dump of the program.
```
### Pre-generated Test Cases
Most instructions are covered.
To add new cases, extend the mnemonics tests.
#### Examples
Generate Intel HEX (default):
```bash
$> c85 program.asm program.hex
```
Generate raw binary:
```bash
$> c85 program.asm program.bin -r
```
Generate memory dump for inspection:
```bash
$> c85 program.asm program.dump -d
```
**Notes:**
* If an output file already exists, it will be **overwritten**.
---
Example:
```bash
c85 examples/hello.asm build/hello.bin -r
```
## TODO Section
* [x] **Lexer** β tokenize assembly source
* [x] **Parser** β build AST from tokens
* [x] **Code Generation** β lower AST into 8085 machine code
* [x] **Symbol Resolution & Linking** β resolve labels, addresses, and forward references
* [x] **Object File Generation** β outputs raw machine code or raw (hex-format) binary output to file
* [x] **Test Case & Output Verification** - verify output against known test cases
* [ ] **Extend Test Cases** - check for every possible point of failure of the application