search

MEGA65 / open-roms

A project to create unencumbered open-source ROMs for use on selected retro computers
Other
263 stars 18 forks source link

Compile #59

Open stephaneickmann opened 4 years ago

stephaneickmann commented 4 years ago

Hello. I want to compile a new kernal for my Ultimate 64. With new f-Keys. What do i need for this? Sorry, its my first time. Do i need a C Compiler? Thx for your help. Greetings Stephan

FeralChild64 commented 4 years ago

  1. You need a Linux, with GIT, GCC, GNU make, and libpng development libraries (libpng-devel package on Debian, if I'm not mistaken). If you only have Windows - you can use Windows Subsystem for Linux, it should work. I'm not sure about Mac OS - I don't have a Mac.

  2. Clone the repository: git clone https://github.com/MEGA65/open-roms.git

  3. Edit the _open-roms/src/,,configultimate64.s file, changing the strings near KEYCMDF1, etc. If you don't need anything assigned to the key, put NO. If you want a string assigned, put the string in quotation marks. If you don't know how to type a given character, consult a PETSCII table here - take the hexadecimal code, and type it replacing dollar ($) with a backslash (), for example \5F_ is a CBM back-arrow sign (top left corner of C64 keyboard).

  4. In the open-roms directory, execute command make - afterwards fetch your ROMs from open-roms/build directory. Note: ALWAYS take the new BASIC ROM even if the only change in the Kernal was changed function key definitions - this is enough to trigger incompatibility, and for the custom build 'ROM mismatch' bluescreen will be displayed by Kernal!

  5. If you are not happy with the new function keys assignment - repeat starting from step 3 (no need to clone a new repository).

I'll keep this ticket open as a reminder to update documentation. We need:

stephaneickmann commented 4 years ago

thank you. Trying Windows Sub for Linux

stephaneickmann commented 4 years ago

hmmm...errormessage... png.h file is missing in resp? File "pngprepare" some tips for me?

Compyx commented 4 years ago

Install libpng, this depends on what distro you installed in the WSL. On my Debian box I have libpng-dev installed, so make works. On Fedora the development packages are usually called 'foo-devel'.

stephaneickmann commented 4 years ago

Yeah. Runs fine now :-)))) First time on Linux ;-) Thank you very much.

Compyx commented 4 years ago

You're welcome!

stephaneickmann commented 4 years ago

By the way... Where can i modify the banner_fancy gfx? Special File? Thx.

FeralChild64 commented 4 years ago

You mean the 'U' logo? Go to open-roms/src/basic/assets/startup_banner.s, for Ultimate 64 build modify values just after '!ifdef CONFIG_MB_U64 {' line. Everything is in PETSCII, has to be terminated by 0 (but I recommend putting BANNER_COLOR_0 before 0, this switches the color to white - for text display). BANNER_SPACING is an indentation for text, in case your new GFX is wider/narrower.