Arduino Matrix Portal ESP32-s3 support added by haeberle · Pull Request #127 · PPUC/ZeDMD

haeberle · 2026-03-09T17:23:18Z

Summary

Add support for the Adafruit Matrix Portal ESP32-S3 board.

Changes

Added configuration for the Adafruit Matrix Portal ESP32-S3 board
Integrated board definitions and settings required for building and running on this hardware
Ensured compatibility with the existing build configuration

Motivation

This allows the project to run on the Adafruit Matrix Portal ESP32-S3, enabling users to use this board with the existing functionality.

Testing

Built the project targeting the Adafruit Matrix Portal ESP32-S3
Verified that the firmware compiles successfully

Notes

During testing, filesystem uploads to ESP32 repeatedly failed with the default partitions configuration. Decreasing the partitions size to 6 MB resolved the issue.

If maintainers prefer a different naming convention or configuration structure for new boards, I am happy to adjust the implementation.

mkalkbrenner

format the code with clang

mkalkbrenner · 2026-03-11T14:19:39Z

src/transports/usb_transport.cpp

 #else
  Serial.setRxBufferSize(usbPackageSize + 128);
-  Serial.setTxBufferSize(64);
+  Serial.setRxBufferSize(64);


Don't overwrite the previous line

Changed, pls. review

mkalkbrenner · 2026-03-11T14:20:49Z

src/transports/wifi_transport.cpp

  GetDisplayDriver()->DisplayText("zedmd-wifi.local", 0, TOTAL_HEIGHT - 5, 0, 0,
                                  0, true);
-
+  Serial.print("Start webserver ");


Don't print debug messages over the serial interface.
Same for following Serial.print commands.

Removed, followings too

mkalkbrenner · 2026-03-11T14:22:17Z

src/main.cpp

  return 0;
 }

+void PrintFileSystem(fs::FS &fs, const char * dirname, uint8_t depth) {


remove that function.

mkalkbrenner · 2026-03-11T14:23:26Z

platformio.ini

+;debug_tool = esp-builtin
+;debug_init_break = tbreak setup
+;build_type = debug
+monitor_port = COM8


mkalkbrenner · 2026-03-11T14:23:35Z

platformio.ini

+;debug_init_break = tbreak setup
+;build_type = debug
+monitor_port = COM8
+upload_port = COM9


mkalkbrenner · 2026-03-11T14:23:43Z

platformio.ini

+;build_type = debug
+monitor_port = COM8
+upload_port = COM9
+monitor_speed = 115200


mkalkbrenner · 2026-03-11T14:25:02Z

platformio.ini

+    -DDISPLAY_LED_MATRIX=1
+    -DARDUINO_ADAFRUIT_MATRIXPORTAL_ESP32S3=1
+    -DPIXEL_COLOR_DEPTH_BITS=8
+    -DZEDMD_WIFI_ONLY=1


Is it really WiFi only? Why is USB not supported?

wrong setting, USB support is now included.

mkalkbrenner

Thanks for your work on this. We are close.

mkalkbrenner · 2026-03-13T17:39:46Z

platformio.ini


 [platformio]
-default_envs = S3-N16R8_128x32
+default_envs = MatrixPortalS3_128x32


Don't change the default

mkalkbrenner · 2026-03-13T17:41:15Z

platformio.ini

 framework = arduino
-platform = https://github.com/pioarduino/platform-espressif32/releases/download/stable/platform-espressif32.zip
+;platform = https://github.com/pioarduino/platform-espressif32/releases/download/stable/platform-espressif32.zip
+platform = https://github.com/pioarduino/platform-espressif32/releases/download/55.03.37/platform-espressif32.zip


Is that really required?
We build on github and it doesn't cache, so stable will always pull the latest stable.

mkalkbrenner · 2026-03-13T17:42:14Z

src/main.cpp

 #ifdef BOARD_HAS_PSRAM
    buffers[i] = (uint8_t *)heap_caps_malloc(
        BUFFER_SIZE, MALLOC_CAP_SPIRAM | MALLOC_CAP_32BIT);
+


mkalkbrenner · 2026-03-13T17:42:19Z

src/main.cpp

 #endif

  pinMode(FORWARD_BUTTON_PIN, INPUT_PULLUP);
+


mkalkbrenner · 2026-03-13T17:42:58Z

src/transports/wifi_transport.cpp


  // Serve index.html
  server->on("/", HTTP_GET, [](AsyncWebServerRequest* request) {
+


mkalkbrenner · 2026-03-13T17:43:26Z

src/displays/Esp32LedMatrix.cpp

 #if defined(DISPLAY_LED_MATRIX) && defined(ESP_BUILD)

 #include "Esp32LedMatrix.h"
+#include <HardwareSerial.h>


I think that this include could be removed.

mkalkbrenner · 2026-03-16T09:49:23Z

#131 seems to achieve the same with less code changes. Actually, the only real change beside using a different pinout is to deactivate Serial.setTxBufferSize(64);.
@haeberle can you test the version of the other PR?
From my maintainer perspective, the other PR better fits in our existing system.

Arduino Matrix Portal ESP32-s3 support added

6e85b1b

haeberle closed this Mar 9, 2026

haeberle reopened this Mar 9, 2026

haeberle closed this Mar 9, 2026

haeberle deleted the ADAFRUIT_MATRIXPORTAL_ESP32S3 branch March 9, 2026 17:30

haeberle restored the ADAFRUIT_MATRIXPORTAL_ESP32S3 branch March 9, 2026 19:06

haeberle reopened this Mar 9, 2026

mkalkbrenner requested changes Mar 11, 2026

View reviewed changes

Changes due to review feedback

b349295

mkalkbrenner requested changes Mar 13, 2026

View reviewed changes

tbnobody mentioned this pull request Mar 14, 2026

Add support for the Adafruit Matrix Portal ESP32-S3 board. #131

Open


		// Serve index.html
		server->on("/", HTTP_GET, [](AsyncWebServerRequest* request) {

Conversation

haeberle commented Mar 9, 2026

Uh oh!

mkalkbrenner left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

mkalkbrenner left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

mkalkbrenner commented Mar 16, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants