Cet article fournit un aperçu de l’interface utilisateur (interface utilisateur) de l’extension VEX Visual Studio Code. L'extension prend en charge le développement de projets C++ et Python pour les plates-formes VEX IQ 2nd Generation, EXP et V5.
Disposition de l'interface utilisateur de l'extension VEX VS Code
L'interface utilisateur de l'extension VEX Visual Studio Code est divisée en cinq zones principales : barre d'activité, barre latérale, éditeur, panneau de terminal et barre d'outils.
Barre d'activité
La barre d'activité comporte une série d'icônes qui nous permettent de basculer entre les vues et nous fournissent des indicateurs contextuels supplémentaires pour le développement du projet VEX.
Les icônes courantes utilisées pour développer un projet VEX dans VS Code sont :
-
Icône de la vue Explorer - Lorsqu'elle est cliquée, la vue Explorer s'ouvre dans la barre latérale.
-
Icône d'affichage des extensions - Lorsqu'on clique dessus, l' d'affichage des extensions s'ouvre dans la barre latérale.
-
Icône de vue VEX - Lorsqu'on clique dessus, la vue VEX s'ouvre dans la barre latérale.
Barre latérale
La barre latérale contient différentes vues qui nous permettent d'utiliser les outils intégrés dans VS Code. Les vues de la barre latérale courantes utilisées pour effectuer des tâches de développement de projets VEX sont Vue d'extension, Vue VEXet Vue Explorateur.
Vue d'extension
La vue d'extension est utilisée pour installer et gérer les extensions dans VS Code. Pour développer des logiciels sur les plates-formes VEX IQ 2nd Generation, EXP et V5, nous devons installer l'extension VEX, l'extension C/C++ et l'extension Python.
Pourdes instructions étape par étape sur la façon d'installer l'extension VEX, l'extension C/C++et l'extension Python dans VS Code, veuillez consulter cet article .
Vue VEX
La vue VEX View nous permet de développer des projets pour VEX IQ 2nd Generation, EXP et V5 dans VS Code. Il existe trois catégories incluses dans la vue VEX : ACTIONS DU PROJET, INFOS SUR LE PÉRIPHÉRIQUE VEX, et COMMENTAIRES VEX.
-
ACTIONS DU PROJET
Les boutons sous ACTIONS DU PROJET sont utilisés pour créer un nouveau projet VEX ou importer un projet VEXcode existant.
Pour des conseils détaillés sur la création d'un projet VEX dans VS Code, veuillez consulter cet article pour V5, cet article pour EXP, et cet article pour IQ (2e).
-
VEX DEVICE INFO
La catégorie VEX DEVICE INFO nous donne un aperçu de l'appareil VEX connecté - un VEX Brain ou un VEX Controller.
Cette catégorie indique le type d'appareil VEX connecté et affiche les informations du système Brain, du port série, du programme téléchargé et des appareils connectés aux ports intelligents du VEX Brain. Il nous permet de faire une capture d'écran de l'écran du VEX Brain, afficher le journal des événements du VEX Brain, utiliser le V5 Battery Medic, définir le nom du cerveau etnuméro d'équipe , et effacer le programme utilisateur du VEX Brain
Lorsqu'un VEX Brain est connecté à l'ordinateur, la catégorie VEX DEVICE INFO indique si un contrôleur VEX est lié au VEX Brain et nous permet de mettre à jour les VEXos du VEX Brain si la version VEXos du VEX Brain est obsolète.
Lorsqu'un contrôleur VEX est connecté à l'ordinateur, la catégorie VEX DEVICE INFO indique si un VEX Brain est lié au contrôleur VEX et nous permet de mettre à jour les VEXos du contrôleur VEX si la version VEXos du contrôleur VEX est obsolète.
Pour une description complète des informations sur l'appareil et comment utiliser les fonctionnalités sous VEX DEVICE INFO, veuillez consulter cet article.
-
VEX FEEDBACK
Nous pouvons envoyer des commentaires à VEX en tapant le message dans la zone de texte sous VEX FEEDBACK et en cliquant sur le bouton ENVOYER
Pour obtenir des informations utiles sur l'utilisation de VEX FEEDBACK dans VS Code, veuillez consulter cet article.
Vue de l'explorateur
La vue Explorer est utilisée pour parcourir, ouvrir et gérer les fichiers et dossiers du projet VEX dans VS Code.
Éditeur
L'éditeur est la zone principale pour éditer les fichiers dans VS Code. L'extension VEX VS Code active Intellisense/Linting pour C/C++ et Python dans la zone Éditeur pour nous aider lors du développement du programme.
Dans la zone Éditeur, nous pouvons accéder à des informations utiles sur une fonction spécifique en passant la souris sur le texte de la fonction ou en utilisant l'aide de la commande VEX pour accéder à la documentation de cette fonction incluse dans l'API C++ et Python (Application Programming Interface).
Pour des instructions détaillées sur l’utilisation de l’aide de la commande VEX dans VS Code, veuillez consulter cet article.
Panneau de terminaux
L'extension VEX VS Code fournit deux terminaux au démarrage, le terminal de journal et le terminal interactif.
-
Terminal de journal - Le terminal de journal affiche la sortie de build, l'erreur de build et les résultats de téléchargement.
-
Terminal interactif - Le terminal interactif a deux fonctions : afficher les journaux d'impression et renvoyer les frappes brutes à un programme utilisateur.
Remarque : Pour utiliser le terminal interactif, un cerveau ou un contrôleur doit être connecté à un ordinateur exécutant l'extension VEX VS Code.
Remarque : 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.
Barre d'outils
La barre d'outils propose une gamme d'icônes qui nous offrent un moyen rapide d'interagir avec les projets d'extension VEX VS Code, VEX Brains et VEX Controllers.
Remarque : La barre d’outils n’est active que lorsqu’un projet VEX valide est ouvert dans VS Code.
Remarque : Un projet VEX valide est un projet créé ou importé par l'extension. Les projets VEXcode ou VEXcode Pro ouverts dans l'éditeur ne seront pas considérés comme un projet VEX valide et devront être importés.
Les icônes présentées dans la barre d'outils incluent :
-
Sélecteur de périphérique - Le sélecteur de périphérique affiche l'icône du périphérique VEX connecté (une icône de cerveau
ou une icône de contrôleur
)
Remarque : Si un contrôleur est connecté à l'ordinateur, mais n'a pas de liaison radio avec un cerveau, aucun nom de cerveau ne sera affiché à côté de l'icône du contrôleur.
-
Icône de sélection d'emplacement - L'icône de sélection d'emplacement nous permet de choisir l'emplacement sur lequel l'extension VEX téléchargera ou lira un programme utilisateur en cliquant dessus et en sélectionnant l'un des huit emplacements disponibles sur le VEX Brain dans la liste de sélection.
-
Build & Télécharger l'icône - Si un périphérique VEX est connecté, l'icône Télécharger s'affichera dans la barre d'outils. Une fois cliqué, le projet sera construit et, en cas de succès, sera téléchargé sur l'appareil VEX connecté.
-
Icône de lecture - Lorsqu'elle est cliquée, l' de lecture exécute le programme utilisateur téléchargé dans l'emplacement sélectionné sur le VEX Brain.
-
Icône d'arrêt - Lorsqu'elle est cliquée, l'icône Arrêt arrête l'exécution du programme utilisateur sur le VEX Brain.
-
Sélecteur de projet - Le Sélecteur de projet affiche le nom du projet sélectionné. L'icône de sélection de projet nous permet de basculer entre les projets VEX lorsque plusieurs existent dans l'espace de travail en cliquant dessus et en sélectionnant un projet dans la liste de sélection.
-
Sélecteur de fichiers Python (Python uniquement) - Lorsqu'un projet VEX Python est sélectionné, le sélecteur de fichiers Python apparaît dans la barre d'outils. Le sélecteur de fichiers Python affiche le nom du fichier Python sélectionné. Python pour VEX ne prend actuellement en charge que les téléchargements de fichiers uniques.
Pour obtenir des informations utiles sur l’utilisation des fonctionnalités de la barre d’outils dans VS Code, veuillez cet article.
Paramètres utilisateur VEX
Les paramètres utilisateur VEX nous permettent de configurer l'extension VEX selon nos propres besoins. Les paramètres utilisateur sont des paramètres globaux appliqués à chaque projet d'extension VEX VS Code. Nous pouvons accéder aux paramètres utilisateur VEX en cliquant sur l'icône Paramètres dans VS Code et en sélectionnant les éléments correspondants dans les menus.
Les paramètres utilisateur VEX pour la configuration de l'extension VEX VS Code sont :
- Canal du contrôleur (contrôleur V5 uniquement) - Définit le canal radio du contrôleur V5 sur Téléchargement ou Pit. Ce paramètre s'applique uniquement à la liaison radio VEXnet.
- Cpp Toolchain Path - Définit le chemin de la chaîne d'outils CPP.
- Activer le terminal utilisateur- Active ou désactive l'extension pour ouvrir et afficher les données du port utilisateur.
- entrées de journal - Définit le nombre d'entrées de journal à télécharger à partir d'un VEX Brain.
- Type de construction du projet - Définit la manière dont l'extension va construire un projet C++.
- Project Home - Définit l'emplacement par défaut pour les nouveaux projets.
- Exécuter après le téléchargement - Définit si le programme utilisateur doit s'exécuter après avoir été téléchargé sur un VEX Brain.
- Système DFU Récupération automatique - Définit si le cerveau doit récupérer automatiquement lorsqu'un IQ2 ou EXP est détecté en mode DFU.
- Websocket Server Enable - Active ou désactive l'extension pour démarrer le serveur Websocket.
- Adresse de l'hôte du serveur Websocket - Définit l'adresse de l'hôte du serveur Websocket.
- Port du serveur Websocket - Définit le numéro de port du serveur Websocket
Pour obtenir des informations utiles sur la manière d'accéder aux paramètres utilisateur VEX et de les définir, cet article.