この記事は、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 コントローラーを簡単に操作できます。 ツールバーは、有効な VEX プロジェクトが VS Codeで開かれている場合にのみアクティブになります。 有効な VEX プロジェクトは、拡張機能によって作成またはインポートされたプロジェクトです。 VEXcode または VEXcode Pro プロジェクトを開くことは無効なので、インポートする必要があります。

接続された VEX デバイスおよびプロジェクトとすばやく対話するために使用できる VEX 拡張アイコンを備えた VS Code ツールバー。 VEX の機能には、デバイス ピッカー、スロット セレクター、ビルド & ダウンロード アイコン、再生アイコン、停止アイコン、プロジェクト セレクター、Python ファイル セレクターが含まれます。

デバイスピッカー

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

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

接続されているすべての VEX デバイスのクイックピック リストを備えた VS Code 検索バー。 この例では、V5 ブレイン、V5 コントローラー、および EXP コントローラーがリストされています。

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

詳細を提供するためにクイックピックリスト項目が表示された VS Code 検索バー。 アイテムには、MyBrain、V5 Brain、User COM8、Comm COM7 と表示されます。

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

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

青い背景の V5 コントローラー項目。このコントローラーがブレインへの無線リンクを持っていることを示します。

重要

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

スロットセレクター

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

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

接続された VEX Brain 上の利用可能なすべてのスロットのクイックピックリストを備えた VS Code 検索バー。 この例では、使用可能なスロットは 8 つあります。

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

ビルド/ダウンロード

ビルドアイコン。アイコンをダウンロードします。

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

ビルドアイコン。

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

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

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

遊ぶ

再生アイコン。

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

停止

停止アイコン。

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

選択したワークスペース

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

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

保存された VEX プロジェクトのクイックピックリストを備えた VS Code 検索バー。 この例では、Python プロジェクトが 1 つと C++ プロジェクトが 1 つリストされています。

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

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

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

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

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


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

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

VEX ビューに開かれた VS Code アクティビティ バーとサイド バーを示すスクリーンショット。 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 フォルダーの下に表示され、強調表示されます。 システム フォルダーには Brain に関するデータがあり、そのデータには VEXos 1.0.1.0、名前 VEX_EXP、チーム 000000、ID 0EC83725、Python 1.0.0.7 と記載されています。

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

シリアルポート情報

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

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

プログラム情報

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

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

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

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

デバイス情報

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

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

Devices フォルダとその内容は、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 デバイス インジケーター フォルダーの上に置かれ、その横に Battery Medic アイコンが表示されます。

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

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

カーソルはシステム フォルダー内の [名前] オプションの上に置かれ、その横に鉛筆アイコンが表示されます。

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

Brain Name プロンプト ウィンドウにテキスト フィールドを設定し、その下に「入力を確認するには 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 拡張機能。 下部には、「更新」と「無視」という 2 つのボタンがあります。

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

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

VEX デバイス インジケーター フォルダーの下の 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 ページが表示されます。

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

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

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

多くのオプションがリストされた VS Code 設定のコンテキスト メニュー。 [設定] というオプションが強調表示され、メニューの [コマンド パレット] と [プロファイル] の下の 3 番目のオプションになります。

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

VS Code 設定ウィンドウが開き、左側のナビゲーション リストで拡張機能カテゴリが強調表示されます。

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

VS Code 設定ウィンドウが開き、拡張機能カテゴリ内の VEX ページ リンクが強調表示されます。

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

VS Code ユーザー設定が開き、VEX ロボティクス拡張機能の動作をカスタマイズできる VEX ページが表示されます。

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

設定の概要

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

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

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

Cpp プロジェクト SDK ホーム

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

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

Cpp ツールチェーンのパス

Cpp ツールチェーン パス は、C++ VEX VS Code プロジェクトを構築するときに使用されるツールチェーンのパスを設定します。

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

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

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

VEX ユーザー設定。一般ユーザー ターミナルの有効化オプションが表示されています。 このオプションにはドロップダウン メニューがあり、デフォルトで [有効] に設定されています。 説明には、拡張機能を有効にして、ユーザー ポートからデータを開いて表示するように書かれています。

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

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

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

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

プロジェクトホーム

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

プロジェクト ホーム オプションが表示された 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: