Le plugin n’est plus fonctionnel à partir du 28 Août 2023, date à laquelle Mercedes à arrêté l’API BRING YOUR OWN CAR (BYOC) utilisé dans ce plugin : Annonce de l’arrêt
Ce plugin a pour but de permettre de récuperer dans Jeedom les informations de sa Mercedes. Il se base sur les API misent à disposition par Mercedes à l’adresse https://developer.mercedes-benz.com
Actuellement Mercedes ne propose pas encore beaucoup de possibilitées avec son API BRING YOUR OWN CAR (BYOC) (tout du moins, moins qu’avec l’application Mobile) mais il évoluera au mieux possible.
Mercedes propose uniquement une méthode Cloud d’interraction avec votre voiture, par conséquent ce plugin utilise une connexion internet pour interragir avec celle-ci.
C’est donc une interface CLOUD
Installer le plugin sur votre Jeedom et activez le.
Afin de permettre au plugin de collecter les informations sur le Cloud Mercedes, un certains nombre de droits doivent être défini sur votre compte Mercedes. Pour cela, connectez-vous sur https://developer.mercedes-benz.com avec votre compte mercedes utilisé sur l’application mobile.
Aller dans la console et créez une nouvelle application avec le bouton “+ ADD NEW APP” Les champs sont a remplir ainsi :
Il devrait a partir de là, vous afficher l’APP ID.
Se rendre à l’adresse dans la liste des API. La liste des API a activer sont :
Pour activer les API, il faut procéder ainsi :
Il faut aussi activer l’API :
Cependant cette API ne fait pas parti de BYOC et donc son activation est un peu différente car c’est en fait une version d’essai limité à 5 tentatives.
Le plugin utilise cette API pour afficher une image de votre voiture sur l’équipement Jeedom.
Dans le cas où l’image ne pourrait être récupéré lors de cette version d’essai, elle est remplacé par une image standard (placeholder).
Pour activer cette API :
Aller dans la console et editez le champ Redirect URLs afin de remplacer le https://localhost
Vous trouverez l’url à y saisir dans le champs Redirect URLs de la configuration du plugin.
Format de l’URL :
https://<votre IP ou DNS public>:<port>/plugins/Mercedes_me/core/php/callback.php?apikey=<API Key>
Rendez-vous dans la page de configuration du plugin Mercedes Me et remplissez les champs :
Cliquez sur Sauvegarder pour enregistrer les informations saisies puis sur le bouton Activer/Refaire la connexion Mercedes
ATTENTION : Il faut absulument être connecté au travers de son IP/URL externe Jeedom afin de pouvoir activer ou refaire la connexion Mercedes.
Dès lors le plugin va établir la communication avec le Cloud Mercedes. Pour cela il utilise le protocole OAUTH2 qui necessite que vous saisissiez votre identifiant et mot de passe Mercedes ainsi que vous acceptiez l’utilisation des API en les cochant (fait une seule fois normalement à moins qu’une API ai était ajouté).Vous êtes ensuite redirigé à nouveau vers la configuration du plugin.
A partir de la, vous avez désormais dans la partie Debug, les informations montrant que la connexion est bien active et opérationnelle.
Dans Jeedom, aller dans Plugins -> Objets connectés -> Mercedes Me
Le plugin inclus un widget qui vous donne visuellement un retour sur les informations récoltés
Afin d’avoir l’image personnalisé de votre véhicule sur le widget, il faut lancer la commande Telecharger Vehicule Image qui la récupèrera et la stockera dans le plugin.
ATTENTION : Le récupération automatique n’est pour le moment pas activé car Mercedes limite à 5 requêtes par véhicule la récupération d’image. Afin d’eviter les échecs et atteindre la limite, je laisse l’utilisateur la récupérer manuellement quand il considère que le plugin est opérationnel.
Afin de profiter des couleurs, il vous faut avoir l’option Icônes widgets colorées active dans la configuration de votre Jeedom
Réglages > Système > Configuration > Interface > Tuile
Les fenêtres et Toit ouvrant / Capote pouvant avoir des statuts plus précis que ouvert ou fermé, vous avez le detail en placant la souris sur l’icône correspondant
Une particularité du Cloud Mercedes est :
Par conséquent, pour recevoir une valeur, il faut qu’il y ai eu un changement d’état dans les 12h précédente. Donc a l’installation du plugin, il se peut que vous ne récupériez pas l’ensemble des informations. Dans ce cas, si vous le souhaitez, je vous invite a ouvrir toutes les portes, fenêtres, capotes, toit ouvrant et rouler un peu pour récupérer les informations de charge (si voiture electrique) ou de carburant.
Une tâche CRON est automatiquement créée sur base du délai de 5 minutes.
Dans un scénario, vous pouvez utiliser la commande Rafraichir afin de reforcer un refresh des informations.
Il existe actuellement plusieurs commandes qui sont décrites ci-dessous :
La plupart des commandes d’informations sont des commandes qui retourne un résultat binaire (0 : Non-Fermé / 1 : Oui-Ouvert) sauf informtion contraire ci-dessous :