Panoramica dell'interfaccia utente di VS Code per V5

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.

Screenshot che mostra il layout completo dell'interfaccia utente di VEX in VS Code. La barra delle attività e la barra laterale si trovano sul lato sinistro dello schermo, la barra degli strumenti e il terminale si trovano sul lato inferiore dello schermo e l'editor occupa la parte restante dello schermo.

Componenti dell'interfaccia utente

Ci sono 3 componenti principali nell'estensione VEX VS Code.

  1. Barra degli strumenti
  2. Barra delle attività e barra laterale
  3. Pannello terminale

Barra degli strumenti

La barra degli strumenti offre agli utenti un modo rapido per interagire con i progetti di estensione VEX per VS Code, ovvero VEX Brains e VEX Controllers. La barra degli strumenti è attiva solo quando è aperto un progetto VEX valido 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.

Barra degli strumenti di VS Code con icone di estensione VEX che possono essere utilizzate per interagire rapidamente con dispositivi e progetti VEX connessi. Le funzionalità di VEX includono il selettore del dispositivo, il selettore dello slot, l'icona di download della build & , l'icona di riproduzione, l'icona di arresto, il selettore del progetto e il selettore del file Python.

Selettore dispositivo

L'icona di selezione del dispositivo è evidenziata nella barra degli strumenti di VS Code. In questo esempio si legge VEX_V5.

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.

Barra di ricerca di VS Code con elenco a selezione rapida di tutti i dispositivi VEX connessi. In questo esempio, sono elencati un V5 Brain, un V5 Controller e un EXP Controller.

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).

Barra di ricerca di VS Code con un elemento dell'elenco a selezione rapida visualizzato per fornire dettagli. L'elemento riporta la dicitura MyBrain, V5 Brain, User COM8, Comm COM7.

Ogni elemento del dispositivo contiene informazioni su nome del cervello, piattaforma, tipo di dispositivo e percorso del dispositivo.

Barra di ricerca di VS Code con un elemento dell'elenco a selezione rapida visualizzato per fornire dettagli. L'oggetto è un controller V5, ma lo sfondo è grigio e non è indicato alcun nome per il Brain. Ciò indica che questo controller non dispone di un collegamento radio con un'unità centrale (Brain).

Elemento Controller V5 con sfondo blu per indicare che questo Controller dispone di un collegamento radio con un Brain.

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 slot è evidenziata nella barra degli strumenti di VS Code. In questo esempio si legge Slot 1.

L'icona del selettore dello slot consente all'utente di scegliere su quale slot l'estensione scaricherà o riprodurrà un programma utente.

Barra di ricerca di VS Code con elenco a selezione rapida di tutti gli slot disponibili sul VEX Brain collegato. In questo esempio, sono disponibili otto slot.

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

Icona di compilazione.Icona di download.

L'icona Costruisci/Scarica cambia funzione se è collegato un cervello VEX o un controller VEX.

Icona di compilazione.

Se un dispositivo VEX non è connesso, viene visualizzata l'icona di creazione. Quando si fa clic, il progetto verrà solo compilato.

Icona di download.

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

Icona di riproduzione

Quando si fa clic sull'icona di riproduzione, viene eseguito il programma utente nello slot selezionato.

Fermare

Icona di arresto.

L'icona di arresto, se selezionata, arresta un programma utente.

Area di lavoro selezionata

Il selettore di progetto viene visualizzato nella barra degli strumenti di VS Code. In questo esempio si legge EXPTestProject.

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.

Barra di ricerca di VS Code con elenco a selezione rapida dei progetti VEX salvati. In questo esempio, sono elencati un progetto Python e un progetto C++.

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 se non è stato creato o importato tramite l'estensione VEX per VS Code.

L'icona del selettore di file Python è visualizzata sulla barra degli strumenti di VS Code. In questo esempio viene letto main.py.

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.

Barra di ricerca di VS Code con elenco a selezione rapida di tutti i file Python presenti in questo progetto VEX. In questo esempio, ci sono tre file Python, ognuno in una posizione diversa.


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

Screenshot che mostra la barra delle attività di VS Code e la barra laterale aperte sulla vista VEX. Nella parte superiore di VEX View sono presenti le opzioni per la creazione e l'importazione di progetti, il menu Informazioni dispositivo VEX in basso e un menu per i feedback in basso.

Azioni di progetti

Sezione Azioni del progetto della vista Estensione VEX. Questa sezione contiene due pulsanti con le scritte "Nuovo progetto" e "Importa progetto".

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 maggiori 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

Nella sezione Informazioni dispositivo VEX della vista Estensione VEX viene visualizzato un elenco di tutti i dispositivi connessi e informazioni specifiche su ciascuno di essi. In questo esempio vengono mostrati un EXP Brain e i programmi scaricati. Nella voce Controller compare la dicitura Controller, non collegato.La sezione Informazioni sul dispositivo VEX viene visualizzata di nuovo, ma ora la voce Controller riporta la dicitura Controller, collegato.

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

