WetterCube Wiki - Benutzerbeiträge [de]

Hauptseite/en

2026-10-20T05:04:06Z

WetterCube: WetterCube Website

__NOTOC__ __NOEDITSECTION__
<div class="wc-sprachhinweis">[[Hauptseite|Deutsch]]</div>
<div class="wc-start-kopf">
<div class="wc-start-titel">Welcome to the WetterCube Wiki</div>
<div class="wc-start-unter">Guides, settings and help for all WetterCubes: weather, health and your home at a glance.</div>
</div>

<div class="wc-kacheln">
<div class="wc-kachel"><div class="wc-kachel-sym">🚀</div><div class="wc-kachel-titel">[[Fusion/Inbetriebnahme/en|Getting started]]</div>
Install the firmware, set up Wi-Fi, get going. The [https://wettercube.de/en/install/ web installers] flash the firmware straight from the browser.</div>
<div class="wc-kachel"><div class="wc-kachel-sym">📟</div><div class="wc-kachel-titel">[[Fusion/Start/en|WetterCube Fusion]]</div>
7-inch display, sensors, Home Assistant, airing, memory card.</div>
<div class="wc-kachel"><div class="wc-kachel-sym">🛏️</div><div class="wc-kachel-titel">[[Next/Start/en|WetterCube Next]]</div>
A display for every room: the additional module for the Fusion.</div>
<div class="wc-kachel"><div class="wc-kachel-sym">📱</div><div class="wc-kachel-titel">[[WetterCubePlus/Start/en|WetterCubePlus]]</div>
3.5-inch touch display, DWD warnings, pollen, rain radar, WetterAmpel.</div>
<div class="wc-kachel"><div class="wc-kachel-sym">🧊</div><div class="wc-kachel-titel">[[WetterCube/Start/en|WetterCube]]</div>
The first smart weather display: ESP32-C3 with a 1.54-inch display.</div>
<div class="wc-kachel"><div class="wc-kachel-sym">🌿</div><div class="wc-kachel-titel">[[Fusion/Sensoren/en|Sensors and airing]]</div>
MQTT, ESPHome, dew point and mould warning, [[Fusion/Lüften und Raumklima/en|airing traffic light]].</div>
<div class="wc-kachel"><div class="wc-kachel-sym">🔧</div><div class="wc-kachel-titel">[[Fusion/Diagnose und Fehlersuche/en|Help with problems]]</div>
Troubleshooting, log, [[Fusion/Wiederherstellung/en|recovery]].</div>
<div class="wc-kachel"><div class="wc-kachel-sym">🧩</div><div class="wc-kachel-titel">[https://wettercube.de/en/hardware/ Hardware and case]</div>
Which board do I need? Cases to print yourself.</div>
<div class="wc-kachel"><div class="wc-kachel-sym">🗺️</div><div class="wc-kachel-titel">[[Fusion/Roadmap/en|Roadmap]]</div>
What comes next? The whole family 2026 to 2027.</div>
</div>

<div class="wc-box">'''Why I do this:''' I am weather-sensitive and wanted the important information in one central place, tailored to me. '''Local instead of cloud:''' The web interfaces run on the devices themselves and are only reachable on the local Wi-Fi; there is no cloud requirement.</div>

<div class="wc-box">'''Updates and maintenance:''' The Fusion is the current spearhead; the Next is developed in parallel. The WetterCubePlus continues to receive updates, including new features as far as the device allows. The WetterCube only gets security updates when they are necessary.</div>

<div class="wc-box">'''At your own risk:''' You use the software and the guides on your own responsibility; I accept no liability for damage or consequences. You should roughly know what you are doing (flashing a board, setting up Wi-Fi, and with WetterCube and WetterCubePlus also crimping cables and soldering). If anything is unclear, please ask first: through the [https://wettercube.de/en/contact/ contact form] or on GitHub (issues). When flashing, you can usually not break much on an ESP32, the board can be flashed again at any time; real damage is more likely to come from wrong wiring or a wrong voltage. Weather data, warnings, pollen forecast and bio-weather are for information only and replace neither official warnings (e.g. NINA, DWD WarnWetter app) nor medical advice.</div>

<div class="wc-box">'''WetterCube is a software project.''' I provide the software (firmware); you build the device yourself: buy a board, flash the firmware, design a case to your own taste. I try to offer matching cases for the individual cubes. Short build guides are at [https://wettercube.de/en/build-guide/ Build guide].</div>

<div class="wc-box">'''Language and region:''' The WetterCube project is currently only available in German. Because the weather data for warnings, pollen forecast and bio-weather comes from the German Weather Service (DWD), it currently only works completely in Germany. A translation into English and weather information usable worldwide are planned, but there is no fixed date yet.</div>

<div class="wc-box">'''In development:''' Fusion and Next are still in development (alpha). Errors can occur with the current versions.</div>

== Status of the products ==
{| class="wikitable"
! Product !! Status !! Version
|-
| WetterCube Fusion || <span class="wc-status">In development</span> || v0.9.9-alpha7
|-
| WetterCube Next (module for the Fusion) || <span class="wc-status">In development</span> || v0.1.0-alpha5
|-
| WetterCubePlus || released || v1.8.1
|-
| WetterCube || released || v2.0.2
|}

<div class="wc-box">💙 '''Thanks to PicoPixel:''' The LVGL UI of the WetterCubes is created with [https://picopixel.io/ PicoPixel], a free, browser-based editor for LVGL. I am convinced by the project; this is not an advertisement or affiliate link, I earn nothing from it.</div>

== Where to find what ==
* '''[https://wettercube.de/en/ Homepage]:''' the family, roadmap, comparison, [https://wettercube.de/en/install/ install], [https://wettercube.de/en/hardware/ hardware and case]
* '''This wiki:''' all guides, organised by product (sidebar on the left)
* '''GitHub:''' [https://github.com/JPPeterson-lab/WetterCube-Fusion Fusion], [https://github.com/JPPeterson-lab/WetterCube-Next Next], [https://github.com/JPPeterson-lab/WetterCubePlus WetterCubePlus], [https://github.com/JPPeterson-lab/WetterCube WetterCube] (releases and bug reports)

<div class="wc-box">'''Open source.''' The source code of WetterCubePlus, Fusion and Next is under the Apache License 2.0, the WetterCube under the MIT licence: using, modifying and sharing is allowed, also commercially. '''My promise:''' private use of all WetterCubes (WetterCube, WetterCubePlus, Fusion and Next) stays free in the future. The free weather interface of Open-Meteo is meant for non-commercial use only. Questions and commissioned projects: [https://wettercube.de/en/contact/ Contact].</div>

[[Kategorie:Hauptseite]]

Hauptseite

2026-10-20T05:04:05Z

WetterCube: WetterCube Website

__NOTOC__ __NOEDITSECTION__
<div class="wc-sprachhinweis">[[Hauptseite/en|English]]</div>
<div class="wc-start-kopf">
<div class="wc-start-titel">Willkommen im WetterCube Wiki</div>
<div class="wc-start-unter">Anleitungen, Einstellungen und Hilfe für alle WetterCubes: Wetter, Gesundheit und dein Zuhause auf einen Blick.</div>
</div>

<div class="wc-kacheln">
<div class="wc-kachel"><div class="wc-kachel-sym">🚀</div><div class="wc-kachel-titel">[[Fusion/Inbetriebnahme|Erste Schritte]]</div>
Firmware installieren, WLAN einrichten, loslegen. Die [https://wettercube.de/installieren/ Web-Installer] spielen die Firmware direkt aus dem Browser auf das Board.</div>
<div class="wc-kachel"><div class="wc-kachel-sym">📟</div><div class="wc-kachel-titel">[[Fusion/Start|WetterCube Fusion]]</div>
7-Zoll-Display, Sensoren, Home Assistant, Lüften, Speicherkarte.</div>
<div class="wc-kachel"><div class="wc-kachel-sym">🛏️</div><div class="wc-kachel-titel">[[Next/Start|WetterCube Next]]</div>
Ein Display für jeden Raum: das Zusatzmodul zum Fusion.</div>
<div class="wc-kachel"><div class="wc-kachel-sym">📱</div><div class="wc-kachel-titel">[[WetterCubePlus/Start|WetterCubePlus]]</div>
3,5-Zoll-Touchdisplay, DWD-Warnungen, Pollen, Regenradar, WetterAmpel.</div>
<div class="wc-kachel"><div class="wc-kachel-sym">🧊</div><div class="wc-kachel-titel">[[WetterCube/Start|WetterCube]]</div>
Das erste smarte Wetterdisplay: ESP32-C3 mit 1,54-Zoll-Display.</div>
<div class="wc-kachel"><div class="wc-kachel-sym">🌿</div><div class="wc-kachel-titel">[[Fusion/Sensoren|Sensoren und Lüften]]</div>
MQTT, ESPHome, Taupunkt und Schimmelwarnung, [[Fusion/Lüften und Raumklima|Lüften-Ampel]].</div>
<div class="wc-kachel"><div class="wc-kachel-sym">🔧</div><div class="wc-kachel-titel">[[Fusion/Diagnose und Fehlersuche|Hilfe bei Problemen]]</div>
Fehlersuche, Protokoll, [[Fusion/Wiederherstellung|Wiederherstellung]].</div>
<div class="wc-kachel"><div class="wc-kachel-sym">🧩</div><div class="wc-kachel-titel">[https://wettercube.de/hardware/ Hardware und Gehäuse]</div>
Welches Board brauche ich? Gehäuse zum Selbstdrucken.</div>
<div class="wc-kachel"><div class="wc-kachel-sym">🗺️</div><div class="wc-kachel-titel">[[Fusion/Roadmap|Roadmap]]</div>
Was kommt als Nächstes? Die ganze Familie 2026 bis 2027.</div>
</div>

<div class="wc-box">'''Warum ich das mache:''' Ich bin wetterfühlig und wollte die wichtigen Informationen zentral an einem Ort haben, zugeschnitten auf mich. '''Lokal statt Cloud:''' Die Web-Oberflächen laufen auf den Geräten selbst und sind nur im lokalen WLAN erreichbar; einen Cloud-Zwang gibt es nicht.</div>

<div class="wc-box">'''Updates und Pflege:''' Der Fusion ist die aktuelle Speerspitze; der Next wird parallel entwickelt. Der WetterCubePlus wird weiterhin mit Updates versorgt, auch mit neuen Funktionen, soweit es die Möglichkeiten des Geräts zulassen. Der WetterCube bekommt nur noch Sicherheitsupdates, wenn sie nötig sind.</div>

<div class="wc-box">'''Auf eigene Gefahr:''' Software und Anleitungen setzt du auf eigene Verantwortung ein, für Schäden oder Folgen übernehme ich keine Haftung. Du solltest grob wissen, was du tust (Board flashen, WLAN einrichten, bei WetterCube und WetterCubePlus auch Kabel crimpen und löten). Bei Unklarheiten frag lieber nach: über das [https://wettercube.de/kontakt/ Kontaktformular] oder auf GitHub (Issues). Beim Flashen kann man bei einem ESP32 in aller Regel nicht viel kaputt machen, das Board lässt sich jederzeit neu flashen; echte Schäden entstehen eher durch falsche Verkabelung oder eine falsche Spannung. Wetterdaten, Warnungen, Pollenflug und Biowetter dienen nur der Information und ersetzen weder amtliche Warnungen (z. B. NINA, WarnWetter-App des DWD) noch ärztlichen Rat.</div>

<div class="wc-box">'''WetterCube ist ein Softwareprojekt.''' Ich stelle die Software (Firmware) bereit; das Gerät baust du selbst: Board kaufen, Firmware aufspielen, ein Gehäuse nach deinem Geschmack gestalten. Ich versuche, zu den einzelnen Cubes passende Gehäuse anzubieten. Kurzanleitungen zum Bau gibt es unter [https://wettercube.de/bauanleitung/ Bauanleitung].</div>

<div class="wc-box">'''Sprache und Region:''' Das WetterCube-Projekt gibt es derzeit nur auf Deutsch. Weil die Wetterdaten für Warnungen, Pollenflug und Biowetter vom Deutschen Wetterdienst (DWD) kommen, funktioniert es derzeit auch nur in Deutschland vollständig. Geplant sind eine Übersetzung ins Englische und weltweit nutzbare Wetterinfos, einen festen Termin gibt es noch nicht.</div>

<div class="wc-box">'''In Entwicklung:''' Fusion und Next sind noch in Entwicklung (Alpha). Mit den aktuellen Versionen können Fehler auftreten.</div>

== Stand der Produkte ==
{| class="wikitable"
! Produkt !! Stand !! Version
|-
| WetterCube Fusion || <span class="wc-status">In Entwicklung</span> || v0.9.9-alpha7
|-
| WetterCube Next (Modul zum Fusion) || <span class="wc-status">In Entwicklung</span> || v0.1.0-alpha5
|-
| WetterCubePlus || veröffentlicht || v1.8.1
|-
| WetterCube || veröffentlicht || v2.0.2
|}

<div class="wc-box">💙 '''Danke an PicoPixel:''' Die LVGL-UI der WetterCubes wird mit [https://picopixel.io/de/ PicoPixel] erstellt, einem kostenlosen, browserbasierten Editor für LVGL. Ich bin von dem Projekt überzeugt; das ist kein Werbe- oder Affiliate-Link, ich verdiene nichts daran.</div>

== Wo gibt es was? ==
* '''[https://wettercube.de/ Homepage]:''' die Familie, Roadmap, Vergleich, [https://wettercube.de/installieren/ Installieren], [https://wettercube.de/hardware/ Hardware und Gehäuse]
* '''Dieses Wiki:''' alle Anleitungen, nach Produkt gegliedert (Seitenleiste links)
* '''GitHub:''' [https://github.com/JPPeterson-lab/WetterCube-Fusion Fusion], [https://github.com/JPPeterson-lab/WetterCube-Next Next], [https://github.com/JPPeterson-lab/WetterCubePlus WetterCubePlus], [https://github.com/JPPeterson-lab/WetterCube WetterCube] (Releases und Fehlermeldungen)

<div class="wc-box">'''Open Source.''' Der Quellcode von WetterCubePlus, Fusion und Next steht unter der Apache-Lizenz 2.0, der WetterCube unter der MIT-Lizenz: nutzen, verändern und weitergeben ist erlaubt, auch kommerziell. '''Mein Versprechen:''' Die private Nutzung aller WetterCubes (WetterCube, WetterCubePlus, Fusion und Next) bleibt auch in Zukunft frei. Die kostenlose Wetter-Schnittstelle von Open-Meteo ist nur für nicht-kommerzielle Nutzung gedacht. Fragen und Auftragsprojekte: [https://wettercube.de/kontakt/ Kontakt].</div>

[[Kategorie:Hauptseite]]

MediaWiki:Common.css

2026-10-20T04:40:55Z

WetterCube: WetterCube Website

/* WetterCube Wiki: Design wie wettercube.de (hell: weiß, Himmelblau, Orange, Navy). Als MediaWiki:Common.css einspielen. */
@font-face{font-family:"Montserrat";font-style:normal;font-weight:100 900;font-display:swap;src:url("/images/fonts/montserrat-latin-wght-normal.woff2") format("woff2");unicode-range:U+0000-00FF,U+0131,U+0152-0153,U+02BB-02BC,U+02C6,U+02DA,U+02DC,U+2000-206F,U+20AC,U+2122,U+2191,U+2193,U+2212,U+2215}
@font-face{font-family:"Montserrat";font-style:normal;font-weight:100 900;font-display:swap;src:url("/images/fonts/montserrat-latin-ext-wght-normal.woff2") format("woff2");unicode-range:U+0100-02BA,U+02BD-02C5,U+02C7-02CC,U+02CE-02D7,U+02DD-02FF,U+1E00-1E9F,U+1EF2-1EFF,U+2020,U+20A0-20AB,U+20AD-20C0,U+2113,U+2C60-2C7F,U+A720-A7FF}
:root{--wc-himmel:#87ceeb;--wc-himmel-dunkel:#2b7fa3;--wc-kachel:#e0f7ff;--wc-flaeche:#f5fbfe;--wc-rand:#b9d6e4;--wc-text2:#4b5563;--wc-orange:#ce4b11;--wc-navy:#0b2545}
body,.mw-body,.mw-body-content,.vector-body,#mw-content-text,input,textarea,select,button{font-family:"Montserrat","Avenir Next","Segoe UI",system-ui,sans-serif}
body{background:#fff;color:#111827}
a{color:var(--wc-himmel-dunkel)}a:visited{color:#5a6fa0}a.new{color:var(--wc-orange)}
.mw-body h1,.mw-body-content h1,.mw-body-content h2,.mw-body-content h3,.mw-body-content h4,.mw-first-heading,.vector-body h1,.vector-body h2,.vector-body h3{font-family:"Montserrat","Avenir Next",system-ui,sans-serif;font-weight:600;letter-spacing:-.4px;color:#111827}
.mw-body h1,.mw-first-heading{font-size:2rem;border-bottom:3px solid var(--wc-himmel);padding-bottom:.25em}
.mw-body-content h2{border-bottom:1px solid var(--wc-rand);padding-bottom:.2em}
/* Kopf und Seitenleiste */
.vector-header-container,#mw-head,#mw-page-base{background:var(--wc-navy)!important}
.vector-header-container .vector-user-links a,.vector-header-container a,#mw-head a,#p-personal a,#mw-head .vector-menu-heading{color:#1d5f80!important}
.mw-logo-wordmark,.mw-logo-tagline{color:#fff}
.vector-search-box-input{border-radius:10px}
.vector-menu-portal .vector-menu-heading,#mw-panel .portal h3{color:var(--wc-himmel-dunkel);font-weight:700;letter-spacing:.08em;text-transform:uppercase;font-size:.72rem}
/* Tabellen */
.wikitable{border:1px solid var(--wc-rand);border-collapse:collapse;border-radius:10px;overflow:hidden;background:#fff}
.wikitable>*>tr>th{background:var(--wc-kachel);color:#0b2545;border:1px solid var(--wc-rand)}
.wikitable>*>tr>td{border:1px solid var(--wc-rand)}
/* Code */
code,pre,.mw-code{background:var(--wc-flaeche);border:1px solid #dcebf2;border-radius:6px}
code{padding:.05em .35em}pre{padding:.8em 1em}
/* Hinweisboxen */
.wc-box{margin:1em 0;border:1px solid var(--wc-rand);border-left:5px solid var(--wc-himmel);border-radius:10px;padding:.8em 1.1em;background:var(--wc-flaeche)}
.wc-warn{margin:1em 0;border:1px solid #f1c9b6;border-left:5px solid var(--wc-orange);border-radius:10px;padding:.8em 1.1em;background:#fff7f2}
.wc-sprachhinweis{float:right;font-size:.85rem;border:1px solid var(--wc-rand);border-radius:999px;padding:.15em .8em;background:#fff;margin-left:1em}
.wc-status{display:inline-block;font-size:.75rem;font-weight:700;padding:.1em .7em;border-radius:999px;background:var(--wc-himmel);color:#06324a}
/* Hauptseite */
.wc-start-kopf{background:linear-gradient(180deg,var(--wc-kachel),#fff);border-radius:18px;padding:1.6em 1.8em;margin-bottom:1.4em}
.wc-start-titel{font-size:2.1rem;font-weight:600;letter-spacing:-.8px;line-height:1.15}
.wc-start-unter{color:var(--wc-text2);font-size:1.1rem;margin-top:.3em}
.wc-kacheln{display:grid;grid-template-columns:repeat(3,1fr);gap:14px;margin:1em 0 1.6em}
.wc-kachel{background:var(--wc-kachel);border:1px solid var(--wc-rand);border-radius:16px;padding:1em 1.1em}
.wc-kachel-sym{font-size:1.7rem;line-height:1.2}
.wc-kachel-titel{font-weight:600;font-size:1.1rem;margin:.2em 0 .25em}
.wc-kachel-titel a{text-decoration:none}
.wc-kachel p{margin:.2em 0;color:var(--wc-text2);font-size:.92rem}
@media(max-width:900px){.wc-kacheln{grid-template-columns:1fr}.wc-sprachhinweis{float:none;display:inline-block;margin:0 0 .6em}}
.mw-footer,#footer{color:var(--wc-text2)}

Hauptseite

2026-10-20T04:40:53Z

WetterCube: WetterCube Website

__NOTOC__ __NOEDITSECTION__
<div class="wc-sprachhinweis">[[Hauptseite/en|English]]</div>
<div class="wc-start-kopf">
<div class="wc-start-titel">Willkommen im WetterCube Wiki</div>
<div class="wc-start-unter">Anleitungen, Einstellungen und Hilfe für alle WetterCubes: Wetter, Gesundheit und dein Zuhause auf einen Blick.</div>
</div>

<div class="wc-kacheln">
<div class="wc-kachel"><div class="wc-kachel-sym">🚀</div><div class="wc-kachel-titel">[[Fusion/Inbetriebnahme|Erste Schritte]]</div>
Firmware installieren, WLAN einrichten, loslegen. Die [https://wettercube.de/installieren/ Web-Installer] spielen die Firmware direkt aus dem Browser auf das Board.</div>
<div class="wc-kachel"><div class="wc-kachel-sym">📟</div><div class="wc-kachel-titel">[[Fusion/Start|WetterCube Fusion]]</div>
7-Zoll-Display, Sensoren, Home Assistant, Lüften, Speicherkarte.</div>
<div class="wc-kachel"><div class="wc-kachel-sym">🛏️</div><div class="wc-kachel-titel">[[Next/Start|WetterCube Next]]</div>
Ein Display für jeden Raum: das Zusatzmodul zum Fusion.</div>
<div class="wc-kachel"><div class="wc-kachel-sym">📱</div><div class="wc-kachel-titel">[[WetterCubePlus/Start|WetterCubePlus]]</div>
3,5-Zoll-Touchdisplay, DWD-Warnungen, Pollen, Regenradar, WetterAmpel.</div>
<div class="wc-kachel"><div class="wc-kachel-sym">🧊</div><div class="wc-kachel-titel">[[WetterCube/Start|WetterCube]]</div>
Das erste smarte Wetterdisplay: ESP32-C3 mit 1,54-Zoll-Display.</div>
<div class="wc-kachel"><div class="wc-kachel-sym">🌿</div><div class="wc-kachel-titel">[[Fusion/Sensoren|Sensoren und Lüften]]</div>
MQTT, ESPHome, Taupunkt und Schimmelwarnung, [[Fusion/Lüften und Raumklima|Lüften-Ampel]].</div>
<div class="wc-kachel"><div class="wc-kachel-sym">🔧</div><div class="wc-kachel-titel">[[Fusion/Diagnose und Fehlersuche|Hilfe bei Problemen]]</div>
Fehlersuche, Protokoll, [[Fusion/Wiederherstellung|Wiederherstellung]].</div>
<div class="wc-kachel"><div class="wc-kachel-sym">🧩</div><div class="wc-kachel-titel">[https://wettercube.de/hardware/ Hardware und Gehäuse]</div>
Welches Board brauche ich? Gehäuse zum Selbstdrucken.</div>
<div class="wc-kachel"><div class="wc-kachel-sym">🗺️</div><div class="wc-kachel-titel">[[Fusion/Roadmap|Roadmap]]</div>
Was kommt als Nächstes? Die ganze Familie 2026 bis 2027.</div>
</div>

<div class="wc-box">'''Warum ich das mache:''' Ich bin wetterfühlig und wollte die wichtigen Informationen zentral an einem Ort haben, zugeschnitten auf mich. '''Lokal statt Cloud:''' Die Web-Oberflächen laufen auf den Geräten selbst und sind nur im lokalen WLAN erreichbar; einen Cloud-Zwang gibt es nicht. Google muss nicht wissen, wie warm es gerade in meinem Schlafzimmer ist.</div>

<div class="wc-box">'''Updates und Pflege:''' Der Fusion ist die aktuelle Speerspitze; der Next wird parallel entwickelt. Der WetterCubePlus wird weiterhin mit Updates versorgt, auch mit neuen Funktionen, soweit es die Möglichkeiten des Geräts zulassen. Der WetterCube bekommt nur noch Sicherheitsupdates, wenn sie nötig sind.</div>

<div class="wc-box">'''Auf eigene Gefahr:''' Software und Anleitungen setzt du auf eigene Verantwortung ein, für Schäden oder Folgen übernehme ich keine Haftung. Du solltest grob wissen, was du tust (Board flashen, WLAN einrichten, bei WetterCube und WetterCubePlus auch Kabel crimpen und löten). Bei Unklarheiten frag lieber nach: über das [https://wettercube.de/kontakt/ Kontaktformular] oder auf GitHub (Issues). Beim Flashen kann man bei einem ESP32 in aller Regel nicht viel kaputt machen, das Board lässt sich jederzeit neu flashen; echte Schäden entstehen eher durch falsche Verkabelung oder eine falsche Spannung. Wetterdaten, Warnungen, Pollenflug und Biowetter dienen nur der Information und ersetzen weder amtliche Warnungen (z. B. NINA, WarnWetter-App des DWD) noch ärztlichen Rat.</div>

<div class="wc-box">'''WetterCube ist ein Softwareprojekt.''' Ich stelle die Software (Firmware) bereit; das Gerät baust du selbst: Board kaufen, Firmware aufspielen, ein Gehäuse nach deinem Geschmack gestalten. Ich versuche, zu den einzelnen Cubes passende Gehäuse anzubieten. Kurzanleitungen zum Bau gibt es unter [https://wettercube.de/bauanleitung/ Bauanleitung].</div>

<div class="wc-box">'''Sprache und Region:''' Das WetterCube-Projekt gibt es derzeit nur auf Deutsch. Weil die Wetterdaten für Warnungen, Pollenflug und Biowetter vom Deutschen Wetterdienst (DWD) kommen, funktioniert es derzeit auch nur in Deutschland vollständig. Geplant sind eine Übersetzung ins Englische und weltweit nutzbare Wetterinfos, einen festen Termin gibt es noch nicht.</div>

<div class="wc-box">'''In Entwicklung:''' Fusion und Next sind noch in Entwicklung (Alpha). Mit den aktuellen Versionen können Fehler auftreten.</div>

== Stand der Produkte ==
{| class="wikitable"
! Produkt !! Stand !! Version
|-
| WetterCube Fusion || <span class="wc-status">In Entwicklung</span> || v0.9.9-alpha7
|-
| WetterCube Next (Modul zum Fusion) || <span class="wc-status">In Entwicklung</span> || v0.1.0-alpha5
|-
| WetterCubePlus || veröffentlicht || v1.8.1
|-
| WetterCube || veröffentlicht || v2.0.2
|}

<div class="wc-box">💙 '''Danke an PicoPixel:''' Die LVGL-UI der WetterCubes wird mit [https://picopixel.io/de/ PicoPixel] erstellt, einem kostenlosen, browserbasierten Editor für LVGL. Ich bin von dem Projekt überzeugt; das ist kein Werbe- oder Affiliate-Link, ich verdiene nichts daran.</div>

== Wo gibt es was? ==
* '''[https://wettercube.de/ Homepage]:''' die Familie, Roadmap, Vergleich, [https://wettercube.de/installieren/ Installieren], [https://wettercube.de/hardware/ Hardware und Gehäuse]
* '''Dieses Wiki:''' alle Anleitungen, nach Produkt gegliedert (Seitenleiste links)
* '''GitHub:''' [https://github.com/JPPeterson-lab/WetterCube-Fusion Fusion], [https://github.com/JPPeterson-lab/WetterCube-Next Next], [https://github.com/JPPeterson-lab/WetterCubePlus WetterCubePlus], [https://github.com/JPPeterson-lab/WetterCube WetterCube] (Releases und Fehlermeldungen)

<div class="wc-box">'''Open Source.''' Der Quellcode von WetterCubePlus, Fusion und Next steht unter der Apache-Lizenz 2.0, der WetterCube unter der MIT-Lizenz: nutzen, verändern und weitergeben ist erlaubt, auch kommerziell. '''Mein Versprechen:''' Die private Nutzung aller WetterCubes (WetterCube, WetterCubePlus, Fusion und Next) bleibt auch in Zukunft frei. Die kostenlose Wetter-Schnittstelle von Open-Meteo ist nur für nicht-kommerzielle Nutzung gedacht. Fragen und Auftragsprojekte: [https://wettercube.de/kontakt/ Kontakt].</div>

[[Kategorie:Hauptseite]]

WetterCube/Hardware/en

2026-10-19T20:25:31Z

WetterCube: WetterCube Website

<div class="wc-sprachhinweis">Dies ist die englische Fassung. [[WetterCube/Hardware|Zur deutschen Fassung]]</div>

----

<div class="wc-box">'''⚠️ Power and safety:''' Only run the device with a tested power supply of the stated voltage and pay attention to correct wiring; mistakes can destroy parts or cause heat. Do not use for safety-critical purposes. You act at your own risk, see the [https://wettercube.de/en/usage-notes/ usage notes].</div>

'''Note on assembly:''' The WetterCube is aimed at people with some knowledge of electronics: during assembly, cables have to be crimped and parts soldered. If you do not want that, the [https://github.com/JPPeterson-lab/WetterCube-Fusion WetterCube Fusion] is the better choice. That is why, for the newer devices (Fusion and Next), I rely on complete boards with an integrated display: building is easy even for people who know nothing about wiring up an ESP32 and the like.

== Components ==

{| class="wikitable"
! Component !! Type
|-
| Microcontroller || '''ESP32-C3 Super Mini'''
|-
| Display || '''ST7789''', 1.54", '''240×240 px''', SPI
|-
| Button || '''TTP223''' (capacitive touch sensor)
|-
| Case || [https://makerworld.com/de/models/2501721-simple-print-monitor-st7789-1-54-display-case#profileId-2750174 Simple Print Monitor – ST7789 1.54" Display Case] by [https://github.com/Keralots Keralots] (3D print, Bambu Makerworld)
|}

== Pin assignment (ESP32-C3) ==

{| class="wikitable"
! Function !! GPIO
|-
| TFT MOSI (SPI) || 20
|-
| TFT SCLK (SPI) || 21
|-
| TFT CS || 6
|-
| TFT DC || 7
|-
| TFT RST || 10
|-
| TFT backlight || 5
|-
| Touch button (TTP223) || 3
|}

The backlight is regulated with PWM (5 kHz, 8 bit), which makes brightness, dimming and night mode possible. The wiring diagram is shown right below.

[[Datei:wc-wettercube-wettercube-kabeldiagramm-a20a69.png|center|700px|Wiring diagram: display, ESP32-C3 Super Mini and touch sensor (TTP223).]]
== Assembly in the case ==

[[Datei:wc-wettercube-wettercube-aufbau-06596d.jpg|center|700px|What the assembly can look like: display in the case, ESP32-C3 Super Mini in the lid, the touch button (red board) glued in on the left of the case.]]
'''Tip:''' Glue the touch button (TTP223) to the inside of the top of the case, for example with some liquid electrical tape or silicone.

== Power supply ==

The ESP32-C3 Super Mini is powered via '''USB-C'''; an ordinary 5 V USB supply is sufficient. A very thin or long cable can cause dropouts when transmitting over Wi-Fi.

== Notes ==

* Output in the serial monitor (115200 baud) comes via the board's USB port. In normal operation the [[WetterCube/Diagnose und Fehlersuche/en|<code>/log</code>]] in the browser is enough, no USB cable needed.
* The cube has a single button and no touchscreen. Operation: [[WetterCube/Screens und Funktionen/en|Screens and features]].

[[Kategorie:Next]]
[[Kategorie:English]]

WetterCube/Hardware

2026-10-19T20:25:30Z

WetterCube: WetterCube Website

<div class="wc-sprachhinweis">[[WetterCube/Hardware/en|English version]]</div>

----

<div class="wc-box">'''⚠️ Strom und Sicherheit:''' Betreibe das Gerät nur mit einem geprüften Netzteil in der angegebenen Spannung und achte auf die richtige Verkabelung; Fehler können Bauteile zerstören oder zu Hitze führen. Nicht für sicherheitskritische Zwecke einsetzen. Du handelst auf eigene Gefahr, siehe die [https://wettercube.de/nutzungshinweise/ Nutzungshinweise].</div>

'''Hinweis zum Aufbau:''' Der WetterCube richtet sich an Leute mit etwas Elektronik-Kenntnis: Beim Aufbau müssen Kabel gecrimpt und Bauteile gelötet werden. Wer das nicht möchte, ist mit dem [https://github.com/JPPeterson-lab/WetterCube-Fusion WetterCube Fusion] besser bedient. Bei den neueren Geräten (Fusion und Next) setze ich deshalb auf komplette Boards mit integriertem Display: Der Bau ist so auch für Leute einfach, die sich mit dem Verkabeln von ESP32 und Co. nicht auskennen.

== Bauteile ==

{| class="wikitable"
! Komponente !! Typ
|-
| Mikrocontroller || '''ESP32-C3 Super Mini'''
|-
| Display || '''ST7789''', 1,54", '''240×240 px''', SPI
|-
| Taste || '''TTP223''' (kapazitiver Touch-Sensor)
|-
| Gehäuse || [https://makerworld.com/de/models/2501721-simple-print-monitor-st7789-1-54-display-case#profileId-2750174 Simple Print Monitor – ST7789 1.54" Display Case] von [https://github.com/Keralots Keralots] (3D-Druck, Bambu Makerworld)
|}

== Pinbelegung (ESP32-C3) ==

{| class="wikitable"
! Funktion !! GPIO
|-
| TFT MOSI (SPI) || 20
|-
| TFT SCLK (SPI) || 21
|-
| TFT CS || 6
|-
| TFT DC || 7
|-
| TFT RST || 10
|-
| TFT Backlight || 5
|-
| Touch-Taste (TTP223) || 3
|}

Das Backlight wird per PWM (5 kHz, 8 Bit) geregelt, so lassen sich Helligkeit, Dimmen und Nachtmodus umsetzen. Das Kabeldiagramm steht direkt darunter.

[[Datei:wc-wettercube-wettercube-kabeldiagramm-a20a69.png|center|700px|Kabeldiagramm: Display, ESP32-C3 Super Mini und Touch-Sensor (TTP223).]]
== Aufbau im Gehäuse ==

[[Datei:wc-wettercube-wettercube-aufbau-06596d.jpg|center|700px|So kann der Aufbau aussehen: Display im Gehäuse, ESP32-C3 Super Mini im Deckel, der Touch-Taster (rote Platine) links im Gehäuse eingeklebt.]]
'''Tipp:''' Den Touch-Taster (TTP223) klebst du von innen an die Oberseite des Gehäuses, zum Beispiel mit etwas Flüssigisolierband oder Silikon.

== Stromversorgung ==

Der ESP32-C3 Super Mini wird über '''USB-C''' versorgt, ein normales 5-V-USB-Netzteil genügt. Ein sehr dünnes oder langes Kabel kann beim WLAN-Senden zu Aussetzern führen.

== Hinweise ==

* Ausgaben im Seriellen Monitor (115200 Baud) kommen über den USB-Port des Boards. Im Normalbetrieb genügt das [[WetterCube/Diagnose und Fehlersuche|<code>/log</code>]] im Browser, ohne USB-Kabel.
* Der Cube hat nur eine Taste und keinen Touchscreen. Bedienung: [[WetterCube/Screens und Funktionen|Screens und Funktionen]].

[[Kategorie:Next]]

Datei:Wc-wettercube-wettercube-kabeldiagramm-a20a69.png

2026-10-19T20:24:13Z

WetterCube: == Beschreibung == Bilder fuer das Wiki

== Beschreibung ==
Bilder fuer das Wiki

WetterCube/Hardware/en

2026-10-19T20:17:59Z

WetterCube: WetterCube Website

<div class="wc-sprachhinweis">Dies ist die englische Fassung. [[WetterCube/Hardware|Zur deutschen Fassung]]</div>

----

<div class="wc-box">'''⚠️ Power and safety:''' Only run the device with a tested power supply of the stated voltage and pay attention to correct wiring; mistakes can destroy parts or cause heat. Do not use for safety-critical purposes. You act at your own risk, see the [https://wettercube.de/en/usage-notes/ usage notes].</div>

'''Note on assembly:''' The WetterCube is aimed at people with some knowledge of electronics: during assembly, cables have to be crimped and parts soldered. If you do not want that, the [https://github.com/JPPeterson-lab/WetterCube-Fusion WetterCube Fusion] is the better choice. That is why, for the newer devices (Fusion and Next), I rely on complete boards with an integrated display: building is easy even for people who know nothing about wiring up an ESP32 and the like.

== Components ==

{| class="wikitable"
! Component !! Type
|-
| Microcontroller || '''ESP32-C3 Super Mini'''
|-
| Display || '''ST7789''', 1.54", '''240×240 px''', SPI
|-
| Button || '''TTP223''' (capacitive touch sensor)
|-
| Case || [https://makerworld.com/de/models/2501721-simple-print-monitor-st7789-1-54-display-case#profileId-2750174 Simple Print Monitor – ST7789 1.54" Display Case] by [https://github.com/Keralots Keralots] (3D print, Bambu Makerworld)
|}

== Pin assignment (ESP32-C3) ==

{| class="wikitable"
! Function !! GPIO
|-
| TFT MOSI (SPI) || 20
|-
| TFT SCLK (SPI) || 21
|-
| TFT CS || 6
|-
| TFT DC || 7
|-
| TFT RST || 10
|-
| TFT backlight || 5
|-
| Touch button (TTP223) || 3
|}

The backlight is regulated with PWM (5 kHz, 8 bit), which makes brightness, dimming and night mode possible. A wiring diagram is in the [https://github.com/JPPeterson-lab/WetterCube#kabeldiagramm README].

== Assembly in the case ==

[[Datei:wc-wettercube-wettercube-aufbau-06596d.jpg|center|700px|What the assembly can look like: display in the case, ESP32-C3 Super Mini in the lid, the touch button (red board) glued in on the left of the case.]]
'''Tip:''' Glue the touch button (TTP223) to the inside of the top of the case, for example with some liquid electrical tape or silicone.

== Power supply ==

The ESP32-C3 Super Mini is powered via '''USB-C'''; an ordinary 5 V USB supply is sufficient. A very thin or long cable can cause dropouts when transmitting over Wi-Fi.

== Notes ==

* Output in the serial monitor (115200 baud) comes via the board's USB port. In normal operation the [[WetterCube/Diagnose und Fehlersuche/en|<code>/log</code>]] in the browser is enough, no USB cable needed.
* The cube has a single button and no touchscreen. Operation: [[WetterCube/Screens und Funktionen/en|Screens and features]].

[[Kategorie:Next]]
[[Kategorie:English]]

WetterCube/Hardware

2026-10-19T20:17:57Z

WetterCube: WetterCube Website

<div class="wc-sprachhinweis">[[WetterCube/Hardware/en|English version]]</div>

----

<div class="wc-box">'''⚠️ Strom und Sicherheit:''' Betreibe das Gerät nur mit einem geprüften Netzteil in der angegebenen Spannung und achte auf die richtige Verkabelung; Fehler können Bauteile zerstören oder zu Hitze führen. Nicht für sicherheitskritische Zwecke einsetzen. Du handelst auf eigene Gefahr, siehe die [https://wettercube.de/nutzungshinweise/ Nutzungshinweise].</div>

'''Hinweis zum Aufbau:''' Der WetterCube richtet sich an Leute mit etwas Elektronik-Kenntnis: Beim Aufbau müssen Kabel gecrimpt und Bauteile gelötet werden. Wer das nicht möchte, ist mit dem [https://github.com/JPPeterson-lab/WetterCube-Fusion WetterCube Fusion] besser bedient. Bei den neueren Geräten (Fusion und Next) setze ich deshalb auf komplette Boards mit integriertem Display: Der Bau ist so auch für Leute einfach, die sich mit dem Verkabeln von ESP32 und Co. nicht auskennen.

== Bauteile ==

{| class="wikitable"
! Komponente !! Typ
|-
| Mikrocontroller || '''ESP32-C3 Super Mini'''
|-
| Display || '''ST7789''', 1,54", '''240×240 px''', SPI
|-
| Taste || '''TTP223''' (kapazitiver Touch-Sensor)
|-
| Gehäuse || [https://makerworld.com/de/models/2501721-simple-print-monitor-st7789-1-54-display-case#profileId-2750174 Simple Print Monitor – ST7789 1.54" Display Case] von [https://github.com/Keralots Keralots] (3D-Druck, Bambu Makerworld)
|}

== Pinbelegung (ESP32-C3) ==

{| class="wikitable"
! Funktion !! GPIO
|-
| TFT MOSI (SPI) || 20
|-
| TFT SCLK (SPI) || 21
|-
| TFT CS || 6
|-
| TFT DC || 7
|-
| TFT RST || 10
|-
| TFT Backlight || 5
|-
| Touch-Taste (TTP223) || 3
|}

Das Backlight wird per PWM (5 kHz, 8 Bit) geregelt, so lassen sich Helligkeit, Dimmen und Nachtmodus umsetzen. Ein Kabeldiagramm steht in der [https://github.com/JPPeterson-lab/WetterCube#kabeldiagramm README].

== Aufbau im Gehäuse ==

[[Datei:wc-wettercube-wettercube-aufbau-06596d.jpg|center|700px|So kann der Aufbau aussehen: Display im Gehäuse, ESP32-C3 Super Mini im Deckel, der Touch-Taster (rote Platine) links im Gehäuse eingeklebt.]]
'''Tipp:''' Den Touch-Taster (TTP223) klebst du von innen an die Oberseite des Gehäuses, zum Beispiel mit etwas Flüssigisolierband oder Silikon.

== Stromversorgung ==

Der ESP32-C3 Super Mini wird über '''USB-C''' versorgt, ein normales 5-V-USB-Netzteil genügt. Ein sehr dünnes oder langes Kabel kann beim WLAN-Senden zu Aussetzern führen.

== Hinweise ==

* Ausgaben im Seriellen Monitor (115200 Baud) kommen über den USB-Port des Boards. Im Normalbetrieb genügt das [[WetterCube/Diagnose und Fehlersuche|<code>/log</code>]] im Browser, ohne USB-Kabel.
* Der Cube hat nur eine Taste und keinen Touchscreen. Bedienung: [[WetterCube/Screens und Funktionen|Screens und Funktionen]].

[[Kategorie:Next]]

WetterCubePlus/Hardware und Verkabelung/en

2026-10-19T20:17:41Z

WetterCube: WetterCube Website

<div class="wc-sprachhinweis">Dies ist die englische Fassung. [[WetterCubePlus/Hardware und Verkabelung|Zur deutschen Fassung]]</div>

----

<div class="wc-box">'''⚠️ Power and safety:''' Only run the device with a tested power supply of the stated voltage and pay attention to correct wiring; mistakes can destroy parts or cause heat. Do not use for safety-critical purposes. You act at your own risk, see the [https://wettercube.de/en/usage-notes/ usage notes].</div>

'''Note on assembly:''' The WetterCubePlus is aimed at people with some knowledge of electronics: during assembly, cables have to be crimped and parts soldered. If you do not want that, the [https://github.com/JPPeterson-lab/WetterCube-Fusion WetterCube Fusion] is the better choice. That is why, for the newer devices (Fusion and Next), I rely on complete boards with an integrated display: building is easy even for people who know nothing about wiring up an ESP32 and the like.

== Parts ==

{| class="wikitable"
! Component !! Type
|-
| Microcontroller || ESP32-S3 '''N16R8''' (16 MB flash, 8 MB OPI PSRAM)
|-
| Display || ILI9488, 3.5", 480×320 pixels, SPI ("3.5'' TFT SPI 480x320" module)
|-
| Touch || XPT2046, resistive, '''separate SPI bus'''
|-
| Backlight || PWM via the ESP-IDF LEDC driver, GPIO 17
|}

== Display (ILI9488), SPI2 ==

{| class="wikitable"
! Display pin !! ESP32-S3 !! Note
|-
| VCC || 3.3 V || '''not 5 V'''
|-
| GND || GND ||
|-
| CS || GPIO 15 || chip select
|-
| RST || GPIO 16 || reset
|-
| DC / RS || GPIO 2 || data/command
|-
| MOSI / SDI || GPIO 13 || SPI data
|-
| SCK / CLK || GPIO 14 || SPI clock
|-
| LED / BL || GPIO 17 || backlight (PWM)
|-
| MISO / SDO || GPIO 12 || optional (read commands only)
|}

== Touch (XPT2046), separate bus SPI3 ==

The module has '''its own touch pins''': <code>T_CLK</code>, <code>T_DIN</code> and <code>T_DO</code> are '''not''' connected to the display's <code>SCK</code>, <code>SDI</code> and <code>SDO</code>.

{| class="wikitable"
! Touch pin !! ESP32-S3 !! Note
|-
| T_CLK || GPIO 6 || separate bus
|-
| T_DIN || GPIO 7 || touch MOSI
|-
| T_DO || GPIO 8 || touch MISO
|-
| T_CS || GPIO 21 || chip select
|-
| T_IRQ || GPIO 18 || not used (touch is polled)
|}

== Power supply ==

{| class="wikitable"
! ESP32-S3 !! Connection
|-
| 5V / VIN || USB or external 5 V
|-
| 3.3 V || display VCC and touch VCC
|-
| GND || common ground
|}

The ESP32-S3 draws short current peaks when transmitting over Wi-Fi, on top of the display and backlight. A '''power supply of at least 5 V / 2 A''' and a '''short, thick USB cable''' are recommended. A weak supply or cable can cause Wi-Fi failures or a brownout reset at cold start (see [[WetterCubePlus/Diagnose und Fehlersuche/en|Diagnostics and troubleshooting]]).

== Case to print yourself ==

The case from the photos (lower part and lid, version 2) is available for free as 3MF files: [https://github.com/JPPeterson-lab/WetterCubePlus/tree/main/gehaeuse folder <code>gehaeuse/</code> on GitHub]. Outer size according to the file: lower part 108 × 91.4 × 75.8 mm, lid 108 × 66.1 × 66.3 mm (width × depth × height). Recommendation: print in PLA or PETG with a 0.4 mm nozzle. A ready-made print profile on Bambu MakerWorld will follow shortly. Licence of the files: CC BY-NC 4.0.

== Notes ==

* '''Do not use GPIO 33–37!''' On the N16R8 they are reserved internally for the OPI PSRAM.
* '''GPIO 19/20''' are USB D−/D+; avoid them for normal I/O.
* '''GPIO 0''' is a strapping pin (boot); use it as an input only with a pull-up.
* The display module usually has its own 3.3 V level shifter. Even if the module can run on 5 V: apply only 3.3 V to VCC unless a separate 3.3 V input exists.
* The backlight can be connected directly to GPIO 17. For brighter LEDs use an NPN transistor (e.g. BC547) as a switch.
* '''LovyanGFX''' is used as the display driver (not TFT_eSPI): it copes with the ESP32-S3 PSRAM and the separate touch SPI bus.

The wiring is also in the repository: [https://github.com/JPPeterson-lab/WetterCubePlus/blob/main/WIRING.md <code>WIRING.md</code>].

[[Kategorie:Next]]
[[Kategorie:English]]

WetterCubePlus/Hardware und Verkabelung

2026-10-19T20:17:40Z

WetterCube: WetterCube Website

<div class="wc-sprachhinweis">[[WetterCubePlus/Hardware und Verkabelung/en|English version]]</div>

----

<div class="wc-box">'''⚠️ Strom und Sicherheit:''' Betreibe das Gerät nur mit einem geprüften Netzteil in der angegebenen Spannung und achte auf die richtige Verkabelung; Fehler können Bauteile zerstören oder zu Hitze führen. Nicht für sicherheitskritische Zwecke einsetzen. Du handelst auf eigene Gefahr, siehe die [https://wettercube.de/nutzungshinweise/ Nutzungshinweise].</div>

'''Hinweis zum Aufbau:''' Der WetterCubePlus richtet sich an Leute mit etwas Elektronik-Kenntnis: Beim Aufbau müssen Kabel gecrimpt und Bauteile gelötet werden. Wer das nicht möchte, ist mit dem [https://github.com/JPPeterson-lab/WetterCube-Fusion WetterCube Fusion] besser bedient. Bei den neueren Geräten (Fusion und Next) setze ich deshalb auf komplette Boards mit integriertem Display: Der Bau ist so auch für Leute einfach, die sich mit dem Verkabeln von ESP32 und Co. nicht auskennen.

== Bauteile ==

{| class="wikitable"
! Komponente !! Typ
|-
| Mikrocontroller || ESP32-S3 '''N16R8''' (16 MB Flash, 8 MB OPI-PSRAM)
|-
| Display || ILI9488, 3,5", 480×320 Pixel, SPI (Modul „3.5'' TFT SPI 480x320“)
|-
| Touch || XPT2046, resistiv, '''eigener SPI-Bus'''
|-
| Hintergrundbeleuchtung || PWM über den ESP-IDF-LEDC-Treiber, GPIO 17
|}

== Display (ILI9488), SPI2 ==

{| class="wikitable"
! Display-Pin !! ESP32-S3 !! Hinweis
|-
| VCC || 3,3 V || '''nicht 5 V'''
|-
| GND || GND ||
|-
| CS || GPIO 15 || Chip Select
|-
| RST || GPIO 16 || Reset
|-
| DC / RS || GPIO 2 || Daten/Befehl
|-
| MOSI / SDI || GPIO 13 || SPI-Daten
|-
| SCK / CLK || GPIO 14 || SPI-Takt
|-
| LED / BL || GPIO 17 || Hintergrundlicht (PWM)
|-
| MISO / SDO || GPIO 12 || optional (nur für Lesebefehle)
|}

== Touch (XPT2046), eigener Bus SPI3 ==

Das Modul hat '''eigene Touch-Pins''': <code>T_CLK</code>, <code>T_DIN</code> und <code>T_DO</code> sind '''nicht''' mit <code>SCK</code>, <code>SDI</code> und <code>SDO</code> des Displays verbunden.

{| class="wikitable"
! Touch-Pin !! ESP32-S3 !! Hinweis
|-
| T_CLK || GPIO 6 || eigener Bus
|-
| T_DIN || GPIO 7 || Touch-MOSI
|-
| T_DO || GPIO 8 || Touch-MISO
|-
| T_CS || GPIO 21 || Chip Select
|-
| T_IRQ || GPIO 18 || nicht genutzt (der Touch wird abgefragt)
|}

== Spannungsversorgung ==

{| class="wikitable"
! ESP32-S3 !! Anschluss
|-
| 5V / VIN || USB oder extern 5 V
|-
| 3,3 V || Display-VCC und Touch-VCC
|-
| GND || gemeinsame Masse
|}

Der ESP32-S3 braucht beim WLAN-Senden kurze Stromspitzen, dazu kommen Display und Hintergrundlicht. Empfohlen sind ein '''Netzteil mit mindestens 5 V / 2 A''' und ein '''kurzes, dickes USB-Kabel'''. Ein schwaches Netzteil oder Kabel kann beim Kaltstart zu WLAN-Fehlern oder einem Brownout-Reset führen (siehe [[WetterCubePlus/Diagnose und Fehlersuche|Diagnose und Fehlersuche]]).

== Gehäuse zum Selbstdrucken ==

Das Gehäuse aus den Fotos (Unterteil und Deckel, Version 2) gibt es kostenlos als 3MF-Dateien zum Download: [https://github.com/JPPeterson-lab/WetterCubePlus/tree/main/gehaeuse Ordner <code>gehaeuse/</code> auf GitHub]. Außenmaße laut Datei: Unterteil 108 × 91,4 × 75,8 mm, Deckel 108 × 66,1 × 66,3 mm (Breite × Tiefe × Höhe). Empfehlung: Druck in PLA oder PETG mit einer 0,4-mm-Düse. Ein fertiges Druckprofil auf Bambu MakerWorld folgt in Kürze. Lizenz der Dateien: CC BY-NC 4.0.

== Hinweise ==

* '''GPIO 33–37 nicht verwenden!''' Sie sind beim N16R8 intern für das OPI-PSRAM reserviert.
* '''GPIO 19/20''' sind USB D−/D+, für normale Ein-/Ausgänge vermeiden.
* '''GPIO 0''' ist ein Strapping-Pin (Boot), als Eingang nur mit Pull-Up verwenden.
* Das Display-Modul hat meist einen eigenen 3,3-V-Pegelwandler. Auch wenn das Modul mit 5 V arbeiten kann: an VCC nur 3,3 V anlegen, sofern kein getrennter 3,3-V-Eingang vorhanden ist.
* Die Hintergrundbeleuchtung kann direkt an GPIO 17 hängen. Für hellere LEDs einen NPN-Transistor (z. B. BC547) als Schalter verwenden.
* Als Display-Treiber wird '''LovyanGFX''' verwendet (nicht TFT_eSPI): Es kommt mit dem PSRAM des ESP32-S3 und dem separaten Touch-SPI-Bus zurecht.

Die Verkabelung steht auch im Repository: [https://github.com/JPPeterson-lab/WetterCubePlus/blob/main/WIRING.md <code>WIRING.md</code>].

[[Kategorie:Next]]

Next/Hardware/en

2026-10-19T20:17:27Z

WetterCube: WetterCube Website

<div class="wc-sprachhinweis">Dies ist die englische Fassung. [[Next/Hardware|Zur deutschen Fassung]]</div>

----

<div class="wc-box">'''⚠️ Power and safety:''' Only run the device with a tested power supply of the stated voltage and pay attention to correct wiring; mistakes can destroy parts or cause heat. Do not use for safety-critical purposes. You act at your own risk, see the [https://wettercube.de/en/usage-notes/ usage notes].</div>

'''Note:''' WetterCube is a software project. You buy the board yourself and design or print a case to your own taste; I try to offer matching cases.

'''Only the described CYD:''' The software is meant for the ESP32 CYD ESP32-2432S028. CYD boards differ depending on the vendor (display controller, colours, orientation); other boards are not supported and can cause problems. As soon as more boards are available, board-specific versions are to be offered in the long term; there is no fixed date yet.

Next needs '''no wiring''' and no soldering: a complete board with an integrated display makes building easy even for people who know nothing about wiring up an ESP32 and the like. It runs on the '''ESP32 CYD''' ("Cheap Yellow Display") '''ESP32-2432S028''': ESP32 (dual core, 4 MB flash, no PSRAM), 2.8" 320×240 display with an '''ST7789''' controller (SPI), resistive touch (only used to turn pages), USB for power and flashing. Standard CYD pins. If the picture looks wrong, change the controller, "Drehen" (rotate) and "Farben invertieren" (invert colours) in the web interface (restart needed).

[[Kategorie:Next]]
[[Kategorie:English]]

Next/Hardware

2026-10-19T20:17:26Z

WetterCube: WetterCube Website

<div class="wc-sprachhinweis">[[Next/Hardware/en|English version]]</div>

----

<div class="wc-box">'''⚠️ Strom und Sicherheit:''' Betreibe das Gerät nur mit einem geprüften Netzteil in der angegebenen Spannung und achte auf die richtige Verkabelung; Fehler können Bauteile zerstören oder zu Hitze führen. Nicht für sicherheitskritische Zwecke einsetzen. Du handelst auf eigene Gefahr, siehe die [https://wettercube.de/nutzungshinweise/ Nutzungshinweise].</div>

'''Hinweis:''' WetterCube ist ein Softwareprojekt. Das Board kaufst du selbst, ein Gehäuse gestaltest oder druckst du nach deinem Geschmack; ich versuche, passende Gehäuse anzubieten.

'''Nur das beschriebene CYD:''' Die Software ist für das ESP32 CYD ESP32-2432S028 gedacht. CYD-Boards unterscheiden sich je nach Anbieter (Display-Controller, Farben, Ausrichtung); andere Boards werden nicht unterstützt und können Probleme machen. Sobald weitere Boards zur Verfügung stehen, sollen langfristig auch boardspezifische Versionen angeboten werden; einen festen Termin gibt es noch nicht.

Das Next braucht '''keine Verkabelung''' und kein Löten: Ein komplettes Board mit integriertem Display macht den Bau auch für Leute einfach, die sich mit dem Verkabeln von ESP32 und Co. nicht auskennen. Es läuft auf dem '''ESP32 CYD''' („Cheap Yellow Display“) '''ESP32-2432S028''':

{| class="wikitable"
! Teil !! Daten
|-
| Prozessor || ESP32 (Dual-Core, 4 MB Flash, kein PSRAM)
|-
| Display || 2,8" 320×240, Controller '''ST7789''' (SPI)
|-
| Touch || resistiv (XPT2046); das Next nutzt nur das Antippen zum Blättern
|-
| Anschluss || USB (Strom und Flashen)
|}

Die Pins sind die des CYD-Standards (Display: MOSI 13, MISO 12, SCLK 14, CS 15, DC 2, Hintergrundlicht 21; Touch-Interrupt 36).

'''Display-Varianten:''' Auf den üblichen CYD sitzt ein ST7789 (Vorgabe: RGB, Farben nicht invertiert). Sieht das Bild bei dir falsch aus, kannst du in der Weboberfläche den Controller, „Drehen“ und „Farben invertieren“ ändern (Neustart nötig).

[[Kategorie:Next]]

Fusion/Hardware/en

2026-10-19T20:16:57Z

WetterCube: WetterCube Website

<div class="wc-sprachhinweis">Dies ist die englische Fassung. [[Fusion/Hardware|Zur deutschen Fassung]]</div>

----

<div class="wc-box">'''⚠️ Power and safety:''' Only run the device with a tested power supply of the stated voltage and pay attention to correct wiring; mistakes can destroy parts or cause heat. Do not use for safety-critical purposes. You act at your own risk, see the [https://wettercube.de/en/usage-notes/ usage notes].</div>

'''Note:''' WetterCube is a software project. You buy the board yourself and design or print a case to your own taste; I try to offer matching cases.

'''Waveshare boards only:''' The software is only reliably supported on exactly these boards (see below). Combined boards with a display often differ from vendor to vendor in display, touch or connectors; other boards are not supported and can cause problems. As soon as more boards are available, board-specific versions are to be offered in the long term; there is no fixed date yet.

Fusion needs '''no wiring''': display, touch and backlight control are built onto the board. This is deliberate: complete boards with an integrated display make building easy even for people who know nothing about building and wiring up an ESP32 and the like. If you do not want to crimp and solder, the Fusion is the right choice; WetterCube and WetterCubePlus, by contrast, require crimping and soldering.

== Target board: Waveshare ESP32-P4-WIFI6-Touch-LCD-7B ==

{| class="wikitable"
! Component !! Type
|-
| Main processor || ESP32-P4 (RISC-V, two fast cores plus one low-power core), '''32 MB PSRAM''' in the package, '''32 MB flash'''
|-
| Wi-Fi/Bluetooth || ESP32-C6 as a co-processor (Wi-Fi 6, Bluetooth 5 LE), connected via ESP-Hosted/<code>esp_wifi_remote</code>
|-
| Display || 7" IPS, '''1024×600''', '''MIPI-DSI'''
|-
| Touch || capacitive, 5 points
|-
| More || USB 2.0 OTG, SDIO 3.0 TF card slot, microphones, speaker header, RTC battery, 2×12 GPIO header, RS485, CAN, I²C, UART, MIPI-CSI
|}

Status: this is the '''main board''' and arrives in a few days. The code is prepared for it (board layer, build, recovery app) but has not run on the board yet; until then development happens on the S3. The S3 state (<code>0.9.9-alpha7</code>) then stays as a backup with small fixes.

== Development board: Waveshare ESP32-S3-Touch-LCD-7B ==

{| class="wikitable"
! Component !! Type
|-
| Microcontroller || ESP32-S3, '''16 MB flash''', '''8 MB OPI PSRAM'''
|-
| Display || 7", '''1024×600''', 16-bit RGB interface
|-
| Touch || GT911 (I²C), capacitive
|-
| Backlight || PWM through an I²C IO expander
|}

== Power supply ==

Via '''USB-C''' at the port labelled '''UART''' ("USB TO UART"). Because of the display, the backlight and the current peaks when transmitting over Wi-Fi, a '''power supply of at least 5 V / 2 A''' and a '''short, thick cable''' are recommended. A weak supply or cable can cause Wi-Fi failures or a brownout reset (see [[Fusion/Diagnose und Fehlersuche/en|Diagnostics]]).

== Notes ==

* '''Flashing and log:''' Both boards have several USB ports. For flashing (web installer) and for the serial monitor output (115200 baud, usually <code>/dev/cu.usbmodem…</code> on a Mac) use the port labelled '''UART''' ("USB TO UART"). If the board is not detected, hold the BOOT button while you plug in the cable or press RESET, then release it (download mode).
* Because of memory bandwidth the S3 draws with partial rendering (see [[Fusion/Entwicklung/en|Development]]); on the P4 with a DSI framebuffer and 32 MB PSRAM this is expected to be unnecessary.

[[Kategorie:Fusion]]
[[Kategorie:English]]

Fusion/Hardware

2026-10-19T20:16:56Z

WetterCube: WetterCube Website

<div class="wc-sprachhinweis">[[Fusion/Hardware/en|English version]]</div>

----

<div class="wc-box">'''⚠️ Strom und Sicherheit:''' Betreibe das Gerät nur mit einem geprüften Netzteil in der angegebenen Spannung und achte auf die richtige Verkabelung; Fehler können Bauteile zerstören oder zu Hitze führen. Nicht für sicherheitskritische Zwecke einsetzen. Du handelst auf eigene Gefahr, siehe die [https://wettercube.de/nutzungshinweise/ Nutzungshinweise].</div>

'''Hinweis:''' WetterCube ist ein Softwareprojekt. Das Board kaufst du selbst, ein Gehäuse gestaltest oder druckst du nach deinem Geschmack; ich versuche, passende Gehäuse anzubieten.

'''Nur auf Waveshare-Boards:''' Die Software läuft gesichert nur auf genau diesen Boards (siehe unten). Kombi-Boards mit Display unterscheiden sich von Anbieter zu Anbieter oft in Display, Touch oder Anschlüssen; andere Boards werden nicht unterstützt und können Probleme machen. Sobald weitere Boards zur Verfügung stehen, sollen langfristig auch boardspezifische Versionen angeboten werden; einen festen Termin gibt es noch nicht.

Fusion braucht '''keine Verkabelung''': Display, Touch und Backlight-Steuerung sitzen fest auf dem Board. Das ist Absicht: Komplette Boards mit integriertem Display machen den Bau auch für Leute einfach, die sich mit dem Bauen und Verkabeln von ESP32 und Co. nicht auskennen. Wer nicht crimpen und löten möchte, ist mit dem Fusion richtig; WetterCube und WetterCubePlus verlangen dagegen Crimpen und Löten.

== Zielboard: Waveshare ESP32-P4-WIFI6-Touch-LCD-7B ==

{| class="wikitable"
! Komponente !! Typ
|-
| Hauptprozessor || ESP32-P4 (RISC-V, zwei schnelle Kerne plus ein Low-Power-Kern), '''32 MB PSRAM''' im Gehäuse, '''32 MB Flash'''
|-
| WLAN/Bluetooth || ESP32-C6 als Zusatzchip (Wi-Fi 6, Bluetooth 5 LE), angebunden über ESP-Hosted/<code>esp_wifi_remote</code>
|-
| Display || 7" IPS, '''1024×600''', '''MIPI-DSI'''
|-
| Touch || kapazitiv, 5 Punkte
|-
| Weiteres || USB 2.0 OTG, SDIO-3.0-TF-Kartenslot, Mikrofone, Lautsprecher-Anschluss, RTC-Batterie, 2×12-GPIO-Leiste, RS485, CAN, I²C, UART, MIPI-CSI
|}

Stand: Das Board ist das '''Hauptboard''' und kommt in einigen Tagen. Der Code ist dafür vorbereitet (Board-Schicht, Bau, Notfall-App), aber noch nicht auf dem Board gelaufen; bis dahin wird auf dem S3 entwickelt. Der S3-Stand (<code>0.9.9-alpha7</code>) bleibt danach als Sicherung mit kleinen Fehlerbehebungen.

== Entwicklungsboard: Waveshare ESP32-S3-Touch-LCD-7B ==

{| class="wikitable"
! Komponente !! Typ
|-
| Mikrocontroller || ESP32-S3, '''16 MB Flash''', '''8 MB OPI-PSRAM'''
|-
| Display || 7", '''1024×600''', 16-Bit-RGB-Interface
|-
| Touch || GT911 (I²C), kapazitiv
|-
| Backlight || PWM über einen I²C-IO-Expander
|}

== Stromversorgung ==

Per '''USB-C''' am Anschluss mit der Beschriftung '''UART''' („USB TO UART“). Wegen Display, Backlight und den Stromspitzen beim WLAN-Senden empfiehlt sich ein '''Netzteil mit mindestens 5 V / 2 A''' und ein '''kurzes, dickes Kabel'''. Ein schwaches Netzteil oder Kabel kann zu WLAN-Fehlern oder einem Brownout-Reset führen (siehe [[Fusion/Diagnose und Fehlersuche|Diagnose]]).

== Hinweise ==

* '''Flashen und Log:''' Beide Boards haben mehrere USB-Anschlüsse. Zum Flashen (Web-Installer) und für die Ausgabe im Seriellen Monitor (115200 Baud, am Mac meist <code>/dev/cu.usbmodem…</code>) wird der Anschluss mit der Beschriftung '''UART''' („USB TO UART“) benutzt. Wird das Board nicht erkannt, die BOOT-Taste gedrückt halten, während du das Kabel ansteckst oder RESET drückst, dann loslassen (Download-Modus).
* Wegen der Speicherbandbreite wird auf dem S3 im Teilrendering gezeichnet (siehe [[Fusion/Entwicklung|Entwicklung]]); auf dem P4 mit DSI-Framebuffer und 32 MB PSRAM voraussichtlich nicht mehr nötig.

[[Kategorie:Fusion]]

Fusion/Home Assistant und Schalter/en

2026-10-19T20:13:51Z

WetterCube: WetterCube Website

<div class="wc-sprachhinweis">Dies ist die englische Fassung. [[Fusion/Home Assistant und Schalter|Zur deutschen Fassung]]</div>

----

The WetterCube Fusion works with '''Home Assistant''' in both directions: it '''reports''' its values (outside weather, moon, UV, air quality, pollen, airing, alarms, internal sensor) and it '''switches''' devices that you add as tiles on the display. Both run through your '''MQTT broker''' (for example Home Assistant's Mosquitto add-on), so over the same connection as the sensors. No account and no cloud needed.

== Requirements ==

* An MQTT broker in your home network, connected to Home Assistant with the '''MQTT integration'''.
* The WetterCube is connected to the broker (web interface → '''Sensoren''', step 1 "Verbinden").

== Home Assistant: values of the WetterCube ==

# Web interface → '''Smart Home''' → card '''Home Assistant (MQTT)''' → switch on '''Home Assistant melden''' and save.
# After a few seconds the device '''WetterCube Fusion''' appears in Home Assistant under Settings → Devices & services → MQTT. Home Assistant creates the sensors itself (MQTT discovery), you do not have to write any YAML. The line '''Stand''' (status) in the card shows how far the registration is; '''Jetzt neu melden''' sends everything again.

'''These entities exist:'''

{| class="wikitable"
! Group !! Entities
|-
| Weather || outside temperature, feels-like temperature, minimum and maximum temperature today, outside humidity, air pressure, wind speed, wind direction, weather (text), UV index now and daily maximum
|-
| Moon || moon phase (text), moon illuminated (%)
|-
| Air || air quality (AQI), particulates PM2.5 and PM10, ozone, nitrogen dioxide
|-
| Pollen || strongest pollen level (0 to 3) and the main allergen
|-
| House || airing (text of the traffic light), airing recommended, humidity warning, sensor alarms (count) and sensor alarm (on/off), DWD warnings (count)
|-
| Case || temperature, humidity and air pressure of the internal sensor (only if installed)
|}

The state is sent as one JSON to the topic <code>wettercube-fusion/zustand</code>, on change (at most every 5 seconds) and at least once a minute. The topic <code>wettercube-fusion/status</code> reports '''online''' or '''offline''' (the broker's last will): when the WetterCube is off, Home Assistant shows its entities as "unavailable". The prefix can be changed. Sensors the WetterCube '''reads''' over MQTT (for example your ESPHome sensors) are not sent back: Home Assistant knows them already.

'''Switching off''' removes the device and its entities from Home Assistant again.

== Without MQTT: <code>/api/status</code> ==

The address <code>http://wettercube-fusion.local/api/status</code> returns the same values as JSON, for example for a REST sensor in Home Assistant:

<pre>
rest:
- resource: http://wettercube-fusion.local/api/status
scan_interval: 60
sensor:
- name: "WetterCube outside temperature"
value_template: "{{ value_json.temp }}"
unit_of_measurement: "°C"
</pre>

== Switch tiles: switching devices from the display ==

<div class="wc-box">'''⚠️ Be careful when switching:''' Anyone switching sockets or lamps quickly deals with mains voltage (230 V). Only use ready-made, tested and approved devices (for example smart plugs) and have any work on the house wiring done by a qualified electrician. Do not use the switches for safety-critical purposes (heating, cooker, medical or safety equipment): the device can fail or switch wrongly. You act at your own risk.</div>

On the '''sensor page''' of the display, '''switch tiles''' (up to 8) appear after the sensors. A tile shows name, room and a switch with "An" (on), "Aus" (off) or "?" (state not known yet). '''Tapping toggles it.''' A green border means on.

'''Setup:''' web interface → '''Schalter''' (tab at the top).

# '''Take devices from the network:''' Home Assistant reports its switches and lights to the broker (MQTT discovery). They appear in step 1 with a checkbox; '''Ausgewählte hinzufügen''' takes over command topic, state topic and the texts for on and off.
# '''By hand:''' under "Schalter von Hand hinzufügen" enter the name, the '''command topic''' (where the WetterCube sends) and optionally the '''state topic''' (where the state comes back from), plus the texts for "on" and "off" (default <code>ON</code> and <code>OFF</code>).
# In the list (step 2) you can change name and room, hide tiles and test with '''an''' and '''aus'''. Under "Erweiterte Einstellungen" you find topics, texts, a JSON key (if the state is inside a JSON message) and the order.

Without a state topic the WetterCube only remembers what it sent last. If the broker cannot be reached, the tile briefly shows "kein MQTT" (no MQTT) when tapped.

'''Examples:'''

{| class="wikitable"
! Device !! Command topic !! State topic !! Send on / off
|-
| Tasmota || <code>cmnd/<name>/POWER</code> || <code>stat/<name>/POWER</code> || <code>ON</code> / <code>OFF</code>
|-
| Shelly (MQTT) || <code>shellies/<id>/relay/0/command</code> || <code>shellies/<id>/relay/0</code> || <code>on</code> / <code>off</code>
|-
| ESPHome switch || <code><name>/switch/<switch>/command</code> || <code><name>/switch/<switch>/state</code> || <code>ON</code> / <code>OFF</code>
|}

'''Lamp with WLED:''' Home Assistant normally connects WLED through its own '''WLED integration''' (HTTP), not over MQTT. Such devices therefore do '''not''' show up on the page '''Schalter''' by themselves: the WetterCube only talks to the MQTT broker. Here is how it works anyway:

# In WLED under '''Config → Sync Interfaces → MQTT''' switch on the connection to the same broker (address, port, user and password as on the Sensoren page, step 1) and note the '''device topic''' (default <code>wled/</code> plus six characters, for example <code>wled/ab12cd</code>).
# With the default topic the lamp appears on the page '''Schalter''' by itself as "WLED …" in step 1; tick it and add it. Otherwise enter name and device topic under "Meine Lampe taucht hier nicht auf" and press '''WLED hinzufügen'''.
# Behind it: the command <code>ON</code> or <code>OFF</code> goes to the device topic, the state comes from <code><topic>/g</code> (brightness, "greater than 0" means on). Color and effects stay in WLED and Home Assistant; the tile only switches on and off.

The switches are part of the settings backup (commands and topics, no password).

[[Kategorie:Fusion]]
[[Kategorie:English]]

Fusion/Home Assistant und Schalter

2026-10-19T20:13:50Z

WetterCube: WetterCube Website

<div class="wc-sprachhinweis">[[Fusion/Home Assistant und Schalter/en|English version]]</div>

----

Der WetterCube Fusion arbeitet mit '''Home Assistant''' in beide Richtungen zusammen: Er '''meldet''' seine Werte (Außenwetter, Mond, UV, Luftqualität, Pollen, Lüften, Alarme, interner Sensor) und er '''schaltet''' Geräte, die du auf dem Display als Kachel anlegst. Beides läuft über deinen '''MQTT-Broker''' (zum Beispiel das Mosquitto-Add-on von Home Assistant), also über dieselbe Verbindung wie die Sensoren. Es braucht kein Konto und keine Cloud.

== Voraussetzung ==

* Ein MQTT-Broker im Heimnetz, in Home Assistant mit der '''MQTT-Integration''' eingebunden.
* Der WetterCube ist mit dem Broker verbunden (Web-Oberfläche → '''Sensoren''', Schritt 1 „Verbinden“).

== Home Assistant: Werte des WetterCube ==

# Web-Oberfläche → '''Smart Home''' → Karte '''Home Assistant (MQTT)''' → '''Home Assistant melden''' einschalten und speichern.
# Nach einigen Sekunden steht in Home Assistant unter Einstellungen → Geräte & Dienste → MQTT das Gerät '''WetterCube Fusion'''. Die Sensoren legt Home Assistant selbst an (MQTT-Discovery), du musst nichts in YAML schreiben. Die Zeile '''Stand''' in der Karte zeigt, wie weit die Anmeldung ist; '''Jetzt neu melden''' sendet alles noch einmal.

'''Diese Entitäten gibt es:'''

{| class="wikitable"
! Gruppe !! Entitäten
|-
| Wetter || Außentemperatur, gefühlte Temperatur, Tiefst- und Höchsttemperatur heute, Außenluftfeuchte, Luftdruck, Windgeschwindigkeit, Windrichtung, Wetter (Text), UV-Index jetzt und Tagesmaximum
|-
| Mond || Mondphase (Text), Mond beleuchtet (%)
|-
| Luft || Luftqualität (AQI), Feinstaub PM2.5 und PM10, Ozon, Stickstoffdioxid
|-
| Pollen || stärkste Pollenstufe (0 bis 3) und das Leitallergen
|-
| Haus || Lüften (Text der Ampel), Lüften empfohlen, Feuchte-Warnung, Sensor-Alarme (Zahl) und Sensor-Alarm (an/aus), DWD-Warnungen (Zahl)
|-
| Gehäuse || Temperatur, Luftfeuchte und Luftdruck des internen Sensors (nur, wenn er eingebaut ist)
|}

Der Zustand wird als ein JSON auf das Thema <code>wettercube-fusion/zustand</code> gesendet, bei Änderung (höchstens alle 5 Sekunden) und mindestens einmal pro Minute. Das Thema <code>wettercube-fusion/status</code> meldet '''online''' oder '''offline''' (Letzter Wille des Brokers): Ist der WetterCube aus, zeigt Home Assistant seine Entitäten als „nicht verfügbar“. Das Präfix lässt sich ändern. Sensoren, die der WetterCube per MQTT '''liest''' (zum Beispiel deine ESPHome-Sensoren), meldet er nicht zurück: Home Assistant kennt sie schon.

'''Ausschalten''' löscht das Gerät und seine Entitäten wieder aus Home Assistant.

== Ohne MQTT: <code>/api/status</code> ==

Dieselben Werte liefert die Adresse <code>http://wettercube-fusion.local/api/status</code> als JSON, zum Beispiel für einen REST-Sensor in Home Assistant:

<pre>
rest:
- resource: http://wettercube-fusion.local/api/status
scan_interval: 60
sensor:
- name: "WetterCube Außentemperatur"
value_template: "{{ value_json.temp }}"
unit_of_measurement: "°C"
</pre>

== Schalter-Kacheln: Geräte vom Display schalten ==

<div class="wc-box">'''⚠️ Vorsicht beim Schalten:''' Wer Steckdosen oder Lampen schaltet, hat es schnell mit Netzspannung (230 V) zu tun. Verwende dafür nur fertige, geprüfte und zugelassene Geräte (zum Beispiel Smart-Steckdosen) und lass Eingriffe in die Hausinstallation von einer Elektrofachkraft machen. Setze die Schalter nicht für sicherheitskritische Zwecke ein (Heizung, Herd, medizinische oder Sicherheitsgeräte): Das Gerät kann ausfallen oder falsch schalten. Du handelst auf eigene Gefahr.</div>

Auf der '''Sensor-Seite''' des Displays erscheinen hinter den Sensoren '''Schalter-Kacheln''' (bis zu 8). Eine Kachel zeigt Name, Raum und einen Schalter mit „An“, „Aus“ oder „?“ (Zustand noch unbekannt). '''Antippen schaltet um.''' Ein grüner Rand bedeutet „an“.

'''Einrichten:''' Web-Oberfläche → '''Schalter''' (Reiter oben).

# '''Geräte aus dem Netz übernehmen:''' Home Assistant meldet seine Schalter und Lichter dem Broker (MQTT-Discovery). Sie erscheinen in Schritt 1 mit Haken; '''Ausgewählte hinzufügen''' übernimmt Befehl-Thema, Zustand-Thema und die Texte für An und Aus.
# '''Von Hand:''' unter „Schalter von Hand hinzufügen“ den Namen, das '''Befehl-Thema''' (dorthin sendet der WetterCube) und optional das '''Zustand-Thema''' (von dort kommt der Zustand zurück) eintragen, dazu die Texte für „an“ und „aus“ (Standard <code>ON</code> und <code>OFF</code>).
# In der Liste (Schritt 2) lassen sich Name und Raum ändern, Kacheln ausblenden und mit '''an''' und '''aus''' testen. Unter „Erweiterte Einstellungen“ stehen Themen, Texte, ein JSON-Schlüssel (wenn der Zustand in einer JSON-Meldung steckt) und die Reihenfolge.

Ohne Zustand-Thema merkt sich der WetterCube nur, was er zuletzt gesendet hat. Ist der Broker nicht erreichbar, zeigt die Kachel beim Antippen kurz „kein MQTT“.

'''Beispiele:'''

{| class="wikitable"
! Gerät !! Befehl-Thema !! Zustand-Thema !! An / Aus senden
|-
| Tasmota || <code>cmnd/<name>/POWER</code> || <code>stat/<name>/POWER</code> || <code>ON</code> / <code>OFF</code>
|-
| Shelly (MQTT) || <code>shellies/<id>/relay/0/command</code> || <code>shellies/<id>/relay/0</code> || <code>on</code> / <code>off</code>
|-
| ESPHome-Schalter || <code><name>/switch/<schalter>/command</code> || <code><name>/switch/<schalter>/state</code> || <code>ON</code> / <code>OFF</code>
|}

'''Lampe mit WLED:''' Home Assistant bindet WLED normalerweise über die eigene '''WLED-Integration''' (HTTP) ein, nicht über MQTT. Solche Geräte tauchen auf der Seite '''Schalter''' deshalb '''nicht''' von selbst auf: Der WetterCube spricht nur mit dem MQTT-Broker. So klappt es trotzdem:

# In WLED unter '''Config → Sync Interfaces → MQTT''' die Verbindung zum selben Broker einschalten (Adresse, Port, Benutzer und Passwort wie auf der Seite Sensoren, Schritt 1) und das '''Gerätethema''' merken (Standard <code>wled/</code> plus sechs Zeichen, zum Beispiel <code>wled/ab12cd</code>).
# Mit dem Standardthema meldet sich die Lampe auf der Seite '''Schalter''' von selbst als „WLED …“ in Schritt 1; Haken setzen und hinzufügen. Sonst unter „Meine Lampe taucht hier nicht auf“ Namen und Gerätethema eintragen und '''WLED hinzufügen'''.
# Dahinter steckt: Befehl <code>ON</code> oder <code>OFF</code> an das Gerätethema, Zustand aus <code><Thema>/g</code> (Helligkeit, „größer als 0“ heißt an). Farbe und Effekte bleiben in WLED und Home Assistant; die Kachel schaltet nur ein und aus.

Die Schalter stehen in der Einstellungssicherung (Befehle und Themen, kein Passwort).

[[Kategorie:Fusion]]

WetterCubePlus/Hardware und Verkabelung/en

2026-10-19T16:02:39Z

WetterCube: WetterCube Website

<div class="wc-sprachhinweis">Dies ist die englische Fassung. [[WetterCubePlus/Hardware und Verkabelung|Zur deutschen Fassung]]</div>

----

'''Note on assembly:''' The WetterCubePlus is aimed at people with some knowledge of electronics: during assembly, cables have to be crimped and parts soldered. If you do not want that, the [https://github.com/JPPeterson-lab/WetterCube-Fusion WetterCube Fusion] is the better choice. That is why, for the newer devices (Fusion and Next), I rely on complete boards with an integrated display: building is easy even for people who know nothing about wiring up an ESP32 and the like.

== Parts ==

{| class="wikitable"
! Component !! Type
|-
| Microcontroller || ESP32-S3 '''N16R8''' (16 MB flash, 8 MB OPI PSRAM)
|-
| Display || ILI9488, 3.5", 480×320 pixels, SPI ("3.5'' TFT SPI 480x320" module)
|-
| Touch || XPT2046, resistive, '''separate SPI bus'''
|-
| Backlight || PWM via the ESP-IDF LEDC driver, GPIO 17
|}

== Display (ILI9488), SPI2 ==

{| class="wikitable"
! Display pin !! ESP32-S3 !! Note
|-
| VCC || 3.3 V || '''not 5 V'''
|-
| GND || GND ||
|-
| CS || GPIO 15 || chip select
|-
| RST || GPIO 16 || reset
|-
| DC / RS || GPIO 2 || data/command
|-
| MOSI / SDI || GPIO 13 || SPI data
|-
| SCK / CLK || GPIO 14 || SPI clock
|-
| LED / BL || GPIO 17 || backlight (PWM)
|-
| MISO / SDO || GPIO 12 || optional (read commands only)
|}

== Touch (XPT2046), separate bus SPI3 ==

The module has '''its own touch pins''': <code>T_CLK</code>, <code>T_DIN</code> and <code>T_DO</code> are '''not''' connected to the display's <code>SCK</code>, <code>SDI</code> and <code>SDO</code>.

{| class="wikitable"
! Touch pin !! ESP32-S3 !! Note
|-
| T_CLK || GPIO 6 || separate bus
|-
| T_DIN || GPIO 7 || touch MOSI
|-
| T_DO || GPIO 8 || touch MISO
|-
| T_CS || GPIO 21 || chip select
|-
| T_IRQ || GPIO 18 || not used (touch is polled)
|}

== Power supply ==

{| class="wikitable"
! ESP32-S3 !! Connection
|-
| 5V / VIN || USB or external 5 V
|-
| 3.3 V || display VCC and touch VCC
|-
| GND || common ground
|}

The ESP32-S3 draws short current peaks when transmitting over Wi-Fi, on top of the display and backlight. A '''power supply of at least 5 V / 2 A''' and a '''short, thick USB cable''' are recommended. A weak supply or cable can cause Wi-Fi failures or a brownout reset at cold start (see [[WetterCubePlus/Diagnose und Fehlersuche/en|Diagnostics and troubleshooting]]).

== Case to print yourself ==

The case from the photos (lower part and lid, version 2) is available for free as 3MF files: [https://github.com/JPPeterson-lab/WetterCubePlus/tree/main/gehaeuse folder <code>gehaeuse/</code> on GitHub]. Outer size according to the file: lower part 108 × 91.4 × 75.8 mm, lid 108 × 66.1 × 66.3 mm (width × depth × height). Recommendation: print in PLA or PETG with a 0.4 mm nozzle. A ready-made print profile on Bambu MakerWorld will follow shortly. Licence of the files: CC BY-NC 4.0.

== Notes ==

* '''Do not use GPIO 33–37!''' On the N16R8 they are reserved internally for the OPI PSRAM.
* '''GPIO 19/20''' are USB D−/D+; avoid them for normal I/O.
* '''GPIO 0''' is a strapping pin (boot); use it as an input only with a pull-up.
* The display module usually has its own 3.3 V level shifter. Even if the module can run on 5 V: apply only 3.3 V to VCC unless a separate 3.3 V input exists.
* The backlight can be connected directly to GPIO 17. For brighter LEDs use an NPN transistor (e.g. BC547) as a switch.
* '''LovyanGFX''' is used as the display driver (not TFT_eSPI): it copes with the ESP32-S3 PSRAM and the separate touch SPI bus.

The wiring is also in the repository: [https://github.com/JPPeterson-lab/WetterCubePlus/blob/main/WIRING.md <code>WIRING.md</code>].

[[Kategorie:Next]]
[[Kategorie:English]]

WetterCubePlus/Hardware und Verkabelung

2026-10-19T16:02:38Z

WetterCube: WetterCube Website

<div class="wc-sprachhinweis">[[WetterCubePlus/Hardware und Verkabelung/en|English version]]</div>

----

'''Hinweis zum Aufbau:''' Der WetterCubePlus richtet sich an Leute mit etwas Elektronik-Kenntnis: Beim Aufbau müssen Kabel gecrimpt und Bauteile gelötet werden. Wer das nicht möchte, ist mit dem [https://github.com/JPPeterson-lab/WetterCube-Fusion WetterCube Fusion] besser bedient. Bei den neueren Geräten (Fusion und Next) setze ich deshalb auf komplette Boards mit integriertem Display: Der Bau ist so auch für Leute einfach, die sich mit dem Verkabeln von ESP32 und Co. nicht auskennen.

== Bauteile ==

{| class="wikitable"
! Komponente !! Typ
|-
| Mikrocontroller || ESP32-S3 '''N16R8''' (16 MB Flash, 8 MB OPI-PSRAM)
|-
| Display || ILI9488, 3,5", 480×320 Pixel, SPI (Modul „3.5'' TFT SPI 480x320“)
|-
| Touch || XPT2046, resistiv, '''eigener SPI-Bus'''
|-
| Hintergrundbeleuchtung || PWM über den ESP-IDF-LEDC-Treiber, GPIO 17
|}

== Display (ILI9488), SPI2 ==

{| class="wikitable"
! Display-Pin !! ESP32-S3 !! Hinweis
|-
| VCC || 3,3 V || '''nicht 5 V'''
|-
| GND || GND ||
|-
| CS || GPIO 15 || Chip Select
|-
| RST || GPIO 16 || Reset
|-
| DC / RS || GPIO 2 || Daten/Befehl
|-
| MOSI / SDI || GPIO 13 || SPI-Daten
|-
| SCK / CLK || GPIO 14 || SPI-Takt
|-
| LED / BL || GPIO 17 || Hintergrundlicht (PWM)
|-
| MISO / SDO || GPIO 12 || optional (nur für Lesebefehle)
|}

== Touch (XPT2046), eigener Bus SPI3 ==

Das Modul hat '''eigene Touch-Pins''': <code>T_CLK</code>, <code>T_DIN</code> und <code>T_DO</code> sind '''nicht''' mit <code>SCK</code>, <code>SDI</code> und <code>SDO</code> des Displays verbunden.

{| class="wikitable"
! Touch-Pin !! ESP32-S3 !! Hinweis
|-
| T_CLK || GPIO 6 || eigener Bus
|-
| T_DIN || GPIO 7 || Touch-MOSI
|-
| T_DO || GPIO 8 || Touch-MISO
|-
| T_CS || GPIO 21 || Chip Select
|-
| T_IRQ || GPIO 18 || nicht genutzt (der Touch wird abgefragt)
|}

== Spannungsversorgung ==

{| class="wikitable"
! ESP32-S3 !! Anschluss
|-
| 5V / VIN || USB oder extern 5 V
|-
| 3,3 V || Display-VCC und Touch-VCC
|-
| GND || gemeinsame Masse
|}

Der ESP32-S3 braucht beim WLAN-Senden kurze Stromspitzen, dazu kommen Display und Hintergrundlicht. Empfohlen sind ein '''Netzteil mit mindestens 5 V / 2 A''' und ein '''kurzes, dickes USB-Kabel'''. Ein schwaches Netzteil oder Kabel kann beim Kaltstart zu WLAN-Fehlern oder einem Brownout-Reset führen (siehe [[WetterCubePlus/Diagnose und Fehlersuche|Diagnose und Fehlersuche]]).

== Gehäuse zum Selbstdrucken ==

Das Gehäuse aus den Fotos (Unterteil und Deckel, Version 2) gibt es kostenlos als 3MF-Dateien zum Download: [https://github.com/JPPeterson-lab/WetterCubePlus/tree/main/gehaeuse Ordner <code>gehaeuse/</code> auf GitHub]. Außenmaße laut Datei: Unterteil 108 × 91,4 × 75,8 mm, Deckel 108 × 66,1 × 66,3 mm (Breite × Tiefe × Höhe). Empfehlung: Druck in PLA oder PETG mit einer 0,4-mm-Düse. Ein fertiges Druckprofil auf Bambu MakerWorld folgt in Kürze. Lizenz der Dateien: CC BY-NC 4.0.

== Hinweise ==

* '''GPIO 33–37 nicht verwenden!''' Sie sind beim N16R8 intern für das OPI-PSRAM reserviert.
* '''GPIO 19/20''' sind USB D−/D+, für normale Ein-/Ausgänge vermeiden.
* '''GPIO 0''' ist ein Strapping-Pin (Boot), als Eingang nur mit Pull-Up verwenden.
* Das Display-Modul hat meist einen eigenen 3,3-V-Pegelwandler. Auch wenn das Modul mit 5 V arbeiten kann: an VCC nur 3,3 V anlegen, sofern kein getrennter 3,3-V-Eingang vorhanden ist.
* Die Hintergrundbeleuchtung kann direkt an GPIO 17 hängen. Für hellere LEDs einen NPN-Transistor (z. B. BC547) als Schalter verwenden.
* Als Display-Treiber wird '''LovyanGFX''' verwendet (nicht TFT_eSPI): Es kommt mit dem PSRAM des ESP32-S3 und dem separaten Touch-SPI-Bus zurecht.

Die Verkabelung steht auch im Repository: [https://github.com/JPPeterson-lab/WetterCubePlus/blob/main/WIRING.md <code>WIRING.md</code>].

[[Kategorie:Next]]

WetterCube/Inbetriebnahme/en

2026-10-19T15:01:52Z

WetterCube: WetterCube Website

<div class="wc-sprachhinweis">Dies ist die englische Fassung. [[WetterCube/Inbetriebnahme|Zur deutschen Fassung]]</div>

----

== 1. Install the firmware ==

'''Option A: Web installer (recommended, no development environment needed)'''

# [https://jppeterson-lab.github.io/WetterCube/ Open the web installer] ('''Google Chrome''' or '''Microsoft Edge''' only, because of WebSerial).
# Connect the board via '''USB-C''', choose "Install" and follow the instructions.
# '''Careful:''' the installation erases the flash, including the '''Wi-Fi password, location and settings'''. Afterwards the cube has to be set up again (step 2).

'''Option B: Arduino IDE''' – see [[WetterCube/Entwicklung/en|Development]]. After that, everything else works through updates over Wi-Fi (no more USB needed).

== 2. First setup ==

# On first start (or if the Wi-Fi is unreachable) the display shows "Portal: WetterCube-Setup". The cube now opens its '''own Wi-Fi "WetterCube-Setup"''' (no password).
# '''On your phone (or PC) open the Wi-Fi settings, look for "WetterCube-Setup" in the list of available networks and connect to it.''' If the phone says that the network has no internet access, stay connected anyway.
# The browser now opens '''the cube's setup portal by itself''' (on iOS and Android usually automatically). If that does not happen, open <code>http://192.168.4.1</code> in the browser.
# There, '''choose your home Wi-Fi from the list''' and enter the password.
# Enter your location (city) '''without umlauts''' (<code>Munchen</code>, <code>Koln</code>, <code>Dusseldorf</code>).
# "Speichern & Verbinden" (save and connect). The cube restarts, connects to your home Wi-Fi and loads the data. Afterwards connect your phone to your normal Wi-Fi again (this usually happens by itself).

After connecting, the boot screen shows the '''IP address for 5 seconds'''. Afterwards the cube is also reachable at '''<code>http://wettercube.local</code>'''. This works out of the box on Windows 11, macOS, iOS and Android; older Windows versions need [https://support.apple.com/kb/DL999 Bonjour].

== If the Wi-Fi connection fails at startup ==

At startup the cube waits up to '''15 seconds''' for the Wi-Fi. If that fails it opens the setup portal again. The portal stays open for '''3 minutes''', after which the cube restarts and tries again. The saved credentials are kept, and the portal has the previous Wi-Fi and location preselected.

A later '''Wi-Fi change''' (new router, new password) works without the portal through the web interface as long as the cube is still on the old network (see [[WetterCube/Einstellungen/en|Settings]]).

[[Kategorie:Next]]
[[Kategorie:English]]

WetterCube/Inbetriebnahme

2026-10-19T15:01:51Z

WetterCube: WetterCube Website

<div class="wc-sprachhinweis">[[WetterCube/Inbetriebnahme/en|English version]]</div>

----

== 1. Firmware aufspielen ==

'''Variante A: Web-Installer (empfohlen, keine Entwicklungsumgebung nötig)'''

# [https://jppeterson-lab.github.io/WetterCube/ Web-Installer öffnen] (nur '''Google Chrome''' oder '''Microsoft Edge''', wegen WebSerial).
# Board per '''USB-C''' verbinden, „Installieren“ wählen und den Anweisungen folgen.
# '''Achtung:''' Die Installation löscht den Flash und damit auch '''WLAN-Passwort, Standort und Einstellungen'''. Danach wird der Cube neu eingerichtet (Schritt 2).

'''Variante B: Arduino IDE''' – siehe [[WetterCube/Entwicklung|Entwicklung]]. Danach läuft alles Weitere per Update über WLAN (kein USB mehr nötig).

== 2. Erstkonfiguration ==

# Beim ersten Start (oder wenn das WLAN nicht erreichbar ist) zeigt das Display „Portal: WetterCube-Setup“. Der Cube macht jetzt sein '''eigenes WLAN „WetterCube-Setup“''' (ohne Passwort) auf.
# '''Öffne am Handy (oder PC) die WLAN-Einstellungen, suche in der Liste der verfügbaren Netze nach „WetterCube-Setup“ und verbinde dich damit.''' Meldet das Handy, dass das Netz keinen Internetzugang hat, bleibst du trotzdem verbunden.
# Jetzt öffnet der Browser '''von selbst das Einrichtungsportal des Cubes''' (auf iOS und Android meist automatisch). Passiert das nicht, rufe im Browser <code>http://192.168.4.1</code> auf.
# Wähle dort '''dein Heim-WLAN aus der Liste''' und gib das Passwort ein.
# Standort (Stadt) eingeben, '''ohne Umlaute''' (<code>Munchen</code>, <code>Koln</code>, <code>Dusseldorf</code>).
# „Speichern & Verbinden“. Der Cube startet neu, verbindet sich mit deinem Heim-WLAN und lädt die Daten. Danach verbindest du das Handy wieder mit deinem normalen WLAN (meist geschieht das von selbst).

Nach dem Verbinden zeigt der Boot-Screen '''5 Sekunden lang die IP-Adresse'''. Danach ist der Cube auch unter '''<code>http://wettercube.local</code>''' erreichbar. Unter Windows 11, macOS, iOS und Android funktioniert das direkt, ältere Windows-Versionen brauchen [https://support.apple.com/kb/DL999 Bonjour].

== Wenn die WLAN-Verbindung beim Start nicht klappt ==

Der Cube wartet beim Start bis zu '''15 Sekunden''' auf das WLAN. Klappt es nicht, öffnet er wieder das Einrichtungsportal. Das Portal bleibt '''3 Minuten''' offen, danach startet der Cube neu und versucht es erneut. Die gespeicherten Zugangsdaten bleiben dabei erhalten, im Portal ist das bisherige WLAN und der Standort schon vorausgewählt.

Ein späterer '''WLAN-Wechsel''' (neuer Router, neues Passwort) geht ohne Portal über die Web-Oberfläche, solange der Cube noch im alten Netz ist (siehe [[WetterCube/Einstellungen|Einstellungen]]).

[[Kategorie:Next]]

WetterCubePlus/Inbetriebnahme/en

2026-10-19T15:01:34Z

WetterCube: WetterCube Website

<div class="wc-sprachhinweis">Dies ist die englische Fassung. [[WetterCubePlus/Inbetriebnahme|Zur deutschen Fassung]]</div>

----

== 1. Install the firmware ==

'''Option A: Web installer (recommended, no development environment needed)'''

# [https://jppeterson-lab.github.io/WetterCubePlus/ Open the web installer] ('''Google Chrome''' or '''Microsoft Edge''' only, because of WebSerial).
# Connect the ESP32-S3 via '''USB-C''' and follow the instructions.
# '''Careful with the "erase device" dialog:''' if ticked, the installer erases the whole flash, including all '''settings and the Wi-Fi password'''. Do '''not''' tick it when you only want to reinstall without losing data.

'''Option B: Arduino IDE''' – see [[WetterCubePlus/Entwicklung/en|Development]]. After that, everything else works through updates over Wi-Fi (no more USB needed).

== 2. First setup ==

# The device starts with '''touch calibration''': tap the 4 crosshairs one after another. Afterwards the cube opens its '''own Wi-Fi "WetterCubePlus-Setup"'''.
# '''On your smartphone (or PC) open the Wi-Fi settings, look for "WetterCubePlus-Setup" in the list of available networks and connect to it.''' If the phone says that the network has no internet access, stay connected anyway.
# The browser now opens '''the cube's setup portal by itself'''. If that does not happen, open <code>http://192.168.4.1</code> in the browser.
# In the portal enter the '''credentials of your home Wi-Fi''' (choose the network, enter the password).
# Enter your location '''without umlauts''' (<code>Munchen</code> instead of <code>München</code>, <code>Koln</code> instead of <code>Köln</code>, <code>Dusseldorf</code> instead of <code>Düsseldorf</code>).
# Choose your DWD region / federal state (also used for the radar map).
# Save. The cube restarts and connects to your home Wi-Fi. Afterwards connect your phone to your normal Wi-Fi again (this usually happens by itself).

Afterwards the cube is reachable at '''<code>http://wettercubeplus.local</code>''' or the IP address shown on the display.

== Re-calibrate touch ==

Hold a finger on the display while powering on until "Neukalibrierung" appears, then let go.

== If the Wi-Fi connection fails at startup ==

At startup the cube tries '''twice''' (15 seconds each). If that fails it shows the setup mode ("WLAN-Verbindung fehlgeschlagen"). The saved credentials are kept, and the cube '''automatically retries every 60 seconds''' and restarts on success. When in doubt, read [[WetterCubePlus/Diagnose und Fehlersuche/en|<code>/log</code>]] (in setup mode at <code>http://192.168.4.1/log</code>).

[[Kategorie:Next]]
[[Kategorie:English]]

WetterCubePlus/Inbetriebnahme

2026-10-19T15:01:33Z

WetterCube: WetterCube Website

<div class="wc-sprachhinweis">[[WetterCubePlus/Inbetriebnahme/en|English version]]</div>

----

== 1. Firmware aufspielen ==

'''Variante A: Web-Installer (empfohlen, keine Entwicklungsumgebung nötig)'''

# [https://jppeterson-lab.github.io/WetterCubePlus/ Web-Installer öffnen] (nur '''Google Chrome''' oder '''Microsoft Edge''', wegen WebSerial).
# ESP32-S3 per '''USB-C''' verbinden und den Anweisungen folgen.
# '''Achtung beim Dialog „Gerät löschen“:''' Wird er angehakt, löscht der Installer den gesamten Flash und damit auch alle '''Einstellungen und das WLAN-Passwort'''. Für ein reines Neuaufspielen ohne Datenverlust '''nicht''' anhaken.

'''Variante B: Arduino IDE''' – siehe [[WetterCubePlus/Entwicklung|Entwicklung]]. Danach läuft alles Weitere per Update über WLAN (kein USB mehr nötig).

== 2. Erstkonfiguration ==

# Das Gerät startet mit der '''Touch-Kalibrierung''': die 4 Kreuzmarkierungen nacheinander antippen. Danach macht der Cube sein '''eigenes WLAN „WetterCubePlus-Setup“''' auf.
# '''Öffne am Smartphone (oder PC) die WLAN-Einstellungen, suche in der Liste der verfügbaren Netze nach „WetterCubePlus-Setup“ und verbinde dich damit.''' Meldet das Handy, dass das Netz keinen Internetzugang hat, bleibst du trotzdem verbunden.
# Jetzt öffnet der Browser '''von selbst das Einrichtungsportal des Cubes'''. Passiert das nicht, rufe im Browser <code>http://192.168.4.1</code> auf.
# Gib im Portal die '''Zugangsdaten deines Heim-WLANs''' ein (Netz auswählen, Passwort eintragen).
# Standort eingeben, '''ohne Umlaute''' (<code>Munchen</code> statt <code>München</code>, <code>Koln</code> statt <code>Köln</code>, <code>Dusseldorf</code> statt <code>Düsseldorf</code>).
# DWD-Region / Bundesland wählen (gilt auch für die Radarkarte).
# Speichern. Der Cube startet neu und verbindet sich mit deinem Heim-WLAN. Danach verbindest du das Handy wieder mit deinem normalen WLAN (meist geschieht das von selbst).

Danach ist der Cube unter '''<code>http://wettercubeplus.local</code>''' oder der auf dem Display angezeigten IP-Adresse erreichbar.

== Touch neu kalibrieren ==

Beim Einschalten den Finger auf das Display halten, bis „Neukalibrierung“ erscheint, dann loslassen.

== Wenn die WLAN-Verbindung beim Start nicht klappt ==

Der Cube versucht es beim Start '''zweimal''' (je 15 Sekunden). Klappt es nicht, zeigt er den Einrichtungsmodus („WLAN-Verbindung fehlgeschlagen“). Die gespeicherten Zugangsdaten bleiben erhalten, und der Cube '''versucht alle 60 Sekunden automatisch erneut''', sich zu verbinden, und startet bei Erfolg selbst neu. Lies im Zweifel das [[WetterCubePlus/Diagnose und Fehlersuche|<code>/log</code>]] (im Einrichtungsmodus unter <code>http://192.168.4.1/log</code>).

[[Kategorie:Next]]

WetterCubePlus/Hardware und Verkabelung/en

2026-10-19T15:01:30Z

WetterCube: WetterCube Website

<div class="wc-sprachhinweis">Dies ist die englische Fassung. [[WetterCubePlus/Hardware und Verkabelung|Zur deutschen Fassung]]</div>

----

'''Note on assembly:''' The WetterCubePlus is aimed at people with some knowledge of electronics: during assembly, cables have to be crimped and parts soldered. If you do not want that, the [https://github.com/JPPeterson-lab/WetterCube-Fusion WetterCube Fusion] is the better choice. That is why, for the newer devices (Fusion and Next), I rely on complete boards with an integrated display: building is easy even for people who know nothing about wiring up an ESP32 and the like.

== Parts ==

{| class="wikitable"
! Component !! Type
|-
| Microcontroller || ESP32-S3 '''N16R8''' (16 MB flash, 8 MB OPI PSRAM)
|-
| Display || ILI9488, 3.5", 480×320 pixels, SPI ("3.5'' TFT SPI 480x320" module)
|-
| Touch || XPT2046, resistive, '''separate SPI bus'''
|-
| Backlight || PWM via the ESP-IDF LEDC driver, GPIO 17
|}

== Display (ILI9488), SPI2 ==

{| class="wikitable"
! Display pin !! ESP32-S3 !! Note
|-
| VCC || 3.3 V || '''not 5 V'''
|-
| GND || GND ||
|-
| CS || GPIO 15 || chip select
|-
| RST || GPIO 16 || reset
|-
| DC / RS || GPIO 2 || data/command
|-
| MOSI / SDI || GPIO 13 || SPI data
|-
| SCK / CLK || GPIO 14 || SPI clock
|-
| LED / BL || GPIO 17 || backlight (PWM)
|-
| MISO / SDO || GPIO 12 || optional (read commands only)
|}

== Touch (XPT2046), separate bus SPI3 ==

The module has '''its own touch pins''': <code>T_CLK</code>, <code>T_DIN</code> and <code>T_DO</code> are '''not''' connected to the display's <code>SCK</code>, <code>SDI</code> and <code>SDO</code>.

{| class="wikitable"
! Touch pin !! ESP32-S3 !! Note
|-
| T_CLK || GPIO 6 || separate bus
|-
| T_DIN || GPIO 7 || touch MOSI
|-
| T_DO || GPIO 8 || touch MISO
|-
| T_CS || GPIO 21 || chip select
|-
| T_IRQ || GPIO 18 || not used (touch is polled)
|}

== Power supply ==

{| class="wikitable"
! ESP32-S3 !! Connection
|-
| 5V / VIN || USB or external 5 V
|-
| 3.3 V || display VCC and touch VCC
|-
| GND || common ground
|}

The ESP32-S3 draws short current peaks when transmitting over Wi-Fi, on top of the display and backlight. A '''power supply of at least 5 V / 2 A''' and a '''short, thick USB cable''' are recommended. A weak supply or cable can cause Wi-Fi failures or a brownout reset at cold start (see [[WetterCubePlus/Diagnose und Fehlersuche/en|Diagnostics and troubleshooting]]).

== Case to print yourself ==

The case from the photos (lower part and lid, version 2) is available for free as 3MF files: [https://github.com/JPPeterson-lab/WetterCubePlus/tree/main/gehaeuse folder <code>gehaeuse/</code> on GitHub]. Outer size according to the file: lower part 108 × 91.4 × 75.8 mm, lid 108 × 66.1 × 66.3 mm (width × depth × height). Print settings (material, layer height, supports) are not stored in the files. Licence of the files: CC BY-NC 4.0.

== Notes ==

* '''Do not use GPIO 33–37!''' On the N16R8 they are reserved internally for the OPI PSRAM.
* '''GPIO 19/20''' are USB D−/D+; avoid them for normal I/O.
* '''GPIO 0''' is a strapping pin (boot); use it as an input only with a pull-up.
* The display module usually has its own 3.3 V level shifter. Even if the module can run on 5 V: apply only 3.3 V to VCC unless a separate 3.3 V input exists.
* The backlight can be connected directly to GPIO 17. For brighter LEDs use an NPN transistor (e.g. BC547) as a switch.
* '''LovyanGFX''' is used as the display driver (not TFT_eSPI): it copes with the ESP32-S3 PSRAM and the separate touch SPI bus.

The wiring is also in the repository: [https://github.com/JPPeterson-lab/WetterCubePlus/blob/main/WIRING.md <code>WIRING.md</code>].

[[Kategorie:Next]]
[[Kategorie:English]]

WetterCubePlus/Hardware und Verkabelung

2026-10-19T15:01:29Z

WetterCube: WetterCube Website

<div class="wc-sprachhinweis">[[WetterCubePlus/Hardware und Verkabelung/en|English version]]</div>

----

'''Hinweis zum Aufbau:''' Der WetterCubePlus richtet sich an Leute mit etwas Elektronik-Kenntnis: Beim Aufbau müssen Kabel gecrimpt und Bauteile gelötet werden. Wer das nicht möchte, ist mit dem [https://github.com/JPPeterson-lab/WetterCube-Fusion WetterCube Fusion] besser bedient. Bei den neueren Geräten (Fusion und Next) setze ich deshalb auf komplette Boards mit integriertem Display: Der Bau ist so auch für Leute einfach, die sich mit dem Verkabeln von ESP32 und Co. nicht auskennen.

== Bauteile ==

{| class="wikitable"
! Komponente !! Typ
|-
| Mikrocontroller || ESP32-S3 '''N16R8''' (16 MB Flash, 8 MB OPI-PSRAM)
|-
| Display || ILI9488, 3,5", 480×320 Pixel, SPI (Modul „3.5'' TFT SPI 480x320“)
|-
| Touch || XPT2046, resistiv, '''eigener SPI-Bus'''
|-
| Hintergrundbeleuchtung || PWM über den ESP-IDF-LEDC-Treiber, GPIO 17
|}

== Display (ILI9488), SPI2 ==

{| class="wikitable"
! Display-Pin !! ESP32-S3 !! Hinweis
|-
| VCC || 3,3 V || '''nicht 5 V'''
|-
| GND || GND ||
|-
| CS || GPIO 15 || Chip Select
|-
| RST || GPIO 16 || Reset
|-
| DC / RS || GPIO 2 || Daten/Befehl
|-
| MOSI / SDI || GPIO 13 || SPI-Daten
|-
| SCK / CLK || GPIO 14 || SPI-Takt
|-
| LED / BL || GPIO 17 || Hintergrundlicht (PWM)
|-
| MISO / SDO || GPIO 12 || optional (nur für Lesebefehle)
|}

== Touch (XPT2046), eigener Bus SPI3 ==

Das Modul hat '''eigene Touch-Pins''': <code>T_CLK</code>, <code>T_DIN</code> und <code>T_DO</code> sind '''nicht''' mit <code>SCK</code>, <code>SDI</code> und <code>SDO</code> des Displays verbunden.

{| class="wikitable"
! Touch-Pin !! ESP32-S3 !! Hinweis
|-
| T_CLK || GPIO 6 || eigener Bus
|-
| T_DIN || GPIO 7 || Touch-MOSI
|-
| T_DO || GPIO 8 || Touch-MISO
|-
| T_CS || GPIO 21 || Chip Select
|-
| T_IRQ || GPIO 18 || nicht genutzt (der Touch wird abgefragt)
|}

== Spannungsversorgung ==

{| class="wikitable"
! ESP32-S3 !! Anschluss
|-
| 5V / VIN || USB oder extern 5 V
|-
| 3,3 V || Display-VCC und Touch-VCC
|-
| GND || gemeinsame Masse
|}

Der ESP32-S3 braucht beim WLAN-Senden kurze Stromspitzen, dazu kommen Display und Hintergrundlicht. Empfohlen sind ein '''Netzteil mit mindestens 5 V / 2 A''' und ein '''kurzes, dickes USB-Kabel'''. Ein schwaches Netzteil oder Kabel kann beim Kaltstart zu WLAN-Fehlern oder einem Brownout-Reset führen (siehe [[WetterCubePlus/Diagnose und Fehlersuche|Diagnose und Fehlersuche]]).

== Gehäuse zum Selbstdrucken ==

Das Gehäuse aus den Fotos (Unterteil und Deckel, Version 2) gibt es kostenlos als 3MF-Dateien zum Download: [https://github.com/JPPeterson-lab/WetterCubePlus/tree/main/gehaeuse Ordner <code>gehaeuse/</code> auf GitHub]. Außenmaße laut Datei: Unterteil 108 × 91,4 × 75,8 mm, Deckel 108 × 66,1 × 66,3 mm (Breite × Tiefe × Höhe). Druckeinstellungen (Material, Schichthöhe, Stützen) sind in den Dateien nicht hinterlegt. Lizenz der Dateien: CC BY-NC 4.0.

== Hinweise ==

* '''GPIO 33–37 nicht verwenden!''' Sie sind beim N16R8 intern für das OPI-PSRAM reserviert.
* '''GPIO 19/20''' sind USB D−/D+, für normale Ein-/Ausgänge vermeiden.
* '''GPIO 0''' ist ein Strapping-Pin (Boot), als Eingang nur mit Pull-Up verwenden.
* Das Display-Modul hat meist einen eigenen 3,3-V-Pegelwandler. Auch wenn das Modul mit 5 V arbeiten kann: an VCC nur 3,3 V anlegen, sofern kein getrennter 3,3-V-Eingang vorhanden ist.
* Die Hintergrundbeleuchtung kann direkt an GPIO 17 hängen. Für hellere LEDs einen NPN-Transistor (z. B. BC547) als Schalter verwenden.
* Als Display-Treiber wird '''LovyanGFX''' verwendet (nicht TFT_eSPI): Es kommt mit dem PSRAM des ESP32-S3 und dem separaten Touch-SPI-Bus zurecht.

Die Verkabelung steht auch im Repository: [https://github.com/JPPeterson-lab/WetterCubePlus/blob/main/WIRING.md <code>WIRING.md</code>].

[[Kategorie:Next]]

WetterCubePlus/Entwicklung/en

2026-10-19T15:01:28Z

WetterCube: WetterCube Website

<div class="wc-sprachhinweis">Dies ist die englische Fassung. [[WetterCubePlus/Entwicklung|Zur deutschen Fassung]]</div>

----

== Repository layout ==

{| class="wikitable"
! File / folder !! Content
|-
| <code>WetterCubePlus.ino</code> || main program (Wi-Fi, data fetching, UI filling, web interface, calculator, game)
|-
| <code>webui_html.h</code> || HTML of the web interface and the setup portal
|-
| <code>build_opt.h</code> || compiler switches (<code>-Os</code>, <code>LV_COLOR_16_SWAP</code>, <code>LV_MEM_SIZE</code>, <code>LV_MEM_PSRAM</code>)
|-
| <code>lv_conf.h.example</code> || LVGL configuration (copy as <code>lv_conf.h</code> into the Arduino <code>libraries</code> folder)
|-
| <code>partitions.csv</code> || custom partition table (2× 4 MB app, rest SPIFFS)
|-
| <code>src/ui/</code> || '''PicoPixel''' export of the user interface (LVGL 8)
|-
| <code>WetterAmpel/</code> || firmware of the ESP32-C3 add-on
|-
| <code>docs/</code> || GitHub Pages: web installer, <code>version.json</code>, <code>manifest.json</code>, <code>firmware/*.bin</code>
|-
| <code>screenshots/</code> || photos for the README and this wiki
|-
| <code>bump_version.sh</code>, <code>deploy_ui.sh</code> || helper scripts (see below)
|-
| <code>CHANGELOG.md</code> / <code>CHANGELOG.en.md</code>, <code>DEVLOG.md</code> || changes (bilingual) and development diary
|}

== Building ==

'''Arduino IDE:''' board ''ESP32S3 Dev Module'', PSRAM ''OPI PSRAM'', Flash Size ''16 MB'', Partition Scheme ''Custom''. Libraries: LovyanGFX (≥ 1.2), LVGL 8.3.x, ArduinoJson. Also provide <code>lv_conf.h</code> (see the section "Manual Installation" in the [https://github.com/JPPeterson-lab/WetterCubePlus#readme README]).

'''Command line:'''

<pre>
arduino-cli compile --fqbn "esp32:esp32:esp32s3:PSRAM=opi,FlashSize=16M,PartitionScheme=custom,UploadSpeed=921600" .
</pre>

Without these options the compiler wrongly reports "sketch too big", because the default partition table applies.

<div class="wc-box">'''Cache trap:''' After every change to <code>build_opt.h</code>, clear the Arduino sketch cache (<code>~/Library/Caches/arduino/sketches/…</code>) and restart the IDE, otherwise the new switches are not applied. '''Duplicate files:''' If the Arduino library folder lives in iCloud, conflict copies such as <code>file 3.c</code> sometimes appear. They cause "multiple definition" link errors and must be deleted.</div>

== Memory ==

{| class="wikitable"
! Memory !! Use
|-
| '''Internal RAM''' (about 320 KB usable) || variables, heap (Wi-Fi; HTTPS/TLS needs about 40–50 KB), stacks
|-
| '''PSRAM''' (8 MB, slower) || '''LVGL memory''' (<code>-DLV_MEM_PSRAM</code>), draw buffers, radar image, game board, large downloads
|-
| '''Flash''' (16 MB) || program, icons, fonts, settings (NVS)
|}

Since v1.3.0 the LVGL memory lives in PSRAM. That gave the internal heap about 130 KB back (lowest heap level from 25 KB to about 157 KB). With <code>LV_MEM_PSRAM</code>, <code>lv_mem_monitor()</code> returns no values, so the sketch uses the free PSRAM instead.

'''Partitions (16 MB flash):'''

{| class="wikitable"
! Partition !! Size !! Purpose
|-
| <code>nvs</code> || 20 KB || settings (Wi-Fi, brightness, high scores …), kept across updates
|-
| <code>otadata</code> || 8 KB || remembers the active app slot
|-
| <code>app0</code>, <code>app1</code> || 4 MB each || two firmware slots: an update is written to the other one, then the device switches
|-
| <code>spiffs</code> || about 8 MB || reserved, '''not used''' in the code
|}

The firmware currently takes about 2.8 MB; about 1.4 MB remain free in the 4 MB slot. '''Icons''' are therefore created at '''128×128''' (a 256 icon costs 196 KB, a 128 one 49 KB). The partition table cannot be changed by an update, only via USB or the web installer.

== User interface with PicoPixel ==

# Export from PicoPixel to <code>src/ui/</code>.
# Run '''<code>./deploy_ui.sh</code>'''. The script adapts the export (LVGL include, image files <code>.c</code> → <code>.inc</code>, 0xff color fix, <code>FADE_IN</code> → <code>NONE</code> to avoid a crash, special character <code>²</code>) and checks that all objects used by the sketch still exist.
# Check after every export: PicoPixel '''occasionally renumbers button names'''; the wiring (<code>REG_CB</code>) in the sketch must match the names.
# Icons: upload new images at 128×128 and create them at 83×83; PicoPixel computes the zoom from widget and image size itself. Icons set at runtime need their own zoom (<code>setWetterIcon()</code> in the sketch).

== Release process ==

# <code>bash bump_version.sh X.Y.Z</code> sets the version everywhere (firmware, <code>version.json</code>, <code>manifest.json</code>, web page, README badges).
# Update <code>CHANGELOG.md</code> '''and''' <code>CHANGELOG.en.md</code>, plus <code>DEVLOG.md</code>.
# In the Arduino IDE use '''Sketch → Export Compiled Binary'''; <code>firmware.bin</code> must end up in <code>docs/firmware/</code>.
# <code>bash bump_version.sh --check</code> verifies that everything is consistent and the binary contains the version.
# Before committing, check the diff for '''credentials''' (the repo is public), then commit, push, create the tag <code>vX.Y.Z</code> and a GitHub release with the four files <code>bootloader.bin</code>, <code>boot_app0.bin</code>, <code>partitions.bin</code>, <code>firmware.bin</code>.

Devices fetch <code>version.json</code> via <code>raw.githubusercontent.com</code> and the firmware from GitHub Pages (<code>docs/firmware/firmware.bin</code>). A device only offers '''higher''' version numbers.

== License and credits ==

The source code is licensed under the '''Apache License 2.0''' (see <code>LICENSE</code> and <code>NOTICE</code>; versions up to v2.1.2 are under CC BY-NC 4.0), texts, images and the 3D-print files under CC BY-NC 4.0 (<code>LICENSE-Dokumentation.txt</code>); the weather icons are from [https://github.com/basmilius/weather-icons Meteocons] (MIT, since version 1.6.5; formerly Dovora), the font is Montserrat (SIL OFL 1.1), the UI control icons (home, gear, arrows, plus, calculator, game) from [https://github.com/icons8/flat-color-icons Icons8 Flat Color Icons] (MIT or Good Boy License); details in <code>CREDITS.md</code>.

[[Kategorie:Next]]
[[Kategorie:English]]

WetterCubePlus/Entwicklung

2026-10-19T15:01:27Z

WetterCube: WetterCube Website

<div class="wc-sprachhinweis">[[WetterCubePlus/Entwicklung/en|English version]]</div>

----

== Aufbau des Repositorys ==

{| class="wikitable"
! Datei / Ordner !! Inhalt
|-
| <code>WetterCubePlus.ino</code> || Hauptprogramm (WLAN, Datenabruf, UI-Befüllung, Web-Oberfläche, Rechner, Spiel)
|-
| <code>webui_html.h</code> || HTML der Web-Oberfläche und des Einrichtungsportals
|-
| <code>build_opt.h</code> || Compiler-Schalter (<code>-Os</code>, <code>LV_COLOR_16_SWAP</code>, <code>LV_MEM_SIZE</code>, <code>LV_MEM_PSRAM</code>)
|-
| <code>lv_conf.h.example</code> || LVGL-Konfiguration (als <code>lv_conf.h</code> in den Arduino-<code>libraries</code>-Ordner kopieren)
|-
| <code>partitions.csv</code> || eigene Partitionstabelle (2× 4 MB App, Rest SPIFFS)
|-
| <code>src/ui/</code> || '''PicoPixel'''-Export der Oberfläche (LVGL 8)
|-
| <code>WetterAmpel/</code> || Firmware des ESP32-C3-Zusatzgeräts
|-
| <code>docs/</code> || GitHub Pages: Web-Installer, <code>version.json</code>, <code>manifest.json</code>, <code>firmware/*.bin</code>
|-
| <code>screenshots/</code> || Fotos für die README und dieses Wiki
|-
| <code>bump_version.sh</code>, <code>deploy_ui.sh</code> || Hilfsskripte (siehe unten)
|-
| <code>CHANGELOG.md</code> / <code>CHANGELOG.en.md</code>, <code>DEVLOG.md</code> || Änderungen (zweisprachig) und Entwicklungs-Tagebuch
|}

== Bauen ==

'''Arduino IDE:''' Board ''ESP32S3 Dev Module'', PSRAM ''OPI PSRAM'', Flash Size ''16 MB'', Partition Scheme ''Custom''. Bibliotheken: LovyanGFX (≥ 1.2), LVGL 8.3.x, ArduinoJson. Zusätzlich <code>lv_conf.h</code> bereitstellen (siehe Abschnitt „Manuelle Installation“ in der [https://github.com/JPPeterson-lab/WetterCubePlus#readme README]).

'''Kommandozeile:'''

<pre>
arduino-cli compile --fqbn "esp32:esp32:esp32s3:PSRAM=opi,FlashSize=16M,PartitionScheme=custom,UploadSpeed=921600" .
</pre>

Ohne diese Optionen meldet der Compiler fälschlich „Sketch zu groß“, weil dann die Standard-Partitionstabelle gilt.

<div class="wc-box">'''Cache-Falle:''' Nach jeder Änderung an <code>build_opt.h</code> den Arduino-Sketch-Cache leeren (<code>~/Library/Caches/arduino/sketches/…</code>) und die IDE neu starten, sonst werden die neuen Schalter nicht übernommen. '''Doppelte Dateien:''' Liegt die Arduino-Bibliothek in einem iCloud-Ordner, entstehen manchmal Konfliktkopien wie <code>datei 3.c</code>. Sie führen zu „multiple definition“-Fehlern beim Linken und müssen gelöscht werden.</div>

== Speicher ==

{| class="wikitable"
! Speicher !! Verwendung
|-
| '''Interner RAM''' (ca. 320 KB nutzbar) || Variablen, Heap (WLAN, HTTPS/TLS braucht ca. 40–50 KB), Stacks
|-
| '''PSRAM''' (8 MB, langsamer) || '''LVGL-Speicher''' (<code>-DLV_MEM_PSRAM</code>), Zeichenpuffer, Radarbild, Spielfeld, große Downloads
|-
| '''Flash''' (16 MB) || Programm, Icons, Schriften, Einstellungen (NVS)
|}

Der LVGL-Speicher liegt seit v1.3.0 im PSRAM. Das gab dem internen Heap etwa 130 KB zurück (tiefster Heap-Stand von 25 KB auf ca. 157 KB). Mit <code>LV_MEM_PSRAM</code> liefert <code>lv_mem_monitor()</code> keine Werte, der Sketch nutzt dann den freien PSRAM.

'''Partitionen (16 MB Flash):'''

{| class="wikitable"
! Partition !! Größe !! Zweck
|-
| <code>nvs</code> || 20 KB || Einstellungen (WLAN, Helligkeit, Bestenliste …), bleibt bei Updates erhalten
|-
| <code>otadata</code> || 8 KB || merkt sich den aktiven App-Slot
|-
| <code>app0</code>, <code>app1</code> || je 4 MB || zwei Firmware-Plätze: das Update wird in den jeweils anderen geschrieben, dann wird umgeschaltet
|-
| <code>spiffs</code> || ca. 8 MB || reserviert, im Code '''nicht genutzt'''
|}

Die Firmware belegt aktuell ca. 2,8 MB; im 4-MB-Slot bleiben rund 1,4 MB frei. '''Icons''' werden daher als '''128×128''' angelegt (ein 256er-Icon kostet 196 KB, ein 128er 49 KB). Die Partitionstabelle lässt sich nicht per Update ändern, nur per USB oder Web-Installer.

== Oberfläche mit PicoPixel ==

# In PicoPixel nach <code>src/ui/</code> exportieren.
# '''<code>./deploy_ui.sh</code>''' ausführen. Das Skript passt den Export an (LVGL-Include, Bilddateien <code>.c</code> → <code>.inc</code>, Farbfix 0xff, <code>FADE_IN</code> → <code>NONE</code> gegen einen Absturz, Sonderzeichen <code>²</code>) und prüft, ob alle vom Sketch verwendeten Objekte noch existieren.
# Nach jedem Export prüfen: PicoPixel '''nummeriert Button-Namen gelegentlich neu'''; die Verdrahtung (<code>REG_CB</code>) im Sketch muss zu den Namen passen.
# Icons: neue Bilder als 128×128 hochladen und mit 83×83 anlegen; PicoPixel rechnet den Zoom aus Widget- und Bildgröße selbst. Zur Laufzeit gesetzte Icons brauchen einen eigenen Zoom (<code>setWetterIcon()</code> im Sketch).

== Release-Ablauf ==

# <code>bash bump_version.sh X.Y.Z</code> setzt die Version überall (Firmware, <code>version.json</code>, <code>manifest.json</code>, Webseite, README-Badges).
# <code>CHANGELOG.md</code> '''und''' <code>CHANGELOG.en.md</code> ergänzen, außerdem <code>DEVLOG.md</code>.
# In der Arduino IDE '''Sketch → Export Compiled Binary'''; die <code>firmware.bin</code> muss in <code>docs/firmware/</code> liegen.
# <code>bash bump_version.sh --check</code> prüft, dass alles konsistent ist und das Binary die Version enthält.
# Vor dem Commit den Diff auf '''Zugangsdaten''' prüfen (das Repo ist öffentlich), dann committen, pushen, Tag <code>vX.Y.Z</code> setzen und ein GitHub-Release mit den vier Dateien <code>bootloader.bin</code>, <code>boot_app0.bin</code>, <code>partitions.bin</code>, <code>firmware.bin</code> anlegen.

Die Geräte holen <code>version.json</code> über <code>raw.githubusercontent.com</code> und die Firmware von GitHub Pages (<code>docs/firmware/firmware.bin</code>). Es gilt: Ein Gerät bietet nur '''höhere''' Versionsnummern an.

== Lizenz und Credits ==

Der Quellcode steht unter der '''Apache-Lizenz 2.0''' (siehe <code>LICENSE</code> und <code>NOTICE</code>; Versionen bis v2.1.2 stehen unter CC BY-NC 4.0), Texte, Bilder und die 3D-Druckdateien unter CC BY-NC 4.0 (<code>LICENSE-Dokumentation.txt</code>); die Wetter-Icons stammen von [https://github.com/basmilius/weather-icons Meteocons] (MIT, seit Version 1.6.5; früher Dovora), die Schrift ist Montserrat (SIL OFL 1.1), die Bedienelemente-Icons (Home, Zahnrad, Pfeile, Plus, Rechner, Spiel) von [https://github.com/icons8/flat-color-icons Icons8 Flat Color Icons] (MIT oder Good Boy License); Details in <code>CREDITS.md</code>.

[[Kategorie:Next]]

Next/Inbetriebnahme/en

2026-10-19T15:01:18Z

WetterCube: WetterCube Website

<div class="wc-sprachhinweis">Dies ist die englische Fassung. [[Next/Inbetriebnahme|Zur deutschen Fassung]]</div>

----

# '''Install the firmware (only for the ESP32 CYD ESP32-2432S028, other boards are not supported):''' connect the CYD via USB, open the [https://jppeterson-lab.github.io/WetterCube-Next/ web installer] in '''Chrome or Edge''' and install. The installation erases the CYD's flash (also foreign software and saved Wi-Fi data).
# '''Set up Wi-Fi:''' the device shows "Einrichtung" (setup) and opens its '''own Wi-Fi "WetterCube-Next-Setup"'''. '''On your phone (or PC) open the Wi-Fi settings, look for "WetterCube-Next-Setup" in the list of available networks and connect to it.''' If the phone says that the network has no internet access, stay connected anyway. The browser then opens '''the cube's setup portal by itself''' (otherwise open <code>192.168.4.1</code>). There choose your '''home Wi-Fi''', enter the password, optionally the address of the Fusion, and tap "Speichern und neu starten" (save and restart). Afterwards connect your phone to your normal Wi-Fi again.
# '''Find the Fusion:''' Next looks for the Fusion via mDNS. If "Suche die Fusion..." stays on screen, enter its address in the web interface (<code>http://wettercube-next.local</code>, section Fusion).
# '''Choose rooms:''' open the section "Räume" in the web interface and tick up to four sensor values.

Requires the Fusion from '''v0.9.9-alpha6''' on the same network.

[[Kategorie:Next]]
[[Kategorie:English]]

Next/Inbetriebnahme

2026-10-19T15:01:18Z

WetterCube: WetterCube Website

<div class="wc-sprachhinweis">[[Next/Inbetriebnahme/en|English version]]</div>

----

# '''Firmware installieren (nur für das ESP32 CYD ESP32-2432S028, andere Boards werden nicht unterstützt):''' CYD per USB anschließen, den [https://jppeterson-lab.github.io/WetterCube-Next/ Web-Installer] in '''Chrome oder Edge''' öffnen und installieren. Die Installation löscht den Flash des CYD (auch eine fremde Software darauf und gespeicherte WLAN-Daten).
# '''WLAN einrichten:''' Das Gerät zeigt „Einrichtung“ und macht sein '''eigenes WLAN „WetterCube-Next-Setup“''' auf. '''Öffne am Handy (oder PC) die WLAN-Einstellungen, suche in der Liste der verfügbaren Netze nach „WetterCube-Next-Setup“ und verbinde dich damit.''' Meldet das Handy, dass das Netz keinen Internetzugang hat, bleibst du trotzdem verbunden. Danach öffnet der Browser '''von selbst das Einrichtungsportal des Cubes''' (sonst <code>192.168.4.1</code> aufrufen). Wähle dort dein '''Heim-WLAN''', trage das Passwort ein, auf Wunsch die Adresse der Fusion, und tippe auf „Speichern und neu starten“. Danach verbindest du das Handy wieder mit deinem normalen WLAN.
# '''Fusion finden:''' Das Next sucht die Fusion über mDNS. Steht „Suche die Fusion...“ länger, trage ihre Adresse in der Weboberfläche ein (<code>http://wettercube-next.local</code>, Abschnitt Fusion).
# '''Räume wählen:''' In der Weboberfläche den Abschnitt „Räume“ öffnen und bis zu vier Sensorwerte ankreuzen.

Voraussetzung: Die Fusion läuft ab '''v0.9.9-alpha6''' im selben Netz (WLAN/LAN).

[[Kategorie:Next]]

Next/Start/en

2026-10-19T15:01:17Z

WetterCube: WetterCube Website

<div class="wc-sprachhinweis">Dies ist die englische Fassung. [[Next/Start|Zur deutschen Fassung]]</div>

----

<gallery mode="packed" heights="260px">
Datei:next-temperatur-biowetter.png|Page 1: temperature and bio-weather
Datei:next-allergene-vorhersage.png|Page 2: allergens and forecast
Datei:next-temperatur-biowetter-nacht.png|At night: page 1
Datei:next-allergene-vorhersage-nacht.png|At night: page 2
</gallery>
'''WetterCube Next''' is an additional module for the [https://github.com/JPPeterson-lab/WetterCube-Next WetterCube Fusion]: a small '''ESP32 CYD''' (2.8", 320×240) shows data from the Fusion, for example temperature and bio-weather in the office, allergens and forecast in the bedroom. No MQTT broker needed.

<div class="wc-box">'''Status:''' alpha (version 0.1.0-alpha4). Requires a WetterCube Fusion from v0.9.9-alpha6 on the same network.</div>

Pages: [[Next/Roadmap/en|Roadmap]], [[Next/Hardware/en|Hardware]], [[Next/Inbetriebnahme/en|Inbetriebnahme]] (setup), [[Next/Einstellungen/en|Einstellungen]] (settings), [[Next/Anbindung an die Fusion/en|Anbindung an die Fusion]] (connection to the Fusion), [[Next/Updates/en|Updates]], [[Next/Diagnose und Fehlersuche/en|Diagnose und Fehlersuche]] (troubleshooting), [[Next/Entwicklung/en|Entwicklung]] (development).

[[Kategorie:Next]]
[[Kategorie:English]]

Next/Start

2026-10-19T15:01:16Z

WetterCube: WetterCube Website

<div class="wc-sprachhinweis">[[Next/Start/en|English version]]</div>

----

<gallery mode="packed" heights="260px">
Datei:next-temperatur-biowetter.png|Seite 1: Temperatur und Biowetter
Datei:next-allergene-vorhersage.png|Seite 2: Allergene und Vorhersage
Datei:next-temperatur-biowetter-nacht.png|Nachts: Seite 1
Datei:next-allergene-vorhersage-nacht.png|Nachts: Seite 2
</gallery>
'''WetterCube Next''' ist ein zusätzliches Modul zur [https://github.com/JPPeterson-lab/WetterCube-Next WetterCube Fusion]: ein kleiner '''ESP32 CYD''' (2,8", 320×240) zeigt Daten der Fusion, zum Beispiel im Büro Temperatur und Biowetter, im Schlafzimmer Allergene und Vorhersage. Kein MQTT-Broker nötig.

<div class="wc-box">'''Status:''' Alpha (Version 0.1.0-alpha4). Voraussetzung: eine WetterCube Fusion ab v0.9.9-alpha6 im selben Netz.</div>

{| class="wikitable"
! Seite !! Inhalt
|-
| [[Next/Roadmap|Roadmap]] || Die WetterCube-Familie 2026–2027
|-
| [[Next/Hardware|Hardware]] || der CYD, Varianten, Anschlüsse
|-
| [[Next/Inbetriebnahme|Inbetriebnahme]] || Installation und Einrichtung
|-
| [[Next/Einstellungen|Einstellungen]] || Weboberfläche: Seiten, Räume, Display, WLAN
|-
| [[Next/Anbindung an die Fusion|Anbindung an die Fusion]] || <code>/api/next</code>, mDNS, was das Next anzeigt
|-
| [[Next/Updates|Updates]] || Update über GitHub oder per Datei, Rollback
|-
| [[Next/Diagnose und Fehlersuche|Diagnose und Fehlersuche]] || wenn etwas nicht klappt
|-
| [[Next/Entwicklung|Entwicklung]] || Aufbau des Repositorys, Bauen, Mitmachen, Lizenz
|}

[[Kategorie:Next]]

Next/Entwicklung/en

2026-10-19T15:01:13Z

WetterCube: WetterCube Website

<div class="wc-sprachhinweis">Dies ist die englische Fassung. [[Next/Entwicklung|Zur deutschen Fassung]]</div>

----

== Repository layout ==

{| class="wikitable"
! File / folder !! Content
|-
| <code>CMakeLists.txt</code>, <code>main/</code> || ESP-IDF project; <code>main/main.cpp</code> is the entry point
|-
| <code>sdkconfig.defaults</code>, <code>partitions.csv</code> || settings and partition table (ESP32 CYD, 4 MB flash)
|-
| <code>conf/lv_conf.h</code> || LVGL configuration (project copy)
|-
| <code>src/app/</code> || network task (<code>app.cpp</code>), data from the Fusion (<code>daten.cpp</code>), UI (<code>ui.cpp</code>), web interface (<code>webui.cpp</code>), update (<code>ota.cpp</code>)
|-
| <code>src/board/</code>, <code>src/display/</code> || board layer for the CYD (display ST7789/ILI9341, touch, backlight) and the LVGL glue
|-
| <code>src/platform/</code> || small compatibility layer for the Arduino names (<code>WiFi</code>, <code>HTTPClient</code>, <code>WebServer</code>, <code>Preferences</code>, <code>String</code> …), sits directly on ESP-IDF
|-
| <code>src/ui/</code>, <code>src/fonts/</code>, <code>src/icons/</code> || '''PicoPixel''' export of the UI (LVGL 8, 320×240), fonts, weather symbols
|-
| <code>tools/</code> || <code>deploy_ui.sh</code>, <code>wetter_icons.py</code>, <code>icon_kontur.py</code>
|-
| <code>assets/</code> || logo, roadmap graphic, screenshots, symbols
|-
| <code>docs/</code> || GitHub Pages: web installer, <code>version.json</code>, <code>manifest.json</code>, <code>firmware/*.bin</code>
|-
| <code>CHANGELOG.md</code> / <code>CHANGELOG.en.md</code> || changes (bilingual)
|}

== Building ==

Install ESP-IDF 5.5.x (<code>git clone --branch v5.5.5 --recursive https://github.com/espressif/esp-idf.git ~/esp/esp-idf-v5.5.5 && cd ~/esp/esp-idf-v5.5.5 && ./install.sh esp32</code>), then:

<pre>
bash build.sh # build (target esp32, ESP32 CYD; the first time the component manager downloads LVGL, ArduinoJson and mdns)
bash build.sh flash /dev/cu.xxx # build and flash (port from ls /dev/cu.*)
bash build.sh erstflash /dev/cu.xxx # erase the whole flash first, then build and flash (the first time on a CYD with foreign software)
bash build.sh clean # after changes to sdkconfig.defaults
</pre>

== UI with PicoPixel ==

# Export from [https://picopixel.io PicoPixel] to <code>src/ui/</code>.
# Run <code>./tools/deploy_ui.sh</code>: it prepares the export and checks that all objects wired by the code still exist.
# The weather symbols (style "flat" with outline) are produced by <code>python3 tools/wetter_icons.py</code> from the Meteocons.

== Update path ==

The firmware files in <code>docs/firmware/</code> and the releases are created by the maintainer. Please send pull requests '''without''' changes to <code>docs/firmware/</code>. The Next fetches <code>version.json</code> and the firmware from GitHub Pages and only offers '''higher''' versions. It gets the Fusion data over HTTP through <code>/api/next</code>.

== Contributing, licence and credits ==

The source code is licensed under the '''Apache License 2.0''' ([https://github.com/JPPeterson-lab/WetterCube-Next/blob/main/LICENSE LICENSE], [https://github.com/JPPeterson-lab/WetterCube-Next/blob/main/NOTICE NOTICE]), texts and images under CC BY-NC 4.0. The name and logos of "WetterCube" are not licensed. Pull requests and [https://github.com/JPPeterson-lab/WetterCube-Next/issues issues] are welcome, ideally with version, device and the text of <code>http://wettercube-next.local/log</code>; contributions are accepted under the Apache License 2.0. Third-party components and data: [https://github.com/JPPeterson-lab/WetterCube-Next/blob/main/CREDITS.md CREDITS].

[[Kategorie:Next]]
[[Kategorie:English]]

Next/Entwicklung

2026-10-19T15:01:12Z

WetterCube: WetterCube Website

<div class="wc-sprachhinweis">[[Next/Entwicklung/en|English version]]</div>

----

== Aufbau des Repositorys ==

{| class="wikitable"
! Datei / Ordner !! Inhalt
|-
| <code>CMakeLists.txt</code>, <code>main/</code> || ESP-IDF-Projekt; <code>main/main.cpp</code> ist der Einstieg
|-
| <code>sdkconfig.defaults</code>, <code>partitions.csv</code> || Einstellungen und Partitionstabelle (ESP32 CYD, 4 MB Flash)
|-
| <code>conf/lv_conf.h</code> || LVGL-Konfiguration (Projektkopie)
|-
| <code>src/app/</code> || Netzwerk-Task (<code>app.cpp</code>), Daten der Fusion (<code>daten.cpp</code>), Oberfläche (<code>ui.cpp</code>), Weboberfläche (<code>webui.cpp</code>), Update (<code>ota.cpp</code>)
|-
| <code>src/board/</code>, <code>src/display/</code> || Board-Schicht für den CYD (Display ST7789/ILI9341, Touch, Hintergrundlicht) und die LVGL-Anbindung
|-
| <code>src/platform/</code> || kleine Ersatzschicht für die Arduino-Namen (<code>WiFi</code>, <code>HTTPClient</code>, <code>WebServer</code>, <code>Preferences</code>, <code>String</code> …), setzt direkt auf ESP-IDF auf
|-
| <code>src/ui/</code>, <code>src/fonts/</code>, <code>src/icons/</code> || '''PicoPixel'''-Export der Oberfläche (LVGL 8, 320×240), Schriften, Wettersymbole
|-
| <code>tools/</code> || <code>deploy_ui.sh</code>, <code>wetter_icons.py</code>, <code>icon_kontur.py</code>
|-
| <code>assets/</code> || Logo, Roadmap-Grafik, Bildschirmfotos, Symbole
|-
| <code>docs/</code> || GitHub Pages: Web-Installer, <code>version.json</code>, <code>manifest.json</code>, <code>firmware/*.bin</code>
|-
| <code>CHANGELOG.md</code> / <code>CHANGELOG.en.md</code> || Änderungen (zweisprachig)
|}

== Bauen ==

ESP-IDF 5.5.x installieren (<code>git clone --branch v5.5.5 --recursive https://github.com/espressif/esp-idf.git ~/esp/esp-idf-v5.5.5 && cd ~/esp/esp-idf-v5.5.5 && ./install.sh esp32</code>), dann:

<pre>
bash build.sh # bauen (Ziel esp32, ESP32 CYD; beim ersten Mal lädt der Komponentenmanager LVGL, ArduinoJson und mdns)
bash build.sh flash /dev/cu.xxx # bauen und flashen (Port aus ls /dev/cu.*)
bash build.sh erstflash /dev/cu.xxx # erst den ganzen Flash löschen, dann bauen und flashen (beim ersten Mal auf einem CYD mit fremder Software)
bash build.sh clean # nach Änderungen an sdkconfig.defaults
</pre>

== Oberfläche mit PicoPixel ==

# In [https://picopixel.io PicoPixel] nach <code>src/ui/</code> exportieren.
# <code>./tools/deploy_ui.sh</code> ausführen: bereitet den Export auf und prüft, ob alle vom Code verdrahteten Objekte noch existieren.
# Die Wettersymbole (Stil „flat“ mit Kontur) erzeugt <code>python3 tools/wetter_icons.py</code> aus den Meteocons.

== Update-Weg ==

Die Firmware-Dateien in <code>docs/firmware/</code> und die Releases erstellt der Maintainer. Pull Requests bitte '''ohne''' Änderungen an <code>docs/firmware/</code>. Das Next holt <code>version.json</code> und die Firmware von GitHub Pages und bietet nur '''höhere''' Versionen an. Die Daten der Fusion holt es per HTTP über <code>/api/next</code>.

== Mitmachen, Lizenz und Credits ==

Der Quellcode steht unter der '''Apache-Lizenz 2.0''' ([https://github.com/JPPeterson-lab/WetterCube-Next/blob/main/LICENSE LICENSE], [https://github.com/JPPeterson-lab/WetterCube-Next/blob/main/NOTICE NOTICE]), Texte und Bilder unter CC BY-NC 4.0. Name und Logos von „WetterCube“ sind nicht freigegeben. Pull Requests und [https://github.com/JPPeterson-lab/WetterCube-Next/issues Issues] sind willkommen, am besten mit Version, Gerät und dem Text von <code>http://wettercube-next.local/log</code>; Beiträge werden unter der Apache-Lizenz 2.0 aufgenommen. Komponenten und Daten Dritter: [https://github.com/JPPeterson-lab/WetterCube-Next/blob/main/CREDITS.md CREDITS].

[[Kategorie:Next]]

Fusion/Inbetriebnahme/en

2026-10-19T15:00:49Z

WetterCube: WetterCube Website

<div class="wc-sprachhinweis">Dies ist die englische Fassung. [[Fusion/Inbetriebnahme|Zur deutschen Fassung]]</div>

----

== 1. Install the firmware ==

<div class="wc-box">'''Waveshare boards only:''' The web installer and the firmware are meant for the Waveshare ESP32-P4-WIFI6-Touch-LCD-7B and the Waveshare ESP32-S3-Touch-LCD-7B. Other boards are not supported and can cause problems.</div>

The firmware is installed with the '''web installer''', straight from the browser and without a development environment:

# [https://jppeterson-lab.github.io/WetterCube-Fusion/ Open the web installer] ('''Google Chrome''' or '''Microsoft Edge''' only, because of WebSerial).
# Connect the board with a '''USB-C data cable''' at the port labelled '''UART''' ("USB TO UART", on the P4 board as on the S3 board), choose "Install" and follow the instructions. If the board is not detected: hold the BOOT button while you plug in the cable or press RESET, then release it.
# '''Careful:''' the installation erases the flash, including '''settings and the Wi-Fi password'''. If you want to keep them, back up your settings in the web interface first (see [[Fusion/Einstellungen/en|Settings]]).

After that, everything else works through updates over Wi-Fi (no more USB needed). If you want to build the firmware yourself, see [[Fusion/Entwicklung/en|Development]].

== 2. First setup ==

# On first start (or if the Wi-Fi is unreachable) the display shows a hint. The cube now opens its '''own Wi-Fi "WetterCube-Fusion-Setup"'''.
# '''On your phone (or PC) open the Wi-Fi settings, look for "WetterCube-Fusion-Setup" in the list of available networks and connect to it.''' If the phone says that the network has no internet access, stay connected anyway.
# The browser now opens '''the cube's setup portal by itself'''. If that does not happen, open <code>http://192.168.4.1</code> in the browser.
# In the portal enter the '''credentials of your home Wi-Fi''' (choose the network, enter the password).
# Enter your location (city) '''without umlauts''' (<code>Munchen</code>, <code>Koln</code>).
# Choose your DWD region / federal state (used for pollen forecast and warnings).
# Save. The cube restarts, connects to your home Wi-Fi and loads the data. Afterwards connect your phone to your normal Wi-Fi again (this usually happens by itself).

Afterwards the device is reachable at '''<code>http://wettercube-fusion.local</code>'''.

== If the Wi-Fi connection fails at startup ==

At startup the device tries '''twice'''. If that fails it shows the setup mode. The saved credentials are kept, and the device then '''automatically retries regularly'''. When in doubt, read [[Fusion/Diagnose und Fehlersuche/en|<code>/log</code>]] (in setup mode at <code>http://192.168.4.1/log</code>).

[[Kategorie:Fusion]]
[[Kategorie:English]]

Fusion/Inbetriebnahme

2026-10-19T15:00:48Z

WetterCube: WetterCube Website

<div class="wc-sprachhinweis">[[Fusion/Inbetriebnahme/en|English version]]</div>

----

== 1. Firmware aufspielen ==

<div class="wc-box">'''Nur Waveshare-Boards:''' Der Web-Installer und die Firmware sind für das Waveshare ESP32-P4-WIFI6-Touch-LCD-7B und das Waveshare ESP32-S3-Touch-LCD-7B gedacht. Andere Boards werden nicht unterstützt und können Probleme machen.</div>

Die Firmware wird mit dem '''Web-Installer''' aufgespielt, direkt aus dem Browser und ohne Entwicklungsumgebung:

# [https://jppeterson-lab.github.io/WetterCube-Fusion/ Web-Installer öffnen] (nur '''Google Chrome''' oder '''Microsoft Edge''', wegen WebSerial).
# Board per '''USB-C-Datenkabel''' am Anschluss mit der Beschriftung '''UART''' („USB TO UART“) verbinden (beim P4- wie beim S3-Board), „Installieren“ wählen und den Anweisungen folgen. Wird das Board nicht erkannt: BOOT-Taste gedrückt halten, während du das Kabel ansteckst oder RESET drückst, dann loslassen.
# '''Achtung:''' Die Installation löscht den Flash und damit auch '''Einstellungen und WLAN-Passwort'''. Wer sie behalten will, sichert vorher in der Web-Oberfläche die Einstellungen (siehe [[Fusion/Einstellungen|Einstellungen]]).

Danach läuft alles Weitere per Update über WLAN (kein USB mehr nötig). Wer die Firmware selbst bauen möchte, findet alles unter [[Fusion/Entwicklung|Entwicklung]].

== 2. Erstkonfiguration ==

# Beim ersten Start (oder wenn das WLAN nicht erreichbar ist) zeigt das Display einen Hinweis. Der Cube macht jetzt sein '''eigenes WLAN „WetterCube-Fusion-Setup“''' auf.
# '''Öffne am Handy (oder PC) die WLAN-Einstellungen, suche in der Liste der verfügbaren Netze nach „WetterCube-Fusion-Setup“ und verbinde dich damit.''' Meldet das Handy, dass das Netz keinen Internetzugang hat, bleibst du trotzdem verbunden.
# Jetzt öffnet der Browser '''von selbst das Einrichtungsportal des Cubes'''. Passiert das nicht, rufe im Browser <code>http://192.168.4.1</code> auf.
# Gib im Portal die '''Zugangsdaten deines Heim-WLANs''' ein (Netz auswählen, Passwort eintragen).
# Standort (Stadt) eingeben, '''ohne Umlaute''' (<code>Munchen</code>, <code>Koln</code>).
# DWD-Region / Bundesland wählen (gilt für Pollenflug und Warnungen).
# Speichern. Der Cube startet neu, verbindet sich mit deinem Heim-WLAN und lädt die Daten. Danach verbindest du das Handy wieder mit deinem normalen WLAN (meist geschieht das von selbst).

Danach ist das Gerät unter '''<code>http://wettercube-fusion.local</code>''' erreichbar.

== Wenn die WLAN-Verbindung beim Start nicht klappt ==

Das Gerät versucht es beim Start '''zweimal'''. Klappt es nicht, zeigt es den Einrichtungsmodus. Die gespeicherten Zugangsdaten bleiben erhalten, und das Gerät versucht danach '''regelmäßig automatisch erneut''', sich zu verbinden. Im Zweifel das [[Fusion/Diagnose und Fehlersuche|<code>/log</code>]] lesen (im Einrichtungsmodus unter <code>http://192.168.4.1/log</code>).

[[Kategorie:Fusion]]

Fusion/Start/en

2026-10-19T15:00:47Z

WetterCube: WetterCube Website

<div class="wc-sprachhinweis">Dies ist die englische Fassung. [[Fusion/Start|Zur deutschen Fassung]]</div>

<gallery mode="packed" heights="260px">
Datei:WetterCube-Fusion-wettercube-fusion-logo-3d1ea0.svg|WetterCube Fusion
Datei:WetterCube-Fusion-teaser-poster-09ebcc.jpg|▶ Teaser (30 s): Größer · Besser · Interne Umweltsensoren · MQTT ready · Inkl. aller WetterCubePlus-Funktionen
</gallery>
----

WetterCube Fusion is the next step of the WetterCube family: a large '''7-inch weather display''', built '''exclusively with ESP-IDF''' and tailored to the '''Waveshare ESP32-P4-WIFI6-Touch-LCD-7B''' (1024×600, MIPI-DSI, capacitive touch, Wi-Fi through the ESP32-C6). It continues the WetterCubePlus XL and will later get environment sensors, Home Assistant and MQTT. Weather, forecast, pollen and allergens, air quality, DWD warnings with a warning map, Biowetter, a web interface and on-device updates. Designed for '''Germany''' (DWD data, German display language).

<div class="wc-box">'''Status:''' in development (alpha), the source code is open (Apache 2.0). Until the P4 board arrives, the same code runs on the Waveshare ESP32-S3-Touch-LCD-7B (also 1024×600).</div>

{| class="wikitable"
! Page !! Content
|-
| [[Fusion/Roadmap/en|Roadmap]] || The WetterCube family 2026–2027
|-
| [[Fusion/Hardware/en|Hardware]] || target board (P4), development board (S3), power supply
|-
| [[Fusion/Inbetriebnahme/en|Getting started]] || installation, first setup
|-
| [[Fusion/Einstellungen/en|Settings]] || web interface, on-device menu, defaults
|-
| [[Fusion/Screens und Funktionen/en|Screens and features]] || all screens (incl. allergens), hint tile, data sources
|-
| [[Fusion/Sensoren/en|Sensors]] || internal environment sensor, ESPHome/MQTT, correction
|-
| [[Fusion/Home Assistant und Schalter/en|Home Assistant and switches]] || values in Home Assistant, switch tiles, <code>/api/status</code>
|-
| [[Fusion/Lüften und Raumklima/en|Airing and room climate]] || airing traffic light, dew point, warning for rooms that are too humid
|-
| [[Fusion/Speicherkarte/en|Memory card]] || sensor history and permanent log on microSD
|-
| [[Fusion/Wiederherstellung/en|Recovery]] || recovery app: renew firmware, factory reset, rollback after a failed update
|-
| [[Fusion/Updates (OTA)/en|Updates (OTA)]] || update icon, installing, emergency via USB
|-
| [[Fusion/Diagnose und Fehlersuche/en|Diagnostics and troubleshooting]] || reading <code>/log</code>, common problems
|-
| [[Fusion/Entwicklung/en|Development]] || repository layout, building, contributing, licence
|}

More: [https://github.com/JPPeterson-lab/WetterCube-Fusion#readme README] · [https://github.com/JPPeterson-lab/WetterCube-Fusion/blob/main/CHANGELOG.en.md Changelog]

[[Kategorie:Fusion]]
[[Kategorie:English]]

Fusion/Start

2026-10-19T15:00:46Z

WetterCube: WetterCube Website

<div class="wc-sprachhinweis">[[Fusion/Start/en|English version]]</div>

<gallery mode="packed" heights="260px">
Datei:WetterCube-Fusion-wettercube-fusion-logo-3d1ea0.svg|WetterCube Fusion
Datei:WetterCube-Fusion-teaser-poster-09ebcc.jpg|▶ Teaser (30 s): Größer · Besser · Interne Umweltsensoren · MQTT ready · Inkl. aller WetterCubePlus-Funktionen
</gallery>
----

WetterCube Fusion ist die nächste Stufe der WetterCube-Familie: ein großes '''7-Zoll-Wetterdisplay''', gebaut '''ausschließlich mit ESP-IDF''' und zugeschnitten auf das '''Waveshare ESP32-P4-WIFI6-Touch-LCD-7B''' (1024×600, MIPI-DSI, kapazitiver Touch, WLAN über den ESP32-C6). Es führt den WetterCubePlus XL weiter und bekommt später Umweltsensoren, Home Assistant und MQTT. Wetter, Vorhersage, Pollen und Allergene, Luftqualität, DWD-Warnungen mit Warnkarte, Biowetter, Web-Oberfläche und Update direkt am Gerät. Auf '''Deutschland''' ausgelegt (DWD-Daten, deutsche Anzeige).

<div class="wc-box">'''Status:''' in Entwicklung (Alpha), der Quellcode ist offen (Apache 2.0). Bis das P4-Board eintrifft, läuft derselbe Code auf dem Waveshare ESP32-S3-Touch-LCD-7B (ebenfalls 1024×600).</div>

{| class="wikitable"
! Seite !! Inhalt
|-
| [[Fusion/Roadmap|Roadmap]] || Die WetterCube-Familie 2026–2027
|-
| [[Fusion/Hardware|Hardware]] || Zielboard (P4), Entwicklungsboard (S3), Stromversorgung
|-
| [[Fusion/Inbetriebnahme|Inbetriebnahme]] || Installation, Erstkonfiguration
|-
| [[Fusion/Einstellungen|Einstellungen]] || Web-Oberfläche, Menü am Display, Standardwerte
|-
| [[Fusion/Screens und Funktionen|Screens und Funktionen]] || alle Bildschirme (inkl. Allergene), Hinweis-Kachel, Datenquellen
|-
| [[Fusion/Sensoren|Sensoren]] || interner Umweltsensor, ESPHome/MQTT, Korrektur
|-
| [[Fusion/Home Assistant und Schalter|Home Assistant und Schalter]] || Werte in Home Assistant, Schalter-Kacheln, <code>/api/status</code>
|-
| [[Next/Start|WetterCube Next]] || kleine Zusatzdisplays (CYD), Schnittstelle <code>/api/next</code>
|-
| [[Fusion/Lüften und Raumklima|Lüften und Raumklima]] || Lüften-Ampel, Taupunkt, Warnung bei zu feuchten Räumen
|-
| [[Fusion/Speicherkarte|Speicherkarte]] || Verlauf der Sensoren und Dauer-Log auf microSD
|-
| [[Fusion/Wiederherstellung|Wiederherstellung]] || Notfall-App: Firmware erneuern, Werksreset, Rollback nach fehlgeschlagenem Update
|-
| [[Fusion/Updates (OTA)|Updates (OTA)]] || Update-Symbol, Installieren, Notfall per USB
|-
| [[Fusion/Diagnose und Fehlersuche|Diagnose und Fehlersuche]] || das <code>/log</code> lesen, typische Probleme
|-
| [[Fusion/Entwicklung|Entwicklung]] || Aufbau des Repositorys, Bauen, Mitmachen, Lizenz
|}

Weiterführend: [https://github.com/JPPeterson-lab/WetterCube-Fusion#readme README] · [https://github.com/JPPeterson-lab/WetterCube-Fusion/blob/main/CHANGELOG.md Changelog] · Vorgänger: [https://github.com/JPPeterson-lab/WetterCubePlus-XL WetterCubePlus XL] · [https://github.com/JPPeterson-lab/WetterCubePlus WetterCubePlus] · [https://github.com/JPPeterson-lab/WetterCube WetterCube]

[[Kategorie:Fusion]]

Fusion/Entwicklung/en

2026-10-19T15:00:41Z

WetterCube: WetterCube Website

<div class="wc-sprachhinweis">Dies ist die englische Fassung. [[Fusion/Entwicklung|Zur deutschen Fassung]]</div>

----

== Repository layout ==

{| class="wikitable"
! File / folder !! Content
|-
| <code>CMakeLists.txt</code>, <code>main/</code> || ESP-IDF project; <code>main/main.cpp</code> is the entry point (<code>app_main()</code>: start NVS, then <code>starten()</code> from <code>src/app/app.cpp</code>); <code>src/platform/</code> is the small compatibility layer for the former Arduino names
|-
| <code>sdkconfig.defaults</code>, <code>sdkconfig.defaults.esp32s3</code>, <code>sdkconfig.defaults.esp32p4</code> || common and chip-specific settings (P4 draft, not tried on the board yet)
|-
| <code>partitions.csv</code>, <code>partitions_p4.csv</code> || partition tables (S3: 16 MB flash, 2 × almost 8 MB OTA slots; P4: 32 MB, 2 × 10 MB)
|-
| <code>conf/lv_conf.h</code> || LVGL configuration (project copy)
|-
| <code>src/board/</code>, <code>src/hardware/</code>, <code>src/display/</code> || board layer (<code>board.h</code>; <code>board/s3/</code> RGB panel, I²C, IO expander, SD over SPI; <code>board/p4/</code> MIPI-DSI, PWM brightness, SDMMC), shared GT911 touch driver and LVGL glue
|-
| <code>src/app/</code> || navigation, data (<code>data_*.cpp</code>), UI (<code>ui_*.cpp</code>), web UI, update (<code>ota.cpp</code>), network task (<code>app.cpp</code>)
|-
| <code>src/ui/</code> || '''PicoPixel''' export of the UI (LVGL 8, 1024×600)
|-
| <code>tools/</code> || <code>deploy_ui.sh</code>, <code>icons_code.py</code>, <code>wetter_icons.py</code>, <code>anim_pack.py</code>, <code>flash_usb.py</code>, <code>notfall_snap.py</code>
|-
| <code>assets/</code> || logo, roadmap graphic, teaser, icons (<code>icons/weather/</code>: weather icons for the display; <code>icons/meteocons/</code>: sensor icons as PNG)
|-
| <code>docs/</code> || GitHub Pages: web installer, <code>version.json</code>, <code>manifest.json</code>, <code>firmware/*.bin</code>
|-
| <code>CHANGELOG.md</code> / <code>CHANGELOG.en.md</code> || changes (bilingual)
|}

== Building ==

Install ESP-IDF 5.5.x (<code>git clone --branch v5.5.5 --recursive https://github.com/espressif/esp-idf.git ~/esp/esp-idf-v5.5.5 && cd ~/esp/esp-idf-v5.5.5 && ./install.sh esp32s3,esp32p4</code>), then:

<pre>
bash build.sh # build (target esp32s3; the first time the component manager downloads LVGL, ArduinoJson and mdns)
bash build.sh flash /dev/cu.xxx # build and flash (port from ls /dev/cu.*)
bash build.sh recovery # build the recovery app (recovery/build/recovery.bin), before flashing
bash build.sh clean # after changes to sdkconfig.defaults*
PCLK=40 bash build.sh # pixel clock in MHz (S3: default 30 = 33 frames/s; at 15 MHz = 16 Hz the panel visibly flickers, clocks that are too high give stripes when WiFi, web interface and display need the PSRAM at the same time)
TARGET=esp32p4 bash build.sh # other target
</pre>

Important settings on the S3 (<code>sdkconfig.defaults.esp32s3</code>): flash and PSRAM 120 MHz, code in PSRAM, <code>LCD_RGB_ISR_IRAM_SAFE</code> (the picture keeps running during flash writes), 64 KB data cache, TLS buffers in PSRAM, Wi-Fi and LWIP buffers in internal RAM (in PSRAM they steal bandwidth from the display and cause stripes), Wi-Fi code without IRAM optimisation (saves about 15 to 20 KB). In <code>CMakeLists.txt</code>: <code>-DLODEPNG_NO_COMPILE_ALLOCATORS</code> (PNG decoding in PSRAM).

== Recovery app (<code>recovery/</code>) ==

A project of its own in pure ESP-IDF (no Arduino): display, touch and the LVGL port come from <code>src/</code> (with <code>recovery/shim/Arduino.h</code> for <code>delay()</code> and <code>millis()</code>; the main firmware has <code>src/platform/Arduino.h</code> for that), the UI is built in code in <code>recovery/main/ui.cpp</code>. It runs from the <code>factory</code> partition (1.5 MB, the app is about 0.6 MB) and uses the same partition table (<code>../partitions.csv</code>).

Development tools: <code>bash build.sh recovery -DNOTFALL_SNAPSHOT=1</code> prints every screen at half size as text on the serial port (<code>python3 tools/notfall_snap.py PORT /tmp/nf 60 --reset</code> turns it into PNGs) and accepts keys as characters (<code>1</code> firmware, <code>2</code> complete, <code>3</code> only reset, <code>4</code> normal, <code>k</code>/<code>a</code>/<code>b</code> source, <code>j</code>/<code>n</code> yes/no, <code>z</code> back); with <code>-DNOTFALL_DEMO=1</code> it also shows all screens with sample data. The rollback can be checked with <code>TESTHANG=1 TESTVERSION=9.9.9-test bash build.sh</code> (builds a deliberately hanging firmware; afterwards run <code>bash build.sh</code> without the variables).

== Pure ESP-IDF (since v0.6.0) ==

Arduino-ESP32 is removed. The application keeps using the familiar names, which <code>src/platform/</code> maps onto ESP-IDF: <code>WiFi</code> → <code>esp_wifi</code> (on the P4 via <code>esp_wifi_remote</code>), <code>HTTPClient</code> → <code>esp_http_client</code> with the certificate bundle, <code>WebServer</code> → <code>esp_http_server</code>, <code>DNSServer</code> → an own DNS responder for the captive portal, <code>Preferences</code> → <code>nvs_flash</code> (same types), <code>ESPmDNS</code> → <code>mdns</code>, <code>Update</code> → <code>esp_ota_*</code>, <code>String</code> → an own class on <code>std::string</code>, time → SNTP; ArduinoJson stays (plain C++ library).

== Memory (ESP32-S3) ==

Internal RAM (about 320 KB usable): variables, heap (Wi-Fi), stacks, LVGL draw buffer (20 lines), RGB bounce buffer, 64 KB cache; about 65 KB free after start. PSRAM (8 MB): framebuffer (1.2 MB), program code, LVGL pool (192 KB), TLS buffers, map image, large downloads (about 3 MB free after start). Flash (16 MB): program, images, fonts, settings. The warning map needs about 3 MB contiguous in PSRAM while decoding; the old map is therefore freed first.

== UI with PicoPixel ==

Export from [https://picopixel.io PicoPixel] to <code>src/ui/</code>, then run <code>./tools/deploy_ui.sh</code> (puts in the weather icons from <code>assets/icons/weather/</code> (Meteocons, even if PicoPixel still holds the old images), renames image files to <code>.inc</code>, adjusts <code>images.c</code>, disables the screen fade, fixes color prefix and special characters, and '''checks that all objects wired in the code still exist'''). The fonts only contain ASCII and <code>° Ä Ö Ü ß ä ö ü</code>; <code>bereinigeText()</code> replaces other characters.

== Releases and update path ==

The firmware files in <code>docs/firmware/</code> and the releases are created by the maintainer from one build (bootloader, partition table, <code>boot_app0.bin</code> and firmware come from the same state). Please send pull requests '''without''' changes to <code>docs/firmware/</code>.

Devices fetch <code>version.json</code> via <code>raw.githubusercontent.com</code> and the firmware from GitHub Pages; a device only offers '''higher''' versions.

== Contributing, licence and credits ==

The source code is licensed under the '''Apache License 2.0''' ([https://github.com/JPPeterson-lab/WetterCube-Fusion/blob/main/LICENSE LICENSE], [https://github.com/JPPeterson-lab/WetterCube-Fusion/blob/main/NOTICE NOTICE]), texts and images under CC BY-NC 4.0. The name and logos of "WetterCube" are not licensed. Pull requests and [https://github.com/JPPeterson-lab/WetterCube-Fusion/issues issues] are welcome; contributions are accepted under the Apache License 2.0. Note: <code>src/ui/</code> is a PicoPixel export; make small UI changes in the code (<code>src/app/ui_*.cpp</code>) instead. The free weather interface of Open-Meteo is meant for non-commercial use only.

Weather and sensor icons by [https://github.com/basmilius/weather-icons Meteocons] (Bas Milius, MIT), control icons from the [https://github.com/icons8/flat-color-icons Flat Color Icons] by Icons8 (MIT / Good Boy License), font Montserrat (SIL OFL 1.1), see <code>CREDITS.md</code>. Third-party resources keep their own licences.

[[Kategorie:Fusion]]
[[Kategorie:English]]

Fusion/Entwicklung

2026-10-19T15:00:40Z

WetterCube: WetterCube Website

<div class="wc-sprachhinweis">[[Fusion/Entwicklung/en|English version]]</div>

----

== Aufbau des Repositorys ==

{| class="wikitable"
! Datei / Ordner !! Inhalt
|-
| <code>CMakeLists.txt</code>, <code>main/</code> || ESP-IDF-Projekt; <code>main/main.cpp</code> ist der Einstieg (<code>app_main()</code>: NVS starten, dann <code>starten()</code> aus <code>src/app/app.cpp</code>); <code>src/platform/</code> ist die kleine Ersatzschicht für die früheren Arduino-Namen
|-
| <code>sdkconfig.defaults</code>, <code>sdkconfig.defaults.esp32s3</code>, <code>sdkconfig.defaults.esp32p4</code> || gemeinsame und chip-spezifische Einstellungen (P4-Entwurf, noch ohne Board erprobt)
|-
| <code>partitions.csv</code>, <code>partitions_p4.csv</code> || Partitionstabellen (S3: 16 MB Flash, 2 × knapp 8 MB OTA-Slots; P4: 32 MB, 2 × 10 MB)
|-
| <code>conf/lv_conf.h</code> || LVGL-Konfiguration (Projektkopie)
|-
| <code>src/board/</code>, <code>src/hardware/</code>, <code>src/display/</code> || Board-Schicht (<code>board.h</code>; <code>board/s3/</code> RGB-Panel, I²C, IO-Erweiterung, SD über SPI; <code>board/p4/</code> MIPI-DSI, PWM-Helligkeit, SDMMC), gemeinsamer Touch-Treiber GT911 und LVGL-Anbindung
|-
| <code>src/app/</code> || Navigation, Daten (<code>data_*.cpp</code>), Oberfläche (<code>ui_*.cpp</code>), WebUI, Update (<code>ota.cpp</code>), Netzwerk-Task (<code>app.cpp</code>), Home Assistant (<code>homeassistant.cpp</code>), animierte Wettersymbole (<code>wetteranim.cpp</code>, nur P4)
|-
| <code>src/sensors/</code> || Sensoren (intern und MQTT), Schalter-Kacheln (<code>schalter*.cpp</code>), MQTT-Client
|-
| <code>src/ui/</code> || '''PicoPixel'''-Export der Oberfläche (LVGL 8, 1024×600)
|-
| <code>tools/</code> || <code>deploy_ui.sh</code>, <code>icons_code.py</code>, <code>wetter_icons.py</code>, <code>anim_pack.py</code>, <code>flash_usb.py</code>, <code>notfall_snap.py</code>
|-
| <code>assets/</code> || Logo, Roadmap-Grafik, Teaser, Icons (<code>icons/wetter/</code>: 32 Wettersymbole; <code>icons/meteocons/</code>: Sensor- und Mond-Icons als PNG; <code>icons/anim/</code>: Animationspaket für den P4)
|-
| <code>docs/</code> || GitHub Pages: Web-Installer, <code>version.json</code>, <code>manifest.json</code>, <code>firmware/*.bin</code>
|-
| <code>CHANGELOG.md</code> / <code>CHANGELOG.en.md</code> || Änderungen (zweisprachig)
|}

== Bauen ==

ESP-IDF 5.5.x installieren (<code>git clone --branch v5.5.5 --recursive https://github.com/espressif/esp-idf.git ~/esp/esp-idf-v5.5.5 && cd ~/esp/esp-idf-v5.5.5 && ./install.sh esp32s3,esp32p4</code>), dann:

<pre>
bash build.sh # bauen (Ziel esp32s3; beim ersten Mal lädt der Komponentenmanager LVGL, ArduinoJson und mdns)
bash build.sh flash /dev/cu.xxx # bauen und flashen (Port aus ls /dev/cu.*)
bash build.sh recovery # Notfall-App bauen (recovery/build/recovery.bin), vor dem Flashen
bash build.sh clean # nach Änderungen an sdkconfig.defaults*
PCLK=40 bash build.sh # Pixeltakt in MHz (S3: Standard 30 = 33 Bilder/s; bei 15 MHz = 16 Hz flimmert das Panel sichtbar, zu hohe Takte geben Streifen, wenn WLAN, Web-Oberfläche und Display zugleich den PSRAM brauchen)
TARGET=esp32p4 bash build.sh # P4-Board (Ordner build_p4; noch ohne Board erprobt), ebenso `TARGET=esp32p4 bash build.sh recovery`
</pre>

Wichtige Einstellungen auf dem S3 (<code>sdkconfig.defaults.esp32s3</code>): Flash und PSRAM 120 MHz, Programmcode im PSRAM, <code>LCD_RGB_ISR_IRAM_SAFE</code> (das Bild läuft beim Flash-Schreiben weiter), 64-KB-Daten-Cache, TLS-Puffer im PSRAM, WLAN- und LWIP-Puffer im internen RAM (im PSRAM stehlen sie dem Display Bandbreite, es gibt Streifen), WLAN-Code ohne IRAM-Optimierung (spart ca. 15 bis 20 KB). Im <code>CMakeLists.txt</code>: <code>-DLODEPNG_NO_COMPILE_ALLOCATORS</code> (PNG-Dekodierung im PSRAM).

== Notfall-App (<code>recovery/</code>) ==

Ein eigenes, reines ESP-IDF-Projekt (kein Arduino): Display, Touch und der LVGL-Port kommen aus <code>src/</code> (mit <code>recovery/shim/Arduino.h</code> für <code>delay()</code> und <code>millis()</code>; die Hauptfirmware hat dafür <code>src/platform/Arduino.h</code>), die Oberfläche ist in <code>recovery/main/ui.cpp</code> in Code gebaut. Sie läuft aus der Partition <code>factory</code> (1,5 MB, die App hat etwa 0,6 MB) und nutzt dieselbe Partitionstabelle (<code>../partitions.csv</code>).

Entwicklungswerkzeuge: <code>bash build.sh recovery -DNOTFALL_SNAPSHOT=1</code> gibt jeden Bildschirm halb skaliert als Text auf der seriellen Schnittstelle aus (<code>python3 tools/notfall_snap.py PORT /tmp/nf 60 --reset</code> macht PNGs daraus) und nimmt Tasten per Zeichen entgegen (<code>1</code> Firmware, <code>2</code> Komplett, <code>3</code> Nur Reset, <code>4</code> Normal, <code>k</code>/<code>a</code>/<code>b</code> Quelle, <code>j</code>/<code>n</code> Ja/Nein, <code>z</code> Zurück); mit <code>-DNOTFALL_DEMO=1</code> zeigt sie zusätzlich alle Bildschirme mit Beispieldaten. Das Rollback lässt sich mit <code>TESTHANG=1 TESTVERSION=9.9.9-test bash build.sh</code> prüfen (baut eine absichtlich hängende Firmware; danach <code>bash build.sh</code> ohne die Variablen).

== Reines ESP-IDF (seit v0.6.0) ==

Arduino-ESP32 ist entfernt. Die Anwendung nutzt weiter die vertrauten Namen, die <code>src/platform/</code> auf ESP-IDF abbildet (<code>WiFi.h</code> + <code>wlan.cpp</code>, <code>HTTPClient</code>, <code>WebServer</code>, <code>DnsPortal</code>, <code>Preferences.h</code>, <code>fusion_string.h</code> mit eigener <code>String</code>-Klasse, <code>Arduino.h</code> mit <code>millis()</code>, <code>delay()</code>, <code>ESP.getFreeHeap()</code> …, <code>Zeit.cpp</code> für SNTP):

{| class="wikitable"
! Früher (Arduino) !! Jetzt (ESP-IDF)
|-
| <code>WiFi</code>, <code>WiFiClientSecure</code>, <code>HTTPClient</code> || <code>esp_wifi</code> (auf dem P4 über <code>esp_wifi_remote</code>), <code>esp_http_client</code> mit Zertifikatspaket
|-
| <code>WebServer</code>, <code>DNSServer</code> || <code>esp_http_server</code>, eigener DNS-Responder für das Captive Portal
|-
| <code>Preferences</code> || <code>nvs_flash</code>
|-
| <code>ESPmDNS</code> || Komponente <code>mdns</code>
|-
| <code>Update</code> || <code>esp_https_ota</code>
|-
| <code>String</code>, <code>Serial</code> || <code>std::string</code>, <code>ESP_LOG</code>
|-
| <code>ArduinoJson</code> || bleibt (reine C++-Bibliothek)
|}

== Speicher (ESP32-S3) ==

{| class="wikitable"
! Speicher !! Verwendung
|-
| '''Interner RAM''' (ca. 320 KB nutzbar) || Variablen, Heap (WLAN, LWIP), Stacks, LVGL-Zeichenpuffer (20 Zeilen), RGB-Bounce-Buffer, 64-KB-Cache; nach dem Start ca. 65 KB frei
|-
| '''PSRAM''' (8 MB) || Framebuffer (1,2 MB), Programmcode, LVGL-Speicherpool (192 KB), TLS-Puffer, Kartenbild, große Downloads (nach dem Start ca. 3 MB frei)
|-
| '''Flash''' (16 MB) || Programm, Bilder, Schriften, Einstellungen (NVS)
|}

Die Warnkarte braucht beim Dekodieren ca. 3 MB am Stück im PSRAM; die alte Karte wird deshalb vorher freigegeben.

== Oberfläche mit PicoPixel ==

# In [https://picopixel.io PicoPixel] nach <code>src/ui/</code> exportieren.
# <code>./tools/deploy_ui.sh</code> ausführen: setzt die Wetter-Icons aus <code>assets/icons/weather/</code> ein (Meteocons, auch wenn PicoPixel noch die alten Bilder enthält), benennt die Bilddateien in <code>.inc</code> um, passt <code>images.c</code> an, schaltet die Screen-Überblendung ab (Absturz-Fix), korrigiert Farb-Präfix und Sonderzeichen und '''prüft, ob alle vom Code verdrahteten Objekte noch existieren'''.
# Die Schriften enthalten nur ASCII und <code>° Ä Ö Ü ß ä ö ü</code>; andere Zeichen ersetzt <code>bereinigeText()</code>.
# '''Icons aus dem Code:''' PicoPixel begrenzt die Bilder. <code>python3 tools/icons_code.py</code> wandelt PNGs aus <code>assets/icons/</code> in LVGL-Bilder um (<code>assets/icons/code/</code>, Tabelle <code>src/icons/icons.cpp</code>); <code>iconSetzen(obj, "name", px)</code> setzt Quelle und Zoom aus der Zielgröße. Die Icons der Allergen-/Biowetter-Screens stehen in PicoPixel nur als Platzhalter, <code>deploy_ui.sh</code> ersetzt sie durch 1×1-Bilder (spart Flash) und die Firmware setzt die echten Icons. Neue Icons: PNG ablegen, in <code>tools/icons_code.py</code> eintragen, Skript ausführen.

== Releases und Update-Weg ==

Die Firmware-Dateien in <code>docs/firmware/</code> und die Releases erstellt der Maintainer aus einem Build (Bootloader, Partitionstabelle, <code>boot_app0.bin</code> und Firmware stammen aus demselben Stand). Pull Requests bitte '''ohne''' Änderungen an <code>docs/firmware/</code>.

Die Geräte holen <code>version.json</code> über <code>raw.githubusercontent.com</code> und die Firmware von GitHub Pages. Ein Gerät bietet nur '''höhere''' Versionen an.

== Mitmachen, Lizenz und Credits ==

Der Quellcode steht unter der '''Apache-Lizenz 2.0''' ([https://github.com/JPPeterson-lab/WetterCube-Fusion/blob/main/LICENSE LICENSE], [https://github.com/JPPeterson-lab/WetterCube-Fusion/blob/main/NOTICE NOTICE]), Texte und Bilder unter CC BY-NC 4.0. Name und Logos von „WetterCube“ sind nicht freigegeben. Pull Requests und [https://github.com/JPPeterson-lab/WetterCube-Fusion/issues Issues] sind willkommen; Beiträge werden unter der Apache-Lizenz 2.0 aufgenommen. Hinweis: <code>src/ui/</code> ist ein PicoPixel-Export; kleine Änderungen an der Oberfläche besser im Code (<code>src/app/ui_*.cpp</code>) machen. Die kostenlose Wetter-Schnittstelle von Open-Meteo ist nur für nicht-kommerzielle Nutzung gedacht.

Wetter- und Sensor-Icons von [https://github.com/basmilius/weather-icons Meteocons] (Bas Milius, MIT), Bedienelemente-Icons aus den [https://github.com/icons8/flat-color-icons Flat Color Icons] von Icons8 (MIT / Good Boy License), Schrift Montserrat (SIL OFL 1.1), siehe <code>CREDITS.md</code>. Drittanbieter-Ressourcen behalten ihre Lizenzen.

[[Kategorie:Fusion]]

Hauptseite/en

2026-10-19T15:00:35Z

WetterCube: WetterCube Website

__NOTOC__ __NOEDITSECTION__
<div class="wc-sprachhinweis">[[Hauptseite|Deutsch]]</div>
<div class="wc-start-kopf">
<div class="wc-start-titel">Welcome to the WetterCube Wiki</div>
<div class="wc-start-unter">Guides, settings and help for all WetterCubes: weather, health and your home at a glance.</div>
</div>

<div class="wc-kacheln">
<div class="wc-kachel"><div class="wc-kachel-sym">🚀</div><div class="wc-kachel-titel">[[Fusion/Inbetriebnahme/en|Getting started]]</div>
Install the firmware, set up Wi-Fi, get going. The [https://wettercube.de/en/install/ web installers] flash the firmware straight from the browser.</div>
<div class="wc-kachel"><div class="wc-kachel-sym">📟</div><div class="wc-kachel-titel">[[Fusion/Start/en|WetterCube Fusion]]</div>
7-inch display, sensors, Home Assistant, airing, memory card.</div>
<div class="wc-kachel"><div class="wc-kachel-sym">🛏️</div><div class="wc-kachel-titel">[[Next/Start/en|WetterCube Next]]</div>
A display for every room: the additional module for the Fusion.</div>
<div class="wc-kachel"><div class="wc-kachel-sym">📱</div><div class="wc-kachel-titel">[[WetterCubePlus/Start/en|WetterCubePlus]]</div>
3.5-inch touch display, DWD warnings, pollen, rain radar, WetterAmpel.</div>
<div class="wc-kachel"><div class="wc-kachel-sym">🧊</div><div class="wc-kachel-titel">[[WetterCube/Start/en|WetterCube]]</div>
The first smart weather display: ESP32-C3 with a 1.54-inch display.</div>
<div class="wc-kachel"><div class="wc-kachel-sym">🌿</div><div class="wc-kachel-titel">[[Fusion/Sensoren/en|Sensors and airing]]</div>
MQTT, ESPHome, dew point and mould warning, [[Fusion/Lüften und Raumklima/en|airing traffic light]].</div>
<div class="wc-kachel"><div class="wc-kachel-sym">🔧</div><div class="wc-kachel-titel">[[Fusion/Diagnose und Fehlersuche/en|Help with problems]]</div>
Troubleshooting, log, [[Fusion/Wiederherstellung/en|recovery]].</div>
<div class="wc-kachel"><div class="wc-kachel-sym">🧩</div><div class="wc-kachel-titel">[https://wettercube.de/en/hardware/ Hardware and case]</div>
Which board do I need? Cases to print yourself.</div>
<div class="wc-kachel"><div class="wc-kachel-sym">🗺️</div><div class="wc-kachel-titel">[[Fusion/Roadmap/en|Roadmap]]</div>
What comes next? The whole family 2026 to 2027.</div>
</div>

<div class="wc-box">'''Why I do this:''' I am weather-sensitive and wanted the important information in one central place, tailored to me. '''Local instead of cloud:''' The web interfaces run on the devices themselves and are only reachable on the local Wi-Fi; there is no cloud requirement. Google does not need to know how warm it is in my bedroom right now.</div>

<div class="wc-box">'''Updates and maintenance:''' The Fusion is the current spearhead; the Next is developed in parallel. The WetterCubePlus continues to receive updates, including new features as far as the device allows. The WetterCube only gets security updates when they are necessary.</div>

<div class="wc-box">'''At your own risk:''' You use the software and the guides on your own responsibility; I accept no liability for damage or consequences. You should roughly know what you are doing (flashing a board, setting up Wi-Fi, and with WetterCube and WetterCubePlus also crimping cables and soldering). If anything is unclear, please ask first: through the [https://wettercube.de/en/contact/ contact form] or on GitHub (issues). When flashing, you can usually not break much on an ESP32, the board can be flashed again at any time; real damage is more likely to come from wrong wiring or a wrong voltage. Weather data, warnings, pollen forecast and bio-weather are for information only and replace neither official warnings (e.g. NINA, DWD WarnWetter app) nor medical advice.</div>

<div class="wc-box">'''WetterCube is a software project.''' I provide the software (firmware); you build the device yourself: buy a board, flash the firmware, design a case to your own taste. I try to offer matching cases for the individual cubes. Short build guides are at [https://wettercube.de/en/build-guide/ Build guide].</div>

<div class="wc-box">'''Language and region:''' The WetterCube project is currently only available in German. Because the weather data for warnings, pollen forecast and bio-weather comes from the German Weather Service (DWD), it currently only works completely in Germany. A translation into English and weather information usable worldwide are planned, but there is no fixed date yet.</div>

<div class="wc-box">'''In development:''' Fusion and Next are still in development (alpha). Errors can occur with the current versions.</div>

== Status of the products ==
{| class="wikitable"
! Product !! Status !! Version
|-
| WetterCube Fusion || <span class="wc-status">In development</span> || v0.9.9-alpha7
|-
| WetterCube Next (module for the Fusion) || <span class="wc-status">In development</span> || v0.1.0-alpha5
|-
| WetterCubePlus || released || v1.8.1
|-
| WetterCube || released || v2.0.2
|}

<div class="wc-box">💙 '''Thanks to PicoPixel:''' The LVGL UI of the WetterCubes is created with [https://picopixel.io/ PicoPixel], a free, browser-based editor for LVGL. I am convinced by the project; this is not an advertisement or affiliate link, I earn nothing from it.</div>

== Where to find what ==
* '''[https://wettercube.de/en/ Homepage]:''' the family, roadmap, comparison, [https://wettercube.de/en/install/ install], [https://wettercube.de/en/hardware/ hardware and case]
* '''This wiki:''' all guides, organised by product (sidebar on the left)
* '''GitHub:''' [https://github.com/JPPeterson-lab/WetterCube-Fusion Fusion], [https://github.com/JPPeterson-lab/WetterCube-Next Next], [https://github.com/JPPeterson-lab/WetterCubePlus WetterCubePlus], [https://github.com/JPPeterson-lab/WetterCube WetterCube] (releases and bug reports)

<div class="wc-box">'''Open source.''' The source code of WetterCubePlus, Fusion and Next is under the Apache License 2.0, the WetterCube under the MIT licence: using, modifying and sharing is allowed, also commercially. '''My promise:''' private use of all WetterCubes (WetterCube, WetterCubePlus, Fusion and Next) stays free in the future. The free weather interface of Open-Meteo is meant for non-commercial use only. Questions and commissioned projects: [https://wettercube.de/en/contact/ Contact].</div>

[[Kategorie:Hauptseite]]

Hauptseite

2026-10-19T15:00:34Z

WetterCube: WetterCube Website

__NOTOC__ __NOEDITSECTION__
<div class="wc-sprachhinweis">[[Hauptseite/en|English]]</div>
<div class="wc-start-kopf">
<div class="wc-start-titel">Willkommen im WetterCube Wiki</div>
<div class="wc-start-unter">Anleitungen, Einstellungen und Hilfe für alle WetterCubes: Wetter, Gesundheit und dein Zuhause auf einen Blick.</div>
</div>

<div class="wc-kacheln">
<div class="wc-kachel"><div class="wc-kachel-sym">🚀</div><div class="wc-kachel-titel">[[Fusion/Inbetriebnahme|Erste Schritte]]</div>
Firmware installieren, WLAN einrichten, loslegen. Die [https://wettercube.de/installieren/ Web-Installer] spielen die Firmware direkt aus dem Browser auf das Board.</div>
<div class="wc-kachel"><div class="wc-kachel-sym">📟</div><div class="wc-kachel-titel">[[Fusion/Start|WetterCube Fusion]]</div>
7-Zoll-Display, Sensoren, Home Assistant, Lüften, Speicherkarte.</div>
<div class="wc-kachel"><div class="wc-kachel-sym">🛏️</div><div class="wc-kachel-titel">[[Next/Start|WetterCube Next]]</div>
Ein Display für jeden Raum: das Zusatzmodul zum Fusion.</div>
<div class="wc-kachel"><div class="wc-kachel-sym">📱</div><div class="wc-kachel-titel">[[WetterCubePlus/Start|WetterCubePlus]]</div>
3,5-Zoll-Touchdisplay, DWD-Warnungen, Pollen, Regenradar, WetterAmpel.</div>
<div class="wc-kachel"><div class="wc-kachel-sym">🧊</div><div class="wc-kachel-titel">[[WetterCube/Start|WetterCube]]</div>
Das erste smarte Wetterdisplay: ESP32-C3 mit 1,54-Zoll-Display.</div>
<div class="wc-kachel"><div class="wc-kachel-sym">🌿</div><div class="wc-kachel-titel">[[Fusion/Sensoren|Sensoren und Lüften]]</div>
MQTT, ESPHome, Taupunkt und Schimmelwarnung, [[Fusion/Lüften und Raumklima|Lüften-Ampel]].</div>
<div class="wc-kachel"><div class="wc-kachel-sym">🔧</div><div class="wc-kachel-titel">[[Fusion/Diagnose und Fehlersuche|Hilfe bei Problemen]]</div>
Fehlersuche, Protokoll, [[Fusion/Wiederherstellung|Wiederherstellung]].</div>
<div class="wc-kachel"><div class="wc-kachel-sym">🧩</div><div class="wc-kachel-titel">[https://wettercube.de/hardware/ Hardware und Gehäuse]</div>
Welches Board brauche ich? Gehäuse zum Selbstdrucken.</div>
<div class="wc-kachel"><div class="wc-kachel-sym">🗺️</div><div class="wc-kachel-titel">[[Fusion/Roadmap|Roadmap]]</div>
Was kommt als Nächstes? Die ganze Familie 2026 bis 2027.</div>
</div>

<div class="wc-box">'''Warum ich das mache:''' Ich bin wetterfühlig und wollte die wichtigen Informationen zentral an einem Ort haben, zugeschnitten auf mich. '''Lokal statt Cloud:''' Die Web-Oberflächen laufen auf den Geräten selbst und sind nur im lokalen WLAN erreichbar; einen Cloud-Zwang gibt es nicht. Google muss nicht wissen, wie warm es gerade in meinem Schlafzimmer ist.</div>

<div class="wc-box">'''Updates und Pflege:''' Der Fusion ist die aktuelle Speerspitze; der Next wird parallel entwickelt. Der WetterCubePlus wird weiterhin mit Updates versorgt, auch mit neuen Funktionen, soweit es die Möglichkeiten des Geräts zulassen. Der WetterCube bekommt nur noch Sicherheitsupdates, wenn sie nötig sind.</div>

<div class="wc-box">'''Auf eigene Gefahr:''' Software und Anleitungen setzt du auf eigene Verantwortung ein, für Schäden oder Folgen übernehme ich keine Haftung. Du solltest grob wissen, was du tust (Board flashen, WLAN einrichten, bei WetterCube und WetterCubePlus auch Kabel crimpen und löten). Bei Unklarheiten frag lieber nach: über das [https://wettercube.de/kontakt/ Kontaktformular] oder auf GitHub (Issues). Beim Flashen kann man bei einem ESP32 in aller Regel nicht viel kaputt machen, das Board lässt sich jederzeit neu flashen; echte Schäden entstehen eher durch falsche Verkabelung oder eine falsche Spannung. Wetterdaten, Warnungen, Pollenflug und Biowetter dienen nur der Information und ersetzen weder amtliche Warnungen (z. B. NINA, WarnWetter-App des DWD) noch ärztlichen Rat.</div>

<div class="wc-box">'''WetterCube ist ein Softwareprojekt.''' Ich stelle die Software (Firmware) bereit; das Gerät baust du selbst: Board kaufen, Firmware aufspielen, ein Gehäuse nach deinem Geschmack gestalten. Ich versuche, zu den einzelnen Cubes passende Gehäuse anzubieten. Kurzanleitungen zum Bau gibt es unter [https://wettercube.de/bauanleitung/ Bauanleitung].</div>

<div class="wc-box">'''Sprache und Region:''' Das WetterCube-Projekt gibt es derzeit nur auf Deutsch. Weil die Wetterdaten für Warnungen, Pollenflug und Biowetter vom Deutschen Wetterdienst (DWD) kommen, funktioniert es derzeit auch nur in Deutschland vollständig. Geplant sind eine Übersetzung ins Englische und weltweit nutzbare Wetterinfos, einen festen Termin gibt es noch nicht.</div>

<div class="wc-box">'''In Entwicklung:''' Fusion und Next sind noch in Entwicklung (Alpha). Mit den aktuellen Versionen können Fehler auftreten.</div>

== Stand der Produkte ==
{| class="wikitable"
! Produkt !! Stand !! Version
|-
| WetterCube Fusion || <span class="wc-status">In Entwicklung</span> || v0.9.9-alpha7
|-
| WetterCube Next (Modul zum Fusion) || <span class="wc-status">In Entwicklung</span> || v0.1.0-alpha5
|-
| WetterCubePlus || veröffentlicht || v1.8.1
|-
| WetterCube || veröffentlicht || v2.0.2
|}

<div class="wc-box">💙 '''Danke an PicoPixel:''' Die LVGL-UI der WetterCubes wird mit [https://picopixel.io/de/ PicoPixel] erstellt, einem kostenlosen, browserbasierten Editor für LVGL. Ich bin von dem Projekt überzeugt; das ist kein Werbe- oder Affiliate-Link, ich verdiene nichts daran.</div>

== Wo gibt es was? ==
* '''[https://wettercube.de/ Homepage]:''' die Familie, Roadmap, Vergleich, [https://wettercube.de/installieren/ Installieren], [https://wettercube.de/hardware/ Hardware und Gehäuse]
* '''Dieses Wiki:''' alle Anleitungen, nach Produkt gegliedert (Seitenleiste links)
* '''GitHub:''' [https://github.com/JPPeterson-lab/WetterCube-Fusion Fusion], [https://github.com/JPPeterson-lab/WetterCube-Next Next], [https://github.com/JPPeterson-lab/WetterCubePlus WetterCubePlus], [https://github.com/JPPeterson-lab/WetterCube WetterCube] (Releases und Fehlermeldungen)

<div class="wc-box">'''Open Source.''' Der Quellcode von WetterCubePlus, Fusion und Next steht unter der Apache-Lizenz 2.0, der WetterCube unter der MIT-Lizenz: nutzen, verändern und weitergeben ist erlaubt, auch kommerziell. '''Mein Versprechen:''' Die private Nutzung aller WetterCubes (WetterCube, WetterCubePlus, Fusion und Next) bleibt auch in Zukunft frei. Die kostenlose Wetter-Schnittstelle von Open-Meteo ist nur für nicht-kommerzielle Nutzung gedacht. Fragen und Auftragsprojekte: [https://wettercube.de/kontakt/ Kontakt].</div>

[[Kategorie:Hauptseite]]

Hauptseite/en

2026-10-19T13:49:10Z

WetterCube: WetterCube Website

__NOTOC__ __NOEDITSECTION__
<div class="wc-sprachhinweis">[[Hauptseite|Deutsch]]</div>
<div class="wc-start-kopf">
<div class="wc-start-titel">Welcome to the WetterCube Wiki</div>
<div class="wc-start-unter">Guides, settings and help for all WetterCubes: weather, health and your home at a glance.</div>
</div>

<div class="wc-kacheln">
<div class="wc-kachel"><div class="wc-kachel-sym">🚀</div><div class="wc-kachel-titel">[[Fusion/Inbetriebnahme/en|Getting started]]</div>
Install the firmware, set up Wi-Fi, get going. The [https://wettercube.de/en/install/ web installers] flash the firmware straight from the browser.</div>
<div class="wc-kachel"><div class="wc-kachel-sym">📟</div><div class="wc-kachel-titel">[[Fusion/Start/en|WetterCube Fusion]]</div>
7-inch display, sensors, Home Assistant, airing, memory card.</div>
<div class="wc-kachel"><div class="wc-kachel-sym">🛏️</div><div class="wc-kachel-titel">[[Next/Start/en|WetterCube Next]]</div>
A display for every room: the additional module for the Fusion.</div>
<div class="wc-kachel"><div class="wc-kachel-sym">📱</div><div class="wc-kachel-titel">[[WetterCubePlus/Start/en|WetterCubePlus]]</div>
3.5-inch touch display, DWD warnings, pollen, rain radar, WetterAmpel.</div>
<div class="wc-kachel"><div class="wc-kachel-sym">🧊</div><div class="wc-kachel-titel">[[WetterCube/Start/en|WetterCube]]</div>
The first smart weather display: ESP32-C3 with a 1.54-inch display.</div>
<div class="wc-kachel"><div class="wc-kachel-sym">🌿</div><div class="wc-kachel-titel">[[Fusion/Sensoren/en|Sensors and airing]]</div>
MQTT, ESPHome, dew point and mould warning, [[Fusion/Lüften und Raumklima/en|airing traffic light]].</div>
<div class="wc-kachel"><div class="wc-kachel-sym">🔧</div><div class="wc-kachel-titel">[[Fusion/Diagnose und Fehlersuche/en|Help with problems]]</div>
Troubleshooting, log, [[Fusion/Wiederherstellung/en|recovery]].</div>
<div class="wc-kachel"><div class="wc-kachel-sym">🧩</div><div class="wc-kachel-titel">[https://wettercube.de/en/hardware/ Hardware and case]</div>
Which board do I need? Cases to print yourself.</div>
<div class="wc-kachel"><div class="wc-kachel-sym">🗺️</div><div class="wc-kachel-titel">[[Fusion/Roadmap/en|Roadmap]]</div>
What comes next? The whole family 2026 to 2027.</div>
</div>

<div class="wc-box">'''Why I do this:''' I am weather-sensitive and wanted the important information in one central place, tailored to me. '''Local instead of cloud:''' The web interfaces run on the devices themselves and are only reachable on the local Wi-Fi; there is no cloud requirement. Google does not need to know how warm it is in my bedroom right now.</div>

<div class="wc-box">'''Updates and maintenance:''' The Fusion is the current spearhead; the Next is developed in parallel. The WetterCubePlus continues to receive updates, including new features as far as the device allows. The WetterCube only gets security updates when they are necessary.</div>

<div class="wc-box">'''At your own risk:''' You use the software and the guides on your own responsibility; I accept no liability for damage or consequences. You should roughly know what you are doing (flashing a board, setting up Wi-Fi, and with WetterCube and WetterCubePlus also crimping cables and soldering). If anything is unclear, please ask first: through the [https://wettercube.de/en/contact/ contact form] or on GitHub (issues). When flashing, you can usually not break much on an ESP32, the board can be flashed again at any time; real damage is more likely to come from wrong wiring or a wrong voltage. Weather data, warnings, pollen forecast and bio-weather are for information only and replace neither official warnings (e.g. NINA, DWD WarnWetter app) nor medical advice.</div>

<div class="wc-box">'''WetterCube is a software project.''' I provide the software (firmware); you build the device yourself: buy a board, flash the firmware, design a case to your own taste. I try to offer matching cases for the individual cubes. Short build guides are at [https://wettercube.de/en/build-guide/ Build guide].</div>

<div class="wc-box">'''Language and region:''' The WetterCube project is currently only available in German. Because the weather data for warnings, pollen forecast and bio-weather comes from the German Weather Service (DWD), it currently only works completely in Germany. A translation into English and weather information usable worldwide are planned, but there is no fixed date yet.</div>

<div class="wc-box">'''In development:''' Fusion and Next are still in development (alpha). Errors can occur with the current versions.</div>

== Status of the products ==
{| class="wikitable"
! Product !! Status !! Version
|-
| WetterCube Fusion || <span class="wc-status">In development</span> || v0.9.9-alpha7
|-
| WetterCube Next (module for the Fusion) || <span class="wc-status">In development</span> || v0.1.0-alpha5
|-
| WetterCubePlus || released || v1.8.1
|-
| WetterCube || released || v2.0.2
|}

<div class="wc-box">💙 '''Thanks to PicoPixel:''' The LVGL UI of the WetterCubes is created with [https://picopixel.io/ PicoPixel], a free, browser-based editor for LVGL. I am convinced by the project; this is not an advertisement or affiliate link, I earn nothing from it.</div>

== Where to find what ==
* '''[https://wettercube.de/en/ Homepage]:''' the family, roadmap, comparison, [https://wettercube.de/en/install/ install], [https://wettercube.de/en/hardware/ hardware and case]
* '''This wiki:''' all guides, organised by product (sidebar on the left)
* '''GitHub:''' [https://github.com/JPPeterson-lab/WetterCube-Fusion Fusion], [https://github.com/JPPeterson-lab/WetterCube-Next Next], [https://github.com/JPPeterson-lab/WetterCubePlus WetterCubePlus], [https://github.com/JPPeterson-lab/WetterCube WetterCube] (releases and bug reports)

<div class="wc-box">'''Free for private use.''' The firmware of Fusion and Next is free for private use; the source code is currently not public. '''My promise:''' private use of all WetterCubes (WetterCube, WetterCubePlus, Fusion and Next) stays free in the future. For commercial use of WetterCubePlus, Fusion and Next please [https://wettercube.de/en/contact/ get in touch] first (the WetterCube is under the MIT licence).</div>

[[Kategorie:Hauptseite]]

Hauptseite

2026-10-19T13:49:09Z

WetterCube: WetterCube Website

__NOTOC__ __NOEDITSECTION__
<div class="wc-sprachhinweis">[[Hauptseite/en|English]]</div>
<div class="wc-start-kopf">
<div class="wc-start-titel">Willkommen im WetterCube Wiki</div>
<div class="wc-start-unter">Anleitungen, Einstellungen und Hilfe für alle WetterCubes: Wetter, Gesundheit und dein Zuhause auf einen Blick.</div>
</div>

<div class="wc-kacheln">
<div class="wc-kachel"><div class="wc-kachel-sym">🚀</div><div class="wc-kachel-titel">[[Fusion/Inbetriebnahme|Erste Schritte]]</div>
Firmware installieren, WLAN einrichten, loslegen. Die [https://wettercube.de/installieren/ Web-Installer] spielen die Firmware direkt aus dem Browser auf das Board.</div>
<div class="wc-kachel"><div class="wc-kachel-sym">📟</div><div class="wc-kachel-titel">[[Fusion/Start|WetterCube Fusion]]</div>
7-Zoll-Display, Sensoren, Home Assistant, Lüften, Speicherkarte.</div>
<div class="wc-kachel"><div class="wc-kachel-sym">🛏️</div><div class="wc-kachel-titel">[[Next/Start|WetterCube Next]]</div>
Ein Display für jeden Raum: das Zusatzmodul zum Fusion.</div>
<div class="wc-kachel"><div class="wc-kachel-sym">📱</div><div class="wc-kachel-titel">[[WetterCubePlus/Start|WetterCubePlus]]</div>
3,5-Zoll-Touchdisplay, DWD-Warnungen, Pollen, Regenradar, WetterAmpel.</div>
<div class="wc-kachel"><div class="wc-kachel-sym">🧊</div><div class="wc-kachel-titel">[[WetterCube/Start|WetterCube]]</div>
Das erste smarte Wetterdisplay: ESP32-C3 mit 1,54-Zoll-Display.</div>
<div class="wc-kachel"><div class="wc-kachel-sym">🌿</div><div class="wc-kachel-titel">[[Fusion/Sensoren|Sensoren und Lüften]]</div>
MQTT, ESPHome, Taupunkt und Schimmelwarnung, [[Fusion/Lüften und Raumklima|Lüften-Ampel]].</div>
<div class="wc-kachel"><div class="wc-kachel-sym">🔧</div><div class="wc-kachel-titel">[[Fusion/Diagnose und Fehlersuche|Hilfe bei Problemen]]</div>
Fehlersuche, Protokoll, [[Fusion/Wiederherstellung|Wiederherstellung]].</div>
<div class="wc-kachel"><div class="wc-kachel-sym">🧩</div><div class="wc-kachel-titel">[https://wettercube.de/hardware/ Hardware und Gehäuse]</div>
Welches Board brauche ich? Gehäuse zum Selbstdrucken.</div>
<div class="wc-kachel"><div class="wc-kachel-sym">🗺️</div><div class="wc-kachel-titel">[[Fusion/Roadmap|Roadmap]]</div>
Was kommt als Nächstes? Die ganze Familie 2026 bis 2027.</div>
</div>

<div class="wc-box">'''Warum ich das mache:''' Ich bin wetterfühlig und wollte die wichtigen Informationen zentral an einem Ort haben, zugeschnitten auf mich. '''Lokal statt Cloud:''' Die Web-Oberflächen laufen auf den Geräten selbst und sind nur im lokalen WLAN erreichbar; einen Cloud-Zwang gibt es nicht. Google muss nicht wissen, wie warm es gerade in meinem Schlafzimmer ist.</div>

<div class="wc-box">'''Updates und Pflege:''' Der Fusion ist die aktuelle Speerspitze; der Next wird parallel entwickelt. Der WetterCubePlus wird weiterhin mit Updates versorgt, auch mit neuen Funktionen, soweit es die Möglichkeiten des Geräts zulassen. Der WetterCube bekommt nur noch Sicherheitsupdates, wenn sie nötig sind.</div>

<div class="wc-box">'''Auf eigene Gefahr:''' Software und Anleitungen setzt du auf eigene Verantwortung ein, für Schäden oder Folgen übernehme ich keine Haftung. Du solltest grob wissen, was du tust (Board flashen, WLAN einrichten, bei WetterCube und WetterCubePlus auch Kabel crimpen und löten). Bei Unklarheiten frag lieber nach: über das [https://wettercube.de/kontakt/ Kontaktformular] oder auf GitHub (Issues). Beim Flashen kann man bei einem ESP32 in aller Regel nicht viel kaputt machen, das Board lässt sich jederzeit neu flashen; echte Schäden entstehen eher durch falsche Verkabelung oder eine falsche Spannung. Wetterdaten, Warnungen, Pollenflug und Biowetter dienen nur der Information und ersetzen weder amtliche Warnungen (z. B. NINA, WarnWetter-App des DWD) noch ärztlichen Rat.</div>

<div class="wc-box">'''WetterCube ist ein Softwareprojekt.''' Ich stelle die Software (Firmware) bereit; das Gerät baust du selbst: Board kaufen, Firmware aufspielen, ein Gehäuse nach deinem Geschmack gestalten. Ich versuche, zu den einzelnen Cubes passende Gehäuse anzubieten. Kurzanleitungen zum Bau gibt es unter [https://wettercube.de/bauanleitung/ Bauanleitung].</div>

<div class="wc-box">'''Sprache und Region:''' Das WetterCube-Projekt gibt es derzeit nur auf Deutsch. Weil die Wetterdaten für Warnungen, Pollenflug und Biowetter vom Deutschen Wetterdienst (DWD) kommen, funktioniert es derzeit auch nur in Deutschland vollständig. Geplant sind eine Übersetzung ins Englische und weltweit nutzbare Wetterinfos, einen festen Termin gibt es noch nicht.</div>

<div class="wc-box">'''In Entwicklung:''' Fusion und Next sind noch in Entwicklung (Alpha). Mit den aktuellen Versionen können Fehler auftreten.</div>

== Stand der Produkte ==
{| class="wikitable"
! Produkt !! Stand !! Version
|-
| WetterCube Fusion || <span class="wc-status">In Entwicklung</span> || v0.9.9-alpha7
|-
| WetterCube Next (Modul zum Fusion) || <span class="wc-status">In Entwicklung</span> || v0.1.0-alpha5
|-
| WetterCubePlus || veröffentlicht || v1.8.1
|-
| WetterCube || veröffentlicht || v2.0.2
|}

<div class="wc-box">💙 '''Danke an PicoPixel:''' Die LVGL-UI der WetterCubes wird mit [https://picopixel.io/de/ PicoPixel] erstellt, einem kostenlosen, browserbasierten Editor für LVGL. Ich bin von dem Projekt überzeugt; das ist kein Werbe- oder Affiliate-Link, ich verdiene nichts daran.</div>

== Wo gibt es was? ==
* '''[https://wettercube.de/ Homepage]:''' die Familie, Roadmap, Vergleich, [https://wettercube.de/installieren/ Installieren], [https://wettercube.de/hardware/ Hardware und Gehäuse]
* '''Dieses Wiki:''' alle Anleitungen, nach Produkt gegliedert (Seitenleiste links)
* '''GitHub:''' [https://github.com/JPPeterson-lab/WetterCube-Fusion Fusion], [https://github.com/JPPeterson-lab/WetterCube-Next Next], [https://github.com/JPPeterson-lab/WetterCubePlus WetterCubePlus], [https://github.com/JPPeterson-lab/WetterCube WetterCube] (Releases und Fehlermeldungen)

<div class="wc-box">'''Frei für den privaten Gebrauch.''' Die Firmware von Fusion und Next ist kostenlos für den privaten Gebrauch; der Quellcode ist aktuell nicht öffentlich. '''Mein Versprechen:''' Die private Nutzung aller WetterCubes (WetterCube, WetterCubePlus, Fusion und Next) bleibt auch in Zukunft frei. Für kommerzielle Nutzung von WetterCubePlus, Fusion und Next bitte vorher [https://wettercube.de/kontakt/ Kontakt] aufnehmen (der WetterCube steht unter der MIT-Lizenz).</div>

[[Kategorie:Hauptseite]]

WetterCubePlus/Screens und Funktionen/en

2026-10-19T12:19:40Z

WetterCube: WetterCube Website

<div class="wc-sprachhinweis">Dies ist die englische Fassung. [[WetterCubePlus/Screens und Funktionen|Zur deutschen Fassung]]</div>

<gallery mode="packed" heights="260px">
Datei:WetterCubePlus-01_hauptscreen-8f4ec6.jpg|Hauptscreen / Main screen
Datei:WetterCubePlus-02_vorhersage-e3bf3d.jpg|Vorhersage / Forecast
Datei:WetterCubePlus-03_pollen-919e3d.jpg|Pollen
Datei:WetterCubePlus-04_regenradar-9fb824.jpg|Regenradar / Rain radar
Datei:WetterCubePlus-05_sonne_mond-d1353b.jpg|Sonne & Mond / Sun & moon
Datei:WetterCubePlus-06_luftqualitaet-9a708b.jpg|Luftqualität / Air quality
Datei:WetterCubePlus-07_biowetter-7fa8e5.jpg|Biowetter
Datei:WetterCubePlus-08_gesundheit-644d1a.jpg|Gesundheit / Health
Datei:WetterCubePlus-12_bubblebreaker_spiel-487305.jpg|Bubblebreaker
</gallery>
== Bildschirmfotos vom Gerät / Screenshots from the device (v1.8.1) ==

Direkt vom Gerät aufgenommen (480×320, pixelgenau). / Taken straight from the device (480×320, pixel-exact).

<gallery mode="packed" heights="260px">
Datei:wc-wettercubeplus-plus-hauptscreen-0b8988.png|Hauptscreen / Main screen
Datei:wc-wettercubeplus-plus-vorhersage-617f2f.png|Vorhersage / Forecast
Datei:wc-wettercubeplus-plus-temperaturverlauf-3920b5.png|Temperaturverlauf / Temperature history
Datei:wc-wettercubeplus-plus-pollen-fc9878.png|Pollen (Tage / days)
Datei:wc-wettercubeplus-plus-pollen-stuendlich-8f835b.png|Pollen (stündlich / hourly)
Datei:wc-wettercubeplus-plus-warnkarte-a84431.png|Regenradar / Rain radar
Datei:wc-wettercubeplus-plus-warnkarte-2-4a66f8.png|Wetterwarnungen / Weather warnings
Datei:wc-wettercubeplus-plus-sonne-mond-855547.png|Sonne & Mond / Sun & moon
Datei:wc-wettercubeplus-plus-luftqualitaet-2022d7.png|Luftqualität / Air quality
Datei:wc-wettercubeplus-plus-biowetter-ae6a6e.png|Biowetter (heute) / Bio-weather (today)
Datei:wc-wettercubeplus-plus-biowetter-2-70f52e.png|Biowetter (morgen) / Bio-weather (tomorrow)
Datei:wc-wettercubeplus-plus-gesundheit-8884cb.png|Gesundheit / Health
Datei:wc-wettercubeplus-plus-menue-4f030a.png|Menü / Menu
</gallery>
----

== Screens ==

{| class="wikitable"
! # !! Screen !! Content
|-
| 1 || '''Main screen''' || current weather, time, date, the two strongest pollen for the next hour or (switchable) the two strongest biowetter values, hint tile at the top left (rain, frost, UV), update icon (top right, when an update is available)
|-
| 2 || '''Forecast''' || 4 time slots with icon, temperature and wind
|-
| 2a || '''Temperature chart''' || Temperature of the next 24 hours as a line chart (labels every 4 hours, min/max), optionally with rain bars (mm per hour) below
|-
| 3 || '''Pollen forecast (hours)''' || pollen load for the next hours (Open-Meteo)
|-
| 4 || '''Pollen forecast (days)''' || 8 allergens (DWD) for today, tomorrow and the day after
|-
| 5 || '''Rain radar''' || section of the chosen federal state (DWD), with location dot and wind arrow
|-
| 6 || '''Sun and moon''' || UV index, sunrise/sunset, daily min/max
|-
| 7 || '''Air quality''' || European AQI as an arc, PM2.5, PM10, NO₂ and ozone, color-coded by EU limits
|-
| 8–9 || '''DWD Biowetter (health weather)''' || health-related weather effects in 7 categories (today, tomorrow)
|-
| 10 || '''Health screen''' || top-4 pollen, 4 selectable Biowetter categories, AQI/ozone/PM2.5/UV as colored dots
|-
| 11 || '''Warning screen''' || flashes on a pollen warning, tap for details
|-
| 12 || '''DWD warning map''' || warnings for your location as colored cards, sorted by level
|-
| – || '''Menu''' || on-device settings, Bubblebreaker, calculator
|}

On the main screen a red '''warning button''' blinks at the bottom center as soon as DWD warnings are active. Tapping it opens the warning map and acknowledges the warning (which also stops the blinking of the [[WetterCubePlus/WetterAmpel/en|WetterAmpel]]).

== Calculator ==

A colorful calculator with the four basic operations, percent, sign toggle, decimal comma, backspace and C. It works like a classic pocket calculator: '''left to right''' (no operator precedence). <code>200 + 10 %</code> gives <code>220</code>, and a division by 0 shows "Fehler" (error). The red X returns to the menu. The screen is only created when opened and freed again when closed.

== Bubblebreaker ==

A colorful bubble puzzle: tap connected color groups to clear them. It has an '''undo''' for the last move, the modes '''Normal''' and '''Laufend''' (endless; the board refills automatically) and a '''high-score table''' (top 5, kept across restarts).

== Data sources ==

{| class="wikitable"
! Source !! Data !! Interval
|-
| [https://open-meteo.com Open-Meteo] || weather, pollen (hourly), air quality || 10 to 60 min
|-
| [https://opendata.dwd.de DWD Opendata] || daily pollen forecast, weather warnings, Biowetter || 15 min to 3 h
|-
| [https://maps.dwd.de DWD WMS] || rain radar of the federal state || 10 min
|}

Pollen: the main screen top-3 and the pollen warning use Open-Meteo hourly values, the 3-day screen uses the DWD pollen hazard index. All data is free and needs '''no API key'''.

<div class="wc-box">'''Region:''' warnings, Biowetter, the pollen-flight forecast and radar come from the German Weather Service and only work in Germany. A worldwide variant with other providers is conceivable but not planned yet.</div>

----

== Hinweis-Kachel (Regen, Sturm, Frost, UV) / Hint tile (rain, frost, UV) ==

'''Deutsch:''' Oben links auf dem Hauptscreen sitzt eine farbige Kachel mit bis zu vier Hinweisen:

{| class="wikitable"
! Hinweis !! Farbe !! Beispiel !! Auslöser
|-
| Regen || blau || „Regen in 25 Min.“, „Regen noch 10 Min.“, „Es regnet“ || mindestens 0,1 mm je 15 Minuten in den nächsten 3 Stunden (Open-Meteo, weltweit)
|-
| Sturm || violett || „Sturmböen ab 17:00, 78 km/h“ || Böen ab 62 km/h (Beaufort 8) in den nächsten 6 Stunden
|-
| Frost || petrol || „Frost ab 03:00, -2 °C“ || 0 °C oder darunter in den nächsten 12 Stunden
|-
| UV || orange-braun || „UV hoch (7), Sonnenschutz“ || UV-Index 6 oder höher jetzt oder in den nächsten 3 Stunden
|}

'''Bedienung:''' Ein neuer Hinweis lässt die Kachel '''blinken'''. Antippen '''bestätigt''' ihn, danach leuchtet die Kachel dauerhaft, solange der Hinweis gilt. Sind mehrere Hinweise aktiv, werden die unbestätigten nacheinander gezeigt (Regen, Sturm, Frost, UV); jedes Antippen bestätigt den gezeigten und zeigt den nächsten. Danach bleibt der wichtigste dauerhaft sichtbar (Regen vor Sturm vor Frost vor UV), ein weiteres Antippen wechselt zum nächsten aktiven Hinweis. Ein bestätigter Hinweis blinkt erst wieder, wenn seine Bedingung mindestens 20 Minuten lang weg war. Ist nichts aktiv, bleibt das Feld leer. Jeder Hinweis lässt sich in der WebUI einzeln abschalten. Die Kachel ersetzt die frühere Regenwarnung (Vollbild-Screen), die mit Version 1.6.0 entfallen ist.

'''English:''' A colored tile at the top left of the main screen shows up to four hints: '''rain''' (blue, "Regen in 25 Min." etc., at least 0.1 mm per 15 minutes within the next 3 hours, Open-Meteo, worldwide), '''storm''' (violet, "Sturmböen ab 17:00, 78 km/h", gusts of 62 km/h or more within the next 6 hours), '''frost''' (teal, "Frost ab 03:00, -2 °C", 0 °C or below within the next 12 hours) and '''UV''' (orange-brown, "UV hoch (7), Sonnenschutz", UV index 6 or higher now or within the next 3 hours).

'''Operation:''' A new hint makes the tile '''blink'''. Tapping '''acknowledges''' it, after which the tile stays lit as long as the hint applies. If several hints are active, the unacknowledged ones are shown one after another (rain, frost, UV); each tap acknowledges the one shown and shows the next. After that the most important one stays visible (rain before storm before frost before UV), and another tap switches to the next active hint. An acknowledged hint only blinks again after its condition has been gone for at least 20 minutes. If nothing is active the field stays empty. Each hint can be switched off individually in the WebUI. The tile replaces the former rain warning (full-screen), which was removed in version 1.6.0.

[[Kategorie:Next]]
[[Kategorie:English]]

WetterCubePlus/Screens und Funktionen

2026-10-19T12:19:39Z

WetterCube: WetterCube Website

<div class="wc-sprachhinweis">[[WetterCubePlus/Screens und Funktionen/en|English version]]</div>

<gallery mode="packed" heights="260px">
Datei:WetterCubePlus-01_hauptscreen-8f4ec6.jpg|Hauptscreen / Main screen
Datei:WetterCubePlus-02_vorhersage-e3bf3d.jpg|Vorhersage / Forecast
Datei:WetterCubePlus-03_pollen-919e3d.jpg|Pollen
Datei:WetterCubePlus-04_regenradar-9fb824.jpg|Regenradar / Rain radar
Datei:WetterCubePlus-05_sonne_mond-d1353b.jpg|Sonne & Mond / Sun & moon
Datei:WetterCubePlus-06_luftqualitaet-9a708b.jpg|Luftqualität / Air quality
Datei:WetterCubePlus-07_biowetter-7fa8e5.jpg|Biowetter
Datei:WetterCubePlus-08_gesundheit-644d1a.jpg|Gesundheit / Health
Datei:WetterCubePlus-12_bubblebreaker_spiel-487305.jpg|Bubblebreaker
</gallery>
== Bildschirmfotos vom Gerät / Screenshots from the device (v1.8.1) ==

Direkt vom Gerät aufgenommen (480×320, pixelgenau). / Taken straight from the device (480×320, pixel-exact).

<gallery mode="packed" heights="260px">
Datei:wc-wettercubeplus-plus-hauptscreen-0b8988.png|Hauptscreen / Main screen
Datei:wc-wettercubeplus-plus-vorhersage-617f2f.png|Vorhersage / Forecast
Datei:wc-wettercubeplus-plus-temperaturverlauf-3920b5.png|Temperaturverlauf / Temperature history
Datei:wc-wettercubeplus-plus-pollen-fc9878.png|Pollen (Tage / days)
Datei:wc-wettercubeplus-plus-pollen-stuendlich-8f835b.png|Pollen (stündlich / hourly)
Datei:wc-wettercubeplus-plus-warnkarte-a84431.png|Regenradar / Rain radar
Datei:wc-wettercubeplus-plus-warnkarte-2-4a66f8.png|Wetterwarnungen / Weather warnings
Datei:wc-wettercubeplus-plus-sonne-mond-855547.png|Sonne & Mond / Sun & moon
Datei:wc-wettercubeplus-plus-luftqualitaet-2022d7.png|Luftqualität / Air quality
Datei:wc-wettercubeplus-plus-biowetter-ae6a6e.png|Biowetter (heute) / Bio-weather (today)
Datei:wc-wettercubeplus-plus-biowetter-2-70f52e.png|Biowetter (morgen) / Bio-weather (tomorrow)
Datei:wc-wettercubeplus-plus-gesundheit-8884cb.png|Gesundheit / Health
Datei:wc-wettercubeplus-plus-menue-4f030a.png|Menü / Menu
</gallery>
----

== Bildschirme ==

{| class="wikitable"
! # !! Screen !! Inhalt
|-
| 1 || '''Hauptscreen''' || aktuelles Wetter, Uhrzeit, Datum, die zwei stärksten Pollen der nächsten Stunde oder (umschaltbar) die zwei stärksten Biowetter-Werte, Hinweis-Kachel oben links (Regen, Sturm, Frost, UV), Update-Symbol (oben rechts, wenn ein Update bereitsteht)
|-
| 2 || '''Wettervorhersage''' || 4 Zeit-Slots mit Icon, Temperatur und Wind
|-
| 2a || '''Temperaturverlauf''' || Temperatur der nächsten 24 Stunden als Liniendiagramm (Beschriftung alle 4 Stunden, Min/Max), darunter optional Regenbalken (mm je Stunde)
|-
| 3 || '''Pollenvorhersage (Stunden)''' || Pollenbelastung der nächsten Stunden (Open-Meteo)
|-
| 4 || '''Pollenvorhersage (Tage)''' || 8 Allergene (DWD) für heute, morgen und übermorgen
|-
| 5 || '''Niederschlagsradar''' || Ausschnitt des gewählten Bundeslandes (DWD), mit Standortpunkt und Windpfeil
|-
| 6 || '''Sonne und Mond''' || UV-Index, Sonnenaufgang/-untergang, Tages-Min/-Max
|-
| 7 || '''Luftqualität''' || europäischer AQI als Bogen, PM2.5, PM10, NO₂ und Ozon, farbkodiert nach EU-Grenzwerten
|-
| 8–9 || '''DWD-Biowetter''' || gesundheitliche Wettereinflüsse in 7 Kategorien (Heute, Morgen)
|-
| 10 || '''Gesundheitsscreen''' || Top-4-Pollen, 4 wählbare Biowetter-Kategorien, AQI/Ozon/PM2.5/UV als farbige Punkte
|-
| 11 || '''Warnscreen''' || blinkt bei Pollenwarnung, Antippen zeigt Details
|-
| 12 || '''DWD-Warnkarte''' || Warnmeldungen für den Standort als farbige Karten, nach Warnstufe sortiert
|-
| – || '''Menü''' || Einstellungen am Gerät, Bubblebreaker, Taschenrechner
|}

Auf dem Hauptscreen blinkt unten in der Mitte ein roter '''Warn-Button''', sobald DWD-Warnungen aktiv sind. Antippen öffnet die Warnkarte und bestätigt die Warnung (das beendet auch das Blinken der [[WetterCubePlus/WetterAmpel|WetterAmpel]]).

== Taschenrechner ==

Bunter Taschenrechner mit den vier Grundrechenarten, Prozent, Vorzeichen-Wechsel, Komma, Rückschritt und C. Er rechnet wie ein klassischer Taschenrechner: '''von links nach rechts''' (keine Punkt-vor-Strich-Regel). <code>200 + 10 %</code> ergibt <code>220</code>, eine Division durch 0 zeigt „Fehler“. Mit dem roten X geht es zurück ins Menü. Der Screen wird erst beim Öffnen angelegt und beim Schließen wieder freigegeben.

== Bubblebreaker ==

Bunte Bubble-Puzzle: zusammenhängende Farbgruppen antippen und auflösen. Es gibt einen '''Undo''' für den letzten Zug, die Modi '''Normal''' und '''Laufend''' (das Feld füllt sich automatisch nach) und eine '''Bestenliste''' (Top 5, bleibt nach einem Neustart erhalten).

== Datenquellen ==

{| class="wikitable"
! Quelle !! Daten !! Intervall
|-
| [https://open-meteo.com Open-Meteo] || Wetter, Pollen (stündlich), Luftqualität || 10 bis 60 Min.
|-
| [https://opendata.dwd.de DWD Opendata] || Pollenflug-Tagesvorhersage, Wetterwarnungen, Biowetter || 15 Min. bis 3 Std.
|-
| [https://maps.dwd.de DWD WMS] || Niederschlagsradar des Bundeslandes || 10 Min.
|}

Pollen: Hauptscreen-Top-3 und Pollenwarnung nutzen Open-Meteo-Stundenwerte, der 3-Tage-Screen den DWD-Pollenflug-Gefahrenindex. Alle Daten sind kostenlos und brauchen '''keinen API-Schlüssel'''.

<div class="wc-box">'''Region:''' Warnungen, Biowetter, Pollenflug-Vorhersage und Radar kommen vom Deutschen Wetterdienst und funktionieren nur in Deutschland. Eine weltweite Variante mit anderen Anbietern ist denkbar, aber noch nicht geplant.</div>

[[Kategorie:Next]]

WetterCubePlus/Einstellungen/en

2026-10-19T12:19:31Z

WetterCube: WetterCube Website

<div class="wc-sprachhinweis">Dies ist die englische Fassung. [[WetterCubePlus/Einstellungen|Zur deutschen Fassung]]</div>

----

Settings can be changed in two places: the '''web interface''' (<code>http://wettercubeplus.local</code>) and directly on the '''menu screen''' of the display (gear icon on the main screen).

== Web interface ==

The web interface has four '''tabs'''. The chosen tab stays when you reload and can be opened by link (e.g. <code>http://wettercubeplus.local/#system</code>). At the top right you switch between the '''light and dark design''' (without a choice your browser setting applies). On the ''Anzeige'' and ''Wetter & Daten'' tabs '''"Einstellungen speichern"''' (save settings) stays visible at the bottom, and a note shows unsaved changes.

{| class="wikitable"
! Tab !! Card !! Setting
|-
| '''Anzeige''' (display) || Display || Brightness 10–100 % (slider), dim timeout: off / 1 / 3 / 5 / 10 minutes
|-
| || Night mode || Switch, from/to (15-minute steps), own night brightness 0–50 %
|-
| || Main screen || "Rechtes Feld" (right-hand field): shows pollen (your allergens) or biowetter (your four categories), the two strongest values. "Regenbalken im Temperaturverlauf" (rain bars in the temperature chart) on/off
|-
| || Hint tile || Rain, storm, frost and UV hint each on/off (default: all on)
|-
| '''Wetter & Daten''' (weather & data) || Location & region || City (without umlauts) and DWD pollen region (federal state for warnings and radar map)
|-
| || Warnings || Pollen warning on/off, DWD weather warnings on/off, pollen warning threshold: low / medium / high / strong
|-
| || My allergens || Switches for hazel, alder, ash, birch, grass, rye, mugwort, ragweed: the pollen warning, the health screen and the two pollen on the main screen consider only the selected ones
|-
| || Biowetter || DWD zone (A–K); weather sensitivity: 4 categories for the health screen
|-
| '''Ampel''' (traffic light) || Traffic-light configuration || Mode (temperature / pollen / air quality) and temperature ranges for green/yellow/red of the [[WetterCubePlus/WetterAmpel/en|WetterAmpel]], with live display of what the light currently shows
|-
| '''System''' || Firmware update || Check for updates, show version and install (see [[WetterCubePlus/Updates (OTA)/en|Updates]]); "Log ansehen" opens the [[WetterCubePlus/Diagnose und Fehlersuche/en|diagnostic log]]
|-
| || Settings backup || "Einstellungen herunterladen" saves all settings as a file (without the Wi-Fi password); "Wiederherstellen" restores such a file and restarts the device
|-
| || Wi-Fi || "WLAN ändern" to enter new credentials
|}

== Menu screen on the display ==

{| class="wikitable"
! Element !! Function
|-
| Brightness slider || sets and saves the brightness directly
|-
| Pollen warning / DWD warnings switches || turn the respective warning on or off
|-
| "Bio statt Pollen" switch || right-hand field of the main screen: show biowetter instead of pollen
|-
| Light/dark switch || toggles between the light and dark color theme
|-
| Game icon || starts '''Bubblebreaker'''
|-
| Calculator icon || opens the '''calculator'''
|-
| Version label || shows the installed firmware version
|}

== Defaults (after a fresh install that erased the flash) ==

{| class="wikitable"
! Setting !! Default
|-
| Brightness || 80 %
|-
| Dim timeout || 3 minutes
|-
| Night mode || off (22:00 to 06:00, night brightness 10 %)
|-
| Pollen warning || on
|-
| Allergens || all eight selected
|-
| Traffic light || green 15–19 °C, yellow 20–24 °C, red 25–99 °C
|-
| Biowetter zone || A
|}

All settings are kept across firmware updates. They are only lost when the entire flash is erased (e.g. "erase device" in the web installer or "Erase All Flash" in the Arduino IDE). Tip: first use '''Einstellungen herunterladen''' in the web interface; afterwards '''Wiederherstellen''' brings them back (only the Wi-Fi has to be set up again).

[[Kategorie:Next]]
[[Kategorie:English]]

WetterCubePlus/Einstellungen

2026-10-19T12:19:30Z

WetterCube: WetterCube Website

<div class="wc-sprachhinweis">[[WetterCubePlus/Einstellungen/en|English version]]</div>

----

Einstellungen lassen sich an zwei Stellen ändern: in der '''Web-Oberfläche''' (<code>http://wettercubeplus.local</code>) und direkt am '''Menü-Screen''' des Displays (Zahnrad-Symbol auf dem Hauptscreen).

== Web-Oberfläche ==

Die Web-Oberfläche hat vier '''Reiter'''. Der gewählte Reiter bleibt beim Neuladen erhalten und lässt sich per Link öffnen (z. B. <code>http://wettercubeplus.local/#system</code>). Oben rechts wechselst du zwischen '''hellem und dunklem Design''' (ohne Wahl gilt die Einstellung deines Browsers). Auf den Reitern ''Anzeige'' und ''Wetter & Daten'' bleibt '''„Einstellungen speichern“''' unten sichtbar, ein Hinweis zeigt ungespeicherte Änderungen.

{| class="wikitable"
! Reiter !! Karte !! Einstellung
|-
| '''Anzeige''' || Display || Helligkeit 10–100 % (Slider), Dimm-Timeout: Aus / 1 / 3 / 5 / 10 Minuten
|-
| || Nachtmodus || Schalter, Von/Bis (15-Minuten-Schritte), eigene Nacht-Helligkeit 0–50 %
|-
| || Hauptscreen || „Rechtes Feld“: zeigt Pollen (deine Allergene) oder Biowetter (deine vier Kategorien), die zwei stärksten Werte. „Regenbalken im Temperaturverlauf“ ein/aus
|-
| || Hinweis-Kachel || Regen-, Sturm-, Frost- und UV-Hinweis je ein/aus (Standard: alle an)
|-
| '''Wetter & Daten''' || Standort & Region || Stadt (ohne Umlaute) und DWD-Pollenregion (Bundesland für Warnungen und Radarkarte)
|-
| || Warnungen || Pollenwarnung ein/aus, DWD-Wetterwarnungen ein/aus, Pollen-Warnschwelle: Gering / Mittel / Hoch / Stark
|-
| || Meine Allergene || Schalter für Hasel, Erle, Esche, Birke, Gräser, Roggen, Beifuß, Ambrosia: Pollenwarnung, Gesundheitsscreen und die zwei Pollen auf dem Hauptscreen berücksichtigen nur die gewählten
|-
| || Biowetter || DWD-Zone (A–K); Wetterfühligkeit: 4 Kategorien für den Gesundheitsscreen frei wählbar
|-
| '''Ampel''' || Ampel-Konfiguration || Modus (Temperatur / Pollen / Luftqualität) und Temperaturbereiche für Grün/Gelb/Rot der [[WetterCubePlus/WetterAmpel|WetterAmpel]], mit Live-Anzeige, was die Ampel gerade auslöst
|-
| '''System''' || Firmware-Update || Auf Updates prüfen, Version anzeigen und installieren (siehe [[WetterCubePlus/Updates (OTA)|Updates]]); „Log ansehen“ öffnet das [[WetterCubePlus/Diagnose und Fehlersuche|Diagnose-Log]]
|-
| || Einstellungen sichern || „Einstellungen herunterladen“ speichert alle Einstellungen als Datei (ohne WLAN-Passwort); „Wiederherstellen“ spielt eine solche Datei ein und startet das Gerät neu
|-
| || WLAN || „WLAN ändern“ für neue Zugangsdaten
|}

== Menü-Screen am Display ==

{| class="wikitable"
! Element !! Funktion
|-
| Helligkeitsregler || stellt die Helligkeit direkt ein und speichert sie
|-
| Schalter Pollenwarnung / DWD-Warnungen || schaltet die jeweilige Warnung an oder aus
|-
| Schalter „Bio statt Pollen“ || rechtes Feld des Hauptscreens: Biowetter statt Pollen anzeigen
|-
| Hell/Dunkel-Umschalter || wechselt zwischen hellem und dunklem Farbthema
|-
| Spiel-Symbol || startet '''Bubblebreaker'''
|-
| Rechner-Symbol || öffnet den '''Taschenrechner'''
|-
| Versionsanzeige || zeigt die installierte Firmware-Version
|}

== Standardwerte (nach Neuinstallation mit Löschen des Flashs) ==

{| class="wikitable"
! Einstellung !! Standard
|-
| Helligkeit || 80 %
|-
| Dimm-Timeout || 3 Minuten
|-
| Nachtmodus || aus (22:00 bis 06:00, Nacht-Helligkeit 10 %)
|-
| Pollenwarnung || an
|-
| Allergene || alle acht gewählt
|-
| Ampel || Grün 15–19 °C, Gelb 20–24 °C, Rot 25–99 °C
|-
| Biowetter-Zone || A
|}

Alle Einstellungen bleiben bei Firmware-Updates erhalten. Sie gehen nur verloren, wenn der gesamte Flash gelöscht wird (z. B. „Gerät löschen“ im Web-Installer oder „Erase All Flash“ in der Arduino IDE). Tipp: Vorher in der Web-Oberfläche '''Einstellungen herunterladen''', dann lassen sie sich danach mit '''Wiederherstellen''' wieder einspielen (nur das WLAN muss neu eingerichtet werden).

[[Kategorie:Next]]

WetterCube/Hardware/en

2026-10-19T12:16:52Z

WetterCube: WetterCube Website

<div class="wc-sprachhinweis">Dies ist die englische Fassung. [[WetterCube/Hardware|Zur deutschen Fassung]]</div>

----

'''Note on assembly:''' The WetterCube is aimed at people with some knowledge of electronics: during assembly, cables have to be crimped and parts soldered. If you do not want that, the [https://github.com/JPPeterson-lab/WetterCube-Fusion WetterCube Fusion] is the better choice. That is why, for the newer devices (Fusion and Next), I rely on complete boards with an integrated display: building is easy even for people who know nothing about wiring up an ESP32 and the like.

== Components ==

{| class="wikitable"
! Component !! Type
|-
| Microcontroller || '''ESP32-C3 Super Mini'''
|-
| Display || '''ST7789''', 1.54", '''240×240 px''', SPI
|-
| Button || '''TTP223''' (capacitive touch sensor)
|-
| Case || [https://makerworld.com/de/models/2501721-simple-print-monitor-st7789-1-54-display-case#profileId-2750174 Simple Print Monitor – ST7789 1.54" Display Case] by [https://github.com/Keralots Keralots] (3D print, Bambu Makerworld)
|}

== Pin assignment (ESP32-C3) ==

{| class="wikitable"
! Function !! GPIO
|-
| TFT MOSI (SPI) || 20
|-
| TFT SCLK (SPI) || 21
|-
| TFT CS || 6
|-
| TFT DC || 7
|-
| TFT RST || 10
|-
| TFT backlight || 5
|-
| Touch button (TTP223) || 3
|}

The backlight is regulated with PWM (5 kHz, 8 bit), which makes brightness, dimming and night mode possible. A wiring diagram is in the [https://github.com/JPPeterson-lab/WetterCube#kabeldiagramm README].

== Assembly in the case ==

[[Datei:wc-wettercube-wettercube-aufbau-06596d.jpg|center|700px|What the assembly can look like: display in the case, ESP32-C3 Super Mini in the lid, the touch button (red board) glued in on the left of the case.]]
'''Tip:''' Glue the touch button (TTP223) to the inside of the top of the case, for example with some liquid electrical tape or silicone.

== Power supply ==

The ESP32-C3 Super Mini is powered via '''USB-C'''; an ordinary 5 V USB supply is sufficient. A very thin or long cable can cause dropouts when transmitting over Wi-Fi.

== Notes ==

* Output in the serial monitor (115200 baud) comes via the board's USB port. In normal operation the [[WetterCube/Diagnose und Fehlersuche/en|<code>/log</code>]] in the browser is enough, no USB cable needed.
* The cube has a single button and no touchscreen. Operation: [[WetterCube/Screens und Funktionen/en|Screens and features]].

[[Kategorie:Next]]
[[Kategorie:English]]

WetterCube/Hardware

2026-10-19T12:16:51Z

WetterCube: WetterCube Website

<div class="wc-sprachhinweis">[[WetterCube/Hardware/en|English version]]</div>

----

'''Hinweis zum Aufbau:''' Der WetterCube richtet sich an Leute mit etwas Elektronik-Kenntnis: Beim Aufbau müssen Kabel gecrimpt und Bauteile gelötet werden. Wer das nicht möchte, ist mit dem [https://github.com/JPPeterson-lab/WetterCube-Fusion WetterCube Fusion] besser bedient. Bei den neueren Geräten (Fusion und Next) setze ich deshalb auf komplette Boards mit integriertem Display: Der Bau ist so auch für Leute einfach, die sich mit dem Verkabeln von ESP32 und Co. nicht auskennen.

== Bauteile ==

{| class="wikitable"
! Komponente !! Typ
|-
| Mikrocontroller || '''ESP32-C3 Super Mini'''
|-
| Display || '''ST7789''', 1,54", '''240×240 px''', SPI
|-
| Taste || '''TTP223''' (kapazitiver Touch-Sensor)
|-
| Gehäuse || [https://makerworld.com/de/models/2501721-simple-print-monitor-st7789-1-54-display-case#profileId-2750174 Simple Print Monitor – ST7789 1.54" Display Case] von [https://github.com/Keralots Keralots] (3D-Druck, Bambu Makerworld)
|}

== Pinbelegung (ESP32-C3) ==

{| class="wikitable"
! Funktion !! GPIO
|-
| TFT MOSI (SPI) || 20
|-
| TFT SCLK (SPI) || 21
|-
| TFT CS || 6
|-
| TFT DC || 7
|-
| TFT RST || 10
|-
| TFT Backlight || 5
|-
| Touch-Taste (TTP223) || 3
|}

Das Backlight wird per PWM (5 kHz, 8 Bit) geregelt, so lassen sich Helligkeit, Dimmen und Nachtmodus umsetzen. Ein Kabeldiagramm steht in der [https://github.com/JPPeterson-lab/WetterCube#kabeldiagramm README].

== Aufbau im Gehäuse ==

[[Datei:wc-wettercube-wettercube-aufbau-06596d.jpg|center|700px|So kann der Aufbau aussehen: Display im Gehäuse, ESP32-C3 Super Mini im Deckel, der Touch-Taster (rote Platine) links im Gehäuse eingeklebt.]]
'''Tipp:''' Den Touch-Taster (TTP223) klebst du von innen an die Oberseite des Gehäuses, zum Beispiel mit etwas Flüssigisolierband oder Silikon.

== Stromversorgung ==

Der ESP32-C3 Super Mini wird über '''USB-C''' versorgt, ein normales 5-V-USB-Netzteil genügt. Ein sehr dünnes oder langes Kabel kann beim WLAN-Senden zu Aussetzern führen.

== Hinweise ==

* Ausgaben im Seriellen Monitor (115200 Baud) kommen über den USB-Port des Boards. Im Normalbetrieb genügt das [[WetterCube/Diagnose und Fehlersuche|<code>/log</code>]] im Browser, ohne USB-Kabel.
* Der Cube hat nur eine Taste und keinen Touchscreen. Bedienung: [[WetterCube/Screens und Funktionen|Screens und Funktionen]].

[[Kategorie:Next]]

WetterCubePlus/Screens und Funktionen/en

2026-10-19T12:16:42Z

WetterCube: WetterCube Website

<div class="wc-sprachhinweis">Dies ist die englische Fassung. [[WetterCubePlus/Screens und Funktionen|Zur deutschen Fassung]]</div>

<gallery mode="packed" heights="260px">
Datei:WetterCubePlus-01_hauptscreen-8f4ec6.jpg|Hauptscreen / Main screen
Datei:WetterCubePlus-02_vorhersage-e3bf3d.jpg|Vorhersage / Forecast
Datei:WetterCubePlus-03_pollen-919e3d.jpg|Pollen
Datei:WetterCubePlus-04_regenradar-9fb824.jpg|Regenradar / Rain radar
Datei:WetterCubePlus-05_sonne_mond-d1353b.jpg|Sonne & Mond / Sun & moon
Datei:WetterCubePlus-06_luftqualitaet-9a708b.jpg|Luftqualität / Air quality
Datei:WetterCubePlus-07_biowetter-7fa8e5.jpg|Biowetter
Datei:WetterCubePlus-08_gesundheit-644d1a.jpg|Gesundheit / Health
Datei:WetterCubePlus-12_bubblebreaker_spiel-487305.jpg|Bubblebreaker
</gallery>
== Bildschirmfotos vom Gerät / Screenshots from the device (v1.8.1) ==

Direkt vom Gerät aufgenommen (480×320, pixelgenau). / Taken straight from the device (480×320, pixel-exact).

<gallery mode="packed" heights="260px">
Datei:wc-wettercubeplus-plus-hauptscreen-0b8988.png|Hauptscreen / Main screen
Datei:wc-wettercubeplus-plus-vorhersage-617f2f.png|Vorhersage / Forecast
Datei:wc-wettercubeplus-plus-temperaturverlauf-3920b5.png|Temperaturverlauf / Temperature history
Datei:wc-wettercubeplus-plus-pollen-fc9878.png|Pollen (Tage / days)
Datei:wc-wettercubeplus-plus-pollen-stuendlich-8f835b.png|Pollen (stündlich / hourly)
Datei:wc-wettercubeplus-plus-warnkarte-a84431.png|Regenradar / Rain radar
Datei:wc-wettercubeplus-plus-warnkarte-2-4a66f8.png|Wetterwarnungen / Weather warnings
Datei:wc-wettercubeplus-plus-sonne-mond-855547.png|Sonne & Mond / Sun & moon
Datei:wc-wettercubeplus-plus-luftqualitaet-2022d7.png|Luftqualität / Air quality
Datei:wc-wettercubeplus-plus-biowetter-ae6a6e.png|Biowetter (heute) / Bio-weather (today)
Datei:wc-wettercubeplus-plus-biowetter-2-70f52e.png|Biowetter (morgen) / Bio-weather (tomorrow)
Datei:wc-wettercubeplus-plus-gesundheit-8884cb.png|Gesundheit / Health
Datei:wc-wettercubeplus-plus-menue-4f030a.png|Menü / Menu
</gallery>
----

== Screens ==

{| class="wikitable"
! # !! Screen !! Content
|-
| 1 || '''Main screen''' || current weather, time, date, the two strongest pollen for the next hour or (switchable) the two strongest biowetter values, hint tile at the top left (rain, frost, UV), update icon (top right, when an update is available)
|-
| 2 || '''Forecast''' || 4 time slots with icon, temperature and wind
|-
| 2a || '''Temperature chart''' || Temperature of the next 24 hours as a line chart (labels every 4 hours, min/max), optionally with rain bars (mm per hour) below
|-
| 3 || '''Pollen forecast (hours)''' || pollen load for the next hours (Open-Meteo)
|-
| 4 || '''Pollen forecast (days)''' || 8 allergens (DWD) for today, tomorrow and the day after
|-
| 5 || '''Rain radar''' || section of the chosen federal state (DWD), with location dot and wind arrow
|-
| 6 || '''Sun and moon''' || UV index, sunrise/sunset, daily min/max
|-
| 7 || '''Air quality''' || European AQI as an arc, PM2.5, PM10, NO₂ and ozone, color-coded by EU limits
|-
| 8–9 || '''DWD Biowetter (health weather)''' || health-related weather effects in 7 categories (today, tomorrow)
|-
| 10 || '''Health screen''' || top-4 pollen, 4 selectable Biowetter categories, AQI/ozone/PM2.5/UV as colored dots
|-
| 11 || '''Warning screen''' || flashes on a pollen warning, tap for details
|-
| 12 || '''DWD warning map''' || warnings for your location as colored cards, sorted by level
|-
| – || '''Menu''' || on-device settings, Bubblebreaker, calculator
|}

On the main screen a red '''warning button''' blinks at the bottom center as soon as DWD warnings are active. Tapping it opens the warning map and acknowledges the warning (which also stops the blinking of the [[WetterCubePlus/WetterAmpel/en|WetterAmpel]]).

== Calculator ==

A colorful calculator with the four basic operations, percent, sign toggle, decimal comma, backspace and C. It works like a classic pocket calculator: '''left to right''' (no operator precedence). <code>200 + 10 %</code> gives <code>220</code>, and a division by 0 shows "Fehler" (error). The red X returns to the menu. The screen is only created when opened and freed again when closed.

== Bubblebreaker ==

A colorful bubble puzzle: tap connected color groups to clear them. It has an '''undo''' for the last move, the modes '''Normal''' and '''Laufend''' (endless; the board refills automatically) and a '''high-score table''' (top 5, kept across restarts).

== Data sources ==

{| class="wikitable"
! Source !! Data !! Interval
|-
| [https://open-meteo.com Open-Meteo] || weather, pollen (hourly), air quality || 10 to 60 min
|-
| [https://opendata.dwd.de DWD Opendata] || daily pollen forecast, weather warnings, Biowetter || 15 min to 3 h
|-
| [https://maps.dwd.de DWD WMS] || rain radar of the federal state || 10 min
|}

Pollen: the main screen top-3 and the pollen warning use Open-Meteo hourly values, the 3-day screen uses the DWD pollen hazard index. All data is free and needs '''no API key'''.

<div class="wc-box">'''Region:''' warnings, Biowetter, the pollen-flight forecast and radar come from the German Weather Service and only work in Germany. A worldwide variant with other providers is conceivable but not planned yet.</div>

----

== Hinweis-Kachel (Regen, Frost, UV) / Hint tile (rain, frost, UV) ==

'''Deutsch:''' Oben links auf dem Hauptscreen sitzt eine farbige Kachel mit bis zu drei Hinweisen:

{| class="wikitable"
! Hinweis !! Farbe !! Beispiel !! Auslöser
|-
| Regen || blau || „Regen in 25 Min.“, „Regen noch 10 Min.“, „Es regnet“ || mindestens 0,1 mm je 15 Minuten in den nächsten 3 Stunden (Open-Meteo, weltweit)
|-
| Frost || petrol || „Frost ab 03:00, -2 °C“ || 0 °C oder darunter in den nächsten 12 Stunden
|-
| UV || orange-braun || „UV hoch (7), Sonnenschutz“ || UV-Index 6 oder höher jetzt oder in den nächsten 3 Stunden
|}

'''Bedienung:''' Ein neuer Hinweis lässt die Kachel '''blinken'''. Antippen '''bestätigt''' ihn, danach leuchtet die Kachel dauerhaft, solange der Hinweis gilt. Sind mehrere Hinweise aktiv, werden die unbestätigten nacheinander gezeigt (Regen, Frost, UV); jedes Antippen bestätigt den gezeigten und zeigt den nächsten. Danach bleibt der wichtigste dauerhaft sichtbar (Regen vor Frost vor UV), ein weiteres Antippen wechselt zum nächsten aktiven Hinweis. Ein bestätigter Hinweis blinkt erst wieder, wenn seine Bedingung mindestens 20 Minuten lang weg war. Ist nichts aktiv, bleibt das Feld leer. Jeder Hinweis lässt sich in der WebUI einzeln abschalten. Die Kachel ersetzt die frühere Regenwarnung (Vollbild-Screen), die mit Version 1.6.0 entfallen ist.

'''English:''' A colored tile at the top left of the main screen shows up to three hints: '''rain''' (blue, "Regen in 25 Min." etc., at least 0.1 mm per 15 minutes within the next 3 hours, Open-Meteo, worldwide), '''frost''' (teal, "Frost ab 03:00, -2 °C", 0 °C or below within the next 12 hours) and '''UV''' (orange-brown, "UV hoch (7), Sonnenschutz", UV index 6 or higher now or within the next 3 hours).

'''Operation:''' A new hint makes the tile '''blink'''. Tapping '''acknowledges''' it, after which the tile stays lit as long as the hint applies. If several hints are active, the unacknowledged ones are shown one after another (rain, frost, UV); each tap acknowledges the one shown and shows the next. After that the most important one stays visible (rain before frost before UV), and another tap switches to the next active hint. An acknowledged hint only blinks again after its condition has been gone for at least 20 minutes. If nothing is active the field stays empty. Each hint can be switched off individually in the WebUI. The tile replaces the former rain warning (full-screen), which was removed in version 1.6.0.

[[Kategorie:Next]]
[[Kategorie:English]]