sy2002 / MiSTer2MEGA65

Framework to simplify porting MiSTer (and other) cores to the MEGA65
GNU General Public License v3.0
35 stars 9 forks source link
fpga mega65 mister mister-core misterfpga qnice

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

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.