ofxRpiLED

OpenFrameworks LED matrix addon for Raspberry Pi based on Henner Zeller's rpi-rgb-led-matrix library.



Hardware

• Raspberry PI Model B / 2
• Adafruit LED Hat

Defaults

If ``setup()` is run without parameters, the addon sets defaults for a single LED Matrix of 64 x 32 pixel. Please refer to the documentation of rpi-rgb-led-matrix on how to set up a different screen size.

Examples

There are two examples within this repo:



• example-image: loads and displays an image file. Headless application with `ofAppNoWindow` output.
• example-screen: does some 3d graphics and redirects the screen onto the LED-Matrix using the `grabScreen()`` function of ofImage.

LED Library

The addon uses hzeller's LED library precompiled. Probably you'll need to recompile the library if you are using a different hardware setup.

The LED library is precompiled with the following configuration options:

# Uncomment the following line for Adafruit Matrix HAT gpio mappings.
If you have an Adafruit HAT ( https://www.adafruit.com/products/2345 ),
you need to use this option as the HAT swaps pins around that are not
compatible with the default mapping.
DEFINES+=-DADAFRUIT_RGBMATRIX_HAT

Uncomment if you want to use the Adafruit HAT with stable PWM timings
The newer version of this library allows for much more stable (less flicker)
output, but it does not work with the Adafruit HAT unless you do a
simple hardware hack on them: connectk GPIO 4 (OE) with 18; they have
convenient solder holes on the board.
Then uncomment the following define.
DEFINES+=-DADAFRUIT_RGBMATRIX_HAT_PWM

It is recommended to install an image with a realtime kernel (for instance this one) to minimize a loaded system having an influence on the image quality according to Zellers readme.