La cartella Sistema e il suo contenuto sono visualizzati ed evidenziati sotto la cartella Cervello. La cartella di sistema contiene dati relativi al Cervello, e i dati sono i seguenti: VEXos 1.0.1.0, nome VEX_EXP, team 000000, ID 0EC83725 e Python 1.0.0.7.

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

La cartella Serial Port e il suo contenuto sono visualizzati sotto la cartella Brain. La cartella Porta seriale contiene i dati relativi alla connessione cablata del Brain. Questi dati indicano la comunicazione COM167 e l'utente COM168.

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

La cartella Programmi e il suo contenuto sono visualizzati sotto la cartella Brain. La cartella Programmi mostra tutti i progetti VEX scaricati su Brain. In questo esempio, sono stati scaricati quattro programmi C/C++ sul dispositivo Brain connesso.

Le informazioni sul programma mostrano un elenco di tutti i programmi utente scaricati su un VEX Brain.

La cartella Programmi e il suo contenuto sono visualizzati sotto la cartella Brain, ora con la cartella del primo progetto aperta per mostrarne il contenuto. La cartella del progetto mostra i dati relativi a slot, file, tipo, dimensione e tempo.

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

La cartella Dispositivi e il suo contenuto sono visualizzati sotto la cartella Cervello. La cartella Dispositivi mostra tutti i dispositivi collegati al Brain. In questo esempio sono elencati 6 dispositivi, tra cui 4 motori, un dispositivo a 3 fili e una radio interna.

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.

La cartella Dispositivi e il suo contenuto sono visualizzati sotto la cartella Cervello. In questo esempio, è stato selezionato un dispositivo Motore e il suo contenuto è il seguente: Tipo Motore, Versione 1.0.0.4, Boot 1.0.2.0.

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.

Il controller è elencato nella cartella Dispositivi. Questo controller legge il controller, collegato.

VEX Brain è collegato a un controller VEX

Il controller è elencato nella cartella Dispositivi. Questo controller legge Controller, non collegato.

VEX Brain non è collegato a un controller VEX

Il controller è elencato nella cartella Dispositivi. Questo controller legge Controller, tethered.

Il controller VEX V5 è collegato a un cervello VEX V5

Schermate

Il cursore si trova sopra la cartella Indicatore dispositivo VEX e accanto ad essa viene visualizzata l'icona di una fotocamera.

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)

Il cursore si trova sopra la cartella Indicatore dispositivo V5 Brain VEX e accanto ad essa viene visualizzata l'icona di Battery Medic.

Facendo clic sull'icona del cuore, l'estensione scaricherà ed eseguirà il programma utente Battery Medic.

Imposta il nome del cervello

Il cursore si trova sopra l'opzione Nome all'interno della cartella Sistema e accanto ad essa viene visualizzata l'icona di una matita.

Facendo clic sull'icona della matita accanto al nome del sistema>, un utente può impostare il nome per un cervello VEX.

Imposta la finestra di richiesta Nome cervello con un campo di testo e un messaggio sottostante che dice Premi Invio per confermare l'input o Esc per annullare.

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

Il cursore si trova sopra l'opzione Team all'interno della cartella Sistema e accanto ad essa viene visualizzata l'icona di una matita.

Facendo clic sull'icona della matita accanto a system>team, un utente può impostare il numero della squadra per un cervello VEX.

Imposta una finestra di richiesta per il numero della squadra con un campo di testo e un messaggio sottostante che dice Premi Invio per confermare l'inserimento o Esc per annullare.

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

Il cursore si trova sopra un programma nella cartella Programmi e accanto ad esso viene visualizzata l'icona del Cestino.

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

L'icona della cartella Brain e l'icona dell'indicatore del dispositivo VEX sono visualizzate in arancione, e accanto alla versione VEXos del sistema è presente un simbolo di pericolo. Questi segnali indicano che la versione di VEXos di Brain è obsoleta.

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.

Il cursore si trova sopra la cartella obsoleta di Brain e accanto ad essa è visualizzata un'icona con una freccia rivolta verso l'alto.

I VEXo possono essere aggiornati facendo clic sulla freccia su accanto all'icona del cervello VEX.

Aggiorna la finestra di prompt di VEXos con un messaggio che recita "Aggiornamento di VEXos disponibile: 1.0.1.0". Sorgente, estensione VEX. Qui sotto, ci sono due pulsanti con le scritte Aggiorna e Ignora.

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

La cartella Brain, situata sotto la cartella VEX Device Indicator, ha un'icona arancione e la scritta Brain, non collegata. Questi segnali indicano che non è collegato alcun VEX Brain.

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

La finestra del terminale di VS Code è aperta e mostra il terminale di log di VEX e il terminale interattivo di VEX.

Terminale di registro

Il terminale di log di VS Code VEX si apre e mostra la cronologia di utilizzo dell'estensione VEX. In questo esempio, sono presenti messaggi che leggono Log, Build di Windows per la piattaforma vexexp, Download del programma utente, Download completato.

Il terminale di registro visualizza l'output della build, l'errore della build e i risultati del download.

Terminale interattivo

Il terminale interattivo VEX di VS Code si apre e mostra un messaggio con la scritta "Hello World".

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.

Le impostazioni utente di VS Code si aprono sulla pagina VEX, dove è possibile personalizzare il comportamento dell'estensione VEX Robotics.

Come accedere alle impostazioni utente VEX

L'icona delle impostazioni si trova nella parte inferiore della barra delle attività di VS Code, nell'angolo in basso a sinistra dello schermo.

Fai clic sull'ingranaggio nell'angolo sinistro di VS Code e verrà visualizzato un menu contestuale

Menu contestuale delle impostazioni di VS Code con numerose opzioni elencate. L'opzione "Impostazioni" è evidenziata ed è la terza opzione del menu, sotto "Palette dei comandi" e "Profili".

Nel menu contestuale, fai clic sulla voce "Impostazioni" e verrà visualizzata una pagina delle impostazioni.

La finestra delle impostazioni di VS Code è aperta e la categoria Estensioni è evidenziata nell'elenco di navigazione a sinistra.

Nella visualizzazione elenco a sinistra, fai clic sulla voce "Estensioni". Successivamente, scorri verso il basso e trova l'elemento etichettato "VEX".

La finestra delle impostazioni di VS Code è aperta e il collegamento alla pagina VEX all'interno della categoria Estensioni è evidenziato.

Fare clic sulla voce dell'elenco "VEX".

Le impostazioni utente di VS Code si aprono sulla pagina VEX, dove è possibile personalizzare il comportamento dell'estensione VEX Robotics.

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.

Impostazioni utente VEX con l'opzione Canale controller visualizzata. Questa opzione presenta un menu a tendina impostato di default su "Scarica". La descrizione recita: Imposta il canale radio del controller V5.

Home dell'SDK del progetto Cpp

NON MODIFICARE QUESTA IMPOSTAZIONE.

Impostazioni utente VEX con l'opzione Home dell'SDK C++ visualizzata. Questa opzione contiene un link con la scritta "Modifica in settings.json". La descrizione recita: NON MODIFICARE.

Percorso della catena di strumenti Cpp

Percorso toolchain Cpp imposta il percorso per la toolchain utilizzata durante la compilazione di un progetto C++ VEX VS Code.

Impostazioni utente VEX con la toolchain C++: opzione Percorso visualizzata. Questa opzione presenta un campo di testo che rappresenta un percorso file.

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.

Impostazioni utente VEX con l'opzione Generale Abilita terminale utente visualizzata. Questa opzione presenta un menu a tendina impostato su Abilita per impostazione predefinita. La descrizione recita: Abilita l'estensione per aprire e visualizzare i dati dalla porta 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.

Impostazioni utente VEX con l'opzione Tipo di build del progetto visualizzata. Questa opzione presenta un menu a tendina impostato su "Crea" per impostazione predefinita. La descrizione recita "Imposta il tipo di compilazione del progetto Cpp".

Progetto Casa

Project Home imposta la directory home predefinita per un nuovo progetto quando si completa la procedura guidata Nuovo progetto.

Impostazioni utente VEX con l'opzione Home progetto visualizzata. Questa opzione presenta un campo di testo che rappresenta un percorso file. La descrizione recita: Imposta la posizione predefinita per i nuovi progetti.

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.

Impostazioni utente VEX con l'opzione "Esegui progetto dopo il download" visualizzata. Questa opzione presenta una casella di controllo che, in questo esempio, risulta selezionata. La descrizione recita: Imposta se il programma utente deve essere eseguito dopo il download.

Home dell'SDK Python

NON MODIFICARE QUESTA IMPOSTAZIONE.

Impostazioni utente VEX con l'opzione Home dell'SDK Python visualizzata. Questa opzione contiene un link con la scritta "Modifica in settings.json". La descrizione recita: NON MODIFICARE.

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).

Il comando C++ nell'editor VS Code è stato evidenziato con il cursore.

Per accedere alla Guida del comando VEX, evidenziare prima il testo della funzione da cercare.

È stato aperto il menu contestuale per il comando C++ e l'opzione Guida ai comandi VEX è evidenziata.

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.

La pagina di aiuto dei comandi VEX è aperta e mostra informazioni ed esempi relativi al comando C++ Brain Screen Print.

Se la Guida del comando VEX trova una corrispondenza esatta, verrà visualizzata una nuova visualizzazione Web con la documentazione pertinente.

Barra di ricerca di VS Code con elenco a selezione rapida dei comandi VEX C++ corrispondenti nella Guida ai comandi VEX per aiutare l'utente a restringere la ricerca.

Se più documenti corrispondono al testo selezionato, verrà visualizzato un menu a discesa con un elenco filtrato della documentazione pertinente.

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

Last Updated: