Articles - Domotique

Zigbee2MQTT : Passerelle Zigbee universelle

Auteur Date  |   Vues 89  |  Commentaires Commentaire (1)  |  Catégorie Domotique  |  Mots clés home assistant, zigbee2mqtt, zigbeetomqtt, cc2531, packages, passerelle universelle zigbee, Zigbee2MqttAssistant, gateway, passerelle, zigbee, domotique
Zigbee2MQTT : Passerelle Zigbee universelle

Mise à jour : 18/04/2020



Introduction.



Le Zigbee est un protocole domotique qui, à l'origine, se devait d’être un protocole universel compatible pour tous.
Mais les gros constructeurs ont vu, avec l'arrivée des marchés asiatiques, des produits équivalents à des prix quatre fois moins chers.
Pour protéger leurs "technologies" (prix lol), ils ont décidé de rendre leur protocole non compatible avec les autres, ce qui a pour effet de se retrouver avec une gateway (passerelle) par constructeur.

C'est là qu'intervient une passerelle universelle.

Il en existe plusieurs, la Zigate (FR), la Conbee II, la ZigbeeToMqtt.

La première, la Zigate (49 euros min), je la connais bien, je l'ai utilisé sous Jeedom avec le plugins "Abeille" et sous Domoticz malheureusement elle est mal intégrée dans Home Assistant c'est pour cela que j'ai du changer.

La Conbee II (40 euros), je ne connais pas mais de ce que j'en entends, elle marche sous Jeedom, Domoticz, Home Assistant.

La dernière, la CC2531(moins de 20 euros sur Aliexpress) permet, une fois flashée, d'avoir ZigbeeToMqtt.

Venant de recevoir le mien nous allons voir comment le flasher et l’intégrer à Home Assistant.
Nous allons voir la méthode de flash classique (via CC Debugger). Pour les versions alternatives rendez vous ici.

Pré-requis.


  • Un CC Debugger
  • Un câble Download
  • Un cc2531 USB sniffer
  • SmartRF Flash Programmer (ne prenez PAS la V2) Il vous faudra créer un compte.ou ICI sans inscription.
  • Récupérez le Driver du CC Debugger pour Windows ICI.
  • Récupérez le dernier firmware CC2531 Default.
  • Avoir installé MQTT Broker.

images1

Commençons.

Installation.


Installez les drivers pour windows, en cliquant sur "Setup_SmartRF_Drivers-1.2.0" dans votre dossier du driver.

images2

Suivant, suivant, suivant.


Idem avec "Setup_SmartRF_Flash_Programmer-1.12.8" le programme de flash.

images3

Faites vos branchements mais ne reliez rien à votre PC

images4

Maintenant reliez le sniffer USB sur un port et le Debugger sur un autre port.

Si vous avez un voyant LED vert sur le Dedbugger, c'est gagné si elle est rouge appuyez sur le bouton reset du Debugger. Si elle persiste au rouge rendez vous sur le site de Texas instrument dans le Troubleshooting en pdf.

Démarrez SmartRF Flash Programmer, vérifiez la présence de votre CC Debugger, sélectionnez votre fichier et réglez le programme comme l'image
images5

Interface : Fast
Flash image : votre firmware téléchargé.
location : Primary
Retain IEEE : Décoché
Actions : Erase, program and verify

Cliquez sur "Perform actions" la lumière verte du CC2531 devrait s’éteindre et à la fin se rallumer.

images6

Intégration à Home Assistant.


intégrer une nouvelle source dans ADD-ON STORE


NOTA : Je vous rappelle qu'il faut avoir installé MQTT Broquer.

Rendez vous dans "Supervisor", "ADD-ON STORE" puis dans "Add new repository by URL" ajoutez "https://github.com/danielwelch/hassio-zigbee2mqtt"

images7

Cliquez sur ADD

Installation


Une fois ajouté, recherchez zigbee2mqtt et installez la version "bridge".

images8
images9

Ajoutez dans votre fichier "configuration.yaml"
Code TEXT :
 
mqtt:
  broker: core-mosquitto # This will have to be your mqtt broker, Mosquitto addon is recommended.
  discovery: true


Panneau d'administration


Deux moyens s'offrent à vous pour avoir un panneau d'administration : soit la création d'un package soit l'ajout d'un ADD-ONS.

L'administration par ADD-ONS.


Je pense que lorsque l'on est débutant c'est le top. En tout cas c'est mon préféré et surtout rien à faire lol.

Cet add-ons vous permettra d'ajouter, supprimer, renommer, avoir une carte avec vos nœuds et autres, etc etc. C'est une gestion complète de votre matériel Zigbee2MQTT.

Ajout de la sources GitHub


