Skip to content

p_roc:

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 p_roc: section of your config is where you configure hardware specific bits about the P-Roc or P3-Roc. In most cases you can omit this config and stick with the defaults.

Optional settings

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

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 know what is going on under the hood. We will usually ask you to set this if you experience any hardware related problems and send us your log.

display_flash_duty:

Single value, type: number (will be converted to floating point). Default: 0.5

Help us write it!

This section is unwritten or needs an update or edit. Can you help write it? Get your name in lights and geeky pinball bragging rights! Hit the magic sparkly wand to the right of the title to see this page source on GitHub. Then add/edit and submit your change. It's easy!

display_flash_frequency:

Single value, type: number (will be converted to floating point). Default: 1.0

Help us write it!

This section is unwritten or needs an update or edit. Can you help write it? Get your name in lights and geeky pinball bragging rights! Hit the magic sparkly wand to the right of the title to see this page source on GitHub. Then add/edit and submit your change. It's easy!

dmd_timing_cycles:

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

Only P-Roc (not P3-Roc).

Those values determine the timing to drive the different shades of your DMD. See How to configure mono/traditional DMD (P-ROC) for details.

dmd_update_interval:

Single value, type: time string (ms) (Instructions for entering time strings). Default: 33ms

Only P-Roc (not P3-Roc).

The update interval of your DMD. Usually you do not have to change this.

driverboards:

Single value, type: one of the following options: wpc, wpcAlphanumeric, wpc95, sternSAM, sternWhitestar, pdb, custom, None. Defaults to empty.

Similar to driverboards in the hardware: section. Use this setting if you use multiple playforms (i.e. FAST and P3-Roc) 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.

lamp_matrix_strobe_time:

Single value, type: time string (ms) (Instructions for entering time strings). Default: 100ms

Default: 100ms

The column strobe time for your lamp matrix. See How to configure Matrix Lights (P-ROC/P3-ROC) for details.

pd_led_boards:

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

A map of PD-LED boards with their ID as key and a configuration map as value. This can be used to configure indivdual features per board.

See Servos on a PD-LED (P-ROC/P3-ROC), Steppers on a PD-LED (P-ROC/P3-ROC) or How to configure LEDs on the PD-LED (P-ROC/P3-ROC) for details.

trace_bus:

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

Log all calls to libpinproc. This will cause a lot of additional log lines and might considerably slow down MPF. Use only during debugging.

use_separate_thread:

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

Whether MPF should spawn a separate thread to talk to the P/P3-Roc or not. If you set this to False any IO to the P/P3-Roc will block the game loop which might cause lags unrelated to the hardware. This has a small overhead but should be enabled in most cases.

use_watchdog:

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

Enable or disable the watchdog. Usually you want to keep this enabled.

watchdog_time:

Single value, type: time string (ms) (Instructions for entering time strings). Default: 1s

Watchdog timeout. The P/P3-Roc will disable all coils when the watchdog expires.

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