2. Installation fr FR - vingerha/gazpar_2_mqtt GitHub Wiki

1. MQTT Broker

Assurez-vous d'avoir MQTT installé et de connaître les détails de connexion / identifiants.

2. Configuration alternative : utiliser docker-compose

C'est la configuration la plus simple et permet d'exécuter un script unitairement et quotidiennement au lieu de garder un conteneur Docker en fonctionnement toute la journée, consommant du CPU/de la mémoire. Notez que GRDF ne met à jour qu'une fois par jour. Ce qui suit suppose une configuration sur une machine Unix/Linux

  1. créez un dossier à un emplacement qui vous convient. par exemple, ci-dessous, le dossier est supposé : /home/docker/gazpar_2_mqtt
me@ha:~/docker/gazpar_2_mqtt_2$ ls -la
total 0
drwxrwxrwx 1 root root   4096 Apr 28 17:47 .
drwxrwxrwx 1 root root   4096 Apr 25 18:23 ..
  1. créez un fichier docker-compose.yml
me@ha:~/docker/gazpar_2_mqtt_2$ ls -la
total 112
drwxrwxrwx 1 root root   4096 Apr 28 17:47 .
drwxrwxrwx 1 root root   4096 Apr 25 18:23 ..
-rwxrwxrwx 1 root root   1909 Apr 28 17:42 docker-compose.yml
  1. modifiez les paramètres pour qu'ils correspondent à votre situation, exemple minimal Remarque : MQTT nécessite généralement des paramètres de connexion, d'où leur utilisation dans l'exemple ci-dessous, mais cela peut différer de votre situation 
version: '3.5'
services:
  gazpar2mqtt:
    container_name: gazpar_2_mqtt
    image: vingerha/gazpar_2_mqtt:latest
    tty: true
    restart: unless-stopped
    environment:
      # obligatoire :
      GRDF_USERNAME: [email protected]
      GRDF_PASSWORD: gazou_password
      MQTT_HOST: hôte (ou utilisez l'adresse IP)
      TZ: Europe/Paris
      STANDALONE_MODE: 'True'
      # facultatif
      MQTT_PORT: '1883'
      MQTT_TOPIC: 'gazpar'
      MQTT_CLIENTID: 'gazou'
      MQTT_USERNAME: 'votre_nom_d_utilisateur_mqtt'
      MQTT_PASSWORD: 'votre_mot_de_passe_mqtt'
    volumes:
      - ./:/data
      - ./app:/app

Pour plus de détails, veuillez consulter les paramètres de docker compose

  1. Exécutez docker-compose, pour Ubuntu, cela ressemble à :
docker-compose run --rm gazpar2mqtt

un sous-dossier app sera créé automatiquement ainsi que la base de données sqlite

me@ha:~/docker/gazpar_2_mqtt_2$ ls -la
total 180
drwxrwxrwx 1 root root   4096 Apr 28 17:47 .
drwxrwxrwx 1 root root   4096 Apr 25 18:23 ..
drwxrwxrwx 1 root root   4096 Apr 28 16:24 app
-rwxrwxrwx 1 root root   1909 Apr 28 17:42 docker-compose.yml
-rwxrwxrwx 1 root root 102400 Apr 28 16:25 gazpar2mqtt.db
  1. Débogage Si ce qui précède ne génère pas de topic dans MQTT, vous pouvez essayer d'ajouter DEBUG pour obtenir plus d'informations sur les blocages. Pour cela, ajoutez DEBUG: 'True' à la section environment du fichier docker-compose.yml

3. Configuration alternative : Docker

Cette configuration suppose que les paramètres doivent être détaillés dans le fichier param.py. Cela permet un réglage plus fin que la configuration "docker-compose".

  • créez un dossier ~/docker/gazpar_2_mqtt à mapper au volume du conteneur
  • dans ce dossier, créez un dossier app (~/docker/gazpar_2_mqtt/app)
  • exécutez la commande docker ci-dessous, la toute première fois, elle copiera tous les fichiers nécessaires dans ~/docker/gazpar_2_mqtt/app
  • il plantera alors car il n'a pas les informations d'identification
  • modifiez le param.py pour qu'il corresponde à l'adresse IP/port GRDF et MQTT et (si nécessaire) aux informations d'identification MQTT
  • redémarrez le conteneur Emplacement Docker

Exemple de commande docker run, en supposant que param.py contient les informations d'identification:

docker run --name gazpar_2_mqtt -v ~/docker/gazpar_2_mqtt/app:/app -v ~/docker/gazpar_2_mqtt:/data --tty vingerha/gazpar_2_mqtt:latest

4. Add-on HASSIO & HAOS

Pour installer l'addon :

  • Allez dans : Paramètres > Add-ons > Boutique d'addons.
  • Cliquez sur les 3 points en haut à droite pour ajouter un nouveau dépôt.
  • Utilisez https://github.com/vingerha/gazpar_2_mqtt pour charger l'addon.
  • Actualisez l'écran pour que l'addon s'affiche, puis ouvrez-le et cliquez sur : Installer. Cela peut prendre plus de 10 minutes.
  • Après l'installation, démarrez-le. Initialement, il plantera car il n'a pas de configuration valide.
  • Utilisez l'éditeur vscode ou un éditeur de fichiers pour modifier le fichier config.yaml dans /config/gazpar_2_mqtt (ou /homeassistant/gazpar_2_mqtt). Notez que le fichier doit être propre, sans lignes commentées ou des commentaires. Exemple :
GRDF_USERNAME="votre_nom_d'utilisateur_habituellement_un_email"
GRDF_PASSWORD="votre_mot_de_passe"
MQTT_HOST=192.168.x.y
MQTT_USERNAME=nom_d'utilisateur_mqtt
MQTT_PASSWORD=mot_de_passe_mqtt
MQTT_TOPIC=gazpar_haos
MQTT_CLIENTID=gazpar_client_haos
HASS_DISCOVERY=True
HASS_PREFIX=homeassistant
HASS_DEVICE_NAME=gazpar
SCHEDULE_TIME=06:30
DEBUG=True

Ajouter une ligne vide à la fin

HAOS et mqtt local / ailleurs Notez que par defaut, l'addon essaiera de trouver un serveur MQTT local et ignorera ensuite les paramètres MQTT ci-dessus. Si MQTT est extérieur de HAOS, désactiver la recherche 'auto-discover' dans le config de l'addon image

Vous pouvez omettre MQTT_HOST et MQTT_PASSWORD dans les options de l'addon si le MQTT est installé local dans HAOS.

Les différents paramètres se trouvent dans les paramètres docker compose

  • Redémarrez l'addon pour prendre en compte ce qui précède.

5. Natif OS / standalone (pas encore disponible)

Comme gazpar_2_mqtt est construit sur Python, on pourrait théoriquement l'exécuter en dehors d'un conteneur. Cependant, cela nécessite que tous les composants logiciels soient installés et fonctionnent correctement, par exemple Selenium et Chromium (Dockerfile pour les détails) À l'heure actuelle, tout cela est à votre propre discrétion et aucun support ne sera fourni car cela diffère selon le type/la version du système d'exploitation

⚠️ **GitHub.com Fallback** ⚠️