Domoticz - vzwingma/domotique GitHub Wiki

L'IHM de gestion domotique est basée sur l'application Domoticz

La documentation en PDF

Scénarios

Des scénarios sont paramétrés pour piloter le domicile tout au long de la journée.

Le schéma suivant présente le diagramme de séquence de ces scénarios :

diagramme de séquence des scénarios

Scripts LUA

Conception

La page de description des scripts est ici

Installation des scripts

 mkdir -p ~/appli/domoticz/scripts/dzVents
 chmod 777 ~/appli/domoticz/scripts/dzVents

  • Copier les scripts LUA dans ~/appli/domoticz/scripts/dzVents

  • Dans Domoticz, ouvrir la page "User Variables", et ajouter les variables définies ci dessous :

Regarder les logs dans Domoticz pour vérifier qu'ils sont bien exécutés.

Scripts Python

Description

Certaines intégrations sont réalisées à partir de scripts python, pré-intégrés dans l'image docker de domoticz. C'est le cas pour l'intégration vers :

  • Linky (par le script Python ici)
  • l'application deCONZ (par le script Python ici)

Installation des scripts

Les scripts sont déjà présents dans l'image docker, ils sont injectés au moment de la construction via le DockerFile

Linky - Configuration

Dans Domoticz, il suffit d'ajouter le hardware Linky à la liste d'équipement tel que décrit dans la procédure d'installation ici

deCONZ - Configuration

Avant d'utiliser le plugin dans Domoticz, il faut d'abord générer une API Key. Pour cela :

  • Se connecter à la Gateway Phoscon

  • Dans Passerelle\Avancée\ cliquer sur Authentifier l'application

  • Dans un terminal, se connecter à l'image docker Domoticz :

     docker exec -it docker_domoticz_1 /bin/sh

    # cd /opt/domoticz/userdata/plugins/Domoticz-deCONZ/
    # python3 API_KEY.py domatique.local:9102 create

et vous obtenez l'API Key

  Your new API key is : 6C66FE0D7D
  • Remarque : Si vous obtenez le message d'erreur Please unlock the gateway first and retry !, vous devez retourner sur la GW Phoscon et recliquer sur Authentifier l'application

Maintenant, dans Domoticz, il suffit d'ajouter un nouveau matériel de type deCONZ Plugin et rentrer les informations de connexion et l'api key

deCONZ - Nettoyage des API Key

Il se peut qu'un message d'avertissement de ce type soit présent dans les logs :

        2022-03-13 13:16:02.127  Status: Phoscon GW: You have 20 API keys memorised, some of them are probably useless, can use the API_KEY.py tool or the Front end to clean them

Dans ce cas, la procédure est la suivante :

  • Dans Domoticz, dans la configuration du plugin Phoscon GW/DeCONZ Plugin, il est nécessaire de relever l'API Key actuellement utilisée par le plugin :

image

  • En ligne de commande, se connecter au conteneur domoticz, et aller dans le répertoire du plugin
     docker exec -it docker_domoticz_1 /bin/sh
     cd /opt/domoticz/userdata/plugins/Domoticz-deCONZ/
  • Lister toutes les API Key :
     python3 API_KEY.py domatique.local:9102 list 6C66FE0D7D

     KEY : 01854540DF Name : Phoscon#B1536x754 Last used : 2021-05-16T20:53:15
     KEY : 02CF44F191 Name : Phoscon#B1431x1030 Last used : 2022-02-13T21:04:51
     KEY : 26228693EA Name : Phoscon#B1536x754 Last used : 2021-09-14T10:49:52
     KEY : 29DA530D1D Name : Phoscon#B1536x754 Last used : 2021-11-30T07:11:20
     KEY : 30D43094C0 Name : Phoscon#B1536x754 Last used : 2021-10-10T14:39:02
     KEY : 33627DBDB1 Name : Phoscon#B1536x754 Last used : 2021-06-27T08:34:01
     KEY : 4564A7D88B Name : Phoscon#B1431x1030 Last used : 2022-03-13T13:51:33
     KEY : 57B9543A74 Name : Phoscon#B1536x754 Last used : 2021-07-26T11:39:56
     KEY : 64E40FFC21 Name : Phoscon#B1707x802 Last used : 2021-12-15T13:37:23
     KEY : 6C66FE0D7D Name : Domoticz Last used : 2022-03-13T13:51:35
     KEY : 6F8ECEA2B0 Name : Phoscon#B1536x754 Last used : 2021-06-23T19:46:05
     KEY : 8D6732D092 Name : Phoscon#B1431x1030 Last used : 2022-03-02T15:13:37
     KEY : 8DBB293238 Name : Phoscon#B1536x754 Last used : 2021-11-12T14:34:02
     KEY : 8E240AB264 Name : Phoscon#B1707x802 Last used : 2022-01-03T13:02:41
     KEY : 9AB7D9D0D9 Name : Phoscon#B1536x696 Last used : 2021-11-19T20:06:25
     KEY : 9FA83F82C6 Name : Domoticz Last used : 2021-05-17T17:04:47
     KEY : E087A45B83 Name : Phoscon#B1536x696 Last used : 2021-06-15T14:00:45
     KEY : F19057BFC1 Name : Phoscon#B1707x802 Last used : 2022-02-06T21:47:46
     KEY : F5BCBDE900 Name : Phoscon#B1536x754 Last used : 2021-08-25T13:23:05
     KEY : FD891B9FCF Name : Phoscon#B1536x754 Last used : 2021-05-17T20:27:58
  • Supprimer toutes les API Key inutiles SAUF
    • celle utilisée actuellement par Domoticz : Domoticz Last used
    • la dernière utilisée actuellement par Phoscon : Phoscon#B1431x1030 Last used
     python3 API_KEY.py domatique.local:9102 delete 6C66FE0D7D <nom de l'API Key à supprimer>
  • Relister toutes les API Key :
     python3 API_KEY.py domatique.local:9102 list 6C66FE0D7D

     KEY : 4564A7D88B Name : Phoscon#B1431x1030 Last used : 2022-03-13T14:15:00
     KEY : 6C66FE0D7D Name : Domoticz Last used : 2022-03-13T14:15:00

Installation docker

L'image docker de DomoticZ dépoyable sur arm est disponible sur DockerHub.

Le fichier docker-compose pour créer le conteneur est docker-compose.yml.

Le script de démarrage est re_start-domotique.sh