Software Prerequisites


This project uses a fork of the hzeller project on Github.  The fork only has changes to specify the scrolling text as a command line argument.  The main branch can be used once this pull request is accepted.

Use these commands to download the code to the Raspberry Pi and build the Web application's dependencies.

// install dependencies for the scrolling text
sudo apt-get update

sudo aptitude install libgraphicsmagick++-dev libwebp-dev

sudo apt-get install libgraphicsmagick++-dev libwebp-dev -y

sudo apt-get install libwebp-dev

sudo apt-get install python2.7-dev python-pillow -y

// download the C++ project that drives the GPIO
git clone

// build the project, specifing the Adafruit HAT as the hardware profile
cd rpi-rgb-led-matrix
sudo HARDWARE_DESC=adafruit-hat make install-python

cd utils/
sudo make led-image-viewer

cd ../examples-api-use

Before continuing, be sure the following demo programs built into the rpi-rgb-led-matrix library run without errors and you see the LED panel lighting up.  

The first demo is the spinning square.

$ cd rpi-rgb-led-matrix/examples-api-use 

$ sudo ./demo -D -m 0 --led-no-hardware-pulse --led-gpio-mapping=adafruit-hat

The second demo is scrolling test.

cd python/samples/
sudo ./

Payara (runs WAR files)

The Web application for this project uses JEE and is packaged as a WAR file.  Payara Server 4.1.x is used to run the Web app.

I tried Payara MicroProfile 164 from the main downlaods page, but it has issues running the WAR.  The prerelease seems stable while running this project.  See the following link and download JAR named "Payara-Micro (Web Profile Implementation)":
Copy the JAR to the Raspberry Pi.  It is used later in the project.

Here is a local copy of the Payara JAR, in case the specific version used in this project is not available for some reason.

The following command can be used to download the local copy of JAR file.

$ wget
Last updated on Feb 19, 2017 Published on Jan 02, 2017