Skip to content

Getting Started

Planning

If you want to run an existing playfield with PPUC you need to take some decisions:

  • Should the original wiring be kept?
  • Should lamps (inserts, GI and/ flashers) be replaced by addressable RGB LEDs?
  • Should switches be wired using a matrix or directly.
  • Which switches should drive coils as fast as possible or directly without involving the CPU?

(Pros ans cons will be described later.)

Multipe boards can be cascaded to to have enough input and output ports. The communication happens via a RS485 BUS and the protocol enhances the DOF protocol which is known from the virtual pinball world.

Get IO Boards

Depending on your decisions above, you you might need different IO boards and a different amount. The entire hardware is open source and you can order the boards from your preferred PCB manufacturer. Gerber and BOM files are part of the repositories:

Wiring the boards

  • Power
  • RS485 bus
  • Coils
  • Switches
  • Lamps
  • Motors

For more details read the hardware documentation.

Flash the IO Board Firware

To bring "life" into the PPUC boards they need to get some software. All the boards gets the same firmware. Details about what they shall do and what they are connected to, are set by the config file which is generated by the config tool. This will be used to initialize the boards on start up.

The boards are distinguished by an address. This must be set by DIP switches on the board. Every board must have a different address.

Download the latest firmware for your boards from https://github.com/PPUC/io-boards/releases/latest

Press and hold the Boot button of your board and connect it to your computer via USB. Release the button after a removable mass storage device is detected by your computer. Copy the appropriate uf2 file from the download above to that mass storage device. The board will automatically flash the firmware and reboot. Repeat that procedure for every board.

"CPU"

The IO boards need a CPU, regardless if you replacing broken or missing electronics or creating a homebrew game.

PinMAME

The platform independent PPUC command line tool can run on any old or small computer like a Raspberry Pi and leverages libpinmame to emulate the ROM.

PPUC Config-Tool

PPUC config-tool


Something missing or wrong? You can fix it!

This website is edited by people like you! Is something wrong or missing? Is something out of date, or can you explain it better?

Please help us! You can fix it yourself and be an official "open source" contributor!

It's easy! See our Beginner's guide to editing the docs.

Page navigation via the keyboard: < >

You can navigate this site via the keyboard. There are two modes:

General navigation, when search is not focused:

  • F , S , / : open search dialog
  • P , , : go to previous page
  • N , . : go to next page

While using the search function:

  • Down , Up : select next / previous result
  • Esc , Tab : close search
  • Enter : go to highlighted page in the results