Plugin WeConnect (weconnect) - Sh0n/docs GitHub Wiki

⚠️ Avertissement ⚠️

❗❗❗Ce plugin est compatible uniquement avec python 3.8❗❗❗

Si vous n'êtes pas en mesure d'installer manuellement python 3.8 n'achetez pas ce plugin.

Jeedom tournant sur Debian 1O, la version de python est normalement la 3.7. Il est possible d'installer manuellement une autre version de python mais n'en faites pas la version par défaut de votre système au risque de perturber tous les autres plugins utilisant python 3.7.

Sur Debian 10, utilisez par exemple ce simple tuto : https://morioh.com/p/70d9c6c9a22c

Description

Le plugin WeConnect vous permet d'utiliser les informations et action des services Volkswagen WeConnect depuis votre Jeedom.

Ce plugin s'appuie sur la librairie python weconnect-cli de Till Steinbach.

Pré-requis

Pour pouvoir utiliser correctement le plugin WeConnect, il est nécessaire d'avoir au préalable créé un compte sur le site officiel Volkswagen. Pour en savoir plus, consulter le site officiel à l'adresse ci-dessous :

https://www.volkswagen.fr/fr/monter-a-bord/nos-solutions-connectees/we-connect/activation.html

Vous devez ensuite absolument télécharger l'application WeConnect ID, vous connecter une première fois avec vos identifiants et accepter les conditions générales d'utilisation.

Utilisation

Après installation, rendez-vous dans la configuration du plugin afin de remplir 2 champs essentiels au bon fonctionnement du plugin :

  • Adresse email : adresse email utilisée pour vous identifier sur le site WeConnect
  • Mot de passe : mot de passe utilisé pour vous identifier sur le site WeConnect

Un autre paramètre est disponible, Clé API Google Maps. Celle-ci est utile si vous souhaitez voir apparaitre sur votre Jeedom une carte Google Maps affichant la position de votre véhicule. Ce paramètre est facultatif à l'utilisation du plugin (utile uniquement pour la commande Carte).

Une fois ces informations renseignées, vous pouvez sauvegarder et créer un nouvel équipement.

Informations disponibles par défaut

Il existe une configuration commune à tous les véhicules. Celle-ci est suceptible d'évoluer et propose pour l'instant :

  • Modèle
  • Année
  • Kilométrage
  • Nom
  • Longitude
  • Latitude
  • Localisation (latitude,longitude)

Attention, la commande Localisation est une simple concaténation des commandes latitude et longitude. Elles doivent donc être activées et actualisées pour que celle-ci fonctionne.

Chaque véhicule dispose ensuite de ses propres commandes (info et action).

Fonctionnement des commandes de type info

Chaque commande de type info dispose de 3 paramètres :

  • Afficher : indique si la commande doit ou non être affichée
  • Historiser : indique si la valeur de la commande doit être historisée, utile si vous souhaitez faire des statistiques sur une donnée
  • Actualiser : indique si lors du refresh des données de l'équipement (refresh manuel ou via le cron) cette information doit être mise à jour

IMPORTANT : si vous ne cochez pas le paramètre Actualiser, la valeur de cette commande ne sera pas actualisée ! Cela permet de ne pas rafraîchir inutilement une commande (par exemple le modèle ou le nom du véhicule), ou au contraire de rafraîchir une valeur sans afficher celle-ci sur le dashboard (donc sans cocher le paramètre Afficher) mais pour pouvoir l'exploiter par ailleurs.

Véhicules compatibles et testés

(liste non exhaustive, voir plus bas)

  • Arteon
  • e-Golf
  • e-up!
  • Golf VII GTE
  • ID.3
  • ID.4
  • Passat GTE
  • Passat Variant GTE
  • Polo
  • Tiguan
  • Transporter

Cas particuliers

Certains véhicules ne répondent pas à la commande /model permettant automatiquement de détecter le modèle de véhicule et de lui associer les commandes dédiées. Pour palier à cela, inscrivez simplement le modèle dans le nom donné à votre véhicule (ex : Transporter de Sh0n).

Cette méthode est actuellement valable pour les modèles suivants :

  • Transporter

Ajout de la configuration d'un nouveau véhicule

Si votre véhicule ne dispose pas d'un fichier de configuration spécifique vous en serez informé lors de l'enregistrement de votre équipement. Si vous souhaitez l'ajout de votre véhicule, suivez les quelques étapes suivantes :

  • Activez le mode Debug dans la configuration des logs du plugin
  • Relancez un enregistrement de votre équipement
  • Rendez-vous dans les logs de Jeedom et relevez les deux lignes suivantes : FULL DATA & FULL DATA ACTION
  • Communiquez moi ces lignes via la plateforme Community de Jeedom en créant un nouveau sujet en n’oubliant pas de taguer le plugin

Bug report ou demande d'évolution ?

Pour tous problèmes rencontrés avec le plugin ou pour toute demande de modification/d'ajout de commande ou autre, vous pouvez consulter les sujets existants ou démarrer un nouveau post via la plateforme community Jeedom : Sujets WeConnect.

Je m'efforcerai de répondre dans les meilleurs délais à vos requêtes :)