Огляд інтерфейсу користувача VEX VS Code Extension – Бібліотека VEX

У цій статті наведено огляд VEX Visual Studio Code Extension UI (інтерфейс користувача). Розширення підтримує розробку проектів C++ і Python для платформ VEX IQ 2-го покоління, EXP і V5.

VEX VS Code Extension UI Layout

Інтерфейс VEX Visual Studio Code Extension UI розділений на п’ять основних областей: панель активності, бічна панель, редактор, панель терміналу та панель інструментів.

Знімок екрана, що показує повний макет інтерфейсу VEX VS Code. Панель активності та бічна панель знаходяться в лівій частині екрана, панель інструментів і термінал — у нижній частині екрана, а редактор заповнює решту екрана.

Панель активності

Панель активності містить набір піктограм, які дозволяють перемикатися між видами та надають нам додаткові контекстно-залежні індикатори для розробки проекту VEX.

Панель активності VS Code з встановленим розширенням VEX Robotics. Панель активності містить значки, які забезпечують корисні швидкі дії, такі як пошук, керування розширеннями, контроль версій тощо.

Загальні значки, які використовуються для розробки проекту VEX у VS Code:

Піктограма перегляду - Якщо натиснути, на бічній панелі відкривається вікно огляду.
Значок перегляду розширень - Після натискання на бічній панелі відкривається вікно перегляду розширень.
Піктограма перегляду VEX - Після натискання 4 на бічній панелі відкривається вікно перегляду VEX .

Бічна панель

Бічна панель містить різні види, які дозволяють використовувати інтегровані інструменти в VS Code. Загальні види бічної панелі, які використовуються для виконання завдань для розробки проекту VEX, це Extension View, VEX Viewта Explorer View.

Перегляд розширення

Extension View використовується для встановлення та керування розширеннями у VS Code. Для розробки програмного забезпечення на платформах VEX IQ 2nd Generation, EXP і V5 нам потрібно встановити розширення VEX, розширення C/C++ і розширення Python.

Щоб отримати покрокові інструкції щодо встановлення VEX Extension, C/C++ Extensionі Python Extension у VS Code, перегляньте цю статтю.

Перегляд розширень VS Code, який відображає список встановлених розширень. Кожне розширення має меню налаштувань, яке можна відкрити тут, а також рядок пошуку для пошуку та завантаження нових розширень.

Перегляд VEX

VEX View дозволяє нам розробляти проекти для VEX IQ 2-го покоління, EXP і V5 у VS Code. У перегляді VEX є три категорії: ДІЇ ПРОЕКТУ, ІНФОРМАЦІЯ ПРО ПРИСТРОЇ VEX, і ЗВОРОТНИЙ ЗВ’язок VEX.

VS Code VEX View, що показує опції для створення та імпорту проектів вище, меню VEX Device Info нижче та меню зворотного зв'язку внизу.

ДІЇ ПРОЕКТУ
Кнопки під ДІЇ ПРОЕКТУ використовуються для створення нового проекту VEX або імпорту існуючого проекту VEXcode.
Щоб отримати докладні вказівки щодо створення проекту VEX у VS Code, перегляньте цю статтю для V5, цю статтю для EXPта цю статтю для IQ (2nd).

Розділ «Дії проєкту» у вікні перегляду розширення VEX. У цьому розділі є дві кнопки з написами «Новий проект» та «Імпорт проекту».

ІНФОРМАЦІЯ ПРО ПРИСТРІЙ VEX
Категорія ІНФОРМАЦІЯ ПРО ПРИСТРІЙ VEX надає нам огляд підключеного пристрою VEX – VEX Brain або контролера VEX.

Ця категорія вказує на тип підключеного пристрою VEX та відображає інформацію про систему Brain, послідовний порт, завантажену програму та пристрої, підключені до інтелектуальних портів VEX Brain. Це дозволяє нам зробити знімок екрана VEX Brain Screen, переглянути журнал подій VEX Brain Event, використовувати V5 Battery Medic, встановити назву мозку і номер командиі стерти програму користувача з VEX Мозок.

