Überblick
MeshCore ist eine benutzerdefinierte Integration, die Home Assistant mit einem MeshCore-Funk-Companion verbindet, um Mesh-Netzwerke zu überwachen und zu steuern. Der Companion verbindet sich über USB, Bluetooth oder TCP, und die Integration arbeitet lokal über die Bibliothek meshcore-py. Sie fügt Sensoren, Binärsensoren, Tasten, Auswahlfelder, Text-Helfer und Anwesenheitserkennung für die Knoten im Mesh hinzu. Die Aktionen umfassen das Senden von Direkt- und Kanalnachrichten, das Ausführen von Companion-Befehlen sowie das Hinzufügen und Entfernen von Kontakten. Repeater und verfolgte Clients können für Telemetrie abgefragt werden, und optionale Selbstdiagnosen ergänzen Funkstatistiken und Fehlerflags. Weitere Optionen sind Modi zur Kontaktsuche, das Hochladen empfangener Adverts auf die MeshCore-Community-Karte und MQTT-Broker; die Einrichtung erfolgt in der Oberfläche, nachdem das benutzerdefinierte Repository hinzugefügt wurde.
Zusammenfassung der README und des Codes von meshcore-dev/meshcore-ha, automatisch erstellt und übersetzt. Stimmt etwas nicht, oder betreust du das Projekt und möchtest hier deinen eigenen Text? Melde dich
Unterstützt
Funktioniert lokal Spricht mit deinen Geräten in deinem eigenen Netzwerk. Keine Cloud des Herstellers dazwischen.
Aus dem Marketplace Wird über den Marketplace installiert, früher HACS.
Aktiv gepflegt Das Projekt hat in den letzten sechs Monaten eine neue Version oder Änderung veröffentlicht.
Stellt bereit
- Sensoren
- Anwesenheit
Einrichtung
Füge ihr Repository im Marketplace als benutzerdefiniertes Repository hinzu und installiere sie. Starte dann Home Assistant neu und füge sie unter Einstellungen > Geräte & Dienste hinzu.
MeshCore-Einrichtung
- Verbindungsart
Wird auch beim Ändern der Verbindung abgefragt.
USB-Verbindung konfigurieren
- USB-Gerätepfad
- Verbindungsgeschwindigkeit
- Eigene Telemetrie aktivieren
- Intervall der eigenen Telemetrie (Sekunden)
- Selbstdiagnose aktivierenErstellt 14 Diagnosesensoren für den Companion: Laufzeit, Länge der TX-Warteschlange, Grundrauschen, letzter RSSI und SNR, TX- und RX-Sendezeit sowie Paketzähler. Standardmäßig aus. Das sind lokale Abfragen an den Companion und es wird nichts im Mesh gesendet. Das Intervall legt fest, wie oft die Sensoren aktualisiert werden (60 bis 3600 Sekunden).
- Intervall der Selbstdiagnose (Sekunden)
- Modus der KontaktsucheEntität pro Kontakt: Jeder gefundene Kontakt bekommt eine eigene Entität (am besten für kleine Meshes). Nur Daten: Gefundene Kontakte werden nur als Daten verfolgt, ohne Entität pro Kontakt. Du kannst sie über das Dropdown oder den Dienst Get Discovered Contact ansehen. Deaktiviert: Die Kontaktsuche ist komplett ausgeschaltet und alle vorhandenen gefundenen Kontakte werden gelöscht.
Bluetooth-Verbindung konfigurieren
- Bluetooth-Gerät
- Eigene Telemetrie aktivieren
- Intervall der eigenen Telemetrie (Sekunden)
- Selbstdiagnose aktivierenErstellt 14 Diagnosesensoren für den Companion: Laufzeit, Länge der TX-Warteschlange, Grundrauschen, letzter RSSI und SNR, TX- und RX-Sendezeit sowie Paketzähler. Standardmäßig aus. Das sind lokale Abfragen an den Companion und es wird nichts im Mesh gesendet. Das Intervall legt fest, wie oft die Sensoren aktualisiert werden (60 bis 3600 Sekunden).
- Intervall der Selbstdiagnose (Sekunden)
- Modus der KontaktsucheEntität pro Kontakt: Jeder gefundene Kontakt bekommt eine eigene Entität (am besten für kleine Meshes). Nur Daten: Gefundene Kontakte werden nur als Daten verfolgt, ohne Entität pro Kontakt. Du kannst sie über das Dropdown oder den Dienst Get Discovered Contact ansehen. Deaktiviert: Die Kontaktsuche ist komplett ausgeschaltet und alle vorhandenen gefundenen Kontakte werden gelöscht.
Netzwerkverbindung konfigurieren
- Host-Adresse
- Port
- Eigene Telemetrie aktivieren
- Intervall der eigenen Telemetrie (Sekunden)
- Selbstdiagnose aktivierenErstellt 14 Diagnosesensoren für den Companion: Laufzeit, Länge der TX-Warteschlange, Grundrauschen, letzter RSSI und SNR, TX- und RX-Sendezeit sowie Paketzähler. Standardmäßig aus. Das sind lokale Abfragen an den Companion und es wird nichts im Mesh gesendet. Das Intervall legt fest, wie oft die Sensoren aktualisiert werden (60 bis 3600 Sekunden).
- Intervall der Selbstdiagnose (Sekunden)
- Modus der KontaktsucheEntität pro Kontakt: Jeder gefundene Kontakt bekommt eine eigene Entität (am besten für kleine Meshes). Nur Daten: Gefundene Kontakte werden nur als Daten verfolgt, ohne Entität pro Kontakt. Du kannst sie über das Dropdown oder den Dienst Get Discovered Contact ansehen. Deaktiviert: Die Kontaktsuche ist komplett ausgeschaltet und alle vorhandenen gefundenen Kontakte werden gelöscht.
USB-Verbindung neu konfigurieren
- USB-Gerätepfad
- Verbindungsgeschwindigkeit
Bluetooth-Verbindung neu konfigurieren
- Bluetooth-Gerät
Netzwerkverbindung neu konfigurieren
- Host-Adresse
- Port
Nach der Einrichtung
- Aktion wählen
- Verfügbare Repeater
- Repeater-Passwort
- Telemetrie-Abfrage aktivieren
- Nachbar-Entitäten aktivieren (erstellt SNR- und Aktivitätssensoren für jeden Nachbarn, den der Repeater sieht)Fragt diesen Repeater nach jeder erfolgreichen Statusabfrage nach seiner Nachbarliste. Jeder Nachbar bekommt einen SNR-Sensor und einen Sensor für das letzte Sehen. Die Liste wird seitenweise abgerufen: Jede Seite ist eine Anfrage, daher steigt der Aufwand mit der Zahl der Nachbarn. Erfordert MeshCore-Firmware 1.14.0 oder neuer.
- Aktualisierungsrate der Telemetrie (Sekunden)
- Pfad-Reset deaktivieren
- PasswortWird einmal gesendet, um sich beim Repeater anzumelden. Leer lassen bei einem Repeater, der den Zugriff per ACL ohne Passwort erlaubt.
- Verfügbare Clients
- Aktualisierungshäufigkeit (Sekunden)
- Pfad-Reset deaktivieren
- Gerät auswählen
- Aktion
- Passwort aktualisieren (leer lassen, um das aktuelle zu behalten)
- Telemetrie-Abfrage aktivieren
- Nachbar-Entitäten aktivieren (erstellt SNR- und Aktivitätssensoren für jeden Nachbarn, den der Repeater sieht)Fragt bei diesem Repeater nach jeder erfolgreichen Statusabfrage die Nachbarliste ab. Jeder Nachbar erhält einen SNR-Sensor und einen Seen-Sensor. Die Liste wird seitenweise abgerufen: Jede Seite ist eine eigene Anfrage, daher steigt der Aufwand mit der Anzahl der Nachbarn. Erfordert MeshCore-Firmware 1.14.0 oder neuer.
- Aktualisierungsrate der Telemetrie (Sekunden)
- Pfad-Reset deaktivieren
- Gerät deaktivieren
- Passwort aktualisieren (leer lassen, um das aktuelle zu behalten)Gespeicherte Passwörter werden nie angezeigt. Lass das Feld leer, um das gespeicherte Passwort zu behalten, oder gib ein neues ein, um es zu ersetzen.
- Aktualisierungshäufigkeit (Sekunden)
- Pfad-Reset deaktivieren
- Gerät deaktivieren
- Modus für die KontakterkennungEntität pro Kontakt: Jeder erkannte Kontakt erhält eine eigene Entität (am besten für kleine Meshes). Nur Daten: Erkannte Kontakte werden nur als Daten erfasst, ohne Entität pro Kontakt. Du kannst sie über das Dropdown oder den Dienst Get Discovered Contact einsehen. Deaktiviert: Die Kontakterkennung ist komplett ausgeschaltet und alle vorhandenen erkannten Kontakte werden gelöscht.
- Erkannte Kontakte begrenzen
- Maximale Anzahl erkannter Kontakte
- Eigene Telemetrie aktivieren
- Intervall der eigenen Telemetrie (Sekunden)
- Eigene Diagnose aktivierenErstellt 14 Diagnosesensoren für den Companion: Betriebszeit, Länge der TX-Warteschlange, Grundrauschen, letzter RSSI und SNR, TX- und RX-Sendezeit sowie Paketzähler. Standardmäßig aus. Das sind lokale Abfragen an den Companion und sie senden nichts über das Mesh. Das Intervall legt fest, wie oft die Sensoren aktualisiert werden (60 bis 3600 Sekunden).
- Intervall der eigenen Diagnose (Sekunden)
- CLI-Konsole aktivierenFügt einen Sensor für die CLI-Konsole hinzu. Er zeichnet jeden Befehl auf, den du mit execute_command oder execute_command_ui ausführst, wenn record_to_console aktiv ist, sowie die Antwort. Er zeigt nur Paare aus Befehl und Antwort, nicht das Geräteprotokoll. Standardmäßig aus. Verwende ihn mit dem Helfer text.meshcore_command und einer Markdown-Karte. In der Dokumentation gibt es ein Beispiel-Dashboard.
- Automatischen Karten-Upload aktivieren (map.meshcore.io)Lädt die Adverts, die du von Repeatern, Raumservern und Sensorknoten empfängst, zu map.meshcore.io hoch. Diese Knoten erscheinen dann auf der MeshCore-Community-Karte. Die Firmware muss den Export des privaten Schlüssels erlauben (ENABLE_PRIVATE_KEY_EXPORT=1). Ohne ihn kann die Integration die Uploads nicht signieren.
- Veraltete erkannte Kontakte automatisch bereinigen (läuft täglich)Wenn aktiviert, werden erkannte Kontakte, deren letzte Aktualisierung älter als der eingestellte Schwellenwert ist, einmal pro Tag automatisch entfernt. Auf dem Knoten gespeicherte Kontakte bleiben immer erhalten.
- Schwellenwert für veraltete Kontakte (Tage)
- Veraltete Nachbarn automatisch entfernenEntfernt Nachbareinträge und ihre Sensor-Entitäten automatisch, wenn in der eingestellten Anzahl von Tagen nichts von ihnen zu hören war.
- Schwellenwert für veraltete Nachbarn (Tage)Anzahl der Tage ohne Rückmeldung eines Nachbarn, bevor er automatisch entfernt wird (1 bis 365).
- Eingehende Nachrichten aus der Warteschlange abrufenStandardmäßig aktiviert. Deaktivieren, wenn ein anderer Client, etwa ein Smartphone über BLE, Kanal- und Direktnachrichten aus der Warteschlange abrufen soll. Home Assistant fragt weiterhin Repeater-Status und Telemetrie ab und kann Befehle senden. Vom Gerät zugestellte Nachrichten können weiterhin in Home Assistant erscheinen. Diese Einstellung steuert den Abruf der Warteschlange, nicht die Anzeige. Auch Textantworten auf Befehle können für den anderen Client in der Warteschlange verbleiben.
- Adaptive Zustellung von KanalnachrichtenWenn aktiviert, werden eingehende Kanalnachrichten ausgelöst, sobald RX_LOG-Daten eintreffen (typischerweise etwa 50 ms), statt immer die vollen 500 ms zu warten. Spät eintreffende Repeater-Daten werden schrittweise nachgeliefert. Deaktiviere die Option, wenn Bots oder Automationen darauf angewiesen sind, alle Pfade im ersten Ereignis zu haben.
- Broker
- Aktion
Texte aus dem Code von meshcore-dev/meshcore-ha. Texte, für die das Repository keine Übersetzung hat, wurden automatisch übersetzt.
Entitäten
- BinärsensorenFunkfehler: Paketpool erschöpft, Funkfehler: CAD-Timeout, Funkfehler: RX-Start-Timeout
- SensorenKnotenstatus, Knotenanzahl, Letzter RSSI, Letzter SNR, Batterie, Betriebszeit, Sendezeit, Gesendete Nachrichten, Empfangene Nachrichten, Routing-Pfad, Pfadlänge, Erfolgreiche Anfragen und 33 weitere
Aktionen
- Nachricht sendenSendet eine Nachricht an einen MeshCore-KnotenFelder: Knoten-ID, Nachricht
- Kanalnachricht sendenSendet eine Textnachricht an einen öffentlichen MeshCore-Kanal.Felder: Kanalindex, Nachricht, Konfigurationseintrags-ID
- UI-Nachricht sendenSende eine Nachricht mit den MeshCore-UI-Helfern. Dieser Dienst liest Werte aus 'select.meshcore_recipient_type', 'select.meshcore_channel', 'select.meshcore_contact' und 'text.meshcore_message', um Empfänger und Nachrichteninhalt zu bestimmen. Rufe diesen Dienst direkt aus einer Tastenkarte auf, um eine einfache Nachrichtenoberfläche zu erhalten.Felder: Konfigurationseintrags-ID
- MeshCore-Befehl ausführenFühre einen Befehl aus der MeshCore-Python-Bibliothek aus. Das ist eine fortgeschrittene Funktion, die direkten Zugriff auf die zugrunde liegende Befehlsschnittstelle bietet. VORSICHT: Manche Befehle nehmen PERMANENT CHANGES an der Konfiguration deines Nodes vor. Gehe sorgfältig damit um.Felder: Befehl, Config-Entry-ID, In CLI-Konsole aufzeichnen
- Befehl aus der UI ausführenFühre einen Befehl mit der Hilfsentität text.meshcore_command aus. Dieser Dienst liest den Befehl aus dem Texthelfer und führt ihn aus. Das Eingabefeld wird danach automatisch geleert.Felder: Config-Entry-ID, In CLI-Konsole aufzeichnen
- CLI-Konsole leerenLeere das Protokoll der CLI-Konsole. Ohne entry_id wird die Konsole jedes konfigurierten Geräts geleert.Felder: Config-Entry-ID
- Ausgewählten Kontakt hinzufügenFüge den in der Auswahl-Entität für entdeckte Kontakte gewählten Kontakt zur Kontaktliste deines Nodes hinzu.Felder: Config-Entry-ID
- Ausgewählten Kontakt entfernenEntferne den in der Auswahl-Entität für hinzugefügte Kontakte gewählten Kontakt aus der Kontaktliste deines Nodes.Felder: Config-Entry-ID
- Entdeckten Kontakt entfernenEntferne einen entdeckten Kontakt aus der Liste der entdeckten Kontakte. Dadurch wird der Kontakt aus Home Assistant entfernt, aber NICHT aus der Kontaktliste deines Nodes. Du kannst das pubkey_prefix direkt angeben oder es leer lassen, um den gewählten Kontakt aus der Auswahl-Entität für entdeckte Kontakte zu verwenden.Felder: Präfix des öffentlichen Schlüssels, Config-Entry-ID
- Nicht verfügbare Kontakte bereinigenEntferne alle nicht verfügbaren MeshCore-Kontakt-Binärsensoren aus Home Assistant.Felder: Config-Entry-ID
- Entdeckte Kontakte leerenEntferne entdeckte Kontakte und ihre zugehörigen Binärsensor-Entitäten aus Home Assistant. Wenn days_threshold angegeben ist, werden nur Kontakte entfernt, deren letzte Aktualisierung älter als der Schwellenwert ist, und auf dem Node gespeicherte Kontakte bleiben erhalten. Ohne days_threshold werden alle entdeckten Kontakte entfernt. Dadurch werden KEINE Kontakte aus der Kontaktliste deines Nodes entfernt.Felder: Schwellenwert in Tagen, Config-Entry-ID
- Entdeckten Kontakt abrufenGib das vollständige Datenwörterbuch für einen einzelnen entdeckten (noch nicht hinzugefügten) Kontakt zurück, zugeordnet über das Präfix des öffentlichen Schlüssels. Im reinen Datenmodus haben entdeckte Kontakte keine eigene Entität, daher ist dies der unterstützte Weg, einen einzelnen zu prüfen.Felder: Präfix des öffentlichen Schlüssels, Config-Entry-ID
Fehlerbehebung
- DiagnosedatenLädt eine Diagnosedatei herunter, die du an einen Fehlerbericht anhängen kannst.
- ReparaturhinweiseMögliche Hinweise unter Einstellungen > Reparaturen:Öffentlicher MeshCore-Schlüssel geändert
Aus der README
This custom integration connects Home Assistant to a MeshCore companion over USB, BLE or TCP. The companion is the radio that sends and receives on the mesh for Home Assistant. Use it to monitor and control the nodes of your MeshCore mesh.
The integration uses the meshcore-py library.
Erscheint in Vulpo
Tastenkarte, Auswahl-Karte, Diagrammkarte, Apple Watch.Informationen
- Installationen
- 573 teilen Analysedaten
- GitHub-Sterne
- 281
- Verbindung
- Funktioniert lokal
- Pflege
- In den letzten 6 Monaten aktualisiert
- Version
- v3.0.3,
- Kategorie
- Hubs und Protokolle, Funkprotokolle
- Art
- Marketplace-Integration
- Voraussetzung
- Wird im Marketplace als benutzerdefiniertes Repository hinzugefügt
- Domain
meshcore- Probleme
- Problem melden











