Build it step by step
0 of 8 doneWire one module first
Test it with the library's example.
Chain four modules
Connect OUT to IN along the row.
Fix the orientation
Change the hardware type until text reads correctly.
Fill in your Wi-Fi
Replace the placeholders.
Upload
Note the IP address on the serial monitor, or from your router.
Send a message
Open the address on a phone and send one.
Watch it scroll
The newest message appears next.
Mount it
Fix it in the kitchen away from steam.
How do you build a family message board?
A MAX7219 matrix in the kitchen scrolls messages that family members send from their phones. You need Wemos D1 Mini ESP8266, MAX7219 8x8 LED matrix module × 4 and 5 V 2 A USB adapter. It takes 8 steps and about 90 minutes.
- Level
- Beginner
- Time
- About 90 min
- Parts
- 3
Parts list
Tick what you already own. It saves to My Garage, so “Build with what I have” knows.
Wiring
| From | To | Why |
|---|---|---|
| Matrix module VCC | D1 mini 5V | Power |
| Matrix module GND | D1 mini GND | Ground |
| Matrix module DIN | D1 mini D7 | SPI data |
| Matrix module CLK | D1 mini D5 | SPI clock |
| Matrix module CS | D1 mini D8 | Chip select |
| Module 1 OUT to module 2 IN, and so on | Chain of four modules | DIN, CLK, CS, VCC and GND pass along |
| 5 V adapter | D1 mini USB or 5V pin | Power for everything |
Code
Chain the four modules from the input end: the first module's DIN, CLK and CS connect to the D1 mini and each OUT side goes to the next IN side. The page at the board's address on your network posts a message, which is cleaned to plain characters and limited to 60 so it cannot break the display. Anyone on your Wi-Fi who knows the address can post, so do not share the network with strangers, and fill in the Wi-Fi placeholders yourself and keep them out of shared code. If the text is mirrored or in the wrong order, change the hardware type (FC16_HW, GENERIC_HW or PAROLA_HW) to match your modules. The board shows the time between messages, using internet time. Arduino IDE with the ESP8266 boards package, board "LOLIN(WEMOS) D1 mini".
Runs on a virtual Wemos D1 mini in your browser, with sliders for the sensors. Happy with it? Verify and upload to your real board from the same page (Chrome or Edge on a computer).
// Libraries: MD_Parola and MD_MAX72XX (by MajicDesigns). Board: D1 mini.
#include <ESP8266WiFi.h>
#include <ESP8266WebServer.h>
#include <MD_Parola.h>
#include <MD_MAX72xx.h>
#include <SPI.h>
#include <time.h>
const char* WIFI_SSID = "YOUR_WIFI_NAME";
const char* WIFI_PASS = "YOUR_WIFI_PASSWORD";
MD_Parola disp = MD_Parola(MD_MAX72XX::FC16_HW, D8, 4); // change FC16_HW if the text is flipped
ESP8266WebServer server(80);
String msgs[5] = {"Hello family", "", "", "", ""};
int count = 1, shown = 0;
char buf[64];
String clean(String s) { // keep printable ASCII only, limit the length
String out = "";
for (unsigned i = 0; i < s.length() && out.length() < 60; i++) if (s[i] >= 32 && s[i] < 127) out += s[i];
return out;
}
void handleRoot() {
String page = "<html><body style='font-family:sans-serif'><h3>Kitchen board</h3>"
"<form method='POST' action='/msg'><input name='m' maxlength='60' size='30'>"
"<input type='submit' value='Send'></form></body></html>";
server.send(200, "text/html", page);
}
void handleMsg() {
String m = clean(server.arg("m"));
if (m.length()) {
for (int i = 4; i > 0; i--) msgs[i] = msgs[i - 1]; // keep the last five messages
msgs[0] = m;
if (count < 5) count++;
shown = 0;
}
server.sendHeader("Location", "/");
server.send(303);
}
void setup() {
disp.begin();
disp.setIntensity(3);
WiFi.begin(WIFI_SSID, WIFI_PASS);
while (WiFi.status() != WL_CONNECTED) delay(300);
configTime(19800, 0, "pool.ntp.org"); // India time, change for yours
server.on("/", handleRoot);
server.on("/msg", HTTP_POST, handleMsg);
server.begin();
msgs[0].toCharArray(buf, sizeof(buf));
disp.displayText(buf, PA_LEFT, 40, 1000, PA_SCROLL_LEFT, PA_SCROLL_LEFT);
}
void loop() {
server.handleClient();
if (disp.displayAnimate()) { // finished a message
static bool showTime = false;
showTime = !showTime;
if (showTime) {
time_t t = time(nullptr); struct tm* tm = localtime(&t);
snprintf(buf, sizeof(buf), "%02d:%02d", tm->tm_hour, tm->tm_min);
disp.displayText(buf, PA_CENTER, 40, 3000, PA_PRINT, PA_NO_EFFECT);
} else {
shown = (shown + 1) % count;
msgs[shown].toCharArray(buf, sizeof(buf));
disp.displayText(buf, PA_LEFT, 40, 1000, PA_SCROLL_LEFT, PA_SCROLL_LEFT);
}
}
}Test checklist
What you should see at each check. If a reading is far off, stop and use the troubleshooting list.
| Check | Expected |
|---|---|
| Power on | Hello family scrolls |
| Phone message | Appears within one cycle |
| Between messages | Time shows |
| Six messages sent | Only the last five are kept |
If it does not work
Text is mirrored
Change the hardware type.
Page does not load
Check the IP address and that the phone is on the same network.
Garbled letters
Check the chain order and the 5 V supply.
Resets
Use a 5 V 1 A supply.
Still stuck? Find the fault step by step with your multimeter →
Common questions
What parts do I need for the family message board?
Wemos D1 Mini ESP8266, MAX7219 8x8 LED matrix module × 4 and 5 V 2 A USB adapter.
How long does the family message board take to build?
About 90 minutes for a beginner maker, in 8 steps.
How do I know the family message board works?
Power on: Hello family scrolls. Phone message: Appears within one cycle. Between messages: Time shows.
Text is mirrored: what should I check?
Change the hardware type.
Page does not load: what should I check?
Check the IP address and that the phone is on the same network.
Garbled letters: what should I check?
Check the chain order and the 5 V supply.
Resets: what should I check?
Use a 5 V 1 A supply.
