A repo with tools for building programs that run on the MOS 6502/6510 and WDC 65c02 CPUs 🕹️

• Node
• NPM
• Homebrew (if using Mac)
• Chocolatey (if using Windows)

HEADS UP WINDOWS USERS: I'm using Hyper terminal, so if you are using a different commandline prompt - I cannot guarantee that all of the npm scripts will work (although they might)

Firstly, clone the and configure it for tracking repo:

git clone https://github.com/bberak/6502-kit.git [new-project]
cd [new-project]
rm -rf .git # Windows: rmdir /S .git
git init
git add .
git commit -m "First commit"
git remote add origin https://github.com/[you]/[new-project].git
git push -u origin master

Then, install prerequisites:

npm install

This project will make the following tools available via the npm scripts (for MacOS and Windows):

• ACME Assembler
• VICE Emulator
• Minipro Chip Programmer

You can read more about the functionality of each tool below.

Build assembly files with:

npm run acme src/file.asm

Defaults to using 65c02 instruction set. Modify the acme scripts in the package.json to change this.

By convention, .asm files should indicate their output paths using a macro at the top of the file:

!to "build/file.prg"

After assembling is complete, you can run your program on the vice emulator using:

npm run vice build/file.prg

You will most likely need to change the assembly instruction set to 6510 see above.

To write your program to a ROM chip, plug your universal programmer into a spare USB port, then run:

npm run minipro build/file.prg

Works with the MiniPRO TL866xx series of chip programmers (make sure it is plugged in)

By default, is setup to write to the AT28C256 rom chip. Modify the minipro scripts in the package.json to change this.

To add syntax highlighting to your .asm files - use the Kick Assembler Sumlime package

• ACME opcodes
• C64 memory
• Dustlayer tutorials
• Easy 6502 tutorials
• Codebase64 tutorials
• Ben Eater's 6502 YouTube series