Ця стаття є оглядом VEX Visual Studio Code Extension UI (інтерфейс користувача). Розширення підтримує розробку проектів C++ і Python для платформ VEX IQ 2-го покоління, EXP і V5.
Компоненти інтерфейсу користувача
Є 3 основні компоненти VEX VS Code Extension.
- Панель інструментів
- Панель активності та бічна панель
- Термінальна панель
Панель інструментів
Панель інструментів дає користувачам швидкий спосіб взаємодії з проектами розширення VEX VS Code VEX Brains і контролерами VEX. Панель інструментів активна лише тоді, коли дійсний проект VEX відкрито в VS Code. Дійсний проект VEX – це проект, створений або імпортований розширенням. Відкриття проекту VEXcode або VEXcode Pro недійсне, і його потрібно імпортувати.
Вибір пристрою
Засіб вибору пристрою виконує дві основні функції. По-перше, він відображає піктограму мозку або контролера, що представляє тип підключеного пристрою VEX.
По-друге, коли клацнути піктограму списку пристроїв, з’явиться список швидкого вибору з усіма підключеними пристроями VEX. Користувач може вибрати, до якого пристрою підключатиметься розширення.
Поточний підключений пристрій завжди відображатиметься у верхній частині списку, а потім усі інші пристрої, відсортовані за типом пристрою (Мозок або Контролер) і платформою (IQ 2-го покоління, EXP і V5).
Кожен елемент пристрою містить назву мозку, платформу, тип пристрою та інформацію про шлях до пристрою.
важливо
Якщо контролер під’єднано до комп’ютера, але не має радіозв’язку з мозком, ім’я мозку не відображатиметься поруч із елементом списку або значком рядка стану списку пристроїв.
Селектор слотів
Піктограма вибору слота дозволяє користувачеві вибрати, у який слот розширення буде завантажувати або відтворювати програму користувача.
Коли клацнути піктограму вибору слота, з’являється список швидкого вибору з доступними слотами програми користувача 1-8.
Збірка/завантаження
Значок збірки/завантаження змінює функції, якщо підключено VEX Brain або контролер VEX.
Якщо пристрій VEX не підключено, відображається піктограма збірки. Якщо натиснути, проект буде лише створено.
Якщо під’єднано пристрій VEX, відображається значок завантаження. Якщо натиснути, проект буде створено та в разі успіху буде завантажено на пристрій VEX.
грати
При натисканні на піктограму відтворення програма користувача запускається у вибраному слоті.
СТІЙ
Після натискання піктограми зупинки програма користувача зупиняється.
Вибрана робоча область
VS Code підтримує проекти з декількома робочими просторами. Селектор проектів дозволяє користувачам перемикатися між проектами VEX, якщо в робочому просторі існує кілька.
Коли клацнути піктограму вибору проектів, з’явиться список швидкого вибору з усіма дійсними проектами.
Важливо
Якщо проект недійсний, він не відображатиметься у списку швидкого вибору проекту. Проект недійсний, якщо він не був створений або імпортований розширенням VEX VS Code.
Селектор файлів Python (лише Python)
Коли вибрано проект VEX python, селектор файлів python з’явиться на панелі інструментів. Наразі Python для VEX підтримує завантаження лише одного файлу.
Після натискання піктограми з’являється список швидкого вибору з усіма файлами python, розташованими в каталозі робочої області.
Селектор файлів Python дозволяє користувачеві перемикатися між вихідними файлами Python (.py)
Панель активності та бічна панель VEX
Проекти Дії
Панель активності vex містить перегляд дій проекту та перегляд інформації про пристрій VEX.
Перегляд дій проекту використовується для створення нового проекту або імпорту існуючого проекту VEXcode або VEXcode Pro.
Щоб дізнатися більше про створення нового проекту, перегляньте цю статтю!
Інформація про версію також відображається в нижньому лівому та правому кутах перегляду.
Важливо
Якщо проект VEXcode або VEXcode Pro відкрито в редакторі, він не вважатиметься дійсним проектом VEX, проект потрібно імпортувати за допомогою кнопки «Імпорт» на бічній панелі VEX.
Інформація про пристрій VEX
Перегляд інформації про пристрій VEX дає користувачеві огляд підключеного VEX Brain або контролера VEX. Версію VEXos, шлях послідовного порту, програму користувача та інформацію про пристрій можна знайти в цьому вікні. Інші функції, такі як оновлення мікропрограми VEXos, знімки екрана, налаштування назви мозку та номер команди налаштування, також можна виконувати через це вікно.
Інформація про систему
Системна інформація містить короткий огляд підключеного пристрою VEX. Це включає версію VEXos пристрою, назву Brain, номер команди, ідентифікатор Brain ID та інформацію про версію середовища виконання python.
Інформація про послідовний порт
Інформація про послідовний порт відображає шлях до кожного порту, доступного для пристрою VEX. Більшість пристроїв VEX називаються двома послідовними портами. Послідовний порт зв'язку використовується для завантаження програм і керування функціями мозку. Послідовний порт користувача використовується для передачі даних між програмою користувача, що працює на Brain, і головним комп’ютером, під’єднаним через USB. Контролер V5 — це єдиний пристрій VEX, який має лише послідовний порт зв’язку та не має послідовного порту користувача.
Інформація про програми
Інформація про програму відображає список усіх завантажених програм користувача на VEX Brain.
Кожен пункт списку програм можна розширити, щоб показати додаткову інформацію про кожну програму користувача, таку як розташування слота, ім’я файлу, тип мови, розмір файлу та час завантаження.
Інформація про пристрої
Інформація про пристрої показує список усіх пристроїв розумного порту, підключених до VEX Brain. Кожен елемент списку показує номер смарт-порту та тип пристрою.
Кожен пункт списку пристроїв можна розгорнути, щоб відобразити інформацію про версію мікропрограми для кожного пристрою з інтелектуальним портом.
При підключенні до VEX Brain Device відображається статус підключення контролера.
VEX Brain підключено до контролера VEX
VEX Brain не підключено до контролера VEX
Контролер VEX V5 прив’язаний до VEX V5 Brain
Скріншоти
Натиснувши піктограму камери, користувач може зробити та завантажити знімок екрана з VEX Brain.
Знімки екрана доступні лише за умови безпосереднього підключення до VEX Brain через USB
Battery Medic (лише V5 Brain)
Якщо натиснути на піктограму серця, розширення завантажить і запустить програму користувача battery medic.
Встановіть назву мозку
Натиснувши піктограму олівця поруч із назвою системи>, користувач може встановити назву для VEX Brain.
Після натискання піктограми олівця у верхній частині редактора коду VS з’явиться поле введення. Введіть нову назву мозку в поле введення та натисніть клавішу Enter, щоб встановити.
Встановіть номер команди
Натиснувши піктограму олівця біля команди system->, користувач може встановити номер команди для VEX Brain.
Після натискання піктограми олівця у верхній частині редактора коду VS з’явиться поле введення. Введіть новий номер команди в полі введення та натисніть Enter, щоб встановити.
Стерти програму користувача
Натиснувши піктограму Trashcan поруч із назвою проекту programs->, користувач може стерти програму в певному слоті. ВАЖЛИВО, після видалення програми її неможливо відновити. Використовуючи цю функцію, будьте обережні.
Попередження щодо інформації про пристрій
Оновлення VEXos
Коли версія VEXos для VEX Brain застаріла, поруч із версією VEXos з’являється значок попереджувального повідомлення, а обидва значки Brain стають жовтими.
Щоб усунути це попередження, користувач повинен оновити VEXos для свого VEXos Brain.
VEXos можна оновити, клацнувши стрілку вгору біля значка VEX Brain.
Крім того, у нижньому правому куті редактора VS Code з’явиться вікно сповіщень, коли VEXos застарів. Користувач може розпочати оновлення VEXos, натиснувши кнопку «Оновити», або натиснути кнопку «Ігнорувати», щоб пропустити оновлення VEXos.
Мозок не підключений до підключеного контролера
Піктограма контролера VEX стане жовтою, коли контролер VEX підключено до комп’ютера, але не під’єднано до VEX Brain.
Щоб усунути це попередження, користувач повинен підключити контролер VEX до VEX Brain
Термінальна панель
Розширення коду VEX VS надає два термінали під час запуску: термінал журналу та інтерактивний термінал
Журнал Термінал
Термінал журналу відображає вихід збірки, помилку збірки та результати завантаження.
Інтерактивний термінал
Інтерактивний термінал має дві функції: відображення журналів printf і надсилання необроблених натискань клавіш назад до програми користувача. Щоб скористатися перевагами інтерактивного терміналу, до комп’ютера, на якому запущено VEX VS Code Extension, необхідно під’єднати мозок або контролер. Вивід інтерактивного терміналу очищається за замовчуванням після створення та завантаження програми користувача.
Налаштування користувача
Параметри користувача — це параметри глобальних параметрів, які код Visual Studio пропонує для кожного розширення. Налаштування користувача застосовуються до кожного проекту розширення VEX 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, і завантаження триватиме набагато довше. За замовчуванням для цього параметра встановлено значення Завантажити.
Домашня сторінка Cpp Project SDK
НЕ РЕДАГУЙТЕ ЦЕ НАЛАШТУВАННЯ.
Шлях ланцюжка інструментів Cpp
Cpp Toolchain Path встановлює шлях для інструментального ланцюга, який використовується під час створення проекту C++ VEX VS Code.
Увімкнути термінал користувача
Налаштування Enable User Terminal дозволяє розширенню відкривати послідовний порт користувача, коли розширення виявляє VEX Brain або VEX Controller. Єдиний виняток стосується контролера V5, який не нумерує послідовний порт користувача.
Enable дозволяє розширенню підключатися до порту користувача під час запуску та створює інтерактивний термінал. Якщо під час роботи розширення вибрано параметр «Увімкнути», розширення намагатиметься відкрити порт користувача, якщо пристрій підключено.
Вимкнути запобігає підключенню розширення до порту користувача під час запуску та не створює інтерактивний термінал. Якщо під час роботи розширення вибрано «Вимкнути», розширення закриє порт користувача та видалить інтерактивний термінал.
Тип збірки проекту
Тип збірки проекту встановлює, як розширення створюватиме проект C++. Користувач може встановити тип побудови: Build або Rebuild.
Build збирає проект лише тоді, коли Make виявляє будь-які зміни у вихідному коді проекту.
Rebuild очищає каталог збірки проекту, а потім збирає проект. Цей варіант зазвичай набагато повільніший.
Головна сторінка проекту
Домашня сторінка проекту встановлює домашній каталог за замовчуванням для нового проекту після завершення роботи майстра нового проекту.
Запустити після завантаження
Запуск після завантаження коли ввімкнено, запускає програму користувача після її завантаження на VEX Brain.
Домашня сторінка Python SDK
НЕ РЕДАГУЙТЕ ЦЕ НАЛАШТУВАННЯ.
Довідка про команди VEX
Довідка VEX Command надає доступ до документації для певних функцій, які входять до C++ і Python API (інтерфейс прикладного програмування). Документація стосується кожної платформи VEX (IQ 2-го покоління, EXP, V5).
Щоб отримати доступ до довідки команд VEX, спочатку виділіть текст функції, яку потрібно знайти.
Клацніть правою кнопкою миші на виділеному тексті, і з’явиться контекстне меню.
Далі Натисніть довідку команди VEX, щоб отримати доступ до документації.
Якщо довідка VEX Command знайде точний збіг, з’явиться нове веб-перегляд із відповідною документацією.
Якщо виділеному тексту відповідає декілька документів, з’явиться розкривний список із відфільтрованим списком відповідної документації.