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