Il va falloir ajouter la source suivante dans "Supervisor", ""ADD-ONS puis dans ajouter une source, rentrez cette adresse https://github.com/yllibed/hassio cliquez sur ADD et recherchez "zigbee2mqttassistant".

images16

Mettre juste votre user et le mot de passe de votre "MQTT Broquer"
Faites "SAVE" puis "START".

Voila, vous avez maintenant un beau panneau de gestion de votre clé Zigbee2MQTT.

Ajout d'un devices

Pour autoriser l'ajout d'un devices, allez dans "statut" puis cliquer sur "ALLOW NEW DEVICES TO JOIN NETWORK" puis effectuez la manipulation d'appairage de votre devices.

Une fois l'appairage fait cliquez sur "Devices"

Voici quelques images.
images17
images18images19images20images21images22

Création du "packages".


NOTA : Ce n'est plus le moyen que j'utilise car il y a beaucoup plus simple, mais comme elle était écrite cela peu intéresser du monde.
Pour les débutants je vous conseille d'utiliser la solution de l'addons.


Dans votre dossier "packages" (si vous avez suivi mon organisation), créer un fichier nommé "zigbee2mqtt.yaml" puis coller ce qui suit.
Ce package vous permet de créer les input Boolean et les automations nécessaires au fonctionnement du Zigbee2MQTT.

images10

Code TEXT :
 
input_boolean:
  zigbee_permit_join:
    name: Ajouter un Device
    initial: off
    icon: mdi:cellphone-wireless
timer:
  zigbee_permit_join:
    name: Time remaining
    duration: 600 # Temps en secondes de durée d'appairage.
sensor:
  - platform: mqtt
    name: Status Passerelle
    state_topic: "zigbee2mqtt/bridge/state"
    icon: mdi:router-wireless
automation:
  - id: enable_zigbee_join
    alias: Activer l’appairage
    trigger:
      platform: state
      entity_id: input_boolean.zigbee_permit_join
      to: 'on'
    action:
    - service: mqtt.publish
      data:
        topic: zigbee2mqtt/bridge/config/permit_join
        payload: 'true'
    - service: timer.start
      data:
        entity_id: timer.zigbee_permit_join
  - id: disable_zigbee_join
    alias: Désactiver l’appairage
    trigger:
    - entity_id: input_boolean.zigbee_permit_join
      platform: state
      to: 'off'
    action:
    - data:
        payload: 'false'
        topic: zigbee2mqtt/bridge/config/permit_join
      service: mqtt.publish
    - data:
        entity_id: timer.zigbee_permit_join
      service: timer.cancel
  - id: disable_zigbee_join_timer
    alias: Désactiver l’appairage par le temps
    trigger:
    - platform: event
      event_type: timer.finished
      event_data:
        entity_id: timer.zigbee_permit_join
    action:
    - service: mqtt.publish
      data:
        topic: zigbee2mqtt/bridge/config/permit_join
        payload: 'false'
    - service: input_boolean.turn_off
      data:
        entity_id: input_boolean.zigbee_permit_join


Une fois créé, sauvegardez puis vérifiez votre configuration. Redémarrez.

Dans "Aperçu" créez une nouvelle cards avec "entités" puis sélectionnez. Remplir via l’éditeur comme ci dessous ou sélectionner vos entités.

images11

Code TEXT :
entities:
  - entity: input_boolean.zigbee_permit_join
  - entity: timer.zigbee_permit_join
  - entity: sensor.status_passerelle
show_header_toggle: false
title: Zigbee
type: entities


Vous avez maintenant un beau panneau de commande.
images12

Ajout d'un device.


Pour ajouter un devices il vous suffit de cliquer sur "Ajouter un Device"
images13

Puis d’effectuer la procédure d'appairage de l'objet.
Pour l'exemple je vais le faire avec un capteur d'ouverture de porte Xiaomi (rester au moins 5 secondes sur le bouton).

Une fois le capteur appairé, rendez vous dans "Configuration","intégration" puis "MQTT".
images14
images15

Votre capteur a été ajouté. En cliquant dessus vous pourrez le renommer, ajouter une carte Lovelace intégrant tous les éléments, créer des scènes, des scripts et des automatisations.

Conclusions.



Vous avez maintenant une passerelle universelle pour tous vos appareils Zigbee.
Elle vous permettra de faire communiquer plus d'objets, non compatibles à l'origine, entre eux sans passer par des cloud en chine.

Trucs & Astuces.


Attention si vous branchz votre clé Zigbee alors que votre Home Assistant est démarré il va planter il va falloir redémarrer, je vous conseille donc d’éteindre votre Home Assistant puis une fois la clé branchée, redémarrer.

To do list :


Mise à jour:
18/04/2020
- Correction
- Ajout de l'ADD-ONS