Tämä artikkeli tarjoaa yleiskatsauksen 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.

VEX VS Code Extension käyttöliittymän asettelu

VEX Visual Studio Code Extension UI on jaettu viiteen pääalueeseen: toimintopalkki, sivupalkki, editori, päätepaneeli ja työkalupalkki.

Kuvakaappaus, joka näyttää VEX VS Code -käyttöliittymän täydellisen asettelun. Toimintapalkki ja sivupalkki ovat näytön vasemmalla puolella, työkalupalkki ja pääte ovat näytön alareunassa ja editori täyttää loput näytöstä.

Activity Bar

Activity Bar sisältää joukon kuvakkeita, joiden avulla voimme vaihtaa näkymien välillä ja antaa meille kontekstikohtaisia ​​lisäindikaattoreita VEX-projektin kehittämiseen.

VS-koodin aktiviteettipalkki, johon on asennettu VEX-robotiikkalaajennus. Toimintapalkissa on kuvakkeita, jotka tarjoavat hyödyllisiä pikatoimintoja, kuten haun, laajennusten hallinnan, versiohallinnan ja paljon muuta.

Yleiset kuvakkeet, joita käytetään VEX-projektin kehittämiseen VS Codessa, ovat:

  • Explorer-näkymän kuvake. Tutkimusnäkymän kuvake - Kun napsautat, Explorer View avautuu sivupalkkiin.
  • Laajennukset-näkymän kuvake. Laajennusten näkymä -kuvake - Kun napsautat, laajennusnäkymä avautuu sivupalkkiin.
  • VEX-näkymän kuvake. VEX View -kuvake - Kun napsautetaan, VEX View avautuu sivupalkkiin.

Sivupalkki

Sivupalkki sisältää erilaisia ​​näkymiä, joiden avulla voimme käyttää VS Coden integroituja työkaluja. Yleiset sivupalkkinäkymät, joita käytetään VEX-projektikehityksen tehtävien suorittamiseen, ovat Extension View, VEX Viewja Explorer View.

Laajennusnäkymä

Extension View tä käytetään laajennuksien asentamiseen ja hallintaan VS Codessa. Ohjelmistojen kehittämiseksi VEX IQ 2nd Generation-, EXP- ja V5-alustoille meidän on asennettava VEX Extension, C/C++ Extension ja Python Extension.

Katso vaiheittaiset ohjeet VEX-laajennuksen, C/C++-laajennuksenja Python-laajennuksen asentamisesta VS-koodiin tästä artikkelista.

VS Code -laajennusnäkymä, joka näyttää asennettujen laajennusten luettelon. Jokaisella laajennuksella on asetusvalikko, joka voidaan avata täällä, ja siellä on hakupalkki uusien laajennusten etsimiseen ja lataamiseen.


VEX-näkymä

VEX View antaa meille mahdollisuuden kehittää projekteja VEX IQ 2nd Generation, EXP ja V5 VS Codessa. VEX-näkymässä on kolme luokkaa: PROJEKTITOIMENPITEET, VEX-LAITETIEDOT, ja VEX-PALAUTE.

VS Coden VEX-näkymä, joka näyttää projektien luomis- ja tuontivaihtoehdot yllä, VEX-laitetiedot-valikon alla ja palautevalikon alareunassa.

VEX-laajennusnäkymän Projektitoiminnot-osio. Tässä osiossa on kaksi painiketta, joissa lukee Uusi projekti ja Tuo projekti.

  • VEX-LAITTEEN TIEDOT
    VEX-LAITTEEN TIEDOT -kategoria antaa yleiskatsauksen liitetystä VEX-laitteesta - VEX Brainista tai VEX-ohjaimesta.

    VEX Device Info section of the VEX Extension View is shown, with a list of all connected devices and specific info about each one. In this example, an IQ (2nd gen) Brain and its downloaded programs are shown.


    Tämä luokka osoittaa liitetyn VEX-laitteen tyypin ja näyttää tiedot Brain-järjestelmästä, sarjaportista, ladatusta ohjelmasta ja VEX Brainin älyportteihin liitetyistä laitteista. Sen avulla voimme kuvakaappauksen VEX Brain -näytöstä, tarkastella VEX Brain -tapahtumalokia, käyttää V5 Battery Medic-ohjelmaa, asettaa aivojen nimen ja tiimin numeronja poistaa käyttäjäohjelman VEX:stä. Aivot.

    Kun VEX Brain on kytketty tietokoneeseen, VEX DEVICE INFO -luokka näyttää, onko VEX-ohjain yhdistetty VEX Brainiin ja mahdollistaa VEXos n päivittämisen VEX Brainille, jos VEX Brainin VEXos-versio on vanhentunut.

    Kun VEX-ohjain on kytketty tietokoneeseen, VEX DEVICE INFO -luokka näyttää, onko VEX-aivot linkitetty VEX-ohjaimeen ja mahdollistaa VEXos n päivittämisen VEX-ohjaimelle, jos VEX-ohjaimen VEXos-versio on vanhentunut.

    Kattava kuvaus laitetiedoista ja VEX DEVICE INFO- toimintojen käytöstä löydät tästä artikkelista.
  • VEX-PALAUTE
    Voimme lähettää palautetta VEX:lle kirjoittamalla viestin tekstikenttään kohdassa VEX-PALAUTE ja napsauttamalla LÄHETÄ -painiketta.
    Hyödyllisiä tietoja VEX FEEDBACK :n käytöstä VS Codessa on tässä artikkelissa.

