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
Reboot
Shutdown
Backup Settings
Restore Settings
About
> System Settings Menu
Monitor Test Card
Uptime
Select Fav. Games
Deselect Fav. Games
Select 2nd Menu Games
Deselect 2nd Menu Games
Select Autostart Game
Boot into Screensaver
No Autostart
DELETE Game from Disk
Undo LAST delete
Restore ALL Games
Clear ALL Hiscores
Hide Settings Menu

    • Screensaver
    • 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.
    • Backup Settings
      • Backup hiscores and MAME settings into to the ‚backup’ folder on the USB stick (or the SD card’s DATA partition).
        Included in the backup: Files from the SD card‘s Linux partition (Mame settings, hiscores and Wi-Fi settings). Favourites definitions (stored in ‚_games.template’ in the ROMs folder) and game menu settings (stored in ‚rpi2jamma/config.ini’ and ‚rpi2jamma/language.ini’)
    • 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).
    • About
      • The obvious …
    • Monitor Test Card
      • Flip through seven different test images for monitor hardware adjustment.
    • Uptime
      • The time the system has been running.
    • 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.
    • Select Autostart Game
      • The screen turns blue. Select a game to run automatically after system boot.
    • Boot into Screensaver
      • The system will boot right into a screensaver.
    • No Autostart
      • Turn off any autostart game or autostart screensaver.
    • DELETE Game from Disk
      • The screen turns red-white. Select game to be removed from the system (from the ‚rpi2jamma/roms_advmame‘ folder). The ROM file is not actually deleted, but rather moved into the ‚rpi2jamma/roms_unused’ folder.
    • Undo LAST Delete
      • Restore the last removed ROM.
    • Restore ALL Games
      • Restore all games from ‚rpi2jamma/roms unused’ back to the system (into ‚rpi2jamma/roms_advmame’).
    • Clear ALL Hiscores
      • Delete all hiscores. Asks for confirmation. The menu changes and you can ‘UNDO Clear Hiscores’
    • 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.

System Settings Menu

Game Menu Settings
Options Menu Settings
Language Settings
Mame Settings
Screen Settings
System Settings
Online Tools
Exit into Shell

Game Menu Settings

    • 1 Line Game Menu
      Display all games found in ‚rpi2jamma/roms_advmame‘.
    • 2 Line Game Menu
      Display favourite games as selected and all games.
    • 3 Line Game Menu
      Display favourite games, 2nd menu games as selected, and all games.
    • Fav. Games Menu Only
      Display favourite games as selected.
    • Fav. & 2nd Menu Only
      Display favourite and 2nd menu games as selected.
    • 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.
    • 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.
    • Game Count
      Display the number of games inside each game menu.
    • 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‘.
    • 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.

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‘.

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‘.
    • 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.

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

    • 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.
    • 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 10 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.
    • P2-Start Button
      The 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 or toggle ServoStik (if available).

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.