Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 2f162ef1 authored by Badhri Jagan Sridharan's avatar Badhri Jagan Sridharan
Browse files

USB: HIDL: Type-c usb interface V1_0 

This interface is responsible for handling type-c port enquiry
and role swtiching.

BUG: 31015010
Test: Manually tested on Angler and sailfish for type-c role switches.
Change-Id: I2c4fb01e7bd74f0483ab08b543e2ce294175bc35
parent cd912948

usb/1.0/Android.bp

0 → 100644
+64 −0
Original line number Diff line number Diff line 
// This file is autogenerated by hidl-gen. Do not edit manually.



genrule {

    name: "android.hardware.usb@1.0_genc++",

    tools: ["hidl-gen"],

    cmd: "$(location hidl-gen) -o $(genDir) -Lc++ -randroid.hardware:hardware/interfaces -randroid.hidl:system/libhidl/transport android.hardware.usb@1.0",

    srcs: [

        "types.hal",

        "IUsb.hal",

        "IUsbCallback.hal",

    ],

    out: [

        "android/hardware/usb/1.0/types.cpp",

        "android/hardware/usb/1.0/UsbAll.cpp",

        "android/hardware/usb/1.0/UsbCallbackAll.cpp",

    ],

}



genrule {

    name: "android.hardware.usb@1.0_genc++_headers",

    tools: ["hidl-gen"],

    cmd: "$(location hidl-gen) -o $(genDir) -Lc++ -randroid.hardware:hardware/interfaces -randroid.hidl:system/libhidl/transport android.hardware.usb@1.0",

    srcs: [

        "types.hal",

        "IUsb.hal",

        "IUsbCallback.hal",

    ],

    out: [

        "android/hardware/usb/1.0/types.h",

        "android/hardware/usb/1.0/IUsb.h",

        "android/hardware/usb/1.0/IHwUsb.h",

        "android/hardware/usb/1.0/BnHwUsb.h",

        "android/hardware/usb/1.0/BpHwUsb.h",

        "android/hardware/usb/1.0/BsUsb.h",

        "android/hardware/usb/1.0/IUsbCallback.h",

        "android/hardware/usb/1.0/IHwUsbCallback.h",

        "android/hardware/usb/1.0/BnHwUsbCallback.h",

        "android/hardware/usb/1.0/BpHwUsbCallback.h",

        "android/hardware/usb/1.0/BsUsbCallback.h",

    ],

}



cc_library_shared {

    name: "android.hardware.usb@1.0",

    generated_sources: ["android.hardware.usb@1.0_genc++"],

    generated_headers: ["android.hardware.usb@1.0_genc++_headers"],

    export_generated_headers: ["android.hardware.usb@1.0_genc++_headers"],

    shared_libs: [

        "libhidlbase",

        "libhidltransport",

        "libhwbinder",

        "liblog",

        "libutils",

        "libcutils",

        "android.hidl.base@1.0",

    ],

    export_shared_lib_headers: [

        "libhidlbase",

        "libhidltransport",

        "libhwbinder",

        "libutils",

        "android.hidl.base@1.0",

    ],

}

usb/1.0/Android.mk

0 → 100644
+427 −0
Original line number Diff line number Diff line 
# This file is autogenerated by hidl-gen. Do not edit manually.



LOCAL_PATH := $(call my-dir)



################################################################################



include $(CLEAR_VARS)

LOCAL_MODULE := android.hardware.usb@1.0-java

LOCAL_MODULE_CLASS := JAVA_LIBRARIES



intermediates := $(local-generated-sources-dir)



HIDL := $(HOST_OUT_EXECUTABLES)/hidl-gen$(HOST_EXECUTABLE_SUFFIX)



LOCAL_JAVA_LIBRARIES := \

    android.hidl.base@1.0-java \





#

# Build types.hal (PortDataRole)

#

GEN := $(intermediates)/android/hardware/usb/V1_0/PortDataRole.java

$(GEN): $(HIDL)

