Skip to content

mzashh/HUB75-Pixel-Art-Display

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 

Repository files navigation

HUB75 Pixel Art Display

A Wi-Fi-enabled LED Pixel Art Display based on HUB75E panels, powered by an ESP32.

Note: The colors are much more vibrant in person, and the flickering only appears on camera.


Changelog

Version 0.4.5a (Major Update)

  • Added an NTP Clock.
  • Added Scrolling Custom Text.
  • Clock and text colors can now be changed via the WebUI.
  • Text font and scroll speed are configurable.
  • Added toggles for:
    • GIF display
    • Clock
    • Scrolling text
  • Added a toggle for GIF looping.

Version 0.2.5a

  • Switched the file system to LittleFS.

Features

  • Wi-Fi Connectivity: On startup, the panel connects to the Wi-Fi network and displays the firmware version, IP address, RSSI, and Wi-Fi SSID for 4 seconds.
  • GIF Playback: Plays GIF files stored in the ESP32's SPI Flash.
  • NTP Clock: Displays the current time (configurable GMT and DST offsets in the firmware).
  • WebUI:
    • Upload, delete, download, and play GIF files.
    • Control brightness via a slider.
    • Authentication functionality for secure access.
    • Remote rebooting of the ESP32.
  • Custom Scrolling Text: Replace the clock with custom scrolling text.
  • WebUI Customization:
    • Change text and clock colors.
    • Adjust text scroll speed and size.
  • Playback Toggles:
    • Enable or disable GIF playback, clock, or scrolling text individually.
    • Toggle GIF looping to either loop a single GIF or play all stored GIFs sequentially.


Planned Features

These features are tentative and may not be implemented due to time constraints or motivation.

  • Proper date system
  • Weather display
  • Additional clock types and faces
  • Canvas drawing functionality
  • Stopwatch/Timer/Pomodoro modes

Hardware Requirements

Pin Configuration

Note: GPIO 34+ on the ESP32 are input-only. GPIO 5, 23, 18, and 19 are reserved for future SD card support.

Panel ESP32 GPIO Pin
R1 25
G1 26
B1 27
R2 14
G2 12
B2 13
A 22
B 32
C 33
D 17
E 21
OE 15
CLK 16
LAT 4

Firmware

Development Tools

  • Arduino IDE (v1.8.19) or PlatformIO.

Required Libraries

Configuration

  • Wi-Fi:
    • Change the Wi-Fi SSID and password in firmware.ino (only 2.4GHz networks are supported).
  • WebUI:
    • Update the WebUI username and password in firmware.ino.
  • Brightness:
    • Set the default brightness in firmware.ino (range: 0–255).
  • Panel Resolution:
  • Authentication:
    • Disable authentication by changing false to true on line 258 in webserver.ino.

Case and Assembly

For smooth assembly and answers to most questions, refer to the project documentation on my website.

  • 3D Printable Files for the Case and the Diffuser:
  • Project Documentation and Assembly:

Credits

About

A WIFI enabled LED Pixel Art Display based on HUB75 panels driven by the ESP32

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published