Tämä artikkeli on yleiskatsaus VEX Visual Studio Code -laajennusliittymästä (käyttöliittymästä). Laajennus tukee C++- ja Python-projektien kehitystä VEX IQ 2nd Generation-, EXP- ja V5-alustoille.
Käyttöliittymän komponentit
VEX VS Code Extension -laajennuksessa on 3 pääkomponenttia.
- Työkalupalkki
- Activity Bar ja Side Bar
- Päätepaneeli
Työkalupalkki
Työkalupalkki antaa käyttäjille nopean tavan olla vuorovaikutuksessa VEX VS Code -laajennusprojektien VEX Brains ja VEX Controllers kanssa. Työkalurivi on aktiivinen vain, kun kelvollinen VEX-projekti on avoinna VS Code-koodissa. Kelvollinen VEX-projekti on laajennuksen luoma tai tuoma projekti. VEXcode- tai VEXcode Pro -projektin avaaminen ei kelpaa ja se on tuotava.
Laitteen valitsin
Laitevalitsimella on kaksi päätoimintoa. Ensinnäkin se näyttää aivo- tai ohjainkuvakkeen, joka edustaa kytkettyä VEX-laitetyyppiä.
Toiseksi, kun laiteluettelokuvaketta napsautetaan, näkyviin tulee pikavalintaluettelo, jossa on kaikki liitetyt VEX-laitteet. Käyttäjä voi valita, mihin laitteeseen laajennus muodostaa yhteyden.
Nykyinen yhdistetty laite näkyy aina luettelon yläosassa ja sen jälkeen kaikki muut laitteet lajiteltuina laitetyypin (Brain tai Controller) ja alustan (IQ 2nd Generation, EXP ja V5) mukaan.
Jokainen laitekohde sisältää aivonimen, alustan, laitetyypin ja laitepolun tiedot.
Tärkeä
Jos ohjain on kytketty tietokoneeseen, mutta sillä ei ole radiolinkkiä aivoihin, aivojen nimeä ei näytetä luettelokohteen tai laiteluettelon tilapalkin kuvakkeen vieressä.
Paikan valitsin
Paikan valitsinkuvakkeen avulla käyttäjä voi valita, missä paikassa laajennus lataa tai toistaa käyttäjäohjelman.
Kun paikan valitsin -kuvaketta napsautetaan, näkyviin tulee pikavalintaluettelo, jossa on käytettävissä olevat käyttäjäohjelmapaikat 1-8.
Rakenna/Lataa
Build/Download-kuvake muuttaa toimintoja, jos VEX Brain tai VEX Controller on kytketty.
Jos VEX-laitetta ei ole kytketty, koontikuvake näytetään. Kun napsautat, projekti vain rakennetaan.
Jos VEX-laite on kytketty, latauskuvake näytetään. Kun napsautat, projekti rakennetaan ja onnistuessaan ladataan VEX-laitteeseen.
pelata
Kun toistokuvaketta napsautetaan, se suorittaa käyttäjäohjelman valitussa paikassa.
Lopettaa
Pysäytyskuvake pysäyttää käyttäjäohjelman, kun sitä napsautetaan.
Valittu työtila
VS Code tukee usean työtilan projekteja. Projektivalitsimen avulla käyttäjät voivat vaihtaa VEX-projektien välillä, kun työtilassa on useita.
Kun projektinvalintakuvaketta napsautetaan, näkyviin tulee pikavalintaluettelo, jossa on kaikki voimassa olevat projektit.
Tärkeää
Jos projekti ei ole kelvollinen, se ei näy projektin pikavalintaluettelossa. Projekti ei ole kelvollinen, ellei sitä ole luotu tai tuotu VEX VS Code -laajennuksella.
Python-tiedoston valitsin (vain Python)
Kun VEX-python-projekti valitaan, python-tiedoston valitsin tulee näkyviin työkalupalkkiin. Python for VEX tukee tällä hetkellä vain yksittäisten tiedostojen latausta.
Kun kuvaketta napsautetaan, näkyviin tulee pikavalintaluettelo, jossa on kaikki työtilan hakemistossa sijaitsevat python-tiedostot.
Python-tiedoston valitsimen avulla käyttäjä voi vaihtaa python-lähdetiedostojen välillä (.py)
VEX Activity Bar ja sivupalkki
Projektit Toimet
Vix-toimintopalkki sisältää Project Actions -näkymän ja VEX Device Info -näkymän.
Projektitoiminnot -näkymää käytetään uuden projektin luomiseen tai olemassa olevan VEXcode- tai VEXcode Pro -projektin tuomiseen.
Lisätietoja uuden projektin luomisesta saat tästä artikkelista!
Versiotiedot näkyvät myös näkymän vasemmassa ja oikeassa alakulmassa.
Tärkeää
Jos VEXcode- tai VEXcode Pro -projekti on auki editorissa, sitä ei pidetä kelvollisena VEX-projektina, vaan projekti on tuotava VEX-sivupalkin Tuo-painikkeella.
VEX-laitteen tiedot
VEX Device Info -näkymä antaa käyttäjälle yleiskatsauksen yhdistetystä VEX Brainista tai VEX-ohjaimesta. VEXos-versio, sarjaportin polku, käyttäjäohjelma ja laitetiedot ovat kaikki tässä näkymässä. Tämän näkymän kautta voidaan suorittaa myös muita toimintoja, kuten VEXos-laiteohjelmiston päivitykset, kuvakaappaukset, aivojen nimen ja asetusryhmän numeron asettaminen.
Järjestelmätiedot
Järjestelmätiedot tarjoavat lyhyen yleiskatsauksen yhdistetystä VEX-laitteesta. Tämä sisältää laitteen VEXos-version, aivonimen, tiimin numeron, aivotunnuksen ja python-ajonaikaisen version tiedot.
Sarjaportin tiedot
Sarjaporttitiedot näyttävät kunkin VEX-laitteen käytettävissä olevan portin laitepolun. Useimmat VEX-laitteet luetellaan kahtena sarjaporttina. Communication-sarjaporttia käytetään ohjelmien lataamiseen ja aivojen toimintojen ohjaamiseen. Käyttäjän sarjaporttia käytetään tiedon siirtämiseen Brainissa toimivan käyttäjäsovelluksen ja USB:n kautta kytketyn isäntätietokoneen välillä. V5-ohjain on ainoa VEX-laite, jossa on vain tiedonsiirron sarjaportti eikä käyttäjän sarjaporttia.
Ohjelmien tiedot
Ohjelmatiedot näyttävät luettelon kaikista ladatuista käyttäjäohjelmista VEX Brainissa.
Jokainen ohjelmaluettelokohde voidaan laajentaa näyttämään lisätietoja kustakin käyttäjäohjelmasta, kuten paikan sijainnin, tiedostonimen, kielityypin, tiedostokoon ja latausajan.
Laitteiden tiedot
Laitetiedot näyttävät luettelon kaikista VEX Brainiin yhdistetyistä älyporttilaitteista. Jokainen luettelokohde näyttää älyportin numeron ja laitetyypin.
Jokainen laiteluettelokohde voidaan laajentaa näyttämään laiteohjelmiston versiotiedot kustakin älyporttilaitteesta.
Ohjaimeen linkitetty tila näytetään, kun se on yhdistetty VEX Brain Device -laitteeseen.
VEX Brain on yhdistetty VEX-ohjaimeen
VEX Brainia ei ole yhdistetty VEX-ohjaimeen
VEX V5 -ohjain on kytketty VEX V5 Brainiin
Screen Shots
Napsauttamalla kamerakuvaketta käyttäjä voi ottaa ja ladata kuvakaappauksen VEX Brainista.
Näyttökuvat ovat käytettävissä vain, kun ne on liitetty suoraan VEX Brainiin USB:n kautta
Battery Medic (vain V5 Brain)
Napsauttamalla Sydän-kuvaketta laajennus lataa ja suorittaa akkulääkärin käyttäjäohjelman.
Aseta aivojen nimi
Napsauttamalla kynäkuvaketta system->nimen vieressä, käyttäjä voi asettaa nimen VEX-aivoille.
Kun kynäkuvaketta on napsautettu, VS-koodieditorin yläosaan tulee syöttöruutu. Kirjoita uusi aivojen nimi syöttöruutuun ja aseta se painamalla Enter.
Aseta joukkueen numero
Napsauttamalla kynäkuvaketta system>teamin vieressä, käyttäjä voi asettaa tiiminumeron VEX Brainille.
Kun kynäkuvaketta on napsautettu, VS-koodieditorin yläosaan ilmestyy syöttöruutu. Kirjoita uusi joukkueen numero syöttöruutuun ja paina Enter asettaaksesi.
Poista käyttäjäohjelma
Napsauttamalla Roskakori -kuvaketta Programs->projektin nimen vieressä, käyttäjä voi poistaa ohjelman tietyssä paikassa. TÄRKEÄÄ, kun poistat ohjelman, sitä ei voi palauttaa. Ole varovainen käyttäessäsi tätä ominaisuutta.
Laitetietojen varoitukset
VEXos-päivitys
Kun VEX Brainin VEXos-versio on vanhentunut, VEXos-version viereen ilmestyy varoitusviestikuvake ja molemmat Brain-kuvakkeet muuttuvat keltaisiksi.
Tämän varoituksen ratkaisemiseksi käyttäjän tulee päivittää VEXos aivoihinsa.
VEXot voidaan päivittää napsauttamalla VEX Brain -kuvakkeen vieressä olevaa ylänuolta.
Myös ilmoitusruutu tulee näkyviin VS-koodieditorin oikeaan alakulmaan, kun VEXos on vanhentunut. Käyttäjä voi aloittaa VEXos-päivityksen napsauttamalla "Päivitä"-painiketta tai napsauttamalla "Ohita"-painiketta ohittaaksesi VEXos-päivityksen.
Aivoja ei ole yhdistetty yhdistettyyn ohjaimeen
VEX-ohjainkuvake muuttuu keltaiseksi, kun VEX-ohjain on kytketty tietokoneeseen, mutta sitä ei ole yhdistetty VEX-aivoihin.
Tämän varoituksen ratkaisemiseksi käyttäjän tulee linkittää VEX-ohjain VEX-aivoon
Päätepaneeli
VEX VS Code Extension tarjoaa kaksi päätelaitetta käynnistyksen yhteydessä, lokiterminaalin ja interaktiivisen päätteen
Log Terminal
Lokipääte näyttää koontitulosteen, koontivirheen ja lataustulokset.
Interaktiivinen terminaali
Interaktiivisella päätteellä on kaksi toimintoa, printf-lokien näyttäminen ja raakanäppäinpainallusten lähettäminen takaisin käyttäjäohjelmaan. Interaktiivisen päätelaitteen hyödyntäminen edellyttää, että Brain tai Controller kytketään tietokoneeseen, jossa on VEX VS Code Extension. Interaktiivinen päätteen lähtö tyhjennetään oletusarvoisesti käyttäjäohjelman rakentamisen ja lataamisen jälkeen.
Käyttäjäasetukset
Käyttäjäasetukset ovat yleisiä asetusasetuksia, jotka Visual Studio Code tarjoaa kullekin laajennukselle. Käyttäjäasetuksia sovelletaan jokaiseen VEX VS Code -laajennusprojektiin.
Kuinka päästä VEX-käyttäjäasetuksiin
Napsauta hammasrataskuvaketta VS Coden vasemmassa kulmassa, niin kontekstivalikko tulee näkyviin
Napsauta pikavalikosta kohtaa "Asetukset", jolloin asetussivu tulee näkyviin.
Napsauta vasemmanpuoleisessa luettelonäkymässä "Laajennukset" -kohtaa. Vieritä seuraavaksi alas ja etsi kohde, jonka nimi on "VEX".
Napsauta "VEX" -luettelokohtaa.
VEX User -asetukset näkyvät oikeanpuoleisessa paneelissa.
Asetusten yleiskatsaus
Ohjainkanava (vain V5-ohjain)
Controller Channel -asetus ohjaa radioviestintäkanavatyyppiä V5 Brainin ja V5 Controllerin välillä.
Tämä asetus koskee vain, kun VS Code on kytketty V5-ohjaimeen USB:n kautta ja ohjain on kytketty V5 Brainiin VEXnetin kautta. Käyttäjä voi valita Download - ja Pit -kanavan välillä. Kun asetus on Download, radio hyppää VEXnet-latauskanavalle, kun käyttäjäohjelman lataus aloitetaan. Latauskanava mahdollistaa suuremmat tiedonsiirtonopeudet ja tehokkaammat lataukset. Kun asetus on Pit, radio pysyy pit-kanavalla ja lataus kestää paljon kauemmin. Oletuksena tämä asetus on Lataa.
Cpp Project SDK Home
ÄLÄ MUOKKAA TÄTÄ ASETUSTA.
Cpp-työkaluketjun polku
Cpp Toolchain Path asettaa polun työkaluketjulle, jota käytetään C++ VEX VS Code -projektin rakentamiseen.
Ota käyttäjäpääte käyttöön
Ota käyttäjäpääte käyttöön -asetus sallii laajennuksen avata käyttäjän sarjaportin, kun laajennus havaitsee VEX Brainin tai VEX Controllerin. Ainoa poikkeus koskee V5-ohjainta, jossa ei ole käyttäjän sarjaporttia.
Ota käyttöön sallii laajennuksen muodostaa yhteyden käyttäjäporttiin käynnistyksen yhteydessä ja luo interaktiivisen päätteen. Jos käytössä on valittuna laajennuksen ollessa käynnissä, laajennus yrittää avata käyttäjäportin, jos laite on kytketty.
Poista käytöstä estää laajennusta muodostamasta yhteyttä käyttäjäporttiin käynnistyksen yhteydessä eikä luo interaktiivista päätelaitetta. Jos pois käytöstä valitaan laajennuksen ollessa käynnissä, laajennus sulkee käyttäjäportin ja poistaa interaktiivisen päätteen.
Projektin rakennustyyppi
Project Build Type määrittää, kuinka laajennus rakentaa C++-projektin. Käyttäjä voi asettaa koontimuodoksi Build tai Rebuild.
Rakenna rakentaa projekti vain, kun Make havaitsee muutoksia projektin lähdekoodissa.
Rebuild puhdistaa projektin rakennushakemiston ja rakentaa sitten projektin. Tämä vaihtoehto on yleensä paljon hitaampi.
Projektin koti
Project Home määrittää uuden projektin oletuskotihakemiston, kun uusi projekti on ohjattu.
Suorita latauksen jälkeen
Suorita latauksen jälkeen kun se on käytössä, käynnistää käyttäjäohjelman sen jälkeen, kun se on ladattu VEX Brainiin.
Python SDK Home
ÄLÄ MUOKKAA TÄTÄ ASETUSTA.
VEX-komento-ohje
VEX Command Help mahdollistaa pääsyn C++- ja Python API:n (Application Programming Interface) sisältämien toimintojen dokumentaatioon. Dokumentaatio on jokaiselle VEX-alustalle ominaista (IQ 2nd Generation, EXP, V5).
Päästäksesi VEX Command Help -ohjeeseen, korosta ensin etsittävän toiminnon teksti.
Napsauta valittua tekstiä hiiren kakkospainikkeella, niin kontekstivalikko tulee näkyviin.
Seuraava Napsauta VEX-komento-ohjetta päästäksesi dokumentaatioon.
Jos VEX Command Help löytää tarkan vastaavuuden, näkyviin tulee uusi verkkonäkymä, jossa on tarvittavat asiakirjat.
Jos useat asiakirjat vastaavat valittua tekstiä, näkyviin tulee pudotusvalikko, jossa on suodatettu luettelo asiaankuuluvista asiakirjoista.