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

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

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

Компоненти інтерфейсу користувача

Є 3 основні компоненти VEX VS Code Extension.

Панель інструментів
Панель активності та бічна панель
Термінальна панель

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

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

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

Вибір пристрою

Піктограма засобу вибору пристрою виділена на панелі інструментів VS Code. У цьому прикладі це VEX_EXP.

Засіб вибору пристрою виконує дві основні функції. По-перше, він відображає піктограму мозку або контролера, що представляє тип підключеного пристрою VEX.

Панель пошуку VS Code зі списком швидкого вибору всіх підключених пристроїв VEX. У цьому прикладі перелічені V5 Brain, V5 Controller та EXP Controller.

По-друге, коли клацнути піктограму списку пристроїв, з’явиться список швидкого вибору з усіма підключеними пристроями VEX. Користувач може вибрати, до якого пристрою підключатиметься розширення.
Поточний підключений пристрій завжди відображатиметься у верхній частині списку, а потім усі інші пристрої, відсортовані за типом пристрою (Мозок або Контролер) і платформою (IQ 2-го покоління, EXP і V5).

Рядок пошуку VS Code з елементом списку швидкого вибору, що відображається для надання детальної інформації. Елемент читається як MyBrain, V5 Brain, User COM8, Comm COM7.

Кожен елемент пристрою містить назву мозку, платформу, тип пристрою та інформацію про шлях до пристрою.

Рядок пошуку VS Code з елементом списку швидкого вибору, що відображається для надання детальної інформації. Це контролер V5, але фон сірий, а назви Brain немає. Це вказує на те, що цей Контролер не має радіозв'язку з Мозком.

Предмет контролера V5 із синім фоном, що вказує на те, що цей контролер має радіозв'язок з Мозком.

важливо

Якщо контролер під’єднано до комп’ютера, але не має радіозв’язку з мозком, ім’я мозку не відображатиметься поруч із елементом списку або значком рядка стану списку пристроїв.

Селектор слотів

Піктограма вибору слотів виділена на панелі інструментів VS Code. У цьому прикладі це Слот 1.

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

Панель пошуку VS Code зі списком швидкого вибору всіх доступних слотів на підключеному VEX Brain. У цьому прикладі є вісім доступних слотів.

Коли клацнути піктограму вибору слота, з’являється список швидкого вибору з доступними слотами програми користувача 1-8.

Збірка/завантаження

Ікона збірки. Значок завантаження.

Значок збірки/завантаження змінює функції, якщо підключено VEX Brain або контролер VEX.

Ікона збірки.

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

Значок завантаження.

Якщо під’єднано пристрій VEX, відображається значок завантаження. Якщо натиснути, проект буде створено та в разі успіху буде завантажено на пристрій VEX.

грати

Значок відтворення.

При натисканні на піктограму відтворення програма користувача запускається у вибраному слоті.

СТІЙ

Значок зупинки.

Після натискання піктограми зупинки програма користувача зупиняється.

Вибрана робоча область

Вибір проекту відображається на панелі інструментів VS Code. У цьому прикладі це EXPTestProject.

VS Code підтримує проекти з декількома робочими просторами. Селектор проектів дозволяє користувачам перемикатися між проектами VEX, якщо в робочому просторі існує кілька.

Панель пошуку VS Code зі списком швидкого вибору збережених проектів VEX. У цьому прикладі зазначено один проект Python та один проект C++.

Коли клацнути піктограму вибору проектів, з’явиться список швидкого вибору з усіма дійсними проектами.

Важливо
Якщо проект недійсний, він не відображатиметься у списку швидкого вибору проекту. Проект недійсний, якщо він не був створений або імпортований розширенням VEX VS Code.

Піктограма вибору файлів Python відображається на панелі інструментів VS Code. У цьому прикладі це main.py.

Селектор файлів Python (лише Python)
Коли вибрано проект VEX python, селектор файлів python з’явиться на панелі інструментів. Наразі Python для VEX підтримує завантаження лише одного файлу.

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

