Skip to content
/ MiSTer2MEGA65 Public template

Framework to simplify porting MiSTer (and other) cores to the MEGA65

License

Notifications You must be signed in to change notification settings

sy2002/MiSTer2MEGA65

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

MiSTer2MEGA65

MiSTer2MEGA65 is a framework to simplify porting MiSTer cores to the MEGA65.

Title Image

Learn more by watching this YouTube video and get started by reading the MiSTer2MEGA65 Wiki.

TL;DR

  1. Scroll up and press the "Use this template" button to start a new MiSTer2MEGA65 project. Then fork the MiSTer core you want to port and make it a Git submodule of your newly created project.

  2. Wrap the MiSTer core inside CORE/vhdl/main.vhd while adjusting the clocks in CORE/vhdl/clk.vhd. Provide RAMs, ROMs and other devices in CORE/vhdl/mega65.vhd and wire everything correctly.

  3. Configure your core's behavior, including how the start screen looks like, what ROMs should be loaded (and where to), the abilities of the Help menu and more in CORE/vhdl/config.vhd and in CORE/vhdl/globals.vhd.

DONE your core is ported to MEGA65! :-)

Obviously, this is a shameless exaggeration of how easy it is to work with MiSTer2MEGA65, but you get the gist of it.

Getting started, detailed documentation and support

  • Please visit our official MiSTer2MEGA65 Wiki. It contains everything you ever wanted to know about M2M, including a "Getting Started" tutorial and a step-by-step guide to port a MiSTer core. You might whant to start your journey here and then follow the reading track that is pointed out in the respective chapters.

  • Post a question in our Discussion Forum.

Status of the framework

The MiSTer2MEGA (M2M) framework is stable and ready for being used. The first production quality core that is based on M2M is the Commodore 64 for MEGA65. Additionally there is already a decent amount of cores that are based on the M2M framework. Head to the Alternate MEGA65 cores website to learn more.

The documentation of the M2M framework needs quite some more work before we will be able to call it "good enough" - let alone complete: MiSTer2MEGA65 Wiki

This should not discourage you from using the MiSTer2MEGA65 framework right now to port MiSTer cores and other cores to the MEGA65. You can use the source code of the Commodore 64 for MEGA65 as your "user's manual" and "reference handbook" for the M2M framework.

Additionally to helping yourself with the Wiki (and the turorials there) and the C64 source code as your "user's manual" and "reference handbook": Post your question in the Discussion Forum and join the friendly MEGA65 community on Discord.