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

image48.png

UIコンポーネント

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

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

ツールバー

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

画像2.png

デバイスピッカー

画像60.png

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

image41.png

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

画像4.png

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

画像8.png

image56.png

重要

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

スロットセレクター

画像19.png

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

image43.png

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

ビルド/ダウンロード

画像5.png画像6.png

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

画像5.png

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

画像6.png

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

遊ぶ

image33.png

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

停止

image45.png

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

選択したワークスペース

画像24.png

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

画像14.png

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

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

image34.png

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

画像17.png


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

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

image57.png

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

image47.png

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

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

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

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

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

VEX デバイス情報

image37.pngimage62.png

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

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

画像25.png

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

シリアルポート情報

画像7.png

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

プログラム情報

画像12.png

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

画像23.png

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

デバイス情報

画像20.png

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

画像29.png

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

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

image44.png

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

画像10.png

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

image52.png

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

スクリーンショット

画像50.png

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

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

image39.png

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

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

画像28.png

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

image54.png

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

チーム番号を設定する

image58.png

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

image49.png

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

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

画像30.png

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

デバイス情報の警告

VEXos アップデート

画像22.png

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

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

画像31.png

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

image36.png

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

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

画像21.png

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

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

端子パネル

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

画像11.png

ログターミナル

画像13.png

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

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

画像16.png

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

ユーザー設定

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

image32.png

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

image42.png

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

画像27.png

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

画像9.png

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

画像18.png

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

image46.png

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

設定の概要

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

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

image63.png

Cpp プロジェクト SDK ホーム

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

画像1.png

Cpp ツールチェーンのパス

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

画像3.png

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

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

image61.png

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

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

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

image51.png

プロジェクトホーム

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

image38.png

ダウンロード後に実行

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

image53.png

Python SDK ホーム

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

image59.png

VEX コマンドのヘルプ

VEX コマンド ヘルプを使用すると、C++ および Python API (アプリケーション プログラミング インターフェイス) に含まれる特定の関数のドキュメントにアクセスできます。 ドキュメントは各 VEX プラットフォーム (IQ 第 2 世代、EXP、V5) に固有です。

image55.png

VEX コマンド ヘルプにアクセスするには、まず、検索する関数のテキストをハイライト表示します。

画像15.png

選択したテキストを右クリックすると、コンテキスト メニューが表示されます。
次に、VEX コマンド ヘルプをクリックしてドキュメントにアクセスします。

画像35.png

VEX Command Help が完全に一致するものを見つけた場合、新しい Web ビューが関連ドキュメントとともに表示されます。

画像26.png

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

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

Last Updated: