Autor:  igel1, 27.02.2026

ARDUINO-IDE:
------------

Beschreibung, wie man einen DHT22-Sensor mit dem Arduino-Beispielcode aus der
Adafruit IO Bibliothek auslesen kann und die Daten in die AdafruitIO-Cloud
hochladen kann:

- Arduino IDE v2.3.8 installieren
- Per Menü Tools > Board Manager die "esp32 by Expressif Systems" Boards installieren
- Per Menü Tools > Board > esp32 > XIAO_ESP32S3 auswählen
- Per Menü Tools > Manage Libraries die "Adafruit IO Arduino" Lib in Version 4.3.4 installieren
- Per Menü File > Examples > Adafruit IO Arduino > adafruitio_15_temp_humidity.ino
    ... in das Verzeichnis der eigenen Arduino-Projekte kopieren
- Im Beispielcode DATA_PIN von 2 auf 5 angepassen (... wenn der DHT22-Sensor an PIN 5 hängt)
- Im config.h file IO_USERNAME, IO_KEY, WIFI_SSID, WIWI_PASS entsprechend anpassen
- Compilieren (per "Verify") und auf das ESP32S3 Board hochladen (per "Upload") -> funktioniert.
    ... es werden sowohl Daten auf Serial ausgegeben, als auch in die Cloud geschrieben


ARDUINO-CLI:
------------

Beschreibung, wie man die Arduino-CLI separat auf einem Mac installiert

- Per "brew install arduino-cli" die arduino-cli v1.4.1 installieren
- brew list arduino-cli ergibt:
    /opt/homebrew/Cellar/arduino-cli/1.4.1/bin/arduino-cli
    /opt/homebrew/Cellar/arduino-cli/1.4.1/etc/bash_completion.d/arduino-cli
    /opt/homebrew/Cellar/arduino-cli/1.4.1/sbom.spdx.json
    /opt/homebrew/Cellar/arduino-cli/1.4.1/share/fish/vendor_completions.d/arduino-cli.fish
    /opt/homebrew/Cellar/arduino-cli/1.4.1/share/pwsh/completions/_arduino-cli.ps1
    /opt/homebrew/Cellar/arduino-cli/1.4.1/share/zsh/site-functions/_arduino-cli



VS CODE mit Arduino Community Edition Plugin:
----------------------------------------------

Beschreibung, wie man einen DHT22-Sensor mit dem Arduino-Beispielcode aus der
Adafruit IO Bibliothek auslesen kann und die Daten in die AdafruitIO-Cloud
hochladen kann:

- VS Code v1.109.5 installieren
- Plugin "Arduino Community Edition" v0.7.2 installieren (und VS Code neu starten)
- Plugin konfigurierten:
      Voraussetzung: arcuino-cli wurde vorab separat auf dem Rechner installiert
      Menü Code > Settings > Settings > Extensions > Arduino configuration
        Arduino: Command Path = bin/arduino-cli
        Arduino: Path = /opt/homebrew/Cellar/arduino-cli/1.4.1/
      Danach VS Code neu starten (unklar, ob das wirklich nötig ist)
- Per Shift-Cmd-P den "Arduino:Board Manager" in VS Code aufrufen
    ... und "esp32 by Expressif Systems" in der Version 3.3.7 installieren
- Via Arduino Board Configuration (ganz unten in der Buttom-Menüleiste von VS Code im Tab "<Select Board Type>"
    ....das Board "XIAO_ESP32S3 (esp32)" auswählen
    ... und dort alle default-Einstellungen unverändert lassen
- Per Shift-Cmd-P den "Arduino: Library Manager" in VS Code aufrufen
    ... und dort die Lib "Adafruit IO Arduino" in der Version 4.3.4 installieren
- Notiz: nach der Installation tauchen im Arduino Library Manager unter der Adafruit IO Arduino Library
    ... zwei neue Buttons auf:  "Include Library" und "Remove". Mit include kann man alle Header-Files
    in den eigenen Code einfügen - hier nicht benötigt, da der Beispielcode bereits die richtigen
    include-Statements enthält
- Das o.g. Arduino-Projekt aus dem Arduino IDE Projektordner
    ... in den Ordner meiner VS Code Projekte kopiert
    Alternativ:
        Shift-Cmd-P die "Arduino:Examples" in VS Code aufrufen
        "Examples from Custom Libraries" > Adafruit_IO_Arduino > adafruitio_15_temp_humidity
        ... das kopiert den Beispielcode in ~/Documents/Arduino/generated_examples/adafruitio_15_temp_humidity
- Ggf. den Projektordner im Explorer von VS Code öffnen
- Ggf. *.ino File im Editor von VS Code öffnen
- Codeanpassungen (analog zur Arduino-IDE Beschreibung oben)
    - Im Beispielcode *.ino den DATA_PIN von 2 auf 5 angepassen (... wenn der DHT22-Sensor an PIN 5 hängt)
    - Im config.h file IO_USERNAME, IO_KEY, WIFI_SSID, WIWI_PASS entsprechend anpassen
        (IO_USERNAME und IO_KEY im Account auf io.adafruit.com nachschlagen)
        (WIFI_SSID und WIWI_PASS sind die WLAN-Zugangsdaten des eigenen WLAN Netzes)
- Das Sketch/Programm "adafruitio_15_temp_humidity.ino" öffnen
    ... und per "Verify"-Button kompilieren (per "Arduino Verify" oben rechts in der Editor-Leiste)
- Den richtigen USB-Port in der Bottom-Liste von VS Code im Tab "<Port>" auswählen
    (z.B. /dev/tty.usbmodem1101)
- Das Programm per "Upload"-Button auf das XIAO_ESP32S3 Board flashen
- Den Serial Monitor öffnen (/dev/tty.usbmodem1101 - Espressif,  115200baud)
- Prüfen, ob Temperatur & Humidity per Serial-Line ausgegeben werden -> funktioniert
- Bei io.adafruit.com eingeloggen und die Feeds temperature & humidity prüfen,
    ob dort die Werte ankommen -> funktioniert
- Hinweis: die Warnung  "[Warning] Output path is not specified. Unable to reuse previously compiled files.
           Build will be slower. See README."
           ... kann durch Hinzufügen von "output": "../build" behoben werden
    Die Config-Datei  <Projectfolder>/.vscode/arduino.json hat bei mir folgenden Inhalt:
    {
      "sketch": "adafruitio_15_temp_humidity.ino",
      "port": "/dev/tty.usbmodem1101",
      "board": "esp32:esp32:XIAO_ESP32S3",
      "configuration": "JTAGAdapter=default,PSRAM=disabled,FlashMode=qio,FlashSize=8M,LoopCore=1,EventsCore=1,USBMode=hwcdc,CDCOnBoot=default,MSCOnBoot=default,DFUOnBoot=default,UploadMode=default,PartitionScheme=default_8MB,CPUFreq=240,UploadSpeed=921600,DebugLevel=none,EraseFlash=none",
      "output": "../build"
    }



References:

  - https://marketplace.visualstudio.com/items?itemName=vscode-arduino.vscode-arduino-community