Эта статья представляет собой обзор пользовательского интерфейса расширения кода VEX Visual Studio. Расширение поддерживает разработку проектов C++ и Python для платформ VEX IQ 2nd Generation, EXP и V5.
Компоненты пользовательского интерфейса
Расширение кода VEX VS состоит из трех основных компонентов.
- Панель инструментов
- Панель действий и боковая панель
- Терминальная панель
Панель инструментов
Панель инструментов дает пользователям быстрый способ взаимодействия с проектами расширения VEX VS Code VEX Brains и VEX Controllers. Панель инструментов активна только тогда, когда действительный проект VEX открыт в VS Code. Действительный проект VEX — это проект, созданный или импортированный расширением. Открытие проекта VEXcode или VEXcode Pro недопустимо, и его необходимо импортировать.
Выбор устройства
Средство выбора устройства имеет две основные функции. Сначала отображается значок мозга или контроллера, обозначающий тип подключенного устройства VEX.
Во-вторых, при нажатии на значок списка устройств появляется список быстрого выбора со всеми подключенными устройствами VEX. Пользователь может выбрать, к какому устройству будет подключаться расширение.
Текущее подключенное устройство всегда будет отображаться вверху списка, за ним следуют все остальные устройства, отсортированные по типу устройства (мозг или контроллер) и платформе (IQ 2-го поколения, EXP и V5).
Каждый элемент устройства содержит имя Brain, платформу, тип устройства и информацию о пути к устройству.
Важный
Если контроллер подключен к компьютеру, но не имеет радиосвязи с мозгом, имя мозга не будет отображаться рядом с элементом списка или значком строки состояния списка устройств.
Селектор слотов
Значок выбора слота позволяет пользователю выбрать, в какой слот расширение будет загружать или воспроизводить пользовательскую программу.
При щелчке по значку выбора слота появляется список быстрого выбора с доступными слотами пользовательских программ 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 и информация о версии среды выполнения Python.
Информация о последовательном порте
Информация о последовательном порте отображает путь к каждому порту, доступному для устройства VEX. Большинство устройств VEX имеют два последовательных порта. Последовательный порт связи используется для загрузки программ и управления функциями мозга. Пользовательский последовательный порт используется для передачи данных между пользовательским приложением, работающим на Brain, и главным компьютером, подключенным через USB. Контроллер V5 — единственное устройство VEX, которое имеет только последовательный порт связи и не имеет последовательного порта пользователя.
Информация о программах
Информация о программе отображает список всех загруженных пользовательских программ на VEX Brain.
Каждый элемент списка программ можно расширить, чтобы отобразить дополнительную информацию о каждой пользовательской программе, например расположение слота, имя файла, тип языка, размер файла и время загрузки.
Информация об устройствах
В информации об устройствах отображается список всех устройств интеллектуальных портов, подключенных к VEX Brain. В каждом элементе списка указан номер интеллектуального порта и тип устройства.
Каждый элемент списка устройств можно расширить, чтобы отобразить информацию о версии прошивки для каждого устройства интеллектуального порта.
Статус связи с контроллером отображается при подключении к устройству VEX Brain.
VEX Brain связан с контроллером VEX.
VEX Brain не связан с контроллером VEX.
Контроллер VEX V5 привязан к VEX V5 Brain.
Снимки экрана
Нажав на значок камеры, пользователь может сделать и загрузить снимок экрана с VEX Brain.
Снимки экрана доступны только при прямом подключении к VEX Brain через USB.
Батарейный медик (только V5 Brain)
При нажатии на значок «Сердце» расширение загрузит и запустит пользовательскую программу Battery Medic.
Установить имя мозга
Нажав на значок карандаша рядом с именем системы->, пользователь может установить имя для VEX Brain.
После щелчка по значку «Карандаш» в верхней части редактора VS Code появится поле ввода. Введите новое имя мозга в поле ввода и нажмите Enter, чтобы установить.
Установить номер команды
Нажав на значок карандаша рядом с командой system->, пользователь может установить номер команды для VEX Brain.
После щелчка по значку «Карандаш» в верхней части редактора VS Code появится поле ввода. Введите новый номер команды в поле ввода и нажмите Enter, чтобы установить.
Удалить программу пользователя
Нажав на значок Корзина рядом с названием проекта программы->, пользователь может удалить программу в определенном слоте. ВАЖНОЕсли вы удалите программу, ее невозможно будет восстановить. Пожалуйста, будьте осторожны при использовании этой функции.
Предупреждения относительно информации об устройстве
Обновление VEXos
Если версия VEXos для VEX Brain устарела, рядом с версией VEXos появляется значок предупреждающего сообщения, и оба значка Brain становятся желтыми.
Чтобы устранить это предупреждение, пользователю следует обновить VEXos для своего VEXos Brain.
VEXos можно обновить, щелкнув стрелку вверх рядом со значком мозга VEX.
Также в правом нижнем углу редактора VS Code появится окно уведомления, когда VEXos устареет. Пользователь может запустить обновление VEXos, нажав кнопку «Обновить» или нажать кнопку «Игнорировать», чтобы пропустить обновление VEXos.
Мозг не связан с подключенным контроллером
Значок контроллера VEX станет желтым, если контроллер VEX подключен к компьютеру, но не связан с VEX Brain.
Чтобы устранить это предупреждение, пользователю следует подключить контроллер VEX к VEX Brain.
Терминальная панель
Расширение кода VEX VS предоставляет два терминала при запуске: терминал журнала и интерактивный терминал.
Журнальный терминал
Терминал журнала отображает выходные данные сборки, ошибки сборки и результаты загрузки.
Интерактивный терминал
Интерактивный терминал имеет две функции: отображение журналов printf и отправку необработанных нажатий клавиш обратно в пользовательскую программу. Чтобы воспользоваться преимуществами интерактивного терминала, мозг или контроллер должен быть подключен к компьютеру, на котором установлено расширение кода VEX VS. Вывод интерактивного терминала по умолчанию очищается после сборки и загрузки пользовательской программы.
Пользовательские настройки
Пользовательские настройки — это глобальные настройки, которые код Visual Studio предлагает для каждого расширения. Пользовательские настройки применяются к каждому проекту расширения VEX VS Code.
Как получить доступ к пользовательским настройкам VEX
Нажмите шестеренку в левом углу VS Code, и появится контекстное меню.
В контекстном меню нажмите пункт «Настройки» и появится страница настроек.
В левом списке списка нажмите на пункт «Расширения». Затем прокрутите вниз и найдите предмет с надписью «VEX».
Нажмите на элемент списка «VEX».
Настройки пользователя VEX появятся на правой панели.
Обзор настроек
Канал контроллера (только контроллер V5)
Настройка Канал контроллера управляет типом канала радиосвязи между V5 Brain и контроллером V5.
Этот параметр применяется только в том случае, если VS Code подключен к контроллеру V5 через USB, а контроллер подключен к V5 Brain через VEXnet. Пользователь может выбрать между каналами Download и Pit. Если установлено значение Download, радиостанция перейдет на канал загрузки VEXnet после начала загрузки пользовательской программы. Канал загрузки обеспечивает более высокую скорость передачи данных и более эффективную загрузку. Если установлено значение Pit, радио останется на пит-канале, и загрузка займет гораздо больше времени. По умолчанию для этого параметра установлено значение Скачать.
Главная страница SDK проекта Cpp
НЕ РЕДАКТИРУЙТЕ ЭТУ НАСТРОЙКУ.
Путь к цепочке инструментов CPP
Cpp Toolchain Path задает путь для цепочки инструментов, которая используется при создании проекта C++ VEX VS Code.
Включить пользовательский терминал
Настройка «Включить пользовательский терминал позволяет расширению открывать пользовательский последовательный порт, когда расширение VEX Brain или контроллер VEX обнаруживается. Единственное исключение относится к контроллеру V5, который не идентифицируется с пользовательским последовательным портом.
Включить позволяет расширению подключаться к пользовательскому порту при запуске и создавать интерактивный терминал. Если включено выбрано во время работы расширения, расширение попытается открыть пользовательский порт, если устройство подключено.
Отключить предотвращает подключение расширения к пользовательскому порту при запуске и не создает интерактивный терминал. Если во время работы расширения выбрано отключение, расширение закроет пользовательский порт и удалит интерактивный терминал.
Тип сборки проекта
Тип сборки проекта определяет, как расширение будет создавать проект C++. Пользователь может установить тип сборки: Сборка или Перестройка.
Сборка собирает проект только тогда, когда Make обнаруживает какие-либо изменения в исходном коде проекта.
Rebuild очищает каталог сборки проекта, затем выполняет сборку проекта. Этот вариант обычно намного медленнее.
Главная страница проекта
Project Home устанавливает домашний каталог по умолчанию для нового проекта при завершении работы мастера создания нового проекта.
Запустить после загрузки
Запускать после загрузки если этот параметр включен, запускает пользовательскую программу после ее загрузки в VEX Brain.
Главная страница Python SDK
НЕ РЕДАКТИРУЙТЕ ЭТУ НАСТРОЙКУ.
Справка по команде VEX
Справка по командам VEX обеспечивает доступ к документации по конкретным функциям, включенным в C++ и Python API (интерфейс прикладного программирования). Документация специфична для каждой платформы VEX (IQ 2-го поколения, EXP, V5).
Чтобы получить доступ к справке по командам VEX, сначала выделите текст функции, которую нужно найти.
Щелкните правой кнопкой мыши по выделенному тексту, и появится контекстное меню.
Далее Нажмите кнопку «Справка по командам VEX», чтобы получить доступ к документации.
Если справка по командам VEX обнаружит точное совпадение, появится новое веб-представление с соответствующей документацией.
Если несколько документов соответствуют выбранному тексту, появится раскрывающийся список с отфильтрованным списком соответствующей документации.