ZZSMSPadTest 1.0

Master System pad test for ZZPicoDriveSMS

Short:        Master System pad test for ZZPicoDriveSMS
Author:       Xanxi
Uploader:     Hakim Hassani <hassani hakim gmail com>
Type:         util/misc
Version:      1.0
Requires:     AmigaOS 3.x
Architecture: m68k-amigaos >= 3.0

ZZSMSPadTest 1.0
----------------

ZZSMSPadTest is a Sega Master System controller test utility for
ZZPicoDriveSMS.

It is meant to help users check their joystick / gamepad setup before
running the Master System edition of ZZPicoDrive.

Purpose
-------

This is a small companion utility for ZZPicoDriveSMS. It is not an
emulator.

It helps users check which DB9 joystick, CD32-style pad or
lowlevel.library controller inputs are actually seen by AmigaOS before
starting ZZPicoDriveSMS.

This is useful because different Amiga joystick adapters, USB stacks,
CD32 pads and lowlevel.library implementations may expose buttons in
different ways.

This utility does not test the keyboard.

No Sega ROMs are included or required.

How it works
------------

ZZSMSPadTest displays a Master System style controller drawing.

When a direction or button is detected, the corresponding indicator lights
up in green above the controller drawing. This makes it easy to check that
the expected directions and buttons are seen by AmigaOS.

Input methods
-------------

DB9 joystick
  Tests standard Amiga joystick ports through the DB9 input mode.

CD32 / USB controllers through lowlevel.library
  Tests CD32-style pads and compatible USB controllers when supported
  by the user's lowlevel.library setup.

Two-player setups
  The utility can be used to check player 1 and player 2 input sources
  before selecting them in ZZPicoDriveSMS.

Notes
-----

ZZSMSPadTest is provided as a helper tool for ZZPicoDriveSMS.

It does not require a Master System ROM and does not run any game.

If a controller does not react in ZZSMSPadTest, it is unlikely to work
correctly in ZZPicoDriveSMS until the input mode or adapter setup is fixed.

Credits
-------

ZZSMSPadTest was written by Xanxi as part of the ZZPicoDrive project.