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

Commit d8229a8e authored by Nathalie Le Clair's avatar Nathalie Le Clair
Browse files

Clarify which HAL (methods) apply to which devices 

Bug: 265906860
Test: make
Change-Id: Icc8df58d4a806d71fc2c073a67bedfd9dd9d3f60
parent 0e9c80d9

tv/README.md

0 → 100644
+8 −0
Original line number Diff line number Diff line 
# TV-related HIDL and AIDL HALs



This directory bundles TV-related HALs in HIDL (legacy) and AIDL.



- The 'tuner' directory contains the Tuner HIDL and AIDL HALs.

- The 'input' directory contains the TV Input HIDL and AIDL HALs.

- The 'cec' directory contains the CEC HIDL HAL.

- The 'hdmi' directory contains the HDMI-related AIDL HALs, which includes the CEC AIDL HAL.

tv/hdmi/README.md

0 → 100644
+11 −0
Original line number Diff line number Diff line 
# HDMI-related AIDL HALs for Android devices



This directory bundles 3 HDMI-related AIDL HALs: HDMI Connection HAL, CEC HAL and eARC HAL.



The HDMI Connection HAL contains general APIs for the HDMI Connection. These methods are required by

the CEC and the eARC implementation. Therefore, devices that implement CEC need to support the HDMI

Connection HAL and the CEC HAL. Devices that implement eARC need to support the HDMI Connection HAL

and the eARC HAL.



Other Android HALs are related to HDMI as well, but not included in this directory for historical

reasons, e.g. Display HAL and TV Input HAL.

tv/hdmi/connection/aidl/android/hardware/tv/hdmi/connection/HdmiPortInfo.aidl

+6 −1
Original line number Diff line number Diff line
@@ -24,11 +24,16 @@ import android.hardware.tv.hdmi.connection.HdmiPortType; 
@VintfStability

parcelable HdmiPortInfo {

    HdmiPortType type;

    int portId; // Input ports should start from 1 which corresponds to HDMI "port 1".

    int portId; // For devices with input ports (e.g. TV Panels), input ports should start from 1

                // which corresponds to HDMI "port 1".



    // In the following, 'supported' refers to having the necessary hardware and firmware on the

    // device to support CEC/ARC/eARC on this port.

    boolean cecSupported;

    boolean arcSupported; // If true, cecSupported has to be true as well. ARC cannot be supported

                          // without CEC support.

    boolean eArcSupported;



    // The physical address of the device connected to this port, valid range is 0x0000 to 0xFFFF

    // (ref Sec 8.7.2 of HDMI 1.4b).

    int physicalAddress;

tv/hdmi/connection/aidl/android/hardware/tv/hdmi/connection/IHdmiConnection.aidl

+11 −0
Original line number Diff line number Diff line
@@ -56,6 +56,11 @@ interface IHdmiConnection { 
     * hotplug signal). When set to {@code HDMI_HPD_STATUS_BIT} the HAL should use the HDP status

     * bit.

     *

     * This is only relevant to TV Panel devices that support eARC TX. While eARC TX is connected,

     * the framework calls this method to set the HPD signal to {@code HDMI_HPD_STATUS_BIT}.

     *

     * For all other device types, this method can be stubbed.

     *

     * @param signal The HPD signal type to use.

     * @param portId id of the port on which the HPD signal should be set.

     *
@@ -70,6 +75,12 @@ interface IHdmiConnection { 
    /**

     * Get the current signal the HAL is using for HPD

     *

     * This is only relevant to TV Panel devices that support eARC TX. While eARC TX is connected,

     * this method returns {@code HDMI_HPD_STATUS_BIT}.

     *

     * For all other device types, this method can be stubbed by always returning

     * {@code HDMI_HPD_PHYSICAL}.

     *

     * @param portId id of the port of which the current HPD signal is queried.

     */

    HpdSignal getHpdSignal(in int portId);

tv/hdmi/earc/aidl/android/hardware/tv/hdmi/earc/IEArc.aidl

+1 −1
Original line number Diff line number Diff line
@@ -20,7 +20,7 @@ import android.hardware.tv.hdmi.earc.IEArcCallback; 
import android.hardware.tv.hdmi.earc.IEArcStatus;



/**

 * eARC HAL interface definition

 * eARC HAL interface definition. This is only relevant to TV Panels that implement eARC TX.

 */

@VintfStability

interface IEArc {