From patchwork Fri Mar 2 13:48:02 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Benoit Parrot X-Patchwork-Id: 10255081 Return-Path: Received: from mail.wl.linuxfoundation.org (pdx-wl-mail.web.codeaurora.org [172.30.200.125]) by pdx-korg-patchwork.web.codeaurora.org (Postfix) with ESMTP id C8832602B5 for ; Fri, 2 Mar 2018 15:57:11 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id B85A328A0D for ; Fri, 2 Mar 2018 15:57:11 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id ACF2628A0F; Fri, 2 Mar 2018 15:57:11 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on pdx-wl-mail.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-4.1 required=2.0 tests=BAYES_00,DKIM_SIGNED, RCVD_IN_DNSWL_MED,T_DKIM_INVALID autolearn=ham version=3.3.1 Received: from gabe.freedesktop.org (gabe.freedesktop.org [131.252.210.177]) (using TLSv1.2 with cipher DHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.wl.linuxfoundation.org (Postfix) with ESMTPS id 4599328A0D for ; Fri, 2 Mar 2018 15:57:11 +0000 (UTC) Received: from gabe.freedesktop.org (localhost [127.0.0.1]) by gabe.freedesktop.org (Postfix) with ESMTP id 43DD36E19D; Fri, 2 Mar 2018 15:57:10 +0000 (UTC) X-Original-To: dri-devel@lists.freedesktop.org Delivered-To: dri-devel@lists.freedesktop.org X-Greylist: delayed 7725 seconds by postgrey-1.36 at gabe; Fri, 02 Mar 2018 15:57:09 UTC Received: from lelnx193.ext.ti.com (lelnx193.ext.ti.com [198.47.27.77]) by gabe.freedesktop.org (Postfix) with ESMTPS id 5274B6E19D for ; Fri, 2 Mar 2018 15:57:09 +0000 (UTC) Received: from dlelxv90.itg.ti.com ([172.17.2.17]) by lelnx193.ext.ti.com (8.15.1/8.15.1) with ESMTP id w22DmJLB021372; Fri, 2 Mar 2018 07:48:19 -0600 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=ti.com; s=ti-com-17Q1; t=1519998499; bh=2N1hZ+d96qDheflknnPWOHUu+0NMcz232MvJSsgrLFw=; h=From:To:CC:Subject:Date:In-Reply-To:References; b=U7xc8QAp1V2Cg0sR3DH7+9kIjnUOXmHObMWD4w0L5uzn3Rccq8VtDAky7V3+0sr2v Izv2kp53cXgmdQZTfVRoJoWdQF09qZwt7cQ7EDpH4lMUfx/NOk0TD/Lf8GLN7M9xzT NN9wxXCDMhsHNbOFUnm49EB8Jvnj/IwqlNxejxnE= Received: from DLEE103.ent.ti.com (dlee103.ent.ti.com [157.170.170.33]) by dlelxv90.itg.ti.com (8.14.3/8.13.8) with ESMTP id w22DmJn6029102; Fri, 2 Mar 2018 07:48:19 -0600 Received: from DLEE113.ent.ti.com (157.170.170.24) by DLEE103.ent.ti.com (157.170.170.33) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256_P256) id 15.1.1261.35; Fri, 2 Mar 2018 07:48:18 -0600 Received: from dlep32.itg.ti.com (157.170.170.100) by DLEE113.ent.ti.com (157.170.170.24) with Microsoft SMTP Server (version=TLS1_0, cipher=TLS_RSA_WITH_AES_256_CBC_SHA) id 15.1.1261.35 via Frontend Transport; Fri, 2 Mar 2018 07:48:18 -0600 Received: from uda0869644a.dhcp.ti.com (ileax41-snat.itg.ti.com [10.172.224.153]) by dlep32.itg.ti.com (8.14.3/8.13.8) with ESMTP id w22DmE5f032677; Fri, 2 Mar 2018 07:48:18 -0600 From: Benoit Parrot To: , Laurent Pinchart , , Rob Herring Subject: [Patch 2/4] dt-bindings: display/ti: Add plane binding to dispc node Date: Fri, 2 Mar 2018 07:48:02 -0600 Message-ID: <20180302134804.3690-3-bparrot@ti.com> X-Mailer: git-send-email 2.9.0 In-Reply-To: <20180302134804.3690-1-bparrot@ti.com> References: <20180302134804.3690-1-bparrot@ti.com> MIME-Version: 1.0 X-EXCLAIMER-MD-CONFIG: e1e8a2fd-e40a-4ac6-ac9b-f7e9cc9ee180 X-BeenThere: dri-devel@lists.freedesktop.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: Direct Rendering Infrastructure - Development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Peter Ujfalusi , Tomi Valkeinen , Jyri Sarha Errors-To: dri-devel-bounces@lists.freedesktop.org Sender: "dri-devel" X-Virus-Scanned: ClamAV using ClamSMTP Add 'plane' child node to generic DISPC node as an optional property. Signed-off-by: Benoit Parrot --- .../devicetree/bindings/display/ti/ti,omap-dss.txt | 63 ++++++++++++++++++++++ 1 file changed, 63 insertions(+) diff --git a/Documentation/devicetree/bindings/display/ti/ti,omap-dss.txt b/Documentation/devicetree/bindings/display/ti/ti,omap-dss.txt index 249e588d7865..cb101525b805 100644 --- a/Documentation/devicetree/bindings/display/ti/ti,omap-dss.txt +++ b/Documentation/devicetree/bindings/display/ti/ti,omap-dss.txt @@ -27,6 +27,34 @@ DISPC Optional properties: - max-memory-bandwidth: Input memory (from main memory to dispc) bandwidth limit in bytes per second +- plane: Child node(s) which defines which logical plane are available to + the system. If at least one plane child node is defined then + only planes defined by these nodes will be available to the system. + Plane nodes must be sequential starting with reg = <0> as DT parsing + will stop on the first missing numbered node. + This means if plane #1 is defined but plane #0 is not then it will + be as if none of the plane nodes were defined. + + Each plane node contains the following properties: + Required properties: + - reg: Used to number the logical plane + - hw-planes: One or two HW plane number(s). + When 2 numbers are present this indicates a virtual plane + composed of two physical planes intended to be used + when the display is larger then the capacity of a + single plane i.e. wider than 2048 pixels. + The first number in the pair will dictate the capabilities + of the virtual plane. This means that for proper + operation the virtual plane should be composed of HW + planes of the same capabilities. + If GFX plane is used in a virtual plane it should be + specified first, otherwise unexpected behavior would + be encountered. + Optional property: + - hw-crtcs: One or more HW crtc number(s). + Describe the list of CRTCs on which this plane is + available. If this node is not present then the + plane will be available on all available CRTCs. Video Ports ----------- @@ -216,3 +244,38 @@ OMAP HDMI --(HDMI)--> TPD12S015 --(HDMI)--> HDMI Connector }; }; }; + +A short example on how to define a virtual plane configuration +to enable wide display support. +Here we define: +- plane#0 to be the HW plane #0 (i.e. GFX plane) + only available on crtc #0 +- plane#1 to be a virtual wide plane composed of HW plane #1 and #2 + (i.e. VID1 & VID2) available on crtc #0 & #1 +- plane#2 to be the HW plane #3 (i.e. VID3 plane) + only available on crtc #0 + +&dss { + dispc@58001000 { + #address-cells = <1>; + #size-cells = <0>; + + plane@0 { + reg = <0>; + hw-planes = <0>; + hw-crtcs = <0>; + }; + + plane@1 { + reg = <1>; + hw-planes = <1 2>; + hw-crtcs = <0 1>; + }; + + plane@2 { + reg = <2>; + hw-planes = <3>; + hw-crtcs = <0>; + }; + }; +};