diff --git a/README.md b/README.md index 4594b8b..f957701 100644 --- a/README.md +++ b/README.md @@ -38,7 +38,13 @@ This ESP32 Arduino/IDF library for HUB75 / HUB75E connector type 64x32 RGB LED 1 - **CIE 1931** luminance [correction](https://ledshield.wordpress.com/2012/11/13/led-brightness-to-your-eye-gamma-correction-no/) (aka natural LED dimming) - **Adafruit GFX API** - library could be build with AdafruitGFX, simplified GFX or without GFX API at all -If you wanna ask "*...OK, OK, than what's the price for those features?*" I'll tell you - "[memory](/doc/i2s_memcalc.md), you pay it all by precious MCU's memory for DMA buffer". +If you wanna ask "*...OK, OK, than what's the price for those features?*" I'll tell you - "[memory](/doc/i2s_memcalc.md), you pay it all by precious MCU's memory for DMA buffer". + +Please use the 'Memory Calculator' to see what is actually achievable with a typical ESP32. + +![Memory Calculator](doc/memcalc.jpg) + + ## ESP32 Supported This library supports the: diff --git a/doc/i2s_memcalc.xlsm b/doc/i2s_memcalc.xlsm deleted file mode 100644 index 9f30ee4..0000000 Binary files a/doc/i2s_memcalc.xlsm and /dev/null differ diff --git a/doc/i2scalc.png b/doc/i2scalc.png deleted file mode 100644 index f6396c1..0000000 Binary files a/doc/i2scalc.png and /dev/null differ diff --git a/doc/memcalc.jpg b/doc/memcalc.jpg new file mode 100644 index 0000000..16bb077 Binary files /dev/null and b/doc/memcalc.jpg differ diff --git a/doc/i2s_memcalc.md b/doc/memcalc.md similarity index 85% rename from doc/i2s_memcalc.md rename to doc/memcalc.md index f32a728..2525cf5 100644 --- a/doc/i2s_memcalc.md +++ b/doc/memcalc.md @@ -1,6 +1,6 @@ -### I2S HUB75 Calculator +### Memory Calculator -I've made this [spreadsheet](i2s_memcalc.xlsm) to estimate all of the main parameters for ESP32-HUB75-MatrixPanel-I2S-DMA lib driving any combination of matrices/chains so that I do not need to reflash it hundreds of times just to check for the debug info about memory. +I've made this [spreadsheet](memcalc.xlsm) to estimate all of the main parameters for ESP32-HUB75-MatrixPanel-DMA lib driving any combination of matrices/chains so that I do not need to reflash it hundreds of times just to check for the debug info about memory. Be sure to enable embedded macro's to allow refresh rate calculations. ![](i2scalc.png) @@ -8,7 +8,7 @@ Just fill-in all of the INPUT fields and get the OUTPUTs. So there are two main resources used to drive LED matrix - Memory - - I2S clock speed (resulting in available bandwidth to pump pixel color data) + - Bus clock speed (resulting in available bandwidth to pump pixel color data) And there are lot's of hogs for those: - matrix resolution (number of pixels) diff --git a/doc/memcalc.xlsm b/doc/memcalc.xlsm new file mode 100644 index 0000000..ec8bdb0 Binary files /dev/null and b/doc/memcalc.xlsm differ