Ten artykuł zawiera omówienie interfejsu użytkownika rozszerzenia kodu programu VEX Visual Studio (interfejs użytkownika). Rozszerzenie wspiera rozwój projektów C++ i Python dla platform VEX IQ 2. generacji, EXP i V5.
Komponenty interfejsu użytkownika
Istnieją 3 główne komponenty rozszerzenia kodu VEX VS.
- pasek narzędzi
- Pasek aktywności i pasek boczny
- Panel terminala
pasek narzędzi
Pasek narzędzi umożliwia użytkownikom szybką interakcję z projektami rozszerzeń VEX VS Code , VEX Brains i VEX Controllers. Pasek narzędzi jest aktywny tylko wtedy, gdy prawidłowy projekt VEX jest otwarty w VS Code. Prawidłowy projekt VEX to projekt utworzony lub zaimportowany przez rozszerzenie. Otwarcie projektu VEXcode lub VEXcode Pro jest nieprawidłowe i należy go zaimportować.
Wybór urządzeń
Selektor urządzeń ma dwie główne funkcje. Najpierw wyświetla ikonę mózgu lub kontrolera reprezentującą typ podłączonego urządzenia VEX.
Po drugie, po kliknięciu ikony listy urządzeń pojawia się lista szybkiego wyboru ze wszystkimi podłączonymi urządzeniami VEX. Użytkownik może wybrać urządzenie, z którym będzie się łączyć rozszerzenie.
Aktualnie podłączone urządzenie będzie zawsze wyświetlane na górze listy, a następnie wszystkie inne urządzenia posortowane według typu urządzenia (mózg lub kontroler) i platformy (IQ 2. generacji, EXP i V5).
Każdy element urządzenia zawiera nazwę Brain, platformę, typ urządzenia i informacje o ścieżce urządzenia.
Ważny
Jeśli kontroler jest podłączony do komputera, ale nie ma połączenia radiowego z mózgiem, obok elementu listy lub ikony na pasku stanu listy urządzeń nie będzie wyświetlana żadna nazwa mózgu.
Selektor slotów
Ikona wyboru gniazda pozwala użytkownikowi wybrać gniazdo, w którym rozszerzenie będzie pobierać lub odtwarzać program użytkownika.
Po kliknięciu ikony wyboru slotu pojawia się lista szybkiego wyboru z dostępnymi slotami programu użytkownika 1-8.
Kompiluj/Pobierz
Ikona budowania/pobierania zmienia funkcje, jeśli podłączony jest VEX Brain lub kontroler VEX.
Jeśli urządzenie VEX nie jest podłączone, wyświetlana jest ikona kompilacji. Po kliknięciu projekt zostanie tylko zbudowany.
Jeśli podłączone jest urządzenie VEX, wyświetlana jest ikona pobierania. Po kliknięciu projekt zostanie skompilowany i, jeśli się powiedzie, zostanie pobrany na urządzenie VEX.
Grać
Ikona odtwarzania po kliknięciu uruchamia program użytkownika w wybranym slocie.
Zatrzymywać się
Kliknięcie ikony zatrzymania powoduje zatrzymanie programu użytkownika.
Wybrany obszar roboczy
VS Code obsługuje projekty z wieloma obszarami roboczymi. Selektor projektów pozwala użytkownikom przełączać się między projektami VEX, gdy w obszarze roboczym istnieje ich wiele.
Po kliknięciu ikony wyboru projektu pojawia się lista szybkiego wyboru zawierająca wszystkie ważne projekty.
Ważne
Jeśli projekt jest nieprawidłowy, nie zostanie wyświetlony na liście szybkiego wyboru projektów. Projekt nie jest ważny, jeśli nie został utworzony lub zaimportowany przez rozszerzenie VEX VS Code.
Selektor plików Pythona (tylko Python)
Po wybraniu projektu VEX Pythona na pasku narzędzi pojawi się selektor plików Pythona. Python dla VEX obsługuje obecnie tylko pobieranie pojedynczych plików.
Po kliknięciu ikony pojawi się lista szybkiego wyboru zawierająca wszystkie pliki Pythona znajdujące się w katalogu obszaru roboczego.
Selektor plików Pythona umożliwia użytkownikowi przełączanie pomiędzy plikami źródłowymi Pythona (.py)
Pasek aktywności i pasek boczny VEX
Projekty Działania
Pasek aktywności vex zawiera widok działań projektu i widok informacji o urządzeniu VEX.
Widok Akcje projektu służy do tworzenia nowego projektu lub importowania istniejącego projektu VEXcode lub VEXcode Pro.
Aby uzyskać więcej informacji na temat tworzenia nowego projektu, sprawdź ten artykuł!
Informacje o wersji są także wyświetlane w lewym i prawym dolnym rogu widoku.
Ważne
Jeśli w edytorze otwarty jest projekt VEXcode lub VEXcode Pro, nie będzie on uważany za prawidłowy projekt VEX, projekt należy zaimportować za pomocą przycisku Importuj na pasku bocznym VEX.
Informacje o urządzeniu VEX
Widok informacji o urządzeniu VEX daje użytkownikowi przegląd podłączonego VEX Brain lub kontrolera VEX. W tym widoku można znaleźć wersję VEXos, ścieżkę portu szeregowego, program użytkownika i informacje o urządzeniu. W tym widoku można również wykonywać inne funkcje, takie jak aktualizacje oprogramowania sprzętowego VEXos, zrzuty ekranu, ustawianie nazwy mózgu i numeru zespołu konfiguracyjnego.
Informacje o systemie
Informacje o systemie zapewniają krótki przegląd podłączonego urządzenia VEX. Obejmuje to wersję VEXos urządzenia, nazwę Brain, numer zespołu, identyfikator Brain i informacje o wersji środowiska wykonawczego Pythona.
Informacje o porcie szeregowym
Informacje o porcie szeregowym wyświetlają ścieżkę urządzenia dla każdego portu dostępnego dla urządzenia VEX. Większość urządzeń VEX ma dwa porty szeregowe. Port szeregowy komunikacyjny służy do pobierania programów i kontrolowania funkcji mózgu. Port szeregowy użytkownika służy do przesyłania danych pomiędzy aplikacją użytkownika działającą na Brain a komputerem hostem podłączonym przez USB. Kontroler V5 jest jedynym urządzeniem VEX, które ma tylko port szeregowy komunikacyjny i nie ma portu szeregowego użytkownika.
Informacje o programach
Informacje o programie wyświetlają listę wszystkich programów użytkownika pobranych na VEX Brain.
Każdy element listy programów można rozwinąć, aby wyświetlić dodatkowe informacje o każdym programie użytkownika, takie jak lokalizacja gniazda, nazwa pliku, typ języka, rozmiar pliku i czas pobierania.
Informacje o urządzeniach
Informacje o urządzeniach przedstawiają listę wszystkich urządzeń Smart Port podłączonych do VEX Brain. Każdy element listy pokazuje numer inteligentnego portu i typ urządzenia.
Każdy element listy urządzeń można rozwinąć, aby wyświetlić informacje o wersji oprogramowania sprzętowego każdego urządzenia z portem inteligentnym.
Stan połączenia kontrolera jest wyświetlany po podłączeniu do urządzenia VEX Brain.
VEX Brain jest połączony z kontrolerem VEX
VEX Brain nie jest połączony z kontrolerem VEX
Kontroler VEX V5 jest podłączony do mózgu VEX V5
Zrzuty ekranu
Klikając ikonę aparatu, użytkownik może wykonać i pobrać zrzut ekranu z VEX Brain.
Zrzuty ekranu są dostępne tylko po bezpośrednim podłączeniu do VEX Brain przez USB
Medyk baterii (tylko mózg V5)
Klikając ikonę Serca, rozszerzenie pobierze i uruchomi program użytkownika baterii medic.
Ustaw nazwę mózgu
Klikając ikonę ołówka obok nazwy systemowej>, użytkownik może ustawić nazwę dla VEX Brain.
Po kliknięciu ikony Ołówek na górze edytora VS Code pojawi się pole wprowadzania. Wpisz nową nazwę mózgu w polu wprowadzania i naciśnij Enter, aby ustawić.
Ustaw numer zespołu
Klikając ikonę ołówka obok zespołu systemowego>, użytkownik może ustawić numer zespołu dla VEX Brain.
Po kliknięciu ikony Ołówek na górze edytora VS Code pojawi się pole wprowadzania. Wpisz nowy numer zespołu w polu wprowadzania i naciśnij klawisz Enter, aby ustawić.
Usuń program użytkownika
Klikając ikonę Trashcan obok nazwy projektu Programy->, użytkownik może usunąć program z określonego slotu. WAŻNE, po usunięciu programu nie można go odzyskać. Podczas korzystania z tej funkcji należy zachować ostrożność.
Ostrzeżenia dotyczące informacji o urządzeniu
Aktualizacja VEXosa
Gdy wersja VEXos VEX Brain jest nieaktualna, obok wersji VEXos pojawia się ikona komunikatu ostrzegawczego, a obie ikony Brain zmieniają kolor na żółty.
Aby rozwiązać to ostrzeżenie, użytkownik powinien zaktualizować VEXos dla swojego VEXos Brain.
VEXos można zaktualizować, klikając strzałkę w górę obok ikony VEX Brain.
Gdy VEXos będzie nieaktualny, w prawym dolnym rogu edytora VS Code pojawi się również okno powiadomienia. Użytkownik może rozpocząć aktualizację VEXos, klikając przycisk „Aktualizuj” lub klikając przycisk „Ignoruj”, aby pominąć aktualizację VEXos.
Mózg nie jest połączony z podłączonym kontrolerem
Ikona kontrolera VEX zmieni kolor na żółty, gdy kontroler VEX będzie podłączony do komputera, ale nie będzie połączony z mózgiem VEX.
Aby rozwiązać to ostrzeżenie, użytkownik powinien połączyć kontroler VEX z mózgiem VEX
Panel terminala
Rozszerzenie kodu VEX VS udostępnia podczas uruchamiania dwa terminale, terminal dziennika i terminal interaktywny
Terminal dziennika
Terminal dziennika wyświetla dane wyjściowe kompilacji, błędy kompilacji i wyniki pobierania.
Interaktywny terminal
Terminal interaktywny ma dwie funkcje: wyświetla dzienniki printf i wysyła nieprzetworzone naciśnięcia klawiszy z powrotem do programu użytkownika. Aby móc korzystać z terminala interaktywnego, mózg lub kontroler musi być podłączony do komputera z zainstalowanym rozszerzeniem kodu VEX VS. Dane wyjściowe terminala interaktywnego są domyślnie czyszczone po zbudowaniu i pobraniu programu użytkownika.
Ustawienia użytkownika
Ustawienia użytkownika to ustawienia globalne, które kod Visual Studio oferuje dla każdego rozszerzenia. Ustawienia użytkownika są stosowane do każdego projektu rozszerzenia VEX VS Code.
Jak uzyskać dostęp do ustawień użytkownika VEX
Kliknij koło zębate w lewym rogu VS Code, a pojawi się menu kontekstowe
W menu kontekstowym kliknij element „Ustawienia”, a pojawi się strona ustawień.
W widoku listy po lewej stronie kliknij element „Rozszerzenia”. Następnie przewiń w dół i znajdź element oznaczony jako „VEX”.
Kliknij pozycję listy „VEX”.
Ustawienia użytkownika VEX pojawią się w prawym panelu.
Przegląd ustawień
Kanał kontrolera (tylko kontroler V5)
Ustawienie Controller Channel steruje typem kanału komunikacji radiowej pomiędzy urządzeniem V5 Brain i kontrolerem V5.
To ustawienie ma zastosowanie tylko wtedy, gdy VS Code jest podłączony do kontrolera V5 przez USB, a kontroler jest podłączony do V5 Brain przez VEXnet. Użytkownik może wybrać pomiędzy kanałami Download i Pit. Po ustawieniu na Pobieranieradio przeskoczy do kanału pobierania VEXnet po rozpoczęciu pobierania programu użytkownika. Kanał pobierania umożliwia wyższą szybkość transmisji danych i wydajniejsze pobieranie. Po ustawieniu na Pitradio pozostanie na kanale Pit, a pobieranie będzie trwało znacznie dłużej. Domyślnie to ustawienie jest ustawione na Pobierz.
Strona główna pakietu SDK projektu Cpp
NIE EDYTUJ TEGO USTAWIENIA.
Ścieżka łańcucha narzędzi Cpp
Cpp Toolchain Path ustawia ścieżkę dla łańcucha narzędzi używanego podczas budowania projektu C++ VEX VS Code.
Włącz terminal użytkownika
Ustawienie Włącz terminal użytkownika umożliwia rozszerzeniu otwarcie portu szeregowego użytkownika, gdy rozszerzenie VEX Brain lub kontroler VEX wykryje. Jedyny wyjątek dotyczy kontrolera V5, który nie zawiera portu szeregowego użytkownika.
Włącz umożliwia rozszerzeniu połączenie się z portem użytkownika podczas uruchamiania i utworzy terminal interaktywny. Jeśli wybrano opcję Włącz, gdy rozszerzenie jest uruchomione, rozszerzenie spróbuje otworzyć port użytkownika, jeśli urządzenie jest podłączone.
Wyłącz uniemożliwia rozszerzeniu połączenie się z portem użytkownika podczas uruchamiania i nie tworzy terminala interaktywnego. Jeśli podczas działania rozszerzenia zostanie wybrana opcja Wyłącz, rozszerzenie zamknie port użytkownika i usunie terminal interaktywny.
Typ kompilacji projektu
Typ kompilacji projektu określa sposób, w jaki rozszerzenie będzie budować projekt C++. Użytkownik może ustawić typ kompilacji na Build lub Rebuild.
Build zbuduj projekt tylko wtedy, gdy Make wykryje jakiekolwiek zmiany w kodzie źródłowym projektu.
Rebuild czyści katalog kompilacji projektu, a następnie buduje projekt. Ta opcja jest zwykle znacznie wolniejsza.
Strona główna projektu
Project Home ustawia domyślny katalog domowy dla nowego projektu po zakończeniu pracy kreatora nowego projektu.
Uruchom po pobraniu
Uruchom po pobraniu , gdy jest włączone, powoduje uruchomienie programu użytkownika po jego pobraniu do VEX Brain.
Strona główna SDK Pythona
NIE EDYTUJ TEGO USTAWIENIA.
Pomoc dotycząca poleceń VEX
Pomoc poleceń VEX umożliwia dostęp do dokumentacji konkretnych funkcji zawartych w API C++ i Python (interfejs programowania aplikacji). Dokumentacja jest specyficzna dla każdej platformy VEX (IQ 2. generacji, EXP, V5).
Aby uzyskać dostęp do pomocy poleceń VEX, najpierw zaznacz tekst funkcji, którą chcesz wyszukać.
Kliknij prawym przyciskiem myszy zaznaczony tekst, a pojawi się menu kontekstowe.
Dalej Kliknij Pomoc polecenia VEX, aby uzyskać dostęp do dokumentacji.
Jeśli pomoc poleceń VEX znajdzie dokładne dopasowanie, pojawi się nowy widok sieciowy z odpowiednią dokumentacją.
Jeśli do wybranego tekstu pasuje wiele dokumentów, pojawi się menu rozwijane z przefiltrowaną listą odpowiedniej dokumentacji.