aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authormrfaptastic <12006953+mrfaptastic@users.noreply.github.com>2020-11-28 08:39:35 +0000
committermrfaptastic <12006953+mrfaptastic@users.noreply.github.com>2020-11-28 08:39:35 +0000
commitb6da8ea09a84004354edf720cbd2c7d76f20d767 (patch)
treea4e0d2765d92cb4967971b243831bbac128dbe24
parent9f9150183619ae755a0d27449ab594b561e22918 (diff)
Change library name
-rw-r--r--ESP32-HUB75-MatrixPanel-I2S-DMA.cpp (renamed from ESP32-RGB64x32MatrixPanel-I2S-DMA.cpp)4
-rw-r--r--ESP32-HUB75-MatrixPanel-I2S-DMA.h (renamed from ESP32-RGB64x32MatrixPanel-I2S-DMA.h)2
-rw-r--r--ESP32-VirtualMatrixPanel-I2S-DMA.h2
-rw-r--r--README.md12
-rw-r--r--examples/AnimatedGIFPanel/AnimatedGIFPanel.ino2
-rw-r--r--examples/AuroraDemo/AuroraDemo.ino2
-rw-r--r--examples/BitmapIcons/BitmapIcons.ino2
-rw-r--r--examples/ChainedPanels/ChainedPanels.ino6
-rw-r--r--examples/ChainedPanels/README.md2
-rw-r--r--examples/ChainedPanelsAuroraDemo/ChainedPanelsAuroraDemo.ino2
-rw-r--r--examples/DoubleBufferSwap/DoubleBufferSwap.ino2
-rw-r--r--examples/FM6126Panel/FM6126Panel.ino2
-rw-r--r--examples/Glediator3_TPM2_MatrixPanel/Glediator3_TPM2_MatrixPanel.ino2
-rw-r--r--examples/PatternPlasma/PatternPlasma.ino2
-rw-r--r--examples/testshapes_32x64/testshapes_32x64.ino2
-rw-r--r--framebuffer_memory.md2
-rw-r--r--library.json8
-rw-r--r--library.properties8
18 files changed, 32 insertions, 32 deletions
diff --git a/ESP32-RGB64x32MatrixPanel-I2S-DMA.cpp b/ESP32-HUB75-MatrixPanel-I2S-DMA.cpp
index 69dd1f6..e720636 100644
--- a/ESP32-RGB64x32MatrixPanel-I2S-DMA.cpp
+++ b/ESP32-HUB75-MatrixPanel-I2S-DMA.cpp
@@ -1,4 +1,4 @@
-#include "ESP32-RGB64x32MatrixPanel-I2S-DMA.h"
+#include "ESP32-HUB75-MatrixPanel-I2S-DMA.h"
// Credits: Louis Beaudoin <https://github.com/pixelmatix/SmartMatrix/tree/teensylc>
// and Sprite_TM: https://www.esp32.com/viewtopic.php?f=17&t=3188 and https://www.esp32.com/viewtopic.php?f=13&t=3256
@@ -254,7 +254,7 @@ bool RGB64x32MatrixPanel_I2S_DMA::allocateDMAmemory()
}
}
- Serial.printf("*** ESP32-RGB64x32MatrixPanel-I2S-DMA: Memory Allocations Complete *** \r\n");
+ Serial.printf("*** ESP32-HUB75-MatrixPanel-I2S-DMA: Memory Allocations Complete *** \r\n");
Serial.printf("Total memory that was reserved: %d kB.\r\n", _total_dma_capable_memory_reserved/1024);
Serial.printf("... of which was used for the DMA Linked List(s): %d kB.\r\n", _dma_linked_list_memory_required/1024);
diff --git a/ESP32-RGB64x32MatrixPanel-I2S-DMA.h b/ESP32-HUB75-MatrixPanel-I2S-DMA.h
index c30709a..5075595 100644
--- a/ESP32-RGB64x32MatrixPanel-I2S-DMA.h
+++ b/ESP32-HUB75-MatrixPanel-I2S-DMA.h
@@ -324,7 +324,7 @@ class RGB64x32MatrixPanel_I2S_DMA : public Adafruit_GFX {
lldesc_t * dmadesc_a = {0};
lldesc_t * dmadesc_b = {0};
- // ESP32-RGB64x32MatrixPanel-I2S-DMA functioning
+ // ESP32-HUB75-MatrixPanel-I2S-DMA functioning
bool everything_OK = false;
bool double_buffering_enabled = false;// Do we use double buffer mode? Your project code will have to manually flip between both.
int back_buffer_id = 0; // If using double buffer, which one is NOT active (ie. being displayed) to write too?
diff --git a/ESP32-VirtualMatrixPanel-I2S-DMA.h b/ESP32-VirtualMatrixPanel-I2S-DMA.h
index 4655866..2a7e569 100644
--- a/ESP32-VirtualMatrixPanel-I2S-DMA.h
+++ b/ESP32-VirtualMatrixPanel-I2S-DMA.h
@@ -9,7 +9,7 @@
Twitter: https://twitter.com/witnessmenow
*******************************************************************/
-#include "ESP32-RGB64x32MatrixPanel-I2S-DMA.h"
+#include "ESP32-HUB75-MatrixPanel-I2S-DMA.h"
#include <Fonts/FreeSansBold12pt7b.h>
diff --git a/README.md b/README.md
index e34a12a..526fe37 100644
--- a/README.md
+++ b/README.md
@@ -21,7 +21,7 @@ As a result, this library can theoretically provide ~16-24 bit colour, at variou
# Wiring ESP32 with the LED Matrix Panel
-By default the pin mapping is as follows (defaults defined in ESP32-RGB64x32MatrixPanel-I2S-DMA.h).
+By default the pin mapping is as follows (defaults defined in ESP32-HUB75-MatrixPanel-I2S-DMA.h).
```
HUB 75 PANEL ESP 32 PIN
@@ -71,13 +71,13 @@ Below is a bare minimum sketch to draw a single white dot in the top left. You m
No .begin() before other functions = Crash
```
-#include <ESP32-RGB64x32MatrixPanel-I2S-DMA.h>
+#include <ESP32-HUB75-MatrixPanel-I2S-DMA.h>
RGB64x32MatrixPanel_I2S_DMA matrix;
void setup()
{
// MUST DO THIS FIRST!
- matrix.begin(); // Use default pins supplied within ESP32-RGB64x32MatrixPanel-I2S-DMA.h
+ matrix.begin(); // Use default pins supplied within ESP32-HUB75-MatrixPanel-I2S-DMA.h
// matrix.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 ); // or custom pins
// Draw a single white pixel
@@ -131,12 +131,12 @@ Summary: setPanelBrightness(xx) value can be any number from 0 (display off) to
## Power, Power and Power!
-Having a good power supply is CRITICAL, and it is highly recommended, for chains of LED Panels to have a 2000uf capacitor soldered to the back of each LED Panel across the [GND and VCC pins](https://github.com/mrfaptastic/ESP32-RGB64x32MatrixPanel-I2S-DMA/issues/39#issuecomment-720780463), otherwise you WILL run into issues with 'flashy' graphics whereby a large amount of LEDs are turned on and off in succession (due to current/power draw peaks and troughs).
+Having a good power supply is CRITICAL, and it is highly recommended, for chains of LED Panels to have a 2000uf capacitor soldered to the back of each LED Panel across the [GND and VCC pins](https://github.com/mrfaptastic/ESP32-HUB75-MatrixPanel-I2S-DMA/issues/39#issuecomment-720780463), otherwise you WILL run into issues with 'flashy' graphics whereby a large amount of LEDs are turned on and off in succession (due to current/power draw peaks and troughs).
Refer to this guide written for the [rpi-rgb-led-matrix library](https://github.com/hzeller/rpi-rgb-led-matrix/blob/master/wiring.md#a-word-about-power) for an explanation.
-- Refer to this [example](https://github.com/mrfaptastic/ESP32-RGB64x32MatrixPanel-I2S-DMA/issues/39#issuecomment-722691127) issue of what can go wrong with a poor powersupply.
-- Refer to [this comment](https://github.com/mrfaptastic/ESP32-RGB64x32MatrixPanel-I2S-DMA/issues/35#issuecomment-726419862) in regards to certain panels not playing nice with voltages, and a 3.3volt signal that the ESP32 GPIO can only provide.
+- Refer to this [example](https://github.com/mrfaptastic/ESP32-HUB75-MatrixPanel-I2S-DMA/issues/39#issuecomment-722691127) issue of what can go wrong with a poor powersupply.
+- Refer to [this comment](https://github.com/mrfaptastic/ESP32-HUB75-MatrixPanel-I2S-DMA/issues/35#issuecomment-726419862) in regards to certain panels not playing nice with voltages, and a 3.3volt signal that the ESP32 GPIO can only provide.
## Inspiration
diff --git a/examples/AnimatedGIFPanel/AnimatedGIFPanel.ino b/examples/AnimatedGIFPanel/AnimatedGIFPanel.ino
index 112c60f..f78d5ff 100644
--- a/examples/AnimatedGIFPanel/AnimatedGIFPanel.ino
+++ b/examples/AnimatedGIFPanel/AnimatedGIFPanel.ino
@@ -21,7 +21,7 @@
#define FILESYSTEM SPIFFS
#include <SPIFFS.h>
#include <AnimatedGIF.h>
-#include <ESP32-RGB64x32MatrixPanel-I2S-DMA.h>
+#include <ESP32-HUB75-MatrixPanel-I2S-DMA.h>
// ----------------------------
diff --git a/examples/AuroraDemo/AuroraDemo.ino b/examples/AuroraDemo/AuroraDemo.ino
index 917611d..dbc0dc5 100644
--- a/examples/AuroraDemo/AuroraDemo.ino
+++ b/examples/AuroraDemo/AuroraDemo.ino
@@ -20,7 +20,7 @@
#define MATRIX_HEIGHT 32
/* -------------------------- Class Initialisation -------------------------- */
-#include <ESP32-RGB64x32MatrixPanel-I2S-DMA.h>
+#include <ESP32-HUB75-MatrixPanel-I2S-DMA.h>
RGB64x32MatrixPanel_I2S_DMA matrix;
#include <FastLED.h>
diff --git a/examples/BitmapIcons/BitmapIcons.ino b/examples/BitmapIcons/BitmapIcons.ino
index 72328c5..310c8a8 100644
--- a/examples/BitmapIcons/BitmapIcons.ino
+++ b/examples/BitmapIcons/BitmapIcons.ino
@@ -1,5 +1,5 @@
#include <Arduino.h>
-#include <ESP32-RGB64x32MatrixPanel-I2S-DMA.h>
+#include <ESP32-HUB75-MatrixPanel-I2S-DMA.h>
#include "Dhole_weather_icons32px.h"
/*--------------------- DEBUG -------------------------*/
diff --git a/examples/ChainedPanels/ChainedPanels.ino b/examples/ChainedPanels/ChainedPanels.ino
index 3f90042..da3b3f4 100644
--- a/examples/ChainedPanels/ChainedPanels.ino
+++ b/examples/ChainedPanels/ChainedPanels.ino
@@ -3,7 +3,7 @@
Steps to use
-----------
- 1) In ESP32-RGB64x32MatrixPanel-I2S-DMA.h:
+ 1) In ESP32-HUB75-MatrixPanel-I2S-DMA.h:
- Set the MATRIX_HEIGHT to be the y resolution of the physical chained
panels in a line (if the panels are 32 x 16, set it to be 16)
@@ -25,7 +25,7 @@
Thanks to:
* Brian Lough for the original example as raised in this issue:
- https://github.com/mrfaptastic/ESP32-RGB64x32MatrixPanel-I2S-DMA/issues/26
+ https://github.com/mrfaptastic/ESP32-HUB75-MatrixPanel-I2S-DMA/issues/26
YouTube: https://www.youtube.com/brianlough
Tindie: https://www.tindie.com/stores/brianlough/
@@ -202,7 +202,7 @@ void setup() {
if (dma_display.width() != NUM_ROWS*NUM_COLS*PANEL_RES_X )
{
- Serial.println(F("\r\nERROR: MATRIX_WIDTH and/or MATRIX_HEIGHT in 'ESP32-RGB64x32MatrixPanel-I2S-DMA.h'\r\nis not configured correctly for the requested VirtualMatrixPanel dimensions!\r\n"));
+ Serial.println(F("\r\nERROR: MATRIX_WIDTH and/or MATRIX_HEIGHT in 'ESP32-HUB75-MatrixPanel-I2S-DMA.h'\r\nis not configured correctly for the requested VirtualMatrixPanel dimensions!\r\n"));
Serial.printf("WIDTH according dma_display is %d, but should be %d. Is your NUM_ROWS and NUM_COLS correct?\r\n", dma_display.width(), NUM_ROWS*NUM_COLS*PANEL_RES_X);
return;
}
diff --git a/examples/ChainedPanels/README.md b/examples/ChainedPanels/README.md
index 9385522..7b8e526 100644
--- a/examples/ChainedPanels/README.md
+++ b/examples/ChainedPanels/README.md
@@ -16,7 +16,7 @@ the matrix, but with VirtualDisplay library looking after the pixel mapping to t
### Steps to Use ###
-1) In ESP32-RGB64x32MatrixPanel-I2S-DMA.h:
+1) In ESP32-HUB75-MatrixPanel-I2S-DMA.h:
- Set the MATRIX_HEIGHT to be the y resolution of the physical chained panels in a line (if the panels are 32 x 16, set it to be 16)
- Set the MATRIX_WIDTH to be the sum of the x resolution of all the physical chained panels (i.e. If you have 4 x (32px w x 16px h) panels, 32x4 = 128)
diff --git a/examples/ChainedPanelsAuroraDemo/ChainedPanelsAuroraDemo.ino b/examples/ChainedPanelsAuroraDemo/ChainedPanelsAuroraDemo.ino
index 1dddd56..9379d7c 100644
--- a/examples/ChainedPanelsAuroraDemo/ChainedPanelsAuroraDemo.ino
+++ b/examples/ChainedPanelsAuroraDemo/ChainedPanelsAuroraDemo.ino
@@ -46,7 +46,7 @@ int lastPattern = 0;
/* -------------------------- Class Initialisation -------------------------- */
-//#include <ESP32-RGB64x32MatrixPanel-I2S-DMA.h>
+//#include <ESP32-HUB75-MatrixPanel-I2S-DMA.h>
//RGB64x32MatrixPanel_I2S_DMA matrix;
#include <ESP32-VirtualMatrixPanel-I2S-DMA.h>
diff --git a/examples/DoubleBufferSwap/DoubleBufferSwap.ino b/examples/DoubleBufferSwap/DoubleBufferSwap.ino
index 06de58f..8ed410c 100644
--- a/examples/DoubleBufferSwap/DoubleBufferSwap.ino
+++ b/examples/DoubleBufferSwap/DoubleBufferSwap.ino
@@ -1,4 +1,4 @@
-#include <ESP32-RGB64x32MatrixPanel-I2S-DMA.h>
+#include <ESP32-HUB75-MatrixPanel-I2S-DMA.h>
RGB64x32MatrixPanel_I2S_DMA display(true); // Note the TRUE -> Turns of secondary buffer - "double buffering"!
// Double buffering is not enabled by default with the library.
diff --git a/examples/FM6126Panel/FM6126Panel.ino b/examples/FM6126Panel/FM6126Panel.ino
index 8b8bd17..f1820be 100644
--- a/examples/FM6126Panel/FM6126Panel.ino
+++ b/examples/FM6126Panel/FM6126Panel.ino
@@ -2,7 +2,7 @@
// https://github.com/hzeller/rpi-rgb-led-matrix/issues/746
#include <Arduino.h>
-#include <ESP32-RGB64x32MatrixPanel-I2S-DMA.h>
+#include <ESP32-HUB75-MatrixPanel-I2S-DMA.h>
RGB64x32MatrixPanel_I2S_DMA dma_display;
diff --git a/examples/Glediator3_TPM2_MatrixPanel/Glediator3_TPM2_MatrixPanel.ino b/examples/Glediator3_TPM2_MatrixPanel/Glediator3_TPM2_MatrixPanel.ino
index e44a8f7..dc884a8 100644
--- a/examples/Glediator3_TPM2_MatrixPanel/Glediator3_TPM2_MatrixPanel.ino
+++ b/examples/Glediator3_TPM2_MatrixPanel/Glediator3_TPM2_MatrixPanel.ino
@@ -1,5 +1,5 @@
/* -------------------------- Class Initialisation -------------------------- */
-#include <ESP32-RGB64x32MatrixPanel-I2S-DMA.h>
+#include <ESP32-HUB75-MatrixPanel-I2S-DMA.h>
RGB64x32MatrixPanel_I2S_DMA matrix;
#include "TPM2.h" // https://github.com/rstephan/TPM2
diff --git a/examples/PatternPlasma/PatternPlasma.ino b/examples/PatternPlasma/PatternPlasma.ino
index b0f5d4b..5f8cb95 100644
--- a/examples/PatternPlasma/PatternPlasma.ino
+++ b/examples/PatternPlasma/PatternPlasma.ino
@@ -43,7 +43,7 @@
#define OE_PIN 13
-#include <ESP32-RGB64x32MatrixPanel-I2S-DMA.h>
+#include <ESP32-HUB75-MatrixPanel-I2S-DMA.h>
RGB64x32MatrixPanel_I2S_DMA dma_display;
#include <FastLED.h>
diff --git a/examples/testshapes_32x64/testshapes_32x64.ino b/examples/testshapes_32x64/testshapes_32x64.ino
index 0960942..a30d05c 100644
--- a/examples/testshapes_32x64/testshapes_32x64.ino
+++ b/examples/testshapes_32x64/testshapes_32x64.ino
@@ -1,4 +1,4 @@
-#include <ESP32-RGB64x32MatrixPanel-I2S-DMA.h>
+#include <ESP32-HUB75-MatrixPanel-I2S-DMA.h>
RGB64x32MatrixPanel_I2S_DMA dma_display;
// Or use an Alternative non-DMA library, i.e:
diff --git a/framebuffer_memory.md b/framebuffer_memory.md
index 9f31088..982d40f 100644
--- a/framebuffer_memory.md
+++ b/framebuffer_memory.md
@@ -48,4 +48,4 @@ Given it's possible to display 128x32 with double buffering in approx. 100kB of
# Caveats
-Experimentation will be required as available memory is highly dependant on other stuff you have in your sketch. It is best to include and use the 'ESP32-RGB64x32MatrixPanel-I2S-DMA' library as early as possible in your code and analyse the serial output of `heap_caps_print_heap_info(MALLOC_CAP_DMA)` to see what DMA memory blocks are available.
+Experimentation will be required as available memory is highly dependant on other stuff you have in your sketch. It is best to include and use the 'ESP32-HUB75-MatrixPanel-I2S-DMA' library as early as possible in your code and analyse the serial output of `heap_caps_print_heap_info(MALLOC_CAP_DMA)` to see what DMA memory blocks are available.
diff --git a/library.json b/library.json
index 84c9cad..7311ae3 100644
--- a/library.json
+++ b/library.json
@@ -1,16 +1,16 @@
{
- "name": "ESP32 64x32 LED MATRIX HUB75 DMA Display",
+ "name": "ESP32 HUB75 LED MATRIX PANEL DMA Display",
"keywords": "hub75, esp32, display, dma, rgb matrix",
- "description": "An experimental Adafruit GFX compatible library for 64x32 RGB matrix modules (other modules not tested - YMMV), using the ESP's DMA Engine for ultra-fast refresh rates, no-interrupts and therefore very low CPU usage (5%) so you can do other things with your ESP32.",
+ "description": "An experimental Adafruit GFX compatible library for 64x32 or 64x64 LED matrix modules using the ESP32 DMA Engine for ultra-fast refresh rates, no-interrupts and therefore very low CPU usage.",
"repository": {
"type": "git",
- "url": "https://github.com/mrfaptastic/ESP32-RGB64x32MatrixPanel-I2S-DMA.git"
+ "url": "https://github.com/mrfaptastic/ESP32-HUB75-MatrixPanel-I2S-DMA.git"
},
"authors": {
"name": "Faptastic",
"url": "https://github.com/mrfaptastic/"
},
- "version": "1.2.2",
+ "version": "1.2.3",
"frameworks": "arduino",
"platforms": "esp32",
"examples": [
diff --git a/library.properties b/library.properties
index 6b7f5ef..929662a 100644
--- a/library.properties
+++ b/library.properties
@@ -1,9 +1,9 @@
-name=ESP32 64x32 LED MATRIX HUB75 DMA Display
-version=1.2.2
+name=ESP32 HUB75 LED MATRIX PANEL DMA Display
+version=1.2.3
author=Faptastic
maintainer=Faptastic
sentence=Experimental DMA based LED Matrix HUB75 Library
-paragraph=An experimental Adafruit GFX compatible library for 64x32 RGB matrix modules (other modules not tested - YMMV), using the ESP's DMA Engine for ultra-fast refresh rates, no-interrupts and very low CPU usage (5%).
+paragraph=An experimental Adafruit GFX compatible library for 64x32 or 64x64 LED matrix modules using the ESP32 DMA Engine for ultra-fast refresh rates, no-interrupts and therefore very low CPU usage.
category=Display
-url=https://github.com/mrfaptastic/ESP32-RGB64x32MatrixPanel-I2S-DMA
+url=https://github.com/mrfaptastic/ESP32-HUB75-MatrixPanel-I2S-DMA
architectures=esp32