$(GEN): PRIVATE_HIDL := $(HIDL)

$(GEN): PRIVATE_DEPS := $(LOCAL_PATH)/types.hal

$(GEN): PRIVATE_OUTPUT_DIR := $(intermediates)

$(GEN): PRIVATE_CUSTOM_TOOL = \

        $(PRIVATE_HIDL) -o $(PRIVATE_OUTPUT_DIR) \

        -Ljava \

        -randroid.hardware:hardware/interfaces \

        -randroid.hidl:system/libhidl/transport \

        android.hardware.usb@1.0::types.PortDataRole



$(GEN): $(LOCAL_PATH)/types.hal

	$(transform-generated-source)

LOCAL_GENERATED_SOURCES += $(GEN)



#

# Build types.hal (PortMode)

#

GEN := $(intermediates)/android/hardware/usb/V1_0/PortMode.java

$(GEN): $(HIDL)

$(GEN): PRIVATE_HIDL := $(HIDL)

$(GEN): PRIVATE_DEPS := $(LOCAL_PATH)/types.hal

$(GEN): PRIVATE_OUTPUT_DIR := $(intermediates)

$(GEN): PRIVATE_CUSTOM_TOOL = \

        $(PRIVATE_HIDL) -o $(PRIVATE_OUTPUT_DIR) \

        -Ljava \

        -randroid.hardware:hardware/interfaces \

        -randroid.hidl:system/libhidl/transport \

        android.hardware.usb@1.0::types.PortMode



$(GEN): $(LOCAL_PATH)/types.hal

	$(transform-generated-source)

LOCAL_GENERATED_SOURCES += $(GEN)



#

# Build types.hal (PortPowerRole)

#

GEN := $(intermediates)/android/hardware/usb/V1_0/PortPowerRole.java

$(GEN): $(HIDL)

$(GEN): PRIVATE_HIDL := $(HIDL)

$(GEN): PRIVATE_DEPS := $(LOCAL_PATH)/types.hal

$(GEN): PRIVATE_OUTPUT_DIR := $(intermediates)

$(GEN): PRIVATE_CUSTOM_TOOL = \

        $(PRIVATE_HIDL) -o $(PRIVATE_OUTPUT_DIR) \

        -Ljava \

        -randroid.hardware:hardware/interfaces \

        -randroid.hidl:system/libhidl/transport \

        android.hardware.usb@1.0::types.PortPowerRole



$(GEN): $(LOCAL_PATH)/types.hal

	$(transform-generated-source)

LOCAL_GENERATED_SOURCES += $(GEN)



#

# Build types.hal (PortRole)

#

GEN := $(intermediates)/android/hardware/usb/V1_0/PortRole.java

$(GEN): $(HIDL)

$(GEN): PRIVATE_HIDL := $(HIDL)

$(GEN): PRIVATE_DEPS := $(LOCAL_PATH)/types.hal

$(GEN): PRIVATE_OUTPUT_DIR := $(intermediates)

$(GEN): PRIVATE_CUSTOM_TOOL = \

        $(PRIVATE_HIDL) -o $(PRIVATE_OUTPUT_DIR) \

        -Ljava \

        -randroid.hardware:hardware/interfaces \

        -randroid.hidl:system/libhidl/transport \

        android.hardware.usb@1.0::types.PortRole



$(GEN): $(LOCAL_PATH)/types.hal

	$(transform-generated-source)

LOCAL_GENERATED_SOURCES += $(GEN)



#

# Build types.hal (PortRoleType)

#

GEN := $(intermediates)/android/hardware/usb/V1_0/PortRoleType.java

$(GEN): $(HIDL)

$(GEN): PRIVATE_HIDL := $(HIDL)

$(GEN): PRIVATE_DEPS := $(LOCAL_PATH)/types.hal

$(GEN): PRIVATE_OUTPUT_DIR := $(intermediates)

$(GEN): PRIVATE_CUSTOM_TOOL = \

        $(PRIVATE_HIDL) -o $(PRIVATE_OUTPUT_DIR) \

        -Ljava \

        -randroid.hardware:hardware/interfaces \

        -randroid.hidl:system/libhidl/transport \

        android.hardware.usb@1.0::types.PortRoleType



$(GEN): $(LOCAL_PATH)/types.hal

	$(transform-generated-source)

LOCAL_GENERATED_SOURCES += $(GEN)



#

# Build types.hal (PortStatus)

#

GEN := $(intermediates)/android/hardware/usb/V1_0/PortStatus.java

$(GEN): $(HIDL)

$(GEN): PRIVATE_HIDL := $(HIDL)

$(GEN): PRIVATE_DEPS := $(LOCAL_PATH)/types.hal

$(GEN): PRIVATE_OUTPUT_DIR := $(intermediates)

$(GEN): PRIVATE_CUSTOM_TOOL = \

        $(PRIVATE_HIDL) -o $(PRIVATE_OUTPUT_DIR) \

        -Ljava \

        -randroid.hardware:hardware/interfaces \

        -randroid.hidl:system/libhidl/transport \

        android.hardware.usb@1.0::types.PortStatus



$(GEN): $(LOCAL_PATH)/types.hal

	$(transform-generated-source)

LOCAL_GENERATED_SOURCES += $(GEN)



#

# Build types.hal (Status)

#

GEN := $(intermediates)/android/hardware/usb/V1_0/Status.java

$(GEN): $(HIDL)

$(GEN): PRIVATE_HIDL := $(HIDL)

$(GEN): PRIVATE_DEPS := $(LOCAL_PATH)/types.hal

$(GEN): PRIVATE_OUTPUT_DIR := $(intermediates)

$(GEN): PRIVATE_CUSTOM_TOOL = \

        $(PRIVATE_HIDL) -o $(PRIVATE_OUTPUT_DIR) \

        -Ljava \

        -randroid.hardware:hardware/interfaces \

        -randroid.hidl:system/libhidl/transport \

        android.hardware.usb@1.0::types.Status



$(GEN): $(LOCAL_PATH)/types.hal

	$(transform-generated-source)

LOCAL_GENERATED_SOURCES += $(GEN)



#

# Build IUsb.hal

#

GEN := $(intermediates)/android/hardware/usb/V1_0/IUsb.java

$(GEN): $(HIDL)

$(GEN): PRIVATE_HIDL := $(HIDL)

$(GEN): PRIVATE_DEPS := $(LOCAL_PATH)/IUsb.hal

$(GEN): PRIVATE_DEPS += $(LOCAL_PATH)/IUsbCallback.hal

$(GEN): $(LOCAL_PATH)/IUsbCallback.hal

$(GEN): PRIVATE_DEPS += $(LOCAL_PATH)/types.hal

$(GEN): $(LOCAL_PATH)/types.hal

$(GEN): PRIVATE_OUTPUT_DIR := $(intermediates)

$(GEN): PRIVATE_CUSTOM_TOOL = \

        $(PRIVATE_HIDL) -o $(PRIVATE_OUTPUT_DIR) \

        -Ljava \

        -randroid.hardware:hardware/interfaces \

        -randroid.hidl:system/libhidl/transport \

        android.hardware.usb@1.0::IUsb



$(GEN): $(LOCAL_PATH)/IUsb.hal

	$(transform-generated-source)

LOCAL_GENERATED_SOURCES += $(GEN)



#

# Build IUsbCallback.hal

#

GEN := $(intermediates)/android/hardware/usb/V1_0/IUsbCallback.java

$(GEN): $(HIDL)

$(GEN): PRIVATE_HIDL := $(HIDL)

$(GEN): PRIVATE_DEPS := $(LOCAL_PATH)/IUsbCallback.hal

$(GEN): PRIVATE_DEPS += $(LOCAL_PATH)/types.hal

$(GEN): $(LOCAL_PATH)/types.hal

$(GEN): PRIVATE_OUTPUT_DIR := $(intermediates)

