🚀 [Success] Huidu HD-WF2 (ESP32-S3) HUB75 Setup Guide for WLED-MM

[hirofairlane]

Hi everyone,

After many hours of trial and error, I’ve finally managed to get a stable WLED-MM setup on the Huidu HD-WF2 board (ESP32-S3).

I initially tried using the standard pre-compiled binaries, but they all resulted in immediate boot loops and filesystem corruption (Superblock 0x0 errors). For this specific board, all generic images I tried lead to a boot loop.

How I solved it
The breakthrough came from using the esp32S3_8MB_M environment as a base and applying some critical optimizations. That lead the board to a stable working status, with some warnings that haven't affected the performance.

Switching to flash_mode = dio: The standard QIO mode was too unstable when the HUB75 driver was active, leading to flash write failures.

Resource Optimization: Since this board lacks PSRAM, the system was running out of heap memory. By stripping down unused modules (Alexa, Loxone, etc.) and forcing WLED_MAX_SEGMENTS=1, the ESP32-S3 finally had enough "breathing room" to handle the 2D matrix effects.

My setup:
platformio_override.ini

[platformio]
default_envs = huidu_hd_wf2

[env:huidu_hd_wf2]
extends = esp32S3_8MB_M  ; Using this as our stable base
board_build.flash_mode = dio      ; Critical for stability on Huidu boards
board_build.f_flash = 80000000L

build_flags = 
  ${env:esp32S3_8MB_M.build_flags}
  -D WLED_RELEASE_NAME=HUIDU_HD_WF2
  -D WLED_ENABLE_2D
  -D WLED_MAX_SEGMENTS=1          ; Essential for boards without PSRAM
  -D WLED_DISABLE_ALEXA           ; Stripping down to free up RAM
  -D WLED_DISABLE_LOXONE
  ; --- HUIDU HD-WF2 ONBOARD PINS ---
  -D LEDPIN=4
  -D RLYPIN=21
  -D BTNPIN=48
  -D IRPIN=15
  -D HW_PIN_SDA=42
  -D HW_PIN_SCL=41

Flashing tip:
To flash this board, use a USB-A to USB-C cable connected to the USB-A female port on the Huidu board.
The board must be powered with 5V via the screw terminals while flashing.

[hirofairlane]

A couple of tweaks for better performace and stability.

[env:huidu_hd_wf2]
extends = esp32S3_8MB_M  ; Using this as our stable base
board_build.flash_mode = dio      ; Critical for stability on Huidu boards
board_build.f_flash = 80000000L
platform = espressif32@6.5.0
platform_packages = ${esp32.platformV4_packages}
board = esp32-s3-devkitc-1
build_unflags = 
  -D USERMOD_DALLASTEMPERATURE ;; disabled because it hangs during usermod setup on -S3 (autodetect broken?)
  -D USE_ALT_DISPLAY ;; four line display seems to have problems with I2C - it hangs during usermod setup
  -D USERMOD_FOUR_LINE_DISPLAY ;; see above
  -D USERMOD_ROTARY_ENCODER_UI ;; see above
  -D WLED_ENABLE_DMX 
build_flags = 
  ${env:esp32S3_8MB_M.build_flags}
  -D WLED_RELEASE_NAME=HUIDU_HD_WF2
  -D WLED_ENABLE_2D
  -D WLED_MAX_SEGMENTS=1          ; Saving as much PSRAM as possible, increase value in case needed
  -D WLED_DISABLE_ALEXA           ; Stripping down to free up RAM
  -D WLED_DISABLE_LOXONE
  ; --- HUIDU HD-WF2 ONBOARD PINS ---
  -D LEDPIN=4
  -D RLYPIN=21
  -D BTNPIN=48
  -D IRPIN=15
  -D HW_PIN_SDA=42
  -D HW_PIN_SCL=41
  -D WLED_DISABLE_AUDIO        ; Disabling audio as board does not implement mic
  -D WLED_DISABLE_SOUNDS       ; Disabling audio as board does not implement mic
  -D WLED_DISABLE_INFRARED     ; Disabling audio as board does not implement IR
  -D WLED_DISABLE_ADALIGHT     ; Stripping down to free up RAM