Schritt 2: Software einrichten und Firmware flashen

Nachdem du die Hardware-Komponenten beschafft hast, geht es nun darum, die notwendige Software auf deinem Computer einzurichten und die WifiWhirl-Firmware auf den NodeMCU-Mikrocontroller zu übertragen (auch "flashen" genannt).

1. Entwicklungsumgebung vorbereiten

Für das Kompilieren und Hochladen der Firmware benötigst du Visual Studio Code (VS Code) mit der PlatformIO IDE Erweiterung.

• Visual Studio Code: Falls noch nicht geschehen, lade und installiere Visual Studio Code für dein Betriebssystem (Windows, Linux oder macOS).
• PlatformIO IDE Erweiterung:
  1. Öffne VS Code.
  2. Klicke auf das Extensions-Icon in der linken Seitenleiste (sieht aus wie vier Quadrate, eines davon abgesetzt).
  3. Suche im Suchfeld nach "PlatformIO IDE".
  4. Klicke bei der offiziellen PlatformIO IDE Erweiterung auf "Install".
  5. Nach der Installation kann ein Neustart von VS Code erforderlich sein. Eventuell öffnet sich auch ein PlatformIO-Startbildschirm oder eine neue Registerkarte.
• NodeMCU USB-Treiber: Dein Computer muss den NodeMCU erkennen können. Die meisten NodeMCU v3 Boards verwenden einen CH340G oder CP2102 USB-zu-Seriell-Chip. Falls dein NodeMCU nicht automatisch erkannt wird, wenn du ihn per USB anschließt, musst du den passenden Treiber installieren:
  • CH340/CH341 Treiber: Oft für günstigere NodeMCU-Klone verwendet. Suche nach "CH340 driver" oder "CH341SER driver".
  • CP210x Treiber: Verwendet von Silicon Labs. Suche nach "CP210x VCP driver". Stelle sicher, dass der NodeMCU nach der Treiberinstallation im Gerätemanager (Windows) oder über lsusb (Linux) korrekt angezeigt wird.

2. WifiWhirl Firmware herunterladen und öffnen

1. Lade die neueste Version der WifiWhirl Software von der WifiWhirl GitHub Releases Seite herunter. Wähle die .zip-Datei des aktuellsten Releases (z.B. WifiWhirl-Software-vX.X.X.zip).
2. Entpacke die heruntergeladene ZIP-Datei in einen Ordner deiner Wahl auf deinem Computer.
3. Öffne Visual Studio Code.
4. Klicke auf "File" > "Open Folder..." (oder "Datei" > "Ordner öffnen...") und wähle den Unterordner Code aus dem gerade entpackten WifiWhirl-Software-Verzeichnis aus.

3. Firmware kompilieren und auf den NodeMCU hochladen

Sobald das Projekt in VS Code geöffnet ist und PlatformIO initialisiert wurde (dies kann beim ersten Mal einen Moment dauern und erfordert eine Internetverbindung, da PlatformIO benötigte Toolchains und Bibliotheken herunterlädt), kannst du die Firmware kompilieren und hochladen.

1. NodeMCU anschließen: Verbinde deinen NodeMCU v3 per Micro-USB-Kabel mit deinem Computer.
2. PlatformIO-Menü öffnen: In der unteren Statusleiste von VS Code sollte sich ein kleines Haus-Symbol (PlatformIO Home) oder andere PlatformIO-spezifische Icons befinden. Klicke auf das PlatformIO-Icon (oft ein Alien-Kopf oder das PlatformIO-Logo) in der linken Aktivitätsleiste oder suche nach dem Befehl "PlatformIO: Home" in der Befehlspalette (Ctrl+Shift+P oder Cmd+Shift+P). Alternativ findest du die PlatformIO-Befehle oft auch in einer eigenen Seitenleiste, die sich öffnet, wenn du das PlatformIO-Icon anklickst.
3. Kompilieren (Build):
   • Suche im PlatformIO-Menü oder in der Projekt-Task-Liste nach der Option Build (oft unter "General" oder dem Projektnamen).
   • Klicke darauf. PlatformIO wird nun den Quellcode kompilieren. Im Terminal-Fenster von VS Code siehst du den Fortschritt.
   • Wenn der Vorgang erfolgreich war, steht am Ende meist eine Meldung wie SUCCESS oder [SUCCESS] ....
4. Hochladen (Upload):
   • Nach dem erfolgreichen Kompilieren, suche die Option Upload.
   • Klicke darauf. PlatformIO versucht nun, die kompilierte Firmware auf den angeschlossenen NodeMCU hochzuladen.
   • Während des Uploads blinkt möglicherweise eine LED auf dem NodeMCU.
   • Warte, bis der Vorgang abgeschlossen ist (Meldung SUCCESS oder ähnlich).
5. Dateisystem-Image erstellen (Build Filesystem Image):
   • Suche im PlatformIO-Menü die Option Build Filesystem Image (oft unter "Platform" oder spezifischen Tasks für das Board).
   • Klicke darauf, um das Image für das SPIFFS (SPI Flash File System) zu erstellen, das die Web-Oberfläche und Konfigurationsdateien enthält.
6. Dateisystem-Image hochladen (Upload Filesystem Image):
   • Suche die Option Upload Filesystem Image.
   • Klicke darauf, um das erstellte Dateisystem auf den NodeMCU zu laden.

Fehlerbehebung (Troubleshooting)

• NodeMCU nicht erkannt/Port nicht gefunden:
  • Überprüfe die USB-Kabelverbindung.
  • Stelle sicher, dass die richtigen USB-Treiber (CH340/CP210x) installiert sind.
  • Versuche einen anderen USB-Port oder ein anderes USB-Kabel.
  • In PlatformIO kannst du manchmal den Upload-Port manuell in der platformio.ini-Datei des Projekts festlegen (z.B. upload_port = COM3 oder upload_port = /dev/ttyUSB0).
• Upload schlägt fehl:
  • Manche NodeMCU-Boards benötigen zum Flashen das Drücken einer "Flash"- oder "Boot"-Taste, während sie mit dem PC verbunden werden oder kurz bevor der Upload-Vorgang startet. Halte die Taste gedrückt, starte den Upload und lasse los, wenn der Upload-Prozess beginnt.
  • Überprüfe die Einstellungen in der platformio.ini (Board-Typ, etc.), obwohl diese für das WifiWhirl-Projekt vorkonfiguriert sein sollten.
• Kompilierungsfehler:
  • Stelle sicher, dass PlatformIO alle Abhängigkeiten und Toolchains korrekt heruntergeladen hat (erfordert Internetverbindung beim ersten Öffnen des Projekts).
  • Lösche ggf. den .pio-Ordner im Projektverzeichnis und lasse PlatformIO das Projekt neu initialisieren (PlatformIO: Re-Init oder VS Code neu starten).

Weitere Informationen

• Eine detaillierte (wenn auch auf die Original-Firmware bezogene) und bebilderte Anleitung zum Flashen findest du auch im originalen Handbuch von visualapproach: bwc-manual.pdf (Englisch).
• Den aktuellsten Quellcode der WifiWhirl Software und weitere technische Details findest du direkt auf GitHub.
• Informationen zu den Unterschieden zwischen der WifiWhirl-Software und der Originalsoftware gibt es in den FAQ.

Nachdem die Software erfolgreich auf dem NodeMCU installiert ist, geht es im nächsten Schritt um das Gehäuse für dein Modul.