この記事は、VEX Visual Studio Code Extension UI(ユーザー インターフェイス)の概要です。 この拡張機能は、VEX IQ 第 2 世代、EXP、および V5 プラットフォーム用の C++ および Python プロジェクトの開発をサポートします。
UIコンポーネント
VEX VS コード拡張には 3 つの主要なコンポーネントがあります。
- ツールバー
- アクティビティバーとサイドバー
- 端子パネル
ツールバー
ツールバーを使用すると、ユーザーは VEX VS Code 拡張プロジェクト、VEX Brains、および VEX コントローラーを簡単に操作できます。 ツールバーは、有効な VEX プロジェクトが VS Codeで開かれている場合にのみアクティブになります。 有効な VEX プロジェクトは、拡張機能によって作成またはインポートされたプロジェクトです。 VEXcode または VEXcode Pro プロジェクトを開くことは無効なので、インポートする必要があります。
デバイスピッカー
デバイス ピッカーには 2 つの主な機能があります。 まず、接続されている VEX デバイスのタイプを表すブレインまたはコントローラーのアイコンが表示されます。
次に、デバイス リスト アイコンをクリックすると、接続されているすべての VEX デバイスを含むクイック ピック リストが表示されます。 ユーザーは、拡張機能が接続するデバイスを選択できます。
現在接続されているデバイスは常にリストの先頭に表示され、その後に他のすべてのデバイスがデバイス タイプ (ブレインまたはコントローラー) およびプラットフォーム (IQ 第 2 世代、EXP、および V5) ごとに並べ替えられて表示されます。
各デバイス項目には、ブレイン名、プラットフォーム、デバイス タイプ、およびデバイス パスの情報が含まれています。
重要
コントローラがコンピュータに接続されているが、ブレインへの無線リンクがない場合、リスト項目またはデバイス リストのステータス バー アイコンの横にブレイン名は表示されません。
スロットセレクター
スロット セレクター アイコンを使用すると、拡張機能がユーザー プログラムをダウンロードまたは再生するスロットを選択できます。
スロット セレクター アイコンをクリックすると、利用可能なユーザー プログラム スロット 1 ~ 8 を含むクイック ピック リストが表示されます。
ビルド/ダウンロード
VEX Brain または VEX コントローラーが接続されている場合、Build/Download アイコンの機能が変わります。
VEX デバイスが接続されていない場合は、ビルド アイコンが表示されます。 クリックすると、プロジェクトがビルドされるだけです。
VEX デバイスが接続されている場合、ダウンロード アイコンが表示されます。 クリックするとプロジェクトがビルドされ、成功すると VEX デバイスにダウンロードされます。
遊ぶ
再生アイコンをクリックすると、選択したスロットでユーザー プログラムが実行されます。
停止
停止アイコンをクリックすると、ユーザープログラムが停止します。
選択したワークスペース
VS Code はマルチ ワークスペース プロジェクトをサポートします。 ワークスペース内に複数の VEX プロジェクトが存在する場合、プロジェクト セレクターを使用してユーザーは VEX プロジェクトを切り替えることができます。
プロジェクト セレクター アイコンをクリックすると、すべての有効なプロジェクトを含むクイック ピック リストが表示されます。
重要
プロジェクトが有効でない場合、プロジェクトのクイック ピック リストには表示されません。 プロジェクトは、VEX VS Code 拡張機能によって作成またはインポートされない限り有効ではありません。
Python ファイル セレクター(Python のみ)
VEX Python プロジェクトが選択されると、Python ファイル セレクターがツールバーに表示されます。 Python for 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 ID、および Python ランタイム バージョン情報が含まれます。
シリアルポート情報
シリアル ポート情報には、VEX デバイスで使用可能な各ポートのデバイス パスが表示されます。 ほとんどの VEX デバイスは 2 つのシリアル ポートとして列挙されます。 通信シリアル ポートは、プログラムをダウンロードし、脳機能を制御するために使用されます。 ユーザー シリアル ポートは、Brain 上で実行されているユーザー アプリと USB 経由で接続されたホスト コンピューターの間でデータを転送するために使用されます。 V5 コントローラーは、通信シリアル ポートのみを備え、ユーザー シリアル ポートを持たない唯一の VEX デバイスです。
プログラム情報
プログラム情報には、VEX Brain にダウンロードされたすべてのユーザー プログラムのリストが表示されます。
各プログラム リストの項目を展開すると、スロットの場所、ファイル名、言語の種類、ファイル サイズ、ダウンロード時間など、各ユーザー プログラムに関する追加情報が表示されます。
デバイス情報
デバイス情報には、VEX Brain に接続されているすべてのスマート ポート デバイスのリストが表示されます。 各リスト項目には、スマート ポート番号とデバイス タイプが表示されます。
各デバイス リスト項目を展開して、各スマート ポート デバイスのファームウェア バージョン情報を表示できます。
VEX Brain Deviceに接続すると、コントローラーのリンクステータスが表示されます。
VEX Brain は VEX コントローラーにリンクされています
VEX Brain は VEX コントローラーにリンクされていません
VEX V5 コントローラーは VEX V5 Brain に接続されています
スクリーンショット
カメラ アイコンをクリックすると、ユーザーは VEX Brain からスクリーンショットを撮ってダウンロードできます。
スクリーンショットは、USB 経由で VEX Brain に直接接続した場合のみ利用可能です
バッテリーメディック (V5 Brain のみ)
ハートのアイコンをクリックすると、拡張機能がバッテリーメディックユーザープログラムをダウンロードして実行します。
ブレインネームを設定する
system>名の横にある鉛筆アイコンをクリックすると、ユーザーは VEX Brain の名前を設定できます。
鉛筆アイコンをクリックすると、VS Code エディターの上部に入力ボックスが表示されます。 入力ボックスに新しい脳名を入力し、Enter キーを押して設定します。
チーム番号を設定する
system->チームの横にある鉛筆アイコンをクリックすると、VEX Brain のチーム番号を設定できます。
鉛筆アイコンをクリックすると、VS Code エディターの上部に入力ボックスが表示されます。 入力ボックスに新しいチーム番号を入力し、Enter キーを押して設定します。
ユーザープログラムの消去
プログラム>プロジェクト名の横にある ゴミ箱 アイコンをクリックすると、特定のスロットのプログラムを消去できます。 重要、一度消去したプログラムは復元できません。 この機能を使用する場合は注意してください。
デバイス情報の警告
VEXos アップデート
VEX Brain の VEXos バージョンが古い場合、VEXos バージョンの横に警告メッセージ アイコンが表示され、両方の Brain アイコンが黄色に変わります。
この警告を解決するには、ユーザーは VEXos Brain の VEXos を更新する必要があります。
VEXos は、VEX Brain アイコンの横にある上矢印をクリックして更新できます。
また、VEXos が古い場合は、VS Code エディターの右下隅に通知ボックスが表示されます。 ユーザーは「更新」ボタンをクリックして VEXos アップデートを開始するか、「無視」ボタンをクリックして VEXos アップデートをスキップできます。
脳が接続されたコントローラーにリンクされていません
VEX コントローラーがコンピューターに接続されているが、VEX Brain にリンクされていない場合、VEX コントローラーのアイコンは黄色に変わります。
この警告を解決するには、ユーザーは VEX コントローラーを VEX Brain にリンクする必要があります。
端子パネル
VEX VS コード拡張機能は、起動時にログ ターミナルとインタラクティブ ターミナルという 2 つのターミナルを提供します。
ログターミナル
ログ ターミナルには、ビルド出力、ビルド エラー、ダウンロード結果が表示されます。
インタラクティブターミナル
インタラクティブ ターミナルには、printf ログの表示と生のキーストロークをユーザー プログラムに送信するという 2 つの機能があります。 インタラクティブ ターミナルを利用するには、VEX VS Code Extension を実行しているコンピュータに Brain または Controller を接続する必要があります。 ユーザープログラムをビルドしてダウンロードした後、対話型ターミナル出力はデフォルトでクリアされます。
ユーザー設定
ユーザー設定は、Visual Studio コードが拡張機能ごとに提供するグローバル設定です。 ユーザー設定は、すべての VEX VS Code 拡張プロジェクトに適用されます。
VEX ユーザー設定にアクセスする方法
VS Code の左隅にある歯車をクリックすると、コンテキスト メニューが表示されます
コンテキストメニューで「設定」項目をクリックすると、設定ページが表示されます。
左側のリストビューで、「拡張機能」項目をクリックします。 次に、一番下までスクロールして「VEX」というラベルの付いた項目を見つけます。
「VEX」リスト項目をクリックします。
VEX ユーザー設定が右側のパネルに表示されます。
設定の概要
コントローラ チャネル (V5 コントローラのみ)
コントローラー チャネル 設定は、V5 Brain と V5 コントローラー間の無線通信チャネル タイプを制御します。
この設定は、VS Code が USB 経由で V5 コントローラーに接続され、コントローラーが VEXnet 経由で V5 Brain に接続されている場合にのみ適用されます。 ユーザーは、 ダウンロード チャンネルと ピット チャンネルの間で選択できます。 Downloadに設定すると、ユーザー プログラムのダウンロードが開始されると、ラジオはダウンロード VEXnet チャネルにジャンプします。 ダウンロード チャネルにより、より高いデータ レートとより効率的なダウンロードが可能になります。 Pitに設定すると、ラジオはピット チャネルに留まり、ダウンロードにかかる時間が大幅に長くなります。 デフォルトでは、この設定は ダウンロードに設定されています。
Cpp プロジェクト SDK ホーム
この設定は編集しないでください。
Cpp ツールチェーンのパス
Cpp ツールチェーン パス は、C++ VEX VS Code プロジェクトを構築するときに使用されるツールチェーンのパスを設定します。
ユーザー端末を有効にする
Enable User Terminal 設定では、VEX Brain または VEX コントローラーが拡張機能によって検出されたときに、拡張機能がユーザー シリアル ポートを開くことができます。 唯一の例外は、ユーザー シリアル ポートを列挙しない V5 コントローラーに適用されます。
有効 では、拡張機能が起動時にユーザーポートに接続できるようになり、対話型ターミナルが作成されます。 拡張機能の実行中に有効が選択されている場合、拡張機能はデバイスが接続されている場合にユーザーポートを開こうとします。
無効 起動時に拡張機能がユーザー ポートに接続できなくなり、対話型ターミナルが作成されなくなります。 拡張機能の実行中に無効が選択された場合、拡張機能はユーザー ポートを閉じ、対話型ターミナルを削除します。
プロジェクトのビルドタイプ
プロジェクト ビルド タイプ は、拡張機能が C++ プロジェクトをビルドする方法を設定します。 ユーザーはビルド タイプをビルドまたはリビルドに設定できます。
ビルド Make がプロジェクトのソース コードの変更を検出した場合にのみプロジェクトをビルドします。
Rebuild 、プロジェクトのビルド ディレクトリをクリーンアップしてから、プロジェクトをビルドします。 このオプションは通常、かなり遅くなります。
プロジェクトホーム
プロジェクト ホーム は、新規プロジェクト ウィザードを完了するときに、新規プロジェクトのデフォルトのホーム ディレクトリを設定します。
ダウンロード後に実行
Run After Download を有効にすると、ユーザー プログラムが VEX Brain にダウンロードされた後に実行されます。
Python SDK ホーム
この設定は編集しないでください。
VEX コマンドのヘルプ
VEX コマンド ヘルプを使用すると、C++ および Python API (アプリケーション プログラミング インターフェイス) に含まれる特定の関数のドキュメントにアクセスできます。 ドキュメントは各 VEX プラットフォーム (IQ 第 2 世代、EXP、V5) に固有です。
VEX コマンド ヘルプにアクセスするには、まず、検索する関数のテキストをハイライト表示します。
選択したテキストを右クリックすると、コンテキスト メニューが表示されます。
次に、VEX コマンド ヘルプをクリックしてドキュメントにアクセスします。
VEX Command Help が完全に一致するものを見つけた場合、新しい Web ビューが関連ドキュメントとともに表示されます。
複数のドキュメントが選択したテキストと一致する場合、ドロップダウンに関連ドキュメントのフィルタリングされたリストが表示されます。