$(GEN): PRIVATE_CUSTOM_TOOL = \

        $(PRIVATE_HIDL) -o $(PRIVATE_OUTPUT_DIR) \

        -Ljava \

        -randroid.hardware:hardware/interfaces \

        -randroid.hidl:system/libhidl/transport \

        android.hardware.usb@1.0::IUsbCallback



$(GEN): $(LOCAL_PATH)/IUsbCallback.hal

	$(transform-generated-source)

LOCAL_GENERATED_SOURCES += $(GEN)

include $(BUILD_JAVA_LIBRARY)





################################################################################



include $(CLEAR_VARS)

LOCAL_MODULE := android.hardware.usb@1.0-java-static

LOCAL_MODULE_CLASS := JAVA_LIBRARIES



intermediates := $(local-generated-sources-dir)



HIDL := $(HOST_OUT_EXECUTABLES)/hidl-gen$(HOST_EXECUTABLE_SUFFIX)



LOCAL_STATIC_JAVA_LIBRARIES := \

    android.hidl.base@1.0-java-static \





#

# Build types.hal (PortDataRole)

#

GEN := $(intermediates)/android/hardware/usb/V1_0/PortDataRole.java

$(GEN): $(HIDL)

$(GEN): PRIVATE_HIDL := $(HIDL)

$(GEN): PRIVATE_DEPS := $(LOCAL_PATH)/types.hal

$(GEN): PRIVATE_OUTPUT_DIR := $(intermediates)

$(GEN): PRIVATE_CUSTOM_TOOL = \

        $(PRIVATE_HIDL) -o $(PRIVATE_OUTPUT_DIR) \

        -Ljava \

        -randroid.hardware:hardware/interfaces \

        -randroid.hidl:system/libhidl/transport \

        android.hardware.usb@1.0::types.PortDataRole



$(GEN): $(LOCAL_PATH)/types.hal

	$(transform-generated-source)

LOCAL_GENERATED_SOURCES += $(GEN)



#

# Build types.hal (PortMode)

#

GEN := $(intermediates)/android/hardware/usb/V1_0/PortMode.java

$(GEN): $(HIDL)

$(GEN): PRIVATE_HIDL := $(HIDL)

$(GEN): PRIVATE_DEPS := $(LOCAL_PATH)/types.hal

$(GEN): PRIVATE_OUTPUT_DIR := $(intermediates)

$(GEN): PRIVATE_CUSTOM_TOOL = \

        $(PRIVATE_HIDL) -o $(PRIVATE_OUTPUT_DIR) \

        -Ljava \

        -randroid.hardware:hardware/interfaces \

        -randroid.hidl:system/libhidl/transport \

        android.hardware.usb@1.0::types.PortMode



$(GEN): $(LOCAL_PATH)/types.hal

	$(transform-generated-source)

LOCAL_GENERATED_SOURCES += $(GEN)



#

# Build types.hal (PortPowerRole)

#

GEN := $(intermediates)/android/hardware/usb/V1_0/PortPowerRole.java

$(GEN): $(HIDL)

$(GEN): PRIVATE_HIDL := $(HIDL)

$(GEN): PRIVATE_DEPS := $(LOCAL_PATH)/types.hal

$(GEN): PRIVATE_OUTPUT_DIR := $(intermediates)

$(GEN): PRIVATE_CUSTOM_TOOL = \

        $(PRIVATE_HIDL) -o $(PRIVATE_OUTPUT_DIR) \

        -Ljava \

        -randroid.hardware:hardware/interfaces \

        -randroid.hidl:system/libhidl/transport \

        android.hardware.usb@1.0::types.PortPowerRole



$(GEN): $(LOCAL_PATH)/types.hal

	$(transform-generated-source)

LOCAL_GENERATED_SOURCES += $(GEN)



#

# Build types.hal (PortRole)

#

GEN := $(intermediates)/android/hardware/usb/V1_0/PortRole.java

$(GEN): $(HIDL)

$(GEN): PRIVATE_HIDL := $(HIDL)

$(GEN): PRIVATE_DEPS := $(LOCAL_PATH)/types.hal

$(GEN): PRIVATE_OUTPUT_DIR := $(intermediates)

$(GEN): PRIVATE_CUSTOM_TOOL = \

        $(PRIVATE_HIDL) -o $(PRIVATE_OUTPUT_DIR) \

        -Ljava \

        -randroid.hardware:hardware/interfaces \

        -randroid.hidl:system/libhidl/transport \

        android.hardware.usb@1.0::types.PortRole



$(GEN): $(LOCAL_PATH)/types.hal

	$(transform-generated-source)

LOCAL_GENERATED_SOURCES += $(GEN)



#

# Build types.hal (PortRoleType)

#

GEN := $(intermediates)/android/hardware/usb/V1_0/PortRoleType.java

$(GEN): $(HIDL)

$(GEN): PRIVATE_HIDL := $(HIDL)

$(GEN): PRIVATE_DEPS := $(LOCAL_PATH)/types.hal

$(GEN): PRIVATE_OUTPUT_DIR := $(intermediates)

$(GEN): PRIVATE_CUSTOM_TOOL = \

        $(PRIVATE_HIDL) -o $(PRIVATE_OUTPUT_DIR) \

        -Ljava \

        -randroid.hardware:hardware/interfaces \

        -randroid.hidl:system/libhidl/transport \

        android.hardware.usb@1.0::types.PortRoleType



$(GEN): $(LOCAL_PATH)/types.hal

	$(transform-generated-source)

LOCAL_GENERATED_SOURCES += $(GEN)



#

# Build types.hal (PortStatus)

#

GEN := $(intermediates)/android/hardware/usb/V1_0/PortStatus.java

$(GEN): $(HIDL)

$(GEN): PRIVATE_HIDL := $(HIDL)

$(GEN): PRIVATE_DEPS := $(LOCAL_PATH)/types.hal

$(GEN): PRIVATE_OUTPUT_DIR := $(intermediates)

$(GEN): PRIVATE_CUSTOM_TOOL = \

        $(PRIVATE_HIDL) -o $(PRIVATE_OUTPUT_DIR) \

        -Ljava \

        -randroid.hardware:hardware/interfaces \

        -randroid.hidl:system/libhidl/transport \

        android.hardware.usb@1.0::types.PortStatus



$(GEN): $(LOCAL_PATH)/types.hal

	$(transform-generated-source)

LOCAL_GENERATED_SOURCES += $(GEN)



#

# Build types.hal (Status)

#

GEN := $(intermediates)/android/hardware/usb/V1_0/Status.java

$(GEN): $(HIDL)

$(GEN): PRIVATE_HIDL := $(HIDL)

$(GEN): PRIVATE_DEPS := $(LOCAL_PATH)/types.hal

$(GEN): PRIVATE_OUTPUT_DIR := $(intermediates)

$(GEN): PRIVATE_CUSTOM_TOOL = \

        $(PRIVATE_HIDL) -o $(PRIVATE_OUTPUT_DIR) \

        -Ljava \

        -randroid.hardware:hardware/interfaces \

        -randroid.hidl:system/libhidl/transport \

        android.hardware.usb@1.0::types.Status



$(GEN): $(LOCAL_PATH)/types.hal

	$(transform-generated-source)

LOCAL_GENERATED_SOURCES += $(GEN)



#

# Build IUsb.hal

#

GEN := $(intermediates)/android/hardware/usb/V1_0/IUsb.java

$(GEN): $(HIDL)

$(GEN): PRIVATE_HIDL := $(HIDL)

$(GEN): PRIVATE_DEPS := $(LOCAL_PATH)/IUsb.hal

$(GEN): PRIVATE_DEPS += $(LOCAL_PATH)/IUsbCallback.hal

$(GEN): $(LOCAL_PATH)/IUsbCallback.hal

$(GEN): PRIVATE_DEPS += $(LOCAL_PATH)/types.hal

