MeshCore pour Home Assistant (intégration de la Marketplace)

Installations: 573 partagent leurs statistiques
Étoiles GitHub: 281
Connexion: Fonctionne en local
Maintenance: Mise à jour au cours des 6 derniers mois
Version: v3.0.3, 22 octobre 2026
Catégorie: Hubs et protocoles, Protocoles sans fil
Type: Intégration de la Marketplace
Prérequis: Ajout comme dépôt personnalisé dans la Marketplace
Domaine: meshcore
Source: github.com/meshcore-dev/meshcore-ha
Problèmes: Signaler un problème

Annuaire indépendant, créé par le développeur de Vulpo. Non affilié à Home Assistant ni à l’Open Home Foundation.

À propos

MeshCore est une intégration personnalisée qui connecte Home Assistant à une radio compagnon MeshCore pour surveiller et contrôler des réseaux maillés. Le compagnon se connecte par USB, Bluetooth ou TCP, et l'intégration fonctionne en local grâce à la bibliothèque meshcore-py. Elle ajoute des capteurs, des capteurs binaires, des boutons, des sélecteurs, des assistants de texte et un suivi de présence pour les nœuds du réseau maillé. Les actions permettent d'envoyer des messages directs et de canal, d'exécuter des commandes du compagnon, et d'ajouter ou de supprimer des contacts. Les répéteurs et les clients suivis peuvent être interrogés pour leur télémétrie, et un autodiagnostic facultatif ajoute des statistiques radio et des indicateurs de panne. Parmi les autres options figurent les modes de découverte des contacts, l'envoi des annonces reçues vers la carte communautaire MeshCore et les brokers MQTT ; la configuration se fait dans l'interface après l'ajout du dépôt personnalisé.

Résumé automatique du README et du code de meshcore-dev/meshcore-ha, traduit automatiquement. Une erreur, ou tu maintiens ce projet et tu veux ton propre texte ici ? Prendre contact

Prise en charge

Fonctionne en local Communique avec tes appareils sur ton propre réseau. Aucun cloud de fournisseur entre les deux.
Depuis la Marketplace S’installe depuis la Marketplace, anciennement HACS.
Maintenance active Son auteur a publié une version ou poussé une modification au cours des six derniers mois.

Fournit

Capteurs
Présence

Mise en place

Ajoute son dépôt à la Marketplace comme dépôt personnalisé et installe-la, puis redémarre Home Assistant et ajoute-la dans Paramètres > Appareils et services.

Configuration de MeshCore

Type de connexion

Également demandé lors d’une modification de la connexion.

Configurer la connexion USB

Chemin de l'appareil USB
Vitesse de connexion
Activer l'autotélémétrie
Intervalle d'autotélémétrie (secondes)
Activer l'autodiagnosticCrée 14 capteurs de diagnostic pour le compagnon : durée de fonctionnement, longueur de la file d'émission, plancher de bruit, dernier RSSI et SNR, temps d'antenne en TX et RX, et compteurs de paquets. Désactivé par défaut. Ce sont des requêtes locales vers le compagnon et rien n'est envoyé sur le réseau maillé. L'intervalle définit la fréquence de mise à jour des capteurs (de 60 à 3600 secondes).
Intervalle d'autodiagnostic (secondes)
Mode de découverte des contactsEntité par contact : chaque contact découvert reçoit sa propre entité (idéal pour les petits réseaux maillés). Données seulement : les contacts découverts sont suivis uniquement comme données, sans entité par contact ; consulte-les via la liste déroulante ou le service Get Discovered Contact. Désactivé : la découverte des contacts est entièrement désactivée et les contacts découverts existants sont effacés.

Configurer la connexion Bluetooth

