Skip to content

opp:

This is a config file reference. Click for instructions.

This page is reference material which explains every setting and option for this section of an MPF yaml config file. See the instructions for config files for formatting and other details. See our guide to config file examples for more examples of real configs in action.

Valid in
machine config files YES ✅
mode config files NO 🚫

The opp: section of your config is where you configure your OPP platform. See How to configure Open Pinball Project (OPP) hardware for MPF for details.

This is an example:

hardware:
  platform: opp
  driverboards: gen2
opp:
  ports: COM7

Required settings

The following sections are required in the opp: section of your config:

ports:

List of one (or more) values, each is a type: string. Defaults to empty.

Serial ports to use.

Optional settings

The following sections are optional in the opp: section of your config. (If you don't include them, the default will be used).

baud:

Single value, type: integer. Default: 115200

Baud rate to use on the serial port.

chains:

One or more sub-entries. Each in the format of string : string

This is an example:

opp:
  ports: /dev/ttyOPP0, /dev/ttyOPP1
  chains:
    0: /dev/ttyOPP0
    1: /dev/ttyOPP1

If you switch was number 1-3 before it will be 0-1-3 or 1-1-3 afterwards.

console_log:

Single value, type: one of the following options: none, basic, full. Default: none

Log level for the console log for this platform.

debug:

Single value, type: boolean (true/false). Default: false

Set this to true if you want to see more debug output.

driverboards:

Single value, type: one of the following options: gen2. Default: gen2

Similar to driverboards in the hardware: section. Use this setting if you use multiple playforms (i.e. FAST and OPP) in one machine.

file_log:

Single value, type: one of the following options: none, basic, full. Default: basic

Log level for the file log for this platform.

incand_update_hz:

Single value, type: integer. Default: 25

The update rate for incandecant bulbs. Do not set this too high or you might saturate the OPP bus.

poll_hz:

Single value, type: integer. Default: 100

How many times per section the OPP hardware is polled for switch changes. Default is 100.

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