rahulc29 / nesys

NES Emulator in Rust

NESYS

NES Emulator written in Rust. Hopefully will be able to run both ordinarily as well as in the browser using WebAssembly.

Roadmap

Key Milestones

• Parse iNES files
• Create Cartridges (iNES + Mapper interface)
• CPU
  • Set Up Memory Map
  • Hardware Structures (registers)
  • Core Loop / Basic Functionality
    • Read / Write RAM
    • Addressing Modes
    • Fetch - Decode - Execute
  • Official Opcodes Implemented
  • Handle Interrupts
• PPU
  • Set Up Basic Rendering Context (HTMLCanvas + SDL)
  • Implement Registers + Memory Map them
  • Implement DMA
  • Generate NMI -> CPU
  • Core rendering loop
    • Background Rendering
    • Sprite Rendering - currently not hardware accurate
    • Proper Background / Foreground blending
  • Sprite Zero Hit
  • Misc PPU flags (emphasize RGB, Greyscale, etc...)
• APU
  • Implement Registers + Memory Map them
  • Frame Timer IRQ
  • Set Up Basic Sound Output Context (SDL)
  • Channels
    • Pulse 1
    • Pulse 2
    • Triangle
    • Noise
    • DMC
  • DMC DMA
• Joypads
  • Basic Controller
  • Zapper - still needs work
  • NES Four Score
• WebAssembly support
  • Compile core to wasm
  • Add HTMLCanvas based PPU implementation
  • Add Web-based APU implementation

It must be blatantly obvious that the project is in a very nascent stage. It will take a long time to get this done.

The roadmaps are inspired from the ANESE repo.

nesys's Issues

Implement `ADC` instruction

Add ADC instruction and add tests.

Generalise Register Write Instructions

Currently, register loading is performed in ld${register_name}_${address_mode}(&mut self, params...) : generalise it to ld${register_name}(&mut self, address_mode: AddressMode).

Implement all opcodes with tests

Implement all NES-specific opcodes along with unit tests.