$(GEN): $(LOCAL_PATH)/types.hal

$(GEN): PRIVATE_OUTPUT_DIR := $(intermediates)

$(GEN): PRIVATE_CUSTOM_TOOL = \

        $(PRIVATE_HIDL) -o $(PRIVATE_OUTPUT_DIR) \

        -Ljava \

        -randroid.hardware:hardware/interfaces \

        -randroid.hidl:system/libhidl/transport \

        android.hardware.usb@1.0::IUsb



$(GEN): $(LOCAL_PATH)/IUsb.hal

	$(transform-generated-source)

LOCAL_GENERATED_SOURCES += $(GEN)



#

# Build IUsbCallback.hal

#

GEN := $(intermediates)/android/hardware/usb/V1_0/IUsbCallback.java

$(GEN): $(HIDL)

$(GEN): PRIVATE_HIDL := $(HIDL)

$(GEN): PRIVATE_DEPS := $(LOCAL_PATH)/IUsbCallback.hal

$(GEN): PRIVATE_DEPS += $(LOCAL_PATH)/types.hal

$(GEN): $(LOCAL_PATH)/types.hal

$(GEN): PRIVATE_OUTPUT_DIR := $(intermediates)

$(GEN): PRIVATE_CUSTOM_TOOL = \

        $(PRIVATE_HIDL) -o $(PRIVATE_OUTPUT_DIR) \

        -Ljava \

        -randroid.hardware:hardware/interfaces \

        -randroid.hidl:system/libhidl/transport \

        android.hardware.usb@1.0::IUsbCallback



$(GEN): $(LOCAL_PATH)/IUsbCallback.hal

	$(transform-generated-source)

LOCAL_GENERATED_SOURCES += $(GEN)

include $(BUILD_STATIC_JAVA_LIBRARY)





################################################################################



include $(CLEAR_VARS)

LOCAL_MODULE := android.hardware.usb@1.0-java-constants

LOCAL_MODULE_CLASS := JAVA_LIBRARIES



intermediates := $(local-generated-sources-dir)



HIDL := $(HOST_OUT_EXECUTABLES)/hidl-gen$(HOST_EXECUTABLE_SUFFIX)

#

GEN := $(intermediates)/android/hardware/usb/V1_0/Constants.java

$(GEN): $(HIDL)

$(GEN): $(LOCAL_PATH)/types.hal

$(GEN): $(LOCAL_PATH)/IUsb.hal

$(GEN): $(LOCAL_PATH)/IUsbCallback.hal



$(GEN): PRIVATE_HIDL := $(HIDL)

$(GEN): PRIVATE_OUTPUT_DIR := $(intermediates)

$(GEN): PRIVATE_CUSTOM_TOOL = \

        $(PRIVATE_HIDL) -o $(PRIVATE_OUTPUT_DIR) \

        -Ljava-constants \

        -randroid.hardware:hardware/interfaces \

        -randroid.hidl:system/libhidl/transport \

        android.hardware.usb@1.0



$(GEN):

	$(transform-generated-source)

LOCAL_GENERATED_SOURCES += $(GEN)

# Avoid dependency cycle of framework.jar -> this-library -> framework.jar

LOCAL_NO_STANDARD_LIBRARIES := true

LOCAL_JAVA_LIBRARIES := core-oj



include $(BUILD_STATIC_JAVA_LIBRARY)







include $(call all-makefiles-under,$(LOCAL_PATH))

usb/1.0/IUsb.hal

0 → 100644
+57 −0
Original line number Diff line number Diff line 
/*

 * Copyright (C) 2016 The Android Open Source Project

 *

 * Licensed under the Apache License, Version 2.0 (the "License");

 * you may not use this file except in compliance with the License.

 * You may obtain a copy of the License at

 *

 *      http://www.apache.org/licenses/LICENSE-2.0

 *

 * Unless required by applicable law or agreed to in writing, software

 * distributed under the License is distributed on an "AS IS" BASIS,

 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

 * See the License for the specific language governing permissions and

 * limitations under the License.

 */



