Logo

Le plugin ne sera plus fonctionnel à partir du 28 Août 2023, date à laquelle Mercedes arrête l’API BRING YOUR OWN CAR (BYOC) utilisé dans ce plugin : Annonce de l’arrêt

Présentation

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.

Principe

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

Liste des véhicules supportés

Veuillez consulter la FAQ

Installation et configuration du plugin

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.

Création de l’application

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.

Ajout des APIs

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 :

Activation API

Cas particulier : API Vehicle Images

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 :

Configuration de l’application

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>

Configuration du plugin

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.

Création de votre véhicule dans Jeedom

Dans Jeedom, aller dans Plugins -> Objets connectés -> Mercedes Me

Configuration Equipement

Affichage sur le Dashboard

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.


Widget

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

Widget Tolltips

Rafraichissement

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.

Automatique

Une tâche CRON est automatiquement créée sur base du délai de 5 minutes.

Manuel

Dans un scénario, vous pouvez utiliser la commande Rafraichir afin de reforcer un refresh des informations.

Commandes

Il existe actuellement plusieurs commandes qui sont décrites ci-dessous :

Action

Infos

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 :

Nous utilisons des cookies pour vous garantir la meilleure expérience sur notre site web. Si vous continuez à utiliser ce site, nous supposerons que vous en êtes satisfait.