ScStw/ESP32-HUB75-MatrixPanel-DMA
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity
Mirror of https://github.com/mrfaptastic/ESP32-HUB75-MatrixPanel-DMA.git
28 commits 5 branches 13 tags 8.1 MiB
C++ 98.3%
CMake 1.7%
Find a file
mrfaptastic 21f8bbba45 Added ability to define custom pin mappings 
Closes issue #4

Use something like:
' display.begin(R1_PIN, G1_PIN, B1_PIN, R2_PIN, G2_PIN, B2_PIN, A_PIN, B_PIN, C_PIN, D_PIN, E_PIN, LAT_PIN, OE_PIN, CLK_PIN );  // setup the LED matrix'

with R1_PIN etc. referring to your own define or constant variables
2019-01-03 00:22:48 +00:00
examples Port Panel GFX demo. 2018-12-25 02:54:55 -08:00
ESP32-RGB64x32MatrixPanel-I2S-DMA.cpp Added ability to define custom pin mappings 2019-01-03 00:22:48 +00:00
ESP32-RGB64x32MatrixPanel-I2S-DMA.h Added ability to define custom pin mappings 2019-01-03 00:22:48 +00:00
esp32_i2s_parallel.c Inital commit 2018-10-13 03:03:34 +01:00
esp32_i2s_parallel.h New Version 2018-10-23 01:00:47 +01:00
image.jpg Update demo screen (less blurry, no overwrite and proper colors). 2018-12-25 01:52:47 -08:00
library.properties Updated library properties 2018-10-24 08:33:43 +01:00
LICENSE.txt Update LICENSE.txt 2018-10-23 01:14:40 +01:00
README.md Minor wording changes. 2018-10-29 22:57:10 +00:00

README.md

Adafruit_GFX RGB64x32MatrixPanel library for the ESP32, utilising I2S DMA.

This ESP32 Arduino library for an RGB LED (HUB 75 type) Matrix Panel, utilises the DMA functionality provided by the ESP32's I2S 'LCD Mode' which basically means that pixel data can be sent straight from memory, via the DMA controller, to the relevant LED Matrix GPIO pins with little CPU overhead.

As a result, this library can theoretically provide ~20 bit colour, at various brightness levels without resulting in noticeable flicker.

It's better in real life

Installation

  • Dependency: You will need to install Adafruit_GFX_Library from the "Library > Manage Libraries" menu.
  • Download and unzip this repository into your Arduino/libraries folder (or better still, use the Arudino 'add library from .zip' option.

Patching GPIO to avoid eratta of ESP32

You should patch the tools/sdk/ld/esp32.peripherals.ld to avoid random pixel noise on the display as following:

/* PROVIDE ( GPIO = 0x3ff44000 ); */
PROVIDE ( GPIO = 0x60004000 );

Please refer section 3.3. in https://www.espressif.com/sites/default/files/documentation/eco_and_workarounds_for_bugs_in_esp32_en.pdf for more details.

Wiring ESP32 with the LED Matrix Panel

If you wish to change this, you will need to adjust in the header file (ESP32-RGB64x32MatrixPanel-I2S-DMA.h).

+-----------+   Panel - ESP32 pins
|  R1   G1  |    R1   - IO25      G1   - IO26
|  B1   GND |    B1   - IO27
|  R2   G2  |    R2   - IO14      G2   - IO12
|  B2   GND |    B2   - IO13
|   A   B   |    A    - IO23      B    - IO22
|   C   D   |    C    - IO 5      D    - IO17
| CLK   LAT |    CLK  - IO16      LAT  - IO 4
|  OE   GND |    OE   - IO15
+-----------+

The panel must be powered by 5V AC adapter with enough current capacity. (Current varies due to how many LED are turned on at the same time. To drive all the LEDs, you need 5V4A adapter.)

A typical RGB panel available for purchase. This is of the larger P4 (4mm spacing between pixels) type.

Usage

Refer to the excellent PxMatrix based library for how to wire one of these panels up (in fact, it's probably best to first get your panel working with this library first to be sure): https://github.com/2dom/PxMatrix

You'll need to adjust the pin configuration in this library of course.

Notes

Seems to work well and drive a RGB panel with decent colours and little flicker. Even better that it uses Direct Memory Access :-)

Credits