P4 80x40 Qiangli module 1/10 scan

[maxmurugan]

hi sir

i am flowing board707 Pico board well working .now trying wf2 controller

DP52125 + DP2020 (shift register decoder)

#define PANEL_CHAIN_TYPE CHAIN_NONE
and
#define PANEL_SCAN_TYPE FOUR_SCAN_40_80PX_HFARCAN

mxconfig.driver = HUB75_I2S_CFG::DP3246_SM5368;

flowing setting display showing incorrect please help

WhatsApp.Video.2025-07-30.at.10.14.17.PM.mp4

[board707]

@maxmurugan
Please show the Arduino compile output of your test code.

[maxmurugan]

Sketch uses 315564 bytes (9%) of program storage space. Maximum is 3342336 bytes.
Global variables use 19904 bytes (6%) of dynamic memory, leaving 307776 bytes for local variables. Maximum is 327680 bytes.
esptool.py v4.8.1
Serial port COM18
Connecting...
Chip is ESP32-S3 (QFN56) (revision v0.2)
Features: WiFi, BLE
Crystal is 40MHz
MAC: c0:4e:30:19:54:20
Uploading stub...
Running stub...
Stub running...
Changing baud rate to 921600
Changed.
Configuring flash size...
Flash will be erased from 0x00000000 to 0x00004fff...
Flash will be erased from 0x00008000 to 0x00008fff...
Flash will be erased from 0x0000e000 to 0x0000ffff...
Flash will be erased from 0x00010000 to 0x0005dfff...
Compressed 18928 bytes to 12222...
Writing at 0x00000000... (100 %)
Wrote 18928 bytes (12222 compressed) at 0x00000000 in 0.4 seconds (effective 395.5 kbit/s)...
Hash of data verified.
Compressed 3072 bytes to 146...
Writing at 0x00008000... (100 %)
Wrote 3072 bytes (146 compressed) at 0x00008000 in 0.0 seconds (effective 516.2 kbit/s)...
Hash of data verified.
Compressed 8192 bytes to 47...
Writing at 0x0000e000... (100 %)
Wrote 8192 bytes (47 compressed) at 0x0000e000 in 0.1 seconds (effective 761.6 kbit/s)...
Hash of data verified.
Compressed 315680 bytes to 169005...
Writing at 0x00010000... (9 %)
Writing at 0x0001b015... (18 %)
Writing at 0x00028893... (27 %)
Writing at 0x0002e0a1... (36 %)
Writing at 0x00033b4f... (45 %)
Writing at 0x00039570... (54 %)
Writing at 0x0003ecf5... (63 %)
Writing at 0x000443e1... (72 %)
Writing at 0x0004ae4c... (81 %)
Writing at 0x00055079... (90 %)
Writing at 0x0005af15... (100 %)
Wrote 315680 bytes (169005 compressed) at 0x00010000 in 3.0 seconds (effective 851.8 kbit/s)...
Hash of data verified.

Leaving...
Hard resetting via RTS pin...

[maxmurugan]

// Select example to compile!
#define EXAMPLE_NUMBER 2
//#define EXAMPLE_NUMBER 2
//#define EXAMPLE_NUMBER 3
//#define EXAMPLE_NUMBER 4 // Custom Special Effects example!

/**

• Configuration of the LED matrix panels number and individual pixel resolution.
  **/
  #define PANEL_RES_X 80 // Number of pixels wide of each INDIVIDUAL panel module.
  #define PANEL_RES_Y 40 // Number of pixels tall of each INDIVIDUAL panel module.

#define VDISP_NUM_ROWS 1 // Number of rows of individual LED panels
#define VDISP_NUM_COLS 1 // Number of individual LED panels per row

#define PANEL_CHAIN_LEN (VDISP_NUM_ROWS*VDISP_NUM_COLS) // Don't change

use example 2
#define PANEL_SCAN_TYPE FOUR_SCAN_40_80PX_HFARCAN

mxconfig.i2sspeed = HUB75_I2S_CFG::HZ_10M;
mxconfig.clkphase = false;
mxconfig.driver = HUB75_I2S_CFG::DP3246_SM5368;

[maxmurugan]

mxconfig.i2sspeed = HUB75_I2S_CFG::HZ_10M;
mxconfig.clkphase = false;
//mxconfig.driver = HUB75_I2S_CFG::FM6126A;
mxconfig.line_decoder = HUB75_I2S_CFG::SM5368;

else if constexpr (ScanType == FOUR_SCAN_40_80PX_HFARCAN)
{
const int PANEL_WIDTH = 80;
const int PANEL_HEIGHT = 40;
const int ROWS_PER_SCAN = 10;
panel_pixel_base = 4;

int panel_local_x = coords.x % PANEL_WIDTH;

// Determine scan phase: alternates every 10 rows
int scanPhase = ((coords.y) / ROWS_PER_SCAN) % 2;

int group  = panel_local_x / panel_pixel_base;
int offset = panel_local_x % panel_pixel_base;

int physLocalX;
if (scanPhase == 0) {
    physLocalX = group * 8 + offset;
} else {
    physLocalX = group * 8 + offset + 4;
    if (physLocalX >= PANEL_WIDTH) physLocalX -= PANEL_WIDTH;
}

coords.x = (coords.x / PANEL_WIDTH) * PANEL_WIDTH + physLocalX;

// Remap Y to preserve line-by-line drawing
coords.y = (coords.y % ROWS_PER_SCAN) + ROWS_PER_SCAN * ((coords.y / (2 * ROWS_PER_SCAN)) % 2);

}

use this setting

0 to 9 -- showing correctly

10 to 19 -- draw 0 to 39 again draw 0 to 39

20 to 29 - ok

30 to 39 - same issue

[maxmurugan]

IMG_8997.1.mp4

[board707]

Hi @maxmurugan

To start fixing your issue we first need to put the library options in order, as described in #815.
I hope, @mrcodetastic will accept my PR.

[board707]

@maxmurugan
What is scan factor of the panel?

[maxmurugan]

scan -- 1/10

example code

/*

• @file VirtualMatrixPanel.ino
• @brief Example of using the VirtualMatrixPanel_T template class.
• The VirtualMatrixPanel_T class can be used for two purposes:
• 1. Create a much larger display out of a number of physical LED panels

•  chained in a Serpentine or Zig-Zag manner; 
  

• 2. Provide a way to deal with weird individual physical panels that do not have a

•  simple linear X, Y pixel mapping. For example, 1/4 scan panels, or outdoor panels.
  

• 1. and 2) can be combined and utilsied together.
• There are FOUR examples contained within this library. What example gets built depends
• on the value of the "#define EXAMPLE_NUMBER X" value. Where X = Example number.
• Example 1: STANDARD 1/2 Scan (i.e. 1/16, 1/32) LED matrix panels, 64x32 pixels each,

•           in a grid of 2x2 panels, chained in a Serpentine manner. 
  

• Example 2: Non-Standard 1/4 Scan (i.e. Four-Scan 1/8) outdoor LED matrix panels, 64x32 pixels each,

•           in a grid of 2x2 panels, chained in a Serpentine manner. 
  

• Example 3: A single non-standard 1/4 Scan (i.e. Four-Scan 1/8) outdoor LED matrix panel, 64x32 pixels.
• Example 4: Having your own panel pixel mapping logic of use only to a specific panel that isn't supported.

•           In this case we re-use this to map an individual pixel in a weird way.
  

*/

#include <Arduino.h>
#include <ESP32-HUB75-VirtualMatrixPanel_T.hpp>

// Select example to compile!
#define EXAMPLE_NUMBER 2
//#define EXAMPLE_NUMBER 2
//#define EXAMPLE_NUMBER 3
//#define EXAMPLE_NUMBER 4 // Custom Special Effects example!

/**

• Configuration of the LED matrix panels number and individual pixel resolution.
  **/
  #define PANEL_RES_X 80 // Number of pixels wide of each INDIVIDUAL panel module.
  #define PANEL_RES_Y 40 // Number of pixels tall of each INDIVIDUAL panel module.

#define VDISP_NUM_ROWS 1 // Number of rows of individual LED panels
#define VDISP_NUM_COLS 1 // Number of individual LED panels per row

#define PANEL_CHAIN_LEN (VDISP_NUM_ROWS*VDISP_NUM_COLS) // Don't change

/**

• Configuration of the approach used to chain all the individual panels together.
• Refer to the documentation or check the enum 'PANEL_CHAIN_TYPE' in VirtualMatrixPanel_T.hpp for options.
  **/
  #define PANEL_CHAIN_TYPE CHAIN_NONE

/**

• Optional config for the per-panel pixel mapping, for non-standard panels.
• i.e. 1/4 scan panels, or outdoor panels. They're a pain in the a-- and all

•  have their own weird pixel mapping that is not linear.
  

• This is used for Examples 2 and 3.

**/
#define PANEL_SCAN_TYPE FOUR_SCAN_40_80PX_HFARCAN

/**

• Mandatory declaration of the dma_display. DO NOT CHANGE
  **/
  MatrixPanel_I2S_DMA *dma_display = nullptr;

// ------------------------------------------------------------------------------------------------------------

/**

• Template instantiation for the VirtualMatrixPanel_T class, depending on use-case.
  **/
  #if EXAMPLE_NUMBER == 1

// --- Example 1: STANDARD 1/2 Scan ---

// Declare a pointer to the specific instantiation:
VirtualMatrixPanel_T<PANEL_CHAIN_TYPE>* virtualDisp = nullptr;

#endif

#if EXAMPLE_NUMBER == 2

// --- Example 2: Non-Standard 1/4 Scan (Four-Scan 1/8) ---

// Use an existing library user-contributed Scan Type pixel mapping
using MyScanTypeMapping = ScanTypeMapping<PANEL_SCAN_TYPE>;

// Create a pointer to the specific instantiation of the VirtualMatrixPanel_T class
VirtualMatrixPanel_T<PANEL_CHAIN_TYPE, MyScanTypeMapping>* virtualDisp = nullptr;

#endif

#if EXAMPLE_NUMBER == 3

// --- Example 3: Single non-standard 1/4 Scan (Four-Scan 1/8) ---

// Use an existing library user-contributed Scan Type pixel mapping
using MyScanTypeMapping = ScanTypeMapping<PANEL_SCAN_TYPE>;

// Create a pointer to the specific instantiation of the VirtualMatrixPanel_T class
VirtualMatrixPanel_T<CHAIN_NONE, MyScanTypeMapping>* virtualDisp = nullptr;

#endif

// Bonus non-existnat example. Create your own per-panel custom pixel mapping!
#if EXAMPLE_NUMBER == 4

// --- Custom Scan–Type Pixel Mapping ---
// This is not what you would use this for, but in any case it
// makes a flipped mirror image
struct CustomMirrorScanTypeMapping {

static VirtualCoords apply(VirtualCoords coords, int pixel_base) {

  // coords are the input coords for adjusting
  int width  = PANEL_RES_X;
  int height = PANEL_RES_Y; 

  // Flip / Mirror x 
  coords.x = PANEL_RES_X - coords.x - 1;   
  
  return coords;

}

};

// Create a pointer to the specific instantiation of the VirtualMatrixPanel_T class

VirtualMatrixPanel_T<CHAIN_NONE, CustomMirrorScanTypeMapping>* virtualDisp = nullptr;

#endif

// ------------------------------------------------------------------------------------------------------------

