Skip to content
sy2002 edited this page Jun 15, 2026 · 28 revisions

Welcome to the MiSTer2MEGA65 Wiki. You will find everything to get started "from zero to hero" here. We encourage you to walk through the multiple tutorials in the "Getting Started" section first, before you actually start to port your first core.

Please note that the MiSTer2MEGA65 framework will often be abbreviated to M2M throughout this Wiki.

Getting started with MiSTer2MEGA65

1. What is MiSTer2MEGA65

2. First Steps

3. "Hello World" Tutorial

The Ultimate MiSTer2MEGA65 Porting Guide

After you've run through the three steps above, continue with The Ultimate MiSTer2MEGA65 Porting Guide. It's your main companion from here on and covers the whole porting process.

Because the guide is so broad, it can't dive deep into every mechanism. That's where the following articles come in: each one goes further on a specific topic, so we recommend reading them alongside the guide.

config.vhd

Deprecated

These older articles are kept for reference, but the porting guide supersedes them.

4. Understand the MiSTer core

5. Project set-up

6. Basic wiring

7. Get the core to synthesize

@TODO next steps

XYZ. How to release your core to the MEGA65 community

Deprecated Reference Guide

Architecture

Audio filters

Caution and loose ends

clk.vhd

Clock Domain Crossing (CDC)

config.vhd

Debugging

Devices

Fatal Errors

File- and Directory Browser

globals.vhd

Help System

keyboard.vhd

m2m-rom.asm

main.vhd

mega65.vhd

On-Screen-Menu

QNICE

RAMs and ROMs

Shell memory layout

Video filters

Video pipeline and output

Virtual Drives

Clone this wiki locally