Panoramica dell'interfaccia utente di VS Code per IQ

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 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 il resto 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 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.

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

Selettore dispositivo

L'icona Selettore dispositivo è evidenziata sulla barra degli strumenti di VS Code. In questo esempio si legge VEX_EXP.

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 VS Code con un elenco di scelta 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 di scelta rapida visualizzato per fornire dettagli. L'elemento riporta 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 di scelta rapida visualizzato per fornire dettagli. L'oggetto è un controller V5, ma lo sfondo è disattivato e non è elencato alcun nome Brain. Ciò indica che questo Controller non ha un collegamento radio con un Brain.

Elemento Controller V5 con sfondo blu per indicare che questo Controller ha 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 sulla 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 VS Code con un elenco di scelta rapida di tutti gli slot disponibili sul VEX Brain connesso. In questo esempio ci sono otto slot disponibili.

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 costruzione.Icona di download.

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

Icona di costruzione.

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 progetto viene visualizzato sulla 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 un elenco di scelta 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 a meno che non sia stato creato o importato dall'estensione VEX VS Code.

L'icona del selettore file Python è visualizzata sulla barra degli strumenti di VS Code. In questo esempio si legge 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 un elenco di scelta rapida di tutti i file Python 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 nella vista VEX. VEX View presenta le opzioni per creare e importare progetti nella parte superiore, il menu Informazioni dispositivo VEX nella parte inferiore e un menu di feedback nella parte inferiore.

Azioni di progetti

Sezione Azioni progetto della vista estensione VEX. Questa sezione contiene due pulsanti: 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

La sezione Informazioni dispositivo VEX della Vista estensione VEX viene visualizzata con un elenco di tutti i dispositivi connessi e informazioni specifiche su ciascuno di essi. In questo esempio vengono mostrati un IQ Brain (2a generazione) e i relativi programmi scaricati. L'elenco Controller riporta Controller, non collegato.La sezione Informazioni dispositivo VEX viene nuovamente visualizzata, ma ora l'elenco Controller riporta 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 di sistema e il suo contenuto vengono mostrati ed evidenziati sotto la cartella Brain. La cartella di sistema contiene dati sul cervello e i dati sono 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 dati sulla connessione cablata del Brain. Questi dati leggono Comunicazione COM167, 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 sul Brain. In questo esempio, ci sono quattro programmi C/C++ scaricati sul 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 vengono 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 Ora.

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 vengono 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, 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 vengono visualizzati sotto la cartella Cervello. In questo esempio, è stato selezionato un dispositivo Motore e il suo contenuto riporta Tipo Motore, Versione 1.0.0.4, Avvio 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 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 è posizionato sulla cartella VEX Device Indicator e accanto ad essa è visualizzata l'icona della 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 è posizionato sulla cartella Indicatore dispositivo V5 Brain VEX e accanto ad essa è visualizzata l'icona 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 è posizionato sopra l'opzione Nome all'interno della cartella Sistema e accanto ad essa è 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 recita 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 è posizionato sopra l'opzione Team all'interno della cartella Sistema e accanto ad essa è 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.

Finestra di richiesta Imposta numero squadra con un campo di testo e un messaggio sottostante che recita 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. Digitare il nuovo numero della squadra nella casella di input e premere Invio per impostarlo.

Cancella programma utente

Il cursore è posizionato sopra un programma nella cartella Programmi e accanto ad esso è 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, mentre accanto alla versione VEXos del sistema è presente un simbolo di pericolo. Questi segnali indicano che la versione VEXos del 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 è posizionato sopra la cartella Brain non aggiornata e accanto ad essa è visualizzata un'icona a forma di freccia rivolta verso l'alto.

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

Aggiorna la finestra del prompt VEXos con un messaggio che recita Aggiornamento VEXos disponibile: 1.0.1.0. Origine, estensione VEX. In basso 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 sotto la cartella VEX Device Indicator ha un'icona arancione e riporta la dicitura Brain, not linked. Questi segnali indicano che non è presente alcun VEX Brain connesso.

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 VS Code è aperta e mostra il terminale VEX Log e il terminale interattivo VEX.

Terminale di registro

Viene aperto il terminale di registro VEX di VS Code, che mostra la cronologia dell'utilizzo dell'estensione VEX. In questo esempio, sono presenti messaggi che leggono Registro, 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 viene aperto e mostra un messaggio che recita 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. È evidenziata l'opzione Impostazioni, che è la terza opzione nel menu, sotto Palette dei comandi e Profili.

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

La finestra Impostazioni 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 Impostazioni 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 mostrata. Questa opzione ha un menu a discesa 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 Cpp mostrata. Questa opzione ha un collegamento che riporta Modifica in settings.json. Nella descrizione c'è scritto NON MODIFICARE.

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.

Impostazioni utente VEX con la toolchain Cpp: opzione Percorso mostrata. Questa opzione ha 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 mostrata. Questa opzione ha un menu a discesa 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 ha un menu a discesa impostato di default su Crea. La descrizione riporta Imposta tipo di build 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 del progetto visualizzata. Questa opzione ha 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 download visualizzata. Questa opzione ha una casella di controllo che in questo esempio viene mostrata 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 mostrata. Questa opzione ha un collegamento che riporta Modifica in settings.json. Nella descrizione c'è scritto 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 al comando 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.

È aperta la pagina della Guida del comando VEX, che mostra informazioni ed esempi sul comando Brain Screen Print C++.

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 un elenco di scelta 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: