W tym artykule przedstawiono przegląd interfejsu użytkownika (UI) rozszerzenia VEX dla programu Visual Studio Code. Rozszerzenie obsługuje tworzenie projektów w językach C++ i Python dla platform VEX IQ 2. generacji, EXP i V5.
Układ interfejsu użytkownika rozszerzenia VEX VS Code
Interfejs użytkownika rozszerzenia VEX Visual Studio Code jest podzielony na pięć głównych obszarów: pasek aktywności, pasek boczny, edytor, panel terminala i pasek narzędzi.
Pasek aktywności
Pasek aktywności zawiera szereg ikon, które umożliwiają przełączanie się między widokami i dostarczają dodatkowych wskaźników kontekstowych ułatwiających rozwój projektu VEX.
Do tworzenia projektów VEX w programie VS Code najczęściej używane są następujące ikony:
-
Ikona widoku eksploratora - Po kliknięciu na pasku bocznym otwiera się Widok eksploratora.
-
Ikona widoku rozszerzeń - Po kliknięciu na pasku bocznym otwiera się Widok rozszerzeń.
-
Ikona widoku VEX - Po kliknięciu na pasku bocznym otwiera się widok VEX .
Pasek boczny
Pasek boczny zawiera różne widoki, które umożliwiają korzystanie ze zintegrowanych narzędzi programu VS Code. Typowe widoki paska bocznego używane do wykonywania zadań podczas opracowywania projektu VEX to: Widok rozszerzenia, Widok VEXi Widok eksploratora.
Widok rozszerzenia
Widok rozszerzenia służy do instalowania i zarządzania rozszerzeniami w programie VS Code. Aby tworzyć oprogramowanie na platformach VEX IQ 2. generacji, EXP i V5, musimy zainstalować rozszerzenie VEX, rozszerzenie C/C++ i rozszerzenie Python.
Instrukcje krok po kroku dotyczące instalacji rozszerzeń VEX, C/C++, i Python Extension w programie VS Code można znaleźć w tym artykule.
Widok VEX
VEX View umożliwia nam tworzenie projektów dla VEX IQ 2. generacji, EXP i V5 w VS Code. Widok VEX zawiera trzy kategorie: DZIAŁANIA PROJEKTU, INFORMACJE O URZĄDZENIU VEX, i INFORMACJE ZWROTNE VEX.
-
DZIAŁANIA PROJEKTU
Przyciski pod DZIAŁANIAMI PROJEKTU służą do tworzenia nowego projektu VEX lub importowania istniejącego projektu VEXcode.
Szczegółowe wskazówki dotyczące tworzenia projektu VEX w programie VS Code można znaleźć tym artykule dla wersji V5, tym artykule dla wersji EXP, i tym artykule dla wersji IQ (2.).
-
INFORMACJE O URZĄDZENIU VEX
Kategoria INFORMACJE O URZĄDZENIU VEX zapewnia nam przegląd podłączonego urządzenia VEX - VEX Brain lub VEX Controller.
Ta kategoria wskazuje typ podłączonego urządzenia VEX i wyświetla informacje o systemie Brain, porcie szeregowym, pobranym programie i urządzeniach podłączonych do inteligentnych portów VEX Brain. Umożliwia nam zrzut ekranu VEX Brain Screen, przeglądanie dziennika zdarzeń VEX Brain, korzystanie z V5 Battery Medic, ustawianie nazwy mózgu i numeru zespołuoraz usuwanie programu użytkownika z VEX Brain
Po podłączeniu VEX Brain do komputera kategoria VEX DEVICE INFO pokazuje, czy kontroler VEX jest podłączony do VEX Brain, i umożliwia nam aktualizację VEXos dla VEX Brain, jeśli wersja VEXos VEX Brain jest nieaktualna.
Gdy kontroler VEX jest podłączony do komputera, kategoria INFORMACJE O URZĄDZENIU VEX pokazuje, czy moduł VEX Brain jest podłączony do kontrolera VEX i umożliwia nam aktualizację systemu VEXos dla kontrolera VEX, jeśli wersja systemu VEXos kontrolera VEX jest nieaktualna.
Aby uzyskać kompleksowy opis informacji o urządzeniu i sposobu korzystania z funkcji w sekcji INFORMACJE O URZĄDZENIU VEX, zapoznaj się z tym artykułem.
-
OPINIA VEX
Możemy przesłać opinię do VEX, wpisując wiadomość w polu tekstowym pod OPINIA VEX i klikając przycisk WYŚLIJ
Przydatne informacje na temat korzystania z OPINIE VEX w programie VS Code można znaleźć w tym artykule.
Widok Eksploratora
Widok Eksploratora służy do przeglądania, otwierania i zarządzania plikami i folderami projektu VEX w programie VS Code.
Redaktor
Edytor jest głównym obszarem edycji plików w programie VS Code. Rozszerzenie VEX VS Code włącza funkcję Intellisense/Linting dla języków C/C++ i Python w obszarze edytora, co ułatwia nam rozwijanie programu.
W obszarze Edytora możemy uzyskać dostęp do przydatnych informacji o konkretnej funkcji, najeżdżając kursorem myszy na tekst funkcji lub korzystając z pomocy polecenia VEX Command Help w celu uzyskania dostępu do dokumentacji tej funkcji zawartej w interfejsie API (Application Programming Interface) języków C++ i Python.
Szczegółowe instrukcje dotyczące korzystania z pomocy polecenia VEX w programie VS Code można w tym artykule.
Panel terminala
Rozszerzenie VEX VS Code udostępnia dwa terminale po uruchomieniu: Terminal Log i Terminal Interaktywny.
-
Terminal dziennika — Terminal dziennika wyświetla dane wyjściowe kompilacji, błędy kompilacji i wyniki pobierania.
-
Terminal interaktywny Terminal interaktywny ma dwie funkcje — wyświetlanie dzienników wydruków i wysyłanie surowych naciśnięć klawiszy powrotem do programu użytkownika.
Uwaga: Aby móc korzystać z terminala interaktywnego, mózg lub kontroler musi być podłączony do komputera, na którym działa rozszerzenie VEX VS Code.
Uwaga: Dane wyjściowe terminala interaktywnego są domyślnie czyszczone po skompilowaniu i pobraniu programu użytkownika.
Pasek narzędzi
Na pasku narzędzi znajduje się szereg ikon, które umożliwiają szybką interakcję z projektami rozszerzeń VEX VS Code, VEX Brains i VEX Controllers.
Uwaga: Pasek narzędzi jest aktywny tylko wtedy, gdy w programie VS Code otwarty jest prawidłowy projekt VEX.
Uwaga: Prawidłowy projekt VEX to projekt utworzony lub zaimportowany przez rozszerzenie. Projekty VEXcode lub VEXcode Pro otwarte w edytorze nie będą uznawane za prawidłowe projekty VEX i konieczne będzie ich zaimportowanie.
Na pasku narzędzi znajdują się następujące ikony:
-
Wybór urządzenia - Wybór urządzenia wyświetla ikonę podłączonego urządzenia VEX (ikona mózgu
lub ikona kontrolera
)
Uwaga: Jeśli kontroler jest podłączony do komputera, ale nie ma połączenia radiowego z mózgiem, obok ikony kontrolera nie zostanie wyświetlona nazwa mózgu.
-
Ikona selektora gniazd - Ikona selektora gniazd umożliwia wybranie gniazda, na którym rozszerzenie VEX pobierze lub odtworzy program użytkownika W tym celu należy kliknąć na nie i wybrać jedno z ośmiu dostępnych gniazd w mózgu VEX z listy wyboru.
-
Kompilacja & Ikona pobierania - Jeśli podłączone jest urządzenie VEX, na pasku narzędzi wyświetli się ikona pobierania. Po kliknięciu projekt zostanie skompilowany i, jeżeli operacja się powiedzie, zostanie pobrany na podłączone urządzenie VEX.
-
Ikona Odtwórz - Po kliknięciu Ikona Odtwórz uruchamia pobrany program użytkownika w wybranym slocie w mózgu VEX.
-
Ikona Zatrzymaj - Po kliknięciu Ikona Zatrzymaj zatrzymuje działanie programu użytkownika w VEX Brain.
-
Selektor projektu - Selektor projektu wyświetla nazwę wybranego projektu. Ikona selektora umożliwia przełączanie się między projektami VEX, gdy w obszarze roboczym znajduje się ich wiele. Wystarczy na nią kliknąć i wybrać projekt z listy wyboru.
-
Selektor plików Pythona (tylko Python) — po wybraniu projektu VEX Python na pasku narzędzi pojawi się Selektor plików Pythona. Selektor plików Python wyświetla nazwę wybranego pliku Python. Python dla VEX obecnie obsługuje tylko pobieranie pojedynczych plików.
Przydatne informacje o korzystaniu z funkcji paska narzędzi w programie VS Code znaleźć w tym artykule.
Ustawienia użytkownika VEX
Ustawienia użytkownika VEX umożliwiają nam konfigurację rozszerzenia VEX zgodnie z naszymi własnymi wymaganiami. Ustawienia użytkownika to globalne ustawienia stosowane do każdego projektu rozszerzenia VEX VS Code. Dostęp do Ustawień użytkownika VEX można uzyskać, klikając ikonę Ustawienia w programie VS Code i wybierając odpowiednie pozycje w menu.
Ustawienia użytkownika VEX służące do konfiguracji rozszerzenia VEX VS Code to:
- Kanał kontrolera (tylko kontroler V5) - Ustawia kanał radiowy kontrolera V5 na Pobierz lub Pit. To ustawienie dotyczy wyłącznie łącza radiowego VEXnet.
- Ścieżka łańcucha narzędzi CPP – Ustawia ścieżkę dla łańcucha narzędzi CPP.
- Włącz terminal użytkownika– włącza lub wyłącza rozszerzenie, aby otwierać i wyświetlać dane z portu użytkownika.
- wpisów dziennika – Ustawia liczbę wpisów dziennika do przesłania z VEX Brain.
- Typ kompilacji projektu — Ustawia sposób, w jaki rozszerzenie będzie kompilować projekt C++.
- Strona główna projektu – Ustawia domyślną lokalizację dla nowych projektów.
- Uruchom po pobraniu – Ustawia, czy program użytkownika ma zostać uruchomiony po pobraniu do VEX Brain.
- System DFU Auto Recover – Ustawia, czy mózg powinien automatycznie odzyskiwać sprawność po wykryciu IQ2 lub EXP w trybie DFU.
- Włącz serwer Websocket — włącza lub wyłącza rozszerzenie w celu uruchomienia serwera Websocket.
- Adres hosta serwera Websocket — Ustawia adres hosta serwera Websocket.
- Port serwera Websocket – Ustawia numer portu serwera Websocket
Przydatne informacje na temat dostępu i konfiguracji ustawień użytkownika VEX znaleźć w tym artykule.