Šis raksts ir pārskats par VEX Visual Studio koda paplašinājuma UI (lietotāja interfeisu). Paplašinājums atbalsta C++ un Python projektu izstrādi VEX IQ 2nd Generation, EXP un V5 platformām.
UI komponenti
VEX VS koda paplašinājumam ir 3 galvenie komponenti.
- Rīkjosla
- Aktivitāšu josla un sānjosla
- Termināļa panelis
Rīkjosla
Rīkjosla sniedz lietotājiem ātru veidu, kā mijiedarboties ar VEX VS Code paplašinājuma projektiem VEX Brains un VEX Controllers. Rīkjosla ir aktīva tikai tad, ja ir atvērts derīgs VEX projekts VS kodā. Derīgs VEX projekts ir projekts, ko izveido vai importē paplašinājums. VEXcode vai VEXcode Pro projekta atvēršana nav derīga, un tā būs jāimportē.
Ierīces atlasītājs
Ierīces atlasītājam ir divas galvenās funkcijas. Pirmkārt, tiek parādīta smadzeņu vai kontrollera ikona, kas attēlo pievienoto VEX ierīces veidu.
Otrkārt, noklikšķinot uz ierīču saraksta ikonas, tiek parādīts ātrās atlases saraksts ar visām pievienotajām VEX ierīcēm. Lietotājs var izvēlēties, ar kuru ierīci paplašinājums izveidos savienojumu.
Pašreizējā pievienotā ierīce vienmēr būs redzama saraksta augšdaļā, kam sekos visas pārējās ierīces, kas sakārtotas pēc ierīces veida (Brain vai Controller) un platformas (IQ 2nd Generation, EXP un V5).
Katrs ierīces vienums satur smadzeņu nosaukumu, platformu, ierīces veidu un ierīces ceļa informāciju.
Svarīgs
Ja kontrolleris ir savienots ar datoru, bet tam nav radiosaites ar smadzenēm, blakus saraksta vienumam vai ierīču saraksta statusa joslas ikonai smadzeņu nosaukums netiks parādīts.
Slotu atlasītājs
Slotu atlasītāja ikona ļauj lietotājam izvēlēties, kurā slotā paplašinājums lejupielādēs vai atskaņos lietotāja programmu.
Kad tiek noklikšķināts uz slota atlasītāja ikonas, tiek parādīts ātrās izvēles saraksts ar pieejamajiem lietotāja programmu slotiem 1-8.
Veidot/lejupielādēt
Ikona Build/Download maina funkcijas, ja ir pievienots VEX Brain vai VEX Controller.
Ja VEX ierīce nav pievienota, tiek parādīta uzbūves ikona. Noklikšķinot, projekts tiks veidots tikai.
Ja ir pievienota VEX ierīce, tiek parādīta lejupielādes ikona. Noklikšķinot, projekts tiks izveidots un, ja tas būs veiksmīgs, tiks lejupielādēts VEX ierīcē.
Spēlēt
Noklikšķinot uz atskaņošanas ikonas, tiek palaista lietotāja programma atlasītajā slotā.
Stop
Apturēšanas ikona, noklikšķinot uz tā, aptur lietotāja programmu.
Atlasītā darbvieta
VS Code atbalsta vairāku darbvietu projektus. Projektu atlasītājs ļauj lietotājiem pārslēgties starp VEX projektiem, ja darbvietā ir vairāki.
Noklikšķinot uz projektu atlasītāja ikonas, tiek parādīts ātrās atlases saraksts ar visiem derīgajiem projektiem.
Svarīgi
Ja projekts nav derīgs, tas netiks rādīts projekta ātrās atlases sarakstā. Projekts nav derīgs, ja vien tas nav izveidots vai importēts ar VEX VS Code paplašinājumu.
Python failu atlasītājs (tikai Python)
Kad ir atlasīts VEX python projekts, rīkjoslā parādīsies python failu atlasītājs. Python for VEX pašlaik atbalsta tikai viena faila lejupielādi.
Noklikšķinot uz ikonas, tiek parādīts ātrās izvēles saraksts ar visiem python failiem, kas atrodas darbvietas direktorijā.
Python failu atlasītājs ļauj lietotājam pārslēgties starp python avota failiem (.py)
VEX aktivitāšu josla un sānjosla
Projekti Darbības
Sarežģīto darbību joslā ir skats Project Actions un VEX Device Info skats.
Skats Projekta darbības tiek izmantots, lai izveidotu jaunu projektu vai importētu esošu VEXcode vai VEXcode Pro projektu.
Lai iegūtu papildinformāciju par jauna projekta izveidi, skatiet šo rakstu!
Versijas informācija tiek parādīta arī skata apakšējā kreisajā un labajā stūrī.
Svarīgi
Ja VEXcode vai VEXcode Pro projekts ir atvērts redaktorā, tas netiks uzskatīts par derīgu VEX projektu, projekts ir jāimportē, izmantojot VEX sānjoslas pogu Importēt.
Informācija par VEX ierīci
Skats VEX Device Info sniedz lietotājam pārskatu par pievienoto VEX Brain vai VEX kontrolieri. Šajā skatā var atrast VEXos versiju, seriālā porta ceļu, lietotāja programmu un informāciju par ierīci. Izmantojot šo skatu, var veikt arī citas funkcijas, piemēram, VEXos programmaparatūras atjauninājumus, ekrānuzņēmumus, smadzeņu nosaukuma un iestatījumu komandas numura iestatīšanu.
Sistēmas informācija
Sistēmas informācija sniedz īsu pārskatu par pievienoto VEX ierīci. Tas ietver ierīces VEXos versiju, smadzeņu nosaukumu, komandas numuru, smadzeņu ID un informāciju par python izpildlaika versiju.
Informācija par seriālo portu
Seriālā porta informācija parāda ierīces ceļu katram portam, kas pieejams VEX ierīcei. Lielākā daļa VEX ierīču ir uzskaitītas kā divi seriālie porti. Sakaru seriālo portu izmanto programmu lejupielādei un smadzeņu funkciju kontrolei. Lietotāja seriālais ports tiek izmantots, lai pārsūtītu datus starp lietotāja lietotni, kas darbojas Brain, un resursdatoru, kas pievienots, izmantojot USB. V5 kontrolieris ir vienīgā VEX ierīce, kurai ir tikai sakaru seriālais ports un nav lietotāja seriālā porta.
Programmu informācija
Programmas informācija parāda visu VEX Brain lejupielādēto lietotāju programmu sarakstu.
Katru programmu saraksta vienumu var paplašināt, lai parādītu papildu informāciju par katru lietotāja programmu, piemēram, slota atrašanās vietu, faila nosaukumu, valodas veidu, faila lielumu un lejupielādes laiku.
Informācija par ierīcēm
Ierīču informācija parāda visu viedo portu ierīču sarakstu, kas savienotas ar VEX Brain. Katrs saraksta vienums parāda viedā porta numuru un ierīces veidu.
Katru ierīču saraksta vienumu var paplašināt, lai parādītu programmaparatūras versijas informāciju par katru viedporta ierīci.
Kontrolierim piesaistītais statuss tiek parādīts, kad ir izveidots savienojums ar VEX Brain Device.
VEX Brain ir saistīts ar VEX kontrolieri
VEX Brain nav saistīts ar VEX kontrolieri
VEX V5 kontrolieris ir piesaistīts VEX V5 Brain
Ekrānuzņēmumi
Noklikšķinot uz kameras ikonas, lietotājs var uzņemt un lejupielādēt ekrānuzņēmumu no VEX Brain.
Ekrānuzņēmumi ir pieejami tikai tad, ja tie ir tieši savienoti ar VEX Brain, izmantojot USB
Battery Medic (tikai V5 Brain)
Noklikšķinot uz Sirds ikonas, paplašinājums lejupielādēs un palaidīs akumulatora medicīnas lietotāja programmu.
Iestatiet smadzeņu nosaukumu
Noklikšķinot uz zīmuļa ikonas blakus sistēmas>nosaukumam, lietotājs var iestatīt VEX Brain nosaukumu.
Pēc noklikšķināšanas uz zīmuļa ikonas VS koda redaktora augšdaļā parādīsies ievades lodziņš. Ievades lodziņā ierakstiet jauno smadzeņu nosaukumu un nospiediet taustiņu Enter, lai iestatītu.
Iestatiet komandas numuru
Noklikšķinot uz zīmuļa ikonas blakus system->team, lietotājs var iestatīt komandas numuru VEX Brain.
Pēc noklikšķināšanas uz zīmuļa ikonas VS koda redaktora augšdaļā parādīsies ievades lodziņš. Ievades lodziņā ierakstiet jauno komandas numuru un nospiediet taustiņu Enter, lai iestatītu.
Dzēst lietotāja programmu
Noklikšķinot uz ikonas Trashcan blakus programmas>projekta nosaukumam, lietotājs var izdzēst programmu noteiktā slotā. SVARĪGI, kad esat izdzēsis programmu, to nevar atgūt. Lūdzu, esiet piesardzīgs, izmantojot šo funkciju.
Ierīces informācijas brīdinājumi
VEXos atjauninājums
Ja VEX Brain VEXos versija ir novecojusi, blakus VEXos versijai tiek parādīta brīdinājuma ziņojuma ikona un abas Brain ikonas kļūst dzeltenas.
Lai novērstu šo brīdinājumu, lietotājam ir jāatjaunina VEXos savam VEXos Brain.
VEXos var atjaunināt, noklikšķinot uz augšupvērstās bultiņas blakus VEX Brain ikonai.
Ja VEXos ir novecojis, VS koda redaktora apakšējā labajā stūrī parādīsies arī paziņojumu lodziņš. Lietotājs var sākt VEXos atjauninājumu, noklikšķinot uz pogas “Atjaunināt” vai noklikšķinot uz pogas “Ignorēt”, lai izlaistu VEXos atjauninājumu.
Smadzenes nav saistītas ar pievienoto kontrolieri
VEX Controller ikona kļūs dzeltena, kad VEX Controller ir pievienots datoram, bet nav saistīts ar VEX Brain.
Lai novērstu šo brīdinājumu, lietotājam jāsaista VEX kontrolleris ar VEX Brain
Termināļa panelis
VEX VS koda paplašinājums startēšanas laikā nodrošina divus terminālus, žurnālu termināli un interaktīvo termināli
Baļķu terminālis
Žurnāla terminālī tiek parādīta būvējuma izvade, izveides kļūda un lejupielādes rezultāti.
Interaktīvais terminālis
Interaktīvajam terminālim ir divas funkcijas: drukas žurnālu parādīšana un neapstrādātu taustiņsitienu nosūtīšana atpakaļ uz lietotāja programmu. Lai izmantotu Interaktīvā termināļa priekšrocības, Brain vai Controller ir jāpievieno datoram, kurā darbojas VEX VS koda paplašinājums. Interaktīvā termināļa izvade pēc noklusējuma tiek notīrīta pēc lietotāja programmas izveides un lejupielādes.
Lietotāja iestatījumi
Lietotāja iestatījumi ir globālo iestatījumu iestatījumi, ko vizuālās studijas kods piedāvā katram paplašinājumam. Lietotāja iestatījumi tiek lietoti katram VEX VS Code paplašinājuma projektam.
Kā piekļūt VEX lietotāja iestatījumiem
Noklikšķiniet uz zobrata VS Code kreisajā stūrī, un tiks parādīta konteksta izvēlne
Konteksta izvēlnē noklikšķiniet uz vienuma “Iestatījumi”, un tiks parādīta iestatījumu lapa.
Kreisajā saraksta skatā noklikšķiniet uz vienuma “Paplašinājumi”. Pēc tam ritiniet uz leju līdz apakšai un atrodiet vienumu ar nosaukumu “VEX”.
Noklikšķiniet uz saraksta vienuma “VEX”.
VEX lietotāja iestatījumi tiks parādīti labajā panelī.
Iestatījumu pārskats
Kontrollera kanāls (tikai V5 kontrolieris)
Iestatījums Controller Channel kontrolē radio sakaru kanāla veidu starp V5 Brain un V5 Controller.
Šis iestatījums ir spēkā tikai tad, ja VS Code ir savienots ar V5 kontrolieri, izmantojot USB, un kontrolleris ir savienots ar V5 Brain, izmantojot VEXnet. Lietotājs var izvēlēties starp Lejupielādes un Pit kanāliem. Ja iestatīts uz Lejupielādēt, radio pārslēgsies uz lejupielādes VEXnet kanālu, tiklīdz tiks uzsākta lietotāja programmas lejupielāde. Lejupielādes kanāls nodrošina lielāku datu pārraides ātrumu un efektīvāku lejupielādi. Ja iestatīts uz Pit, radio paliks bedres kanālā un lejupielāde prasīs daudz ilgāku laiku. Pēc noklusējuma šis iestatījums ir iestatīts uz Lejupielādēt.
Cpp Project SDK sākumlapa
NEREDIĢĒJIET ŠO IESTATĪJUMU.
Cpp rīkķēdes ceļš
Cpp Toolchain Path iestata ceļu rīku ķēdei, kas tiek izmantota, veidojot C++ VEX VS Code projektu.
Iespējot lietotāja termināli
Iestatījums Iespējot lietotāja termināli ļauj paplašinājumam atvērt lietotāja seriālo portu, kad paplašinājums nosaka VEX Brain vai VEX kontrolleri. Vienīgais izņēmums attiecas uz V5 kontrolleri, kuram nav norādīts lietotāja seriālais ports.
Iespējot ļauj paplašinājumam startēšanas laikā izveidot savienojumu ar lietotāja portu un izveidot interaktīvo termināli. Ja paplašinājuma darbības laikā ir atlasīta opcija Iespējot, paplašinājums mēģinās atvērt lietotāja portu, ja ierīce ir pievienota.
Atspējot neļauj paplašinājumam izveidot savienojumu ar lietotāja portu startēšanas laikā un neizveidos interaktīvo termināli. Ja paplašinājuma darbības laikā ir atlasīta opcija Atspējot, paplašinājums aizvērs lietotāja portu un noņems interaktīvo termināli.
Projekta veidošanas veids
Project Build Type nosaka, kā paplašinājums veidos C++ projektu. Lietotājs var iestatīt būvējuma veidu uz Build vai Rebuild.
Build veido projektu tikai tad, kad Make nosaka jebkādas izmaiņas projekta avota kodā.
Rebuild notīra projekta būvēšanas direktoriju un pēc tam veido projektu. Šī opcija parasti ir daudz lēnāka.
Projekta mājas lapa
Project Home iestata noklusējuma mājas direktoriju jaunam projektam, pabeidzot New Project vedni.
Palaist pēc lejupielādes
Palaist pēc lejupielādes ja ir iespējots, lietotāja programma sāk darboties pēc tam, kad tā ir lejupielādēta VEX Brain.
Python SDK sākumlapa
NEREDIĢĒJIET ŠO IESTATĪJUMU.
VEX komandu palīdzība
VEX komandu palīdzība ļauj piekļūt dokumentācijai par specifiskām funkcijām, kas iekļautas C++ un Python API (lietojumprogrammu saskarnē). Dokumentācija ir specifiska katrai VEX platformai (IQ 2nd Generation, EXP, V5).
Lai piekļūtu VEX komandu palīdzībai, vispirms iezīmējiet meklējamās funkcijas tekstu.
Ar peles labo pogu noklikšķiniet uz atlasītā teksta, un parādīsies konteksta izvēlne.
Nākamais Noklikšķiniet uz VEX Command Help, lai piekļūtu dokumentācijai.
Ja VEX Command Help atrod precīzu atbilstību, tiks parādīts jauns tīmekļa skats ar attiecīgo dokumentāciju.
Ja atlasītajam tekstam atbilst vairāki dokumenti, tiks parādīta nolaižamā izvēlne ar filtrētu atbilstošās dokumentācijas sarakstu.