From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-8.7 required=3.0 tests=HEADER_FROM_DIFFERENT_DOMAINS, INCLUDES_PATCH,MAILING_LIST_MULTI,SIGNED_OFF_BY,SPF_HELO_NONE,SPF_PASS, URIBL_BLOCKED,USER_AGENT_GIT autolearn=ham autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 2CB59C43613 for ; Mon, 24 Jun 2019 16:03:42 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.kernel.org (Postfix) with ESMTP id 0ED6220449 for ; Mon, 24 Jun 2019 16:03:42 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1731483AbfFXQDl (ORCPT ); Mon, 24 Jun 2019 12:03:41 -0400 Received: from lb1-smtp-cloud7.xs4all.net ([194.109.24.24]:41047 "EHLO lb1-smtp-cloud7.xs4all.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1729496AbfFXQDk (ORCPT ); Mon, 24 Jun 2019 12:03:40 -0400 Received: from tschai.fritz.box ([46.9.252.75]) by smtp-cloud7.xs4all.net with ESMTPA id fRRKhHRxHF85OfRRShZab5; Mon, 24 Jun 2019 18:03:38 +0200 From: Hans Verkuil To: linux-media@vger.kernel.org Cc: Dariusz Marcinkiewicz , dri-devel@lists.freedesktop.org, Cheng-yi Chiang , Hans Verkuil Subject: [PATCHv8 05/13] cec: document CEC_ADAP_G_CONNECTOR_INFO Date: Mon, 24 Jun 2019 18:03:22 +0200 Message-Id: <20190624160330.38048-6-hverkuil-cisco@xs4all.nl> X-Mailer: git-send-email 2.20.1 In-Reply-To: <20190624160330.38048-1-hverkuil-cisco@xs4all.nl> References: <20190624160330.38048-1-hverkuil-cisco@xs4all.nl> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-CMAE-Envelope: MS4wfJHC8gnzmC6VsiHnhAT8Mnidw5ZU62gn3HZHqKNX7UVaXyuhfnr8nar7qUT3qlGmLsDkHKBOJjxOpQkAxPvSMU3uLSYaB+Wh29+IGNwTHaGSotCleMaH jydz2acYQRgsFtg5uESRnzo2+IhsZuls1iSK2+Qfkk2rRICKaq20ln8sxj5KvqE5TGegRK8uzBLdcF1HlbC6OaX8lMJjgnGzWc0jjfkuWs4X7YDCfmEum+4X EcZCyIsFh8k2xFRLcU5Gc0W61YkPGvB1b8ApD3uhy0omGT08+E7McH1Hf2S5Ig/VzyXS/OrQ4ZvogWElIONKW9fR0hITkbJmUhYwMOL6l1o= Sender: linux-media-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-media@vger.kernel.org Document the new CEC_ADAP_G_CONNECTOR_INFO ioctl. Signed-off-by: Hans Verkuil --- Documentation/media/uapi/cec/cec-funcs.rst | 1 + .../uapi/cec/cec-ioc-adap-g-conn-info.rst | 109 ++++++++++++++++++ 2 files changed, 110 insertions(+) create mode 100644 Documentation/media/uapi/cec/cec-ioc-adap-g-conn-info.rst diff --git a/Documentation/media/uapi/cec/cec-funcs.rst b/Documentation/media/uapi/cec/cec-funcs.rst index 620590b168c9..dc6da9c639a8 100644 --- a/Documentation/media/uapi/cec/cec-funcs.rst +++ b/Documentation/media/uapi/cec/cec-funcs.rst @@ -24,6 +24,7 @@ Function Reference cec-ioc-adap-g-caps cec-ioc-adap-g-log-addrs cec-ioc-adap-g-phys-addr + cec-ioc-adap-g-conn-info cec-ioc-dqevent cec-ioc-g-mode cec-ioc-receive diff --git a/Documentation/media/uapi/cec/cec-ioc-adap-g-conn-info.rst b/Documentation/media/uapi/cec/cec-ioc-adap-g-conn-info.rst new file mode 100644 index 000000000000..87f475d7dfed --- /dev/null +++ b/Documentation/media/uapi/cec/cec-ioc-adap-g-conn-info.rst @@ -0,0 +1,109 @@ +.. SPDX-License-Identifier: GPL-2.0 +.. +.. Copyright 2019 Google LLC +.. +.. This documentation is free software; you can redistribute it and/or +.. modify it under the terms of the GNU General Public License +.. version 2 as published by the Free Software Foundation. +.. +.. This documentation is distributed in the hope that it will be useful, +.. but WITHOUT ANY WARRANTY; without even the implied warranty of +.. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.. GNU General Public License for more details. +.. +.. _CEC_ADAP_G_CONNECTOR_INFO: + +******************************* +ioctl CEC_ADAP_G_CONNECTOR_INFO +******************************* + +Name +==== + +CEC_ADAP_G_CONNECTOR_INFO - Query HDMI connector information + +Synopsis +======== + +.. c:function:: int ioctl( int fd, CEC_ADAP_G_CONNECTOR_INFO, struct cec_connector_info *argp ) + :name: CEC_ADAP_G_CONNECTOR_INFO + +Arguments +========= + +``fd`` + File descriptor returned by :c:func:`open() `. + +``argp`` + + +Description +=========== + +Using this ioctl an application can learn which HDMI connector this CEC +device corresponds to. While calling this ioctl the application should +provide pointer to a cec_connector_info struct which will be populated +by the kernel with the info provided by the adapter's driver. Not all +drivers supply this information. + +.. tabularcolumns:: |p{1.0cm}|p{4.4cm}|p{2.5cm}|p{9.6cm}| + +.. c:type:: cec_connector_info + +.. flat-table:: struct cec_connector_info + :header-rows: 0 + :stub-columns: 0 + :widths: 1 1 1 8 + + * - __u32 + - ``type`` + - The type of connector this adapter is associated with. + * - union + - ``(anonymous)`` + - + * - + - ``struct cec_drm_connector_info`` + - drm + - :ref:`cec-drm-connector-info`. + + +.. tabularcolumns:: |p{4.4cm}|p{2.5cm}|p{10.6cm}| + +.. _connector-type: + +.. flat-table:: Connector types + :header-rows: 0 + :stub-columns: 0 + :widths: 3 1 8 + + * .. _`CEC-CONNECTOR-TYPE-NO-CONNECTOR`: + + - ``CEC_CONNECTOR_TYPE_NO_CONNECTOR`` + - 0 + - No connector is associated with the adapter/the information is not provided by the driver. + * .. _`CEC-CONNECTOR-TYPE-DRM`: + + - ``CEC_CONNECTOR_TYPE_DRM`` + - 1 + - Indicates that a DRM connector is associated with this adapter. Info about the + connector can be found in :ref:`cec-drm-connector-info`. + +.. tabularcolumns:: |p{4.4cm}|p{2.5cm}|p{10.6cm}| + +.. c:type:: cec_drm_connector_info + +.. _cec-drm-connector-info: + +.. flat-table:: struct cec_drm_connector_info + :header-rows: 0 + :stub-columns: 0 + :widths: 3 1 8 + + * .. _`CEC-DRM-CONNECTOR-TYPE-CARD-NO`: + + - __u32 + - ``card_no`` + - DRM card number - the digit from a card's path, e.g. 0 in case of /dev/card0. + * .. _`CEC-DRM-CONNECTOR-TYPE-CONNECTOR_ID`: + + - __u32 -- 2.20.1 From mboxrd@z Thu Jan 1 00:00:00 1970 From: Hans Verkuil Subject: [PATCHv8 05/13] cec: document CEC_ADAP_G_CONNECTOR_INFO Date: Mon, 24 Jun 2019 18:03:22 +0200 Message-ID: <20190624160330.38048-6-hverkuil-cisco@xs4all.nl> References: <20190624160330.38048-1-hverkuil-cisco@xs4all.nl> Mime-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Return-path: Received: from lb2-smtp-cloud7.xs4all.net (lb2-smtp-cloud7.xs4all.net [194.109.24.28]) by gabe.freedesktop.org (Postfix) with ESMTPS id 604D589CD7 for ; Mon, 24 Jun 2019 16:10:47 +0000 (UTC) In-Reply-To: <20190624160330.38048-1-hverkuil-cisco@xs4all.nl> List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dri-devel-bounces@lists.freedesktop.org Sender: "dri-devel" To: linux-media@vger.kernel.org Cc: Hans Verkuil , Dariusz Marcinkiewicz , dri-devel@lists.freedesktop.org, Cheng-yi Chiang List-Id: dri-devel@lists.freedesktop.org RG9jdW1lbnQgdGhlIG5ldyBDRUNfQURBUF9HX0NPTk5FQ1RPUl9JTkZPIGlvY3RsLgoKU2lnbmVk LW9mZi1ieTogSGFucyBWZXJrdWlsIDxodmVya3VpbC1jaXNjb0B4czRhbGwubmw+Ci0tLQogRG9j dW1lbnRhdGlvbi9tZWRpYS91YXBpL2NlYy9jZWMtZnVuY3MucnN0ICAgIHwgICAxICsKIC4uLi91 YXBpL2NlYy9jZWMtaW9jLWFkYXAtZy1jb25uLWluZm8ucnN0ICAgICB8IDEwOSArKysrKysrKysr KysrKysrKysKIDIgZmlsZXMgY2hhbmdlZCwgMTEwIGluc2VydGlvbnMoKykKIGNyZWF0ZSBtb2Rl IDEwMDY0NCBEb2N1bWVudGF0aW9uL21lZGlhL3VhcGkvY2VjL2NlYy1pb2MtYWRhcC1nLWNvbm4t aW5mby5yc3QKCmRpZmYgLS1naXQgYS9Eb2N1bWVudGF0aW9uL21lZGlhL3VhcGkvY2VjL2NlYy1m dW5jcy5yc3QgYi9Eb2N1bWVudGF0aW9uL21lZGlhL3VhcGkvY2VjL2NlYy1mdW5jcy5yc3QKaW5k ZXggNjIwNTkwYjE2OGM5Li5kYzZkYTljNjM5YTggMTAwNjQ0Ci0tLSBhL0RvY3VtZW50YXRpb24v bWVkaWEvdWFwaS9jZWMvY2VjLWZ1bmNzLnJzdAorKysgYi9Eb2N1bWVudGF0aW9uL21lZGlhL3Vh cGkvY2VjL2NlYy1mdW5jcy5yc3QKQEAgLTI0LDYgKzI0LDcgQEAgRnVuY3Rpb24gUmVmZXJlbmNl CiAgICAgY2VjLWlvYy1hZGFwLWctY2FwcwogICAgIGNlYy1pb2MtYWRhcC1nLWxvZy1hZGRycwog ICAgIGNlYy1pb2MtYWRhcC1nLXBoeXMtYWRkcgorICAgIGNlYy1pb2MtYWRhcC1nLWNvbm4taW5m bwogICAgIGNlYy1pb2MtZHFldmVudAogICAgIGNlYy1pb2MtZy1tb2RlCiAgICAgY2VjLWlvYy1y ZWNlaXZlCmRpZmYgLS1naXQgYS9Eb2N1bWVudGF0aW9uL21lZGlhL3VhcGkvY2VjL2NlYy1pb2Mt YWRhcC1nLWNvbm4taW5mby5yc3QgYi9Eb2N1bWVudGF0aW9uL21lZGlhL3VhcGkvY2VjL2NlYy1p b2MtYWRhcC1nLWNvbm4taW5mby5yc3QKbmV3IGZpbGUgbW9kZSAxMDA2NDQKaW5kZXggMDAwMDAw MDAwMDAwLi44N2Y0NzVkN2RmZWQKLS0tIC9kZXYvbnVsbAorKysgYi9Eb2N1bWVudGF0aW9uL21l ZGlhL3VhcGkvY2VjL2NlYy1pb2MtYWRhcC1nLWNvbm4taW5mby5yc3QKQEAgLTAsMCArMSwxMDkg QEAKKy4uIFNQRFgtTGljZW5zZS1JZGVudGlmaWVyOiBHUEwtMi4wCisuLgorLi4gQ29weXJpZ2h0 IDIwMTkgR29vZ2xlIExMQworLi4KKy4uIFRoaXMgZG9jdW1lbnRhdGlvbiBpcyBmcmVlIHNvZnR3 YXJlOyB5b3UgY2FuIHJlZGlzdHJpYnV0ZSBpdCBhbmQvb3IKKy4uIG1vZGlmeSBpdCB1bmRlciB0 aGUgdGVybXMgb2YgdGhlIEdOVSBHZW5lcmFsIFB1YmxpYyBMaWNlbnNlCisuLiB2ZXJzaW9uIDIg YXMgcHVibGlzaGVkIGJ5IHRoZSBGcmVlIFNvZnR3YXJlIEZvdW5kYXRpb24uCisuLgorLi4gVGhp cyBkb2N1bWVudGF0aW9uIGlzIGRpc3RyaWJ1dGVkIGluIHRoZSBob3BlIHRoYXQgaXQgd2lsbCBi ZSB1c2VmdWwsCisuLiBidXQgV0lUSE9VVCBBTlkgV0FSUkFOVFk7IHdpdGhvdXQgZXZlbiB0aGUg aW1wbGllZCB3YXJyYW50eSBvZgorLi4gTUVSQ0hBTlRBQklMSVRZIG9yIEZJVE5FU1MgRk9SIEEg UEFSVElDVUxBUiBQVVJQT1NFLiBTZWUgdGhlCisuLiBHTlUgR2VuZXJhbCBQdWJsaWMgTGljZW5z ZSBmb3IgbW9yZSBkZXRhaWxzLgorLi4KKy4uIF9DRUNfQURBUF9HX0NPTk5FQ1RPUl9JTkZPOgor CisqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqCitpb2N0bCBDRUNfQURBUF9HX0NPTk5F Q1RPUl9JTkZPCisqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqCisKK05hbWUKKz09PT0K KworQ0VDX0FEQVBfR19DT05ORUNUT1JfSU5GTyAtIFF1ZXJ5IEhETUkgY29ubmVjdG9yIGluZm9y bWF0aW9uCisKK1N5bm9wc2lzCis9PT09PT09PQorCisuLiBjOmZ1bmN0aW9uOjogaW50IGlvY3Rs KCBpbnQgZmQsIENFQ19BREFQX0dfQ09OTkVDVE9SX0lORk8sIHN0cnVjdCBjZWNfY29ubmVjdG9y X2luZm8gKmFyZ3AgKQorICAgIDpuYW1lOiBDRUNfQURBUF9HX0NPTk5FQ1RPUl9JTkZPCisKK0Fy Z3VtZW50cworPT09PT09PT09CisKK2BgZmRgYAorICAgIEZpbGUgZGVzY3JpcHRvciByZXR1cm5l ZCBieSA6YzpmdW5jOmBvcGVuKCkgPGNlYy1vcGVuPmAuCisKK2BgYXJncGBgCisKKworRGVzY3Jp cHRpb24KKz09PT09PT09PT09CisKK1VzaW5nIHRoaXMgaW9jdGwgYW4gYXBwbGljYXRpb24gY2Fu IGxlYXJuIHdoaWNoIEhETUkgY29ubmVjdG9yIHRoaXMgQ0VDCitkZXZpY2UgY29ycmVzcG9uZHMg dG8uIFdoaWxlIGNhbGxpbmcgdGhpcyBpb2N0bCB0aGUgYXBwbGljYXRpb24gc2hvdWxkCitwcm92 aWRlIHBvaW50ZXIgdG8gYSBjZWNfY29ubmVjdG9yX2luZm8gc3RydWN0IHdoaWNoIHdpbGwgYmUg cG9wdWxhdGVkCitieSB0aGUga2VybmVsIHdpdGggdGhlIGluZm8gcHJvdmlkZWQgYnkgdGhlIGFk YXB0ZXIncyBkcml2ZXIuIE5vdCBhbGwKK2RyaXZlcnMgc3VwcGx5IHRoaXMgaW5mb3JtYXRpb24u CisKKy4uIHRhYnVsYXJjb2x1bW5zOjogfHB7MS4wY219fHB7NC40Y219fHB7Mi41Y219fHB7OS42 Y219fAorCisuLiBjOnR5cGU6OiBjZWNfY29ubmVjdG9yX2luZm8KKworLi4gZmxhdC10YWJsZTo6 IHN0cnVjdCBjZWNfY29ubmVjdG9yX2luZm8KKyAgICA6aGVhZGVyLXJvd3M6ICAwCisgICAgOnN0 dWItY29sdW1uczogMAorICAgIDp3aWR0aHM6ICAgICAgIDEgMSAxIDgKKworICAgICogLSBfX3Uz MgorICAgICAgLSBgYHR5cGVgYAorICAgICAgLSBUaGUgdHlwZSBvZiBjb25uZWN0b3IgdGhpcyBh ZGFwdGVyIGlzIGFzc29jaWF0ZWQgd2l0aC4KKyAgICAqIC0gdW5pb24KKyAgICAgIC0gYGAoYW5v bnltb3VzKWBgCisgICAgICAtCisgICAgKiAtCisgICAgICAtIGBgc3RydWN0IGNlY19kcm1fY29u bmVjdG9yX2luZm9gYAorICAgICAgLSBkcm0KKyAgICAgIC0gOnJlZjpgY2VjLWRybS1jb25uZWN0 b3ItaW5mb2AuCisKKworLi4gdGFidWxhcmNvbHVtbnM6OiB8cHs0LjRjbX18cHsyLjVjbX18cHsx MC42Y219fAorCisuLiBfY29ubmVjdG9yLXR5cGU6CisKKy4uIGZsYXQtdGFibGU6OiBDb25uZWN0 b3IgdHlwZXMKKyAgICA6aGVhZGVyLXJvd3M6ICAwCisgICAgOnN0dWItY29sdW1uczogMAorICAg IDp3aWR0aHM6ICAgICAgIDMgMSA4CisKKyAgICAqIC4uIF9gQ0VDLUNPTk5FQ1RPUi1UWVBFLU5P LUNPTk5FQ1RPUmA6CisKKyAgICAgIC0gYGBDRUNfQ09OTkVDVE9SX1RZUEVfTk9fQ09OTkVDVE9S YGAKKyAgICAgIC0gMAorICAgICAgLSBObyBjb25uZWN0b3IgaXMgYXNzb2NpYXRlZCB3aXRoIHRo ZSBhZGFwdGVyL3RoZSBpbmZvcm1hdGlvbiBpcyBub3QgcHJvdmlkZWQgYnkgdGhlIGRyaXZlci4K KyAgICAqIC4uIF9gQ0VDLUNPTk5FQ1RPUi1UWVBFLURSTWA6CisKKyAgICAgIC0gYGBDRUNfQ09O TkVDVE9SX1RZUEVfRFJNYGAKKyAgICAgIC0gMQorICAgICAgLSBJbmRpY2F0ZXMgdGhhdCBhIERS TSBjb25uZWN0b3IgaXMgYXNzb2NpYXRlZCB3aXRoIHRoaXMgYWRhcHRlci4gSW5mbyBhYm91dCB0 aGUKKyAgICAgICAgY29ubmVjdG9yIGNhbiBiZSBmb3VuZCBpbiA6cmVmOmBjZWMtZHJtLWNvbm5l Y3Rvci1pbmZvYC4KKworLi4gdGFidWxhcmNvbHVtbnM6OiB8cHs0LjRjbX18cHsyLjVjbX18cHsx MC42Y219fAorCisuLiBjOnR5cGU6OiBjZWNfZHJtX2Nvbm5lY3Rvcl9pbmZvCisKKy4uIF9jZWMt ZHJtLWNvbm5lY3Rvci1pbmZvOgorCisuLiBmbGF0LXRhYmxlOjogc3RydWN0IGNlY19kcm1fY29u bmVjdG9yX2luZm8KKyAgICA6aGVhZGVyLXJvd3M6ICAwCisgICAgOnN0dWItY29sdW1uczogMAor ICAgIDp3aWR0aHM6ICAgICAgIDMgMSA4CisKKyAgICAqIC4uIF9gQ0VDLURSTS1DT05ORUNUT1It VFlQRS1DQVJELU5PYDoKKworICAgICAgLSBfX3UzMgorICAgICAgLSBgYGNhcmRfbm9gYAorICAg ICAgLSBEUk0gY2FyZCBudW1iZXIgLSB0aGUgZGlnaXQgZnJvbSBhIGNhcmQncyBwYXRoLCBlLmcu IDAgaW4gY2FzZSBvZiAvZGV2L2NhcmQwLgorICAgICogLi4gX2BDRUMtRFJNLUNPTk5FQ1RPUi1U WVBFLUNPTk5FQ1RPUl9JRGA6CisKKyAgICAgIC0gX191MzIKLS0gCjIuMjAuMQoKX19fX19fX19f X19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX18KZHJpLWRldmVsIG1haWxpbmcg bGlzdApkcmktZGV2ZWxAbGlzdHMuZnJlZWRlc2t0b3Aub3JnCmh0dHBzOi8vbGlzdHMuZnJlZWRl c2t0b3Aub3JnL21haWxtYW4vbGlzdGluZm8vZHJpLWRldmVs