Questo articolo offre una panoramica dell'interfaccia utente dell'estensione VEX Visual Studio Code (interfaccia utente). L'estensione supporta lo sviluppo di progetti C++ e Python per piattaforme VEX IQ di seconda generazione, EXP e V5.
Componenti dell'interfaccia utente
Ci sono 3 componenti principali nell'estensione VEX VS Code.
- Barra degli strumenti
- Barra delle attività e barra laterale
- Pannello terminale
Barra degli strumenti
La barra degli strumenti offre agli utenti un modo rapido per interagire con i progetti di estensione VEX VS Code VEX Brains e VEX Controllers. La barra degli strumenti è attiva solo quando un progetto VEX valido è aperto in VS Code. Un progetto VEX valido è un progetto creato o importato dall'estensione. L'apertura di un progetto VEXcode o VEXcode Pro non è valida e dovrà essere importato.
Selettore dispositivo
Il selettore del dispositivo ha due funzioni principali. Innanzitutto, visualizza l'icona di un cervello o di un controller che rappresenta il tipo di dispositivo VEX connesso.
In secondo luogo, quando si fa clic sull'icona dell'elenco dei dispositivi, viene visualizzato un elenco di selezione rapida con tutti i dispositivi VEX collegati. L'utente può selezionare a quale dispositivo si connetterà l'estensione.
Il dispositivo attualmente connesso apparirà sempre in cima all'elenco seguito da tutti gli altri dispositivi ordinati per tipo di dispositivo (Brain o Controller) e piattaforma (IQ 2nd Generation, EXP e V5).
Ogni elemento del dispositivo contiene informazioni su nome del cervello, piattaforma, tipo di dispositivo e percorso del dispositivo.
Importante
Se un controller è connesso a un computer, ma non ha un collegamento radio con un cervello, nessun nome del cervello verrà visualizzato accanto all'elemento dell'elenco o all'icona della barra di stato dell'elenco dei dispositivi.
Selettore di slot
L'icona del selettore dello slot consente all'utente di scegliere su quale slot l'estensione scaricherà o riprodurrà un programma utente.
Quando si fa clic sull'icona del selettore dello slot, viene visualizzato un elenco di selezione rapida con gli slot del programma utente disponibili da 1 a 8.
Costruisci/Scarica
L'icona Costruisci/Scarica cambia funzione se è collegato un cervello VEX o un controller VEX.
Se un dispositivo VEX non è connesso, viene visualizzata l'icona di creazione. Quando si fa clic, il progetto verrà solo compilato.
Se è collegato un dispositivo VEX, viene visualizzata l'icona di download. Quando si fa clic, il progetto verrà creato e, in caso di successo, verrà scaricato sul dispositivo VEX.
Giocare
Quando si fa clic sull'icona di riproduzione, viene eseguito il programma utente nello slot selezionato.
Fermare
L'icona di arresto, se selezionata, arresta un programma utente.
Area di lavoro selezionata
VS Code supporta progetti con più aree di lavoro. Il selettore di progetto consente agli utenti di passare da un progetto VEX all'altro quando ne esistono più nello spazio di lavoro.
Quando si fa clic sull'icona del selettore del progetto, viene visualizzato un elenco di selezione rapida con tutti i progetti validi.
Importante
Se un progetto non è valido, non verrà mostrato nell'elenco di selezione rapida del progetto. Un progetto non è valido a meno che non sia stato creato o importato dall'estensione VEX VS Code.
Selettore file Python (solo Python)
Quando viene selezionato un progetto Python VEX, il selettore file Python apparirà nella barra degli strumenti. Python per VEX supporta attualmente solo download di file singoli.
Quando si fa clic sull'icona, viene visualizzato un elenco di selezione rapida con tutti i file Python situati nella directory dell'area di lavoro.
Il selettore di file Python consente all'utente di alternare tra i file sorgente Python (.py)
Barra delle attività e barra laterale VEX
Azioni di progetti
La barra delle attività vex contiene la vista Azioni progetto e la vista Informazioni dispositivo VEX.
La vista Azioni progetto viene utilizzata per creare un nuovo progetto o importare un progetto VEXcode o VEXcode Pro esistente.
Per ulteriori informazioni sulla creazione di un nuovo progetto, consulta questo
Le informazioni sulla versione vengono visualizzate anche negli angoli in basso a sinistra e a destra della vista.
Importante
Se un progetto VEXcode o VEXcode Pro è aperto nell'editor, non sarà considerato un progetto VEX valido, il progetto deve essere importato utilizzando il pulsante Importa nella barra laterale VEX.
Informazioni sul dispositivo VEX
La visualizzazione Informazioni dispositivo VEX offre all'utente una panoramica del VEX Brain o del controller VEX collegato. In questa schermata è possibile trovare la versione di VEXos, il percorso della porta seriale, il programma utente e le informazioni sul dispositivo. Attraverso questa visualizzazione è possibile eseguire anche altre funzioni come gli aggiornamenti del firmware VEXos, le schermate, l'impostazione del nome del cervello e il numero del team delle impostazioni.
Informazioni di sistema
Le informazioni di sistema forniscono una breve panoramica di un dispositivo VEX collegato. Ciò include la versione VEXos di un dispositivo, il nome del cervello, il numero del team, l'ID del cervello e le informazioni sulla versione del runtime di Python.
Informazioni sulla porta seriale
Le informazioni sulla porta seriale mostrano il percorso del dispositivo per ciascuna porta disponibile per un dispositivo VEX. La maggior parte dei dispositivi VEX conta due porte seriali. La porta seriale di comunicazione viene utilizzata per scaricare programmi e controllare le funzioni cerebrali. La porta seriale utente viene utilizzata per trasferire i dati tra l'app utente in esecuzione su Brain e il computer host collegato tramite USB. Il Controller V5 è l'unico dispositivo VEX che ha solo una porta seriale di comunicazione e nessuna porta seriale utente.
Informazioni sui programmi
Le informazioni sul programma mostrano un elenco di tutti i programmi utente scaricati su un VEX Brain.
Ciascun elemento dell'elenco programmi può essere espanso per mostrare informazioni aggiuntive su ciascun programma utente, come posizione dello slot, nome file, tipo di lingua, dimensione del file e ora del download.
Informazioni sui dispositivi
Le informazioni sui dispositivi mostrano un elenco di tutti i dispositivi Smart Port collegati a un VEX Brain. Ciascun elemento dell'elenco mostra il numero di porta intelligente e il tipo di dispositivo.
Ciascun elemento dell'elenco dei dispositivi può essere espanso per mostrare le informazioni sulla versione del firmware di ciascun dispositivo Smart Port.
Lo stato collegato al controller viene visualizzato quando connesso al dispositivo VEX Brain.
VEX Brain è collegato a un controller VEX
VEX Brain non è collegato a un controller VEX
Il controller VEX V5 è collegato a un cervello VEX V5
Schermate
Facendo clic sull'icona della fotocamera, un utente può acquisire e scaricare uno screenshot da un cervello VEX.
Le schermate sono disponibili solo se collegato direttamente a un VEX Brain tramite USB
Medico della batteria (solo cervello V5)
Facendo clic sull'icona del cuore, l'estensione scaricherà ed eseguirà il programma utente Battery Medic.
Imposta il nome del cervello
Facendo clic sull'icona della matita accanto al nome del sistema>, un utente può impostare il nome per un cervello VEX.
Dopo aver fatto clic sull'icona Matita, verrà visualizzata una casella di input nella parte superiore dell'editor VS Code. Digita il nuovo nome del cervello nella casella di input e premi Invio per impostarlo.
Imposta il numero della squadra
Facendo clic sull'icona della matita accanto a system>team, un utente può impostare il numero della squadra per un cervello VEX.
Dopo aver fatto clic sull'icona Matita, verrà visualizzata una casella di input nella parte superiore dell'editor VS Code. Digitare il nuovo numero della squadra nella casella di input e premere Invio per impostarlo.
Cancella programma utente
Facendo clic sull'icona Cestino accanto al nome del progetto programmi->, un utente può cancellare un programma in uno slot specifico. IMPORTANTE, una volta cancellato un programma non è più possibile recuperarlo. Si prega di prestare attenzione quando si utilizza questa funzione.
Avvisi sulle informazioni sul dispositivo
Aggiornamento VEXos
Quando la versione VEXos di VEX Brain non è aggiornata, viene visualizzata l'icona di un messaggio di avviso accanto alla versione VEXos ed entrambe le icone Brain diventano gialle.
Per risolvere questo avviso, l'utente deve aggiornare VEXos per il proprio VEXos Brain.
I VEXo possono essere aggiornati facendo clic sulla freccia su accanto all'icona del cervello VEX.
Inoltre, una finestra di notifica apparirà nell'angolo in basso a destra dell'editor VS Code quando VEXos non è aggiornato. Un utente può avviare un aggiornamento VEXos facendo clic sul pulsante "Aggiorna" o facendo clic sul pulsante "Ignora" per saltare l'aggiornamento VEXos.
Cervello non collegato al controller collegato
L'icona del controller VEX diventerà gialla quando un controller VEX è collegato a un computer, ma non è collegato a un cervello VEX.
Per risolvere questo avviso, l'utente deve collegare un controller VEX a un cervello VEX
Pannello terminale
L'estensione VEX VS Code fornisce due terminali all'avvio, il terminale di registro e il terminale interattivo
Terminale di registro
Il terminale di registro visualizza l'output della build, l'errore della build e i risultati del download.
Terminale interattivo
Il terminale interattivo ha due funzioni, visualizzare i registri printf e inviare le sequenze di tasti grezze a un programma utente. Per sfruttare il terminale interattivo, un cervello o un controller deve essere collegato a un computer che esegue l'estensione VEX VS Code. L'output del terminale interattivo viene cancellato per impostazione predefinita dopo aver creato e scaricato un programma utente.
Impostazioni utente
Le impostazioni utente sono impostazioni globali offerte dal codice Visual Studio per ciascuna estensione. Le impostazioni dell'utente vengono applicate a ogni progetto di estensione VEX VS Code.
Come accedere alle impostazioni utente VEX
Fai clic sull'ingranaggio nell'angolo sinistro di VS Code e verrà visualizzato un menu contestuale
Nel menu contestuale, fai clic sulla voce "Impostazioni" e verrà visualizzata una pagina delle impostazioni.
Nella visualizzazione elenco a sinistra, fai clic sulla voce "Estensioni". Successivamente, scorri verso il basso e trova l'elemento etichettato "VEX".
Fare clic sulla voce dell'elenco "VEX".
Le impostazioni utente VEX appariranno nel pannello di destra.
Panoramica delle impostazioni
Canale controller (solo controller V5)
L'impostazione Controller Channel controlla il tipo di canale di comunicazione radio tra V5 Brain e V5 Controller.
Questa impostazione si applica solo quando VS Code è collegato a un controller V5 tramite USB e il controller è collegato a un V5 Brain tramite VEXnet. L'utente può scegliere tra canali Download e Pit. Quando impostato su Download, la radio passerà a un canale VEXnet di download una volta avviato il download del programma utente. Il canale di download consente velocità dati più elevate e download più efficienti. Se impostato su Pit, la radio rimarrà su un canale pit e il download richiederà molto più tempo. Per impostazione predefinita questa impostazione è impostata su Download.
Home dell'SDK del progetto Cpp
NON MODIFICARE QUESTA IMPOSTAZIONE.
Percorso della catena di strumenti Cpp
Cpp Toolchain Path imposta il percorso per la toolchain utilizzata durante la creazione di un progetto C++ VEX VS Code.
Abilita terminale utente
L'impostazione Abilita terminale utente consente all'interno di aprire la porta seriale dell'utente quando un VEX Brain o un controller VEX viene rilevato dall'interno. L'unica eccezione si applica a un controller V5 che non enumera una porta seriale utente.
Abilita consente all'interno di connettersi a una porta utente all'avvio e creerà il terminale interattivo. Se si seleziona abilita mentre l'estensione è in esecuzione, l'estensione tenterà di aprire la porta utente se è connesso un dispositivo.
Disabilita impedisce all'interno di connettersi alla porta utente all'avvio e non creerà un terminale interattivo. Se si seleziona Disattiva mentre l'estensione è in esecuzione, l'estensione chiuderà la porta utente e rimuoverà il terminale interattivo.
Tipo di costruzione del progetto
Project Build Type imposta il modo in cui l'estensione creerà un progetto C++. L'utente può impostare il tipo di build su Costruisci o Ricostruisci.
Build crea il progetto solo quando Make rileva eventuali modifiche nel codice sorgente del progetto.
Rebuild pulisce la directory di build del progetto, quindi crea il progetto. Questa opzione è normalmente molto più lenta.
Progetto Casa
Project Home imposta la directory home predefinita per un nuovo progetto quando si completa la procedura guidata Nuovo progetto.
Esegui dopo il download
Esegui dopo il download quando abilitato, fa sì che il programma utente venga eseguito dopo essere stato scaricato su un VEX Brain.
Home dell'SDK Python
NON MODIFICARE QUESTA IMPOSTAZIONE.
Aiuto comando VEX
VEX Command Help consente l'accesso alla documentazione per funzioni specifiche incluse nell'API C++ e Python (Application Programming Interface). La documentazione è specifica per ciascuna piattaforma VEX (IQ 2nd Generation, EXP, V5).
Per accedere alla Guida del comando VEX, evidenziare prima il testo della funzione da cercare.
Fare clic con il tasto destro sul testo selezionato e verrà visualizzato un menu contestuale.
Successivo Fare clic sulla Guida del comando VEX per accedere alla documentazione.
Se la Guida del comando VEX trova una corrispondenza esatta, verrà visualizzata una nuova visualizzazione Web con la documentazione pertinente.
Se più documenti corrispondono al testo selezionato, verrà visualizzato un menu a discesa con un elenco filtrato della documentazione pertinente.