VDAリファレンス

Vega Device Adapter（VDA）コマンドラインユーティリティを使用すると、Vegaアプリをインストール、テスト、デバッグできます。VDAはVega SDKに付属のバイナリで、$HOME/vega/sdk/vega-sdk/main//bin/tools/vdaに配置されています。 VDAで使用するようにFire TV Stickをセットアップする方法については、Fire TV Stickのセットアップを参照してください。VDAでVega仮想デバイス（シミュレーター）を操作する場合は、追加のセットアップは必要ありません。

VDAグローバルオプション

Vegaアプリをインストール、テスト、デバッグするには、以下のVDAグローバルオプション、ローカルコマンド、シェルコマンドを使用します。

シリアルオーバーライド

特定のシリアル番号または修飾子を持つデバイスまたはエミュレーターにコマンドを送信するには、-sを使用します。このオプションはVEGA_SERIAL環境変数をオーバーライドします。

デバイス（USB）

vega exec vda -s <特定のデバイス>

例：

vega exec vda -s G0XXXXXXXXXXXXXX shell

出力の例：

* daemon not running. starting it now on port 5037 *
* daemon started successfully *

デバイス（TCP/IP）

デバイスがTCP/IP経由で接続されている場合は、vega exec vda devicesの出力に表示される識別子を使用します。

vega exec vda -s <ip>:<port> shell

例：

vega exec vda -s 192.168.1.100:5555 shell

出力の例：

* daemon not running. starting it now on port 5037 *
* daemon started successfully *

Vega仮想デバイス

vega exec vda -s emulator-<VVDポート> shell

例：

vega exec vda -s emulator-5554 shell

出力の例：

* daemon not running. starting it now on port 5037 *
* daemon started successfully *

VDAローカルコマンド

デバイス接続の管理、ファイルの転送、VDAサーバーの制御を行うには、開発マシンから次のコマンドを実行します。

devices

接続されているすべてのデバイスの一覧を表示するには、devicesを使用します。-lを追加してデバイス修飾子を一覧表示します。

vega exec vda devices [ -l ]

例：

vega exec vda devices -l

USB経由で接続されているデバイスの出力例：

List of devices attached
G0XXXXXXXXXXXXXX       device usb:14131000

TCP/IP経由で接続されているデバイスの出力例：

List of devices attached
192.168.1.100:5555     device

Vega仮想デバイスの出力例：

List of devices attached
emulator-5554          device

シリアル番号の取得

DSNを出力するには、get-serialnoを使用します。このコマンドは、デバイスがネットワークに接続されている場合でも、識別子ではなく実際のDSNを返します。

vega exec vda get-serialno

USB接続デバイスでの出力例：

G0XXXXXXXXXXXXXX

TCP/IP経由で接続されている同じデバイスの出力例：

G0XXXXXXXXXXXXXX

TCP/IPモード

USB接続デバイスをTCP/IPモードに切り替えるには、tcpipを使用してポート番号を指定します。デバイスはVDAデーモンを再起動し、指定されたポートでリッスンします。ポート5555を使用するか、1024より大きいポートを使用してください。

vega exec vda tcpip <ポート>

例：

vega exec vda tcpip 5555

出力の例：

restarting in TCP mode port: 5555

TCP/IPモードに切り替えたら、USBケーブルを取り外し、connectを使用してワイヤレス接続を確立します。設定の詳細なワークフローについては、Fire TVデバイスでTCP/IP経由のVDAを構成する方法を参照してください。

USBモード

このコマンドを実行する場合は、事前にUSBケーブルの接続を確認してください。

vega exec vda usb

接続

TCP/IP経由でデバイスに接続するには、connectを使用します。最初にデバイスをTCP/IPモードに構成します（「Fire TVデバイスでTCP/IP経由のVDAを構成する方法」を参照）。

vega exec vda connect <ホスト>[:<ポート>]

ポート番号を指定しない場合、VDAはポート5555を使用します。例：

vega exec vda connect 192.168.1.100:5555

出力の例：

connected to 192.168.1.100:5555

接続が失敗したときの出力例:

failed to connect to '192.168.1.100:5555': Operation timed out

タイムアウトは通常、開発者モードが有効になっていないか、ホストとデバイスが同じネットワーク上にないことを意味します。原因の一覧については、「VDA接続と電源に関する問題の修正」を参照してください。

disconnect

TCP/IP接続デバイスの接続を解除するには、disconnectを使用します。引数を指定せずにこのコマンドを実行すると、VDAはすべてのTCP/IP接続デバイスの接続を解除します。

vega exec vda disconnect [<ホスト>[:<ポート>]]

例：

vega exec vda disconnect 192.168.1.100:5555

出力の例：

disconnected 192.168.1.100:5555

すべてのTCP/IPデバイスを一度に接続解除するには、コマンドを引数なしで実行します。

vega exec vda disconnect [<ホスト>[:<ポート>]]

出力の例：

disconnected everything

ヘルプ

ヘルプファイルを表示するには、vega exec vda --helpを使用します。

vega exec vda --help

出力の例：

Vega Device Adapter
Usage: vda [OPTIONS] [SUBCOMMAND]

Options:
  -V,--version                Display program version information and exit
  -h,--help                   Show this help message
  --one-device TEXT           only allowed with 'start-server'
  -a Excludes: -d             listen on all network interfaces, not just localhost
  -d Excludes: -a -e          use USB device (error if multiple devices connected)
  -e Excludes: -d             use TCP/IP device (error if multiple TCP/IP devices available)
  -s SERIAL (Env:VEGA_SERIAL) use device with given serial (overrides $VEGA_SERIAL)
  -t ID:POSITIVE              use device with given transport id
  -H TEXT (Env:VEGA_VDA_SERVER_ADDRESS) Excludes: -L
                              name of vda server host [default=localhost]
  -P INT:INT in [1 - 65534] (Env:VEGA_VDA_SERVER_PORT) Excludes: -L
                              port of vda server [default=5037]
  -L SOCKET (Env:VDA_SERVER_SOCKET) Excludes: -H -P
                              listen on given socket for vda server [default=tcp:localhost:5037]
  --exit-on-write-error       exit if stdout is closed

サーバーの強制終了

サーバーを停止するには、kill-serverを使用します。

vega exec vda kill-server

サーバーの起動

サーバーを起動するには、start-serverを使用します。

vega exec vda start-server

出力の例：

* daemon not running. starting it now on port 5037 *
* daemon started successfully *

プッシュ

ファイルまたはディレクトリをデバイスにコピーするには、pushを使用します。転送の進行状況を表示するには-pを使用します。

vega exec vda push [-p] <ローカル> <リモート>

例：

vega exec vda push Echo.png /tmp/

出力の例：

$ vega exec vda push Echo.png /tmp/
2283 KB/s (6109 bytes in 0.002s)

$ vega exec vda shell ls /tmp/Echo*
/tmp/Echo.png

プル

デバイスからファイルまたはディレクトリをコピーするには、pullを使用します。-pを追加すると転送の進行状況が表示され、-aを追加するとタイムスタンプとモードが表示されます。

vega exec vda pull [-p] [-a] <リモート> [<ローカル>]

例：

vega exec vda pull -p /tmp/Echo.png

出力の例：

$ vega exec vda pull -p /tmp/Echo.png
Transferring: 6109/6109 (100%)
370 KB/s (6109 bytes in 0.016s)

$ ls Echo*
Echo.png

バージョン

VDAのバージョンを表示するには、versionを使用します。

vega exec vda version

出力の例：

Vega Device Adapter version 2.12+0a5eee73
Server Version 41
Platform Version 34.0.4

デバイスの待機

デバイスがオンラインになるまでアクティビティをブロックするには、wait-for-deviceを使用します。これは、スクリプトで操作する場合に役立ちます。

vega exec vda wait-for-device

出力の例：

$ vega exec vda devices
List of devices attached

$ vega exec vda wait-for-device

$ vega exec vda devices
List of devices attached
G0XXXXXXXXXXXXXX    device

再起動

デバイスを再起動するには、rebootを使用します。

vega exec vda reboot

出力の例：

$ vega exec vda reboot

$ vega exec vda wait-for-device

$ vega exec vda devices
List of devices attached
G0XXXXXXXXXXXXXX    device

VDAシェルコマンド

これらのコマンドは、VDAシェルを介してデバイス上で実行されます。

シェルの起動

vega exec vda shellコマンドを使用すると、リモートシェルをインタラクティブに実行し、多くのオプションを使用できます。

vega exec vda shell <コマンド>

出力の例：

##################################################
#####     Welcome to Developer Mode Shell    #####
##################################################
sh(com.amazon.dev.shell):/$

その他のシェルコマンド

vega exec vda shell <command>

例：

vega exec vda shell whoami

出力の例：

app_user

アプリの管理・通信ツール

これらのツールにはVDAシェルからアクセスできます。

   vega exec vda shell vpm <サブコマンド>
   vega exec vda shell vlcm <サブコマンド>
   vega exec vda shell vmsgr <サブコマンド>

vpm、vlcm、vmsgrコマンドの詳細については、アプリの管理・通信ツールを参照してください。

コンポーネントシェルの起動

各アプリは1つ以上のコンポーネントを起動します。コンポーネントの一覧を取得するには、次のコマンドを実行します。

vega exec vda shell vlcm list

出力の例：

application                                type      pid     id    state       lifespan       timeout container                               launch args
com.amazon.lcm.stem.webview.main           S         2719    1     IDLE        PERMANENT      DEFAULT framework.slice/service                 <none>
com.amazon.lcm.stem.apl.main               S         2725    2     IDLE        PERMANENT      DEFAULT framework.slice/service                 <none>
com.amazon.otad.main                       I         3901    18    NOT_VISIBLE PERMANENT      DEFAULT app.slice/app                           <none>

以降のコマンドでは、application列の値を<コンポーネントID>引数として使用します。コンポーネントを対話型で実行するには、次のコマンドを使用します。

vega exec vda shell -c <コンポーネントID>

出力の例：

vega exec vda shell -c com.amazon.otad.main
##################################################
#####     Welcome to Developer Mode Shell    #####
##################################################
sh(com.amazon.otad):/$

コンポーネントシェルでコマンドを実行するには、次のコマンドを使用します。

vega exec vda shell -c <コンポーネントID> <command>

例：

vega exec vda shell -c com.amazon.otad.main df -h /tmp

出力の例：

vega exec vda shell -c com.amazon.otad.main df -h /tmp
Filesystem            Size  Used Avail Use% Mounted on
none                   64M     0   64M   0% /tmp

メモリ使用状況

システム内のすべてのプロセスに関するメモリ使用量の概要を確認するには、ace_memusageを使用します。

vega exec vda shell ace_memusage

出力の例：

PID   User     Cmdline                                 Swap    Uss     Pss     Rss     Vss
1     root     /sbin/init                              0       1128    2669    8184    28904
401   root     /lib/systemd/systemd-journald           0       2560    3150    7116    19692
423   root     /lib/systemd/systemd-udevd              0       2432    2694    6220    18956

Total System Memory:
Total     Free      Buffers    Cached    Shmem   Slab    Available
1782444   1088312   142808     278528    10880   79024   1479176
Done

スクリーンショットのキャプチャ

スクリーンショットをキャプチャしてPNG形式で保存するには、gwsi-tool-screenshooterを使用します。

vega exec vda shell gwsi-tool-screenshooter <file.png>

例：

$ vega exec vda shell gwsi-tool-screenshooter /tmp/test.png

$ vega exec vda pull /tmp/test.png

$ ls test.png
test.png

デバイスログ

デバイスログを画面に出力するには、loggingctl logを使用します。

vega exec vda shell loggingctl log <サブコマンド>

例：

vega exec vda shell loggingctl log -o short-precise -f

出力の例：

Jun 05 18:10:37.484732 firetvstick-xxxxxxxxxxxxxxxx idle-manager[3268]: I idle-service:[IdleManagerService.cpp:107] transitionTo: 0->2
Jun 05 18:10:37.484831 firetvstick-xxxxxxxxxxxxxxxx idle-manager[3268]: I idle-service:[ScreensaverLauncher.cpp:71] Launching pkg://com.amazon.screensaver
Jun 05 18:10:37.485561 firetvstick-xxxxxxxxxxxxxxxx lcm_service[2151]: I lcm-ipc-server:[LcmServer.cpp:182] Received request: launch app for result (1) from (uid:101, gid:101, pid:3268, security_ctx:System)
<continuous log output>

Vega CLIツール

VDAグローバルオプション

シリアルオーバーライド

デバイス（USB）

デバイス（TCP/IP）

Vega仮想デバイス

VDAローカルコマンド

devices

シリアル番号の取得

TCP/IPモード

USBモード

接続

disconnect

ヘルプ

サーバーの強制終了

サーバーの起動

プッシュ

プル

バージョン

デバイスの待機

再起動

VDAシェルコマンド

シェルの起動

その他のシェルコマンド

アプリの管理・通信ツール

コンポーネントシェルの起動

メモリ使用状況

スクリーンショットのキャプチャ

デバイスログ

関連トピック

​VDAグローバルオプション

​シリアルオーバーライド

​デバイス（USB）

​デバイス（TCP/IP）

​Vega仮想デバイス

​VDAローカルコマンド

​devices

​シリアル番号の取得

​TCP/IPモード

​USBモード

​接続

​disconnect

​ヘルプ

​サーバーの強制終了

​サーバーの起動

​プッシュ

​プル

​バージョン

​デバイスの待機

​再起動

​VDAシェルコマンド

​シェルの起動

​その他のシェルコマンド

​アプリの管理・通信ツール

​コンポーネントシェルの起動

​メモリ使用状況

​スクリーンショットのキャプチャ

​デバイスログ

​関連トピック

VDAグローバルオプション

シリアルオーバーライド

デバイス（USB）

デバイス（TCP/IP）

Vega仮想デバイス

VDAローカルコマンド

devices

シリアル番号の取得

TCP/IPモード

USBモード

接続

disconnect

ヘルプ

サーバーの強制終了

サーバーの起動

プッシュ

プル

バージョン

デバイスの待機

再起動

VDAシェルコマンド

シェルの起動

その他のシェルコマンド

アプリの管理・通信ツール

コンポーネントシェルの起動

メモリ使用状況

スクリーンショットのキャプチャ

デバイスログ

関連トピック