Weihnachtsbeleuchtung Zeitschaltuhr ESP32: an bei Sonnenuntergang
Weihnachtsbeleuchtung per ESP32-Zeitschaltuhr: NTP und Standort liefern den Sonnenuntergang, ein Relais schaltet ein und um Mitternacht aus. Mit Städtetabelle.
Der größte Vorteil eines ESP32 als Zeitschaltuhr für die Weihnachtsbeleuchtung: Er schaltet das Licht nicht zu einer festen Uhrzeit, sondern dann, wenn an deinem Wohnort wirklich die Sonne untergeht. Der ESP32 verbindet sich mit dem WLAN, holt per NTP die Uhrzeit aus dem Internet, berechnet aus dem eingegebenen Breiten- und Längengrad Sonnenauf- und -untergang des Tages, schaltet die Lichterkette über ein Relaismodul ein und um Mitternacht von selbst wieder aus. Zusätzlich kannst du das Licht über eine kleine Webseite auf dem Handy von Hand schalten, und der gewählte Modus bleibt sogar nach einem Stromausfall gespeichert.
In diesem Ratgeber zeigen wir zuerst, warum sich der Sonnenuntergang jeden Tag verschiebt und wie stark er sich von Stadt zu Stadt unterscheidet, und erklären dann Schritt für Schritt die Formel hinter der Berechnung. Danach folgen zwei Sketche: Der erste schreibt nur den heutigen Sonnenauf- und -untergang in den seriellen Monitor, der zweite ist eine vollständige Zeitschaltuhr mit Relais, Abschaltung um Mitternacht und Websteuerung. Zum Schluss geht es um Sicherheit im Außenbereich und häufige Fehler. Wenn du die NTP-Grundlagen auffrischen willst, wirf einen Blick auf ESP32-NTP-Uhr.

