pinHP User Manual

> Setup Instructions

Arcade Games

      • Navigate with joystick, arrow keys or gamepad.
        Left/Right: Scroll pagewise.
        Left/Right & Player1-Start: Jump alphabetically.
      • Select game or menu item: Player1-Button1 (‚Left-CTRL‘).
      • Insert coin: Player1-Start & Joystick up (‚1‘ & ‚Up-Arrow‘).
      • Exit game: Player1-Start & Player1-Button1 (‚1‘ & ‚Left-CTRL‘)
      • Go back in menu: Player1-Button2 (‚Left-ALT‘).
      • Edit Mame controls.

Options Menu

    • Screensaver
    • Filter Games
      • Filter games by various criteria.
    • Group Games
      • Group games by various criteria.
    • Reboot
      • Reboot the system. This option also forces a regeneration of the game menu.
    • Shutdown
      • Gracefully shut down the Raspberry system. Wait a couple of seconds, then you can safely power off the Arcade cabinet as well.
    • About
      • The obvious …
    • Uptime
      • The time the system has been running.

Game Menu Settings

    • Show Deleted Games
      List previously ‚deleted‘ (i. e. moved to roms_unused folder) games in games menu.
    • Hide Mature Games
      Hide mature games
    • 1 Line Game Menu
      Display all games found in ‚rpi2jamma/roms_advmame‘.
    • 2 Line Game Menu
      Display favourite games and all games.
    • 3 Line Game Menu
      Display favourite games, 2nd menu games and all games.
    • Fav. Games Menu Only
      Display favourite games.
    • Fav. & 2nd Menu Only
      Display favourite and 2nd menu games.
    • Custom Folders
      Enable subfolders inside ‚rpi2jamma/roms_advmame’. The menu list will be sorted alphabetically, according to the folders’ names. Avoid special characters in folder names, as they may crash the system, use the ‚.title‘ file instead. Each subfolder contains a ‚.title’ file to define an optional display name different from the folder name. Titles preceded by a hash (#) make the menu invisible but accessible. Titles preceded by a dot (.) are completely hidden from the menu.
    • Select Fav. Games
      The screen turns green. Select games you want to add to the favourites menu (‚Fav. Games‘). Changes are applied from inside the game menu by clicking ‚APPLY CHANGES‘ or when the green menu mode is left.
    • Deselect Fav. Games
      The screen turns red. Select games you want to remove from the favourites menu. Nothing is deleted – the games are still there, they are just not displayed in the favourites menu any more. Changes are applied from inside the game menu by clicking ‚APPLY CHANGES‘ or when the red menu mode is left.
    • Select 2nd Menu Games
      The screen turns green. Select games you want to add to the second favourites menu (‚More Games‘). Changes are applied from inside the game menu by clicking ‚APPLY CHANGES‘ or when the green menu mode is left.
    • Deselect 2nd Menu Games
      The screen turns red. Select games you want to remove from the second favourites menu. Nothing is deleted – the games are still there, they are just not displayed in the second favourites menu any more. Changes are applied from inside the game menu by clicking ‚APPLY CHANGES‘ or when the red menu mode is left.
    • Game Preview Images
      Display game preview images in the menu, if found in ‚rpi2jamma/snaps‘ (*.png file format).
    • Game Preview Videos
      Display game preview videos images in the menu, if found in ‚rpi2jamma/videos‘ (*.mp4 file format).
    • Video Volume
      Select the volume of game preview videos (LOW | MID | MAX | OFF).
    • Game Preview Marquees
      Display marquees, if found in ‚rpi2jamma/marquees‘.
    • Game Preview Logos
      Display logos, if found in ‚rpi2jamma/logos‘.
    • Game Count
      Display the number of games inside each game menu.
    • Display Friendly Names
      Filter out descriptive text like ‚(US set 1)‘ or ‚(rev 2)‘ from the game menu.
    • Orientation Filter
      Display only games matching the current screen setting.

Options Menu Settings

    • Display or hide the selected items in the ‚Options’ menu.

Mame Settings

    • Active Mame Config
      Support for up to three independent Mame configurations (‚advmame.rc’ configuration files). Game resolutions, button assignments or whatever is set from the pinHP ‚Mame Settings’ menu is saved in the current Mame configuration only, making it possible to e. g. have a set for Jamma controls and another set for gamepad controls. Hiscores are independent as they are not part of configuration files.
    • Display Button Layout
      Display a button layout image before starting a game, if found in ‚rpi2jamma/buttons‘. *.png file format. Technically, this is actually no Mame setting, though it is listed here.
    • Artwork Backdrop
      Display artwork files, if found in ‚rpi2jamma/artwork_advmame‘.
    • Artwork Overlay
      Display artwork files, if found in ‚rpi2jamma/artwork_advmame‘.
    • Brightness
      Set the brightness level ( 0.5 | 1.0 | 1.5 ).
    • Gamma
      Set the gamma level ( 0.5 | 1.0 | 1.5 ).
    • Vector antialias
      Anti-alias vector games.
    • Vsync
      Enable/disable vsync.
    • Enable Cheats
      Enable/disable Mame cheats, if available.
    • Free Play
      Enable/disable Mame free play, if available.
    • Idle Exit
      Exit Mame game back to pinHP menu after a certain idle time. Since there is no screensaver available in Mame, once back in pinHP menu, the screensaver (if selected) can be activated.
    • Custom Idle Exit Time
      Set any custom time (seconds).
    • Pause Dim Screen
      Dim the screen 50 % if a game is paused. Pause action: Player1-Start & Joystick down (‚1‘ & ‚Down-Arrow‘). Edit the default key combination from the Mame configuration menu.
    • Sound Normalize
      Enable/disable sound normalize.
    • Mono/Stereo
      mono | stereo | surround | auto
    • H-Games rotate L
      For vertical cabinets. Mame expects a horizontal monitor. Select this option to display horizontal games on a vertically mounted monitor. This will always be a compromise regarding game resolution.
    • V-Games rotate L
      For vertical cabinets. Select this option to properly display vertical games on a vertically mounted monitor.

Control Settings

    • Hardware Mode
      Important! Pi2Jamma or Pi2SCART. The hardware mode should be auto detected at boot. However, if it is not set properly, controls of a Jamma cabinet will not work or, on Pi2SCART, weird characters will flash on the screen.
    • USB Gamepad
      Select your gamepad for pinHP menu control. This is independent from Mame, which uses its own setup: TAB into Mame settings.
    • Enable ServoStik
      If you have a 4-8-way switchable Ultimarc® ServoStik mounted, this option enables control via the menu or automatically with each game.
    • P2-Start Button
      Player2-Start button, while in pinHP menu (not during a game) can trigger a defined action: Add game to favourites (not available if the system was made child proof), change screen orientation, activate screensaver, delete game (not available if the system was made child proof) or toggle ServoStik (if ServoStik is enabled).

Filter Settings

    • List
      Add selected items to filter selection lists
    • Unlist
      Remove selected items from filter selection lists
    • Reset All
      Reset all item selections to their default values

Screen Settings

    • Orientation
      Set the orientation of the pinHP menu. This is independent from Mame games. Mame orientation is set here.
    • Menu Size
      pinHP menu size.
    • Color
      Select your preferred pinHP menu style.
    • Text Size
      pinHP menu text size: Small | Normal
    • Text Align
      pinHP menu text alignment: Left | Center | Right
    • Text Color
      pinHP menu text color: Enter hex value.
    • Highlight Color
      pinHP “cursor” text color: Enter hex value.
    • Screen Upside Down
      For monitors not mounted the standard way.
    • Monitor Test Card
      Flip through seven different test images for monitor hardware adjustment.

System Settings

    • Select Autostart Game
      The screen turns blue. Select a game to run automatically after system boot.
    • Autostart Last Game
      Automatically run the last played game after system boot.
    • No Autostart
      Disable any autostart (game or screenaver)
    • Boot into Screensaver
      The system will boot right into a screensaver.
    • Screensaver
      Idle time until activation.
    • Custom Screensaver Time
      Custom idle time.
    • Screensaver Type
      Select from 13 different screensavers.
    • Status Messages
      Flash a brief status message when selecting a menu item (e. g. the name of the Mame ROM before starting a game).
    • Game Volume
      Set the game volume.
    • System Boot Date
      Select the date to be set when the system boots. There is no hardware clock in a Raspberry Pi, so the system date will always be wrong unless there is an Internet connection. Select between image date, last shutdown date or a custom date.
    • Set Time Zone
      Select your time zone.
    • Max. Data Partition
      Maximise the DATA partition of the SD card, making available unused space outside the default 16 GB image size.
    • Copy Games from SD to USB
      Copy all games from the system SD card to the USB stick.
    • Copy Games from USB to SD
      Copy all games from the USB stick to the system SD card.
    • Run External File
      Run a custom external file, to be placed in the ‚rpi2jamma’ directory.
      Attn. developers: Since a child process does not have access to its parent’s variables, the current pinHP variables are dumped into /tmp/pinhp_variables right before running the external file, making it possible to grep the values. The other way round, if you need to change pinHP variables, you can declare them in /tmp/external_vars. The main script sources this file right after executing the custom script/program.
    • AdvanceMENU Frontend
      Run alternative user interface, developed by the creator of AdvanceMAME, the MAME port used in pinHP. Press ESC to exit or ‚P1-Start & P1-Button1’.
    • Boot into AdvanceMENU
      Run AdvanceMenu user interface automatically.

Language Settings

    • Keyboard
      Select keyboard layout ( de|us|fr ).
    • *menu_* entries
      Edit display titles as you like.

      N.b.: Display text of all pinHP menu items can be edited in ‚rpi2jamma/language.ini‘.

Backup/Restore

    • Backup Settings
      Backup hiscores and MAME settings into to the ‚backup’ folder on the USB stick (or the SD card’s DATA partition).
    • Restore Settings
      Restore settings from the ‚backup’ folder. Asks for confirmation before actually restoring and overwriting settings. Does NOT restore files on the USB stick or DATA partition (favourites definitions, config.ini and language.ini).
    • Backup Fav. Settings
      Backup favourites definitions into the ‚backup’ folder on the USB stick (or the SD card’s DATA partition).
    • Restore Fav. Settings
      Restore favourites definitions from the ‚backup’ folder.

Online Tools

    • Wi-Fi Setup
      Select and connect to a Wi-Fi network. A keyboard is required for the first time, to enter encryption keys.
    • Connect now
      Connect to the selected network.
    • Auto Connect
      Automatically connect to the network during boot.
    • Show IP Address
      The IP address assigned to the system by your network. Required for SSH connection.
    • Disconnect Wi-Fi
      Disconnect current Wi-Fi.
    • Remove Wi-Fi Profiles
      Remove all saved Wi-Fi profiles from the system. Required if a network key has changed. Asks for confirmation.
    • Uptime Alarm by Mail
      Did you ever leave your game room for „just a minute“ and forgot to come back before the next weekend? Receive an email that the system is still up and running after a specified amount of time. To be configured inside ‚rpi2jamma/.mail‘ on the USB stick or the DATA partition.
    • Check for Update
      Check if system updates are available.

Exit into Shell

    • Exit Arcade. You are logged in to the Linux system as root user. Type ‘poweroff’ to gracefully shut down the system.

* Hide Settings Menu *

    • Make your system child proof. Removes all menu items which should be accessible to the system administrator only. The menu can be activated again by clicking any of the blank lines between ‘Back’ and ‘About’ three times (slowly) within 10 seconds.