Intégrer ITEAD Sonoff avec le firmware d'origine a Home Assistant

3 minutes de lecture
OBJECTIFS DU GUIDE:
CONCEPTS FACE:
  • Configuration du logiciel
COMPOSANTS LOGICIELS UTILISÉS:
Pré-requis:
DISPOSITIFS PHYSIQUES UTILISÉS:
  • Il Raspberry Pi sur lequel il réside Home Assistant
  • un Android ou un smartphone / tablette Appl'iOS
  • L'élément ITEAD à intégrer
GUIDE plus indiqué pour:

Tous les environnements

Notes et avertissement
  • qualsiasi modifica all'impianto elettrico dev'essere progettata ed effettuata da personale qualificato;
  • tout changement mis en œuvre dans proavant est un prola responsabilité personnelle, ainsi que propremier risque et danger (le contenu de la présente page est purement pédagogique);
  • tout changement mis en œuvre dans proavant un appareil, il annule la garantie, les approbations de qualité et les certifications.
Avis de conduite: 1.2

Abstrait

Comme on le sait, la pratique la plus répandue consiste à équiper les composants à partir de SOC ESP8266 (comment, pour leappgraisseux, la plupart des ITEADs) di firmware alternatif utile pour donner à l'utilisateur une plus grande liberté de configuration et une certaine intégration (généralement via MQTT) avec tout HUB personnel et similaire. Si vous ne voulez pas vous en occuper la proordre de remboursementpropoids du firmware, vous pouvez utiliser ce composant en gardant toujours à l'esprit que:

  • l'intégration est garantie sur la base à la matrice de compatibilité (binôme modèle / version du firmware d'origine);
  • l’intégration, lorsqu’elle fonctionne, ne garantit pas toujours l’utilisation de toutes les fonctionnalités du dispositif intégré (par exemple, la Sonoff POW R2 avec le firmware 3.3.x);
  • l'intégration utilise le cloud ITEAD comme moyen, donc en l'absence de connexion internet, l'intégration cesse de fonctionner.

l'intégration, comme mentionné, utilise le nuage ITEAD: en pratique le composant Sonoff se connecte à travers la configuration précédente de l'habituel app mobile eWeLink (utilisé pour configurer et gérer les membres de la famille Sonoff) Et Home Assistant, à travers "HASS-sonoff-ewelink " fa lo stesso, authentification sur le nuage avec les mêmes informations d'identification que leapp eWeLink: cette connexion "pont" permettra donc deHUB "voir" le Sonoff et ensuite de l'intégrer.

Il commence

vérifications propedeutiche

Avant de s'aventurer dans l'intégration via le firmware d'origine est nécessaire appurare:

  • pour que l'accessoire à intégrer soit déjà configuré à laapp eWeLink;
  • vérifier que la version de l'accessoire / du micrologiciel d'origine (vérifiable par app eWeLink) fait partie de ceux qui peuvent être intégrés en consultant la matrice de compatibilité.

Le non respect de ces points rendra l’intégration dans ces modes impossible.

Installation de composants

La proCedura envisage de télécharger à partir de GitHub le fichier .zip contenant le composant, décompressez-le et copiez le dossier “sonoff"Contenu en elle"custom_components"À son tour contenu dans ce qu'il préserve habituellement les fichiers de configuration de Home Assistant (s'il n'existe pas, créez-le).

Ce dossier correspond généralement à:

  • si installé comme applicence sur Raspbian, dans le dossier “/home/homeassistant/.homeassistant";
  • su HASSIO, dans le dossier "/ Config /« 

Pour copier le dossier "sonoff"Nous vous recommandons d'utiliser sFTP (peut-être en utilisant le client Filezilla), qui est opérationnel en présence du service SSH. Pour installer SSH sur HASSIO, se référer à à ce guide.

À partir de 0.101.x

À partir de la version 0.101.x de Home Assistant alors il est devenu nécessaire:

  • enlever la ligne "REQUIREMENTS"Présent dans le dossier __init__.py
  • ajouter un fichier appelé sonoff.json contenant le code suivant:
{
  "domain": "sonoff",
  "name": "Sonoff / eWeLink",
  "documentation": "https://github.com/peterbuga/HASS-sonoff-ewelink",
  "dependencies": [],
  "codeowners": ["@peterbuga"],
  "requirements": ["uuid", "websocket-client==0.54.0"]
}

Enfin: en cas de Home Assistant installé comme applicativo sous Raspbian, veillez à exécuter la commande suivante pour corriger les autorisations sur le système de fichiers:

sudo chmod -R 0777  /home/home/.homeassistant

Configuration Home Assistant

À ce stade, il est possible de varier la configuration de Home Assistant afin de vous ajouter le bloc suivant:

sonoff:
  username: [email o numero telefonico]
  password: [password]
  scan_interval: 60
  grace_period: 600
  api_region: 'eu'
  entity_prefix: True
  debug: False

Explication des champs:

TerrainValeur
sonoff:(Obligatoire) Identifie le bloc de configuration lié au composant "HASS-sonoff-ewelink».
username(String, obligatoire) Provotre nom d'utilisateur sur le nuage ITEAD.
password(String, obligatoire) Provotre mot de passe sur le nuage ITEAD.
scan_interval(Entier, facultatif) Nombre de secondes entre une mise à journamento et l'autre. 60 minimum.
grace_period(Entier, optionnel) Puisqu'il n'est pas possible de se connecter avec provotre compte de plus d'un client à la fois, au cas où vous vous connectez app Home Assistant il est automatiquement déconnecté: cette valeur indique combien de secondes Home Assistant il ne doit pas essayer de se reconnecter.
api_region(Chaîne, facultatif) Indique le continent à partir duquel se connecter. La valeur par défaut est "eu« ; les autres valeurs possibles sont "us","as"Et"cn».
entity_prefix(Boolean, optionnel) Si défini sur "true"Supprimer le préfixe"sonoff_”Du nom de entité généré sur Home Assistant par l'intégration.
debug(Boolean, optionnel) Si défini sur "true"Activer le mode débogage. Plus d'informations sur le mode débogage sont disponibles ici.

Après la configuration réussie, recommencer Home Assistant.

Utiliser

À ce stade, rien d'autre n'est nécessaire qui commencent à utiliser des entités qui aura été généré par le composant, généralement de type "Switch"Et"Sensor».

Home Assistant Switch
un exemple de commutateur.

Une possible, ultérieure ajout d'actionneurs et de capteurs auapp eWeLink (toujours compatible avec la matrice de compatibilité) générera automatiquement, à Home Assistant, les entités correspondantes.

MISE À JOUR DU FIRMWARE

un'accortezza important: en cas de besoin de mises à journamedu firmware d'origine d'un ou plusieurs composants ITEAD (évidemment, n'oubliez pas de vérifier la matrice de compatibilité afin de ne pas risquer de perdre la possibilité de l'intégrer à Home Assistant), souviens-toi d'abord arrêter Home Assistantet seulement après la mise à journamento firmware provvedere pour le redémarrer.


Home Assistant Logo officielATTENZIONE: rappelez-vous qu'il y a sur notre communauté FORUM une section ad hoc dédiée à Home Assistantpour tout doute, question, information sur le mérite spécifique de ces composants.


Veuillez commenter ci-dessous