^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1) .. SPDX-License-Identifier: GPL-2.0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2) ..
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 3) .. Copyright 2019 Google LLC
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 4) ..
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 5) .. c:namespace:: CEC
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 6)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 7) .. _CEC_ADAP_G_CONNECTOR_INFO:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 8)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 9) *******************************
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 10) ioctl CEC_ADAP_G_CONNECTOR_INFO
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 11) *******************************
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 12)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 13) Name
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 14) ====
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 15)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 16) CEC_ADAP_G_CONNECTOR_INFO - Query HDMI connector information
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 17)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 18) Synopsis
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 19) ========
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 20)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 21) .. c:macro:: CEC_ADAP_G_CONNECTOR_INFO
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 22)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 23) ``int ioctl(int fd, CEC_ADAP_G_CONNECTOR_INFO, struct cec_connector_info *argp)``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 24)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 25) Arguments
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 26) =========
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 27)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 28) ``fd``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 29) File descriptor returned by :c:func:`open()`.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 30)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 31) ``argp``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 32)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 33) Description
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 34) ===========
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 35)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 36) Using this ioctl an application can learn which HDMI connector this CEC
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 37) device corresponds to. While calling this ioctl the application should
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 38) provide a pointer to a cec_connector_info struct which will be populated
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 39) by the kernel with the info provided by the adapter's driver. This ioctl
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 40) is only available if the ``CEC_CAP_CONNECTOR_INFO`` capability is set.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 41)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 42) .. tabularcolumns:: |p{1.0cm}|p{4.4cm}|p{2.5cm}|p{9.6cm}|
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 43)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 44) .. c:type:: cec_connector_info
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 45)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 46) .. flat-table:: struct cec_connector_info
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 47) :header-rows: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 48) :stub-columns: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 49) :widths: 1 1 8
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 50)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 51) * - __u32
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 52) - ``type``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 53) - The type of connector this adapter is associated with.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 54) * - union {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 55) - ``(anonymous)``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 56) * - ``struct cec_drm_connector_info``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 57) - drm
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 58) - :ref:`cec-drm-connector-info`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 59) * - }
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 60) -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 61)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 62) .. tabularcolumns:: |p{4.4cm}|p{2.5cm}|p{10.6cm}|
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 63)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 64) .. _connector-type:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 65)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 66) .. flat-table:: Connector types
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 67) :header-rows: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 68) :stub-columns: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 69) :widths: 3 1 8
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 70)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 71) * .. _`CEC-CONNECTOR-TYPE-NO-CONNECTOR`:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 72)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 73) - ``CEC_CONNECTOR_TYPE_NO_CONNECTOR``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 74) - 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 75) - No connector is associated with the adapter/the information is not
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 76) provided by the driver.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 77) * .. _`CEC-CONNECTOR-TYPE-DRM`:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 78)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 79) - ``CEC_CONNECTOR_TYPE_DRM``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 80) - 1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 81) - Indicates that a DRM connector is associated with this adapter.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 82) Information about the connector can be found in
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 83) :ref:`cec-drm-connector-info`.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 84)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 85) .. tabularcolumns:: |p{4.4cm}|p{2.5cm}|p{10.6cm}|
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 86)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 87) .. c:type:: cec_drm_connector_info
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 88)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 89) .. _cec-drm-connector-info:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 90)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 91) .. flat-table:: struct cec_drm_connector_info
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 92) :header-rows: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 93) :stub-columns: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 94) :widths: 3 1 8
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 95)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 96) * .. _`CEC-DRM-CONNECTOR-TYPE-CARD-NO`:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 97)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 98) - __u32
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 99) - ``card_no``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 100) - DRM card number: the number from a card's path, e.g. 0 in case of
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 101) /dev/card0.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 102) * .. _`CEC-DRM-CONNECTOR-TYPE-CONNECTOR_ID`:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 103)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 104) - __u32
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 105) - ``connector_id``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 106) - DRM connector ID.