[](https://github.com/balt-dev/r6502/actions/)
[](https://docs.rs/r6502)
[](https://gist.github.com/alexheretic/d1e98d8433b602e57f5d0a9637927e0c)
[](https://github.com/balt-dev/r6502)
[](https://crates.io/crates/r6502)
[](https://github.com/balt-dev/r6502/blob/trunk/LICENSE-MIT)
[](https://github.com/rust-secure-code/safety-dance/)
# r6502
### Yet another MOS 6502 emulator.
---
Designed to support `no-std` and not require an allocator nor any unsafe code, and be reasonably fast.
The API of this crate shies away from implementing interrupt handling,
instead having you step the emulator one opcode at a time and handle them yourself.
Note that this does not emulate cycle-by-cycle, and as such may not be 100% accurate.
## Feature Flags
The following feature flags exist:
| Name | Description |
|-----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| bcd | Enable binary-coded decimal arithmetic.
Enabled by default. Disable if you're writing a NES emulator.
Note that invalid BCD is left untested and will not function faithfully to the MOS 6502. |
| bytemuck | Enables [bytemuck](https://docs.rs/bytemuck/) support. |
| arbitrary | Enables [arbitrary](https://docs.rs/arbitrary/) support. This will pull in `std`. |
| serde | Enables [serde](https://docs.rs/serde) support. |
## Example
```rust ignore
extern crate std;
use std::eprintln;
use r6502::{Emulator, FunctionReadCallback, FunctionWriteCallback};
fn main() {
let mut emu = Emulator::default()
.with_read_callback(FunctionReadCallback(|state: &mut State, addr| {
// Log reads
eprintln!("Read from #${addr:04x}");
state.memory[addr as usize]
}))
.with_write_callback(FunctionWriteCallback(|state: &mut State, addr, byte|
// Don't write to ROM
if addr < 0xFF00 {
state.memory[addr as usize] = byte
})
)
.with_rom(include_bytes!("rom.bin"))
.with_program_counter(0x200);
loop {
let interrupt_requested = emu.step()
.expect("found an invalid opcode (only MOS 6502 opcodes are supported)");
if interrupt_requested { // Go to IRQ interrupt vector
let vector = u16::from_le_bytes([
emu.read(0xFFFE),
emu.read(0xFFFF)
]);
emu.state.program_counter = vector;
}
}
}
```
---
## Licensing
This may be licensed under either the MIT or Apache-2.0 license, at your option.