package android.hardware.usb@1.0;



import IUsbCallback;



interface IUsb {

    /*

     * This function is used to change the port role of a specific port.

     * For example, when PD_SWAP or PR_SWAP is supported.

     * This is function is asynchronous. The status of the role switch

     * will be informed through IUsbCallback object's notifyPortStatusChange

     * method.

     *

     * @param portName name of the port for which the role has to be changed

     * @param role the new port role.

     */

    oneway switchRole(string portName, PortRole role);



    /*

     * This function is used to register a callback function which is

     * called by the HAL whenever there is a change in the port state.

     * i.e. DATA_ROLE, POWER_ROLE or MODE.

     *

     * Also the same callback object would be called to inform the caller

     * of the roleSwitch status.

     *

     * @param callback IUsbCallback object used to convey status to the

     * userspace.

     */

    oneway setCallback(IUsbCallback callback);



    /*

     * This functions is used to request the hal for the current status

     * status of the Type-C ports. This method is async/oneway. The result of the

     * query would be sent through the IUsbCallback object's notifyRoleSwitchStatus

     * to the caller. This api would would let the caller know of the number

     * of type-c ports that are present and their connection status through the

     * PortStatus type.

     */

    oneway queryPortStatus();

};

usb/1.0/IUsbCallback.hal

0 → 100644
+45 −0
Original line number Diff line number Diff line 
/*

 * Copyright (C) 2016 The Android Open Source Project

 *

 * Licensed under the Apache License, Version 2.0 (the "License");

 * you may not use this file except in compliance with the License.

 * You may obtain a copy of the License at

 *

 *      http://www.apache.org/licenses/LICENSE-2.0

 *

 * Unless required by applicable law or agreed to in writing, software

 * distributed under the License is distributed on an "AS IS" BASIS,

 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

 * See the License for the specific language governing permissions and

 * limitations under the License.

 */



package android.hardware.usb@1.0;



/*

 * Callback object used for all the IUsb async methods which expects a result.

 * Caller is expected to register the callback object using setCallback method

 * to receive updates on the PortStatus.

 */

interface IUsbCallback {

    /*

     * Used to convey the current port status to the caller.

     * Called either when PortState changes due to the port partner (or)

     * when caller requested for the PortStatus update through queryPortStatus.

     *

     * @param currentPortStatus vector object of current status of all the

     * typeC ports in the device.

     * @param retval SUCCESS when query was done successfully.

     * ERROR otherwise.

     */

    oneway notifyPortStatusChange(vec<PortStatus> currentPortStatus, Status retval);



    /*

     * Used to notify the result of the switchRole call to the caller.

     *

     * @param portName name of the port for which the roleswap is requested.

     * @param newRole the new role requested by the caller.

     * @param retval SUCCESS if the role switch succeeded. FAILURE otherwise.

     */

    oneway notifyRoleSwitchStatus(string portName, PortRole newRole, Status retval);

};

usb/1.0/types.hal

0 → 100644
+214 −0
Original line number Diff line number Diff line 
/*

 * Copyright (C) 2016 The Android Open Source Project

 *

 * Licensed under the Apache License, Version 2.0 (the "License");

 * you may not use this file except in compliance with the License.

 * You may obtain a copy of the License at

 *

 *      http://www.apache.org/licenses/LICENSE-2.0

 *

 * Unless required by applicable law or agreed to in writing, software

 * distributed under the License is distributed on an "AS IS" BASIS,

 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

 * See the License for the specific language governing permissions and

 * limitations under the License.

 */

package android.hardware.usb@1.0;





enum Status : uint32_t {

    SUCCESS = 0,



    /*

     * error value when the HAL operation fails for reasons not listed here.

     */

    ERROR = 1,



    /*

     * error value returned when input argument is invalid.

     */

    INVALID_ARGUMENT = 2,



    /*

     * error value returned when role string is unrecognized.

     */

    UNRECOGNIZED_ROLE = 3,

};



/*

 * Denotes the Port role type.

 * Passed as an argument for functions used to query or change port roles.

 */

enum PortRoleType : uint32_t {

    /*

     * Denotes the data role of the port.

     * The port can either be a "host" or a "device" for data.

     * This maps to the PortDataRole enum.

     */

    DATA_ROLE = 0,



    /*

     * Denotes the power role of the port.

     * The port can either be a "source" or "sink" for power.

     * This maps to PortPowerRole enum.

     */

    POWER_ROLE = 1,



    /*

     * USB ports can be a pure DFP port which can only act

     * as a host. A UFP port which can only act as a device.

     * Or a dual role ports which can either can as a host or

     * a device. This property is used to mention them.

     */

    MODE = 2,

};



@export

enum PortDataRole : uint32_t {

    /*

     * Indicates that the port does not have a data role.

     * In case of DRP, the current data role of the port is only resolved

     * when the type-c handshake happens.

     */

    NONE = 0,



    /*

     * Indicates that the port is acting as a host for data.

     */

    HOST = 1,



    /*

     * Indicated that the port is acting as a device for data.

     */

    DEVICE = 2,



    NUM_DATA_ROLES = 3,

};



@export

enum PortPowerRole : uint32_t {

    /*

     * Indicates that the port does not have a power role.

     * In case of DRP, the current power role of the port is only resolved

     * when the type-c handshake happens.

     */

    NONE = 0,



    /*

     * Indicates that the port is supplying power to the other port.

     */

    SOURCE = 1,



    /*

     * Indicates that the port is sinking power from the other port.

     */

    SINK = 2,



    NUM_POWER_ROLES = 3,

};



@export

enum PortMode : uint32_t {

    /*

     * Indicates that the port does not have a mode.

     * In case of DRP, the current mode of the port is only resolved

     * when the type-c handshake happens.

     */

    NONE = 0,

    /*

     * Indicates that port can only act as device for data and sink for power.

     */

    UFP = 1,



    /*

     * Indicates the port can only act as host for data and source for power.

     */

    DFP = 2,



    /*

     * Indicates can either act as UFP or DFP at a given point of time.

     */

    DRP = 3,



    NUM_MODES = 4,

};



/*

 * Used as a container to send port role information.

 */

struct PortRole {

    /*

     * Indicates the type of Port Role.

     * Maps to the PortRoleType enum.

     */

    PortRoleType type;



    /*

     * when type is HAL_USB_DATA_ROLE pass values from enum PortDataRole.

     * when type is HAL_USB_POWER_ROLE pass values from enum PortPowerRole.

     * when type is HAL_USB_MODE pass values from enum PortMode.

     */

    uint32_t role;

};



/*

 * Used as the container to report data back to the caller.

 * Represents the current connection status of a single USB port.

 */

struct PortStatus {

     /*

      * Name of the port.

      * Used as the port's id by the caller.

      */

     string portName;



     /*

      * Data role of the port.

      */

     PortDataRole currentDataRole;



     /*

      * Power Role of thte port.

      */

     PortPowerRole currentPowerRole;



     /*

      * Mode in which the port is connected.

      * Can be UFP or DFP.

      */

     PortMode currentMode;



     /*

      * True indicates that the port's mode can

      * be changed. False otherwise.

      */

     bool canChangeMode;



     /*

      * True indicates that the port's data role

      * can be changed. False otherwise.

      * For example, true if Type-C PD PD_SWAP

      * is supported.

      */

     bool canChangeDataRole;



     /*

      * True indicates that the port's power role

      * can be changed. False otherwise.

      * For example, true if Type-C PD PR_SWAP

      * is supported.

      */

     bool canChangePowerRole;



     /*

      * Identifies the type of the local port.

      *

      * UFP - Indicates that port can only act as device for

      *       data and sink for power.

      * DFP - Indicates the port can only act as host for data

      *       and source for power.

      * DRP - Indicates can either act as UFP or DFP at a

      *       given point of time.

      */

      PortMode supportedModes;

};