Warning

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

This is the documentation for MPF 0.56, 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.

smartmatrix:

Config file section

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

The smartmatrix: section of your config is where you configure RGB DMD devices.

This is an example:

#config_version=5
hardware:
  rgb_dmd: smartmatrix
smartmatrix:
  my_smartmatrix:
    port: com4
    baud: 4000000
displays:
  dmd:
    width: 128
    height: 32
rgb_dmds:
  my_smartmatrix:
    hardware_brightness: .5
This example is tested to be valid MPF and MPF-MC config. However, it is not integration tested.
#config_version=5
hardware:
  rgb_dmd: smartmatrix
smartmatrix:
  my_smartmatrix:
    port: com4
    baud: 4000000
displays:
  dmd:
    width: 128
    height: 32
rgb_dmds:
  my_smartmatrix:
    hardware_brightness: .5

Required settings

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

baud:

Single value, type: integer. Defaults to empty.

Baud rate of your serial port. Depends on the smartmatrix firmware.

port:

Single value, type: string. Defaults to empty.

Name of the serial port of your smartmatrix device. This will be comX on Windows. On Linux and Mac it depends on the usb-serial chip (usually /dev/ttyUSBX on linux or /dev/tty.usbmodemYYY on Mac).

Optional settings

The following sections are optional in the smartmatrix: 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

file_log:

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