Після натискання піктограми з’являється список швидкого вибору з усіма файлами python, розташованими в каталозі робочої області.
Селектор файлів Python дозволяє користувачеві перемикатися між вихідними файлами Python (.py)

Панель активності та бічна панель VEX

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

Проекти Дії

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

Панель активності vex містить перегляд дій проекту та перегляд інформації про пристрій VEX.

Перегляд дій проекту використовується для створення нового проекту або імпорту існуючого проекту VEXcode або VEXcode Pro.

Щоб дізнатися більше про створення нового проекту, перегляньте цю статтю!

Інформація про версію також відображається в нижньому лівому та правому кутах перегляду.

Важливо
Якщо проект VEXcode або VEXcode Pro відкрито в редакторі, він не вважатиметься дійсним проектом VEX, проект потрібно імпортувати за допомогою кнопки «Імпорт» на бічній панелі VEX.

Інформація про пристрій VEX

Розділ «Інформація про пристрій VEX» у вікні розширення VEX відображається зі списком усіх підключених пристроїв та конкретною інформацією про кожен з них. У цьому прикладі показано EXP Brain та його завантажені програми. У списку Контролер написано Контролер, а не пов'язано. Розділ «Інформація про пристрій VEX» знову відображається, але тепер у списку контролерів відображається «Контролер, підключено».

Перегляд інформації про пристрій VEX дає користувачеві огляд підключеного VEX Brain або контролера VEX. Версію VEXos, шлях послідовного порту, програму користувача та інформацію про пристрій можна знайти в цьому вікні. Інші функції, такі як оновлення мікропрограми VEXos, знімки екрана, налаштування назви мозку та номер команди налаштування, також можна виконувати через це вікно.

Інформація про систему

Системна папка та її вміст відображаються та виділяються під папкою Brain. Системна папка містить дані про Brain, а саме: VEXos 1.0.1.0, назва VEX_EXP, команда 000000, ідентифікатор 0EC83725 та Python 1.0.0.7.

Системна інформація містить короткий огляд підключеного пристрою VEX. Це включає версію VEXos пристрою, назву Brain, номер команди, ідентифікатор Brain ID та інформацію про версію середовища виконання python.

Інформація про послідовний порт

Папка Serial Port та її вміст відображаються під папкою Brain. Папка Serial Port містить дані про дротове з'єднання Brain. Ці дані зчитуються зі зв'язку COM167, користувача COM168.

Інформація про послідовний порт відображає шлях до кожного порту, доступного для пристрою VEX. Більшість пристроїв VEX називаються двома послідовними портами. Послідовний порт зв'язку використовується для завантаження програм і керування функціями мозку. Послідовний порт користувача використовується для передачі даних між програмою користувача, що працює на Brain, і головним комп’ютером, під’єднаним через USB. Контролер V5 — це єдиний пристрій VEX, який має лише послідовний порт зв’язку та не має послідовного порту користувача.

Інформація про програми

Папка «Програми» та її вміст відображаються під папкою «Brain». У папці «Програми» відображаються всі завантажені проекти VEX на Brain. У цьому прикладі на підключений Brain завантажено чотири програми на C/C++.

Інформація про програму відображає список усіх завантажених програм користувача на VEX Brain.

Папка «Програми» та її вміст відображаються під папкою «Brain», тепер відкрито папку першого проекту для відображення її вмісту. У папці проекту відображаються дані про слот, файл, тип, розмір і час.

Кожен пункт списку програм можна розширити, щоб показати додаткову інформацію про кожну програму користувача, таку як розташування слота, ім’я файлу, тип мови, розмір файлу та час завантаження.

Інформація про пристрої

Папка «Пристрої» та її вміст відображаються під папкою «Brain». У папці «Пристрої» відображаються всі пристрої, підключені до Brain. У цьому прикладі перелічено 6 пристроїв, включаючи 4 двигуни, 3-провідний пристрій та внутрішній радіомодуль.

