JoystickShortcuts - mist-devel/mist-board GitHub Wiki

Gamepad keyboard shortcuts

Pressing certain button combinations with a USB joystick or gamepad will send specific keyboard keys to a core. This is useful for certain games that require a key press to continue.

The keyboard commands are made from the virtual gamepad as defined in this page. You can use mist.ini to change how hardware buttons map to the virtual gamepad, allowing to change which buttons trigger the below.

Command mappings (START)

  • START + A: press Enter key
  • START + B: press Space bar
  • START + L: press ESC key
  • START + R: press F1 key
  • START + SELECT: press F12 (opens OSD in most cores)

Mouse emulation (SELECT)

Keep SELECT pushed to emulate a mouse:

  • directions: Move cursor
  • L: Left click
  • R: Right click

OSD joystick control

When keyboard shortcuts are active, a controller can also be used to control the OSD:

  • A: choose / enter menu
  • B: cancel / return to previous menu
  • Up/Down/Left/Right: move around menu
  • SELECT + Up/Down: Pageup/Pagedown
  • L + Up/Down: Pageup/Pagedown
  • R + Up/Down: Pageup/Pagedown

Disabling shortcuts

To disable the above joystick mappings, set the following in mist.ini:

joystick_disable_shortcuts=1

On-board Buttons

  • Left button: Board reset
  • Middle button: Menu
  • Right button: User Button/Core defined

Besides their main functions, middle and right buttons have additional functions:

  1. Switch between 15KHz(TV) and 31KHz(Scandoubler) video modes: Hold the middle button pressed for more than 2 seconds.

  2. Switch between RGB and YPbPr modes: While keeping middle button pressed press and release the right button. Right button should be pressed within 2 seconds interval, otherwise (1) will be triggered.

  3. Since firmware 220821: the User Button switches the boot order of SD/USB across resets when it is pressed and held during power on or reset:

    • SD, fall back to USB (default)
    • USB, fall back to SD

    This is convenient when you want to test something on an USB stick without ejecting the SD card. Connect USB stick, press and hold User Button, power on MiST -> USB stick is the primary device.

    It's always possible to switch between the two boot priority settings by pressing and holding User Button and then reset MiST (Left Button).