Appareil Bluetooth
Activer l'autotélémétrie
Intervalle d'autotélémétrie (secondes)
Activer l'autodiagnosticCrée 14 capteurs de diagnostic pour le compagnon : durée de fonctionnement, longueur de la file d'émission, plancher de bruit, dernier RSSI et SNR, temps d'antenne en TX et RX, et compteurs de paquets. Désactivé par défaut. Ce sont des requêtes locales vers le compagnon et rien n'est envoyé sur le réseau maillé. L'intervalle définit la fréquence de mise à jour des capteurs (de 60 à 3600 secondes).
Intervalle d'autodiagnostic (secondes)
Mode de découverte des contactsEntité par contact : chaque contact découvert reçoit sa propre entité (idéal pour les petits réseaux maillés). Données seulement : les contacts découverts sont suivis uniquement comme données, sans entité par contact ; consulte-les via la liste déroulante ou le service Get Discovered Contact. Désactivé : la découverte des contacts est entièrement désactivée et les contacts découverts existants sont effacés.

Configurer la connexion réseau

Adresse de l'hôte
Port
Activer l'autotélémétrie
Intervalle d'autotélémétrie (secondes)
Activer l'autodiagnosticCrée 14 capteurs de diagnostic pour le compagnon : durée de fonctionnement, longueur de la file d'émission, plancher de bruit, dernier RSSI et SNR, temps d'antenne en TX et RX, et compteurs de paquets. Désactivé par défaut. Ce sont des requêtes locales vers le compagnon et rien n'est envoyé sur le réseau maillé. L'intervalle définit la fréquence de mise à jour des capteurs (de 60 à 3600 secondes).
Intervalle d'autodiagnostic (secondes)
Mode de découverte des contactsEntité par contact : chaque contact découvert reçoit sa propre entité (idéal pour les petits réseaux maillés). Données seulement : les contacts découverts sont suivis uniquement comme données, sans entité par contact ; consulte-les via la liste déroulante ou le service Get Discovered Contact. Désactivé : la découverte des contacts est entièrement désactivée et les contacts découverts existants sont effacés.

Reconfigurer la connexion USB

Chemin de l'appareil USB
Vitesse de connexion

Reconfigurer la connexion Bluetooth

Appareil Bluetooth

Reconfigurer la connexion réseau

Adresse de l'hôte
Port

Après la mise en place

