From patchwork Mon Jun 1 06:17:37 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Sandor Yu X-Patchwork-Id: 11581405 Return-Path: Received: from mail.kernel.org (pdx-korg-mail-1.web.codeaurora.org [172.30.200.123]) by pdx-korg-patchwork-2.web.codeaurora.org (Postfix) with ESMTP id 5CAFF139A for ; Mon, 1 Jun 2020 06:25:29 +0000 (UTC) Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPS id 39DAD206A4 for ; Mon, 1 Jun 2020 06:25:29 +0000 (UTC) Authentication-Results: mail.kernel.org; dkim=pass (2048-bit key) header.d=lists.infradead.org header.i=@lists.infradead.org header.b="D06YuX7+" DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org 39DAD206A4 Authentication-Results: mail.kernel.org; dmarc=fail (p=none dis=none) header.from=nxp.com Authentication-Results: mail.kernel.org; spf=none smtp.mailfrom=linux-arm-kernel-bounces+patchwork-linux-arm=patchwork.kernel.org@lists.infradead.org DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=bombadil.20170209; h=Sender: Content-Transfer-Encoding:Content-Type:MIME-Version:Cc:List-Subscribe: List-Help:List-Post:List-Archive:List-Unsubscribe:List-Id:References: In-Reply-To:Message-Id:Date:Subject:To:From:Reply-To:Content-ID: Content-Description:Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc :Resent-Message-ID:List-Owner; bh=fapyVE7GnVubHJmBi9RxbbdDKucdc0JseYLXYE/9B+k=; b=D06YuX7+Di4BrUhkJLYTMg4mzp ABODWAiIuQybTpZ+34qZlNFZ23ZXEH6DULrKK/mhV5NNymheGVI50l3WOwwxcSE4Zkx9CdHFv2VUy DWXR0kPDVsiyl8p8ESKz9HdvfpS7+DHjoTMfu6PR8cemCs6ruGRJ52eQMUXCbcWHNmnJjYMMwFAsw oALFLqLqMivxg6txI+J5CXNTyTeu18th2CzIQwhuryQyKXrl4Ip+l6BZIOUpGSGSy4ooIZ1kKhe6o QpT9sNpVEeReVesXGldY1i8d8fkoOFBOCatBwiPx0mls4vbYBuE3eJN2SL1CxoIgtd/ta4lhOhbG+ o82bSRCQ==; Received: from localhost ([127.0.0.1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.92.3 #3 (Red Hat Linux)) id 1jfdsy-0002iS-Hy; Mon, 01 Jun 2020 06:25:24 +0000 Received: from inva021.nxp.com ([92.121.34.21]) by bombadil.infradead.org with esmtps (Exim 4.92.3 #3 (Red Hat Linux)) id 1jfdr5-0007Rz-D7; Mon, 01 Jun 2020 06:23:31 +0000 Received: from inva021.nxp.com (localhost [127.0.0.1]) by inva021.eu-rdc02.nxp.com (Postfix) with ESMTP id CB2BB20047B; Mon, 1 Jun 2020 08:23:25 +0200 (CEST) Received: from invc005.ap-rdc01.nxp.com (invc005.ap-rdc01.nxp.com [165.114.16.14]) by inva021.eu-rdc02.nxp.com (Postfix) with ESMTP id 03B38200480; Mon, 1 Jun 2020 08:23:20 +0200 (CEST) Received: from localhost.localdomain (mega.ap.freescale.net [10.192.208.232]) by invc005.ap-rdc01.nxp.com (Postfix) with ESMTP id 0C01440323; Mon, 1 Jun 2020 14:23:12 +0800 (SGT) From: sandor.yu@nxp.com To: a.hajda@samsung.com, narmstrong@baylibre.com, Laurent.pinchart@ideasonboard.com, jonas@kwiboo.se, jernej.skrabec@siol.net, heiko@sntech.de, hjc@rock-chips.com, Sandor.yu@nxp.com, dkos@cadence.com, dri-devel@lists.freedesktop.org Subject: [PATCH 7/7] dt-bindings: display: Document Cadence MHDP HDMI/DP bindings Date: Mon, 1 Jun 2020 14:17:37 +0800 Message-Id: <9fa979f1099f7c02fd746f25002d8a652253d70f.1590982881.git.Sandor.yu@nxp.com> X-Mailer: git-send-email 2.17.1 In-Reply-To: References: In-Reply-To: References: X-Virus-Scanned: ClamAV using ClamSMTP X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20200531_232327_756932_B34D4533 X-CRM114-Status: GOOD ( 11.20 ) X-Spam-Score: -2.3 (--) X-Spam-Report: SpamAssassin version 3.4.4 on bombadil.infradead.org summary: Content analysis details: (-2.3 points) pts rule name description ---- ---------------------- -------------------------------------------------- -2.3 RCVD_IN_DNSWL_MED RBL: Sender listed at https://www.dnswl.org/, medium trust [92.121.34.21 listed in list.dnswl.org] -0.0 SPF_PASS SPF: sender matches SPF record 0.0 SPF_HELO_NONE SPF: HELO does not publish an SPF Record X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: linux-rockchip@lists.infradead.org, linux-kernel@vger.kernel.org, linux-arm-kernel@lists.infradead.org, linux-imx@nxp.com MIME-Version: 1.0 Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+patchwork-linux-arm=patchwork.kernel.org@lists.infradead.org From: Sandor Yu Document the bindings used for the Cadence MHDP HDMI/DP bridge. Signed-off-by: Sandor Yu --- .../bindings/display/bridge/cdns,mhdp.yaml | 46 +++++++++++++++ .../devicetree/bindings/display/imx/mhdp.yaml | 59 +++++++++++++++++++ 2 files changed, 105 insertions(+) create mode 100644 Documentation/devicetree/bindings/display/bridge/cdns,mhdp.yaml create mode 100644 Documentation/devicetree/bindings/display/imx/mhdp.yaml diff --git a/Documentation/devicetree/bindings/display/bridge/cdns,mhdp.yaml b/Documentation/devicetree/bindings/display/bridge/cdns,mhdp.yaml new file mode 100644 index 000000000000..aa23feba744a --- /dev/null +++ b/Documentation/devicetree/bindings/display/bridge/cdns,mhdp.yaml @@ -0,0 +1,46 @@ +# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/display/bridge/cdns,mhdp.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Cadence MHDP TX Encoder + +maintainers: + - Sandor Yu + +description: | + Cadence MHDP Controller supports one or more of the protocols, + such as HDMI and DisplayPort. + Each protocol requires a different FW binaries. + + This document defines device tree properties for the Cadence MHDP Encoder + (CDNS MHDP TX). It doesn't constitue a device tree binding + specification by itself but is meant to be referenced by platform-specific + device tree bindings. + + When referenced from platform device tree bindings the properties defined in + this document are defined as follows. The platform device tree bindings are + responsible for defining whether each property is required or optional. + +properties: + reg: + maxItems: 1 + description: Memory mapped base address and length of the MHDP TX registers. + + interrupts: + maxItems: 2 + + interrupt-names: + - const: plug_in + description: Hotplug detect interrupter for cable plugin event. + - const: plug_out + description: Hotplug detect interrupter for cable plugout event. + + port: + type: object + description: | + The connectivity of the MHDP TX with the rest of the system is + expressed in using ports as specified in the device graph bindings defined + in Documentation/devicetree/bindings/graph.txt. The numbering of the ports + is platform-specific. diff --git a/Documentation/devicetree/bindings/display/imx/mhdp.yaml b/Documentation/devicetree/bindings/display/imx/mhdp.yaml new file mode 100644 index 000000000000..17850cfd1cb1 --- /dev/null +++ b/Documentation/devicetree/bindings/display/imx/mhdp.yaml @@ -0,0 +1,59 @@ +# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/display/bridge/mhdp.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Cadence MHDP Encoder + +maintainers: + - Sandor Yu + +description: | + The MHDP transmitter is a Cadence HD Display TX controller IP + with a companion PHY IP. + The MHDP supports one or more of the protocols, + such as HDMI(1.4 & 2.0), DisplayPort(1.2). + switching between the two modes (HDMI and DisplayPort) + requires reloading the appropriate FW + + These DT bindings follow the Cadence MHDP TX bindings defined in + Documentation/devicetree/bindings/display/bridge/cdns,mhdp.yaml with the + following device-specific properties. + +Properties: + compatible: + enum: + - nxp,imx8mq-cdns-hdmi + - nxp,imx8mq-cdns-dp + + reg: See cdns,mhdp.yaml. + + interrupts: See cdns,mhdp.yaml. + + interrupt-names: See cdns,mhdp.yaml. + + ports: See cdns,mhdp.yaml. + +Required: + - compatible + - reg + - interrupts + - interrupt-names + - ports + +Example: + - | + mhdp: mhdp@32c00000 { + compatible = "nxp,imx8mq-cdns-hdmi"; + reg = <0x32c00000 0x100000>; + interrupts = , + ; + interrupt-names = "plug_in", "plug_out"; + + ports { + mhdp_in: endpoint { + remote-endpoint = <&dcss_out>; + }; + }; + };