EXP 的 VS Code UI 概述

本文概述了 VEX Visual Studio 代码扩展 UI（用户界面）。该扩展支持为 VEX IQ 第二代、EXP 和 V5 平台开发 C++ 和 Python 项目。

图像48.png

用户界面组件

VEX VS Code 扩展有 3 个主要组件。

工具栏
活动栏和侧栏
端子面板

工具栏

该工具栏为用户提供了一种与 VEX VS Code 扩展项目 VEX Brains 和 VEX Controller 进行交互的快速方式。仅当在 VS Code中打开有效的 VEX 项目时，工具栏才处于活动状态。有效的 VEX 项目是由扩展创建或导入的项目。打开 VEXcode 或 VEXcode Pro 项目无效，需要导入。

图片2.png

设备选择器

图片60.png

设备选择器有两个主要功能。首先，它显示代表连接的 VEX 设备类型的大脑或控制器图标。

图片41.png

其次，当单击设备列表图标时，会出现一个快速选择列表，其中包含所有已连接的 VEX 设备。用户可以选择分机将连接到哪个设备。
当前连接的设备将始终显示在列表顶部，然后是按设备类型（大脑或控制器）和平台（IQ 第二代、EXP 和 V5）排序的所有其他设备。

图片4.png

每个设备项包含 Brain 名称、平台、设备类型和设备路径信息。

图片8.png

图片56.png

重要的

如果控制器连接到计算机，但没有到大脑的无线电链路，则列表项或设备列表状态栏图标旁边不会显示大脑名称。

插槽选择器

图片19.png

插槽选择器图标允许用户选择扩展将在哪个插槽上下载或播放用户程序。

图片43.png

单击插槽选择器图标时，将出现一个快速选择列表，其中包含可用的用户程序插槽 1-8。

构建/下载

图片5.png 图片6.png

如果连接了 VEX Brain 或 VEX 控制器，构建/下载图标会更改功能。

图片5.png

如果未连接 VEX 设备，则会显示构建图标。单击后，只会构建该项目。

图片6.png

如果连接了 VEX 设备，则会显示下载图标。单击后，将构建项目，如果成功，将下载到 VEX 设备。

玩

图片33.png

单击播放图标后，将运行所选插槽中的用户程序。

停止

图片45.png

单击停止图标可停止用户程序。

选定的工作空间

图片24.png

VS Code 支持多工作区项目。当工作区内存在多个 VEX 项目时，项目选择器允许用户在 VEX 项目之间切换。

图片14.png

单击项目选择器图标时，将出现一个包含所有有效项目的快速选择列表。

重要
如果项目无效，则不会显示在项目快速选择列表中。除非由 VEX VS Code 扩展创建或导入，否则项目无效。

图片34.png

Python 文件选择器（仅限 Python）
当选择 VEX python 项目时，python 文件选择器将出现在工具栏中。 Python for VEX 目前仅支持单个文件下载。

图片17.png

单击该图标时，将出现一个快速选择列表，其中包含位于工作区目录中的所有 python 文件。
python 文件选择器允许用户在 python 源文件（.py）之间切换

VEX 活动栏和侧边栏

图片57.png

项目行动

图片47.png

vex 活动栏包含项目操作视图和 VEX 设备信息视图。

项目操作视图用于创建新项目或导入现有的 VEXcode 或 VEXcode Pro 项目。

有关创建新项目的更多信息，请查看这篇文章！

版本信息也显示在视图的左下角和右下角。

重要
如果 VEXcode 或 VEXcode Pro 项目在编辑器中打开，则它将不会被视为有效的 VEX 项目，需要使用 VEX 侧栏中的导入按钮导入该项目。

VEX 设备信息

图片37.png 图片62.png

VEX 设备信息视图为用户提供了所连接的 VEX Brain 或 VEX 控制器的概览。 VEXos版本、串口路径、用户程序、设备信息都可以在该视图中找到。其他功能，如 VEXos 固件更新、屏幕截图、设置大脑名称和设置团队编号也可以通过此视图执行。

系统信息

图片25.png

系统信息提供了所连接的 VEX 设备的简要概述。这包括设备的 VEXos 版本、Brain 名称、团队编号、Brain ID 和 python 运行时版本信息。

串口信息

图片7.png

串行端口信息显示可用于 VEX 设备的每个端口的设备路径。大多数 VEX 设备枚举为两个串行端口。通讯串口用于下载程序和控制大脑功能。用户串行端口用于在 Brain 上运行的用户应用程序和通过 USB 连接的主机之间传输数据。 V5 控制器是唯一只有通信串行端口而没有用户串行端口的 VEX 设备。

节目信息

图片12.png

程序信息显示 VEX Brain 上所有下载的用户程序的列表。

图片23.png

每个程序列表项都可以展开以显示有关每个用户程序的附加信息，例如插槽位置、文件名、语言类型、文件大小和下载时间。

设备信息

图片20.png

设备信息显示连接到 VEX Brain 的所有智能端口设备的列表。每个列表项显示智能端口号和设备类型。

图片29.png

每个设备列表项都可以展开以显示有关每个智能端口设备的固件版本信息。

连接到 VEX Brain Device 时会显示控制器链接状态。

VEX Brain 连接到 VEX 控制器

