Ez a cikk a VEX Visual Studio Code Extension UI (felhasználói felület) áttekintése. A bővítmény támogatja a C++ és Python projektek fejlesztését VEX IQ 2nd Generation, EXP és V5 platformokhoz.
UI összetevők
A VEX VS Code Extension 3 fő összetevője van.
- Eszköztár
- Activity Bar és Side Bar
- Terminál panel
Eszköztár
Az eszköztár segítségével a felhasználók gyorsan kapcsolatba léphetnek a VEX VS Code kiterjesztési projektekkel, VEX Brains és VEX Controllers. Az eszköztár csak akkor aktív, ha egy érvényes VEX projekt meg van nyitva a VS Codeben. Az érvényes VEX projekt olyan projekt, amelyet a bővítmény hozott létre vagy importált. A VEXcode vagy VEXcode Pro projekt megnyitása nem érvényes, és importálni kell.
Eszközválasztó
Az eszközválasztónak két fő funkciója van. Először egy agy vagy vezérlő ikont jelenít meg, amely a csatlakoztatott VEX eszköz típusát képviseli.
Másodszor, amikor az eszközlista ikonjára kattint, megjelenik egy gyors kiválasztási lista az összes csatlakoztatott VEX-eszközzel. A felhasználó kiválaszthatja, hogy a bővítmény melyik eszközhöz csatlakozzon.
Az aktuálisan csatlakoztatott eszköz mindig a lista tetején jelenik meg, majd az összes többi eszköz, eszköztípus (agy vagy vezérlő) és platform (IQ 2nd Generation, EXP és V5) szerint rendezve.
Minden eszközelem tartalmazza az agy nevét, platformját, eszköztípusát és az eszköz elérési útját.
Fontos
Ha egy vezérlő csatlakozik egy számítógéphez, de nincs rádiókapcsolata az agyhoz, akkor az agy neve nem jelenik meg a listaelem vagy az eszközlista állapotsorának ikonja mellett.
Slot Selector
A helyválasztó ikon lehetővé teszi a felhasználó számára, hogy kiválassza, hogy a bővítmény melyik nyíláson tölt le vagy játssza le a felhasználói programot.
Ha a bővítőhely-választó ikonra kattint, megjelenik egy gyors kiválasztási lista az elérhető felhasználói programok 1-8.
Build/Download
A Build/Download ikon funkciója megváltozik, ha VEX Brain vagy VEX Controller van csatlakoztatva.
Ha nincs VEX-eszköz csatlakoztatva, akkor megjelenik a build ikon. Ha rákattint, a projekt csak felépül.
Ha VEX-eszköz van csatlakoztatva, akkor megjelenik a letöltés ikon. Ha rákattint, a projekt létrejön, és ha sikeres, letöltődik a VEX eszközre.
Játék
A lejátszás ikonra kattintva elindítja a felhasználói programot a kiválasztott nyílásban.
Állj meg
A stop ikonra kattintva leállítja a felhasználói programot.
Kiválasztott munkaterület
A VS Code támogatja a több munkaterületű projekteket. A projektválasztó lehetővé teszi a felhasználók számára, hogy váltsanak a VEX projektek között, ha több is létezik a munkaterületen belül.
Ha a projektválasztó ikonra kattint, megjelenik egy gyors kiválasztási lista az összes érvényes projekttel.
Fontos
Ha egy projekt nem érvényes, akkor nem jelenik meg a projekt gyors kiválasztási listán. Egy projekt csak akkor érvényes, ha a VEX VS Code bővítmény hozta létre vagy importálta.
Python fájlválasztó (csak Python)
Ha egy VEX python projekt van kiválasztva, a python fájlválasztó megjelenik az eszköztáron. A Python for VEX jelenleg csak egyetlen fájl letöltését támogatja.
Ha az ikonra kattint, megjelenik egy gyors kiválasztási lista a munkaterület-könyvtárban található összes python-fájllal.
A python fájlválasztó lehetővé teszi a felhasználó számára, hogy váltson a python forrásfájlok (.py) között
VEX Activity Bar és Sidebar
Projektek Akciók
A vex tevékenységsáv tartalmazza a Project Actions nézetet és a VEX Device Info nézetet.
A Projektműveletek nézet új projekt létrehozására vagy meglévő VEXcode vagy VEXcode Pro projekt importálására szolgál.
Az új projekt létrehozásával kapcsolatos további információkért tekintse meg ezt a cikket!
A verzióinformációk a nézet bal és jobb alsó sarkában is megjelennek.
Fontos
Ha egy VEXcode vagy VEXcode Pro projekt meg van nyitva a szerkesztőben, akkor az nem tekinthető érvényes VEX projektnek, a projektet a VEX oldalsávon található Import gombbal kell importálni.
VEX eszköz információ
A VEX Device Info nézet áttekintést nyújt a felhasználó számára a csatlakoztatott VEX Brain vagy VEX Controllerről. A VEXos verzió, a soros port elérési útja, a felhasználói program és az eszköz információi mind megtalálhatók ebben a nézetben. Ezen a nézeten keresztül más funkciók is végrehajthatók, mint például a VEXos firmware-frissítések, képernyőképek, az agy nevének beállítása és a csapatszám beállítása.
Rendszer információ
A rendszerinformációk rövid áttekintést nyújtanak a csatlakoztatott VEX-eszközről. Ez magában foglalja az eszköz VEXos verzióját, az agy nevét, a csapat számát, a Brain ID-t és a python futásidejű verziószámát.
Soros port információ
A soros port információi megjelenítik az eszköz elérési útját minden egyes VEX-eszközhöz elérhető porthoz. A legtöbb VEX eszköz két soros portként szerepel. A kommunikációs soros port a programok letöltésére és az agyi funkciók vezérlésére szolgál. A felhasználói soros port az Agyon futó felhasználói alkalmazás és az USB-n keresztül csatlakoztatott gazdagép közötti adatátvitelre szolgál. A V5 Controller az egyetlen VEX eszköz, amely csak kommunikációs soros porttal rendelkezik, felhasználói soros port nélkül.
Programok információi
A programinformációk megjelenítik a VEX Brain összes letöltött felhasználói programjának listáját.
Minden programlista elem kibővíthető, hogy további információkat jelenítsen meg az egyes felhasználói programokról, mint például a hely helye, fájlnév, nyelvtípus, fájlméret és letöltési idő.
Eszközök információi
Az eszközök információi a VEX Brainhez csatlakoztatott összes intelligens port eszköz listáját jelenítik meg. Minden listaelem mutatja az intelligens port számát és az eszköz típusát.
Az Eszközlista minden eleme kibővíthető, hogy megjelenítse az egyes intelligens port-eszközök firmware-verzióját.
A vezérlővel összekapcsolt állapot akkor jelenik meg, ha csatlakozik a VEX Brain Device-hez.
A VEX Brain egy VEX vezérlőhöz kapcsolódik
A VEX Brain nem kapcsolódik VEX vezérlőhöz
A VEX V5 vezérlő egy VEX V5 Brainhez van kötve
Képernyőképek
A Kamera ikonra kattintva a felhasználó képernyőképet készíthet és letölthet a VEX Brainből.
Képernyőképek csak akkor érhetők el, ha közvetlenül csatlakozik a VEX Brainhez USB-n keresztül
Battery Medic (csak V5 Brain)
A Szív ikonra kattintva a bővítmény letölti és futtatja az akkumulátoros medic felhasználói programot.
Állítsa be az agy nevét
A rendszer>név melletti Ceruza ikonra kattintva a felhasználó beállíthatja a VEX Brain nevét.
Miután a Ceruza ikonra kattintott, egy beviteli mező jelenik meg a VS Code szerkesztő tetején. Írja be az új agy nevét a beviteli mezőbe, és nyomja meg az Enter billentyűt a beállításhoz.
Csapatszám beállítása
A rendszer->csapat melletti Ceruza ikonra kattintva a felhasználó beállíthatja a VEX Brain csapatszámát.
Miután a Ceruza ikonra kattintott, egy beviteli mező jelenik meg a VS Code szerkesztő tetején. Írja be az új csapat számát a beviteli mezőbe, és nyomja meg az Enter billentyűt a beállításhoz.
Felhasználói program törlése
A Programs->projekt neve melletti Trashcan ikonra kattintva a felhasználó törölhet egy programot egy adott nyílásban. FONTOS, ha töröl egy programot, azt nem lehet visszaállítani. Kérjük, legyen körültekintő a funkció használatakor.
Eszközinformációs figyelmeztetések
VEXos frissítés
Ha egy VEX Brain VEXos verziója elavult, egy figyelmeztető üzenet ikon jelenik meg a VEXos verzió mellett, és mindkét Brain ikon sárgára vált.
Ennek a figyelmeztetésnek a megoldásához a felhasználónak frissítenie kell a VEXos-t a VEXos agyához.
A VEXo-kat a VEX Brain ikon melletti felfelé mutató nyílra kattintva frissítheti.
A VS Code szerkesztő jobb alsó sarkában egy értesítési mező is megjelenik, ha a VEXos elavult. A felhasználó elindíthatja a VEXos frissítést a „Frissítés” gombra kattintva, vagy az „Ignore” gombra kattintva kihagyhatja a VEXos frissítést.
Az agy nincs összekapcsolva a csatlakoztatott vezérlővel
A VEX vezérlő ikonja sárgára vált, ha egy VEX vezérlő csatlakozik egy számítógéphez, de nincs összekapcsolva a VEX Brain rendszerrel.
A figyelmeztetés feloldásához a felhasználónak össze kell kapcsolnia egy VEX vezérlőt egy VEX Brain rendszerrel
Terminál panel
A VEX VS Code Extension két terminált biztosít indításkor, a naplóterminált és az interaktív terminált
Naplóterminál
A Log Terminal megjeleníti az összeállítási kimenetet, az összeállítási hibát és a letöltési eredményeket.
Interaktív terminál
Az interaktív terminálnak két funkciója van, a printf naplók megjelenítése és a nyers billentyűleütések visszaküldése egy felhasználói programnak. Az Interaktív terminál előnyeinek kihasználásához egy agyat vagy vezérlőt kell csatlakoztatni a VEX VS Code Extensiont futtató számítógéphez. Az interaktív terminál kimenete alapértelmezés szerint törlődik a felhasználói program felépítése és letöltése után.
Felhasználói beállítások
A felhasználói beállítások olyan globális beállítások, amelyeket a Visual Studio kód kínál az egyes bővítményekhez. A felhasználói beállítások minden VEX VS Code kiterjesztési projektre vonatkoznak.
Hogyan lehet elérni a VEX felhasználói beállításait
Kattintson a fogaskerékre a VS Code bal sarkában, és megjelenik egy helyi menü
A helyi menüben kattintson a „Beállítások” elemre, és megjelenik egy beállítási oldal.
A bal oldali listanézetben kattintson a „Bővítmények” elemre. Ezután görgessen le az aljára, és keresse meg a „VEX” feliratú elemet.
Kattintson a „VEX” listaelemre.
A VEX User beállítások a jobb oldali panelen jelennek meg.
Beállítások áttekintése
Vezérlőcsatorna (csak V5 vezérlő)
A Controller Channel beállítás vezérli a rádiókommunikációs csatorna típusát a V5 Brain és a V5 Controller között.
Ez a beállítás csak akkor érvényes, ha a VS Code egy V5-ös vezérlőhöz van csatlakoztatva USB-n keresztül, és a vezérlő csatlakozik a V5-ös agyhoz VEXneten keresztül. A felhasználó Download és Pit csatorna közül választhat. Ha Letöltésértékre van állítva, a rádió egy letöltő VEXnet csatornára ugrik, amint a felhasználói program letöltése elindul. A letöltési csatorna nagyobb adatátviteli sebességet és hatékonyabb letöltést tesz lehetővé. Ha Pitvan állítva, a rádió egy pitcsatornán marad, és a letöltés sokkal tovább tart. Alapértelmezés szerint ez a beállítás Letöltés.
Cpp Project SDK főoldal
NE SZERKESZTSE EZT A BEÁLLÍTÁST.
Cpp Toolchain Path
Cpp Toolchain Path beállítja a C++ VEX VS Code projekt felépítéséhez használt eszközlánc elérési útját.
Felhasználói terminál engedélyezése
A Enable User Terminal beállítás lehetővé teszi a bővítmény számára a felhasználói soros port megnyitását, ha a bővítmény VEX Brain-t vagy VEX-vezérlőt észlel. Az egyetlen kivétel a V5 vezérlőkre vonatkozik, amelyek nem tartalmaznak felhasználói soros portot.
Engedélyezés lehetővé teszi a bővítmény számára, hogy csatlakozzon egy felhasználói porthoz indításkor, és létrehozza az interaktív terminált. Ha az Engedélyezés van kiválasztva, miközben a bővítmény fut, a bővítmény megpróbálja megnyitni a felhasználói portot, ha eszköz csatlakozik.
A Disable megakadályozza, hogy a bővítmény indításkor csatlakozzon a felhasználói porthoz, és nem hoz létre interaktív terminált. Ha a letiltást választja, miközben a bővítmény fut, a bővítmény bezárja a felhasználói portot, és eltávolítja az interaktív terminált.
Projekt felépítési típusa
A Project Build Type beállítja, hogy a bővítmény hogyan építsen fel egy C++ projektet. A felhasználó beállíthatja a build típusát Build vagy Rebuild értékre.
Build csak akkor építse fel a projektet, ha a Make bármilyen változást észlel a projekt forráskódjában.
A Rebuild megtisztítja a projekt összeállítási könyvtárát, majd összeállítja a projektet. Ez az opció általában sokkal lassabb.
Project Home
A Project Home beállítja az új projekt alapértelmezett kezdőkönyvtárát az Új projekt varázsló végrehajtásakor.
Futtassa a letöltés után
Futtatás letöltés után Ha engedélyezve van, a felhasználói program lefut, miután letöltötte a VEX Brainbe.
Python SDK főoldal
NE SZERKESZTSE EZT A BEÁLLÍTÁST.
VEX Command Help
A VEX Command Help hozzáférést biztosít a C++ és a Python API-ban (Application Programming Interface) található specifikus funkciók dokumentációjához. A dokumentáció minden VEX platformra jellemző (IQ 2nd Generation, EXP, V5).
A VEX Command Help eléréséhez először jelölje ki a keresendő funkció szövegét.
Kattintson a jobb gombbal a kiválasztott szövegre, és megjelenik egy helyi menü.
Következő Kattintson a VEX Command Help-re a dokumentáció eléréséhez.
Ha a VEX Command Help pontos egyezést talál, egy új webnézet jelenik meg a megfelelő dokumentációval.
Ha több dokumentum egyezik a kiválasztott szöveggel, akkor egy legördülő menü jelenik meg a releváns dokumentációk szűrt listájával.