Galaga MSX-Paddle support patch
-------------------------------
(c) 2020 by FRS

This patch adds support for the MSX-Paddle to the game Galaga. 

As a bonus, it also:
- Supports MSX-HID PnP connection/disconnection detection for the paddle
- Allows 5 to be pressed on boot to force 50Hz video
- Enables the turbo on machines that have the CHGCPU routine on BIOS


==============================
How to apply the patch

The recipient ROM image *must* be a dump from your an original cartridge that
you actually own.
Don't you ever consider to apply this patch if you don't own this game. The
correct ROM file has the following SHA1 checksum:

SHA1(GalagaV2.rom)= 2a34f0221193712c43f336f08d2a6e58a1a8974a

- You can use the following tools to verify the SHA1 checksum:
  - Windows:
    -MD5 & SHA-1 Checksum Utility 1.1
    - HashTab
  - Mac OS-X:
    - DropHash
    - HashTab
    - (or use the Linux solution below)
  - Linux:
    - Just type on a shell: openssl dgst -sha1 MYGAME.DSK

- To apply the patch, get an IPS patcher like IPSWin, LunarIPS or UIPS, and
  follow the instructions contained in the manual of that tool.


==============================
Special Thanks

- OpenMSX team, for their excellent emulator and debugger
- MRC crew, for the place where MSX hobbyists can meet and exchange ideas
- SjASMPlus assembler team on Github
- FiXato, for compiling many development tools I use on macOS
- Daniel J. Viana, for the old Galaga paddle patch
- Qinni (In memoriam), for her beautiful drawings
  https://www.deviantart.com/qinni

==============================
FAQ
---

Q: Will the game work without a paddle connected?
A: Yes, just like the original

Q: Does the game still support joysticks?
A: Yes, just like the original

Q: Will the patched game run on non-turbo machines?
A: Yes, just as usual

Q: Why doesn't the paddle work on my MSX TurboR?
A: The MSX TurboR lacks the MSX-Paddle drivers on its BIOS. You need to install
   the TRnewdrv driver, before running the game, to have paddle support. You can
   download it here:
   http://frs.badcoffee.info/tools.html

Q: I have an Arkanoid Vaus paddle. Will it work?
A: No, because that paddle has a proprietary protocol. Due to the lack of
   space in the game ROM, only the paddles supported by the MSX-BIOS can be
   used. 

Q: I applied the patch and the resulting ROM doesn't work! What is wrong?
A: You're probably trying to apply the patch on a ROM that has an incorrect
   checksum. Also, check if you're using the recommended patch tools

Q: I think you ruined the game with this patch!
A: Just don't apply the patch and take your rudeness somewhere else. 

===========================================================================
	                     License
                           Terms of use
---------------------------------------------------------------------------

1) This patch is gratis for non-commercial purposes, and the author retains
   its copyright. You only can run and make backup copies of the patch
   while observing the non-commercial restriction.

2) You are only allowed redistribute the patch files (online or on a removable
   media) under the following conditions:
   2.1) No commercial transaction of any kind is involved
   2.2) All the included files are distributed together inside the same
   compressed file.
   2.3) This README must be included unmodified inside the same compressed file.

3) If you want to use this patch for commercial purposes you MUST contact me
   first to negotiate the terms and conditions. Send an e-mail to
   sdsnatcheralpha@gmail.com to contact me.

4) You cannot distribute games with this patch pre-applied.

5) This patch is provided ‘as-is’, without any express or implied warranty.
   In no event will the author be held liable for any damages resulting from the
   use of this patch or the software patched with it.

6) USE THIS SOFTWARE SOLELY AT YOUR OWN RISK.


===========================================================================
                          Donations
---------------------------------------------------------------------------
 If you like the enhancements and fixes here presented and want to show your
 appreciation by donating any amount, or MSX software/hardware, it will be very
 welcome and will help future developments.
 Donations can be done via PayPal to sdsnatcheralpha@gmail.com, and for MSX
 hardware, try contacting me on this e-mail address too.

 Have a look at my wishlist in the following link:
 http://frs.badcoffee.info/wishlist.html

