Zum Hauptinhalt springen

MeshCore Home Assistant Integration

Diese Seite beschreibt die Integration von MeshCore in Home Assistant auf Basis der offiziellen Projektseite

Die Integration ist eine Custom Integration für Home Assistant und erlaubt Monitoring sowie Steuerung von MeshCore-Nodes über USB, BLE oder TCP.

Status laut Projekt

Die Integration ist laut README noch Work in Progress. Die BLE-Verbindung wurde dort als noch nicht umfassend getestet beschrieben.

Voraussetzungen​

Laut README werden benötigt:

  • Home Assistant ab Version 2023.8.0
  • Ein MeshCore-Node mit Firmware, die API-Kommandos unterstützt
  • Für BLE: Bluetooth-Adapter auf dem Home-Assistant-Host
  • Für USB: USB-Port auf dem Home-Assistant-Host

Hinweis aus der README zu BLE: direkte Verbindung wird vorausgesetzt; Proxy-Verbindungen funktionieren bei PIN-Pairing nicht.

Installation​

HACS (empfohlen)​

  1. Sicherstellen, dass HACS installiert ist.
  2. In HACS unter Integrations das Repository als Custom Repository hinzufügen (Integration als Kategorie).
  3. MeshCore-Integration installieren.
  4. Home Assistant neu starten.

Manuelle Installation​

  1. Den Ordner custom_components/meshcore aus dem Repository in das eigene custom_components-Verzeichnis kopieren.
  2. Home Assistant neu starten.

Quick Start​

Nach der Installation:

  1. In Home Assistant zu Settings -> Devices & Services wechseln.
  2. + Add Integration auswählen.
  3. Nach MeshCore suchen und den Setup-Wizard durchlaufen.

MQTT Upload (Addon/Container-Umgebung)​

Laut README kann die Konfiguration in der Home-Assistant-Weboberfläche erfolgen:

  • Settings -> Devices & Services -> MeshCore -> Configure
  • MQTT Global Settings
  • MQTT Broker Settings (Broker 1-4)

Wichtige Punkte aus der README:

  • meshcore-decoder ist optional.
  • Wenn meshcore-decoder nicht verfügbar ist, fällt die Integration automatisch auf Python-Signing mit PyNaCl zurück.
  • Der Signing Key wird vom verbundenen Node via export_private_key() geholt.
  • Wenn der Export des Private Keys in der Firmware deaktiviert/blockiert ist, kann der Auth-Token-Upload nicht starten.

Dokumentation und Support​

Die README verweist auf die vollständige Projektdokumentation mit Feature-Liste, Konfigurationshilfen, Sensor-/Service-Beschreibungen, Automationsbeispielen, Dashboard-Templates und Troubleshooting

Issues und Weiterentwicklung