HiROM | FastROM support

…ram memory

…develop

…hannels

and some other fixes from previous commit

Mouse support

What has been done:

- Super Scope code is usable and available now, comes with example mini game.
- Some minor changes to mouse support, now we can also use detectMouse() function to set snes_mouse automatically. Example was updated to display this function. MouseSpeedChange funciton was renamed to mouseSpeedChange(). My bad ^^
- Pad folder name was changed to "input"
- input folder inside old pad folder was renamed to "controller", as well as other assets
- pad.h was renamed to input.h, and every reference to that file inside other files
- input name folder was changed to "controller", as well as assets inside
- Some minor tabs

P.D. Sorry for the big change! I think that input is a more suitable name, now that we have more controlling devices in addition to pad controllers.

***SUPER SCOPE USAGE***

first, we might use detectSuperScope() on boot to detect Super Scope presence. Other way is to force detection by populating snes_sscope to 1 manually, but we dont need to do that if we call this function. We need to call this function everytime Scope gets disconnected from the system, a usefull way to do it is inside this conditional:

```
if (snes_sscope == false)
{
  detectSuperScope();
  // some other code you might need in your program, like displaying warning messages and stopping your game.
}

```

Here is a brief explanation of every variable we might be using:

```
extern u16 scope_holddelay; /*! \brief Hold delay. */
extern u16 scope_repdelay;  /*! \brief Repeat rate. */
extern u16 scope_shothraw;  /*! \brief Horizontal shot position, not adjusted. */
extern u16 scope_shotvraw;  /*! \brief Vertical shot position, not adjusted. */
extern u16 scope_shoth;     /*! \brief Horizontal shot position, adjusted for aim. */
extern u16 scope_shotv;     /*! \brief Vertical shot position, adjusted for aim. */
extern u16 scope_centerh;   /*! \brief 0x0000 is the center of the screen, positive values go to bottom right. */
extern u16 scope_centerv;   /*! \brief 0x0000 is the center of the screen, positive values go to bottom right. */
extern u16 scope_down;      /*! \brief flags that are currently true.*/
extern u16 scope_now;       /*! \brief flags that have become true this frame.*/
extern u16 scope_held;      /*! \brief flagsthat have been true for a certain length of time.*/
extern u16 scope_last;      /*! \brief flags that were true on the previous frame.*/
extern u16 scope_sinceshot; /*! \brief Number of frames elapsed since last shot was fired.*/
```

for scope_down, scope_now, scope_held, scope_last, we need to mask our bits with this usefull bits:

```
typedef enum SUPERSCOPE_BITS
{
    SSC_FIRE = BIT(15),     //!< superscope FIRE button.
    SSC_CURSOR = BIT(14),   //!< superscope CURSOR button.
    SSC_PAUSE = BIT(12),    //!< superscope PAUSE button.
    SSC_TURBO = BIT(13),    //!< superscope TURBO flag.
    SSC_OFFSCREEN = BIT(9), //!< superscope OFFSCREEN flag.
    SSC_NOISE = BIT(8),     //!< superscope NOISE flag.
} SUPERSCOPE_BITS;
```

And that's most of it. You can look inside the example file to have an idea of how you can program Super Scope games.

***MOUSE USAGE UPDATE***

Same as Super Scope, mouse uses detectMouse() to populate snes_mouse to 1, so It can be called at boot and like this:

```
if (snes_mouse == false)
{
  detectMouse();
  // some other code you might need in your program, like displaying warning messages and stopping your game.
}

```

Co-Authored-By: alekmaul <alekmaul@portabledev.com>

Super Scope support added, some other changes

Calibration now works as it should. scope_held functions are best explained too. Offscreen sprites now are hidden. Removed some unnecessary messages because we don't know if the fist aim adjust shot is in the middle of screen, so it's just a test screen.

Noise and Offscreen bits are not used in this example, but they are present on lib.

Super Scope Example update

soundbank.asm now fill banks with HiROM mapping, following -i usage. This is necessary or sound will be broken.

SMCONV fix

soundbank is smaller than $10000 in size, so it fits in one single bank.

Musical theme rearranged and some fun animations have been added ;)

I removed a branch present in bios, so both ports are read in one single vblank interrupt.
detectMouse() is called later, after nmi, so mouse is detected. snes_mouse is set to 0 when both mouses are not found, not the second one, this is to prevent potential issues.

Music inside HiROM mapped rom example and mouse support bug fixes

to free VBlank time that can be used by the `nmi_handler`

…troller

The functions that are called by the VBlank ISR have been moved to
vblank.asm

These functions are called by the VBlank ISR and should not be called
multiple times per frame.

The getpad1data loop did a 16-bit read of REG_JOYA, which also reads
from REG_JOYB, preventing the getpad23data loop from reading joypad
values.

scanMplay5 now tests if a standard controller is connected to the
multitap.

This commit also optimises the multitap reading code by:
 * Using Joypad Auto-Read to read the first three controllers.
 * Using ScanPads to read the first two controllers.
 * Using an 8 bit A when reading the last two controllers.
 * Using the carry output of `rol` to determine when all of the
   controller bits have been read.

As a consequence of the Joypad Auto-Read optimisation, the WRIO register
must not be written to when `snes_mplay5` is set.  I do not think this
will be an issue, since `REG_WRIO` (nor 4201) is not defined in the
header files nor the snes-examples directory.

Tested by running the multiplay5 example in Mesen

This is safe as the input reading subroutines/macros are private to the
vblank_isr section

During a lag frame:
 * oamMemory will not be transfered to the PPU OAM
 * the pads/mouse/scope will not be read

nmi_handler will be called on every VBlank interrupt.

The vblank_flag variable can be used to detect lag-frames in the
nmi_handler.

Crash was caused by a missing `.BASE 0` in the `.vblank_bss` ramsection.

This commit also fixes 2 more sections with the wrong .BASE.

Modifies WaitForVBlank() so it can be called with any DB register value.

Also documents that WaitForVBlank() will preserve A/X/Y registers.

The speed_change jsr in `_MouseRead` can crash if `mouseSpeedChange` is
in a different bank to `_MouseRead`.

speed_change has been changed to a child label to illuminate that
`_MouseRead` is calling a subroutine outside of vblank.asm.

mouse_read has been moved to vblank.asm and the same comments already
exist in vblank.asm.

Saves 2 cycles and matches the _GetScope call in the VBlank ISR.