Instruments personnalisés

Chaque compteur personnalisé possède un script. main() dans le script est l'entrée de dessin et renvoie un écran composé de View intégré : Text affiche le texte, Circle dessine des cercles, LineChart affiche des courbes et le conteneur de mise en page est responsable de l'organisation de ce contenu.

Le script peut obtenir la vitesse actuelle, la vitesse de rotation (RPM) et d'autres lectures dans main(), calculer le nombre, la couleur ou l'angle à afficher, puis renvoyer le résultat sous forme de contenu et d'attributs de View. Par exemple, après avoir lu la vitesse, vous pouvez soit écrire la valeur dans Text, soit la convertir en angle d'arc de Circle.

CapDrive appellera à nouveau main() lorsqu'il devra mettre à jour l'écran et dessiner le résultat renvoyé. Le code de l'instrument n'a besoin que de décrire l'écran en fonction de cette entrée, et l'animation des attributs est également exécutée par la fin du dessin. Les ressources d'images peuvent être enregistrées avec l'instrument et utilisées par nom de ressource dans le code.

Les instruments sont importés et partagés via des fichiers .instrument. Les fichiers existants peuvent être ouverts à partir de Importer un instrument dans le menu de l'instrument personnalisé, ou les fichiers peuvent être ouverts à l'aide de CapDrive. Les œuvres importées doivent être ajoutées au tableau de bord séparément.

Les instruments importés sont enregistrés dans Plus（…）→ Instruments personnalisés. Sélectionnez-le via Plus（…）→ Modifier le tableau de bord → + et cliquez sur OK pour l'afficher sur le tableau de bord.

Les travaux qui utilisent des paramètres de véhicule devront également sélectionner leurs propres paramètres de véhicule dans Réglages de l’instrument → Liaisons d’entrée pour l'entrée OBD existante. Garder l'identifiant d'entrée inchangé vous permet d'hériter du code de l'œuvre sans écrire l'identifiant de l'appareil dans le script.

Sélectionnez Ajouter un instrument dans Plus（…）→ Instruments personnalisés pour accéder à l'éditeur. La zone d'édition permet d'écrire main() et View ; cliquez sur le nom en haut pour définir le nom de l'instrument, les liaisons d'entrée et d'autres options. L'équipement ouvre Configuration des paramètres, qui peut gérer six types d'entrées : valeur numérique, texte, interrupteur, élément de sélection, données de base et données OBD. Le nouveau compteur dispose déjà d'une entrée de vitesse de base avec l'identifiant speed.

Vous pouvez prévisualiser le texte, la mise en page, les graphiques et les animations à tout moment pendant l'édition. L'aperçu fournit une entrée analogique pour une vérification facile des instruments en stationnement. Lorsqu'une erreur de code se produit, elle peut être localisée à partir du numéro de ligne dans le journal. Après avoir enregistré, ajoutez le compteur au tableau de bord pour utiliser les lectures réelles.

« First Speed ​​​​​​Gauge » fournit un code complet et une description ; la référence API répertorie les View, les propriétés, les types et les interfaces d'exécution disponibles.

$data fournit la lecture actuelle et les échantillons récents au script. Les champs de base tels que la vitesse et la distance peuvent être directement utilisés pour l'affichage numérique ; des paramètres tels que la vitesse du véhicule (RPM) et la température du liquide de refroidissement sont fournis via le dispositif OBD configuré. Le script peut également générer des courbes à l'aide d'un échantillonnage historique.

Chaque fois que main() est exécuté, les champs obligatoires sont lus, les valeurs sont traitées et View est généré. Les lectures peuvent être temporairement indisponibles, le code d'affichage doit donc fournir un contenu approprié pour les mesures manquantes. Les documents de données d'instrument décrivent de manière centralisée la structure des champs, les références OBD, l'échantillonnage historique et la gestion des valeurs nulles.