wledPixel

ESP32 or ESP8266 and MAX7219 dot matrix display management

The latest firmware version can be found in Releases

Supported key features:

Home Assistant client [display sensor values]
OpenWeatherMap client [display: temperature (C/F), humidity, pressure, wind speed, weather icon]
MQTT client [each display zone support own topic]
Display controll through MQTT
Wall NTP clock [NTP sync clock]
Manual input
Full controll through web UI
Home Assistant MQTT discovery [When MQTT settings specified, device will be automatically send discovery message to HA]
Control display as light in Home Assistant [MQTT setup required]
Initial setup through wifi AP and web UI
Support 3 independent display zones
Support up to 12 display segments at the same time [configured in web UI]
Included 3 different fonts
Plus symbols font

Ingredients:

Dot matrix display MAX7219, something like this: https://aliexpress.com/item/32618155357.html
ESP32 or WeMos D1 Mini (ESP8266), something like this: https://aliexpress.com/item/32651747570.html

Web UI - Settings

Firmware compiled with next parameters:

ESP32

// Display pinout
#define DATA_PIN  23         // ESP32 GPIO23
#define CS_PIN    5          // ESP32 GPIO5
#define CLK_PIN   18         // ESP32 GPIO18

// Ds18b20 pinout
const int oneWireBus = 4;    // ESP32 GPIO04

ESP8266

// Display pinout
#define DATA_PIN  D7         // WeMos D1 mini or ESP8266 -> GPIO13
#define CS_PIN    D6         // WeMos D1 mini or ESP8266 -> GPIO12
#define CLK_PIN   D5         // WeMos D1 mini or ESP8266 -> GPIO14

// Ds18b20 pinout
const int oneWireBus = D4;   // WeMos D1 mini or ESP8266 -> GPIO02

Wiring

First boot:

Device will boot in wifi access point mode and write the wifi name and password on the display.

AP wifi name: wledPixel-[short MAC address]

AP wifi password: 12345678

Connect to this AP and configure your wifi settings (connect to your wifi network)

When the device connects to the WIFI network, the device's IP address will be displayed on the zone0

Open the browser and go to the device IP address

API

/api/temperature      - get measured temperature from connected ds18b20 sensor

Icons in Wled symbol font:

1 - "X"
2 - "stop"
3 - "rain"
4 - "ip:"
8 - "full light segment"
A - "calendar"
B - "windows"
C - "clouds"
D - "door"
E - "female"
F - "snowflake"
G - "key"
H - "male"
I - "alarm"
J - "clock"
K - "garbage"
L - "info"
M - "moon"
N - "message"
O - "reminder"
P - "wifi"
R - "huge rain"
S - "sun"
T - "thunderstorm"
c - "cloud"
f - "fog"
m - "cloud and moon"
r - "rain"
s - "sun and cloud"
° - "degree symbol"

MQTT topics:

devicePrefix/zoneN/workMode - zone work mode
devicePrefix/zoneN/scrolleffectIn - scroll effect IN
devicePrefix/zoneN/scrolleffectOut - scroll effect Out
devicePrefix/zoneN/scrollspeed - scroll speed
devicePrefix/zoneN/scrollpause - scroll pause
devicePrefix/zoneN/scrollalign - scroll alignment
devicePrefix/zoneN/charspacing - character spacing
devicePrefix/intensity - brightness
devicePrefix/zoneN/workMode - zone work mode
devicePrefix/power - display power control, support on / off values

where devicePrefix = wledPixel-A071 zoneN = zone number (e.g. Zone0)

Supported workMode:

workMode supported values:

mqttClient - MQTT client
manualInput - Manual static text inputed in UI
wallClock - NTP sync clock
owmWeather - Open Weather Map client
haClient - Home Assistant client

Wall clock

Wall clock mode support next following display options:

HH:MM - Hours : Minutes [21:43]
HH:MM:SS - Hours : Minutes : Seconds [21:43:54]
HH - Hours [21]
MM - Minutes [43]
dd.mm.yyyy - Day.Month.Year [21.06.2022]
dd.mm - Day.Month [21.06]
dd.mm aa - Day.Month weekday name (e.g., Sun) [21.06 Tue] *in Cyrillic font weekday name will be in Cyrillic
aa - Weekday name (e.g. Sun) *in Cyrillic font weekday name will be in Cyrillic

Scroll effect list

Default effects:

PA_RANDOM
PA_PRINT
PA_SCAN_HORIZ
PA_SCROLL_LEFT
PA_WIPE
PA_SCAN_VERTX
PA_SCROLL_UP_LEFT
PA_SCROLL_UP
PA_FADE
PA_OPENING_CURSOR
PA_GROW_UP
PA_SCROLL_UP_RIGHT
PA_BLINDS
PA_CLOSING
PA_GROW_DOWN
PA_SCAN_VERT
PA_SCROLL_DOWN_LEFT
PA_WIPE_CURSOR
PA_SCAN_HORIZX
PA_DISSOLVE
PA_MESH
PA_OPENING
PA_CLOSING_CURSOR
PA_SCROLL_DOWN_RIGHT
PA_SCROLL_RIGHT
PA_SLICE
PA_SCROLL_DOWN

Home Assistant automation example:

Send sensor value each time when a value has been changed

---
- alias: Outside temp change - send new temp to wled panel mqtt
  initial_state: 'on'
  trigger:
    platform: state
    entity_id: sensor.outside_thp_sensor_3
  action:
    - service: mqtt.publish
      data:
        topic: wledPixel-A071/zone0/text
        payload_template: "{{ states('sensor.outside_thp_sensor_3') }} C"

Change wledPixel-A071 to device name with your prefix

widapro / wledPixel

readme