------------------------------------------------------------------------------ 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_