Arduino-aftelklok: nieuwjaarsklok met ESP32 en MAX7219
Bouw een Arduino-aftelklok: ESP32 NTP-tijd op een MAX7219 8x32-matrix toont dagen, uren en minuten, en om middernacht een scrolltekst en een melodie. Ook als Uno + RTC.
Een Arduino-aftelklok laat in dagen, uren, minuten en seconden zien hoeveel tijd er nog is tot een doelmoment (middernacht met nieuwjaar, een verjaardag, een examendag), en het is een van de leukste seizoensprojecten voor makers. In deze gids koppel je een ESP32 via Wi-Fi aan NTP-servers om de tijd op de seconde nauwkeurig van het internet te halen, en toon je de resterende tijd op een MAX7219 8x32-ledmatrix die uit vier modules bestaat. Als de klok 00:00 bereikt, scrolt "Happy New Year" over het scherm en speelt een passieve buzzer een melodie.
Zit je ergens zonder internet, of heb je alleen een Arduino Uno? Dan bouwen we hetzelfde project met een RTC-module (real-time clock). Aan het eind vind je ook een MicroPython-versie voor de Raspberry Pi Pico W en tips om de timer aan te passen aan andere data dan nieuwjaar. De code is klaar: verander alleen de naam van je wifi-netwerk, je wachtwoord en de doeldatum en upload hem dan. We leggen ook uit wat elke regel doet, zodat je je eigen timer kunt ontwerpen.