VEX-laajennusnäkymän VEX-palaute -osio. Tässä osiossa on lomake, jolla voit lähettää palautetta VEX:lle.

Explorer-näkymä

Explorer View tä käytetään VEX-projektitiedostojen ja -kansioiden selaamiseen, avaamiseen ja hallintaan VS Codessa.

VS Code Explorer -näkymä, jonka avulla käyttäjä voi selata VEX-projektinsa kansioita ja tiedostoja. Tiedostoilla on vastaavat kuvakkeet ja tiedostotyypit. Tässä esimerkissä on valittuna Python-tiedosto ja otsikko on main.py.

Toimittaja

Editor on pääalue VS Coden tiedostojen muokkaamiseen. VEX VS Code Extension mahdollistaa Intellisense/Lintingin sekä C/C++:lle että Pythonille Editor-alueella auttamaan meitä ohjelman kehittämisessä.

VS-koodieditori, jossa Python-tiedosto on avattu osana VEX-projektia. Python- tai C/C++-koodia voidaan kirjoittaa ja muokata täällä VEX-robotiikkaohjelmien luomiseksi, kun se on yhdistetty VEX Brainiin.

Editor-alueella voimme lähestyä hyödyllisiä tietoja tietystä funktiosta viemällä hiiren osoitin funktion tekstin päälle tai käyttämällä VEX Command Help päästäksesi käsiksi tämän funktion dokumentaatioon, joka sisältyy C++- ja Python-sovellusliittymään (Application Programming Interface). ).

Katso yksityiskohtaiset ohjeet VEX Command Help n käyttämisestä VS Codessa tästä artikkelista.

Päätepaneeli

VEX VS Code Extension tarjoaa kaksi päätelaitetta käynnistyksen yhteydessä, lokiterminaalin ja interaktiivisen päätteen. 

  • Lokipääte – Lokipääte näyttää koontitulosteen, koontivirheen ja lataustulokset.

VS Code VEX -lokiterminaali avataan ja näyttää oletusarvoisen tyhjän tilan, jossa on vain yksi tulostettu viesti "Loki".

  • Vuorovaikutteinen pääte Vuorovaikutteisella on kaksi toimintoa: tulostuslokien näyttäminen ja raakanäppäilyjen lähettäminen takaisin käyttäjäohjelmalle.

    VS Code VEX Interactive Terminal is opened and shows messages that detail the VEX Brain connection status.



    Huomautus: Vuorovaikutteisen päätelaitteen käyttämiseksi aivojen tai ohjaimen on oltava kytkettynä tietokoneeseen, jossa on käynnissä VEX VS Code Extension.
    Huomautus: Vuorovaikutteisen päätelaitteen tuloste tyhjennetään oletusarvoisesti käyttäjäohjelman rakentamisen ja lataamisen jälkeen.

Työkalupalkki

Työkalupalkki sisältää joukon kuvakkeita, jotka tarjoavat meille nopean tavan olla vuorovaikutuksessa VEX VS Code -laajennusprojektien, VEX Brainsin ja VEX-ohjaimien kanssa.

VS Code -työkalurivi VEX-laajennuskuvakkeilla, joiden avulla voi nopeasti olla vuorovaikutuksessa yhdistettyjen VEX-laitteiden ja -projektien kanssa. VEX-ominaisuuksiin kuuluvat laitteen valitsin, paikan valitsin, & latauskuvake, toistokuvake, pysäytyskuvake, projektivalitsin ja Python-tiedostovalitsin.

Huomautus: Työkalupalkki on aktiivinen vain, kun kelvollinen VEX-projekti on avoinna VS Codessa. 

Huomautus: Kelvollinen VEX-projekti on laajennuksen luoma tai tuoma projekti. Editorissa avattuja VEXcode- tai VEXcode Pro -projekteja ei pidetä kelvollisena VEX-projektina ja ne on tuotava.