Інформація про пристрої показує список усіх пристроїв розумного порту, підключених до VEX Brain. Кожен елемент списку показує номер смарт-порту та тип пристрою.

Папка «Пристрої» та її вміст відображаються під папкою «Brain». У цьому прикладі вибрано пристрій Motor, а його вміст має наступне значення: Type Motor, Version 1.0.0.4, Boot 1.0.2.0.

Кожен пункт списку пристроїв можна розгорнути, щоб відобразити інформацію про версію мікропрограми для кожного пристрою з інтелектуальним портом.

При підключенні до VEX Brain Device відображається статус підключення контролера.

Контролер знаходиться в папці «Пристрої». Цей Контролер читає Контролер, пов'язаний.

VEX Brain підключено до контролера VEX

Контролер знаходиться в папці «Пристрої». Цей Контролер читає Контролер, а не пов'язаний.

VEX Brain не підключено до контролера VEX

Контролер знаходиться в папці «Пристрої». Цей Контролер читає Контролер, прив'язаний.

Контролер VEX V5 прив’язаний до VEX V5 Brain

Скріншоти

Курсор знаходиться над папкою індикатора пристрою VEX, а поруч із нею відображається значок камери.

Натиснувши піктограму камери, користувач може зробити та завантажити знімок екрана з VEX Brain.
Знімки екрана доступні лише за умови безпосереднього підключення до VEX Brain через USB

Battery Medic (лише V5 Brain)

Курсор знаходиться над папкою індикатора пристрою V5 Brain VEX, а поруч із нею відображається значок Battery Medic.

Якщо натиснути на піктограму серця, розширення завантажить і запустить програму користувача battery medic.

Встановіть назву мозку

Курсор знаходиться над опцією «Ім’я» в системній папці, а поруч із нею відображається значок олівця.

Натиснувши піктограму олівця поруч із назвою системи>, користувач може встановити назву для VEX Brain.

Вікно запиту «Встановити назву мозку» з текстовим полем і повідомленням нижче: натисніть Enter для підтвердження введення або Escape для скасування.

Після натискання піктограми олівця у верхній частині редактора коду VS з’явиться поле введення. Введіть нову назву мозку в поле введення та натисніть клавішу Enter, щоб встановити.

Встановіть номер команди

Курсор знаходиться над опцією «Команда» в системній папці, а поруч із нею відображається значок олівця.

Натиснувши піктограму олівця біля команди system->, користувач може встановити номер команди для VEX Brain.

Вікно запиту «Встановити номер команди» з текстовим полем і повідомленням нижче: натисніть Enter для підтвердження введення або Escape для скасування.

Після натискання піктограми олівця у верхній частині редактора коду VS з’явиться поле введення. Введіть новий номер команди в полі введення та натисніть Enter, щоб встановити.

Стерти програму користувача

Курсор знаходиться над програмою в папці «Програми», а поруч із нею відображається значок кошика.

Натиснувши піктограму Trashcan поруч із назвою проекту programs->, користувач може стерти програму в певному слоті. ВАЖЛИВО, після видалення програми її неможливо відновити. Використовуючи цю функцію, будьте обережні.

Попередження щодо інформації про пристрій

Оновлення VEXos

Піктограма папки Brain та піктограма індикатора пристрою VEX відображаються помаранчевим кольором, а поруч із версією VEXos системи є символ небезпеки. Ці ознаки вказують на те, що версія VEXos для Brain застаріла.

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

Щоб усунути це попередження, користувач повинен оновити VEXos для свого VEXos Brain.

Курсор знаходиться над застарілою папкою Brain, а поруч із нею відображається значок стрілки вгору.

VEXos можна оновити, клацнувши стрілку вгору біля значка VEX Brain.

Вікно запиту оновлення VEXos з повідомленням «Доступне оновлення VEXos: 1.0.1.0». Джерело, розширення VEX. Нижче є дві кнопки з написами «Оновити» та «Ігнорувати».

Крім того, у нижньому правому куті редактора VS Code з’явиться вікно сповіщень, коли VEXos застарів. Користувач може розпочати оновлення VEXos, натиснувши кнопку «Оновити», або натиснути кнопку «Ігнорувати», щоб пропустити оновлення VEXos.

Мозок не підключений до підключеного контролера

Папка Brain під папкою VEX Device Indicator має помаранчевий значок і напис Brain, not linked (Мозок, не пов’язано). Ці ознаки вказують на те, що VEX Brain не підключено.

Піктограма контролера VEX стане жовтою, коли контролер VEX підключено до комп’ютера, але не під’єднано до VEX Brain.

Щоб усунути це попередження, користувач повинен підключити контролер VEX до VEX Brain

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

Розширення коду VEX VS надає два термінали під час запуску: термінал журналу та інтерактивний термінал

Вікно терміналу VS Code відкрито, у ньому відображаються термінал журналу VEX та інтерактивний термінал VEX.

Журнал Термінал

Термінал журналу VEX коду VS відкривається та відображає історію використання розширення VEX. У цьому прикладі є повідомлення типу «Журнал», «Збірка Windows для платформи vexexp», «Завантаження користувацької програми», «Завантаження завершено».

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

Інтерактивний термінал

Інтерактивний термінал VS Code VEX відкривається та відображає повідомлення «Привіт, світ».

Інтерактивний термінал має дві функції: відображення журналів printf і надсилання необроблених натискань клавіш назад до програми користувача. Щоб скористатися перевагами інтерактивного терміналу, до комп’ютера, на якому запущено VEX VS Code Extension, необхідно під’єднати мозок або контролер. Вивід інтерактивного терміналу очищається за замовчуванням після створення та завантаження програми користувача.

Налаштування користувача

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

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

Як отримати доступ до налаштувань користувача VEX

Значок налаштувань у самому низу панелі активності VS Code, розташованої в лівому нижньому куті екрана.

Натисніть значок шестірні в лівому куті VS Code, і з’явиться контекстне меню

Контекстне меню налаштувань VS Code з багатьма переліченими опціями. Виділено опцію «Налаштування», яка є третьою опцією в меню, під «Палітрою команд» та «Профілями».

У контекстному меню клацніть пункт «Налаштування», з’явиться сторінка налаштувань.

Вікно налаштувань VS Code відкрито, а категорія «Розширення» виділена в лівому списку навігації.

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

Вікно налаштувань VS Code відкрито, а посилання на сторінку VEX у категорії «Розширення» виділено.

Натисніть на пункт списку «VEX».

Параметри користувача VEX з’являться на правій панелі.

Огляд налаштувань

Канал контролера (лише контролер V5)

Налаштування Controller Channel керує типом каналу радіозв’язку між V5 Brain і V5 Controller.
Цей параметр застосовується лише тоді, коли VS Code підключено до контролера V5 через USB, а контролер підключено до V5 Brain через VEXnet. Користувач може вибрати між Download і Pit канали. Якщо встановлено значення Download, радіостанція перейде до каналу VEXnet для завантаження після початку завантаження програми користувача. Канал завантаження забезпечує вищу швидкість передачі даних і більш ефективне завантаження. Якщо встановлено значення Pit, радіо залишатиметься на каналі pit, і завантаження триватиме набагато довше. За замовчуванням для цього параметра встановлено значення Завантажити.

Налаштування користувача VEX із показаною опцією каналу контролера. Цей параметр має випадаюче меню, у якому за замовчуванням встановлено значення «Завантажити». В описі написано: «Встановлює радіоканал контролера V5».

Домашня сторінка Cpp Project SDK

НЕ РЕДАГУЙТЕ ЦЕ НАЛАШТУВАННЯ.

Шлях ланцюжка інструментів Cpp

Cpp Toolchain Path встановлює шлях для інструментального ланцюга, який використовується під час створення проекту C++ VEX VS Code.

Налаштування користувача VEX з показаним параметром «Шлях» у наборі інструментів Cpp. Цей параметр має текстове поле, яке представляє шлях до файлу.

Увімкнути термінал користувача

Налаштування Enable User Terminal дозволяє розширенню відкривати послідовний порт користувача, коли розширення виявляє VEX Brain або VEX Controller. Єдиний виняток стосується контролера V5, який не нумерує послідовний порт користувача.

Налаштування користувача VEX із зазначенням опції «Загальне увімкнення терміналу користувача». Цей параметр має випадаюче меню, для якого за замовчуванням встановлено значення «Увімкнути». В описі написано: «Увімкнути розширення для відкриття та відображення даних з користувацького порту».

Enable дозволяє розширенню підключатися до порту користувача під час запуску та створює інтерактивний термінал. Якщо під час роботи розширення вибрано параметр «Увімкнути», розширення намагатиметься відкрити порт користувача, якщо пристрій підключено.
Вимкнути запобігає підключенню розширення до порту користувача під час запуску та не створює інтерактивний термінал. Якщо під час роботи розширення вибрано «Вимкнути», розширення закриє порт користувача та видалить інтерактивний термінал.

Тип збірки проекту

Тип збірки проекту встановлює, як розширення створюватиме проект C++. Користувач може встановити тип побудови: Build або Rebuild.
Build збирає проект лише тоді, коли Make виявляє будь-які зміни у вихідному коді проекту.
Rebuild очищає каталог збірки проекту, а потім збирає проект. Цей варіант зазвичай набагато повільніший.

Налаштування користувача VEX із показаним параметром «Тип збірки проекту». Цей параметр має випадаюче меню, для якого за замовчуванням встановлено значення «Створити». В описі написано «Встановити тип збірки проекту Cpp».

Головна сторінка проекту

Домашня сторінка проекту встановлює домашній каталог за замовчуванням для нового проекту після завершення роботи майстра нового проекту.

Налаштування користувача VEX із показаною опцією «Головна сторінка проекту». Цей параметр має текстове поле, яке представляє шлях до файлу. В описі написано: Встановлює розташування за замовчуванням для нових проектів.

Запустити після завантаження

Запуск після завантаження коли ввімкнено, запускає програму користувача після її завантаження на VEX Brain.

Налаштування користувача VEX з опцією «Запуск проекту після завантаження». Цей параметр має прапорець, який у цьому прикладі показано як вибраний. В описі написано «Встановити, чи слід запускати користувацьку програму після завантаження».

Домашня сторінка Python SDK

НЕ РЕДАГУЙТЕ ЦЕ НАЛАШТУВАННЯ.

Налаштування користувача VEX з показаним параметром «Головна сторінка» Python SDK. Цей параметр має посилання «Редагувати в settings.json». В описі написано НЕ РЕДАГУВАТИ.

Довідка про команди VEX

Довідка VEX Command надає доступ до документації для певних функцій, які входять до C++ і Python API (інтерфейс прикладного програмування). Документація стосується кожної платформи VEX (IQ 2-го покоління, EXP, V5).

Команда C++ у редакторі VS Code виділена курсором.

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

Контекстне меню для команди C++ відкрито, а опція «Довідка з команд VEX» виділена.

Клацніть правою кнопкою миші на виділеному тексті, і з’явиться контекстне меню.
Далі Натисніть довідку команди VEX, щоб отримати доступ до документації.

Сторінку довідки з команд VEX відкрито, на ній показано інформацію про команду Brain Screen Print у C++ та приклади її виконання.

Якщо довідка VEX Command знайде точний збіг, з’явиться нове веб-перегляд із відповідною документацією.

Панель пошуку VS Code зі списком швидкого вибору відповідних команд VEX C++ у довідці команд VEX, що допомагає звузити пошук користувача.

Якщо виділеному тексту відповідає декілька документів, з’явиться розкривний список із відфільтрованим списком відповідної документації.