Hoe werkt een aftelklok?
Een aftelling is eigenlijk één aftrekking: resterende tijd = doeltijd − huidige tijd. Computers slaan tijd meestal op als Unix-timestamp (epoch), het aantal seconden sinds 1 januari 1970. Zodra je het doelmoment naar hetzelfde formaat omzet, trek je de twee getallen van elkaar af, krijg je het resultaat in seconden en splits je dat in dagen, uren, minuten en seconden. Om 18:30 op 27 december zijn er bijvoorbeeld 365.400 seconden tot nieuwjaar, dat is 4 dagen 5 uur 30 minuten. De echte uitdaging is niet de wiskunde, maar de huidige tijd nauwkeurig kennen: de millis()-teller van de Arduino begint bij elke herstart opnieuw, en door de keramische resonator op de Uno kan hij per dag minuten afwijken. Daarom halen we de tijd van het internet (NTP) of van een RTC-chip met batterij.
| Stap | Berekening | Voorbeeld (365400 s) |
|---|---|---|
| Dagen | remaining / 86400 | 4 |
| Uren | (remaining % 86400) / 3600 | 5 |
| Minuten | (remaining % 3600) / 60 | 30 |
| Seconden | remaining % 60 | 0 |
Onderdelenlijst
| Onderdeel | Functie | Opmerking |
|---|---|---|
| ESP32-developmentboard | Haalt NTP-tijd op via Wi-Fi, berekent de resterende tijd en stuurt het display aan | De Uno-versie gebruikt in plaats daarvan een Arduino Uno + RTC |
| MAX7219 8x32 dotmatrix (FC16-type) | Toont de resterende tijd en de scrolltekst | Wordt geleverd met 4 vooraf doorgekoppelde 8x8-matrices |
| Passieve buzzer | Speelt de melodie van middernacht | Een actieve buzzer kan geen melodie spelen, alleen een vaste pieptoon |
| DS1307- of DS3231-RTC-module | Houdt de tijd bij in de offlineversie | De knoopcel houdt de tijd bij, ook als de stroom wegvalt |
| 5 V 2 A-adapter (aanbevolen) | Voedt de matrix | Bij lage helderheid is voeding via USB genoeg |
| Jumperdraden en breadboard | Aansluitingen | Female-naar-male-draden zijn handig voor de pins van de module |
Bedradingsschema: MAX7219, buzzer en RTC
| Aansluiting | Arduino Uno | ESP32 | Pico W |
|---|---|---|---|
| MAX7219 VCC | 5V | 5V (VIN) | VBUS (5 V) |
| MAX7219 GND | GND | GND | GND |
| MAX7219 DIN | D11 (MOSI) | GPIO 23 | GP19 |
| MAX7219 CS | D10 | GPIO 5 | GP17 |
| MAX7219 CLK | D13 (SCK) | GPIO 18 | GP18 |
| Passieve buzzer (+) | D6 | GPIO 25 | GP15 |
| Passieve buzzer (−) | GND | GND | GND |
| RTC SDA / SCL | A4 / A5 | Niet nodig (NTP) | Niet nodig (NTP) |
De ESP32 en de Pico gebruiken 3,3V-logica. Volgens de datasheet van de MAX7219 heeft de ingang bij 5 V voeding minstens 3,5 V nodig om als logisch hoog te tellen; 3,3 V zit daar net onder, maar in de praktijk werken de meeste modules zonder problemen. Zie je willekeurige puntjes, flikkering of een vastlopend scherm, kort dan de draden in en voeg een niveauconverter toe op de lijnen DIN, CLK en CS. Ook de interne bedrading van modules in de handel verschilt: als de tekst omgekeerd, gespiegeld of elke letter 90 graden gedraaid is, probeer dan in de code FC16_HW te vervangen door PAROLA_HW, GENERIC_HW of ICSTATION_HW. Hoe de chip werkt, leggen we uitgebreid uit in het artikel MAX7219-ledmatrix.
De bibliotheken installeren
- Open in de Arduino IDE de Library Manager, zoek naar MD_Parola en installeer de bibliotheek van MajicDesigns; MD_MAX72XX wordt als afhankelijkheid mee geïnstalleerd, en zo niet, installeer hem dan apart.
- Installeer voor de versie met Uno + RTC de bibliotheek RTClib van Adafruit; accepteer als daarom wordt gevraagd ook de afhankelijkheid Adafruit BusIO.
- Installeer voor de ESP32 het pakket esp32 van Espressif via de Boards Manager; de Wi-Fi- en NTP-functies zitten in dit pakket, dus je hebt geen extra bibliotheek nodig. Details over de installatie staan in Wat is de ESP32?.
- Open eerst het voorbeeld Parola_HelloWorld in MD_Parola en stel de CS-pin en het hardwaretype in; zie je een nette "Hello" op het scherm, dan kloppen je bedrading en het type module.
Aftelcode met ESP32 NTP-tijd
De onderstaande code verbindt de ESP32 met je wifi-netwerk, haalt met configTzTime() de tijd op van een NTP-server en stelt de Turkse tijdzone (UTC+3) in. Daarna berekent hij het volgende nieuwjaar en schrijft hij bij elke lus de resterende tijd naar het display. Zolang het aantal dagen boven nul is, wisselt het display elke drie seconden tussen "4g" (dagen) en "05:30" (uren:minuten); op de laatste dag toont het uren:minuten, in het laatste uur minuten:seconden en in de laatste 10 seconden één cijfer. Als het doel is bereikt, spelen 60 seconden lang een scrolltekst en een melodie, waarna de timer automatisch overschakelt naar het doel van volgend jaar.
1#include <WiFi.h>
2#include <time.h>
3#include <SPI.h>
4#include <MD_Parola.h>
5#include <MD_MAX72xx.h>
6
7#define HARDWARE_TYPE MD_MAX72XX::FC16_HW // modül tipi / module type
8#define MAX_DEVICES 4 // 4 adet 8x8 = 8x32 / 4 x 8x8 = 8x32
9#define CS_PIN 5 // DIN=GPIO23, CLK=GPIO18
10#define BUZZER_PIN 25 // pasif buzzer / passive buzzer
11
12const char* WIFI_SSID = "WIFI_ADIN"; // Wi-Fi adın / your Wi-Fi name
13const char* WIFI_PASS = "WIFI_SIFREN"; // Wi-Fi şifren / your Wi-Fi password
14const char* TZ_INFO = "TRT-3"; // Türkiye UTC+3 / Turkey UTC+3
15
16const int TARGET_MONTH = 1; // hedef ay / target month
17const int TARGET_DAY = 1; // hedef gün / target day
18const int TARGET_HOUR = 0; // hedef saat / target hour
19const char* MESSAGE = "Mutlu Yillar"; // kutlama yazısı / celebration text
20const long CELEBRATE_SEC = 60; // kutlama süresi (s) / celebration length (s)
21
22MD_Parola P = MD_Parola(HARDWARE_TYPE, CS_PIN, MAX_DEVICES);
23
24// Jingle Bells nakaratı (Hz, ms) / Jingle Bells chorus (Hz, ms)
25const int notes[] = {659, 659, 659, 659, 659, 659, 659, 784, 523, 587, 659,
26 698, 698, 698, 698, 698, 659, 659, 659, 659,
27 659, 587, 587, 659, 587, 784};
28const int durs[] = {250, 250, 500, 250, 250, 500, 250, 250, 375, 125, 1000,
29 250, 250, 375, 125, 250, 250, 250, 125, 125,
30 250, 250, 250, 250, 500, 500};
31const int NOTE_COUNT = sizeof(notes) / sizeof(notes[0]);
32
33time_t target = 0;
34bool celebrating = false;
35char text[16];
36char lastText[16] = "";
37char msg[40];
38
39int noteIndex = 0;
40unsigned long lastNoteMs = 0;
41unsigned long waitMs = 0;
42bool melodyOn = false;
43
44time_t makeTarget(int year) {
45 struct tm t = {};
46 t.tm_year = year - 1900;
47 t.tm_mon = TARGET_MONTH - 1;
48 t.tm_mday = TARGET_DAY;
49 t.tm_hour = TARGET_HOUR;
50 t.tm_isdst = -1; // yaz saatini sistem belirlesin / let the system decide DST
51 return mktime(&t); // yerel saat -> epoch / local time -> epoch
52}
53
54void chooseTarget() {
55 time_t now = time(nullptr);
56 struct tm n;
57 localtime_r(&now, &n);
58 int year = n.tm_year + 1900;
59 target = makeTarget(year);
60 if (now - target >= CELEBRATE_SEC) target = makeTarget(year + 1); // bu yılki geçti / this year's has passed
61}
62
63void showText(const char* t) {
64 if (strcmp(t, lastText) != 0) { // yalnız değişince yaz / write only on change
65 strncpy(lastText, t, sizeof(lastText) - 1);
66 lastText[sizeof(lastText) - 1] = '\0';
67 P.print(lastText);
68 }
69}
70
71void startCelebration() {
72 celebrating = true;
73 time_t now = time(nullptr);
74 struct tm n;
75 localtime_r(&now, &n);
76 snprintf(msg, sizeof(msg), "%s %d", MESSAGE, n.tm_year + 1900);
77 P.displayClear();
78 P.displayText(msg, PA_CENTER, 40, 500, PA_SCROLL_LEFT, PA_SCROLL_LEFT);
79 noteIndex = 0;
80 waitMs = 0;
81 lastNoteMs = millis();
82 melodyOn = true;
83}
84
85void playMelody() {
86 if (!melodyOn || millis() - lastNoteMs < waitMs) return;
87 if (noteIndex >= NOTE_COUNT) { // melodi bitti / melody finished
88 melodyOn = false;
89 noTone(BUZZER_PIN);
90 return;
91 }
92 tone(BUZZER_PIN, notes[noteIndex], durs[noteIndex] * 9 / 10); // %90 çal, %10 sus / play 90%, rest 10%
93 lastNoteMs = millis();
94 waitMs = durs[noteIndex];
95 noteIndex++;
96}
97
98void setup() {
99 P.begin();
100 P.setIntensity(2); // parlaklık 0-15 / brightness 0-15
101 P.setTextAlignment(PA_CENTER);
102 P.print("WiFi");
103
104 WiFi.mode(WIFI_STA);
105 WiFi.begin(WIFI_SSID, WIFI_PASS);
106 while (WiFi.status() != WL_CONNECTED) delay(300);
107
108 P.print("NTP");
109 configTzTime(TZ_INFO, "pool.ntp.org", "time.google.com");
110 struct tm ti;
111 while (!getLocalTime(&ti, 5000)) {} // saat gelene kadar bekle / wait for the time
112 chooseTarget();
113}
114
115void loop() {
116 time_t now = time(nullptr);
117 long remaining = (long)(target - now);
118
119 if (remaining <= 0) {
120 if (remaining > -CELEBRATE_SEC) { // kutlama anı / celebration time
121 if (!celebrating) startCelebration();
122 if (P.displayAnimate()) P.displayReset(); // yazıyı sürekli kaydır / keep scrolling
123 playMelody();
124 return;
125 }
126 celebrating = false; // kutlama bitti / celebration over
127 noTone(BUZZER_PIN);
128 chooseTarget(); // sonraki yıla kur / set for next year
129 lastText[0] = '\0';
130 P.displayClear();
131 return;
132 }
133
134 long d = remaining / 86400;
135 long h = (remaining % 86400) / 3600;
136 long m = (remaining % 3600) / 60;
137 long s = remaining % 60;
138
139 if (d > 0) {
140 if ((now / 3) % 2 == 0) snprintf(text, sizeof(text), "%ldg", d); // gün / days
141 else snprintf(text, sizeof(text), "%02ld:%02ld", h, m); // saat:dakika / hh:mm
142 } else if (h > 0) {
143 snprintf(text, sizeof(text), "%02ld:%02ld", h, m); // saat:dakika / hh:mm
144 } else if (m > 0 || s > 10) {
145 snprintf(text, sizeof(text), "%02ld:%02ld", m, s); // dakika:saniye / mm:ss
146 } else {
147 snprintf(text, sizeof(text), "%ld", s); // son 10 sn / last 10 s
148 }
149 showText(text);
150 delay(20);
151}| Codedeel | Wat het doet |
|---|---|
| configTzTime(TZ_INFO, ...) | Maakt verbinding met de NTP-server, haalt de tijd op als UTC en zet die met de TZ-string om naar lokale tijd; standaard synchroniseert de ESP32 de tijd automatisch elk uur opnieuw. |
| makeTarget(year) | Vult de doeldatum in een struct tm en zet die met mktime() om naar epoch-seconden in lokale tijd. |
| chooseTarget() | Als het doel van dit jaar langer geleden is verstreken dan de feesttijd, kiest hij het doel van volgend jaar. |
| remaining / 86400 ... | Splitst de resterende seconden in dagen, uren, minuten en seconden. |
| showText() | Schrijft alleen met P.print() naar het display als de tekst veranderd is; door dezelfde tekst niet opnieuw te sturen voorkom je flikkeren. |
| displayAnimate() | Tekent het volgende frame van de scrolltekst; het is niet-blokkerend en moet dus vaak in de lus worden aangeroepen. |
| playMelody() | Speelt de noten achter elkaar af op basis van millis()-verschillen; omdat het geen delay() gebruikt, haperen de scrolltekst niet. |
Waarom wisselt het display dan af? De 8x32-matrix is maar 32 pixels breed en in het standaardlettertype van MD_Parola is een cijfer 5 pixels breed, samen met de ruimte van 1 pixel ernaast 6 pixels. "05:30" met vier cijfers en een dubbele punt past ruim in ongeveer 26 pixels, maar een display met zes cijfers zoals "04:05:30" komt boven de 40 pixels. Daarom spreiden we de informatie over de tijd: als het doel ver weg is, tellen de dagen, op de laatste dag de uren en minuten, en in het laatste uur bouwen de seconden de spanning op. Wil je meer informatie tegelijk tonen, dan kun je een tweede 8x32-module aan de keten toevoegen en MAX_DEVICES op 8 zetten, of een eigen lettertype met smalle cijfers definiëren.
Middernacht: scrolltekst en buzzermelodie
Als de timer nul bereikt, springt de functie startCelebration() aan: die combineert het bericht met het jaar tot de tekst "Mutlu Yillar 2027" en scrolt die met het effect PA_SCROLL_LEFT van rechts naar links. De melodie gebruikt de 26 noten van het refrein van "Jingle Bells"; voor elke noot wordt tone(pin, frequency, duration) aangeroepen en de volgende noot begint op basis van het millis()-verschil. Van elke noot wordt maar 90 procent van de duur gespeeld; door de korte stilte die overblijft hoor je herhaalde gelijke noten (mi-mi-mi) apart. Het standaardlettertype heeft geen Turkse tekens, daarom hebben we in het bericht i in plaats van ı geschreven. Om de melodie te veranderen pas je gewoon de arrays notes en durs aan; de frequenties van noten en hoe passieve buzzers werken, vind je in Wat is een buzzer?.
Versie met Arduino Uno + RTC-module
Ga je de timer in een klaslokaal, een schoolgang of een etalage zonder internet plaatsen, dan is het veiliger om niet van wifi af te hangen. In dat geval houdt een RTC-module de tijd bij: een DS1307- of DS3231-chip telt de seconden met zijn eigen kristal en blijft dankzij de knoopcel erop doortellen, ook als de Arduino geen stroom meer heeft. De DS1307 gebruikt een externe kristal van 32,768 kHz die gevoelig is voor temperatuur, waardoor hij bijna een minuut per maand kan afwijken; de temperatuurgecompenseerde DS3231 wijkt maar ongeveer een minuut per jaar af. Je schakelt over door in de code gewoon RTC_DS3231 te schrijven in plaats van RTC_DS1307. Voor details over de module kun je het artikel RTC-klokmodule lezen.

1#include <SPI.h>
2#include <Wire.h>
3#include <MD_Parola.h>
4#include <MD_MAX72xx.h>
5#include <RTClib.h>
6
7#define HARDWARE_TYPE MD_MAX72XX::FC16_HW // modül tipi / module type
8#define MAX_DEVICES 4
9#define CS_PIN 10 // DIN=D11, CLK=D13
10#define BUZZER_PIN 6 // pasif buzzer / passive buzzer
11
12MD_Parola P = MD_Parola(HARDWARE_TYPE, CS_PIN, MAX_DEVICES);
13RTC_DS1307 rtc; // DS3231 için RTC_DS3231 / use RTC_DS3231 for DS3231
14
15DateTime target(2027, 1, 1, 0, 0, 0); // yıl, ay, gün, saat, dk, sn / year, month, day, h, m, s
16const long CELEBRATE_SEC = 60; // kutlama süresi (s) / celebration length (s)
17
18const int notes[] = {659, 659, 659, 659, 659, 659, 659, 784, 523, 587, 659,
19 698, 698, 698, 698, 698, 659, 659, 659, 659,
20 659, 587, 587, 659, 587, 784};
21const int durs[] = {250, 250, 500, 250, 250, 500, 250, 250, 375, 125, 1000,
22 250, 250, 375, 125, 250, 250, 250, 125, 125,
23 250, 250, 250, 250, 500, 500};
24const int NOTE_COUNT = sizeof(notes) / sizeof(notes[0]);
25
26bool celebrating = false;
27char text[12];
28char lastText[12] = "";
29char msg[24];
30int noteIndex = 0;
31unsigned long lastNoteMs = 0;
32unsigned long waitMs = 0;
33bool melodyOn = false;
34
35void showText(const char* t) {
36 if (strcmp(t, lastText) != 0) { // yalnız değişince yaz / write only on change
37 strncpy(lastText, t, sizeof(lastText) - 1);
38 lastText[sizeof(lastText) - 1] = '\0';
39 P.print(lastText);
40 }
41}
42
43void startCelebration() {
44 celebrating = true;
45 snprintf(msg, sizeof(msg), "Mutlu Yillar %d", (int)target.year());
46 P.displayClear();
47 P.displayText(msg, PA_CENTER, 40, 500, PA_SCROLL_LEFT, PA_SCROLL_LEFT);
48 noteIndex = 0;
49 waitMs = 0;
50 lastNoteMs = millis();
51 melodyOn = true;
52}
53
54void playMelody() {
55 if (!melodyOn || millis() - lastNoteMs < waitMs) return;
56 if (noteIndex >= NOTE_COUNT) { // melodi bitti / melody finished
57 melodyOn = false;
58 noTone(BUZZER_PIN);
59 return;
60 }
61 tone(BUZZER_PIN, notes[noteIndex], durs[noteIndex] * 9 / 10);
62 lastNoteMs = millis();
63 waitMs = durs[noteIndex];
64 noteIndex++;
65}
66
67void setup() {
68 P.begin();
69 P.setIntensity(2); // parlaklık 0-15 / brightness 0-15
70 P.setTextAlignment(PA_CENTER);
71 if (!rtc.begin()) { // RTC bulunamadı / RTC not found
72 P.print("RTC?");
73 while (true) {}
74 }
75 if (!rtc.isrunning()) { // ilk kurulum: derleme saati / first setup: compile time
76 rtc.adjust(DateTime(F(__DATE__), F(__TIME__)));
77 }
78}
79
80void loop() {
81 DateTime now = rtc.now();
82 long remaining = (target - now).totalseconds();
83
84 if (remaining <= 0) {
85 if (remaining > -CELEBRATE_SEC) { // kutlama anı / celebration time
86 if (!celebrating) startCelebration();
87 if (P.displayAnimate()) P.displayReset();
88 playMelody();
89 return;
90 }
91 celebrating = false; // kutlama bitti, hedef +1 yıl / done, target +1 year
92 noTone(BUZZER_PIN);
93 target = DateTime(target.year() + 1, target.month(), target.day(),
94 target.hour(), target.minute(), target.second());
95 lastText[0] = '\0';
96 P.displayClear();
97 return;
98 }
99
100 long d = remaining / 86400;
101 long h = (remaining % 86400) / 3600;
102 long m = (remaining % 3600) / 60;
103 long s = remaining % 60;
104
105 if (d > 0) {
106 if ((now.unixtime() / 3) % 2 == 0) snprintf(text, sizeof(text), "%ldg", d);
107 else snprintf(text, sizeof(text), "%02ld:%02ld", h, m);
108 } else if (h > 0) {
109 snprintf(text, sizeof(text), "%02ld:%02ld", h, m);
110 } else if (m > 0 || s > 10) {
111 snprintf(text, sizeof(text), "%02ld:%02ld", m, s);
112 } else {
113 snprintf(text, sizeof(text), "%ld", s);
114 }
115 showText(text);
116 delay(20);
117}De Uno-code volgt dezelfde logica als de ESP32-versie; het enige verschil is dat de tijd met rtc.now() wordt gelezen in plaats van via NTP. In RTClib geeft het aftrekken van twee DateTime-objecten een TimeSpan terug, en totalseconds() geeft de resterende tijd in seconden. Als de RTC bij de eerste upload nog nooit is ingesteld, zet rtc.adjust() de tijd op de compileertijd van de computer; die kan achterlopen met de tijd tussen compileren en uploaden, dat is 10–20 seconden. Om dit verschil te dichten kun je + TimeSpan(15) aan de adjust-regel toevoegen. Als het doel verstreken is en het feest voorbij is, verschuift de code het doel automatisch een jaar vooruit, zodat de timer elk nieuwjaar opnieuw begint.
MicroPython-versie met de Raspberry Pi Pico W
Hetzelfde idee kun je op de Pico W met MicroPython uitvoeren. De module ntptime zet de klok van de Pico op UTC, dus we zetten het doel om naar UTC door 3 uur van de lokale tijd af te trekken. Voor het display moet je het max7219.py-stuurprogramma van de MicroPython-community naar de Pico kopiëren. Dit stuurprogramma is gebaseerd op framebuf en gebruikt een lettertype van 8x8 pixels, dus er passen maximaal 4 tekens in 32 pixels; daarom laten we de dubbele punt weg en tonen we "0530". Omdat de interne klok van de Pico na verloop van tijd afdrijft, is het verstandig om de aanroep ntptime.settime() eens per dag te herhalen als het apparaat dagenlang aan blijft. Ben je nieuw met MicroPython, begin dan met MicroPython-basis.
1import network, ntptime, time
2from machine import Pin, SPI, PWM
3import max7219 # max7219.py Pico'da olmalı / must be on the Pico
4
5SSID = "WIFI_ADIN"
6PASS = "WIFI_SIFREN"
7UTC_OFFSET = 3 * 3600 # Türkiye UTC+3 / Turkey UTC+3
8# yerel 1 Ocak 00:00 -> UTC / local Jan 1 00:00 -> UTC
9TARGET = time.mktime((2027, 1, 1, 0, 0, 0, 0, 0)) - UTC_OFFSET
10
11spi = SPI(0, baudrate=10_000_000, polarity=0, phase=0, sck=Pin(18), mosi=Pin(19))
12disp = max7219.Matrix8x8(spi, Pin(17, Pin.OUT), 4)
13disp.brightness(2) # parlaklık 0-15 / brightness 0-15
14buz = PWM(Pin(15))
15
16def show(txt):
17 disp.fill(0)
18 x = max(0, (32 - len(txt) * 8) // 2) # ortala / center
19 disp.text(txt, x, 0, 1)
20 disp.show()
21
22wlan = network.WLAN(network.STA_IF)
23wlan.active(True)
24wlan.connect(SSID, PASS)
25show("WiFi")
26while not wlan.isconnected():
27 time.sleep(0.5)
28
29show("NTP")
30while True:
31 try:
32 ntptime.settime() # saati UTC'ye ayarla / set the clock to UTC
33 break
34 except OSError:
35 time.sleep(2)
36
37while True:
38 kalan = TARGET - time.time()
39 if kalan <= 0: # kutlama / celebration
40 buz.freq(784)
41 buz.duty_u16(30000)
42 time.sleep(0.4)
43 buz.duty_u16(0)
44 msg = "MUTLU YILLAR 2027"
45 for x in range(32, -len(msg) * 8, -1): # kayan yazı / scrolling text
46 disp.fill(0)
47 disp.text(msg, x, 0, 1)
48 disp.show()
49 time.sleep(0.03)
50 continue
51 d, r = divmod(kalan, 86400)
52 h, r = divmod(r, 3600)
53 m, s = divmod(r, 60)
54 if d > 0:
55 show("%dg" % d if (time.time() // 3) % 2 == 0 else "%02d%02d" % (h, m))
56 elif h > 0:
57 show("%02d%02d" % (h, m)) # saat dakika / hours minutes
58 else:
59 show("%02d%02d" % (m, s)) # dakika saniye / minutes seconds
60 time.sleep(0.2)Aanpassen aan andere data
De timer gebruiken voor een verjaardag, een tussentijdse vakantie, een examendag of een bruiloft is heel makkelijk. Verander in de ESP32-code alleen de constanten TARGET_MONTH, TARGET_DAY en TARGET_HOUR en pas de tekst MESSAGE aan; het jaar wordt automatisch berekend en als het doel verstrijkt, wordt de timer op het volgende jaar gezet. Wil je het jaar niet aan de feesttekst toevoegen, verwijder dan het deel %d uit de snprintf-regel in startCelebration(). Gebruik voor een eenmalige gebeurtenis, zoals een examen, een vast jaar zoals target = makeTarget(2027) in plaats van chooseTarget() in setup(). In de Uno-versie verander je de DateTime-waarden op de doelregel. Voor dagen waarvan de datum elk jaar verschilt, zoals religieuze feestdagen, is het het betrouwbaarst om de datum van dat jaar met de hand in te vullen.
| Gebeurtenis | Instellingen (ESP32) | Voorgesteld bericht |
|---|---|---|
| Nieuwjaar | TARGET_MONTH 1, TARGET_DAY 1, TARGET_HOUR 0 | Mutlu Yillar |
| Verjaardag (bijv. 14 maart) | 3, 14, 0 | Iyi ki dogdun |
| Tussentijdse vakantie (rapportdag) | Maand en dag uit de kalender, uur 15 | Tatil basladi |
| Examendag | Vast jaar: target = makeTarget(2027); maand, dag en uur 10 | Basarilar |
| 29 oktober Republiekdag (Turkse feestdag) | 10, 29, 0 | Cumhuriyet Bayrami |
Projectideeën met een aftelklok
- Klasbord: een grote timer in de schoolgang die de dagen telt tot de toelatingsexamens voor de universiteit; koppel twee 8x32-modules aan elkaar voor een breedte van 64 pixels.
- Automatische versiering: schakel de lichtjes van de kerstboom automatisch in met een relaismodule zodra de timer nul bereikt.
- Kleurenversie: vervang de matrix door een WS2812B-ledmatrix en laat de kleuren in de laatste 10 seconden van rood naar groen overlopen.
- Bureauklok: laat het display een gewone klok worden als de aftelling voorbij is; details over NTP staan in ESP32 NTP-klok.
- Het doel wijzigen vanaf je telefoon: laat een kleine webserver op de ESP32 draaien om de doeldatum via een browser in te voeren.
- Een timer die zijn instelling onthoudt: sla de doeldatum op in het EEPROM, zodat de instelling niet verloren gaat als de stroom uit en weer aan gaat.
Veelgemaakte fouten en hoe je ze oplost
| Verschijnsel | Waarschijnlijke oorzaak | Oplossing |
|---|---|---|
| Tekst is omgekeerd, gespiegeld of letters zijn gedraaid | Verkeerd hardwaretype | Probeer PAROLA_HW, GENERIC_HW of ICSTATION_HW in plaats van FC16_HW |
| Het display blijft "NTP" tonen | De tijd kan niet worden opgehaald | Controleer of het netwerk UDP-poort 123 niet blokkeert en probeer een andere NTP-server |
| Het display blijft "WiFi" tonen | Verkeerde netwerknaam of verkeerd wachtwoord, of een 5 GHz-netwerk | De ESP32 verbindt alleen met 2,4 GHz-netwerken; controleer de SSID en het wachtwoord |
| De tijd loopt 3 uur voor of achter | Verkeerde tijdzonestring | Zet TZ_INFO op "TRT-3"; denk eraan dat het teken omgekeerd is |
| De buzzer geeft één toon in plaats van een melodie | Er is een actieve buzzer gebruikt | Gebruik een passieve buzzer waarvan de frequentie kan worden veranderd |
| Op de Uno klopt de tijd bij elke start niet | De RTC-batterij ontbreekt of is leeg | Controleer de batterij; de adjust-regel wordt alleen uitgevoerd als isrunning() false is |
| De ESP32 herstart en het display flikkert | De matrix trekt te veel stroom | Verlaag de helderheid, voed de matrix met een aparte 5V-adapter en verbind de GND's met elkaar |
Een aftelklok brengt in één leuk project veel basisvaardigheden samen: tijd berekenen, netwerktijd synchroniseren, een ledmatrix aansturen en niet-blokkerende code schrijven. In de BlueGrays-app vind je een dotmatrixklok en -kalender met MAX7219, een ESP32 NTP-klok, een digitale klok met een DS1307-RTC en projecten met buzzermelodieën, stap voor stap met schakelschema's en kant-en-klare code, en kun je deze timer daarop voortbouwen.
Veelgestelde vragen
Hoe maak je een aftelklok met Arduino?
Je neemt de doeldatum en de huidige tijd in seconden en trekt de ene van de andere af, en deelt het resultaat dan door 86400, 3600 en 60 om dagen, uren, minuten en seconden te krijgen. De huidige tijd lees je via NTP van het internet op een ESP32, of van een RTC-module zoals een DS1307 of DS3231 op een Arduino Uno. Het resultaat toon je dan op een display zoals een MAX7219-ledmatrix, een 7-segmentdisplay of een LCD.
Kun je millis() voor een aftelling gebruiken?
millis() is prima voor timers van een paar minuten, maar niet geschikt voor een aftelling die dagen duurt. Door de keramische resonator van de Arduino Uno kan millis() per dag minuten afwijken en begint hij opnieuw wanneer het board herstart. Gebruik voor lange aftellingen NTP of een RTC-module met batterij.
Stopt de ESP32 NTP-klok als het internet uitvalt?
Nee. Nadat de ESP32 de tijd eenmaal heeft opgehaald, blijft hij met zijn eigen kristal doortellen en is de afwijking meestal minder dan een paar seconden per dag. Als de verbinding terugkomt, synchroniseert de SNTP-client de tijd standaard eens per uur opnieuw; maar als de stroom wegvalt en het board herstart, is de tijd onbekend totdat hij opnieuw is opgehaald.
Hoeveel stroom trekt een MAX7219 8x32-ledmatrix?
Dat hangt af van de helderheid en het aantal brandende leds. Bij lage helderheid (setIntensity 0–3) blijft hij rond 100–200 mA terwijl hij een paar cijfers toont; met alle 256 leds op volle helderheid kan hij meer dan 1 A trekken. Voor een timer die lang aan blijft, is het voeden van de matrix met een aparte 5 V 2 A-adapter de veiligste manier.
Is de DS1307 of de DS3231 nauwkeuriger?
De DS3231 is duidelijk nauwkeuriger: dankzij zijn temperatuurgecompenseerde interne kristal wijkt hij ongeveer een minuut per jaar af. De DS1307 gebruikt een extern kristal en kan tussen een halve en een hele minuut per maand afwijken. Voor een moment waarop de seconde telt, zoals nieuwjaar, kies je de DS3231 of stel je de DS1307 af en toe opnieuw in.
Kan een ledmatrix Turkse tekens tonen?
Het standaardlettertype van MD_Parola heeft geen letters zoals ı, ş of ğ, daarom hebben we in het voorbeeld "Mutlu Yillar" geschreven. Je kunt een eigen lettertype definiëren, dat laden met setFont() en de Turkse letters tekenen op ongebruikte tekencodes. Het makkelijkst is om voor korte berichten woorden te kiezen waarvoor je geen Turkse letters nodig hebt.
Projecten om hierna te bouwen
Alle projecten bekijken
Turks volkslied met een buzzer
Druk op de knop en een kleine buzzer speelt noot voor noot het Turkse volkslied (İstiklal Marşı).

Dotmatrix-klok en -kalender (MAX7219, DS1307)
Een oplichtend bord voor op je bureau of aan de muur dat de tijd en de datum toont in scrollende tekst.

Dotmatrixklok, kalender en weerstation (MAX7219, DS1307)
Een scrollend tekstbord voor op je bureau of aan de muur dat om de beurt de tijd, de datum en het weer in de kamer toont.

4x 32x8-matrix ledanimatie en tekst
Stapel vier lange ledmatrixmodules op elkaar en je krijgt een vierkant scherm met meer dan duizend lichtpunten. Eerst regenen er letters van boven naar beneden, zoals in de film.

4x 32x8 ledmatrix - pakket met 6 animaties
Vier 32x8-ledpanelen boven elkaar vormen een vierkant scherm waarop zes animaties na elkaar worden afgespeeld: vallende digitale regen, een groeiende spiraal, cellen die helemaal zelf ontstaan en…

Echte tijd van internet met ESP32 en NTP
De ESP32 verbindt met Wi-Fi en haalt met milliseconde-precisie de echte tijd op bij NTP-servers (Network Time Protocol). configTzTime() past de Turkse tijdzone (TRT, UTC+3) automatisch toe, en in landen met zomertijd wordt de overgang naar zomertijd (DST) geregeld met een POSIX TZ-string. De tijd wordt zowel naar de Serial Monitor als naar een optioneel I2C-lcd gestuurd.

Digitale klok met ESP32 en DS1307-RTC (I2C + LCD)
In dit project tonen we de tijd en de datum op een 16x2 I2C-LCD met de DS1307 realtimeklok-module (RTC). De DS1307 is een RTC met batterijback-up die de tijd bijhoudt, ook als de ESP32 uit staat. Beide modules delen dezelfde I2C-bus (SDA/SCL), zodat je leert hoe je met slechts twee signaaldraden meerdere apparaten bestuurt. Met dit project krijg je praktische kennis van het I2C-communicatieprotocol, de werking van RTC-modules en het dynamisch tonen van gegevens op een LCD.

Digitale klok met 7-segmentdisplay met 4 cijfers
Een lichtgevende digitale klok met vier cijfers, zoals op een keukenoven. De DS1302-klokmodule houdt de tijd bij en de Arduino leest elke seconde uren en minuten uit en toont ze op het display met…
Meer artikelen
BlueGrays-app
Bouw deze schakeling stap voor stap op je telefoon
Schakelschema, code en onderdelenlijst op één scherm. Meer dan 500 Arduino-, ESP32- en Pico-projecten om te bouwen.
Scan met je telefoon
Richt je camera op de code en de appstore van je telefoon opent.
of open de store

