Questo articolo fornisce una panoramica dell'interfaccia utente (UI) dell'estensione VEX per Visual Studio Code. L'estensione supporta lo sviluppo di progetti C++ e Python per le piattaforme VEX IQ di seconda generazione, EXP e V5.
Layout dell'interfaccia utente dell'estensione VEX VS Code
L'interfaccia utente dell'estensione VEX per Visual Studio Code è suddivisa in cinque aree principali: barra delle attività, barra laterale, editor, pannello terminale e barra degli strumenti.
Barra delle attività
La barra delle attività presenta una serie di icone che ci consentono di passare da una visualizzazione all'altra e ci forniscono ulteriori indicatori specifici del contesto per lo sviluppo del progetto VEX.
Le icone comuni utilizzate per sviluppare un progetto VEX in VS Code sono:
-
Icona Visualizzazione Explorer - Quando si fa clic, la Visualizzazione Explorer si apre nella barra laterale.
-
Icona Visualizzazione Estensioni - Quando si fa clic, la Visualizzazione Estensioni si apre nella barra laterale.
-
Icona vista VEX - Quando si fa clic, la vista VEX si apre nella barra laterale.
Barra laterale
La barra laterale contiene diverse visualizzazioni che ci consentono di utilizzare gli strumenti integrati in VS Code. Le viste della barra laterale più comuni utilizzate per eseguire attività per lo sviluppo di progetti VEX sono Visualizzazione estensione, Visualizzazione VEXe Visualizzazione esploratore.
Visualizzazione estensione
La vista estensione viene utilizzata per installare e gestire le estensioni in VS Code. Per sviluppare software sulle piattaforme VEX IQ di seconda generazione, EXP e V5, dobbiamo installare l'estensione VEX, l'estensione C/C++ e l'estensione Python.
Per istruzioni dettagliate su come installare l'estensione VEX , l'C/C++ e l'estensione Python in VS Code, consulta questo articolo .
Vista VEX
La VEX View ci consente di sviluppare progetti per VEX IQ di seconda generazione, EXP e V5 in VS Code. La vista VEX include tre categorie: AZIONI PROGETTO, INFORMAZIONI DISPOSITIVO VEX, e FEEDBACK VEX.
-
AZIONI PROGETTO
I pulsanti sotto AZIONI PROGETTO vengono utilizzati per creare un nuovo progetto VEX o importare un progetto VEXcode esistente.
Per una guida dettagliata sulla creazione di un progetto VEX in VS Code, vedere questo articolo per V5, questo articolo per EXPe questo articolo per IQ (2nd).
-
INFORMAZIONI SUL DISPOSITIVO VEX
La categoria INFORMAZIONI SUL DISPOSITIVO VEX fornisce una panoramica del dispositivo VEX connesso - un VEX Brain o un VEX Controller.
Questa categoria indica il tipo di dispositivo VEX connesso e visualizza le informazioni sul sistema Brain, sulla porta seriale, sul programma scaricato e sui dispositivi connessi alle porte intelligenti del VEX Brain. Ci consente di catturare uno screenshot della schermata del VEX Brain, visualizzare il registro eventi del VEX Brain, utilizzare il V5 Battery Medic, impostare il nome del cervello e il numero del teame cancellare il programma utente dal VEX Brain
Quando un VEX Brain è collegato al computer, la categoria VEX DEVICE INFO mostra se un VEX Controller è collegato al VEX Brain e ci consente di aggiornare il VEXos per il VEX Brain se la versione VEXos del VEX Brain non è aggiornata.
Quando un VEX Controller è collegato al computer, la categoria VEX DEVICE INFO mostra se un VEX Brain è collegato al VEX Controller e ci consente di aggiornare il VEXos per il VEX Controller se la versione VEXos del VEX Controller non è aggiornata.
Per una descrizione completa delle informazioni sul dispositivo e su come utilizzare le funzionalità in INFORMAZIONI SUL DISPOSITIVO VEX, consultare questo articolo.
-
VEX FEEDBACK
Possiamo inviare feedback a VEX digitando il messaggio nella casella di testo sotto VEX FEEDBACK e cliccando sul pulsante INVIA
Per informazioni utili sull'utilizzo del VEX FEEDBACK in VS Code, consultare questo articolo.
Vista Explorer
La vista Explorer viene utilizzata per esplorare, aprire e gestire i file e le cartelle del progetto VEX in VS Code.
Redattore
L'Editor è l'area principale per modificare i file in VS Code. L'estensione VEX VS Code abilita Intellisense/Linting sia per C/C++ che per Python nell'area Editor per assisterci durante lo sviluppo del programma.
Nell'area Editor possiamo accedere a informazioni utili su una funzione specifica passando il mouse sul testo della funzione o utilizzando VEX Command Help per accedere alla documentazione per questa funzione inclusa nell'API (Application Programming Interface) di C++ e Python.
Per istruzioni dettagliate sull'utilizzo del comando VEX Help in VS Code, consultare questo articolo.
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 di build, gli errori di build e i risultati del download.
-
Terminale interattivo - Il terminale interattivo ha due funzioni: visualizzare i registri di stampa e inviare sequenze di tasti non elaborate a un programma utente.
Nota: per utilizzare il terminale interattivo, un cervello o un controller deve essere collegato a un computer che esegue l'estensione VEX VS Code.
Nota: l'output del terminale interattivo viene cancellato per impostazione predefinita dopo aver creato e scaricato un programma utente.
Barra degli strumenti
La barra degli strumenti presenta una serie di icone che ci forniscono un modo rapido per interagire con i progetti di estensione VEX VS Code, VEX Brains e VEX Controller.
Nota: La barra degli strumenti è attiva solo quando un progetto VEX valido è aperto in VS Code.
Nota: Un progetto VEX valido è un progetto creato o importato dall'estensione. I progetti VEXcode o VEXcode Pro aperti nell'editor non saranno considerati progetti VEX validi e dovranno essere importati.
Le icone presenti sulla barra degli strumenti includono:
-
Selettore dispositivo - Il Selettore dispositivo visualizza l'icona del dispositivo VEX connesso (un'icona Cervello
o un'icona Controller
)
Nota: se un controller è connesso al computer, ma non ha un collegamento radio a un cervello, accanto all'icona Controller non verrà visualizzato alcun nome di cervello.
-
Icona selettore slot - L'icona selettore slot ci consente di scegliere su quale slot l'estensione VEX scaricherà o riprodurrà un programma utente cliccandoci sopra e selezionando uno degli otto slot disponibili sul VEX Brain dall'elenco di selezione.
-
Build & Icona di download - Se è connesso un dispositivo VEX, l'icona di download verrà visualizzata sulla barra degli strumenti. Cliccando, il progetto verrà compilato e, se completato correttamente, verrà scaricato sul dispositivo VEX connesso.
-
Icona di riproduzione - Quando viene cliccata, l'icona di riproduzione esegue il programma utente scaricato nello slot selezionato sul VEX Brain.
-
Icona di arresto - Quando si fa clic, l'icona di arresto interrompe l'esecuzione del programma utente sul VEX Brain.
-
Selettore progetto - Il Selettore progetto visualizza il nome del progetto selezionato. L'icona Project Selector ci consente di passare da un progetto VEX all'altro quando ne esistono più di uno all'interno dell'area di lavoro, cliccandoci sopra e selezionando un progetto dall'elenco di selezione.
-
Selettore file Python (solo Python) - Quando viene selezionato un progetto Python VEX, il Selettore file Python apparirà nella barra degli strumenti. Il selettore file Python visualizza il nome del file Python selezionato. Al momento Python per VEX supporta solo il download di singoli file.
Per informazioni utili su come utilizzare le funzionalità della barra degli strumenti in VS Code, consulta questo
Impostazioni utente VEX
Le impostazioni utente VEX ci consentono di configurare l'estensione VEX in base alle nostre esigenze. Le impostazioni utente sono impostazioni globali applicate a ogni progetto di estensione VEX VS Code. Possiamo accedere alle Impostazioni utente VEX cliccando sull'icona Impostazioni in VS Code e selezionando le voci corrispondenti nei menu.
Le impostazioni utente VEX per la configurazione dell'estensione VEX VS Code sono:
- Canale controller (solo controller V5) - Imposta il canale radio del controller V5 su Download o Pit. Questa impostazione si applica solo al collegamento radio VEXnet.
- Percorso della toolchain CPP : imposta il percorso per la toolchain CPP.
- Abilita terminale utente: abilita o disabilita l'estensione per aprire e visualizzare i dati dalla porta utente.
- Voci di registro - Imposta il numero di voci di registro da caricare da un VEX Brain.
- Tipo di build del progetto : imposta il modo in cui l'estensione compilerà un progetto C++.
- Home progetto - Imposta la posizione predefinita per i nuovi progetti.
- Esegui dopo il download - Imposta se il programma utente deve essere eseguito dopo essere stato scaricato su un VEX Brain.
- Sistema DFU Auto Recover - Imposta se il cervello deve effettuare il ripristino automatico quando viene rilevato un IQ2 o EXP in modalità DFU.
- Abilita server Websocket - Abilita o disabilita l'estensione per avviare il server Websocket.
- Indirizzo host del server Websocket : imposta l'indirizzo host del server Websocket.
- Porta server Websocket - Imposta il numero di porta del server Websocket
Per informazioni utili su come accedere e configurare le Impostazioni utente VEX, questo.