图片10.png

VEX Brain 未链接至 VEX 控制器

图片52.png

VEX V5 控制器连接到 VEX V5 Brain

屏幕截图

图片50.png

通过单击相机图标，用户可以从 VEX Brain 拍摄并下载屏幕截图。
屏幕截图仅在通过 USB 直接连接到 VEX Brain 时可用

电池医生（仅限 V5 Brain）

图片39.png

通过单击“心脏”图标，扩展程序将下载并运行电池医生用户程序。

设置大脑名称

图片28.png

通过单击 system->名称旁边的铅笔图标，用户可以设置 VEX Brain 的名称。

图片54.png

单击铅笔图标后，VS Code 编辑器顶部会出现一个输入框。在输入框中输入新的大脑名称，然后按回车键进行设置。

设置队伍号码

图片58.png

通过单击 system->团队旁边的铅笔图标，用户可以设置 VEX Brain 的团队编号。

图片49.png

单击铅笔图标后，VS Code 编辑器顶部将出现一个输入框。在输入框中输入新的队伍号码，然后按回车键进行设置。

擦除用户程序

图片30.png

通过单击程序 ->项目名称旁边的 垃圾桶 图标，用户可以删除特定插槽中的程序。重要，一旦删除程序，就无法恢复。使用此功能时请谨慎。

设备信息警告

VEXos 更新

图片22.png

当 VEX Brain 的 VEXos 版本过时时，VEXos 版本旁边会出现警告消息图标，并且两个 Brain 图标都会变成黄色。

要解决此警告，用户应更新其 VEXos Brain 的 VEXos。

图片31.png

可以通过单击 VEX Brain 图标旁边的向上箭头来更新 VEXos。

图片36.png

当 VEXos 过时时，VS Code 编辑器的右下角也会出现一个通知框。用户可以通过单击“更新”按钮启动 VEXos 更新，也可以单击“忽略”按钮跳过 VEXos 更新。

大脑未连接至已连接的控制器

图片21.png

当 VEX 控制器连接到计算机但未链接到 VEX Brain 时，VEX 控制器图标将变成黄色。

要解决此警告，用户应将 VEX 控制器链接到 VEX Brain

端子面板

VEX VS Code 扩展在启动时提供两个终端，日志终端和交互终端

图片11.png

日志终端

图片13.png

日志终端显示构建输出、构建错误和下载结果。

互动终端

图片16.png

交互式终端有两个功能，显示 printf 日志和将原始击键发送回用户程序。为了利用交互式终端，大脑或控制器必须连接到运行 VEX VS 代码扩展的计算机。构建并下载用户程序后，默认情况下会清除交互式终端输出。

用户设置

用户设置是 Visual Studio Code 为每个扩展提供的全局设置。用户设置适用于每个 VEX VS Code 扩展项目。

图片32.png

如何访问 VEX 用户设置

单击 VS Code 左上角的齿轮，将出现一个上下文菜单

图片27.png

在上下文菜单中，单击“设置”项，将出现一个设置页面。

图片9.png

在左侧列表视图中，单击“扩展”项。接下来，向下滚动到底部并找到标有“VEX”的项目。

图片18.png

单击“VEX”列表项。

图片46.png

VEX 用户设置将出现在右侧面板中。

设置概览

控制器通道（仅限 V5 控制器）

控制器通道 设置控制 V5 Brain 和 V5 控制器之间的无线电通信通道类型。
此设置仅适用于 VS Code 通过 USB 连接到 V5 控制器并且控制器通过 VEXnet 连接到 V5 Brain 的情况。用户可以在下载和坑频道之间进行选择。当设置为 Download时，一旦启动用户程序下载，无线电将跳转到下载 VEXnet 通道。下载通道允许更高的数据速率和更高效的下载。当设置为 Pit时，收音机将保留在坑频道上，并且下载将花费更长的时间。默认情况下，此设置设置为下载。

图片63.png

Cpp项目SDK主页

请勿编辑此设置。

Cpp 工具链路径

Cpp Toolchain Path 设置构建 C++ VEX VS Code 项目时使用的工具链的路径。

图片3.png

启用用户终端

启用用户终端 设置允许分机在检测到 VEX Brain 或 VEX 控制器时打开用户串行端口。唯一的例外适用于不枚举用户串行端口的 V5 控制器。

图片61.png

启用允许扩展在启动时连接到用户端口并将创建交互式终端。如果在扩展程序运行时选择启用，则扩展程序将在连接设备时尝试打开用户端口。
禁用阻止扩展在启动时连接到用户端口，并且不会创建交互式终端。如果在扩展程序运行时选择禁用，则扩展程序将关闭用户端口并删除交互式终端。

项目构建类型

项目构建类型 设置扩展如何构建 C++ 项目。用户可以将构建类型设置为“构建”或“重建”。
Build 仅当 Make 检测到项目源代码中的任何更改时才构建项目。
Rebuild 清理项目的构建目录，然后构建项目。此选项通常要慢得多。

图片51.png

项目首页

项目主目录 完成新建项目向导时设置新项目的默认主目录。

图片38.png

下载后运行

下载后运行 启用后，会导致用户程序在下载到 VEX Brain 后运行。

图片53.png

Python SDK 主页