Warum Sonnenuntergang statt fester Uhrzeit?
Eine mechanische oder digitale Steckdosen-Zeitschaltuhr schaltet jeden Abend zur selben Zeit ein, der Sonnenuntergang wandert aber durch die ganze Saison. In Berlin geht die Sonne am 1. November um 16:38, am 1. Dezember um 15:57 und am 31. Januar um 16:47 unter, eine Schwankung von fast einer Stunde in der Weihnachtszeit. Eine feste Einstellung auf 16:15 schaltet das Licht Anfang November und Ende Januar bei Tageslicht ein; stellst du sie auf 16:30, geht es Mitte Dezember erst über eine halbe Stunde nach Einbruch der Dunkelheit an. Auch der Ort macht viel aus: Am 21. Dezember geht die Sonne in Berlin um 15:53 und in Madrid um 17:51 unter, obwohl beide Städte in derselben Zeitzone liegen. Die Tabelle zeigt Sonnenuntergänge, berechnet mit derselben Formel wie im Code; sie weichen von amtlichen Werten meist nur ein bis zwei Minuten ab.
| Stadt | Breite, Länge | 1. Dez. | 10. Dez. | 21. Dez. | 31. Dez. |
|---|---|---|---|---|---|
| Istanbul | 41,01 / 28,98 | 17:37 | 17:36 | 17:38 | 17:44 |
| Ankara | 39,93 / 32,86 | 17:25 | 17:23 | 17:26 | 17:32 |
| Izmir | 38,42 / 27,14 | 17:51 | 17:51 | 17:53 | 17:59 |
| London | 51,51 / -0,13 | 15:56 | 15:52 | 15:53 | 15:59 |
| Berlin | 52,52 / 13,41 | 15:57 | 15:53 | 15:53 | 16:00 |
| München | 48,14 / 11,58 | 16:23 | 16:20 | 16:22 | 16:28 |
| Wien | 48,21 / 16,37 | 16:04 | 16:01 | 16:02 | 16:08 |
| Madrid | 40,42 / -3,70 | 17:49 | 17:48 | 17:51 | 17:57 |
| Paris | 48,86 / 2,35 | 16:57 | 16:54 | 16:55 | 17:02 |
| Rom | 41,90 / 12,50 | 16:40 | 16:39 | 16:41 | 16:47 |
| Mailand | 45,46 / 9,19 | 16:42 | 16:40 | 16:42 | 16:48 |
| New York | 40,71 / -74,01 | 16:30 | 16:28 | 16:31 | 16:37 |
| Mexiko-Stadt | 19,43 / -99,13 | 17:57 | 17:59 | 18:03 | 18:08 |
In der Tabelle steckt ein interessantes Detail: Obwohl der 21. Dezember der kürzeste Tag ist, liegt der früheste Sonnenuntergang etwa zehn Tage davor, in der ersten Dezemberhälfte. Der Grund ist die Zeitgleichung: Die Erdbahn ist kein perfekter Kreis und die Erdachse ist geneigt, deshalb erreicht die Sonne im Dezember ihren höchsten Stand jeden Tag rund 30 Sekunden später. Der Sonnenuntergang wird dadurch nach hinten geschoben, während die Sonne morgens bis Anfang Januar immer später aufgeht. Eine Zeitschaltuhr mit fester Uhrzeit kann diese Feinheit nie abbilden; die Formel berücksichtigt sie automatisch.
Wie wird der Sonnenuntergang berechnet?
Der Code nutzt die Näherungsformeln der US-Behörde für Ozean und Atmosphäre (NOAA). Die Berechnung braucht nur den Tag des Jahres, den Breiten- und den Längengrad; zusätzliche Daten aus dem Internet sind nicht nötig. Das Ergebnis liegt in UTC-Minuten vor und wird vom Code über die Zeitzoneneinstellung in Ortszeit umgerechnet, so stimmt es auch in Ländern mit Sommerzeit. Unterhalb von 60° Breite ist die Formel auf ein bis zwei Minuten genau; in Polargebieten, wenn die Sonne den ganzen Tag nicht untergeht oder gar nicht aufgeht, ist der Arkuskosinus undefiniert, was der Code eigens prüft.
| Schritt | Formel | Erklärung |
|---|---|---|
| 1. Jahresbruchteil | γ = 2π / 365 × (Tag − 1) | Rechnet den Tag des Jahres in Radiant um |
| 2. Zeitgleichung | eqtime = 229,18 × (0,000075 + 0,001868 cos γ − 0,032077 sin γ − 0,014615 cos 2γ − 0,040849 sin 2γ) | Unterschied zwischen Sonnenuhr und Uhrzeit, übers Jahr etwa −14 bis +16 min |
| 3. Deklination der Sonne | δ = 0,006918 − 0,399912 cos γ + 0,070257 sin γ − ... | Um den 21. Dezember etwa −23,44° |
| 4. Stundenwinkel | ha = arccos(cos 90,833° / (cos φ cos δ) − tan φ tan δ) | 90,833°: Refraktion am Horizont (0,567°) + Sonnenradius (0,267°) |
| 5. Sonnenuntergang | 720 − 4 × (Länge − ha) − eqtime | UTC-Minuten; jedes Grad Länge entspricht 4 Minuten |
Materialliste
- ESP32-Entwicklungsboard (30 oder 38 Pins, egal)
- 1-Kanal-Relaismodul: mit Optokoppler, Kontakte für 10 A 250 V AC; oder ein geräuschloses Halbleiterrelais (SSR)
- USB-Netzteil 5 V 1–2 A und USB-Kabel für den ESP32
- Lichterkette: am besten eine Niedervolt-LED-Kette (5–31 V) für außen mit eigenem Netzteil
- IP65-Abzweigdose, Kabelverschraubungen und Klemmen
- Ein paar Jumperkabel
Verdrahtung: ESP32 und Relaismodul
| Relaismodul | ESP32 | Hinweis |
|---|---|---|
| VCC | VIN (5 V) | Die Relaisspule braucht 5 V; der per USB versorgte VIN-Pin reicht |
| GND | GND | Gemeinsame Masse |
| IN | GPIO 26 | RELAY_PIN im Code; die meisten Module schalten bei LOW |
| COM | +-Ausgang des Lichterketten-Netzteils | Eingang der geschalteten Leitung |
| NO (Schließer) | +-Eingang der Lichterkette | Zieht das Relais an, schließt der Kreis |
| NC (Öffner) | Frei | Wird nicht genutzt |
Schritt 1: den heutigen Sonnenuntergang im seriellen Monitor sehen
- Installiere in der Arduino IDE über den Boardverwalter das Paket esp32 und wähle ESP32 Dev Module als Board.
- Trag im Code unten Netzwerkname und Passwort in WIFI_SSID und WIFI_PASS ein.
- Passe LATITUDE und LONGITUDE an deine Stadt an; westliche Längen und südliche Breiten sind negativ.
- Außerhalb der Türkei wählst du die Zeile TZ_INFO aus der Zeitzonentabelle weiter unten, für Deutschland und Österreich "CET-1CEST,M3.5.0,M10.5.0/3".
- Lade den Code hoch, öffne den seriellen Monitor mit 115200 Baud und vergleiche die Zeiten mit der Tabelle.
1// ESP32: NTP saati + bugünün gün doğumu/batımı (Seri Monitör)
2// ESP32: NTP time + today's sunrise/sunset (Serial Monitor)
3#include <WiFi.h>
4#include <time.h>
5#include <math.h>
6
7const char* WIFI_SSID = "AgAdi"; // Wi-Fi adı / Wi-Fi name
8const char* WIFI_PASS = "Sifre123"; // Wi-Fi şifresi / Wi-Fi password
9const char* TZ_INFO = "<+03>-3"; // Türkiye UTC+3 / Turkey UTC+3
10const double LATITUDE = 41.01; // İstanbul enlemi (kuzey +) / latitude (north +)
11const double LONGITUDE = 28.98; // İstanbul boylamı (doğu +) / longitude (east +)
12
13// NOAA yaklaşık formülü, sonuç UTC dakika / NOAA approximation, result in UTC minutes
14bool sunTimesUtc(int yday, int year, double &riseUtc, double &setUtc) {
15 int daysInYear = ((year % 4 == 0 && year % 100 != 0) || year % 400 == 0) ? 366 : 365;
16 double g = 2.0 * PI / daysInYear * yday; // yılın kesri (radyan) / fractional year (rad)
17 double eqTime = 229.18 * (0.000075 + 0.001868 * cos(g) - 0.032077 * sin(g)
18 - 0.014615 * cos(2 * g) - 0.040849 * sin(2 * g)); // zaman denklemi (dk) / equation of time (min)
19 double decl = 0.006918 - 0.399912 * cos(g) + 0.070257 * sin(g) - 0.006758 * cos(2 * g)
20 + 0.000907 * sin(2 * g) - 0.002697 * cos(3 * g) + 0.00148 * sin(3 * g); // eğim (rad) / declination (rad)
21 double lat = LATITUDE * DEG_TO_RAD;
22 double x = cos(90.833 * DEG_TO_RAD) / (cos(lat) * cos(decl)) - tan(lat) * tan(decl);
23 if (x < -1.0 || x > 1.0) return false; // kutup gecesi ya da gündüzü / polar night or day
24 double ha = acos(x) * RAD_TO_DEG; // saat açısı (derece) / hour angle (degrees)
25 riseUtc = 720 - 4 * (LONGITUDE + ha) - eqTime;
26 setUtc = 720 - 4 * (LONGITUDE - ha) - eqTime;
27 return true;
28}
29
30void setup() {
31 Serial.begin(115200);
32 WiFi.begin(WIFI_SSID, WIFI_PASS);
33 while (WiFi.status() != WL_CONNECTED) {
34 delay(500);
35 Serial.print(".");
36 }
37 configTzTime(TZ_INFO, "pool.ntp.org", "time.cloudflare.com");
38 struct tm now;
39 while (!getLocalTime(&now)) {
40 Serial.println("NTP bekleniyor / waiting for NTP");
41 }
42
43 struct tm noon = now; // yerel öğle: günün UTC tarihini bulmak için / local noon to find today's UTC date
44 noon.tm_hour = 12; noon.tm_min = 0; noon.tm_sec = 0; noon.tm_isdst = -1;
45 time_t noonT = mktime(&noon);
46 time_t utcMidnight = noonT - (noonT % 86400);
47
48 double riseUtc, setUtc;
49 if (sunTimesUtc(now.tm_yday, now.tm_year + 1900, riseUtc, setUtc)) {
50 time_t riseT = utcMidnight + (time_t)(riseUtc * 60);
51 time_t setT = utcMidnight + (time_t)(setUtc * 60);
52 struct tm r, s;
53 localtime_r(&riseT, &r);
54 localtime_r(&setT, &s);
55 Serial.printf("Bugun / today: %02d.%02d.%d\n", now.tm_mday, now.tm_mon + 1, now.tm_year + 1900);
56 Serial.printf("Gun dogumu / sunrise: %02d:%02d\n", r.tm_hour, r.tm_min);
57 Serial.printf("Gun batimi / sunset: %02d:%02d\n", s.tm_hour, s.tm_min);
58 }
59}
60
61void loop() {
62}Der kniffligste Teil des Codes ist die Umrechnung zwischen UTC und Ortszeit. Die Formel liefert den Sonnenuntergang als Minuten nach der UTC-Mitternacht des Tages. Der Code wandelt zuerst den heutigen Mittag in Ortszeit mit mktime() in einen Zeitstempel um und zieht dann den Rest der Division durch 86400 ab, um die UTC-Mitternacht desselben Datums zu erhalten. Darauf werden die Sonnenuntergangsminuten addiert, und localtime_r() rechnet das Ergebnis in deine Zeitzone um. Der Start beim Mittag verhindert, dass in den Nachtstunden, in denen UTC- und Ortsdatum auseinanderliegen, der falsche Tag berechnet wird.
Schritt 2: der vollständige Code mit Relais, Mitternachtsabschaltung und Websteuerung
Der zweite Sketch macht aus der Sonnenuntergangsberechnung eine Zeitschaltuhr. Alle 10 Sekunden prüft er die Uhrzeit; hat der Tag gewechselt, berechnet er Sonnenauf- und -untergang neu, und im Automatikmodus entscheidet er, ob das Licht an sein soll. Die eingebaute Bibliothek WebServer stellt auf Port 80 eine kleine Seite bereit: Öffnest du die IP-Adresse des ESP32 im Browser, siehst du den Lichtstatus, Sonnenauf- und -untergang des Tages sowie die Links AUTO, ON und OFF. Der gewählte Modus wird mit Preferences im Flash gespeichert, nach einem Stromausfall macht die Zeitschaltuhr im selben Modus weiter.
1// ESP32 Noel ışıkları zamanlayıcısı: gün batımında aç, gece yarısı kapat, web'den elle kontrol
2// ESP32 Christmas lights timer: on at sunset, off at midnight, manual control from the web
3#include <WiFi.h>
4#include <WebServer.h>
5#include <Preferences.h>
6#include <time.h>
7#include <math.h>
8
9const char* WIFI_SSID = "AgAdi"; // Wi-Fi adı / Wi-Fi name
10const char* WIFI_PASS = "Sifre123"; // Wi-Fi şifresi / Wi-Fi password
11const char* TZ_INFO = "<+03>-3"; // Türkiye / Turkey. Berlin, Paris, Roma, Madrid: "CET-1CEST,M3.5.0,M10.5.0/3"
12const double LATITUDE = 41.01; // enlem (kuzey +) / latitude (north +)
13const double LONGITUDE = 28.98; // boylam (doğu +, batı -) / longitude (east +, west -)
14
15const int RELAY_PIN = 26; // röle modülü IN / relay module IN
16const bool RELAY_ACTIVE_LOW = true; // çoğu modül LOW ile çeker / most modules switch on LOW
17const int SUNSET_OFFSET_MIN = 0; // gün batımına göre kayma (dk), -15 = 15 dk önce / shift from sunset (min)
18const int OFF_MINUTE = 24 * 60; // kapanış: 24:00 = gece yarısı, 23:30 için 23*60+30 / off time
19const int MORNING_ON_MINUTE = -1; // sabah açılış, ör. 6*60+30; -1 = kapalı / morning on, e.g. 6:30; -1 = off
20
21enum Mode : uint8_t { MODE_AUTO, MODE_ON, MODE_OFF };
22Mode mode = MODE_AUTO;
23bool lightsOn = false;
24int sunriseMin = -1, sunsetMin = -1; // bugünün yerel dakikası / today's local minute of day
25int lastYday = -1;
26unsigned long lastCheck = 0;
27
28WebServer server(80);
29Preferences prefs;
30
31bool sunTimesUtc(int yday, int year, double &riseUtc, double &setUtc) {
32 int daysInYear = ((year % 4 == 0 && year % 100 != 0) || year % 400 == 0) ? 366 : 365;
33 double g = 2.0 * PI / daysInYear * yday;
34 double eqTime = 229.18 * (0.000075 + 0.001868 * cos(g) - 0.032077 * sin(g)
35 - 0.014615 * cos(2 * g) - 0.040849 * sin(2 * g));
36 double decl = 0.006918 - 0.399912 * cos(g) + 0.070257 * sin(g) - 0.006758 * cos(2 * g)
37 + 0.000907 * sin(2 * g) - 0.002697 * cos(3 * g) + 0.00148 * sin(3 * g);
38 double lat = LATITUDE * DEG_TO_RAD;
39 double x = cos(90.833 * DEG_TO_RAD) / (cos(lat) * cos(decl)) - tan(lat) * tan(decl);
40 if (x < -1.0 || x > 1.0) return false;
41 double ha = acos(x) * RAD_TO_DEG;
42 riseUtc = 720 - 4 * (LONGITUDE + ha) - eqTime;
43 setUtc = 720 - 4 * (LONGITUDE - ha) - eqTime;
44 return true;
45}
46
47int toLocalMinute(time_t utcMidnight, double utcMinutes) {
48 time_t t = utcMidnight + (time_t)(utcMinutes * 60);
49 struct tm lt;
50 localtime_r(&t, <);
51 return lt.tm_hour * 60 + lt.tm_min;
52}
53
54void updateSunTimes(struct tm now) { // günde bir kez / once a day
55 now.tm_hour = 12; now.tm_min = 0; now.tm_sec = 0; now.tm_isdst = -1;
56 time_t noonT = mktime(&now);
57 time_t utcMidnight = noonT - (noonT % 86400);
58 double r, s;
59 if (sunTimesUtc(now.tm_yday, now.tm_year + 1900, r, s)) {
60 sunriseMin = toLocalMinute(utcMidnight, r);
61 sunsetMin = toLocalMinute(utcMidnight, s);
62 }
63 lastYday = now.tm_yday;
64 Serial.printf("Gun dogumu %02d:%02d, gun batimi %02d:%02d\n", sunriseMin / 60, sunriseMin % 60, sunsetMin / 60, sunsetMin % 60);
65}
66
67void setRelay(bool on) {
68 lightsOn = on;
69 digitalWrite(RELAY_PIN, (on != RELAY_ACTIVE_LOW) ? HIGH : LOW);
70}
71
72bool autoWantsOn(int nowMin) {
73 if (sunsetMin < 0) return false;
74 if (nowMin >= sunsetMin + SUNSET_OFFSET_MIN && nowMin < OFF_MINUTE) return true; // akşam / evening
75 if (MORNING_ON_MINUTE >= 0 && nowMin >= MORNING_ON_MINUTE && nowMin < sunriseMin) return true; // sabah / morning
76 return false;
77}
78
79void applyState() {
80 struct tm now;
81 if (!getLocalTime(&now, 10)) { // saat henüz yok / no time yet
82 setRelay(mode == MODE_ON);
83 return;
84 }
85 if (now.tm_yday != lastYday) updateSunTimes(now);
86 int nowMin = now.tm_hour * 60 + now.tm_min;
87 bool on = (mode == MODE_ON) || (mode == MODE_AUTO && autoWantsOn(nowMin));
88 if (on != lightsOn) {
89 setRelay(on);
90 Serial.printf("%02d:%02d isiklar %s\n", now.tm_hour, now.tm_min, on ? "ACIK / on" : "KAPALI / off");
91 }
92}
93
94String hhmm(int m) {
95 if (m < 0) return "--:--";
96 char buf[12];
97 snprintf(buf, sizeof(buf), "%02d:%02d", m / 60, m % 60);
98 return String(buf);
99}
100
101void handleRoot() {
102 String html = F("<!DOCTYPE html><html><head><meta charset='utf-8'>"
103 "<meta name='viewport' content='width=device-width,initial-scale=1'>"
104 "<title>Noel</title></head><body style='font-family:sans-serif;text-align:center'>");
105 html += "<h2>" + String(lightsOn ? "ON" : "OFF") + "</h2>";
106 html += "<p>Sunrise " + hhmm(sunriseMin) + " | Sunset " + hhmm(sunsetMin) + "</p>";
107 html += "<p>Mode: " + String(mode == MODE_AUTO ? "AUTO" : (mode == MODE_ON ? "ON" : "OFF")) + "</p>";
108 html += F("<p><a href='/mode?m=auto'>AUTO</a> | <a href='/mode?m=on'>ON</a> | <a href='/mode?m=off'>OFF</a></p></body></html>");
109 server.send(200, "text/html", html);
110}
111
112void handleMode() {
113 String m = server.arg("m");
114 mode = (m == "on") ? MODE_ON : (m == "off") ? MODE_OFF : MODE_AUTO;
115 prefs.putUChar("mode", mode); // elektrik kesilse de hatırla / remember after a power cut
116 applyState();
117 server.sendHeader("Location", "/");
118 server.send(303);
119}
120
121void setup() {
122 digitalWrite(RELAY_PIN, RELAY_ACTIVE_LOW ? HIGH : LOW); // açılışta kapalı başla / start switched off
123 pinMode(RELAY_PIN, OUTPUT);
124 Serial.begin(115200);
125
126 prefs.begin("noel", false);
127 mode = (Mode)prefs.getUChar("mode", MODE_AUTO);
128
129 WiFi.mode(WIFI_STA);
130 WiFi.begin(WIFI_SSID, WIFI_PASS);
131 unsigned long start = millis();
132 while (WiFi.status() != WL_CONNECTED && millis() - start < 20000) delay(500);
133 Serial.print("IP: ");
134 Serial.println(WiFi.localIP());
135
136 configTzTime(TZ_INFO, "pool.ntp.org", "time.cloudflare.com");
137 server.on("/", handleRoot);
138 server.on("/mode", handleMode);
139 server.begin();
140}
141
142void loop() {
143 server.handleClient();
144 if (millis() - lastCheck > 10000) { // 10 sn'de bir kontrol / check every 10 s
145 lastCheck = millis();
146 applyState();
147 }
148}Einstellungen
| Einstellung | Standard | Wozu? |
|---|---|---|
| TZ_INFO | "<+03>-3" | Zeitzone und Sommerzeitregel (POSIX-Format) |
| LATITUDE / LONGITUDE | 41.01 / 28.98 | Standort; westliche Länge und südliche Breite negativ |
| RELAY_PIN | 26 | Pin, an dem IN des Relaismoduls hängt |
| RELAY_ACTIVE_LOW | true | true, wenn das Modul bei LOW schaltet, false bei HIGH |
| SUNSET_OFFSET_MIN | 0 | Verschiebung zum Sonnenuntergang; −15 schaltet 15 min früher ein |
| OFF_MINUTE | 24 * 60 | Ausschaltzeit; für 23:30 nimm 23 * 60 + 30 |
| MORNING_ON_MINUTE | -1 | Morgens einschalten; mit 6 * 60 + 30 leuchtet es von 06:30 bis Sonnenaufgang |
Wie funktioniert der Code?
In applyState() fällt die Entscheidung. Ist noch keine Uhrzeit da, leuchtet das Licht nur im Modus ON; so geht es nicht zur falschen Zeit an, bevor das WLAN steht. Ist die Zeit gültig, wird die Minute des Tages berechnet und zwei Bedingungen werden geprüft: Das Abendfenster reicht vom Sonnenuntergang bis zur Ausschaltzeit, das optionale Morgenfenster von der Einschaltzeit bis zum Sonnenaufgang. Das Relais schaltet nur, wenn sich der Zustand ändert, und jede Änderung erscheint im seriellen Monitor, was die Fehlersuche erleichtert. setRelay() schreibt je nach RELAY_ACTIVE_LOW den richtigen Pegel auf den Pin. In setup() wird der Pin auf den Aus-Pegel gesetzt, bevor er zum Ausgang wird; diese Reihenfolge verhindert, dass das Relais beim Start kurz anzieht. Fällt das WLAN aus, läuft der ESP32 mit seiner internen Uhr weiter, und sobald die Verbindung zurück ist, korrigiert NTP die Zeit wieder.
| Region | TZ_INFO |
|---|---|
| Türkei | <+03>-3 |
| Deutschland, Österreich, Italien, Frankreich, Spanien | CET-1CEST,M3.5.0,M10.5.0/3 |
| Vereinigtes Königreich, Irland, Portugal | GMT0BST,M3.5.0/1,M10.5.0 |
| USA Ostküste (New York) | EST5EDT,M3.2.0,M11.1.0 |
| Mexiko (Mexiko-Stadt) | CST6 |
Sicherheit im Außenbereich
- Niedervolt bevorzugen: Bei LED-Ketten mit 5–31 V und eigenem Netzteil setzt du das Relais an den Niedervolt-Ausgang des Netzteils und berührst die Netzspannung überhaupt nicht.
- Gehäuse und Verschraubungen: Setz ESP32 und Relais in ein IP65-Gehäuse, führe die Kabel durch Verschraubungen und montiere die Dose mit den Kabeleinführungen nach unten, damit kein Wasser hineinläuft.
- Strom prüfen: Eine typische Kette mit 200 LEDs nimmt 10–20 W auf, an 230 V also weniger als 0,1 A. Den 10-A-Wert des Relais erreichst du nie, bei billigen Modulen liegt die echte Grenze aber unter dem Aufdruck; halte die Gesamtlast daher unter wenigen Ampere.
- Kondenswasser: In Winternächten kann sich im Gehäuse Feuchtigkeit niederschlagen; leg ein kleines Silicagel-Päckchen hinein und befestige die Elektronik oben im Gehäuse statt auf dem Boden.
- Keine induktiven Lasten: Nutze diese Zeitschaltuhr nur für Licht; der Anlaufstrom von Motoren, Heizungen oder Kompressoren kann die Relaiskontakte schnell verschweißen.
Häufige Fehler und Lösungen
| Problem | Ursache | Lösung |
|---|---|---|
| "Warte auf NTP" hört im seriellen Monitor nicht auf | WLAN nicht verbunden oder NTP-Port gesperrt | Netzwerkname und Passwort prüfen, ESP32 näher an den Router |
| Sonnenuntergang genau eine Stunde daneben | Falsches TZ_INFO oder fehlende Sommerzeitregel | Den richtigen POSIX-String aus der Tabelle nutzen |
| Sonnenuntergang Stunden daneben | Falsches Vorzeichen der Länge oder Breite und Länge vertauscht | Westliche Länge negativ eingeben, Reihenfolge prüfen |
| Relais fällt nie ab | 5-V-Modul schaltet mit 3,3-V-HIGH nicht ganz ab | JD-VCC trennen, 3,3-V-Modul oder Transistor nutzen |
| Licht blitzt beim Start kurz auf | Boot-Pin oder pinMode-Reihenfolge | Sicheren Pin wie GPIO 26 wählen, erst digitalWrite, dann pinMode |
| Webseite öffnet nicht | IP-Adresse hat sich geändert | DHCP-Reservierung im Router oder mDNS nutzen |
| Licht brennt auch nach Mitternacht | Modus steht auf ON | Auf der Webseite zu AUTO wechseln |
Projektideen mit dieser Zeitschaltuhr
- Lichtsensor als Reserve: Ist das WLAN lange weg, erkenne die Dunkelheit mit einem LDR und schalte das Licht trotzdem ein.
- Smart-Home-Anbindung: Veröffentliche den Relaiszustand per MQTT und steuere ihn aus dem Home Assistant-Dashboard.
- Mehrkanal-Zeitplan: Mit einer 4-Kanal-Relaisplatine bekommen Balkon-, Garten- und Fensterlicht unterschiedliche Ausschaltzeiten.
- Sonnenuntergangs-Effekt: Nimm statt des Relais einen WS2812B-Streifen und blende die Farben bei Sonnenuntergang langsam auf Warmweiß; den Streifenaufbau findest du unter Weihnachtsbaum-Beleuchtung.
- Weitere Saisonprojekte: Ideen, die diese Zeitschaltuhr ergänzen, findest du in der Liste Arduino-Weihnachtsprojekte.
Willst du die Bausteine dieser Zeitschaltuhr einzeln lernen, schau dir in der BlueGrays-App die Projekte zur ESP32-Echtzeit per NTP, zum ESP32-Async-Webserver und zur intelligenten ESP32-Beleuchtung an; jedes bringt Schaltplan, Verdrahtungsliste und Schritt für Schritt erklärten Code mit. Kombinierst du diese Bausteine mit der Sonnenuntergangsberechnung aus diesem Beitrag, geht deine Weihnachtsbeleuchtung jeden Abend pünktlich von selbst an.
Häufige Fragen
Wie schaltet sich die Weihnachtsbeleuchtung bei Sonnenuntergang automatisch ein?
Am genauesten ist ein WLAN-Board wie der ESP32, das die Zeit per NTP holt und aus Breiten- und Längengrad den Sonnenuntergang des Tages berechnet. Zu dieser Zeit zieht das Board ein Relais an und schaltet das Licht ein, zur gewünschten Uhrzeit wieder aus. Einfacher ist ein Dämmerungsschalter mit LDR, den aber Wolken und Straßenlaternen täuschen können.
Holt der ESP32 die Sonnenuntergangszeit aus dem Internet?
Nein, aus dem Internet kommt per NTP nur die Uhrzeit. Den Sonnenuntergang berechnet er selbst mit den NOAA-Formeln, dafür reichen Tag des Jahres, Breiten- und Längengrad. Ein Wetterdienst oder API-Schlüssel ist also nicht nötig.
Läuft die Zeitschaltuhr weiter, wenn das Internet ausfällt?
Ja. Hat der ESP32 die Zeit einmal, zählt er mit seiner internen Uhr weiter, und die Abweichung bleibt meist bei wenigen Sekunden pro Tag. Kommt die Verbindung zurück, korrigiert NTP die Zeit. Startet der ESP32 aber neu, schaltet der Automatikmodus das Licht erst ein, wenn er wieder eine Uhrzeit hat.
Funktioniert ein Relaismodul mit den 3,3 V des ESP32?
Die meisten 5-V-Relaismodule lassen sich mit 3,3 V ansteuern, manche Optokoppler-Module, die bei LOW schalten, fallen bei 3,3 V HIGH aber nicht ganz ab. Dann hilft es, den JD-VCC-Jumper zu ziehen und das Modul getrennt zu versorgen, ein Modul mit 3,3-V-Ansteuerung zu kaufen oder einen NPN-Transistor dazwischenzuschalten.
Welches Relais eignet sich für Weihnachtsbeleuchtung im Freien?
Für Licht reicht ein mechanisches Relaismodul mit Optokoppler und Kontakten für 10 A 250 V AC; wer das Klicken nicht mag, nimmt ein Halbleiterrelais (SSR). In jedem Fall gehört die Platine in ein wasserdichtes Gehäuse und die Netzseite an einen Stromkreis mit FI-Schutzschalter.
Kann das Licht vor oder nach Sonnenuntergang angehen?
Ja. SUNSET_OFFSET_MIN im Code legt die Verschiebung in Minuten fest: −15 schaltet 15 Minuten vor Sonnenuntergang ein, 20 schaltet 20 Minuten danach ein. Da die Dämmerung etwa 30 Minuten dauert, sieht eine positive Verschiebung von 10–20 Minuten oft am schönsten aus.
Projekte, die du danach bauen kannst
Alle Projekte ansehen
ESP32: Echtzeit aus dem Internet per NTP
Der ESP32 verbindet sich mit dem WLAN und holt die Uhrzeit millisekundengenau von NTP-Servern (Network Time Protocol). Mit configTzTime() gilt automatisch die türkische Zeitzone (TRT, UTC+3); in Ländern mit Sommerzeit regelt ein POSIX-TZ-String die Umstellung (DST) von selbst. Die Uhrzeit erscheint im Serial Monitor und auf einem optionalen I2C-LCD.

ESP32 Async-Webserver (mit IP-Anzeige auf dem LCD)
Wir machen den ESP32 zu einem asynchronen Webserver, den du per Handy oder Computer im selben WLAN steuerst. Dank der Bibliothek ESPAsyncWebServer verarbeitet der Server mehrere Anfragen gleichzeitig (er blockiert nicht wie das klassische WebServer.h bei einer einzigen Anfrage). Öffne im Browser die IP-Adresse des ESP32 und schalte mit den Tasten ON/OFF (Adressen /on und /off) die LED an GPIO 5 ein und aus.

ESP32 Intelligente Beleuchtung (PIR + LDR + Relais + OLED)
Mit ESP32, PIR-Bewegungssensor, LDR-Lichtsensor und Relaismodul machen wir aus Flur, Bad oder Vorratskammer eine smarte Beleuchtung. Ist es hell, bleibt das Licht trotz Bewegung aus, so brennt es tagsüber nicht umsonst und spart Energie. Das Licht bleibt 30 Sekunden an; solange Bewegung erkannt wird, verlängert sich die Zeit automatisch.

ESP32 Nachtlicht mit LDR
Nachtlicht, bei dem die LED im Dunkeln automatisch ein- und im Hellen ausgeschaltet wird. Der D0-Pin (digital out) des LDR-Sensormoduls wird verwendet - die Dunkelschwelle wird mit dem kleinen Potentiometer am Modul eingestellt, das Modul selbst erzeugt den HIGH/LOW-Ausgang. ESP32 liest dieses Signal einfach mit digitalRead() aus, der Code ist sehr einfach.

