この記事は、VEX Visual Studio Code Extension UI(ユーザー インターフェイス)の概要です。この拡張機能は、VEX IQ 第 2 世代、EXP、および V5 プラットフォーム用の C++ および Python プロジェクトの開発をサポートします。

VEX VS CodeのUIレイアウト全体を示すスクリーンショット。アクティビティバーとサイドバーは画面の左側に、ツールバーとターミナルは画面の下部に配置され、残りの画面はエディタで埋め尽くされます。

UIコンポーネント

VEX VS コード拡張には 3 つの主要なコンポーネントがあります。

  1. ツールバー
  2. アクティビティバーとサイドバー
  3. 端子パネル

ツールバー

ツールバーを使用すると、ユーザーはVEX VS Code拡張プロジェクトであるVEX BrainsおよびVEX Controllersとすばやくやり取りできます。ツールバーは、VS Codeで有効なVEXプロジェクトが開かれている場合にのみアクティブになります。有効な VEX プロジェクトは、拡張機能によって作成またはインポートされたプロジェクトです。 VEXcode または VEXcode Pro プロジェクトを開くことは無効なので、インポートする必要があります。

VS Codeツールバーには、接続されたVEXデバイスやプロジェクトと素早くやり取りできるVEX拡張機能アイコンが搭載されています。 VEXの機能には、デバイスピッカー、スロットセレクター、ビルド & ダウンロードアイコン、再生アイコン、停止アイコン、プロジェクトセレクター、およびPythonファイルセレクターが含まれます。

デバイスピッカー

VS Codeのツールバーで、デバイスピッカーのアイコンがハイライト表示されます。この例では、VEX_V5 と表示されます。

デバイス ピッカーには 2 つの主な機能があります。まず、接続されている VEX デバイスのタイプを表すブレインまたはコントローラーのアイコンが表示されます。

VS Codeの検索バーに、接続されているすべてのVEXデバイスのクイック選択リストが表示されます。この例では、V5 Brain、V5 Controller、およびEXP Controllerがリストされています。

次に、デバイス リスト アイコンをクリックすると、接続されているすべての VEX デバイスを含むクイック ピック リストが表示されます。ユーザーは、拡張機能が接続するデバイスを選択できます。
現在接続されているデバイスは常にリストの先頭に表示され、その後に他のすべてのデバイスがデバイス タイプ (ブレインまたはコントローラー) およびプラットフォーム (IQ 第 2 世代、EXP、および V5) ごとに並べ替えられて表示されます。

VS Codeの検索バーに、詳細情報を表示するためのクイックピックリスト項目が表示されています。アイテムには「MyBrain、V5 Brain、User COM8、Comm COM7」と記載されています。

各デバイス項目には、ブレイン名、プラットフォーム、デバイス タイプ、およびデバイス パスの情報が含まれています。

VS Codeの検索バーに、詳細情報を表示するためのクイックピックリスト項目が表示されています。このアイテムはV5コントローラーですが、背景がグレー表示されており、ブレイン名が表示されていません。これは、このコントローラーがブレインと無線接続されていないことを示しています。

V5コントローラーアイテムは、背景が青色で表示されており、このコントローラーがブレインと無線接続していることを示しています。

重要

コントローラがコンピュータに接続されているが、ブレインへの無線リンクがない場合、リスト項目またはデバイス リストのステータス バー アイコンの横にブレイン名は表示されません。

スロットセレクター

VS Codeのツールバーで、スロットセレクターのアイコンがハイライト表示されます。この例では「スロット1」と表示されます。

スロット セレクター アイコンを使用すると、拡張機能がユーザー プログラムをダウンロードまたは再生するスロットを選択できます。

VS Codeの検索バーに、接続されているVEX Brainで使用可能なすべてのスロットのクイック選択リストが表示されます。この例では、利用可能なスロットが8つあります。

スロット セレクター アイコンをクリックすると、利用可能なユーザー プログラム スロット 1 ~ 8 を含むクイック ピック リストが表示されます。

ビルド/ダウンロード

アイコンを作成します。ダウンロードアイコン。

VEX Brain または VEX コントローラーが接続されている場合、Build/Download アイコンの機能が変わります。

アイコンを作成します。

VEX デバイスが接続されていない場合は、ビルド アイコンが表示されます。クリックすると、プロジェクトがビルドされるだけです。

ダウンロードアイコン。

VEX デバイスが接続されている場合、ダウンロード アイコンが表示されます。クリックするとプロジェクトがビルドされ、成功すると VEX デバイスにダウンロードされます。

遊ぶ

再生アイコン。

再生アイコンをクリックすると、選択したスロットでユーザー プログラムが実行されます。

停止

停止アイコン。

停止アイコンをクリックすると、ユーザープログラムが停止します。

選択したワークスペース

プロジェクトセレクターはVS Codeのツールバーに表示されます。この例では、EXPTestProject と表示されます。

VS Code はマルチ ワークスペース プロジェクトをサポートします。ワークスペース内に複数の VEX プロジェクトが存在する場合、プロジェクト セレクターを使用してユーザーは VEX プロジェクトを切り替えることができます。

VS Codeの検索バーに、保存済みのVEXプロジェクトのクイック選択リストが表示されます。この例では、Pythonプロジェクトが1つ、C++プロジェクトが1つリストされています。

プロジェクト セレクター アイコンをクリックすると、すべての有効なプロジェクトを含むクイック ピック リストが表示されます。

重要
プロジェクトが有効でない場合、プロジェクトのクイック ピック リストには表示されません。プロジェクトは、VEX VS Code拡張機能によって作成またはインポートされたものでない限り、有効ではありません。

PythonファイルセレクターのアイコンがVS Codeのツールバーに表示されます。この例では、main.py を読み込みます。

Python ファイル セレクター(Python のみ)
VEX Python プロジェクトが選択されると、Python ファイル セレクターがツールバーに表示されます。 Python for VEX は現在、単一ファイルのダウンロードのみをサポートしています。

VS Codeの検索バーに、このVEXプロジェクト内のすべてのPythonファイルをクイックピックリストで表示する機能。この例では、それぞれ異なるファイル場所に配置された3つのPythonファイルがあります。


アイコンをクリックすると、ワークスペース ディレクトリにあるすべての Python ファイルを含むクイック ピック リストが表示されます。
Python ファイル セレクターを使用すると、ユーザーは Python ソース ファイル (.py) を切り替えることができます。

VEX アクティビティ バーとサイドバー

VS Codeのアクティビティバーとサイドバーを開き、VEXビューを表示した状態のスクリーンショット。 VEX Viewには、上部にプロジェクトの作成とインポートのオプション、下部にVEXデバイス情報メニュー、下部にフィードバックメニューがあります。

プロジェクトのアクション

VEX拡張機能ビューの「プロジェクトアクション」セクション。このセクションには、「新規プロジェクト」と「プロジェクトのインポート」という2つのボタンがあります。

VEX アクティビティ バーには、プロジェクト アクション ビューと VEX デバイス情報ビューが含まれています。

プロジェクト アクション ビューは、新しいプロジェクトを作成したり、既存の VEXcode または VEXcode Pro プロジェクトをインポートしたりするために使用されます。

新しいプロジェクトの作成の詳細については、 この記事をご覧ください。

バージョン情報は、ビューの左下隅と右下隅にも表示されます。

重要
VEXcode または VEXcode Pro プロジェクトがエディターで開いている場合、それは有効な VEX プロジェクトとみなされません。VEX サイドバーの [インポート] ボタンを使用してプロジェクトをインポートする必要があります。

VEX デバイス情報

VEX拡張機能ビューのVEXデバイス情報セクションには、接続されているすべてのデバイスのリストと、それぞれのデバイスに関する詳細情報が表示されます。この例では、EXP Brainとそれにダウンロードされたプログラムが表示されています。コントローラーの一覧には「コントローラー、リンクされていません」と表示されます。VEXデバイス情報セクションが再び表示されますが、今度はコントローラーのリストが「コントローラー、リンク済み」と表示されます。

VEX デバイス情報ビューでは、接続されている VEX Brain または VEX コントローラーの概要がユーザーに表示されます。 VEXos のバージョン、シリアル ポート パス、ユーザー プログラム、デバイス情報はすべてこのビューで確認できます。 VEXos ファームウェアの更新、スクリーンショット、ブレイン名の設定、チーム番号の設定などの他の機能も、このビューから実行できます。

システムインフォメーション

システムフォルダとその内容は、Brainフォルダの下に表示され、強調表示されます。システムフォルダにはブレインに関するデータがあり、そのデータにはVEXos 1.0.1.0、名前VEX_EXP、チーム000000、ID 0EC83725、Python 1.0.0.7と記載されています。

システム情報は、接続された VEX デバイスの概要を示します。これには、デバイスの VEXos バージョン、Brain 名、チーム番号、Brain ID、および Python ランタイム バージョン情報が含まれます。

シリアルポート情報

シリアルポートフォルダとその内容は、ブレインフォルダの下に表示されています。シリアルポートフォルダには、Brainの有線接続に関するデータが格納されています。このデータは、通信ポートCOM167、ユーザーポートCOM168を読み取ります。

シリアル ポート情報には、VEX デバイスで使用可能な各ポートのデバイス パスが表示されます。ほとんどの VEX デバイスは 2 つのシリアル ポートとして列挙されます。通信シリアル ポートは、プログラムをダウンロードし、脳機能を制御するために使用されます。ユーザー シリアル ポートは、Brain 上で実行されているユーザー アプリと USB 経由で接続されたホスト コンピューターの間でデータを転送するために使用されます。 V5 コントローラーは、通信シリアル ポートのみを備え、ユーザー シリアル ポートを持たない唯一の VEX デバイスです。

プログラム情報

プログラムフォルダとその内容は、Brainフォルダの下に表示されます。プログラムフォルダには、BrainにダウンロードされたすべてのVEXプロジェクトが表示されます。この例では、接続されたBrainに4つのC/C++プログラムがダウンロードされています。

プログラム情報には、VEX Brain にダウンロードされたすべてのユーザー プログラムのリストが表示されます。

「Brain」フォルダの下に「Programs」フォルダとその内容が表示され、最初のプロジェクトのフォルダが開かれてその内容が表示されています。プロジェクトフォルダには、スロット、ファイル、タイプ、サイズ、および時間に関するデータが表示されます。

各プログラム リストの項目を展開すると、スロットの場所、ファイル名、言語の種類、ファイル サイズ、ダウンロード時間など、各ユーザー プログラムに関する追加情報が表示されます。

デバイス情報

デバイスフォルダとその内容は、ブレインフォルダの下に表示されます。「デバイス」フォルダには、Brainに接続されているすべてのデバイスが表示されます。この例では、4つのモーター、3線式デバイス、および内蔵無線機を含む6つのデバイスがリストされています。

デバイス情報には、VEX Brain に接続されているすべてのスマート ポート デバイスのリストが表示されます。各リスト項目には、スマート ポート番号とデバイス タイプが表示されます。

デバイスフォルダとその内容は、ブレインフォルダの下に表示されます。この例では、モーターデバイスが選択されており、その内容は「タイプ モーター、バージョン 1.0.0.4、ブート 1.0.2.0」となっています。

各デバイス リスト項目を展開して、各スマート ポート デバイスのファームウェア バージョン情報を表示できます。

VEX Brain Deviceに接続すると、コントローラーのリンクステータスが表示されます。

コントローラーは「デバイス」フォルダの下に表示されます。このコントローラーは「コントローラー、リンク済み」を読み取ります。

VEX Brain は VEX コントローラーにリンクされています

コントローラーは「デバイス」フォルダの下に表示されます。このコントローラーは「コントローラー」と表示され、リンクされていません。

VEX Brain は VEX コントローラーにリンクされていません

コントローラーは「デバイス」フォルダの下に表示されます。このコントローラーは「コントローラー、テザー接続済み」と表示します。

VEX V5 コントローラーは VEX V5 Brain に接続されています

スクリーンショット

カーソルがVEXデバイスインジケーターフォルダの上にあり、その横にカメラアイコンが表示されています。

カメラ アイコンをクリックすると、ユーザーは VEX Brain からスクリーンショットを撮ってダウンロードできます。
スクリーンショットは、USB 経由で VEX Brain に直接接続した場合のみ利用可能です

バッテリーメディック (V5 Brain のみ)

カーソルがV5 Brain VEXデバイスインジケーターフォルダの上にあり、その横にバッテリーメディックのアイコンが表示されています。

ハートのアイコンをクリックすると、拡張機能がバッテリーメディックユーザープログラムをダウンロードして実行します。

ブレインネームを設定する

カーソルがシステムフォルダ内の「名前」オプションの上にあり、その横に鉛筆アイコンが表示されています。

system>名の横にある鉛筆アイコンをクリックすると、ユーザーは VEX Brain の名前を設定できます。

脳名入力プロンプトウィンドウにテキストフィールドを設定し、その下に「入力を確定するにはEnterキーを押してください。キャンセルするにはEscキーを押してください。」というメッセージを表示します。

鉛筆アイコンをクリックすると、VS Code エディターの上部に入力ボックスが表示されます。入力ボックスに新しい脳名を入力し、Enter キーを押して設定します。

チーム番号を設定する

カーソルがシステムフォルダ内の「チーム」オプションの上にあり、その横に鉛筆アイコンが表示されています。

system->チームの横にある鉛筆アイコンをクリックすると、VEX Brain のチーム番号を設定できます。

チーム番号入力プロンプトウィンドウにテキストフィールドを設定し、その下に「入力を確定するにはEnterキーを押してください。キャンセルするにはEscキーを押してください。」というメッセージを表示します。

鉛筆アイコンをクリックすると、VS Code エディターの上部に入力ボックスが表示されます。入力ボックスに新しいチーム番号を入力し、Enter キーを押して設定します。

ユーザープログラムの消去

カーソルが「プログラム」フォルダ内のプログラムの上にあり、その横にゴミ箱アイコンが表示されています。

プログラム>プロジェクト名の横にある ゴミ箱 アイコンをクリックすると、特定のスロットのプログラムを消去できます。重要、一度消去したプログラムは復元できません。この機能を使用する場合は注意してください。

デバイス情報の警告

VEXos アップデート

ブレインフォルダのアイコンとVEXデバイスインジケーターのアイコンはオレンジ色で表示され、システムのVEXosバージョンの横には危険シンボルが表示されます。これらの兆候は、BrainのVEXosバージョンが古いことを示している。

VEX Brain の VEXos バージョンが古い場合、VEXos バージョンの横に警告メッセージ アイコンが表示され、両方の Brain アイコンが黄色に変わります。

この警告を解決するには、ユーザーは VEXos Brain の VEXos を更新する必要があります。

カーソルが古いBrainフォルダの上にあり、その横に上向き矢印アイコンが表示されています。

VEXos は、VEX Brain アイコンの横にある上矢印をクリックして更新できます。

VEXosのプロンプトウィンドウに「VEXosアップデートが利用可能です:1.0.1.0」というメッセージを表示するように更新します。ソース:VEX Extension。下部には、「更新」と「無視」という2つのボタンがあります。

また、VEXos が古い場合は、VS Code エディターの右下隅に通知ボックスが表示されます。ユーザーは「更新」ボタンをクリックして VEXos アップデートを開始するか、「無視」ボタンをクリックして VEXos アップデートをスキップできます。

脳が接続されたコントローラーにリンクされていません

VEX Device Indicatorフォルダの下にあるBrainフォルダにはオレンジ色のアイコンがあり、「Brain、リンクされていません」と表示されています。これらの兆候は、VEX Brainが接続されていないことを示しています。

VEX コントローラーがコンピューターに接続されているが、VEX Brain にリンクされていない場合、VEX コントローラーのアイコンは黄色に変わります。

この警告を解決するには、ユーザーは VEX コントローラーを VEX Brain にリンクする必要があります。

端子パネル

VEX VS コード拡張機能は、起動時にログ ターミナルとインタラクティブ ターミナルという 2 つのターミナルを提供します。

VS Codeのターミナルウィンドウが開いており、VEXログターミナルとVEXインタラクティブターミナルが表示されています。

ログターミナル

VS CodeのVEXログターミナルが開かれ、VEX拡張機能の使用履歴が表示されます。この例では、「ログ」、「プラットフォーム vexexp 用の Windows ビルド」、「ユーザー プログラムのダウンロード」、「ダウンロード完了」というメッセージが表示されます。

ログ ターミナルには、ビルド出力、ビルド エラー、ダウンロード結果が表示されます。

インタラクティブターミナル

VS Code VEXインタラクティブターミナルが開かれ、「Hello World」というメッセージが表示されます。

インタラクティブ ターミナルには、printf ログの表示と生のキーストロークをユーザー プログラムに送信するという 2 つの機能があります。インタラクティブ ターミナルを利用するには、VEX VS Code Extension を実行しているコンピュータに Brain または Controller を接続する必要があります。ユーザープログラムをビルドしてダウンロードした後、対話型ターミナル出力はデフォルトでクリアされます。

ユーザー設定

ユーザー設定は、Visual Studio コードが拡張機能ごとに提供するグローバル設定です。ユーザー設定は、すべての VEX VS Code 拡張プロジェクトに適用されます。

VS Codeのユーザー設定を開くと、VEXページが表示され、VEX Robotics Extensionの動作をカスタマイズできます。

VEX ユーザー設定にアクセスする方法

設定アイコンは、画面左下隅にあるVS Codeアクティビティバーの一番下にあります。

VS Code の左隅にある歯車をクリックすると、コンテキスト メニューが表示されます

VS Codeの設定コンテキストメニューには、多くのオプションが一覧表示されています。「設定」というオプションがハイライト表示されており、メニューの「コマンドパレット」と「プロファイル」の下にある3番目のオプションです。

コンテキストメニューで「設定」項目をクリックすると、設定ページが表示されます。

VS Codeの設定ウィンドウが開いており、左側のナビゲーションリストで「拡張機能」カテゴリがハイライト表示されています。

左側のリストビューで、「拡張機能」項目をクリックします。次に、一番下までスクロールして「VEX」というラベルの付いた項目を見つけます。

VS Codeの設定ウィンドウが開いており、拡張機能カテゴリ内のVEXページへのリンクがハイライト表示されています。

「VEX」リスト項目をクリックします。

VS Codeのユーザー設定を開くと、VEXページが表示され、VEX Robotics Extensionの動作をカスタマイズできます。

VEX ユーザー設定が右側のパネルに表示されます。

設定の概要

コントローラ チャネル (V5 コントローラのみ)

コントローラー チャネル 設定は、V5 Brain と V5 コントローラー間の無線通信チャネル タイプを制御します。
この設定は、VS Code が USB 経由で V5 コントローラーに接続され、コントローラーが VEXnet 経由で V5 Brain に接続されている場合にのみ適用されます。ユーザーは、 ダウンロード チャンネルと ピット チャンネルの間で選択できます。 Downloadに設定すると、ユーザー プログラムのダウンロードが開始されると、ラジオはダウンロード VEXnet チャネルにジャンプします。ダウンロード チャネルにより、より高いデータ レートとより効率的なダウンロードが可能になります。 Pitに設定すると、ラジオはピット チャネルに留まり、ダウンロードにかかる時間が大幅に長くなります。デフォルトでは、この設定は ダウンロードに設定されています。

コントローラーチャンネルオプションが表示されたVEXユーザー設定。このオプションにはドロップダウンメニューがあり、デフォルトでは「ダウンロード」に設定されています。説明には「V5コントローラーの無線チャンネルを設定します」と記載されています。

Cpp プロジェクト SDK ホーム

この設定は編集しないでください。

VEXユーザー設定画面に、C++ SDKのホームオプションが表示されています。このオプションには「settings.json を編集」というリンクがあります。説明文には「編集しないでください」と書かれています。

Cpp ツールチェーンのパス

Cppツールチェーンパス C++ VEX VS Codeプロジェクトをビルドする際に使用されるツールチェーンのパスを設定します。

VEXユーザー設定で、C++ツールチェーンのパスオプションが表示されています。このオプションには、ファイルパスを表すテキストフィールドがあります。

ユーザー端末を有効にする

Enable User Terminal 設定では、VEX Brain または VEX コントローラーが拡張機能によって検出されたときに、拡張機能がユーザー シリアル ポートを開くことができます。唯一の例外は、ユーザー シリアル ポートを列挙しない V5 コントローラーに適用されます。

VEXユーザー設定で、「一般」→「ユーザー端末を有効にする」オプションが表示されている。このオプションにはドロップダウンメニューがあり、デフォルトでは「有効」に設定されています。説明には「ユーザーポートからデータを開いて表示する拡張機能を有効にする」と記載されています。

有効 では、拡張機能が起動時にユーザーポートに接続できるようになり、対話型ターミナルが作成されます。拡張機能の実行中に有効が選択されている場合、拡張機能はデバイスが接続されている場合にユーザーポートを開こうとします。
無効 起動時に拡張機能がユーザー ポートに接続できなくなり、対話型ターミナルが作成されなくなります。拡張機能の実行中に無効が選択された場合、拡張機能はユーザー ポートを閉じ、対話型ターミナルを削除します。

プロジェクトのビルドタイプ

プロジェクト ビルド タイプ は、拡張機能が C++ プロジェクトをビルドする方法を設定します。ユーザーはビルド タイプをビルドまたはリビルドに設定できます。
ビルド Make がプロジェクトのソース コードの変更を検出した場合にのみプロジェクトをビルドします。
Rebuild 、プロジェクトのビルド ディレクトリをクリーンアップしてから、プロジェクトをビルドします。このオプションは通常、かなり遅くなります。

プロジェクト構築タイプオプションが表示されたVEXユーザー設定。このオプションにはドロップダウンメニューがあり、デフォルトでは「構築」に設定されています。説明には「C++プロジェクトのビルドタイプを設定します」と記載されています。

プロジェクトホーム

プロジェクト ホーム は、新規プロジェクト ウィザードを完了するときに、新規プロジェクトのデフォルトのホーム ディレクトリを設定します。

プロジェクトホームオプションが表示されたVEXユーザー設定。このオプションには、ファイルパスを表すテキストフィールドがあります。説明には「新規プロジェクトのデフォルトの場所を設定します」と記載されています。

ダウンロード後に実行

Run After Download を有効にすると、ユーザー プログラムが VEX Brain にダウンロードされた後に実行されます。

「ダウンロード後にプロジェクトを実行する」オプションが表示されたVEXユーザー設定。このオプションにはチェックボックスがあり、この例では選択されている状態になっています。説明文には「ダウンロード後にユーザープログラムを実行するかどうかを設定します」とあります。

Python SDK ホーム

この設定は編集しないでください。

Python SDKのホームオプションが表示されたVEXユーザー設定画面。このオプションには「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 Command Help が完全に一致するものを見つけた場合、新しい Web ビューが関連ドキュメントとともに表示されます。

VS Codeの検索バーに、VEXコマンドヘルプ内の該当するVEX C++コマンドのクイックピックリストを追加することで、ユーザーの検索を絞り込むのに役立ちます。

複数のドキュメントが選択したテキストと一致する場合、ドロップダウンに関連ドキュメントのフィルタリングされたリストが表示されます。

For more information, help, and tips, check out the many resources at VEX Professional Development Plus

Last Updated: