[Intégration externe] Volvo : votre voiture dans Gladys

Développement
1

Bonjour à tous,

Je vous présente gladys-volvo, une intégration externe qui amène votre Volvo dans Gladys grâce aux API officielles de Volvo Cars. Elle s’inspire de l’intégration Volvo de Home Assistant, adaptée aux catégories « véhicule électrique » de Gladys.

Ce que vous obtenez

  • Un appareil par voiture de votre compte Volvo ID, avec ce que votre voiture transmet réellement :
    • batterie, autonomie et état de la charge (électriques et hybrides rechargeables) ;
    • carburant et autonomie (thermiques et hybrides) ;
    • kilométrage, verrouillage (pilotable depuis Gladys), portes, hayon, capot, fenêtres, toit ouvrant ;
    • climatisation à distance ;
    • entretien (distance et délai), alertes (pneus, niveaux, ampoules) et distance du domicile.
  • Des scènes :
    • verrouillée ou déverrouillée ;
    • verrouillée mais une fenêtre est restée ouverte ;
    • moteur démarré ou arrêté ;
    • charge terminée, câble branché ou débranché ;
    • arrivée ou départ de la maison (pour ouvrir le portail, par exemple) ;
    • nouvelle alerte.

Chaque déclencheur fournit un résumé prêt à envoyer en notification.

  • Des actions de scène : verrouiller, déverrouiller, climatiser, faire clignoter, démarrer le moteur (selon le modèle), ou récupérer l’état complet de la voiture.
  • Un widget de tableau de bord avec la photo de votre voiture (modèle et couleur exacts), batterie ou carburant, autonomie, état des ouvrants et boutons rapides : verrouiller, climatiser, faire clignoter, voir sur la carte.

Prérequis

  • Une Volvo à partir de 2010 dont l’application Volvo Cars fonctionne (Europe, Amérique du Nord, etc.).
  • Un compte gratuit sur le portail développeur Volvo. Il faut y créer et « publier » une application pour obtenir une clé d’API et un identifiant client. Comptez une dizaine de minutes, tout est expliqué pas à pas dans la documentation.
  • Gladys 5.1.1 ou plus récent.

Bon à savoir

  • Volvo n’envoie rien en temps réel : la voiture est lue toutes les 5 minutes par défaut (réglable).
  • Volvo limite dans le temps l’autorisation d’une application personnelle. Quand elle expire, Gladys vous prévient (il y a même un déclencheur de scène pour ça) et il suffit de recliquer sur « Connecter ».

:open_book: Documentation : https://github.com/William-De71/gladys-volvo/blob/main/docs/fr.md
:laptop: Code source : https://github.com/William-De71/gladys-volvo

Appel aux testeurs : Si vous avez une Volvo (électrique, hybride ou thermique), vos retours m’intéressent beaucoup : ce qui fonctionne, ce qui manque, les éventuelles erreurs dans les journaux de l’intégration.

Merci d’avance ! :automobile: