Véhicules

Le skill Véhicules fait de votre voiture un appareil du contrôleur nomos system : niveau de charge et autonomie, charge, portes et fenêtres, kilométrage et position — et, dans la mesure où la voiture le permet, la charge, la climatisation, le chauffage auxiliaire et la ventilation à commander. Les valeurs sont disponibles dans les pièces, les automatisations et les lieux comme celles de tout autre appareil.

Aujourd'hui, le skill prend en charge Škoda via l'interface de l'application MyŠkoda. D'autres marques viendront s'ajouter dans le même skill : vous choisirez alors une autre marque pour l'accès, tout le reste restant identique. Vous pouvez ajouter autant de véhicules que vous le souhaitez, y compris de marques différentes.

WARNING

Avant de commencer : il vous faut une Clé API de l'application MyŠkoda (à partir de la version 8.16). Créez-la sous Profil › Clés API et sélectionnez les véhicules pour lesquels elle doit valoir. La clé permet de lire les données de ces véhicules et d'envoyer les commandes que le véhicule concerné propose ; le verrouillage et le déverrouillage n'en font pas partie. Sa validité est limitée. Traitez-la comme un mot de passe : le contrôleur l'enregistre et ne l'affiche plus jamais.

Ajouter un accès

Un accès est une clé API. Une clé peut couvrir plusieurs véhicules ; lorsqu'elle expire, vous la renouvelez une seule fois sur l'accès, et non sur chaque véhicule.

1. Activez le skill Véhicules.
2. Cliquez sur Ajouter un accès.
3. Choisissez la Marque, saisissez si vous le souhaitez une Désignation, par exemple « Famille », et collez la Clé API. Sous le champ, Ouvrir mène aux instructions du constructeur.
4. Cliquez sur Enregistrer.

À l'enregistrement, le contrôleur ne vérifie pas encore la clé ; il le fait lorsque vous ajoutez le premier véhicule. Dès la première réponse du constructeur, la page affiche pour l'accès Valable jusqu'au avec la date d'expiration de la clé.

Ajouter un véhicule

Dès qu'un accès existe, Ajouter un véhicule apparaît. L'assistant comporte trois étapes :

1. Accès — Choisissez l'accès dont la clé couvre le véhicule et cliquez sur Suivant. S'il n'y en a qu'un, il est présélectionné. Les accès expirés ou refusés ne peuvent pas être choisis.

2. Numéro d'identification du véhicule (VIN) — Il figure sur le certificat d'immatriculation et dans l'application MyŠkoda : 17 caractères, lettres et chiffres sans I, O ni Q. Les espaces et les minuscules sont corrigés. Vérifier interroge le véhicule une fois ; cela compte comme une requête au véhicule (voir Mises à jour et quota).

3. Résultat — Le contrôleur affiche l'image du véhicule si le constructeur en fournit une, la Motorisation (Électrique, Hybride rechargeable ou Thermique), le VIN et, sous Fonctions détectées, ce que le véhicule sait faire, par exemple Batterie, Charge, Profils de charge, Statut, Position, Kilométrage et Climatisation. En dessous, vous saisissez :

   • Nom — prérempli avec le nom que porte le véhicule dans l'application MyŠkoda. En dessous, vous choisissez la pièce.
   • Plaque d'immatriculation — facultative, 16 caractères au maximum, préremplie si le constructeur la transmet. Elle sert uniquement à l'affichage.
   • Afficher la position — voir Position.
   • S-PIN — uniquement pour les véhicules avec chauffage auxiliaire, facultatif ; voir S-PIN.

   Ajouter crée le véhicule ; à partir de là, le contrôleur l'interroge régulièrement.

Les fonctions d'un véhicule sont fixées lors de son ajout. Messages possibles lors de la vérification :

• « Le véhicule n'a pas encore transmis toutes ses données. Veuillez réessayer dans quelques minutes. » — Une partie manquait momentanément dans la réponse. Plutôt que de créer le véhicule avec trop peu de fonctions, le contrôleur refuse. Attendez quelques minutes et vérifiez à nouveau.
• « L'accès ne couvre pas ce VIN. » — Sélectionnez le véhicule pour la clé dans l'application MyŠkoda, ou prenez l'accès qui le couvre.
• « La clé API a expiré. » ou « La clé API a été refusée. » — Renouvelez l'accès (voir Expiration de la clé API).
• « Trop de demandes envoyées au véhicule. De nouveau possible à … » — Le quota de l'heure est épuisé.

Un véhicule déjà ajouté ne peut pas l'être une seconde fois : « Ce véhicule a déjà été ajouté. »

L'aperçu

Chaque accès a sa propre section avec la marque, la désignation et Valable jusqu'au. Une étiquette à côté de la marque indique son état : Expire bientôt (à partir de 14 jours avant l'expiration), Expiré ou Refusé ; en haut de la page, une bannière le résume : « Un accès expire bientôt. » ou « Un accès a expiré ou a été refusé. Renouvelez sa clé. » À droite se trouvent Renouveler la clé et le × pour supprimer.

En dessous suivent les véhicules de l'accès sous forme de tuiles, avec la marque et la plaque d'immatriculation, par exemple « Škoda · GE 123456 ». Sous chaque tuile se trouvent des boutons dont le nom apparaît au survol :

• Profils de charge — uniquement si le véhicule transmet des profils de charge,
• S-PIN — uniquement pour les véhicules avec chauffage auxiliaire,
• Paramètres — plaque d'immatriculation et position,
• Diagnostic — mises à jour et quota.

Les valeurs du véhicule

Un véhicule est un appareil avec un composant. Il ne reçoit que les valeurs qu'il a transmises lors de son ajout ; l'application et la configuration les classent en quatre groupes :

• Charge — État de charge, Prise connectée, Prise verrouillée, Puissance de charge, Type de charge (AC ou DC), Temps de charge restant, Entièrement chargé à et Courant de charge. Se commandent Chargement, Limite de charge (de 50 à 100 % par pas de dix) et Mode de charge (uniquement les modes que la voiture propose). Avec les profils de charge s'ajoutent Profil de charge (le profil à l'emplacement actuel) et Prochaine heure de charge.
• Climatisation — Climatisation (commandable), État de la climatisation, Setpoint (de 16 à 30 °C) et Dégivrage des vitres ; pour les véhicules avec chauffage auxiliaire Chauffage auxiliaire et Durée du chauffage auxiliaire (de 10 à 60 minutes), avec ventilation Ventilation.
• Véhicule — Batterie (niveau de charge en pour cent) et Autonomie ; pour les véhicules thermiques et hybrides rechargeables Niveau de carburant, Autonomie carburant et Autonomie AdBlue ; Verrouillé, Portes, Fenêtres, Coffre, Capot, Toit ouvrant et Feux ; Kilométrage, Motorisation et Dernière mise à jour — quand la voiture a transmis des données pour la dernière fois. L'action Rafraîchir interroge la voiture immédiatement.
• Position — Stationné, Latitude, Longitude et Adresse.

Si la voiture ne transmet pas une valeur, la dernière valeur transmise reste affichée ; une valeur manquante n'est jamais affichée comme 0.

Commandes

La voiture ne confirme une commande qu'à la mise à jour suivante. Le contrôleur vérifie donc au bout d'une et de trois minutes. Les valeurs commandables affichent toujours ce que la voiture transmet, et non ce qui a été demandé ; jusqu'à la confirmation, la commande figure dans le diagnostic sous Commande en cours. Si la voiture n'a toujours pas confirmé au bout de trois minutes, la commande expire sans message — les voitures refusent aussi à juste titre, par exemple la charge lorsque la limite de charge est atteinte.

• Setpoint et Durée du chauffage auxiliaire sont mémorisés et envoyés au prochain démarrage de la climatisation ou du chauffage auxiliaire ; tant que la voiture ne les transmet pas, l'appareil affiche la valeur demandée. Sans valeur de votre part, le chauffage auxiliaire fonctionne 30 minutes.
• Par véhicule, les commandes s'exécutent l'une après l'autre. Une nouvelle commande pour la même valeur remplace celle qui attend encore.
• Si une commande ne peut pas être exécutée, vous recevez une notification, par exemple « Le véhicule ne prend pas en charge cette fonction. », « Le véhicule n'accepte pas de commandes pour le moment. », « Enregistrez d'abord le code S-PIN pour le chauffage auxiliaire. » ou « Trop de demandes envoyées au véhicule. De nouveau possible à … ». Le même message arrive au plus toutes les 15 minutes par véhicule.

Paramètres

Sous Paramètres, vous modifiez la Plaque d'immatriculation et activez ou désactivez Afficher la position.

Position

« La position et l'adresse du véhicule sont publiées sur le composant et peuvent être utilisées dans des automatisations. » C'est le réglage par défaut. Si vous désactivez Afficher la position, le contrôleur vide Latitude, Longitude et Adresse et ne les écrit plus ; Stationné reste. Le réglage s'applique par véhicule.

Škoda ne transmet la position que lorsque la voiture est stationnée. Pendant un trajet, la dernière position de stationnement reste affichée.

S-PIN

Pour le chauffage auxiliaire, Škoda exige le S-PIN, le code de sécurité à quatre chiffres de votre compte MyŠkoda. Vous pouvez le saisir lors de l'ajout ou plus tard via S-PIN sur la tuile. Le dialogue affiche S-PIN enregistré ou Aucun S-PIN enregistré ; saisissez le S-PIN et cliquez sur Enregistrer, ou supprimez-le avec Supprimer le S-PIN. « Le S-PIN est nécessaire pour le chauffage auxiliaire. Il est enregistré sur le contrôleur et n'est plus jamais affiché. » Sans S-PIN, le chauffage auxiliaire ne peut pas être démarré.

Profils de charge

La voiture enregistre des profils de charge par emplacement, par exemple pour la maison et le travail. Profils de charge affiche les profils du véhicule ; le profil à l'emplacement de la voiture porte la mention Emplacement actuel. Un clic l'ouvre, et vous modifiez ce que la voiture transmet pour lui :

• Charge cible et Charge minimale, avec Charger immédiatement sous le minimum,
• Courant de charge — Réduit ou Maximal,
• Déverrouiller la prise après la charge,
• Heures de charge préférées — des plages horaires, chacune avec Actif, début et fin,
• Minuteries de départ — chacune avec Actif, heure et Une fois (avec un jour de la semaine) ou Hebdomadaire (avec des jours de la semaine).

Il n'est pas possible de créer ou de supprimer des profils ici. Après Enregistrer, le dialogue affiche Transfert en cours … jusqu'à ce que la voiture ait confirmé la modification. « Ce véhicule ne permet pas de modifier les profils de charge. » signifie que la voiture affiche ses profils, mais n'accepte aucune modification. L'ouverture du dialogue et chaque enregistrement coûtent chacun une requête.

Diagnostic

Diagnostic affiche Requêtes restantes, Le quota se renouvelle à, Dernière mise à jour (la dernière interrogation par le contrôleur), Échecs consécutifs et Commande en cours. Sous Signalé par le véhicule, vous voyez pour chaque domaine quand la voiture l'a transmis pour la dernière fois — les domaines d'une voiture ont souvent des âges différents. Si l'accès ne couvre plus le véhicule, il est indiqué « L'accès ne couvre plus ce véhicule. » Actualiser recharge l'affichage sans interroger la voiture.

Mises à jour et quota

Škoda autorise 20 requêtes par heure et par véhicule. Le contrôleur les répartit ainsi :

• Il interroge la voiture toutes les 15 minutes, toutes les 5 minutes tant qu'elle charge, climatise, chauffe, ventile ou roule.
• Il réserve quatre requêtes par heure aux commandes. S'il ne reste plus que celles-ci, la mise à jour régulière attend le renouvellement du quota.
• Chaque commande coûte une requête, plus une ou deux pour la confirmation. Vérifier lors de l'ajout ainsi que l'ouverture et l'enregistrement des profils de charge coûtent également une requête chacun.
• Rafraîchir interroge immédiatement si le quota le permet. Si la dernière mise à jour date de moins d'une minute, les données actuelles restent.
• Après un redémarrage du contrôleur, les mises à jour démarrent de façon échelonnée ; si la dernière date de moins de cinq minutes, la première attend en conséquence.

Des données anciennes ne rendent pas une voiture injoignable : une voiture stationnée qui est en veille ne transmet que rarement. Elle devient injoignable si la clé a expiré ou a été refusée, si la clé ne couvre plus le véhicule ou si trois mises à jour échouent d'affilée.

Comme le contrôleur n'interroge la voiture que toutes les 5 à 15 minutes, les valeurs arrivent elles aussi avec ce délai — tenez-en compte dans les automatisations.

Expiration de la clé API

Le contrôleur vous rappelle l'expiration de la clé par une notification 14 jours avant, 3 jours avant (avec une priorité élevée) et à l'expiration, par exemple « L'accès « Famille » expire dans 14 jours. Créez une nouvelle clé API et renouvelez l'accès. » Une fois la clé expirée ou refusée, le contrôleur cesse d'interroger les véhicules de l'accès, et ceux-ci deviennent injoignables. Si vous désélectionnez un véhicule pour la clé dans l'application MyŠkoda, le contrôleur signale « L'accès ne couvre plus ce véhicule. Vérifiez les véhicules sélectionnés pour la clé API. »

Pour renouveler l'accès :

1. Créez dans l'application MyŠkoda une nouvelle clé API pour les mêmes véhicules.
2. Cliquez sur Renouveler la clé pour l'accès, collez la nouvelle clé et cliquez sur Enregistrer.

Le contrôleur interroge aussitôt à nouveau tous les véhicules de l'accès. Les véhicules, les pièces et les automatisations restent inchangés.

Supprimer des véhicules et des accès

Vous supprimez un véhicule comme tout autre appareil ; le contrôleur supprime en même temps son S-PIN et ses paramètres. Vous supprimez un accès avec le ×, mais seulement lorsqu'il n'a plus de véhicules : « Supprimez d'abord les véhicules de cet accès ».

Les véhicules dans les lieux et les automatisations

Lieux : Avec la position activée, le véhicule apparaît parmi les appareils avec position des lieux. Vous obtenez ainsi des déclencheurs comme « la voiture arrive au travail » ou « la voiture quitte le domicile », et avec la valeur Quelqu’un est sur place du lieu « À la maison », la voiture peut servir d'entrée dans la détection de présence. Si la position est désactivée, le véhicule reste là où il était en dernier, et la liste affiche aucune position actuelle.

Automatisations : Toutes les valeurs du véhicule peuvent servir de déclencheur et de condition ; comme actions, vous pouvez régler Chargement, Limite de charge, Mode de charge, Climatisation, Setpoint, Chauffage auxiliaire, Durée du chauffage auxiliaire, Ventilation et Rafraîchir. Exemples :

• les jours ouvrables à 6 h 45, activer la Climatisation si la voiture est à la maison,
• envoyer un message lorsque Batterie passe sous 20 % et que Prise connectée est désactivé,
• le soir, envoyer un message si la voiture est à la maison et que Verrouillé est désactivé.

Chaque commande coûte une requête du quota. Ne laissez donc les automatisations se déclencher qu'au changement (Déclenche seulement au changement de valeur) et non à chaque nouvelle valeur.