How mrcodetastic/esp32-hub75-matrixpanel-dma works
ESP32-HUB75-MatrixPanel-DMA is an embedded graphics library for driving HUB75 RGB LED panels through ESP32 hardware DMA. A user sketch invokes the MatrixPanel API, optionally through virtual-panel coordinate mapping or a GFX API; pixels are encoded into a DMA framebuffer with brightness and color correction, linked into descriptors, and continuously streamed by the platform-specific I2S or S3 GDMA backend to the panel. The graph reflects sampled runtime code and README capabilities; some unsampled integration details remain intentionally unwired.
Main entry points: ESP32-HUB75-MatrixPanel-I2S-DMA.h Matrix Panel API · gdma_lcd_parallel16.cpp S3 GDMA Bus · ESP32-HUB75-MatrixPanel-I2S-DMA.cpp DMA Descriptors · esp32_i2s_parallel_dma.cpp I2S Parallel Bus
Components 17
User Interface
- GFX API
- Matrix Panel API
src/ESP32-HUB75-MatrixPanel-I2S-DMA.h - Virtual Mapping
src/ESP32-HUB75-VirtualMatrixPanel_T.hpp
Rendering Core
- DMA Framebuffer
src/ESP32-HUB75-MatrixPanel-I2S-DMA.h - Pixel Encoder
src/ESP32-HUB75-MatrixPanel-I2S-DMA.cpp - CIE Correction
src/cie_luts.h - Brightness Control
src/ESP32-HUB75-MatrixPanel-I2S-DMA.cpp - Panel Drivers
src/ESP32-HUB75-MatrixPanel-leddrivers.cpp
DMA Transport
- Platform Selection
src/platforms/platform_detect.hpp - DMA Descriptors
src/ESP32-HUB75-MatrixPanel-I2S-DMA.cpp - I2S Parallel Bus
src/platforms/esp32/esp32_i2s_parallel_dma.cpp - S3 GDMA Bus
src/platforms/esp32s3/gdma_lcd_parallel16.cpp
Panel Hardware
- Pin Configuration
src/platforms/esp32/esp32-default-pins.hpp
Other components
- User Sketch
- ESP32 Hardware
- HUB75 Panel
- S3 PSRAM
Connections 22
- User Sketch → Matrix Panel API: draws pixels
- User Sketch → Virtual Mapping: draws virtually
- GFX API → Matrix Panel API: calls API
- Virtual Mapping → Matrix Panel API: maps coordinates
- Matrix Panel API → Pixel Encoder: encodes pixels
- Pixel Encoder → CIE Correction: uses LUTs
- Pixel Encoder → DMA Framebuffer: writes pixels
- Matrix Panel API → Brightness Control: sets brightness
- Brightness Control → DMA Framebuffer: updates OE
- Matrix Panel API → Panel Drivers: initializes drivers
- DMA Framebuffer → DMA Descriptors: supplies buffers
- Matrix Panel API → DMA Descriptors: creates links
- Platform Selection → I2S Parallel Bus: selects backend
- Platform Selection → S3 GDMA Bus: selects backend
- DMA Descriptors → I2S Parallel Bus: streams descriptors
- DMA Descriptors → S3 GDMA Bus: streams descriptors
- Pin Configuration → I2S Parallel Bus: configures pins
- Pin Configuration → S3 GDMA Bus: configures pins
- I2S Parallel Bus → ESP32 Hardware: outputs DMA
- S3 GDMA Bus → ESP32 Hardware: outputs GDMA
- S3 GDMA Bus → S3 PSRAM: optionally reads
- ESP32 Hardware → HUB75 Panel: drives panel