Skip to content

How to configure Matrix Lights (P-ROC/P3-ROC)

Related Config File Sections:

To configure matrix lights connected to a PD-8x8 and a P-ROC or P3-ROC, you can follow the guides and instructions in the Lights docs. If you are using PD-LED with see the instructions about LEDs on PD-LED for P/P3-Roc.

However there are a few things to know about using matrix lights with a P3-ROC.


If you're using your P-ROC in an existing machine, then don't use the number settings here. Instead use the numbers from the existing machine section of the documentation.


Configure the number for each lamp in your lights: section with an entry that contains a bunch of letters and numbers which specify the specific columns and row outputs that make up each lamp. It's probably easiest to look at an example.

    subtype: matrix
    number: C-A2-B0-0:R-A2-B1-0

Notice there are two parts to the number, separated by a colon.

The first part is the column information:

  • C means "Column"
  • A2 means "the PD-8x8 at Address 2"
  • B0 means "Bank 0"
  • 0 means output "0"

The second part is the row information:

  • R means "Row"
  • A2 means "the PD-8x8 at Address 2"
  • B1 means "Bank 1"
  • 0 means input "0"

Luckily this is only something you have to work out once. :)

You only need subtype: matrix on the P3-Roc since subtype defaults to led. The P-Roc defaults to matrix so you may omit it there.

Fine tuning column strobe times

The lamp matrix works by quickly cycling through the columns and then activating the rows for the individual lamps that are supposed to be on in that specific column.

Back in the day when only incandescent bulbs were used, this pretty much worked the same everywhere and you didn't have to worry about any other settings. However now that it's possible to use LEDs replacement bulbs in your lamp matrices, and there are all sorts of LEDs like "anti-ghosting" and things like that, you may want to fine-tune the timing of how the columns are activated. You can do that in the p_roc: section of your machine-wide config.

For P-ROC:

  lamp_matrix_strobe_time: 100ms

For P3-ROC:

  lamp_matrix_strobe_time: 100ms

100ms is the default setting (which is used if you don't add this entry), but you can play with this value to see how it affects your lights or LEDs.

This is a system-wide setting, so if you have multiple lamp matrices on multiple PD-8x8 boards, then this setting will be used for all of them.

What if it did not work?

Have a look at our troubleshooting guide for the P/P3-Roc.

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