HUB75 LED MATRIX PANEL DMA Display/platforms/esp32s3/gdma_lcd_parallel16.cpp.o] Error 1

[captshadab]

hello

after the update of esphome 2025.11.0 i am continuously getting this error

.piolibdeps/bedroom1-wf2/ESP32 HUB75 LED MATRIX PANEL DMA Display/src/platforms/esp32s3/gdma_lcd_parallel16.cpp: In member function 'bool Bus_Parallel16::init()':
.piolibdeps/bedroom1-wf2/ESP32 HUB75 LED MATRIX PANEL DMA Display/src/platforms/esp32s3/gdma_lcd_parallel16.cpp:204:9: error: 'gpio_hal_iomux_func_sel' was not declared in this scope; did you mean 'gpio_hal_func_sel'?
  204 |         gpio_hal_iomux_func_sel(GPIO_PIN_MUX_REG[pins[i]], PIN_FUNC_GPIO);
      |         ^~~~~~~~~~~~~~~~~~~~~~~
      |         gpio_hal_func_sel
Compiling .pioenvs/bedroom1-wf2/managed_components/chmorgan__esp-libhelix-mp3/libhelix-mp3/real/polyphase.c.o
.piolibdeps/bedroom1-wf2/ESP32 HUB75 LED MATRIX PANEL DMA Display/src/platforms/esp32s3/gdma_lcd_parallel16.cpp:231:7: error: 'gpio_hal_iomux_func_sel' was not declared in this scope; did you mean 'gpio_hal_func_sel'?
  231 |       gpio_hal_iomux_func_sel(GPIO_PIN_MUX_REG[_cfg.pin_wr], PIN_FUNC_GPIO);
      |       ^~~~~~~~~~~~~~~~~~~~~~~
      |       gpio_hal_func_sel
.piolibdeps/bedroom1-wf2/ESP32 HUB75 LED MATRIX PANEL DMA Display/src/platforms/esp32s3/gdma_lcd_parallel16.cpp:254:21: warning: 'esp_err_t gdma_new_channel(const gdma_channel_alloc_config_t*, gdma_channel_t**)' is deprecated: please use gdma_new_ahb_channel or gdma_new_axi_channel respectively [-Wdeprecated-declarations]
  254 |     gdma_new_channel(&dma_chan_config, &dma_chan);
      |     ~~~~~~~~~~~~~~~~^~~~~~~~~~~~~~~~~~~~~~~~~~~~~
In file included from .piolibdeps/bedroom1-wf2/ESP32 HUB75 LED MATRIX PANEL DMA Display/src/platforms/esp32s3/gdma_lcd_parallel16.hpp:64,
                 from .piolibdeps/bedroom1-wf2/ESP32 HUB75 LED MATRIX PANEL DMA Display/src/platforms/esp32s3/gdma_lcd_parallel16.cpp:27:
/data/cache/platformio/packages/framework-espidf/components/esp_hw_support/dma/include/esp_private/gdma.h:481:11: note: declared here
  481 | esp_err_t gdma_new_channel(const gdma_channel_alloc_config_t *config, gdma_channel_handle_t *ret_chan)
      |           ^~~~~~~~~~~~~~~~
Compiling .pioenvs/bedroom1-wf2/managed_components/chmorgan__esp-libhelix-mp3/libhelix-mp3/real/scalfact.c.o
*** [.pioenvs/bedroom1-wf2/lib11a/ESP32 HUB75 LED MATRIX PANEL DMA Display/platforms/esp32s3/gdma_lcd_parallel16.cpp.o] Error 1
========================= [FAILED] Took 39.18 seconds =========================

[nevada750club]

HARDWARE: ESP32S3 240MHz, 320KB RAM, 8MB Flash

• contrib-piohome @ 3.4.4
• framework-arduinoespressif32 @ 3.3.2
• framework-arduinoespressif32-libs @ 5.5.0+sha.129cd0d247
• framework-espidf @ 3.50501.0 (5.5.1)
• tool-cmake @ 4.0.3
• tool-esp-rom-elfs @ 2024.10.11
• tool-esptoolpy @ 5.1.0
• tool-mklittlefs @ 3.2.0
• tool-ninja @ 1.13.1
• tool-scons @ 4.40801.0 (4.8.1)
• toolchain-xtensa-esp-elf @ 14.2.0+20241119
  Reading CMake configuration...
  Dependency Graph
  |-- Networking @ 3.3.2
  |-- ESPmDNS @ 3.3.2
  |-- Update @ 3.3.2
  |-- ArduinoJson @ 7.4.2
  |-- SPI @ 3.3.2
  |-- Wire @ 3.3.2
  |-- Adafruit BusIO @ 1.17.4
  |-- Adafruit GFX Library @ 1.12.4
  |-- ESP32 HUB75 LED MATRIX PANEL DMA Display @ 3.0.12+sha.533ffe9
  |-- noise-c @ 0.1.10
  Compiling .pioenvs/matrix64x32/src/main.cpp.o
  Compiling .pioenvs/matrix64x32/liba87/ESP32 HUB75 LED MATRIX PANEL DMA Display/platforms/esp32s3/gdma_lcd_parallel16.cpp.o
  .piolibdeps/matrix64x32/ESP32 HUB75 LED MATRIX PANEL DMA Display/src/platforms/esp32s3/gdma_lcd_parallel16.cpp:21:19: note: '#pragma message: Compiling for ESP32-S3'
  21 | #pragma message "Compiling for ESP32-S3"
  | ^~~~~~~~~~~~~~~~~~~~~~~~
  .piolibdeps/matrix64x32/ESP32 HUB75 LED MATRIX PANEL DMA Display/src/platforms/esp32s3/gdma_lcd_parallel16.cpp: In member function 'bool Bus_Parallel16::init()':
  .piolibdeps/matrix64x32/ESP32 HUB75 LED MATRIX PANEL DMA Display/src/platforms/esp32s3/gdma_lcd_parallel16.cpp:204:9: error: 'gpio_hal_iomux_func_sel' was not declared in this scope; did you mean 'gpio_hal_func_sel'?
  204 | gpio_hal_iomux_func_sel(GPIO_PIN_MUX_REG[pins[i]], PIN_FUNC_GPIO);
  | ^~~~~~~~~~~~~~~~~~~~~~~
  | gpio_hal_func_sel
  .piolibdeps/matrix64x32/ESP32 HUB75 LED MATRIX PANEL DMA Display/src/platforms/esp32s3/gdma_lcd_parallel16.cpp:231:7: error: 'gpio_hal_iomux_func_sel' was not declared in this scope; did you mean 'gpio_hal_func_sel'?
  231 | gpio_hal_iomux_func_sel(GPIO_PIN_MUX_REG[_cfg.pin_wr], PIN_FUNC_GPIO);
  | ^~~~~~~~~~~~~~~~~~~~~~~
  | gpio_hal_func_sel
  .piolibdeps/matrix64x32/ESP32 HUB75 LED MATRIX PANEL DMA Display/src/platforms/esp32s3/gdma_lcd_parallel16.cpp:254:21: warning: 'esp_err_t gdma_new_channel(const gdma_channel_alloc_config_t*, gdma_channel_t**)' is deprecated: please use gdma_new_ahb_channel or gdma_new_axi_channel respectively [-Wdeprecated-declarations]
  254 | gdma_new_channel(&dma_chan_config, &dma_chan);
  | ~~~~~~~~~~~~~~~~^~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  In file included from .piolibdeps/matrix64x32/ESP32 HUB75 LED MATRIX PANEL DMA Display/src/platforms/esp32s3/gdma_lcd_parallel16.hpp:64,
  from .piolibdeps/matrix64x32/ESP32 HUB75 LED MATRIX PANEL DMA Display/src/platforms/esp32s3/gdma_lcd_parallel16.cpp:27:
  /data/cache/platformio/packages/framework-espidf/components/esp_hw_support/dma/include/esp_private/gdma.h:481:11: note: declared here
  481 | esp_err_t gdma_new_channel(const gdma_channel_alloc_config_t *config, gdma_channel_handle_t *ret_chan)
  | ^~~~~~~~~~~~~~~~
  *** [.pioenvs/matrix64x32/liba87/ESP32 HUB75 LED MATRIX PANEL DMA Display/platforms/esp32s3/gdma_lcd_parallel16.cpp.o] Error 1
  ========================= [FAILED] Took 46.75 seconds =========================

[Jason2866]

esphome needs to update the used version. Actual HUB75 LED MATRIX PANEL DMA has this fixed since 36edef5

[nevada750club]

Same error after update ESPHome Builder to 2025.11.1.
I'm stuck with development.
Any ideas on how to work around this problem?

[captshadab]

Same error after update esphome to 2025.11.1.
I'm stuck with development.
Any ideas on how to work around this problem?

To get around I am using esphome 2025.10

Install the esphome legacy addon in home assistant

[nevada750club]

Thanks so much for the suggestion.
I installed version 2025.10 and it compiles fine.
I didn't know this very useful addon existed.
Thanks again.

[captshadab]

Thanks so much for the suggestion.
I installed version 2025.10 and it compiles fine.
I didn't know this very useful addon existed.
Thanks again.

No problem
I will try and fork this with modifications and once it works will share the link

May be in a week's time

Till then you can use older versions of epshome

[sudheerbussa]

For Arduino framework, For ESP32S3, should I use previous version of ESP32 library? Facing Restart when attempting to begin() display.

[mrcodetastic]

I'll have to take a look at this.

I think there's been changes to the IDF that have broken the library on the S3

Use a older version

[paulmro]

any example on how to use this in esphome , i didn't managed after 6h chatting with all the possible ai chatbots :(

[captshadab]

any example on how to use this in esphome , i didn't managed after 6h chatting with all the possible ai chatbots :(

Most simplest solution is to use esphome 2025.10

[paulmro]

I have tried with the legacy 2025.10 but with no luck , if someone can give an example of what they are using in the yaml that will be great.

[captshadab]

I have tried with the legacy 2025.10 but with no luck , if someone can give an example of what they are using in the yaml that will be great.

here is my yaml. works fine with espome 2025.10.0 and earlier

https://pastebin.com/3D4z8yYP

[nevada750club]

I use 2025.9 and it work fine, with 2025.10 I still have problems.

[rgot-org]

I encountered the same issue with Arduino ESP32 v3.3.5. Compilation worked correctly with version 3.2.1. This is due to the fact that version 3.3.5 uses ESP-IDF 5.5.1, while version 3.2.1 uses ESP-IDF 5.4.2, and there were changes between the two versions.
I modified the following file: ESP32_HUB75_LED_MATRIX_PANEL_DMA_Display/src/platforms/esp32s3/gdma_lcd_parallel16.cpp in the following way:
at line 198:

#if ESP_IDF_VERSION >= ESP_IDF_VERSION_VAL(5, 5, 0)
        gpio_ll_func_sel(&GPIO, pins[i], PIN_FUNC_GPIO);
#else
        gpio_hal_iomux_func_sel(GPIO_PIN_MUX_REG[pins[i]], PIN_FUNC_GPIO);
#endif

and around line 230:

#if ESP_IDF_VERSION >= ESP_IDF_VERSION_VAL(5, 5, 0)
      gpio_ll_func_sel(&GPIO, _cfg.pin_wr, PIN_FUNC_GPIO);
#else
      gpio_hal_iomux_func_sel(GPIO_PIN_MUX_REG[_cfg.pin_wr], PIN_FUNC_GPIO);
#endif

and now it works for esp32-S3 !
I have not tested this with other processors, but the principle should be the same for the other ESP32 variants located in the “platforms” folder.