Обзор пользовательского интерфейса VS Code для V5 – Библиотека VEX

Эта статья представляет собой обзор пользовательского интерфейса расширения кода VEX Visual Studio. Расширение поддерживает разработку проектов C++ и Python для платформ VEX IQ 2nd Generation, EXP и V5.

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

Компоненты пользовательского интерфейса

Расширение кода VEX VS состоит из трех основных компонентов.

Панель инструментов
Панель действий и боковая панель
Терминальная панель

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

Панель инструментов предоставляет пользователям быстрый способ взаимодействия с проектами расширений VEX VS Code, такими как VEX Brains и VEX Controllers. Панель инструментов активна только тогда, когда в VS Code открыт действительный проект VEX. Действительный проект VEX — это проект, созданный или импортированный расширением. Открытие проекта VEXcode или VEXcode Pro недопустимо, и его необходимо импортировать.

Панель инструментов VS Code со значками расширений VEX, позволяющая быстро взаимодействовать с подключенными устройствами и проектами VEX. В число функций VEX входят: выбор устройства, выбор слота, значок загрузки сборки & , значок воспроизведения, значок остановки, выбор проекта и выбор файла Python.

Выбор устройства

Значок выбора устройства выделен на панели инструментов VS Code. В этом примере отображается VEX_V5.

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

Поисковая строка VS Code с выпадающим списком всех подключенных устройств VEX. В этом примере указаны V5 Brain, V5 Controller и EXP Controller.

Во-вторых, при нажатии на значок списка устройств появляется список быстрого выбора со всеми подключенными устройствами VEX. Пользователь может выбрать, к какому устройству будет подключаться расширение.
Текущее подключенное устройство всегда будет отображаться вверху списка, за ним следуют все остальные устройства, отсортированные по типу устройства (мозг или контроллер) и платформе (IQ 2-го поколения, EXP и V5).

В строке поиска VS Code отображается пункт быстрого выбора для получения подробной информации. В описании указано: MyBrain, V5 Brain, User COM8, Comm COM7.

Каждый элемент устройства содержит имя Brain, платформу, тип устройства и информацию о пути к устройству.

В строке поиска VS Code отображается пункт быстрого выбора для получения подробной информации. Предмет представляет собой контроллер V5, но фон неактивен (серый), и название блока управления не указано. Это указывает на то, что данный контроллер не имеет радиосвязи с центральным блоком управления.

Элемент контроллера 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. В меню VEX View сверху расположены параметры для создания и импорта проектов, снизу — меню «Информация об устройстве VEX», а внизу — меню обратной связи.

Проекты Действия

Раздел «Действия проекта» в окне расширения 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 и информация о версии среды выполнения Python.

Информация о последовательном порте

Папка Serial Port и ее содержимое отображаются внутри папки Brain. В папке Serial Port содержатся данные о проводном подключении устройства Brain. Эти данные означают: Коммуникация COM167, Пользователь COM168.

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

Информация о программах

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

Информация о программе отображает список всех загруженных пользовательских программ на VEX Brain.

Папка «Программы» и ее содержимое отображаются под папкой «Brain», при этом открыта папка первого проекта, чтобы показать ее содержимое. В папке проекта отображаются данные о слоте, файле, типе, размере и времени.

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

Информация об устройствах

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

В информации об устройствах отображается список всех устройств интеллектуальных портов, подключенных к VEX Brain. В каждом элементе списка указан номер интеллектуального порта и тип устройства.

Папка Devices и ее содержимое отображаются под папкой Brain. В этом примере выбрано устройство "Мотор", и его содержимое выглядит следующим образом: Тип "Мотор", Версия 1.0.0.4, Загрузка 1.0.2.0.

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

Статус связи с контроллером отображается при подключении к устройству VEX Brain.

Контроллер указан в папке «Устройства». Этот контроллер считывает данные из связанного контроллера.

VEX Brain связан с контроллером VEX.

Контроллер указан в папке «Устройства». Этот контроллер читает информацию о контроллере, а не связан с ним.

VEX Brain не связан с контроллером VEX.

Контроллер указан в папке «Устройства». Этот контроллер считывает данные с подключенного контроллера.

Контроллер VEX V5 привязан к VEX V5 Brain.

Снимки экрана

При наведении курсора на папку «Индикаторы устройств VEX» рядом с ней отображается значок камеры.

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

Батарейный медик (только V5 Brain)

При наведении курсора на папку «Индикаторы устройства V5 Brain VEX» рядом с ней отображается значок Battery Medic.

При нажатии на значок «Сердце» расширение загрузит и запустит пользовательскую программу Battery Medic.

Установить имя мозга

При наведении курсора на поле «Имя» в папке «Система» отображается значок карандаша.

Нажав на значок карандаша рядом с именем системы->, пользователь может установить имя для VEX Brain.

В окне подсказки Brain Name разместите текстовое поле и сообщение ниже: «Нажмите Enter для подтверждения ввода или Escape для отмены».

После щелчка по значку «Карандаш» в верхней части редактора VS Code появится поле ввода. Введите новое имя мозга в поле ввода и нажмите Enter, чтобы установить.

Установить номер команды

При наведении курсора на пункт «Команда» в папке «Система» рядом с ним отображается значок карандаша.

Нажав на значок карандаша рядом с командой system->, пользователь может установить номер команды для VEX Brain.

В окне запроса номера команды должно быть текстовое поле, а ниже — сообщение: «Нажмите Enter для подтверждения ввода или Escape для отмены».

После щелчка по значку «Карандаш» в верхней части редактора VS Code появится поле ввода. Введите новый номер команды в поле ввода и нажмите Enter, чтобы установить.

Удалить программу пользователя

При наведении курсора на программу в папке «Программы» рядом с ней отображается значок корзины.

Нажав на значок Корзина рядом с названием проекта программы->, пользователь может удалить программу в определенном слоте. ВАЖНОЕсли вы удалите программу, ее невозможно будет восстановить. Пожалуйста, будьте осторожны при использовании этой функции.

Предупреждения относительно информации об устройстве

Обновление VEXos

Значок папки "Brain" и значок индикатора устройства VEX отображаются оранжевым цветом, а рядом с версией VEXos системы отображается символ опасности. Эти признаки указывают на то, что версия VEXos для Brain устарела.

Если версия VEXos для VEX Brain устарела, рядом с версией VEXos появляется значок предупреждающего сообщения, и оба значка Brain становятся желтыми.

Чтобы устранить это предупреждение, пользователю следует обновить VEXos для своего VEXos Brain.

При наведении курсора на устаревшую папку Brain's отображается значок стрелки вверх.

VEXos можно обновить, щелкнув стрелку вверх рядом со значком мозга VEX.

В обновленном окне командной строки 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 Log Terminal и VEX Interactive Terminal.

Журнальный терминал

Открывается окно журнала VS Code VEX Log Terminal, в котором отображается история использования расширения VEX. В этом примере присутствуют сообщения следующего содержания: Log, Windows build for platform vexexp, Download User Program, Download Finished.

Терминал журнала отображает выходные данные сборки, ошибки сборки и результаты загрузки.

Интерактивный терминал

Открывается интерактивный терминал VS Code VEX, на экране которого отображается сообщение "Hello World".

Интерактивный терминал имеет две функции: отображение журналов printf и отправку необработанных нажатий клавиш обратно в пользовательскую программу. Чтобы воспользоваться преимуществами интерактивного терминала, мозг или контроллер должен быть подключен к компьютеру, на котором установлено расширение кода VEX VS. Вывод интерактивного терминала по умолчанию очищается после сборки и загрузки пользовательской программы.

Пользовательские настройки

Пользовательские настройки — это глобальные настройки, которые код Visual Studio предлагает для каждого расширения. Пользовательские настройки применяются к каждому проекту расширения VEX VS Code.

В настройках пользователя VS Code открывается страница VEX, где можно настроить поведение расширения VEX Robotics Extension.

Как получить доступ к пользовательским настройкам VEX

Значок настроек находится в самом низу панели активности VS Code, в левом нижнем углу экрана.

Нажмите шестеренку в левом углу VS Code, и появится контекстное меню.

Контекстное меню настроек VS Code с множеством перечисленных параметров. Выделена опция «Настройки», которая является третьей в меню, ниже «Палитры команд» и «Профили».

В контекстном меню нажмите пункт «Настройки» и появится страница настроек.

Окно настроек VS Code открыто, и в списке навигации слева выделена категория «Расширения».

В левом списке списка нажмите на пункт «Расширения». Затем прокрутите вниз и найдите предмет с надписью «VEX».

Окно настроек VS Code открыто, и ссылка на страницу VEX в категории «Расширения» выделена.

Нажмите на элемент списка «VEX».

Настройки пользователя VEX появятся на правой панели.

Обзор настроек

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

Настройка Канал контроллера управляет типом канала радиосвязи между V5 Brain и контроллером V5.
Этот параметр применяется только в том случае, если VS Code подключен к контроллеру V5 через USB, а контроллер подключен к V5 Brain через VEXnet. Пользователь может выбрать между каналами Download и Pit. Если установлено значение Download, радиостанция перейдет на канал загрузки VEXnet после начала загрузки пользовательской программы. Канал загрузки обеспечивает более высокую скорость передачи данных и более эффективную загрузку. Если установлено значение Pit, радио останется на пит-канале, и загрузка займет гораздо больше времени. По умолчанию для этого параметра установлено значение Скачать.

В настройках пользователя VEX отображается опция «Канал контроллера». В этом разделе есть выпадающее меню, в котором по умолчанию установлено значение «Скачать». В описании указано: «Задает радиоканал контроллера V5».

Главная страница SDK проекта Cpp

НЕ РЕДАКТИРУЙТЕ ЭТУ НАСТРОЙКУ.

Путь к цепочке инструментов CPP

Параметр Cpp Toolchain Path задает путь к цепочке инструментов, используемой при сборке проекта C++ VEX VS Code.

В настройках пользователя VEX с использованием инструментария C++ отображается параметр «Путь». В этом параметре есть текстовое поле, представляющее собой путь к файлу.

Включить пользовательский терминал

Настройка «Включить пользовательский терминал позволяет расширению открывать пользовательский последовательный порт, когда расширение VEX Brain или контроллер VEX обнаруживается. Единственное исключение относится к контроллеру V5, который не идентифицируется с пользовательским последовательным портом.

В настройках пользователя VEX отображается параметр «Включить пользовательский терминал» (General Enable User Terminal). Эта опция имеет выпадающее меню, которое по умолчанию установлено в положение «Включить». В описании указано: «Включить расширение для открытия и отображения данных из пользовательского порта».

Включить позволяет расширению подключаться к пользовательскому порту при запуске и создавать интерактивный терминал. Если включено выбрано во время работы расширения, расширение попытается открыть пользовательский порт, если устройство подключено.
Отключить предотвращает подключение расширения к пользовательскому порту при запуске и не создает интерактивный терминал. Если во время работы расширения выбрано отключение, расширение закроет пользовательский порт и удалит интерактивный терминал.

Тип сборки проекта

Тип сборки проекта определяет, как расширение будет создавать проект C++. Пользователь может установить тип сборки: Сборка или Перестройка.
Сборка собирает проект только тогда, когда Make обнаруживает какие-либо изменения в исходном коде проекта.
Rebuild очищает каталог сборки проекта, затем выполняет сборку проекта. Этот вариант обычно намного медленнее.

В настройках пользователя VEX отображается параметр «Тип сборки проекта». В этом варианте есть выпадающее меню, в котором по умолчанию установлено значение «Сборка». В описании указано: «Установить тип сборки проекта C++».

Главная страница проекта

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

В настройках пользователя VEX отображается опция "Главная страница проекта". В этом параметре есть текстовое поле, представляющее собой путь к файлу. В описании указано: «Задает местоположение по умолчанию для новых проектов».

Запустить после загрузки

Запускать после загрузки если этот параметр включен, запускает пользовательскую программу после ее загрузки в VEX Brain.

В настройках пользователя VEX отображается опция «Запустить проект после загрузки». Эта опция имеет флажок, который в данном примере отображается как выбранный. В описании указано: «Устанавливает, должна ли пользовательская программа запускаться после загрузки».

Главная страница Python SDK

НЕ РЕДАКТИРУЙТЕ ЭТУ НАСТРОЙКУ.

В настройках пользователя VEX отображается опция "Домашняя директория Python SDK". В этом разделе есть ссылка «Редактировать» в файле settings.json. В описании указано: НЕ РЕДАКТИРОВАТЬ.

Справка по команде VEX

Справка по командам VEX обеспечивает доступ к документации по конкретным функциям, включенным в C++ и Python API (интерфейс прикладного программирования). Документация специфична для каждой платформы VEX (IQ 2-го поколения, EXP, V5).

В редакторе VS Code выделена команда C++, отмеченная курсором.

Чтобы получить доступ к справке по командам VEX, сначала выделите текст функции, которую нужно найти.

Открылось контекстное меню для команды C++, и выделен пункт «Справка по команде VEX».

Щелкните правой кнопкой мыши по выделенному тексту, и появится контекстное меню.
Далее Нажмите кнопку «Справка по командам VEX», чтобы получить доступ к документации.

Открыта страница справки по командам VEX, на которой отображается информация и примеры использования команды Brain Screen Print на языке C++.

Если справка по командам VEX обнаружит точное совпадение, появится новое веб-представление с соответствующей документацией.

В VS Code есть строка поиска с быстрым списком соответствующих команд VEX C++ в справке по командам VEX, которая помогает сузить область поиска пользователя.

Если несколько документов соответствуют выбранному тексту, появится раскрывающийся список с отфильтрованным списком соответствующей документации.