6502_emulator

KO | EN

gitlite — search

#python #ai #android #linux #docker #macos #nodejs #java #cli #security #pytorch #ios #mcp #open-source

(★ 31)

A 6502 emulator with interactive debugger and graphics!

6502_emulator 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 6502 Emulator

Emulates a MOS 6502 chip with an interactive debugger.  
**[LIVE DEMO](https://archusr64.github.io/6502_emulator/)**

https://github.com/ArchUsr64/6502_emulator/assets/83179501/75f19672-a8c2-446f-b395-1c2cca4db83d

Source Code for [snake](examples/snake.asm)

## Build and Execution
1. Clone the repository:  
   `git clone https://github.com/ArchUsr64/6502_emulator`
2. Change to newly created directory:  
   `cd 6502_emulator`
3. Run the emulator:  
   `cargo run --release`
   
## Usage

Assemble one of the provided examples under `examples/` using the provided python build script:  
`python build_asm.py examples/snake.asm`  
This should build an `a.out` binary which the emulator can understand along with `symbols.dbg` for debugging.

Run the emulator with the newly generated files:

`cargo run -- -a examples/snake.asm -d symbols.dbg a.out`

### Debugging
Click the 'Pause Execution' button in the Debug Controls window to pause the execution at any time or start in paused state via the `-s` flag.
Once paused, use the `Step` button to execute the next instruction. Add breakpoints from the 'Breakpoints' window and press the 'X' button to
remove previously added entires. Watchpoints can be used to observe and change memory addresses at runtime.

The symbols required for debugging are included in a newline delimited entries of line numbers and program counter addresses, with the addresses in hexadecimal.
For an example take a look at the provided [`symbols.dbg`](./symbols.dbg).

### CLI Arguments

Usage: `nemu [OPTIONS] [EXECUTABLE]`

| Option | Description | Default |
| :--: | -- | -- |
| -v | **Verbosity:** Verbosity level for console logs | `0` (Errors only) |
| -s | **Start debug:** Stard the emulator in debug mode | `false` |
| -i | **Instructions per frame:** The number of CPU instructions to execute per rendered frame | `100` |
| -d | **Debug symbols:** Path for the file containing debug symbols | [`symbols.dbg`](./symbols.dbg) |
| -a | **Assembly source:** Path for the assembly source file | [`examples/snake.asm`](./examples/snake.asm) |
  
### Inputs
Use WASD or the arrow keys to provide input events.

### RGB color format:
Each color byte is divided into bit fields of size 3, 3 and 2. The bit field if size 2 is least significant and represents the blue color, with the most significant bit field representing red as shown below:
```f#
MSB      LSB
 ^        ^
 765 432 10
 |   |   |
 RRR GGG BB
```
![color_palette](https://github.com/ArchUsr64/6502_emulator/assets/83179501/c50d56e0-0bd6-45be-83c7-d7bcb6025847)

## Screenshots
### Debugger UI
![image](https://github.com/ArchUsr64/6502_emulator/assets/83179501/7c077fbf-0ba2-4534-93a7-aaef24da32c0)
<br>
### Console Logs
![image](https://github.com/ArchUsr64/6502_emulator/assets/83179501/66a6e6f8-802d-4ed5-931f-bc01a5cdf2f6)

## Thanks
- [NesDev wiki](https://www.nesdev.org/) for providing amazing documentation of the chip.
- [Vasm](http://sun.hasenbraten.de/vasm/) as the assembler.
- [Egui](https://crates.io/crates/egui) for making the debugger UI possible.
- [Macroquad](https://crates.io/crates/macroquad) for providing an easy to use graphics API.
- [Emulating a 6502 system in JavaScript • Matt Godbolt](https://www.youtube.com/watch?v=7WuRq-Wmw5o)
- [Assembly language vs. machine code - Ben Eater](https://www.youtube.com/watch?v=oO8_2JJV0B4)

## Similar Projects
- [Mesen](https://www.mesen.ca/)
- [henrikpersson/potatis](https://github.com/henrikpersson/potatis)

6502_emulator

6502_emulator 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

6502_emulator

6502_emulator 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README