Gidsen · 10 min leestijd

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.

MAX7219 8x32 dotmatrix-ledmodule
De MAX7219 8x32-module, opgebouwd uit vier 8x8-matrices: 256 leds en maar 5 draden (VCC, GND, DIN, CS, CLK).

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.

StapBerekeningVoorbeeld (365400 s)
Dagenremaining / 864004
Uren(remaining % 86400) / 36005
Minuten(remaining % 3600) / 6030
Secondenremaining % 600

Onderdelenlijst

OnderdeelFunctieOpmerking
ESP32-developmentboardHaalt NTP-tijd op via Wi-Fi, berekent de resterende tijd en stuurt het display aanDe Uno-versie gebruikt in plaats daarvan een Arduino Uno + RTC
MAX7219 8x32 dotmatrix (FC16-type)Toont de resterende tijd en de scrolltekstWordt geleverd met 4 vooraf doorgekoppelde 8x8-matrices
Passieve buzzerSpeelt de melodie van middernachtEen actieve buzzer kan geen melodie spelen, alleen een vaste pieptoon
DS1307- of DS3231-RTC-moduleHoudt de tijd bij in de offlineversieDe knoopcel houdt de tijd bij, ook als de stroom wegvalt
5 V 2 A-adapter (aanbevolen)Voedt de matrixBij lage helderheid is voeding via USB genoeg
Jumperdraden en breadboardAansluitingenFemale-naar-male-draden zijn handig voor de pins van de module

Bedradingsschema: MAX7219, buzzer en RTC

AansluitingArduino UnoESP32Pico W
MAX7219 VCC5V5V (VIN)VBUS (5 V)
MAX7219 GNDGNDGNDGND
MAX7219 DIND11 (MOSI)GPIO 23GP19
MAX7219 CSD10GPIO 5GP17
MAX7219 CLKD13 (SCK)GPIO 18GP18
Passieve buzzer (+)D6GPIO 25GP15
Passieve buzzer (−)GNDGNDGND
RTC SDA / SCLA4 / A5Niet nodig (NTP)Niet nodig (NTP)
Voed de matrix altijd met 5 V, maar onderschat de stroom niet: met alle 256 leds op volle helderheid kan hij meer dan 1 A trekken, wat de USB-poort en de beveiligingsdiode op het board zwaar belast. Houd je de helderheid in de code tussen 0 en 3, dan blijf je rond 100–200 mA terwijl je cijfers toont. Wil je het helderder, voed de matrix dan met een aparte 5 V 2 A-adapter en verbind de GND van de adapter zeker met het board.

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

  1. 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.
  2. Installeer voor de versie met Uno + RTC de bibliotheek RTClib van Adafruit; accepteer als daarom wordt gevraagd ook de afhankelijkheid Adafruit BusIO.
  3. 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?.
  4. 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.

C++ (Arduino IDE)
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}
CodedeelWat 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.
Het teken in de TZ-string is omgekeerd: in POSIX-formaat betekent "TRT-3" UTC+3. Turkije gebruikt sinds 2016 geen zomertijd meer, dus dit is genoeg. Voor Duitsland, Frankrijk, Spanje en Italië kun je "CET-1CEST,M3.5.0,M10.5.0/3" gebruiken, en voor het Verenigd Koninkrijk "GMT0BST,M3.5.0/1,M10.5.0"; met deze strings worden de zomertijdwisselingen automatisch berekend.

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.

DS1307 RTC-klokmodule
DS1307 RTC-module: wordt via I2C aangesloten en houdt dankzij de knoopcel de tijd bij, ook als de stroom wegvalt.
C++ (Arduino IDE)
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.

Als de tijd van de DS1307-module nooit oploopt of bij elke start terugspringt, kan de batterij leeg zijn of ontbreken. Sommige goedkope DS1307-modules hebben een oplaadschakeling en verwachten dus een oplaadbare LIR2032-batterij; een gewone CR2032 in zulke modules kan ervoor zorgen dat de batterij opzwelt. Controleer het schema van je module voordat je de batterij vervangt.

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.

MicroPython
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.

GebeurtenisInstellingen (ESP32)Voorgesteld bericht
NieuwjaarTARGET_MONTH 1, TARGET_DAY 1, TARGET_HOUR 0Mutlu Yillar
Verjaardag (bijv. 14 maart)3, 14, 0Iyi ki dogdun
Tussentijdse vakantie (rapportdag)Maand en dag uit de kalender, uur 15Tatil basladi
ExamendagVast jaar: target = makeTarget(2027); maand, dag en uur 10Basarilar
29 oktober Republiekdag (Turkse feestdag)10, 29, 0Cumhuriyet 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

VerschijnselWaarschijnlijke oorzaakOplossing
Tekst is omgekeerd, gespiegeld of letters zijn gedraaidVerkeerd hardwaretypeProbeer PAROLA_HW, GENERIC_HW of ICSTATION_HW in plaats van FC16_HW
Het display blijft "NTP" tonenDe tijd kan niet worden opgehaaldControleer of het netwerk UDP-poort 123 niet blokkeert en probeer een andere NTP-server
Het display blijft "WiFi" tonenVerkeerde netwerknaam of verkeerd wachtwoord, of een 5 GHz-netwerkDe ESP32 verbindt alleen met 2,4 GHz-netwerken; controleer de SSID en het wachtwoord
De tijd loopt 3 uur voor of achterVerkeerde tijdzonestringZet TZ_INFO op "TRT-3"; denk eraan dat het teken omgekeerd is
De buzzer geeft één toon in plaats van een melodieEr is een actieve buzzer gebruiktGebruik een passieve buzzer waarvan de frequentie kan worden veranderd
Op de Uno klopt de tijd bij elke start nietDe RTC-batterij ontbreekt of is leegControleer de batterij; de adjust-regel wordt alleen uitgevoerd als isrunning() false is
De ESP32 herstart en het display flikkertDe matrix trekt te veel stroomVerlaag de helderheid, voed de matrix met een aparte 5V-adapter en verbind de GND's met elkaar
Om de timer dagen voor nieuwjaar te testen, zet je de doeltijd een paar minuten vooruit; wacht op het feestmoment, bekijk de scrolltekst en de melodie en ga daarna terug naar de echte datum. Blijft de ESP32 resetten, dan is de oorzaak meestal de voeding; details staan in ESP32 Brownout en Guru Meditation.

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.

Alle projecten bekijken
Turks volkslied met een buzzer
AR-15Gemiddeld

Turks volkslied met een buzzer

Druk op de knop en een kleine buzzer speelt noot voor noot het Turkse volkslied (İstiklal Marşı).

4.8(114)
234
Dotmatrix-klok en -kalender (MAX7219, DS1307)
AR-84Gemiddeld
Premium

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.

5.0(37)
59
Dotmatrixklok, kalender en weerstation (MAX7219, DS1307)
AR-85Gemiddeld
Premium

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.

5.0(50)
66
4x 32x8-matrix ledanimatie en tekst
AR-90Gemiddeld
Premium

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.

4.6(40)
66
4x 32x8 ledmatrix - pakket met 6 animaties
AR-91Gemiddeld
Premium

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…

4.5(35)
48
Echte tijd van internet met ESP32 en NTP
ES-26Gevorderd
Premium

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.

4.5(13)
22
Digitale klok met ESP32 en DS1307-RTC (I2C + LCD)
ES-18Gemiddeld
Premium

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.

4.6(26)
40
Digitale klok met 7-segmentdisplay met 4 cijfers
AR-48Gemiddeld
Premium

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…

4.8(56)
73