Guide
Se connecter à Home Assistant
Installez l'intégration inkVision pour Home Assistant et ajoutez l'appareil sur votre réseau local.
Avant de commencer
Ce guide décrit la méthode actuelle de connexion à Home Assistant sur le réseau local pour les appareils Atmos Wi-Fi déjà connectés à votre Wi-Fi domestique.
- Il vous faut un appareil Atmos déjà connecté à votre réseau domestique.
- Il vous faut une instance Home Assistant fonctionnelle sur le même réseau local.
- Il vous faut l'adresse IP de l'appareil, ou un réseau sur lequel la découverte de Home Assistant peut atteindre l'appareil.
- Pour vérifier que l'appareil est en ligne, ouvrez http://DEVICE_IP/ dans un navigateur.
- Pages et points de terminaison locaux utiles : /, /ota, /status, /sensors, /config.json et /ws.
Option 1 : Installation via HACS
- Ouvrez HACS dans Home Assistant.
- Ouvrez Intégrations.
- Ajoutez le dépôt personnalisé https://github.com/HomeBrainz/ha-inkVision.
- Choisissez la catégorie Intégration.
- Installez inkVision.
- Redémarrez Home Assistant.
Option 2 : Installation manuelle
- Ouvrez le dossier de configuration de Home Assistant.
- Créez le dossier custom_components/inkvision s'il n'existe pas.
- Copiez dans ce dossier les fichiers du dossier custom_components/inkvision du dépôt de l'intégration.
- Redémarrez Home Assistant.
Mise à niveau depuis l'intégration HomeBrainz
- L'intégration s'appelait auparavant HomeBrainz. Après sa mise à jour dans HACS et le redémarrage de Home Assistant, vos appareils passent automatiquement à inkVision et conservent leurs ID d'entité et leur historique.
- Les actions ont été renommées de homebrainz.* en inkvision.*. Les anciens noms fonctionnent toujours, et Paramètres > Réparations vous signale si une automatisation en utilise encore un.
- HACS laisse en place l'ancien dossier custom_components/homebrainz. Une notification de réparation propose de le supprimer ; redémarrez ensuite Home Assistant.
Ajouter l'intégration dans Home Assistant
- Dans Home Assistant, ouvrez Paramètres > Appareils et services.
- Sélectionnez Ajouter une intégration.
- Recherchez inkVision.
- Si Home Assistant détecte automatiquement l'appareil, sélectionnez-le.
- Sinon, saisissez manuellement l'adresse IP de l'appareil.
- Terminez l'assistant de configuration.
Home Assistant détecte généralement l'appareil automatiquement sur votre réseau local, mais la saisie manuelle de l'adresse IP fonctionne toujours en solution de secours.
Ce qui est ajouté
- Des entités de capteur pour la température, l'humidité, la pression, le signal Wi-Fi et la qualité de l'air.
- Des commandes de luminosité et de fuseau horaire.
- Des commandes de rotation de l'écran.
- Des actions de vérification et d'installation du firmware.
- Des commandes de haut-parleur ou de lecteur multimédia sur les versions compatibles.
Utiliser les pages intégrées de l'appareil
Avant ou après l'ajout de l'appareil à Home Assistant, vous pouvez vérifier l'état de l'appareil directement dans ses pages locales intégrées.
- Ouvrez http://DEVICE_IP/.
- Utilisez l'inkVision Device Dashboard pour examiner l'état de l'appareil, les valeurs des capteurs en direct, la luminosité, la rotation de l'écran, la vérification ou l'installation des mises à jour OTA et les commandes de redémarrage.
- Ouvrez http://DEVICE_IP/ota si vous souhaitez téléverser manuellement un fichier de firmware .bin local.
- Si Home Assistant affiche des valeurs obsolètes, comparez-les avec le tableau de bord ou avec les réponses brutes de /status et /sensors.
Vérifier la connexion
- Ouvrez la page du nouvel appareil inkVision dans Home Assistant.
- Vérifiez que les valeurs des capteurs se mettent à jour.
- Ouvrez le lien web local de l'appareil depuis Home Assistant, s'il est disponible.
- Si votre version dispose de commandes, testez une action sans risque, comme la luminosité.
Dépannage
Si la découverte ne fonctionne pas, assurez-vous que Home Assistant et l'appareil Atmos sont sur le même réseau local ou sur un sous-réseau local accessible, vérifiez que http://DEVICE_IP/status répond, puis ajoutez à nouveau l'intégration en saisissant manuellement l'adresse IP.
S'il manque des entités, notez que les entités de capteur nécessitent une version équipée de capteurs, les commandes de haut-parleur une version avec audio et les commandes d'affichage une version avec écran.
Si l'intégration est ajoutée mais que les valeurs ne se mettent pas à jour, rechargez l'intégration, redémarrez une fois l'appareil Atmos et recherchez des erreurs de connexion ou WebSocket dans les journaux de Home Assistant.
Si vous ne connaissez pas l'adresse IP de l'appareil, consultez la liste des clients de votre routeur ou utilisez un scanner de réseau local.