Työkalupalkin kuvakkeet sisältävät:

  • Laitevalitsimen kuvake näkyy VS Coden työkalupalkissa. Laitevalitsin - Laitevalitsin näyttää yhdistetyn VEX-laitteen kuvakkeen (aivokuvake Device Picker icon is highlighted on the VS Code toolbar. In this example it shows a Brain icon and it reads IQ Brain(IQ). tai ohjainkuvake Device Picker icon is highlighted on the VS Code toolbar. In this example it shows a Controller icon and it reads IQ Controller.)
    Huomautus: Jos ohjain on yhdistetty tietokoneeseen, mutta sillä ei ole radioyhteyttä aivoihin, ohjainkuvakkeen vieressä ei näy aivojen nimeä.
  • Paikanvalitsimen kuvake. Slot Selector Icon - Slot Selector Icon antaa meille mahdollisuuden valita, minkä paikan VEX Extension lataa tai toistaa käyttäjäohjelman napsauttamalla sitä ja valitsemalla yhden VEX Brainin kahdeksasta käytettävissä olevasta paikasta valintaluettelosta.
  • Rakenna ja lataa -kuvake. Kokoonpano & latauskuvake - Jos VEX-laite on kytketty, latauskuvake näkyy työkalupalkissa. Kun napsautat, projekti rakennetaan ja onnistuessaan ladataan liitettyyn VEX-laitteeseen.
  • Toista-kuvake. Play -kuvake - Napsauttamalla Play -kuvaketta ajaa ladatun käyttäjäohjelman valitussa paikassa VEX Brainissa.
  • Pysäytyskuvake. Pysäytyskuvake - Napsauttamalla Stop-kuvaketta lopettaa käyttäjäohjelman suorittamisen VEX Brainissa.
  • Projektinvalitsin näkyy VS Coden työkalupalkissa. Tässä esimerkissä se lukee IQ_Test. Project Selector - Project Selector näyttää valitun projektin nimen. Project Selector -kuvakkeen avulla voimme vaihtaa VEX-projektien välillä, kun työtilassa on useita, napsauttamalla sitä ja valitsemalla projektin valintaluettelosta.
  • Python-tiedostonvalitsimen kuvake näkyy VS Code -työkalurivillä. Tässä esimerkissä se lukee main.py. Python File Selector (vain Python) - Kun VEX Python -projekti valitaan, Python File Selector tulee näkyviin työkalupalkkiin. Python-tiedoston valitsin näyttää valitun Python-tiedoston nimen. Python for VEX tukee tällä hetkellä vain yksittäisten tiedostojen latausta.

Saat hyödyllisiä tietoja työkalupalkin ominaisuuksien käyttämisestä VS Codessa tästä artikkelista.

VEX-käyttäjäasetukset

VEX-käyttäjäasetusten avulla voimme konfiguroida VEX Extension n omien tarpeidemme mukaan. Käyttäjäasetukset ovat yleisiä asetuksia, joita sovelletaan jokaiseen VEX VS Code -laajennusprojektiin. Pääsemme VEX User Settings een napsauttamalla Asetukset-kuvaketta VS Codessa ja valitsemalla vastaavat kohdat valikoista.

VS Coden käyttäjäasetukset avataan VEX-luokkaan, jossa VEX-robotiikkalaajennuksen toimintaa voidaan mukauttaa.

VEX-käyttäjäasetukset VEX VS -koodilaajennuksen määrittämiseksi ovat:

  • Ohjainkanava (vain V5-ohjain) - Asettaa V5-ohjaimen radiokanavan arvoon Download tai Pit. Tämä asetus koskee vain VEXnet-radiolinkkiä.
  • Cpp Toolchain Path - Asettaa polun CPP Toolchainille.
  • Ota User Terminalkäyttöön – Ottaa käyttöön tai poistaa käytöstä laajennuksen, joka avaa ja näyttää tietoja käyttäjäportista.
  • Lokimerkintöjä - Asettaa VEX Brainista ladattavien lokimerkintöjen määrän.
  • Project Build Type - Määrittää, kuinka laajennus rakentaa C++-projektin.
  • Projektin koti - Asettaa oletussijainnin uusille projekteille.
  • Suorita latauksen jälkeen - Asettaa, tuleeko käyttäjäohjelman suorittaa sen jälkeen, kun se on ladattu VEX Brainiin.
  • Järjestelmän DFU:n automaattinen palautus – Asettaa, palautuuko aivot automaattisesti, kun IQ2 tai EXP havaitaan DFU-tilassa.
  • Websocket Server Enable - Ottaa käyttöön tai poistaa käytöstä laajennuksen Websocket-palvelimen käynnistämiseksi.
  • Websocket-palvelimen isäntäosoite - Asettaa Websocket-palvelimen isäntäosoitteen.
  • Websocket-palvelimen portti - Asettaa Websocket-palvelimen portin numeron

Saat hyödyllisiä tietoja VEX-käyttäjäasetusten käyttämisestä ja asettamisesta tästä artikkelista.

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

Last Updated: