2025 年 3 月 27 日より、AOSP のビルドとコントリビューションには aosp-main ではなく android-latest-release を使用することをおすすめします。詳細については、AOSP の変更をご覧ください。

USB Port Reset API

USB Hardware Abstraction Layer（HAL）API をサポートするためには、デバイスメーカーで対応する USB HAL バージョンを実装する必要があります。USB HAL API を使用するには、システム特権アプリが必要です。

USB HAL は、USB HAL v2.0 を必要とする USB Port Reset API をサポートしており、Android 13 以降を搭載したデバイスで利用できます。この API を使用して、接続したホストを使用する USB 接続をリセットします。

USB HAL とその API の確認

デバイスメーカーは、API をサポートするために、USB HAL を実装する必要があります。

USB HAL のデフォルト実装を確認するには、以下のパスを使用します。

バージョン AIDL（最新）: <aosp>/hardware/interfaces/usb/gadget/1.2/default/
ハードウェアインターフェースのヘッダーファイルを確認するには、以下のパスを使用します。

バージョン AIDL（最新）: <aosp>/hardware/interfaces/usb/gadget/1.2/IUsbGadget.hal
API を確認するには、以下のパスを使用して AIDL ヘッダーファイルで API を見つけます。このパスは、この API の Android フレームワークエントリポイントでもあります。

android.hardware.usb: <aosp>/core/java/android/hardware/usb

USB HAL API を使用するには、以下を実装します。

USB HAL API は android.hardware.usb パッケージに組み込まれており、USB HAL を利用してデバイスとやり取りします。この API のアーキテクチャについての詳細を以下の図に示します。

下の図は、フレームワーク内の USB Port Reset API のコードフローを示しています。これには、USB HAL の実装も含まれています。

USB Port Reset API コードフローのサンプル

図 1.1 USB Port Reset API コードフローのサンプル

各 USB HAL バージョンと対応する API は、ベンダーテストスイート（VTS）のテストケースに関連付けられています。

USB Port Reset API の VTS テストケースを見つけるには、次にアクセスします。

USB HAL v1.2 向けの VTS テストケースは、これらのアクションを実行するために使用できるホスト側のテストケースです。