Présentation de l'interface utilisateur de VS Code pour la V5

Cet article est une présentation de l'interface utilisateur de l'extension de code VEX Visual Studio (interface utilisateur). L'extension prend en charge le développement de projets C++ et Python pour les plateformes VEX IQ 2e génération, EXP et V5.

image48.png

Composants de l'interface utilisateur

L'extension de code VEX VS comporte 3 composants principaux.

  1. Barre d'outils
  2. Barre d'activité et barre latérale
  3. Panneau à bornes

Barre d'outils

La barre d'outils offre aux utilisateurs un moyen rapide d'interagir avec les projets d'extension VEX VS Code , VEX Brains et VEX Controllers. La barre d'outils n'est active que lorsqu'un projet VEX valide est ouvert dans VS Code. Un projet VEX valide est un projet créé ou importé par l'extension. L'ouverture d'un projet VEXcode ou VEXcode Pro n'est pas valide et devra être importée.

image2.png

Sélecteur de périphérique

image60.png

Le sélecteur de périphérique a deux fonctions principales. Tout d'abord, il affiche une icône de cerveau ou de contrôleur représentant le type de périphérique VEX connecté.

image41.png

Deuxièmement, lorsque vous cliquez sur l'icône de la liste des appareils, une liste de sélection rapide apparaît avec tous les appareils VEX connectés. L'utilisateur peut sélectionner à quel appareil l'extension se connectera.
L'appareil actuellement connecté apparaîtra toujours en haut de la liste, suivi de tous les autres appareils triés par type d'appareil (cerveau ou contrôleur) et plate-forme (IQ 2e génération, EXP et V5).

image4.png

Chaque élément de périphérique contient les informations relatives au nom du cerveau, à la plate-forme, au type de périphérique et au chemin du périphérique.

image8.png

image56.png

Important

Si un contrôleur est connecté à un ordinateur, mais n'a pas de liaison radio avec un cerveau, aucun nom de cerveau ne sera affiché à côté de l'élément de liste ou de l'icône de la barre d'état de la liste des appareils.

Sélecteur d'emplacement

image19.png

L'icône de sélection d'emplacement permet à l'utilisateur de choisir sur quel emplacement l'extension téléchargera ou exécutera un programme utilisateur.

image43.png

Lorsque vous cliquez sur l'icône de sélection d'emplacement, une liste de sélection rapide apparaît avec les emplacements de programme utilisateur disponibles 1 à 8.

Créer/Télécharger

image5.pngimage6.png

L'icône Construire/Télécharger change de fonction si un VEX Brain ou un VEX Controller est connecté.

image5.png

Si un périphérique VEX n'est pas connecté, l'icône de construction s'affiche. Lorsque vous cliquez dessus, le projet sera uniquement construit.

image6.png

Si un appareil VEX est connecté, l'icône de téléchargement s'affiche. Lorsque vous cliquez dessus, le projet sera construit et, en cas de succès, sera téléchargé sur le périphérique VEX.

Jouer

image33.png

L'icône de lecture, lorsqu'elle est cliquée, exécute le programme utilisateur dans l'emplacement sélectionné.

Arrêt

image45.png

L'icône d'arrêt, lorsqu'on clique dessus, arrête un programme utilisateur.

Espace de travail sélectionné

image24.png

VS Code prend en charge les projets multi-espaces de travail. Le sélecteur de projet permet aux utilisateurs de basculer entre les projets VEX lorsqu'il en existe plusieurs dans l'espace de travail.

image14.png

Lorsque vous cliquez sur l'icône de sélection de projet, une liste de sélection rapide apparaît avec tous les projets valides.

Important
Si un projet n'est pas valide, il ne sera pas affiché dans la liste de sélection rapide du projet. Un projet n'est valide que s'il a été créé ou importé par l'extension VEX VS Code.

image34.png

Sélecteur de fichiers Python (Python uniquement)
Lorsqu'un projet Python VEX est sélectionné, le sélecteur de fichiers Python apparaîtra dans la barre d'outils. Python pour VEX ne prend actuellement en charge que les téléchargements de fichiers uniques.

image17.png


Lorsque vous cliquez sur l'icône, une liste de sélection rapide apparaît avec tous les fichiers Python situés dans le répertoire de l'espace de travail.
Le sélecteur de fichiers Python permet à l'utilisateur de basculer entre les fichiers sources Python (.py)

Barre d'activité et barre latérale VEX

image57.png

Actions des projets

image47.png

La barre d'activité vex contient la vue Actions du projet et la vue Informations sur le périphérique VEX.

La vue Actions du projet est utilisée pour créer un nouveau projet ou importer un projet VEXcode ou VEXcode Pro existant.

Pour plus d'informations sur la création d'un nouveau projet, consultez cet article!

Les informations sur la version sont également affichées dans les coins inférieurs gauche et droit de la vue.

Important
Si un projet VEXcode ou VEXcode Pro est ouvert dans l'éditeur, il ne sera pas considéré comme un projet VEX valide, le projet doit être importé à l'aide du bouton Importer dans la barre latérale VEX.

Informations sur l'appareil VEX

image37.pngimage62.png

La vue Informations sur le périphérique VEX donne à l'utilisateur un aperçu du VEX Brain ou du VEX Controller connecté. La version VEXos, le chemin du port série, le programme utilisateur et les informations sur le périphérique peuvent tous être trouvés dans cette vue. D'autres fonctions telles que les mises à jour du micrologiciel VEXos, les captures d'écran, la définition du nom du cerveau et du numéro d'équipe des paramètres peuvent également être exécutées via cette vue.

Informations système

image25.png

Les informations système fournissent un bref aperçu d'un appareil VEX connecté. Cela inclut la version VEXos d'un appareil, le nom du cerveau, le numéro d'équipe, l'ID du cerveau et les informations sur la version d'exécution de Python.

Informations sur le port série

image7.png

Les informations sur le port série affichent le chemin du périphérique pour chaque port disponible pour un périphérique VEX. La plupart des appareils VEX sont répertoriés comme deux ports série. Le port série de communication est utilisé pour télécharger des programmes et contrôler les fonctions cérébrales. Le port série utilisateur est utilisé pour transférer des données entre l'application utilisateur exécutée sur le Brain et l'ordinateur hôte connecté via USB. Le contrôleur V5 est le seul appareil VEX doté d'un simple port série de communication et d'aucun port série utilisateur.

Informations sur les programmes

image12.png

Les informations sur le programme affichent une liste de tous les programmes utilisateur téléchargés sur un VEX Brain.

image23.png

Chaque élément de la liste de programmes peut être développé pour afficher des informations supplémentaires sur chaque programme utilisateur, telles que l'emplacement de l'emplacement, le nom du fichier, le type de langue, la taille du fichier et l'heure du téléchargement.

Informations sur les appareils

image20.png

Les informations sur les appareils affichent une liste de tous les appareils à port intelligent connectés à un VEX Brain. Chaque élément de la liste affiche le numéro de port intelligent et le type de périphérique.

image29.png

Chaque élément de la liste des appareils peut être développé pour afficher des informations sur la version du micrologiciel de chaque appareil à port intelligent.

L’état lié au contrôleur s’affiche lorsqu’il est connecté au VEX Brain Device.

image44.png

VEX Brain est lié à un contrôleur VEX

image10.png

VEX Brain n'est pas lié à un contrôleur VEX

image52.png

Le contrôleur VEX V5 est connecté à un cerveau VEX V5

Captures d'écran

image50.png

En cliquant sur l'icône de l'appareil photo, un utilisateur peut prendre et télécharger une capture d'écran d'un VEX Brain.
Les captures d'écran ne sont disponibles que lorsque vous êtes connecté directement à un VEX Brain via USB

Battery Medic (cerveau V5 uniquement)

image39.png

En cliquant sur l'icône Coeur, l'extension téléchargera et exécutera le programme utilisateur Battery Medic.

Définir le nom du cerveau

image28.png

En cliquant sur l'icône en forme de crayon à côté du nom du système>, un utilisateur peut définir le nom d'un cerveau VEX.

image54.png

Après avoir cliqué sur l'icône Crayon, une zone de saisie apparaîtra en haut de l'éditeur VS Code. Tapez le nouveau nom du cerveau dans la zone de saisie et appuyez sur Entrée pour définir.

Définir le numéro d'équipe

image58.png

En cliquant sur l'icône en forme de crayon à côté de l'équipe système>, un utilisateur peut définir le numéro d'équipe d'un VEX Brain.

image49.png

Après avoir cliqué sur l'icône Crayon, une zone de saisie apparaîtra en haut de l'éditeur VS Code. Tapez le nouveau numéro d'équipe dans la zone de saisie et appuyez sur Entrée pour définir.

Effacer le programme utilisateur

image30.png

En cliquant sur l'icône Corbeille à côté des programmes ->nom du projet, un utilisateur peut effacer un programme dans un emplacement spécifique. IMPORTANT, une fois que vous avez effacé un programme, il ne peut plus être récupéré. Veuillez faire preuve de prudence lorsque vous utilisez cette fonctionnalité.

Avertissements concernant les informations sur l'appareil

Mise à jour VEXos

image22.png

Lorsque la version VEXos d'un VEX Brain est obsolète, une icône de message d'avertissement apparaît à côté de la version VEXos et les deux icônes Brain deviennent jaunes.

Pour résoudre cet avertissement, un utilisateur doit mettre à jour VEXos pour son VEXos Brain.

image31.png

Les VEXos peuvent être mis à jour en cliquant sur la flèche vers le haut à côté de l'icône du cerveau VEX.

image36.png

Une boîte de notification apparaîtra également dans le coin inférieur droit de l'éditeur VS Code lorsque VEXos est obsolète. Un utilisateur peut démarrer une mise à jour de VEXos en cliquant sur le bouton « Mettre à jour » ou en cliquant sur le bouton « Ignorer » pour ignorer la mise à jour de VEXos.

Cerveau non lié au contrôleur connecté

image21.png

L'icône du contrôleur VEX deviendra jaune lorsqu'un contrôleur VEX est connecté à un ordinateur, mais n'est pas lié à un cerveau VEX.

Pour résoudre cet avertissement, un utilisateur doit lier un contrôleur VEX à un cerveau VEX.

Panneau à bornes

L'extension de code VEX VS fournit deux terminaux au démarrage, le Log Terminal et le Terminal interactif

image11.png

Terminal de journalisation

image13.png

Le Log Terminal affiche la sortie de build, les erreurs de build et les résultats de téléchargement.

Borne interactive

image16.png

Le terminal interactif a deux fonctions : afficher les journaux printf et renvoyer les frappes brutes à un programme utilisateur. Afin de profiter du terminal interactif, un cerveau ou un contrôleur doit être connecté à un ordinateur exécutant l'extension de code VEX VS. La sortie du terminal interactif est effacée par défaut après la création et le téléchargement d'un programme utilisateur.

Paramètres utilisateur

Les paramètres utilisateur sont des paramètres globaux proposés par Visual Studio Code pour chaque extension. Les paramètres utilisateur sont appliqués à chaque projet d'extension VEX VS Code.

image32.png

Comment accéder aux paramètres utilisateur VEX

image42.png

Cliquez sur l'engrenage dans le coin gauche de VS Code et un menu contextuel apparaîtra

image27.png

Dans le menu contextuel, cliquez sur l'élément « Paramètres » et une page de paramètres apparaîtra.

image9.png

Dans la liste de gauche, cliquez sur l'élément « Extensions ». Ensuite, faites défiler vers le bas et recherchez l’élément intitulé « VEX ».

image18.png

Cliquez sur l'élément de liste « VEX ».

image46.png

Les paramètres utilisateur VEX apparaîtront dans le panneau de droite.

Aperçu des paramètres

Canal du contrôleur (contrôleur V5 uniquement)

Le paramètre Controller Channel contrôle le type de canal de communication radio entre un V5 Brain et un V5 Controller.
Ce paramètre s'applique uniquement lorsque VS Code est connecté à un contrôleur V5 via USB et que le contrôleur est connecté à un V5 Brain via VEXnet. L'utilisateur peut choisir entre Download et canaux Pit. Lorsqu'elle est réglée sur Download, la radio passera à un canal de téléchargement VEXnet une fois qu'un téléchargement de programme utilisateur est lancé. Le canal de téléchargement permet des débits de données plus élevés et des téléchargements plus efficaces. Lorsqu'elle est réglée sur Pit, la radio restera sur un canal Pit et le téléchargement prendra beaucoup plus de temps. Par défaut, ce paramètre est défini sur Télécharger.

image63.png

Accueil du SDK du projet Cpp

NE MODIFIEZ PAS CE PARAMÈTRE.

image1.png

Chemin de la chaîne d'outils Cpp

Cpp Toolchain Path définit le chemin de la chaîne d'outils utilisée lors de la création d'un projet C++ VEX VS Code.

image3.png

Activer le terminal utilisateur

Le paramètre Activer le terminal utilisateur permet à l'extension d'ouvrir le port série utilisateur lorsqu'un cerveau VEX ou un contrôleur VEX est détecté par l'extension. La seule exception s'applique à un contrôleur V5 qui n'énumère pas de port série utilisateur.

image61.png

Activer permet à l'extension de se connecter à un port utilisateur au démarrage et créera le terminal interactif. Si activer est sélectionné pendant que l'extension est en cours d'exécution, l'extension tentera d'ouvrir le port utilisateur si un périphérique est connecté.
Désactiver empêche l'extension de se connecter au port utilisateur au démarrage et ne crée pas de terminal interactif. Si désactiver est sélectionné pendant que l'extension est en cours d'exécution, l'extension fermera le port utilisateur et supprimera le terminal interactif.

Type de construction de projet

Project Build Type définit la manière dont l'extension construira un projet C++. L'utilisateur peut définir le type de build sur Build ou Rebuild.
Build ne construit le projet que lorsque Make détecte des modifications dans le code source du projet.
Rebuild nettoie le répertoire de construction du projet, puis construit le projet. Cette option est normalement beaucoup plus lente.

image51.png

Accueil du projet

Accueil du projet définit le répertoire personnel par défaut d'un nouveau projet lorsque vous terminez l'assistant Nouveau projet.

image38.png

Exécuter après le téléchargement

Exécuter après le téléchargement Lorsqu'il est activé, le programme utilisateur s'exécute après son téléchargement sur un VEX Brain.

image53.png

Accueil du SDK Python

NE MODIFIEZ PAS CE PARAMÈTRE.

image59.png

Aide de la commande VEX

L'aide de la commande VEX permet d'accéder à la documentation pour des fonctions spécifiques incluses dans l'API C++ et Python (Application Programming Interface). La documentation est spécifique à chaque plateforme VEX (IQ 2e génération, EXP, V5).

image55.png

Pour accéder à l'aide de la commande VEX, mettez d'abord en surbrillance le texte de la fonction à rechercher.

image15.png

Faites un clic droit sur le texte sélectionné et un menu contextuel apparaîtra.
Suivant Cliquez sur l'aide de la commande VEX pour accéder à la documentation.

image35.png

Si l'aide de la commande VEX trouve une correspondance exacte, une nouvelle vue Web apparaîtra avec la documentation pertinente.

image26.png

Si plusieurs documents correspondent au texte sélectionné, une liste déroulante apparaîtra avec une liste filtrée de la documentation pertinente.

For more information, help, and tips, check out the many resources at VEX Professional Development Plus

Last Updated: