0001 .. SPDX-License-Identifier: GPL-2.0
0002 ..
0003 .. Copyright 2019 Google LLC
0004 ..
0005 .. c:namespace:: CEC
0006
0007 .. _CEC_ADAP_G_CONNECTOR_INFO:
0008
0009 *******************************
0010 ioctl CEC_ADAP_G_CONNECTOR_INFO
0011 *******************************
0012
0013 Name
0014 ====
0015
0016 CEC_ADAP_G_CONNECTOR_INFO - Query HDMI connector information
0017
0018 Synopsis
0019 ========
0020
0021 .. c:macro:: CEC_ADAP_G_CONNECTOR_INFO
0022
0023 ``int ioctl(int fd, CEC_ADAP_G_CONNECTOR_INFO, struct cec_connector_info *argp)``
0024
0025 Arguments
0026 =========
0027
0028 ``fd``
0029 File descriptor returned by :c:func:`open()`.
0030
0031 ``argp``
0032
0033 Description
0034 ===========
0035
0036 Using this ioctl an application can learn which HDMI connector this CEC
0037 device corresponds to. While calling this ioctl the application should
0038 provide a pointer to a cec_connector_info struct which will be populated
0039 by the kernel with the info provided by the adapter's driver. This ioctl
0040 is only available if the ``CEC_CAP_CONNECTOR_INFO`` capability is set.
0041
0042 .. tabularcolumns:: |p{1.0cm}|p{4.4cm}|p{2.5cm}|p{9.2cm}|
0043
0044 .. c:type:: cec_connector_info
0045
0046 .. flat-table:: struct cec_connector_info
0047 :header-rows: 0
0048 :stub-columns: 0
0049 :widths: 1 1 8
0050
0051 * - __u32
0052 - ``type``
0053 - The type of connector this adapter is associated with.
0054 * - union {
0055 - ``(anonymous)``
0056 * - ``struct cec_drm_connector_info``
0057 - drm
0058 - :ref:`cec-drm-connector-info`
0059 * - }
0060 -
0061
0062 .. tabularcolumns:: |p{4.4cm}|p{2.5cm}|p{10.4cm}|
0063
0064 .. _connector-type:
0065
0066 .. flat-table:: Connector types
0067 :header-rows: 0
0068 :stub-columns: 0
0069 :widths: 3 1 8
0070
0071 * .. _`CEC-CONNECTOR-TYPE-NO-CONNECTOR`:
0072
0073 - ``CEC_CONNECTOR_TYPE_NO_CONNECTOR``
0074 - 0
0075 - No connector is associated with the adapter/the information is not
0076 provided by the driver.
0077 * .. _`CEC-CONNECTOR-TYPE-DRM`:
0078
0079 - ``CEC_CONNECTOR_TYPE_DRM``
0080 - 1
0081 - Indicates that a DRM connector is associated with this adapter.
0082 Information about the connector can be found in
0083 :ref:`cec-drm-connector-info`.
0084
0085 .. tabularcolumns:: |p{4.4cm}|p{2.5cm}|p{10.4cm}|
0086
0087 .. c:type:: cec_drm_connector_info
0088
0089 .. _cec-drm-connector-info:
0090
0091 .. flat-table:: struct cec_drm_connector_info
0092 :header-rows: 0
0093 :stub-columns: 0
0094 :widths: 3 1 8
0095
0096 * .. _`CEC-DRM-CONNECTOR-TYPE-CARD-NO`:
0097
0098 - __u32
0099 - ``card_no``
0100 - DRM card number: the number from a card's path, e.g. 0 in case of
0101 /dev/card0.
0102 * .. _`CEC-DRM-CONNECTOR-TYPE-CONNECTOR_ID`:
0103
0104 - __u32
0105 - ``connector_id``
0106 - DRM connector ID.
