wolf icon indicating copy to clipboard operation
wolf copied to clipboard

Wolfenstein 3D for Gameboy Color


Wolfenstein 3D for Gameboy Color (c)2017 Anders Granlund, www.happydaze.se

This hardware and software is free; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

It is being distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

The Z80 binary is using FX-Hammer and GBP Player. The authors of these must be credited and any of their respective copyright notices and/or disclaimers must be included.

The KE04 binary uses and/or takes inspiration from parts of Wolf4SDL source code by Moritz "Ripper" Kroll (http://www.chaos-software.de.vu) which was in turn based on Wolfenstein 3D sources released by id Software.

Some data files are derivate from the Wolfenstein 3D shareware package.


A rough description of what is included:

/z80/ ASM sourcecode for the Gameboy side Compile with WLA-DX (http://www.villehelin.com/wla.htm)

Burn using a Gameboy flash cart programmer that support programming
an AM29F040 chip via the AudioIn pin.
I use the open-source C3 programmer from Jeff Frohwein.
(https://reinerziegler.de.mirrors.gg8.se/readplus.htm#C3)
I'm sure there are more modern options out there but this is what
have had since back when those things were the latest and greatest :)
Alternatively, burn the chip with a generic eprom programmer before soldering to board

/z80/tools mod2gbt - Part of GBP Player 3.0.5. Built for Mac OSX. wla-gb - Part of WLA-DX. Built for Mac OSX wlalink - Part of WLA-DX. Built for Mac OSX

/ke04/ C sourcecode for MKE04Z128VLD4 Build data using wolfgfx (makefile inside /ke04/test2/Data) Compile source+data with Kinetis Design Studio Burn with Segger J-link cable connected to SWI pins on cartridge

/tools/wolfgfx/ C++ source code for the map & graphics converter, with XCode project.

/hardware/mbc/ MBC1 clone for ATF1502AS(L) Compile with Atmel WinCUPL Burn with Atmel ATDH1150SUB cable connected to JTAG pins on cartridge

/hardware/cart/ Eagle & Gerber files for cartridge boards Rev.C use Nintendo MBC1 chip Rev.D use ATF1502 to clone MBC1 functionality Both are otherwise functionally identical Manufacture the board in 0.8mm height

/hardware/link/ Eagle & Gerber files for cartridge <-> JTAG & SWI cables Optional adapter to make connecting programming cables more convenient


Wolf4SDL:

Portions of this software derivate from Wolf4SDL by Moritz "Ripper" Kroll (http://www.chaos-software.de.vu) Wolf4SDL is in turned based on Wolfenstein 3D by id Software. (http://www.idsoftware.com)


FX HAMMER:

This software is using FX Hammer by Aleksi Eeben for generating and playing sound effects. https://aleksieeben.myportfolio.com/portfolio


GBT PLAYER:

This software is using GBT PLAYER v3.0.5 for music playback and for converting the midis to runtime format. https://github.com/AntonioND/gbt-player

The converter tool in z80/tools/mod2gbt was built for MacOSX. Please see the official GBT-Player Github page if you need to build it for another operating system.

;############################################################################### ;# # ;# # ;# GBT PLAYER 3_0_5 # ;# # ;# Contact: antonio_nd@outlook_com # ;############################################################################### ; Copyright (c) 2009-2016, Antonio Niño Díaz (AntonioND) ; All rights reserved_ ; ; Redistribution and use in source and binary forms, with or without ; modification, are permitted provided that the following conditions are met: ; ; * Redistributions of source code must retain the above copyright notice, this ; list of conditions and the following disclaimer_ ; ; * Redistributions in binary form must reproduce the above copyright notice, ; this list of conditions and the following disclaimer in the documentation ; and/or other materials provided with the distribution_ ; ; THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" ; AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE ; IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE ; DISCLAIMED_ IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE ; FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL ; DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR ; SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER ; CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, ; OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE ; OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE_