Skip to content
This repository has been archived by the owner on May 18, 2024. It is now read-only.

Best Performance

Joel Joannisse edited this page Feb 7, 2021 · 3 revisions

Performance-related command Flags

This is a collection of flags from the [https://github.com/hzeller/rpi-rgb-led-matrix](rgb matrix library) that affect the performance of your display.

--led-rows Display rows.                16 for 16x32, 32 for 32x32 and 64x32. (Default: 32)
--led-cols Panel columns.               Typically 32 or 64. (Default: 32)
--led-chain                             Daisy-chained boards. (Default: 1)
--led-parallel                          For Plus-models or RPi2: parallel chains. 1..3. (Default: 1)
--led-pwm-bits                          Bits used for PWM. Range 1..11. (Default: 11)
--led-brightness                        Sets brightness level. Range: 1..100. (Default: 100)
--led-gpio-mapping                      Hardware Mapping: regular, adafruit-hat, adafruit-hat-pwm
--led-scan-mode                         Progressive or interlaced scan. 0 = Progressive, 1 = Interlaced. (Default: 1)
--led-pwm-lsb-nanosecond                Base time-unit for the on-time in the lowest significant bit in nanoseconds. (Default: 130)
--led-show-refresh                      Shows the current refresh rate of the LED panel.
--led-slowdown-gpio                     Slow down writing to GPIO. Range: 0..4. (Default: 1)
--led-no-hardware-pulse                 Don't use hardware pin-pulse generation.
--led-rgb-sequence                      Switch if your matrix has led colors swapped. (Default: RGB)
--led-pixel-mapper                      Apply pixel mappers. e.g Rotate:90, U-mapper
--led-row-addr-type                     0 = default; 1 = AB-addressed panels. (Default: 0)
--led-multiplexing                      Multiplexing type: 0 = direct; 1 = strip; 2 = checker; 3 = spiral; 4 = Z-strip; 5 = ZnMirrorZStripe; 6 = coreman; 7 = Kaler2Scan; 8 = ZStripeUneven. (Default: 0)
--led-panel-type:                       Needed to initialize special panels. Supported: 'FM6126A', 'FM6127'

Using either a raspberry Zero, 3B+, 3A+ and 4B with an Adafruit HAT or Bonnet, here's what I did to run my board properly.

  • Do the hardware mod found in the Improving flicker section.
  • Disable the onboard sound. You can find how to do it from the Troubleshooting sections
  • From the same section, run the command that removes the Bluetooth firmware, Unless you use any Bluetooth device with your Pi.

Finally, these are the flag I use. (ONLY USE THESE FLAGS IF YOU'VE DONE THE HARDWARD ANTI-FLICKERING MOD. If not, replace the first flag with --led-gpio-mapping=adafruit-hat).

--led-gpio-mapping=adafruit-hat-pwm --led-brightness=60 --led-slowdown-gpio=2

For Raspberry pi 3 and up.

This command removes ALL flickering. I only notice some glitch when the scoreboard start.

DO NOT USE ON A PI ZERO. Some of these flags make the scoreboard use more CPU power, which the Pi Zero has none. It might work but it will definitely slow it down.

--led-gpio-mapping=adafruit-hat-pwm --led-brightness=50 --led-slowdown-gpio=2 --led-pwm-bits=10 --led-limit-refresh=120 --led-pwm-dither-bits=1
Clone this wiki locally