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.

immagine48.png

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.

immagine2.png

Selettore dispositivo

immagine60.png

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.

immagine41.png

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

immagine4.png

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

immagine8.png

immagine56.png

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

immagine19.png

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

immagine43.png

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

immagine5.pngimmagine6.png

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

immagine5.png

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

immagine6.png

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

image33.png

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

Fermare

immagine45.png

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

Area di lavoro selezionata

image24.png

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.

immagine14.png

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.

image34.png

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.

immagine17.png


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

immagine57.png

Azioni di progetti

immagine47.png

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

immagine37.pngimmagine62.png

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

immagine25.png

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

immagine7.png

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

immagine12.png

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

immagine23.png

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

immagine20.png

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.

immagine29.png

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.

immagine44.png

VEX Brain è collegato a un controller VEX

immagine10.png

VEX Brain non è collegato a un controller VEX

immagine52.png

Il controller VEX V5 è collegato a un cervello VEX V5

Schermate

immagine50.png

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)

immagine39.png

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

Imposta il nome del cervello

image28.png

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

immagine54.png

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

immagine58.png

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

immagine49.png

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

immagine30.png

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

image22.png

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.

image31.png

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

immagine36.png

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

immagine21.png

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

immagine11.png

Terminale di registro

immagine13.png

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

Terminale interattivo

immagine16.png

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.

image32.png

Come accedere alle impostazioni utente VEX

immagine42.png

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

immagine27.png

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

immagine9.png

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

immagine18.png

Fare clic sulla voce dell'elenco "VEX".

immagine46.png

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.

immagine63.png

Home dell'SDK del progetto Cpp

NON MODIFICARE QUESTA IMPOSTAZIONE.

immagine1.png

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.

immagine3.png

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.

immagine61.png

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.

immagine51.png

Progetto Casa

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

immagine38.png

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.

immagine53.png

Home dell'SDK Python

NON MODIFICARE QUESTA IMPOSTAZIONE.

immagine59.png

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

immagine55.png

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

immagine15.png

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.

immagine35.png

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

image26.png

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

Last Updated: