RPI RMP Guide
RPI Software Setup SDK
Main Github
- Please ask for software support via github
- clone project https://github.com/hzeller/rpi-rgb-led-matrix/tree/master/adapter
- build the binary executable file, and use following commands
make -C examples-api-use
Prerequisite Checklist
double check for GPIOs
- turn off => SPI IIC, 1-wire, serial, etc in raspi-config
- turn off => sound in /boot/config.txt -> add line dtparam=audio=off
- optionally remove following modules: sudo apt-get remove bluez bluez-firmware pi-bluetooth triggerhappy pigpio
- optionally disable: audio in kernel
cat <<EOF | sudo tee /etc/modprobe.d/blacklist-rgb-matrix.conf blacklist snd_bcm2835 EOF
sudo update-initramfs -u
- by following up setup, the GPIO output should be all good
Quick Start Guide
Drive Notice
- The panels of the same size could have different drive (scan) methods, it depends on the panel's driver chip.
- please try different led-multiplexing, from 0~17
--led-multiplexing=0
P8 P10 Outdoor 32x16 (tested)
Run example for our selling 32x16 panel
- P10 - 32x16
./examples-api-use/demo -D 0 --led-cols=32 --led-rows=16 --led-multiplexing=8
./examples-api-use/demo -D 0 --led-cols=32 --led-rows=16 --led-multiplexing=3 ./examples-api-use/runtext16.ppm -D 0 --led-cols=32 --led-rows=16 --led-multiplexing=8 ./examples-api-use/demo -D 0 --led-cols=32 --led-rows=32 --led-multiplexing=1
- To chain other panel:
--led-chain=2 to --led-chain=4
- Other example will have the same configuration
--led-rows=8 --led-chain=2
32x32
- multiplexing =1
./examples-api-use/demo -D 0 --led-cols=32 --led-rows=32 --led-multiplexing=1
P4 64x32 (tested)
- multiplexing=0
./examples-api-use/demo -D 0 --led-cols=64 --led-rows=32 --led-multiplexing=0
- Tested panel is 64x32 P4-256x128-2121-A1
P3/P4 64x64 (tested)
Extra Setup Needed
- Setup P4 jumper to ground, P8 jumper to #E line
- multiplexing usually 0 or 1, try further options only when you have special board
CMD for both P3/P4
- ./examples-api-use/demo -D 0 --led-cols=64 --led-rows=64 --led-multiplexing=1
128x128 / 256x128
- Should be not supported
Panel Specifications
| Working Panel | Demo code | Panel Specification | Command |
|---|---|---|---|
| 32x16 P8 or P10 | 3216 | 1/4 | ./demo -D 0 --led-rows=8 --led-chain=2 |
| 32x32 P6 | 3232 | 1/8 | |
| 64x32 P4 | NA | 1/16 | |
| 64x64 P4 | NA | 1/32 |
Drive Demo
- The following demos are tested at 13th April
32x16
32x16 panel specs
6432 test01
6432 test02
64x64 test
64x64 P3 specs
64x64 P4 specs
More Types of Demos
Runtext demo 01
Runtext demo 02
- ./demo -D 1 runtext.ppm --led-no-hardware-pulse --led-slowdown-gpio=4 --led-cols=64 --led-rows=32
Troubleshooting / Common Debug List
Multiplexing and Chip Type
- Check the chip type (FM6126A)
- Check the multiplexing, this is how the problem looks like
Common Multiplexing Issue 01
Correct Multiplexing setup
- Tested working panel is 64x32, please refer above RPI_RMP_Guide#P4_64x32_.28tested.29
E-line Setup
- Check if your panel is oversize (64x64 is needed) or chained with multiple panels, then you need to setup the E-line
- The normal setup is P4 + GND, and P8 + #E
- Below is how problem looks like
- Problem demo video here: https://fb.watch/c7KIaWjqIr/
64x64 E-line not setup error issue
Further Help
- If you still have problems, please try the default demo: /rpi-rgb-led-matrix# ./examples-api-use/demo -D 0 --led-cols=64 --led-rows=32 --led-multiplexing=0
- And provide demo images to info@electrodragon.com to check.
FAQs
- Using all 3 chains with rPi 4, is there any GPIO free to use?
No any free pins left except SC / SD pins
- What are SC and SD pin holes?
GPIO0 = SDA0, GPIO7 = SCL0
- What are RX pin hole?
GPIO15, ROW_E pin, can be set to ground