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.
Composants de l'interface utilisateur
L'extension de code VEX VS comporte 3 composants principaux.
- Barre d'outils
- Barre d'activité et barre latérale
- 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.
Sélecteur de périphérique
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é.
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).
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.
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
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.
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
L'icône Construire/Télécharger change de fonction si un VEX Brain ou un VEX Controller est connecté.
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.
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
L'icône de lecture, lorsqu'elle est cliquée, exécute le programme utilisateur dans l'emplacement sélectionné.
Arrêt
L'icône d'arrêt, lorsqu'on clique dessus, arrête un programme utilisateur.
Espace de travail sélectionné
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.
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.
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.
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
Actions des projets
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
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
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
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
Les informations sur le programme affichent une liste de tous les programmes utilisateur téléchargés sur un VEX Brain.
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
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.
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.
VEX Brain est lié à un contrôleur VEX
VEX Brain n'est pas lié à un contrôleur VEX
Le contrôleur VEX V5 est connecté à un cerveau VEX V5
Captures d'écran
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)
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
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.
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
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.
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
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
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.
Les VEXos peuvent être mis à jour en cliquant sur la flèche vers le haut à côté de l'icône du cerveau VEX.
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é
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
Terminal de journalisation
Le Log Terminal affiche la sortie de build, les erreurs de build et les résultats de téléchargement.
Borne interactive
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.
Comment accéder aux paramètres utilisateur VEX
Cliquez sur l'engrenage dans le coin gauche de VS Code et un menu contextuel apparaîtra
Dans le menu contextuel, cliquez sur l'élément « Paramètres » et une page de paramètres apparaîtra.
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 ».
Cliquez sur l'élément de liste « VEX ».
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.
Accueil du SDK du projet Cpp
NE MODIFIEZ PAS CE PARAMÈTRE.
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.
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.
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.
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.
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.
Accueil du SDK Python
NE MODIFIEZ PAS CE PARAMÈTRE.
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).
Pour accéder à l'aide de la commande VEX, mettez d'abord en surbrillance le texte de la fonction à rechercher.
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.
Si l'aide de la commande VEX trouve une correspondance exacte, une nouvelle vue Web apparaîtra avec la documentation pertinente.
Si plusieurs documents correspondent au texte sélectionné, une liste déroulante apparaîtra avec une liste filtrée de la documentation pertinente.