MeshCore voor Home Assistant (Marketplace-integratie)

Installaties: 573 die analysegegevens delen
GitHub-sterren: 281
Verbinding: Werkt lokaal
Onderhoud: Bijgewerkt in de afgelopen 6 maanden
Versie: v3.0.3, 22 oktober 2026
Categorie: Hubs en protocollen, Draadloze protocollen
Soort: Marketplace-integratie
Vereist: Toegevoegd als aangepaste repository in de Marketplace
Domein: meshcore
Bron: github.com/meshcore-dev/meshcore-ha
Problemen: Probleem melden

Onafhankelijk overzicht, gemaakt door de ontwikkelaar van Vulpo. Niet gelieerd aan Home Assistant of de Open Home Foundation.

Over dit item

MeshCore is een aangepaste integratie die Home Assistant verbindt met een MeshCore-radiocompanion om meshnetwerken te bewaken en te bedienen. De companion maakt verbinding via USB, Bluetooth of TCP en de integratie werkt lokaal via de bibliotheek meshcore-py. Het voegt sensoren, binaire sensoren, knoppen, selecties, teksthelpers en aanwezigheidsdetectie toe voor de nodes in de mesh. Acties omvatten het verzenden van directe berichten en kanaalberichten, het uitvoeren van companion-opdrachten en het toevoegen of verwijderen van contacten. Repeaters en gevolgde clients kunnen worden bevraagd voor telemetrie, en optionele zelfdiagnostiek voegt radiostatistieken en foutvlaggen toe. Verdere opties zijn modi voor het ontdekken van contacten, uploads van ontvangen adverts naar de MeshCore-communitykaart en MQTT-brokers; de installatie gebeurt in de UI nadat je de aangepaste repository hebt toegevoegd.

Automatische samenvatting van de README en de code van meshcore-dev/meshcore-ha, automatisch vertaald. Klopt er iets niet, of ben je de maintainer en wil je hier je eigen tekst tonen? Neem contact op

Ondersteunt

Werkt lokaal Praat met je apparaten op je eigen netwerk. Geen cloud van de aanbieder ertussen.
Uit de Marketplace Wordt geïnstalleerd via de Marketplace, voorheen HACS.
Actief onderhouden De auteur heeft in de afgelopen zes maanden een release of wijziging gepubliceerd.

Levert

Sensoren
Aanwezigheid

Instellen

Voeg de repository als aangepaste repository toe aan de Marketplace en installeer de integratie. Herstart daarna Home Assistant en voeg de integratie toe onder Instellingen > Apparaten en diensten.

MeshCore Installatie

Verbindingstype

Ook gevraagd bij het wijzigen van de verbinding.

Configureer USB-verbinding

USB-apparaat pad
Verbindingssnelheid
Zelftelemetrie inschakelen
Interval zelftelemetrie (seconden)
Zelfdiagnostiek inschakelenMaakt 14 diagnostische sensoren aan voor de companion: uptime, lengte van de TX-wachtrij, ruisvloer, laatste RSSI en SNR, TX- en RX-airtime en pakkettellers. Standaard uitgeschakeld. Dit zijn lokale query's naar de companion en er wordt niets op de mesh verzonden. Het interval bepaalt hoe vaak de sensoren worden bijgewerkt (60 tot 3600 seconden).
Interval zelfdiagnostiek (seconden)
Modus voor contactontdekkingEntiteit per contact: elk ontdekt contact krijgt een eigen entiteit (het beste voor kleine meshes). Alleen gegevens: ontdekte contacten worden alleen als gegevens bijgehouden, zonder entiteit per contact. Bekijk ze via de vervolgkeuzelijst of de service Get Discovered Contact. Uitgeschakeld: contactontdekking is volledig uitgezet en bestaande ontdekte contacten worden gewist.

Configureer Bluetooth-verbinding

Bluetooth-apparaat
Zelftelemetrie inschakelen
Interval zelftelemetrie (seconden)
Zelfdiagnostiek inschakelenMaakt 14 diagnostische sensoren aan voor de companion: uptime, lengte van de TX-wachtrij, ruisvloer, laatste RSSI en SNR, TX- en RX-airtime en pakkettellers. Standaard uitgeschakeld. Dit zijn lokale query's naar de companion en er wordt niets op de mesh verzonden. Het interval bepaalt hoe vaak de sensoren worden bijgewerkt (60 tot 3600 seconden).
Interval zelfdiagnostiek (seconden)
Modus voor contactontdekkingEntiteit per contact: elk ontdekt contact krijgt een eigen entiteit (het beste voor kleine meshes). Alleen gegevens: ontdekte contacten worden alleen als gegevens bijgehouden, zonder entiteit per contact. Bekijk ze via de vervolgkeuzelijst of de service Get Discovered Contact. Uitgeschakeld: contactontdekking is volledig uitgezet en bestaande ontdekte contacten worden gewist.

Configureer Netwerkverbinding

Hostadres
Poort
Zelftelemetrie inschakelen
Interval zelftelemetrie (seconden)
Zelfdiagnostiek inschakelenMaakt 14 diagnostische sensoren aan voor de companion: uptime, lengte van de TX-wachtrij, ruisvloer, laatste RSSI en SNR, TX- en RX-airtime en pakkettellers. Standaard uitgeschakeld. Dit zijn lokale query's naar de companion en er wordt niets op de mesh verzonden. Het interval bepaalt hoe vaak de sensoren worden bijgewerkt (60 tot 3600 seconden).
Interval zelfdiagnostiek (seconden)
Modus voor contactontdekkingEntiteit per contact: elk ontdekt contact krijgt een eigen entiteit (het beste voor kleine meshes). Alleen gegevens: ontdekte contacten worden alleen als gegevens bijgehouden, zonder entiteit per contact. Bekijk ze via de vervolgkeuzelijst of de service Get Discovered Contact. Uitgeschakeld: contactontdekking is volledig uitgezet en bestaande ontdekte contacten worden gewist.

USB-verbinding opnieuw configureren

Pad van USB-apparaat
Verbindingssnelheid

Bluetooth-verbinding opnieuw configureren

Bluetooth-apparaat

Netwerkverbinding opnieuw configureren

Hostadres
Poort

Na het instellen

Kies een actie
Beschikbare Repeaters
Repeater Wachtwoord
Schakel Telemetrie-polling in
Buurentiteiten inschakelen (maakt SNR- en activiteitssensoren aan voor elke buur die de repeater ziet)Vraagt na elke geslaagde statuspoll de buurlijst van deze repeater op. Elke buur krijgt een SNR-sensor en een gezien-sensor. De lijst wordt in pagina's opgehaald: elke pagina is één verzoek, dus de belasting groeit met het aantal buren. Vereist MeshCore-firmware 1.14.0 of nieuwer.
Vernieuwingsfrequentie telemetrie (seconden)
Schakel Pad-reset uit
PasswordWordt eenmalig verzonden om in te loggen op de repeater. Laat leeg voor een repeater die via ACL toegang geeft zonder wachtwoord.
Beschikbare Clients
Updatefrequentie (seconden)
Schakel Pad-reset uit
Selecteer Apparaat
Actie
Wachtwoord bijwerken (leeg laten om huidige te behouden)
Schakel Telemetrie-polling in
Buurentiteiten inschakelen (maakt SNR- en activiteitssensoren aan voor elke buur die de repeater ziet)Vraagt na elke geslaagde statuspoll de buurlijst van deze repeater op. Elke buur krijgt een SNR-sensor en een gezien-sensor. De lijst wordt in pagina's opgehaald: elke pagina is één verzoek, dus de belasting groeit met het aantal buren. Vereist MeshCore-firmware 1.14.0 of nieuwer.
Vernieuwingsfrequentie telemetrie (seconden)
Schakel Pad-reset uit
Schakel Apparaat uit
Wachtwoord bijwerken (laat leeg om het huidige te behouden)Opgeslagen wachtwoorden worden nooit getoond. Laat dit leeg om het opgeslagen wachtwoord te behouden; typ een nieuw wachtwoord om het te vervangen.
Updatefrequentie (seconden)
Schakel Pad-reset uit
Schakel Apparaat uit
Modus voor contactontdekkingEntiteit per contact: elk ontdekt contact krijgt een eigen entiteit (het beste voor kleine meshes). Alleen gegevens: ontdekte contacten worden alleen als gegevens bijgehouden, zonder entiteit per contact. Bekijk ze via de vervolgkeuzelijst of de service Get Discovered Contact. Uitgeschakeld: contactontdekking is volledig uitgezet en bestaande ontdekte contacten worden gewist.
Beperk Ontdekte Contacten
Maximum aantal Ontdekte Contacten
Schakel Zelf-telemetrie in
Zelf-telemetrie-interval (seconden)
Zelfdiagnostiek inschakelenMaakt 14 diagnostische sensoren aan voor de companion: uptime, lengte van de TX-wachtrij, ruisvloer, laatste RSSI en SNR, TX- en RX-airtime en pakkettellers. Standaard uitgeschakeld. Dit zijn lokale query's naar de companion en er wordt niets op de mesh verzonden. Het interval bepaalt hoe vaak de sensoren worden bijgewerkt (60 tot 3600 seconden).
Interval zelfdiagnostiek (seconden)
CLI-console inschakelenVoegt een CLI Console-sensor toe. Deze legt elke opdracht vast die je uitvoert met execute_command of execute_command_ui wanneer record_to_console aan staat, samen met het antwoord. Hij toont alleen paren van opdracht en antwoord, niet het apparaatlogboek. Standaard uitgeschakeld. Gebruik hem met de helper text.meshcore_command en een Markdown-kaart. In de documentatie staat een voorbeelddashboard.
Schakel Map Auto Uploader in (map.meshcore.io)Als dit is ingeschakeld, worden advertenties van repeaters en room servers die u ontvangt geüpload naar map.meshcore.io. Die knooppunten verschijnen op de officiële MeshCore-kaart voor de community. Vereist dat export van de privésleutel op de firmware is ingeschakeld (ENABLE_PRIVATE_KEY_EXPORT=1); anders kunnen uploads niet worden ondertekend.
Verouderde ontdekte contacten automatisch opruimen (dagelijks)Als dit is ingeschakeld, worden ontdekte contacten waarvan de laatste update ouder is dan de ingestelde drempel één keer per dag automatisch verwijderd. Contacten die op de node zijn opgeslagen blijven altijd behouden.
Drempel voor verouderde contacten (dagen)
Verouderde buren automatisch verwijderenVerwijdert automatisch burenvermeldingen en hun sensorentiteiten als er het ingestelde aantal dagen niets van is vernomen.
Drempel voor verouderde buren (dagen)Aantal dagen zonder bericht van een buur voordat deze automatisch wordt verwijderd (1 tot 365).
Inkomende berichten uit de wachtrij ophalenStandaard ingeschakeld. Schakel dit uit als een andere client, zoals een telefoon via BLE, kanaalberichten en privéberichten uit de wachtrij moet ophalen. Home Assistant blijft de status en telemetrie van repeaters opvragen en kan opdrachten versturen. Berichten die het apparaat doorstuurt, kunnen nog steeds in Home Assistant verschijnen. Deze instelling bepaalt het ophalen uit de wachtrij, niet de weergave. Tekstantwoorden op opdrachten kunnen ook voor de andere client in de wachtrij blijven staan.
Adaptieve bezorging van kanaalberichtenAls dit is ingeschakeld, worden binnenkomende kanaalberichten doorgegeven zodra RX_LOG-gegevens binnenkomen (meestal ~50ms), in plaats van altijd de volle 500ms te wachten. Gegevens van repeaters die later binnenkomen worden stapsgewijs bezorgd. Schakel dit uit als bots of automatiseringen ervan afhankelijk zijn dat alle paden al in de eerste gebeurtenis zitten.
Broker
Actie

Teksten uit de code van meshcore-dev/meshcore-ha. Teksten waarvoor de repository geen Nederlandse vertaling heeft, zijn automatisch vertaald.

Entiteiten

Binaire sensorenRadiostoring: pakketpool uitgeput, Radiostoring: CAD-timeout, Radiostoring: RX-Start-timeout
SensorenNode Status, Node Aantal, Laatste RSSI, Laatste SNR, Batterij, Uptime, Airtime, Verzonden Berichten, Ontvangen Berichten, Routeringspad, Padlengte, Verzoek Successen en nog 33

Acties

Bericht VersturenVerstuur een bericht naar een MeshCore-nodeVelden: Node ID, Bericht
Kanaalbericht VersturenVerstuur een tekstbericht naar een openbaar MeshCore-kanaal.Velden: Kanaalindex, Bericht, ID van configuratie-item
UI-bericht VersturenVerstuur een bericht met gebruik van de MeshCore UI-helpers. Deze service leest waarden uit 'select.meshcore_recipient_type', 'select.meshcore_channel', 'select.meshcore_contact' en 'text.meshcore_message' om de ontvanger en berichtinhoud te bepalen. Roep deze service direct aan vanuit een knopkaart voor een naadloze interface.Velden: ID van configuratie-item
MeshCore Opdracht UitvoerenVoer een opdracht uit geleverd door de MeshCore Python-bibliotheek. Dit is een geavanceerde functie die directe toegang geeft tot de onderliggende opdrachteninterface. LET OP: Sommige opdrachten maken PERMANENTE WIJZIGINGEN aan de configuratie van uw node. Gebruik met zorg.Velden: Opdracht, ID van configuratie-item, Vastleggen in CLI-console
Opdracht vanuit UI UitvoerenVoer een opdracht uit met behulp van de text.meshcore_command helper-entiteit. Deze service leest de opdracht uit de tekst-helper en voert deze uit. Het invoerveld wordt na uitvoering automatisch gewist.Velden: ID van configuratie-item, Vastleggen in CLI-console
CLI-console wissenWist het transcript van de CLI-console. Zonder entry_id wordt de console van elk geconfigureerd apparaat gewist.Velden: ID van configuratie-item
Geselecteerd Contact ToevoegenVoeg het geselecteerde contact uit de lijst met ontdekte contacten toe aan de contactenlijst van uw node.Velden: ID van configuratie-item
Geselecteerd Contact VerwijderenVerwijder het geselecteerde contact uit de lijst met toegevoegde contacten van de contactenlijst van uw node.Velden: ID van configuratie-item
Ontdekt Contact VerwijderenVerwijder een ontdekt contact uit de lijst met ontdekte contacten. Dit verwijdert het contact uit Home Assistant, maar verwijdert het NIET uit de contactenlijst van uw node. U kunt de pubkey_prefix direct opgeven, of leeg laten om het geselecteerde contact uit de selectie-entiteit te gebruiken.Velden: Prefix van publieke sleutel, ID van configuratie-item
Onbeschikbare Contacten OpschonenVerwijder alle onbeschikbare MeshCore-contact-binaire sensoren uit Home Assistant.Velden: ID van configuratie-item
Alle Ontdekte Contacten WissenVerwijder alle ontdekte contacten en hun bijbehorende binaire sensor-entiteiten uit Home Assistant. Dit verwijdert GEEN contacten uit de contactenlijst van uw node.Velden: Drempel in dagen, ID van configuratie-item
Ontdekt contact ophalenGeeft de volledige gegevensdictionary terug van één ontdekt (niet toegevoegd) contact, gevonden op basis van het prefix van de publieke sleutel. In de modus met alleen gegevens hebben ontdekte contacten geen eigen entiteit, dus dit is de ondersteunde manier om er één te bekijken.Velden: Prefix van publieke sleutel, ID van configuratie-item

Probleemoplossing

DiagnostiekDownloadt een diagnostiekbestand om aan een bugmelding toe te voegen.
ReparatiemeldingenMeldingen die het kan tonen onder Instellingen > Reparaties:Publieke sleutel van MeshCore gewijzigd

Uit de 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.

Uit de README van meshcore-dev/meshcore-ha, MIT License. Ingekort.