Steuerung des ESP32 WS2812B NeoPixel-Streifens
WS2812B-LEDs (NeoPixel) sind adressierbare RGB-LEDs, die sich in Reihe über einen einzigen Datenpin steuern lassen. Wir steuern einen WS2812B-Streifen mit 8 LEDs über die Bibliothek Adafruit_NeoPixel und erzeugen eine flüssige Regenbogenanimation. Die 3,3-V-Logik des ESP32 klappt bei den meisten WS2812B; bei Instabilität hilft ein 470Ω-Serienwiderstand plus 1000µF-Kondensator. Die Animation verschiebt den Farbton im HSV-Farbraum.

ESP32-WLAN-STA-Verbindung (mit LCD-Display)
In diesem Projekt verbinden wir den ESP32 im Station-Modus (STA) sicher und fehlertolerant mit dem heimischen WLAN. Wir lagern SSID und Passwort in eine separate secrets.h-Datei aus, um Leaks zu Git zu verhindern, richten einen Auto-Reconnect-Mechanismus ein und zeigen RSSI-Signalpegel und IP-Adresse auf einem I2C-LCD-Display an. Die interne LED dient als Statusanzeige. Ein Verbindungsmanager auf Produktionsniveau.

ESP32 mDNS: Zugriff auf das Gerät über „bluegrays-esp.local“ (mit LCD-Display)
Wir ergänzen den ESP32 um einen mDNS-Dienst (Multicast DNS), damit du ihn statt über eine IP-Adresse unter einem lesbaren Hostnamen wie bluegrays-esp.local erreichst. Auch wenn sich die per DHCP vergebene IP ändert, bleibt der Name gleich. Ein kleiner Webserver auf dem Board lässt dich die LED im Browser unter http://bluegrays-esp.local/ steuern.

220V Glühbirne mit Druckknopf (Push)
Solange du den Knopf gedrückt hältst, leuchtet eine echte 220-Volt-Glühbirne, und sobald du loslässt, geht sie aus.
Weitere Artikel
BlueGrays-App
Diese Schaltung Schritt für Schritt auf dem Handy nachbauen
Schaltplan, Code und Teileliste auf einem Bildschirm. Über 500 Arduino-, ESP32- und Pico-Projekte zum Nachbauen.
Mit dem Handy scannen
Richte die Kamera auf den Code, dann öffnet sich der App-Store deines Handys.
oder im Store öffnen

