Wiki Les geekeries de rungis

Domotique

Sun, 02 Feb 2025 15:33:31 +0100

Je vous partage quelques tips relatifs à l'utilisation de jeedom et de Home Assistant.

[HomeAssistant] Installer zigbee2mqtt et mosquitto sur docker

Sun, 02 Feb 2025 15:19:48 +0100

Introduction

Dans cet article, je vais détailler comment installer Zigbee2mqtt et Mosquitto sur un serveur Docker.
Le but est de pouvoir piloter des équipements Zigbee (ampoules, prises, capteurs, etc.) via un serveur MQTT conectable à Home Assistant mais en installant le broker et Zigbee2mqtt à part, ce qui vous permettra dans le futur, si besoin de migrer vers un autre système domotique sans devoir appairer à nouveau tous vos équipements Zigbee.

Prérequis

- Un serveur Docker fonctionnel (personnellement, j'utilise une VM Debian sur mon serveur Proxmox avec docker et Portainer installés dessus).
- Un dongle Zigbee compatible avec Zigbee2mqtt (CC2531, CC2530, CC2531, etc.) >> pour cela, je vous invite à consulter mon article qui vous décrit le flashage du dongle Sonooff Zigbee 3.0 Dongle Plus.

Installation de Mosquitto et Zigbee2mqtt dans une stack Docker

Déploiement de la stack

Je vous donne ma méthode valable avec Portainer.
Allez sur votre portainer, puis dans votre environnement puis cliquez sur "Stacks" et enfin sur "Add stack".

Copiez le docker-compose suivant dans le champ "Web editor" :

Code YAML :

 
services:
  mosquitto:
    image: eclipse-mosquitto
    container_name: mosquitto
    restart: always
    volumes:
      - /opt/docker/mosquitto/config:/mosquitto/config
      - /opt/docker/mosquitto/data:/mosquitto/data
      - /opt/docker/mosquitto/log:/mosquitto/log
    ports:
      - 1883:1883
      - 9001:9001
 
  zigbee2mqtt:
    image: koenkk/zigbee2mqtt
    container_name: zigbee2mqtt
    restart: unless-stopped
    volumes:
      - /opt/docker/zigbee2mqtt:/app/data
      - /run/udev:/run/udev:ro
    devices:
      - /dev/serial/by-id/usb-ITead_Sonoff_Zigbee_3.0_USB_Dongle_Plus_d6c634615252ef1185b12a53cc32aab1-if00-port0:/dev/ttyUSB0 
    ports:
      - 8080:8080
    environment:
      - TZ=Europe/Paris

Quelques explications :
- pour mosquitto, on utilise l'image officielle eclipse-mosquitto. Il est important de monter les volumes pour la configuration, les données et les logs.
Pour le montage des volumes, j'utilise la méthode qui consiste à créer un dossier par conteneur dans /opt/docker/.
Pour les ports, veillez à ce que ces ports ne soient pas déjà utilisés sur votre serveur.
- pour zigbee2mqtt, on utilise l'image officielle koenkk/zigbee2mqtt. Il est important de monter le volume pour les données et de monter le device du dongle Zigbee.
Pour les ports, veillez à ce que ces ports ne soient pas déjà utilisés sur votre serveur. L'environnement TZ permet de définir le fuseau horaire.

Pour trouver le device du dongle Zigbee (ici "usb-ITead_Sonoff_Zigbee_3.0_USB_Dongle_Plus_d6c634615252ef1185b12a53cc32aab1-if00-port0"), vous pouvez utiliser la commande suivante : `ls -l /dev/serial/by-id/usb*` sur votre serveur qui héberge docker.
Faites attention à bien formater la ligne

La stack est maintenant déployée et les deux conteneurs installés. Cependant, il reste un peu de configuration à faire pour les deux conteneurs.

Configuration de zigbee2mqtt

Si votre conteneur redémarre sans arrêt (ce qui était mon cas), il est possible que le fichier de configuration ne soit pas correctement configuré (chez moi il était inexistant...).
Vous pouvez dans ce cas arrêter le conteneur avant de créer ou modifier le fichier configuration.yaml

Ici, il faut commencer par modifier (ou créer, dans mon cas le fichier n'existait pas) le fichier configuration.yaml dans le dossier /opt/docker/zigbee2mqtt.
Voici un exemple de fichier de configuration :

Code YAML :

 
homeassistant:
  enabled: true
mqtt:
  base_topic: zigbee2mqtt
  server: mqtt://192.168.1.82
  user: admin
  password: supermotdepasse
availability:
  enabled: true
  active:
    timeout: 10
  passive:
    timeout: 1500
serial:
  port: /dev/ttyUSB0
frontend:
  enabled: true
  port: 8080

Le base_topic est le nom du topic MQTT qui sera utilisé pour les équipements Zigbee. Vous pouvez mettre ce que vous souhaitez.
L'adresse IP du serveur correspond à l'adresse IP de votre serveur Docker.

Retenez bien le mot de passe que vous avez mis dans le fichier de configuration, il vous sera utile dans la configuration de mosquitto.

Ensuite, ajoutez l'utilisateur au groupe dialout pour qu'il puisse accéder au dongle Zigbee :

Code TEXT :

 
usermod -a -G dialout $USER

Puis donnez les bons droits aux dossier utiles :

Code TEXT :

 
chmod -R 755 /opt/docker/zigbee2mqtt/
chown -R 1000:1000 /opt/docker/zigbee2mqtt/

Si comme moi vous avez une erreur du type : Configuration is not consistent with adapter state/backup! dans les logs du conteneur, il faut supprimer le fichier /opt/docker/zigbee2mqtt/coordinator_backup.json et redémarrer le conteneur.

Configurations du conteneur mosquitto

Comme pour zigbee2mqtt, vous pouvez arrêter le conteneur s'il redémarre sans cesse, avant de créer le fichier de configuration.

La première chose à faire est de créer le fichier de configuration de mosquitto.
Pour cela, créez le fichier /opt/docker/mosquitto/config/mosquitto.conf (à adapter à votre installation ,ce chemin correspond à celui que j'ai utilisé dans le docker-compose)
et ajoutez-y le contenu suivant :

Code TEXT :

 
persistence true
persistence_location /mosquitto/data/
log_dest file /mosquitto/log/mosquitto.log
listener 1883
listener 9001
allow_anonymous true
protocol websockets
password_file mosquitto/config/mqtt_passwd

On retrouve ici le dossier /mosquitto/data créé dans docker-compose. Les ports sont également à adapter à votre docker-compose.
On voit également un renvoi vers le fichier mqtt_passwd, on va le créer maintenant.

Pour cela, on va devoir entrer dans le conteneur :

Code TEXT :

 
docker exec -it mosquitto sh

Une fois dans le conteneur, on va créer l'utilisateur avec la commande suivante :

Code TEXT :

 
mosquitto_passwd -c /mosquitto/config/mqtt_passwd admin

Il vous sera demandé de saisir un mot de passe, saisissez le mot de passe que vous avez mis dans le fichier de configuration de zigbee2mqtt.

Vos deux conteneurs devraient normalement être fonctionnels et vous permettre de piloter vos équipements Zigbee via MQTT.
Vous pouvez maintenant vous connecter à l'interface web de Zigbee2mqtt en vous rendant sur http://192.168.1.82:8080 (adaptez l'adresse, il s'agit de l'adresse de votre serveur Docker).

[Jeedom] Gérer ses volets Legrand dans Jeedom grâce à Home Assistant

Wed, 09 Aug 2023 10:52:12 +0200

Introduction

Catégorie Jeedom mais on va aussi utiliser Home Assistant aujourd'hui. Je me suis mis il y a quelques temps sur Home Assistant, je ne fais des choses basiques mais cela me permet de palier à quelques fonctionnalités non prises en charge par Jeedom.

C'est le cas aujourd'hui avec la gestion des volets Legrand. J'ai installé chez moi des interrupteurs de volets roulants connectés Legrand, comme celui ci-dessus. On peut donc piloter ses volets avec son smartphone ou une enceinte connectée (Google Nest, Alexa...). Mais pour les contrôler depuis Jeedom, il n'y a pas de plugin... J'ai fonctionné jusque là avec IFTTT mais depuis plusieurs semaines, cela ne fonctionne plus, et voulant m'éloigner d'IFTTT c'était l'occasion.

Côté Home Assistant

Côté Home Assistant, c'est assez simple, je ne fais pas encore de tuto sur le sujet mais normalement dans la partie Appareils et Services (menu paramètres), vous devez voir apparaître une intégration Netatmo directement détectée, c'est ensuite très simple à configurer. Il suffit de donner les noms qui vont bien aux appareils et les associer aux bonnes pièces.

Deux choses importantes à faire :

Noter le nom de l'appareil que l'on souhaite utiliser dans Jeedom. Pour cela, cliquer sur l'appareil puis sur la roue crantée en haut à droite et noter la valeur dans le champs ID d'entité
Créer un jeton d'accès longue durée. Pour cela, cliquer sur votre nom d'utilisateur en bas à gauche puis aller tout en bas sur créer un jeton. Donnez-lui un nom et notez bien le code fourni, vous ne pourrez plus le faire afficher par la suite

Côté Jeedom

Ici, je vais directement vous donner tout ce qu'il faut pour piloter vos volets roulants. Sachez que vous pouvez sur le même principe faire plein de choses mais pour trouver les commandes de Home Assistant, cela m'a donné un peu de temps pour comprendre comment fonctionne les API de Home Assistant qui sont beaucoup moins "friendly" que celles de jeedom. Je vous conseille d'utiliser un logiciel comme Postman pour faire des tests sur les API.

Dans jeedom, on va utiliser le plugin script et faire du script en ruby et en bash. J'ai testé de tout faire en bash et en php mais je n'ai pas réussi à faire ce que je voulais. Probablement que c'est possible mais j'ai réussi en ruby et bash donc je vous livre cela.

Dans le plugin script, créez un équipement pour votre volet puis 3 commandes :

Dans la commande état, cliquer sur la petite icone verte pour créer un nouveau script que vous nommez comme vous le souhaitez (ici API_HomeAssistant_GET.rb). Collez ensuite dedans le code suivant :

Code RUBY :

 
#!/usr/bin/env ruby
  input = ARGV
  commande = input[0]
  require 'net/http'
  require 'json'
  @host = '[IP HomeAssistant]'
  @port = '[Port HomeAssistant]'
  @path = "/api/states/#{commande}"
 
  request = Net::HTTP::Get.new(@path, initheader = {'Content-Type' => 'application/json', 'Authorization' => 'Bearer [Jeton]'})
  response = Net::HTTP.new(@host, @port).start {|http| http.request(request)}
  parsed = JSON.parse(response.body)
  state = parsed["state"]
  if state == "open"
    puts 1
  else
    puts 0
  end

Remplacez [IP HomeAssistant] par l'IP de votre serveur Home Assistant (sans les crochets), [Port HomeAssistant] par le port (sans les crochets) et [Jeton] par votre jeton créé précédemment (sans les crochets)

Une fois le script enregistré, il faut ajouter un paramètre à la suite du nom du script qui est l'ID d'entité que je vous ai demandé de noter (voir impression écran ci-dessus. Cette méthode vous permet pour d'autres équipement de conserver le même script et de juste changer l'option. Vous pourrez alors dupliquer tout l'équipement pour un autre volet et juste changer les paramètres passés au scipt Ruby.

Pour ce qui est des commandes ouverture et fermeture, on créé un second script de la même façon et on y met le code suivant (ce script servira aux deux commandes) :

Code BASH :

 
#!/bin/bash
commande="$1"
equipement="$2"
curl --location "http://[IP HomeAssistant]:[Port HomeAssistant]/api/services/cover/$commande" \
--header 'Content-Type: text/plain' \
--header 'Authorization: Bearer [Jeton]' \
--data '{
    "entity_id":"'"$equipement"'"
}'

Comme précédemment, il faut ajouter deux paramètres à la suite du nom du script une fois celui-ci enregistré :

open_cover ou close_cover en fonction de la commande
l'ID d'entité

Et voilà ! Normalement, à vous de tester, cela doit fonctionner. Je vous conseille au cas où cela ne fonctionne pas de copier ces scripts sur votre PC puis de les exécuter dans un terminal afin de voir les retours (bien que jeedom donne des retours aussi).

[Jeedom] Paramétrer le mini keypad RFID de zipato avec Zwavejs

Tue, 20 Jun 2023 19:16:47 +0200

Dans cet article, nous allons voir comment paramétrer ses codes et badges sur le mini RFID keypad de zipato lorsqu'on bascule de Zwave vers Zwavejs.
En effet, les commandes changent beaucoup lors de la migration et il est compliqué de s'y retrouver.

Je vais vous donner un exemple et vous aurez compris pour la suite.

Activer le code à définir

Dans un premier temps, il est nécessaire d'activer le code que l'on veut définir, par exemple le Code-1 (attention, le Code-0 ne sert qu'à retrouver les bons codes, on ne le définit pas). Pour cela, on va dans la liste des commandes de notre équipement et on clique sur "Tester" de la commande "Activer Code-1".

Récupérer le code du badge

Ensuite, on va devoir récupérer le code de notre badge. Pour cela, aller sur l'équipement, puis cliquer sur "Valeurs" (en dessous du visuel).

Puis déroulez le menu User Code v1 :

Ici, vous verrez dans userCode-0 le dernier code reçu par le clavier, à savoir soit en code en chiffre tapé sur les chiffres (1 à 4) soit le code du badge que vous avez passer. Pour taper un code, taper sur Home puis le code puis OK. Pour un badge, taper sur Home puis passez le badge.

Enregistrer ce code dans la mémoire du clavier

Ensuite, pour enregistrer ce code sur la mémoire Code-1, allez dans les commandes de l'équipement puis cocher l'affichage de la commande "Définir code-1". Allez ensuite dans votre dashboard, entrez le code récupéré dans l'étape précédente puis cliquez sur le bouton Définir Code-1.

Vérifier que cela a fonctionné

Vous pouvez ensuite vérifier que cela a fonctionné en repassant votre badge après avoir appuyé sur Home. Dans la commande User ID devrait s'afficher 1 (pour Code-1) ou 2 (pour Code-2 et ainsi de suite).

[Jeedom] Plugin mqtt après migration vers debian 11

Fri, 03 Mar 2023 23:35:43 +0100

Article très court. Je me suis décidé à migrer jeedom vers debian 11.
Pour cela, il m'a fallu basculer d'openzwave vers Zwave JS puisque le plugin openzwave ne fonctionne pas sur debian 11.

Pour fonctionner, le plugin Zwave JS a besoin du plugin MQTT Manager. J'ai donc installé ces deux plugins, vérifié que tout fonctionnait puis migré vers debian 11.

Malheureusement, au redémarrage, impossible d'installer les dépendances du plugin MQTT Manager.

Après quelques tests, la solution est venu en supprimant les éléments suivants dans /var/www/html/log :

mqtt2d
mqtt2
mqtt2_packages

Après, cela les dépendances s'installent correctement et tout refonctionne !

[Jeedom] Jeedom bannit mon IP sur Android

Fri, 27 Aug 2021 15:18:32 +0200

Description du problème

Petit article court pour décrire comment j'ai résolu un problème qui revenait de temps à autre.

Je me suis retrouvé de temps en temps à ne plus pouvoir me connecter sur mon jeedom à partir de mon smartphone sous Android. Cela ne m'est arrivé qu'avec Chrome et Vivaldi, d'après plusieurs forums c'est toujours les navigateurs basés sur Chrome qui sont en cause.

Je n'ai pas trouvé l'explication à ce problème mais voici comment le résoudre.

Tout d'abord, vérifier que le problème vient bien d'un bannissement d'IP. Pour cela, rendez-vous sur la page d'accueil de votre jeedom avec un autre périphérique (avec un ordinateur plutôt qu'un smartphone cela sera plus simple), et allez dans [Réglages] > [Système] > [Configuration] puis allez dans l'onglet [Sécurité]

Ici, on peut voir que l'IP 10.0.0.31 est bannie. Refaites un test en supprimant cette IP puis en retestant de vous connecter et vérifiez que l'IP est à nouveau bannie.

Résolution du problème

Pour résoudre le problème, cela se passe sur votre smartphone.

Tout d'abord fermez l'application.

Allez dans [Paramètres] > [Applis et notifications] > [Chrome] (ou le navigateur que vous utilisez) > [Espace de stockage et cache] puis cliquez sur [Forcer l'arrêt] puis sur la petite corbeille [Vider le cache].

Voilà, vous pouvez vous reconnecter sur Jeedom, le problème est normalement résolu !