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

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

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

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

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

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

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

Панель инструментов дает пользователям быстрый способ взаимодействия с проектами расширения VEX VS Code VEX Brains и VEX Controllers. Панель инструментов активна только тогда, когда действительный проект 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.

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

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

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

Раздел «Действия проекта» в представлении расширения VEX. В этом разделе есть две кнопки: «Новый проект» и «Импорт проекта».

Панель активности vex содержит представление «Действия проекта» и представление «Информация об устройстве VEX».

Представление «Действия проекта» используется для создания нового проекта или импорта существующего проекта VEXcode или VEXcode Pro.

Для получения дополнительной информации о создании нового проекта ознакомьтесь этой статьей!

Информация о версии также отображается в нижнем левом и правом углах представления.

Важно
Если проект VEXcode или VEXcode Pro открыт в редакторе, он не будет считаться действительным проектом VEX. Проект необходимо импортировать с помощью кнопки «Импорт» на боковой панели VEX.

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

Раздел «Информация об устройстве VEX» в представлении расширения VEX содержит список всех подключенных устройств и подробную информацию о каждом из них. В этом примере показан мозг IQ (2-го поколения) и его загруженные программы. В списке контроллеров указано «Контроллер, не подключен». Раздел «Информация об устройстве VEX» снова отображается, но теперь в списке контроллеров указано «Контроллер, подключен».

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

Системная информация

Папка System и ее содержимое отображаются и подсвечиваются под папкой 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 проекты VEX. В этом примере в подключенный Brain загружены четыре программы C/C++.

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

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

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

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

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

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

Папка «Устройства» и ее содержимое отображаются под папкой «Мозг». В этом примере выбрано устройство Motor, и его содержимое имеет вид Type Motor, Version 1.0.0.4, Boot 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.

Установите окно запроса имени мозга с текстовым полем и сообщением ниже: Нажмите Enter для подтверждения ввода или Escape для отмены.

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

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

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

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

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

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

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

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

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

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

Обновление VEXos

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

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

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

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

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

Обновите окно приглашения VEXos, выведя сообщение: Доступно обновление VEXos: 1.0.1.0. Источник, расширение VEX. Ниже находятся две кнопки: «Обновить» и «Игнорировать».

Также в правом нижнем углу редактора VS Code появится окно уведомления, когда VEXos устареет. Пользователь может запустить обновление VEXos, нажав кнопку «Обновить» или нажать кнопку «Игнорировать», чтобы пропустить обновление VEXos.

Мозг не связан с подключенным контроллером

Папка Brain, находящаяся под папкой индикатора устройств VEX, имеет оранжевый значок и надпись Brain, not linked. Эти признаки указывают на отсутствие подключенного VEX Brain.

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

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

Терминальная панель

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

Окно терминала VS Code открыто и отображает терминал журнала VEX и интерактивный терминал VEX.

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

Открывается терминал журнала VS Code VEX, в котором отображается история использования расширения VEX. В этом примере есть сообщения «Журнал», «Сборка Windows для платформы vexexp», «Загрузка пользовательской программы», «Загрузка завершена».

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Настройки пользователя 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 с Cpp Toolchain: показана опция Path. Эта опция имеет текстовое поле, представляющее путь к файлу.

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

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

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

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

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

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

Настройки пользователя VEX с показанным параметром «Тип сборки проекта». Этот параметр имеет раскрывающееся меню, в котором по умолчанию установлено значение «Сборка». Описание гласит: Установить тип сборки проекта Cpp.

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

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

Настройки пользователя VEX с показанной опцией Project Home. Эта опция имеет текстовое поле, представляющее путь к файлу. Описание гласит: Устанавливает местоположение по умолчанию для новых проектов.

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

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

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

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

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

Показаны настройки пользователя VEX с опцией Python SDK Home. У этой опции есть ссылка с надписью Изменить в settings.json. В описании написано НЕ РЕДАКТИРОВАТЬ.

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

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

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

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

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

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

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

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

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

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