A minimalist and educational 6502 CPU emulator written in JavaScript. This project is designed for learning and experimentation, focusing on the core functionality of the 6502 processor.
• Basic Instruction Set: Implements a subset of the 6502 instruction set, allowing for the execution of simple programs.
• 16-bit Addressing: Supports 16-bit memory addressing with 8-bit data registers.
• Memory Management: Includes basic read/write operations for memory handling.
• Customizable: Designed with simplicity in mind, making it easy to extend and modify.
• Testing: Covered with tests 11/151 OPCODES, which are official and documented guidelines. (in progress)
| Load | Trans | Stack | Shift | Logic | Arith | Inc | Ctrl | Bra | Flags | Nop |
|---|---|---|---|---|---|---|---|---|---|---|
| LDA | TAX | PHA | ASL | AND | ADC | DEC | BRK | BCC | CLC | NOP |
| LDX | TAY | PHP | LSR | BIT | CMP | DEX | JMP | BCS | CLD | |
| LDY | TSX | PLA | ROL | EOR | CPX | DEY | JSR | BEQ | CLI | |
| STA | TXA | PLP | ROR | ORA | CPY | INC | RTI | BMI | CLV | |
| STX | TXS | SBC | INX | RTS | BNE | SEC | ||||
| STY | TYA | INY | BPL | SED | ||||||
| BVC | SEI | |||||||||
| BVS |
Clone the repository and navigate to the project directory:
git clone https://github.com/kostDev/6502-emulator-UA.git
cd 6502-emulator-UATo start using the emulator, simply include the js folder files in your project and create an instance of the CPU class, as example:
import Memory from "./memory";
import CPU from "./cpu";
const params = {
testing: false,
running: false
}
const cpu = new CPU(new Memory(0x10000), params); // 64kb -> 0x10000
// emulator.loadProgram(yourProgram); // in future
cpu.run();• Implement full 6502 instruction set. Current 22/151 (256)
• Add debugging tools.
• Create example programs for testing and learning.
• Develop a simple UI for interactive use.
This project is licensed under the MIT License - see the LICENSE file for details.
Цей README надає основну інформацію про проект, включаючи інструкції з встановлення, використання та плани на майбутнє. Він достатньо простий і зрозумілий, щоб ви могли швидко почати працювати з моїм емулятором. Зроблено в Україні (Made in Ukraine 🇺🇦).