Коли VEX Brain підключено до комп’ютера, категорія VEX DEVICE INFO показує, чи під’єднано контролер VEX до VEX Brain, і дозволяє нам оновити VEXos для VEX Brain, якщо версія VEXos VEX Brain є застарілий.

Коли контролер VEX під’єднано до комп’ютера, категорія VEX DEVICE INFO показує, чи під’єднано VEX Brain до контролера VEX, і дозволяє нам оновити VEXos для контролера VEX, якщо версія VEXos контролера VEX є застарілий.

Щоб отримати вичерпний опис інформації про пристрій і як використовувати функції в розділі ІНФОРМАЦІЯ ПРО ПРИСТРІЙ VEX, перегляньте цю статтю.

VEX FEEDBACK
Ми можемо надіслати відгук VEX, ввівши повідомлення в текстове поле під VEX FEEDBACK і натиснувши кнопку НАДІСЛАТИ .
Щоб отримати корисну інформацію про використання VEX FEEDBACK у VS Code, перегляньте цю статтю.

Розділ «Зворотній зв’язок VEX» у вікні перегляду розширення VEX. У цьому розділі є форма з опціями для надсилання відгуків до VEX.

Провідник

Explorer View використовується для перегляду, відкриття та керування файлами та папками проекту VEX у VS Code.

Перегляд VS Code Explorer, який дозволяє користувачеві переміщатися між папками та файлами у своєму VEX-проєкті. Файли мають відповідні значки та типи файлів, у цьому прикладі вибрано файл Python, а заголовок має вигляд main.py.

редактор

Редактор — це основна область редагування файлів у VS Code. Розширення VEX VS Code Extension дає змогу використовувати Intellisense/Linting для C/C++ і Python у області редактора, щоб допомогти нам під час розробки програми.

Редактор коду VS з файлом Python, відкритим як частина проекту VEX. Тут можна писати та редагувати код на Python або C/C++ для створення програм робототехніки VEX при підключенні до VEX Brain.

В області «Редактор» ми можемо отримати корисну інформацію про певну функцію, навівши курсор миші на текст функції або скориставшись VEX Command Help щоб отримати доступ до документації для цієї функції, включеної в C++ і Python API (інтерфейс прикладного програмування). ).

Щоб отримати детальні інструкції щодо використання командної довідки VEX у VS Code, перегляньте цю статтю.

Термінальна панель

VEX VS Code Extension надає два термінали під час запуску: термінал журналу та інтерактивний термінал.

Термінал журналу - Термінал журналу відображає вихідні дані збірки, помилку збірки та результати завантаження.

Термінал журналу VEX VS Code відкривається та відображає порожній стан за замовчуванням, лише з одним надрукованим повідомленням з текстом «Журнал».

Інтерактивний термінал - Інтерактивний термінал має дві функції: відображення журналів друку та надсилання необроблених натискань клавіш назад до користувацької програми.

Примітка: Щоб використовувати інтерактивний термінал, Brain або Controller має бути підключений до комп'ютера, на якому запущено розширення VEX VS Code.
Примітка: Вивід інтерактивного терміналу очищається за замовчуванням після збірки та завантаження користувацької програми.

Панель інструментів

Панель інструментів містить набір піктограм, які надають нам швидкий спосіб взаємодії з проектами розширення VEX VS Code, VEX Brains і контролерами VEX.

Панель інструментів VS Code з піктограмами розширень VEX, які можна використовувати для швидкої взаємодії з підключеними пристроями та проектами VEX. Функції VEX включають вибір пристроїв, вибір слотів, значок завантаження збірки & , значок відтворення, значок зупинки, вибір проекту та вибір файлів Python.

Примітка: Панель інструментів активна лише тоді, коли дійсний проект VEX відкрито у VS Code.

Примітка: Дійсним проектом VEX є проект, створений або імпортований розширенням. Проекти VEXcode або VEXcode Pro, відкриті в редакторі, не вважатимуться дійсними проектами VEX і їх потрібно імпортувати.

На панелі інструментів представлені такі значки:

Вибір пристрою - Вибір пристрою відображає піктограму підключеного пристрою VEX (піктограму мозку або піктограму контролера )
Примітка: Якщо контролер підключено до комп’ютера, але не має радіозв’язку з мозком, поруч із піктограмою контролера назва мозку не відображатиметься.

Значок вибору слота - Піктограма вибору слота дозволяє нам вибрати, який слот розширення VEX завантажуватиме або відтворюватиме програму користувача, натиснувши його та вибравши один із восьми доступних слотів на VEX Brain зі списку вибору.
Збірка & Піктограма завантаження - Якщо пристрій VEX підключено, Піктограма завантаження з’явиться на панелі інструментів. Якщо натиснути, проект буде створено та в разі успіху буде завантажено на підключений пристрій VEX.
Піктограма відтворення - Після натискання Піктограма відтворення запускає завантажену програму користувача у вибраному слоті на VEX Brain.
Піктограма зупинки - Якщо натиснути, Піктограма зупинки зупиняє виконання програми користувача на VEX Brain.
Селектор проекту - Селектор проекту відображає назву вибраного проекту. Піктограма вибору проекту дозволяє нам перемикатися між проектами VEX, якщо в робочому просторі існує кілька, клацнувши на ньому та вибравши проект зі списку вибору.
Селектор файлів Python (лише для Python) - Коли вибрано проект VEX Python, Селектор файлів Python з’явиться на панелі інструментів. Вибір файлів Python відображає назву вибраного файлу Python. Наразі Python для VEX підтримує завантаження лише одного файлу.

Щоб отримати корисну інформацію про те, як використовувати функції панелі інструментів у VS Code, перегляньте цю статтю.

Параметри користувача VEX

Параметри користувача VEX дозволяють нам налаштувати VEX Extension відповідно до наших власних вимог. Параметри користувача — це глобальні налаштування, які застосовуються до кожного проекту розширення VEX VS Code. Ми можемо отримати доступ до налаштувань користувача VEX , натиснувши піктограму налаштувань у коді VS і вибравши відповідні пункти в меню.

Налаштування користувача VS Code відкриваються в категорії VEX, де можна налаштувати поведінку розширення VEX Robotics.

Налаштування користувача VEX для налаштування розширення коду VEX VS:

Controller Channel (тільки для контролера V5) - Встановлює радіоканал контролера V5 на Download або Pit. Цей параметр застосовується лише до радіоканалу VEXnet.

Cpp Toolchain Path - встановлює шлях для CPP Toolchain.
Увімкнути термінал користувача– увімкнути або вимкнути розширення для відкриття та відображення даних із порту користувача.
Записів журналу – встановлює кількість записів журналу для завантаження з VEX Brain.
Тип побудови проекту - встановлює, як розширення створюватиме проект C++.
Головна сторінка проекту - встановлює розташування за умовчанням для нових проектів.
Запускати після завантаження – встановлює, чи програма користувача повинна запускатися після завантаження на VEX Brain.
Система DFU Auto Recover - встановлює, чи мозок повинен автоматично відновлюватися, коли IQ2 або EXP виявлено в режимі DFU.
Websocket Server Enable – вмикає або вимикає розширення для запуску Websocket Server.
Адреса хоста сервера Websocket - встановлює адресу хоста сервера Websocket.
Порт сервера Websocket — встановлює номер порту сервера Websocket

Щоб отримати корисну інформацію про те, як отримати доступ до налаштувань користувача VEX і налаштувати їх, перегляньте цю статтю.