void setup()
{
Serial.begin(115200);
delay(2000);

/*

#define RL1 18
#define GL1 17
#define BL1 16
#define RL2 15
#define GL2 7
#define BL2 6
#define CH_A 4
#define CH_B 10
#define CH_C 14
#define CH_D 21
#define CH_E 5 // assign to any available pin if using two panels or 64x64 panels with 1/32 scan
#define CLK 47
#define LAT 48
#define OE  38

// HUB75_I2S_CFG::i2s_pins _pins={RL1, GL1, BL1, RL2, GL2, BL2, CH_A, CH_B, CH_C, CH_D, CH_E, LAT, OE, CLK};

*/
#define R1_PIN 2
#define G1_PIN 6
#define B1_PIN 10
#define R2_PIN 3
#define G2_PIN 7
#define B2_PIN 11
#define A_PIN 39
#define B_PIN 38
#define C_PIN 37
#define D_PIN 36
#define E_PIN 21 // required for 1/32 scan panels, like 64x64px. Any available pin would do, i.e. IO32
#define LAT_PIN 33
#define OE_PIN 35
#define CLK_PIN 34

HUB75_I2S_CFG::i2s_pins _pins={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};

#if EXAMPLE_NUMBER == 1
// A grid of normal (i.e. supported out of the box) 1/16, 1/32 (two scan) panels

 // Standard panel type natively supported by this library (Example 1, 4)
 HUB75_I2S_CFG mxconfig(
   PANEL_RES_X,   
   PANEL_RES_Y,  
   1
   , _pins
 );

#endif

#if EXAMPLE_NUMBER == 2
// A grid of 1/4 scan panels. This panel type is not supported 'out of the box' and require specific
// ScanTypeMapping (pixel mapping) within the panel itself.

 /**
  * HACK ALERT!
  * For 1/4 scan panels (namely outdoor panels), electrically the pixels are connected in a chain that is
  * twice the physical panel's pixel width, and half the pixel height. As such, we need to configure
  * the underlying DMA library to match the same. Then we use the VirtualMatrixPanel_T class to map the
  * physical pixels to the virtual pixels.
 */
 HUB75_I2S_CFG mxconfig(
   PANEL_RES_X*2,              // DO NOT CHANGE THIS
   PANEL_RES_Y/2,              // DO NOT CHANGE THIS
   1
   , _pins       
 );

#endif

#if EXAMPLE_NUMBER == 3
// A single 1/4 scan panel. This panel type is not supported 'out of the box' and require specific
// ScanTypeMapping (pixel mapping) within the panel itself.

 /**
  * HACK ALERT!
  * For 1/4 scan panels (namely outdoor panels), electrically the pixels are connected in a chain that is
  * twice the physical panel's pixel width, and half the pixel height. As such, we need to configure
  * the underlying DMA library to match the same. Then we use the VirtualMatrixPanel_T class to map the
  * physical pixels to the virtual pixels.
 */

HUB75_I2S_CFG mxconfig(
PANEL_RES_X*2, // DO NOT CHANGE THIS
PANEL_RES_Y/2, // DO NOT CHANGE THIS
1 // A Single panel
, _pins
);
#endif

#if EXAMPLE_NUMBER == 4
// A single normal scan panel, but we're using a custom CustomScanTypeMapping in the 'wrong'
// way to demonstrate how it can be used to create custom physical LED Matrix panel mapping.

// HUB75_I2S_CFG::i2s_pins _pins={RL1, GL1, BL1, RL2, GL2, BL2, CH_A, CH_B, CH_C, CH_D, CH_E, LAT, OE, CLK};
 // Standard panel type natively supported by this library (Example 1, 4)
 HUB75_I2S_CFG mxconfig(
   PANEL_RES_X,   
   PANEL_RES_Y,  
   1          
 //   , _pins
 );

#endif

mxconfig.i2sspeed = HUB75_I2S_CFG::HZ_10M;
mxconfig.clkphase = false;
//mxconfig.driver = HUB75_I2S_CFG::FM6126A;
mxconfig.line_decoder = HUB75_I2S_CFG::SM5368;

/**
* Setup physical DMA LED display output.
*/
dma_display = new MatrixPanel_I2S_DMA(mxconfig);
dma_display->begin();
dma_display->setBrightness8(128); //0-255
dma_display->clearScreen();

/**
* Setup the VirtualMatrixPanel_T class to map the virtual pixels to the physical pixels.
*/

#if EXAMPLE_NUMBER == 1
virtualDisp = new VirtualMatrixPanel_T<PANEL_CHAIN_TYPE>(VDISP_NUM_ROWS, VDISP_NUM_COLS, PANEL_RES_X, PANEL_RES_Y);
#elif EXAMPLE_NUMBER == 2
virtualDisp = new VirtualMatrixPanel_T<PANEL_CHAIN_TYPE, MyScanTypeMapping>(VDISP_NUM_ROWS, VDISP_NUM_COLS, PANEL_RES_X, PANEL_RES_Y);
#elif EXAMPLE_NUMBER == 3
virtualDisp = new VirtualMatrixPanel_T<CHAIN_NONE, MyScanTypeMapping>(1, 1, PANEL_RES_X, PANEL_RES_Y); // Single 1/4 scan panel
#elif EXAMPLE_NUMBER == 4
virtualDisp = new VirtualMatrixPanel_T<CHAIN_NONE, CustomMirrorScanTypeMapping>(1, 1, PANEL_RES_X, PANEL_RES_Y); // Single 1/4 scan panel
#endif

// Pass a reference to the DMA display to the VirtualMatrixPanel_T class
virtualDisp->setDisplay(*dma_display);

for (int y = 0; y < virtualDisp->height(); y++) {
for (int x = 0; x < virtualDisp->width(); x++) {

   uint16_t color = virtualDisp->color565(96, 0, 0); // red

   if (x == 0)   color = virtualDisp->color565(0, 255, 0); // g
   if (x == (virtualDisp->width()-1)) color = virtualDisp->color565(0, 0, 255); // b

   virtualDisp->drawPixel(x, y, color);
   delay(5);
 }

}

virtualDisp->drawLine(virtualDisp->width() - 1, virtualDisp->height() - 1, 0, 0, virtualDisp->color565(255, 255, 255));

virtualDisp->print("Virtual Matrix Panel");

delay(3000);
virtualDisp->clearScreen();
virtualDisp->drawDisplayTest(); // re draw text numbering on each screen to check connectivity

}

// ------------------------------------------------------------------------------------------------------------

void loop() {

// Do nothing here.

}

[maxmurugan]

IMG_9001.MOV

else if constexpr (ScanType == FOUR_SCAN_40_80PX_Maxmurugan)
{
const int PANEL_WIDTH = 80;
const int PANEL_HEIGHT = 40;
const int ROWS_PER_SCAN = 10;
panel_pixel_base = 4;

int panel_local_x = coords.x % PANEL_WIDTH;

// Determine scan phase: alternates every 10 rows
int scanPhase = ((coords.y) / ROWS_PER_SCAN) % 2;

int group  = panel_local_x / panel_pixel_base;
int offset = panel_local_x % panel_pixel_base;

int physLocalX;
if (scanPhase == 0) {
    physLocalX = group * 8 + offset;
} else {
    physLocalX = group * 8 + offset + 4;
   // if (physLocalX >= PANEL_WIDTH) physLocalX -= PANEL_WIDTH;
}

coords.x = (coords.x / PANEL_WIDTH) * PANEL_WIDTH + physLocalX;

// Remap Y to preserve line-by-line drawing
coords.y = (coords.y % ROWS_PER_SCAN) + ROWS_PER_SCAN * ((coords.y / (2 * ROWS_PER_SCAN)) % 2);

}

this working fine

please check this code

i am using new library
mxconfig.line_decoder = HUB75_I2S_CFG::SM5368;

how to increase refresh rate?

[board707]

please check this code

I think the code is correct because it works :) Do you experience any problem with it?

how to increase refresh rate?

Sorry, it is not my library.

[maxmurugan]

fine working

thanks sir

[maxmurugan]

I've been using this library for the past week, and I must say—it's incredibly colorful and amazing!
Thank you for making such a fantastic tool available.
A special thanks to MrCodetastic for your brilliant work and dedication!