Choisis une action
Répéteurs disponibles
Mot de passe du répéteur
Activer l'interrogation de la télémétrie
Activer les entités voisines (crée des capteurs de SNR et d'activité pour chaque voisin vu par le répéteur)Demande à ce répéteur sa liste de voisins après chaque interrogation d'état réussie. Chaque voisin reçoit un capteur de SNR et un capteur de présence. La liste est paginée : chaque page correspond à une requête, donc le coût augmente avec le nombre de voisins. Nécessite le firmware MeshCore 1.14.0 ou plus récent.
Fréquence d'actualisation de la télémétrie (secondes)
Désactiver la réinitialisation du chemin
Mot de passeEnvoyé une seule fois pour se connecter au répéteur. Laisse vide pour un répéteur qui donne l'accès par ACL sans mot de passe.
Clients disponibles
Fréquence de mise à jour (secondes)
Désactiver la réinitialisation du chemin
Sélectionner un appareil
Action
Mettre à jour le mot de passe (laisse vide pour conserver l'actuel)
Activer l'interrogation de la télémétrie
Activer les entités voisines (crée des capteurs de SNR et d'activité pour chaque voisin vu par le répéteur)Demande à ce répéteur sa liste de voisins après chaque interrogation d'état réussie. Chaque voisin reçoit un capteur SNR et un capteur de dernière réception. La liste est paginée : chaque page correspond à une requête, donc le coût augmente avec le nombre de voisins. Nécessite le firmware MeshCore 1.14.0 ou plus récent.
Fréquence d'actualisation de la télémétrie (secondes)
Désactiver la réinitialisation du chemin
Désactiver l'appareil
Mettre à jour le mot de passe (laisse vide pour conserver l'actuel)Les mots de passe enregistrés ne sont jamais affichés. Laisse ce champ vide pour conserver le mot de passe enregistré ; saisis-en un nouveau pour le remplacer.
Fréquence de mise à jour (secondes)
Désactiver la réinitialisation du chemin
Désactiver l'appareil
Mode de découverte des contactsEntité par contact : chaque contact découvert reçoit sa propre entité (idéal pour les petits maillages). Données uniquement : les contacts découverts sont suivis uniquement comme données, sans entité par contact. Consulte-les via la liste déroulante ou le service Get Discovered Contact. Désactivé : la découverte des contacts est entièrement désactivée et les contacts découverts existants sont supprimés.
Limiter les contacts découverts
Nombre maximal de contacts découverts
Activer l'autotélémétrie
Intervalle d'autotélémétrie (secondes)
Activer l'autodiagnosticCrée 14 capteurs de diagnostic pour le companion : durée de fonctionnement, longueur de la file d'émission, plancher de bruit, dernier RSSI et SNR, temps d'antenne en émission et en réception, et compteurs de paquets. Désactivé par défaut. Ce sont des requêtes locales vers le companion et rien n'est envoyé sur le maillage. L'intervalle définit la fréquence de mise à jour des capteurs (de 60 à 3600 secondes).
Intervalle d'autodiagnostic (secondes)
Activer la console CLIAjoute un capteur Console CLI. Il enregistre chaque commande que tu exécutes avec execute_command ou execute_command_ui lorsque record_to_console est activé, ainsi que la réponse. Il affiche uniquement les paires commande et réponse, pas le journal de l'appareil. Désactivé par défaut. Utilise-le avec l'assistant text.meshcore_command et une carte Markdown. La documentation contient un exemple de tableau de bord.
Activer l'envoi automatique vers la carte (map.meshcore.io)Envoie à map.meshcore.io les annonces que tu reçois des répéteurs, des serveurs de salon et des nœuds capteurs. Ces nœuds apparaissent ensuite sur la carte de la communauté MeshCore. Le firmware doit autoriser l'export de la clé privée (ENABLE_PRIVATE_KEY_EXPORT=1). Sans cela, l'intégration ne peut pas signer les envois.
Nettoyage automatique des contacts découverts obsolètes (une fois par jour)Lorsque cette option est activée, les contacts découverts dont la dernière mise à jour est plus ancienne que le seuil configuré sont supprimés automatiquement une fois par jour. Les contacts enregistrés sur le nœud sont toujours conservés.
Seuil des contacts obsolètes (jours)
Suppression automatique des voisins obsolètesSupprime automatiquement les entrées de voisins et leurs entités capteur lorsqu'aucun signal n'en a été reçu pendant le nombre de jours configuré.
Seuil des voisins obsolètes (jours)Nombre de jours sans nouvelle d'un voisin avant sa suppression automatique (1 à 365).
Récupérer les messages entrants en file d'attenteActivé par défaut. Désactive cette option lorsqu'un autre client, par exemple un téléphone en BLE, doit récupérer les messages de canal et les messages directs en file d'attente. Home Assistant continue d'interroger l'état et la télémétrie des répéteurs et peut toujours envoyer des commandes. Les messages transmis par l'appareil peuvent quand même apparaître dans Home Assistant ; ce réglage contrôle la récupération de la file d'attente, pas la visibilité des messages. Les réponses textuelles aux commandes peuvent aussi rester en file d'attente pour l'autre client.
Livraison adaptative des messages de canalLorsque cette option est activée, les messages de canal entrants sont déclenchés dès l'arrivée des données RX_LOG (généralement environ 50 ms) au lieu d'attendre toujours les 500 ms complètes. Les données de répéteurs arrivées en retard sont livrées progressivement. Désactive cette option si des bots ou des automatisations ont besoin de tous les chemins dans l'événement initial.
Broker
Action

Textes issus du code de meshcore-dev/meshcore-ha. Les textes que le dépôt ne fournit pas en français ont été traduits automatiquement.

Entités

Capteurs binairesDéfaut radio : réserve de paquets épuisée, Défaut radio : délai CAD dépassé, Défaut radio : délai de début de réception dépassé
CapteursÉtat du nœud, Nombre de nœuds, Dernier RSSI, Dernier SNR, Batterie, Durée de fonctionnement, Temps d'antenne, Messages envoyés, Messages reçus, Chemin de routage, Longueur du chemin, Requêtes réussies et 33 autres

Actions

Envoyer un messageEnvoie un message à un nœud MeshCoreChamps : ID du nœud, Message
Envoyer un message de canalEnvoie un message texte à un canal public MeshCore.Champs : Index du canal, Message, ID de l'entrée de configuration
Envoyer un message UIEnvoie un message à l'aide des assistants d'interface MeshCore. Ce service lit les valeurs de 'select.meshcore_recipient_type', 'select.meshcore_channel', 'select.meshcore_contact' et 'text.meshcore_message' pour déterminer le destinataire et le contenu du message. Appelle ce service directement depuis une carte bouton pour obtenir une interface de messagerie fluide.Champs : ID de l'entrée de configuration
Exécuter une commande MeshCoreExécute une commande fournie par la bibliothèque Python MeshCore. C'est une fonctionnalité avancée qui donne un accès direct à l'interface de commandes sous-jacente. ATTENTION : certaines commandes appliquent des CHANGES PERMANENTS à la configuration de ton nœud. Utilise-la avec précaution.Champs : Commande, ID de l’entrée de configuration, Enregistrer dans la console CLI
Exécuter la commande depuis l’interfaceExécute une commande à l’aide de l’entité auxiliaire text.meshcore_command. Ce service lit la commande dans l’auxiliaire de texte et l’exécute. Il vide automatiquement le champ de saisie après l’exécution.Champs : ID de l’entrée de configuration, Enregistrer dans la console CLI
Vider la console CLIVide la transcription de la console CLI. Sans entry_id, vide la console de chaque appareil configuré.Champs : ID de l’entrée de configuration
Ajouter le contact sélectionnéAjoute le contact sélectionné dans l’entité sélecteur des contacts découverts à la liste de contacts de ton nœud.Champs : ID de l’entrée de configuration
Supprimer le contact sélectionnéSupprime le contact sélectionné dans l’entité sélecteur des contacts ajoutés de la liste de contacts de ton nœud.Champs : ID de l’entrée de configuration
Supprimer un contact découvertSupprime un contact découvert de la liste des contacts découverts. Cela supprime le contact de Home Assistant, mais ne le supprime PAS de la liste de contacts de ton nœud. Tu peux indiquer directement le pubkey_prefix, ou le laisser vide pour utiliser le contact sélectionné dans l’entité sélecteur des contacts découverts.Champs : Préfixe de clé publique, ID de l’entrée de configuration
Nettoyer les contacts indisponiblesSupprime de Home Assistant tous les capteurs binaires de contacts MeshCore indisponibles.Champs : ID de l’entrée de configuration
Vider les contacts découvertsSupprime de Home Assistant les contacts découverts et leurs entités de capteurs binaires associées. Quand days_threshold est indiqué, seuls les contacts dont la dernière mise à jour est plus ancienne que le seuil sont supprimés, et les contacts enregistrés dans le nœud sont conservés. Sans days_threshold, tous les contacts découverts sont supprimés. Cela ne supprime PAS les contacts de la liste de contacts de ton nœud.Champs : Seuil en jours, ID de l’entrée de configuration
Obtenir un contact découvertRenvoie le dictionnaire complet des données d’un seul contact découvert (non ajouté), identifié par son préfixe de clé publique. En mode données uniquement, les contacts découverts n’ont pas d’entité propre, c’est donc la façon prise en charge d’en inspecter un.Champs : Préfixe de clé publique, ID de l’entrée de configuration

Dépannage

DiagnosticsTélécharge un fichier de diagnostics à joindre à un rapport de bug.
Avis de correctionLes avis qu’elle peut afficher dans Paramètres > Corrections :La clé publique MeshCore a changé

Extrait du 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.

Extrait du README de meshcore-dev/meshcore-ha, MIT License. Abrégé.