This is the dev documentation for an unreleased version of MPF!

This is the documentation for MPF 0.55+, which is the “dev” (next) release of MPF that is a work-in-progress. Unless you’re specifically looking for this version, you probably want to use the version of documentation called “latest” which is for the latest released version of MPF. That documentation is at docs.missionpinball.org/en/latest.

Matrix Lights (Bulbs)

Related Config File Sections

Some hardware platforms support lamps in a matrix. Those lights are usually bulbs and single color (white). Each of them is assigned to a unique column/row combination and driven sequentially by the platform.


TODO: Add a picture of bulbs in a matrix

There are various types of bulbs in pinball machines depending on when they were made. In EM and early SS #44 and #47 bulbs were used. Later SS machines used #555 bulbs (or the vibration resistant variant #444 or the #259 substitute). Those bulbs are rated at 6.3V but typically driven at 12V in a matrix or using AC voltages in older machines. Newer machines (pre LED) use #906 bulbs which are rated at 13.5V.


Details differ by platform but the syntax for the number of such a light is usually column:row or column:row (see your platform for details). The config looks like this:

    number: 2:10      # or 2/10
This example is tested to be valid MPF config. However, it is not integration tested.
    number: 2:10      # or 2/10

Monitorable Properties

For dynamic values and conditional events, the prefix for LEDs is device.lights.<name>.

  • color
  • corrected_color
Related How To Guides
Tutorial step 17: Add lights (or LEDs)
Related Events