From patchwork Tue Nov 29 10:47:48 2016 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Neil Armstrong X-Patchwork-Id: 9451457 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 9500860756 for ; Tue, 29 Nov 2016 10:49:35 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 9CC652816B for ; Tue, 29 Nov 2016 10:49:35 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 9186C2811E; Tue, 29 Nov 2016 10:49:35 +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=unavailable version=3.3.1 Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.9]) (using TLSv1.2 with cipher AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by mail.wl.linuxfoundation.org (Postfix) with ESMTPS id 37F5C2816B for ; Tue, 29 Nov 2016 10:49:35 +0000 (UTC) Received: from localhost ([127.0.0.1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.85_2 #1 (Red Hat Linux)) id 1cBfyY-0005Mx-D8; Tue, 29 Nov 2016 10:49:26 +0000 Received: from mail-wj0-x230.google.com ([2a00:1450:400c:c01::230]) by bombadil.infradead.org with esmtps (Exim 4.85_2 #1 (Red Hat Linux)) id 1cBfxY-0004rK-6L for linux-amlogic@lists.infradead.org; Tue, 29 Nov 2016 10:48:31 +0000 Received: by mail-wj0-x230.google.com with SMTP id qp4so141350696wjc.3 for ; Tue, 29 Nov 2016 02:48:03 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=baylibre-com.20150623.gappssmtp.com; s=20150623; h=from:to:cc:subject:date:message-id:in-reply-to:references; bh=KxnBFqwVDem2JHxxZeE7s+M4CUNC3OCMebu9VPxyOhw=; b=bNYsI0q2Djht3Wl07uKw6YJoy3ZLLZOBJhkswXTRGa5QZ5kkqstVIJsth++5EdHBEw 6wfbtvOfs+qpJ6yzYZAuCp3FgwTWB2rN9YJnesR2aKq5s4n7S5/i3o7L9hqZTr6mhlAK lWVUZ4A8sXX2puuNa8JgLitq99FKGCGwDj0NwPUSxtj8BqQBVr8t2HxMA8hMnQb9k/lD ktIL/G90fLcCvlhCWURzSkV57sjHsQB96NP9XsDlNrK9bgH29DKwVF47uppsqWbOCTHy bXUjKQTXlm1l5Lx3OlcQR/ZvBuc0lHfcyGb3UO3Pu+OmjAlJ94zY7BsVIhHtm6XV2JKa QO/Q== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references; bh=KxnBFqwVDem2JHxxZeE7s+M4CUNC3OCMebu9VPxyOhw=; b=VMDBBv+SEYVfSoZqBnc9Rbd024ODSqF1+Br52oNf0828IK3/LD8/gBnRgfA+/A3NYN e+P662kpxL9FRL1x5hC9ntSediHDBbCZfJA4oPVm79M9/csIKf4Q5Gr9ZwubgfhVB2hd uKpPUJJfjs0ac9oJHNK7cl+SxzwlfV1xwCQnb9VZc/ddEhhUgtdKOF29F52a/E8fgCJE DPkyGylYle9ule2TXGyuysIAZKGRtB6FKT5IVSCJKGOG+IhFJZutS7vqYi3RAFgx/bTZ EdYvDRnZi/5Zik+UwnzmVNJp6os+KZq0+Fn4+5HzEkBHtS/Zw5sRUaST+ItE3Uayp2eh 5HRQ== X-Gm-Message-State: AKaTC03jeBzTBEiBvua87/TiXEhkIpQxjvSqEb6IbV0PY1wmxWAEF02uiFGvuYeFP5mNb+kU X-Received: by 10.194.112.170 with SMTP id ir10mr4436974wjb.190.1480416482236; Tue, 29 Nov 2016 02:48:02 -0800 (PST) Received: from localhost.localdomain ([90.63.244.31]) by smtp.gmail.com with ESMTPSA id g197sm2122521wmd.15.2016.11.29.02.48.01 (version=TLS1_2 cipher=ECDHE-RSA-AES128-SHA bits=128/128); Tue, 29 Nov 2016 02:48:01 -0800 (PST) From: Neil Armstrong To: airlied@linux.ie, khilman@baylibre.com, carlo@caione.org Subject: [PATCH 3/4] dt-bindings: display: add Amlogic Meson DRM Bindings Date: Tue, 29 Nov 2016 11:47:48 +0100 Message-Id: <1480416469-9655-4-git-send-email-narmstrong@baylibre.com> X-Mailer: git-send-email 1.9.1 In-Reply-To: <1480416469-9655-1-git-send-email-narmstrong@baylibre.com> References: <1480416469-9655-1-git-send-email-narmstrong@baylibre.com> X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20161129_024824_511406_F6B99218 X-CRM114-Status: GOOD ( 14.09 ) X-BeenThere: linux-amlogic@lists.infradead.org X-Mailman-Version: 2.1.20 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: devicetree@vger.kernel.org, Xing.Xu@amlogic.com, victor.wan@amlogic.com, Neil Armstrong , linux-kernel@vger.kernel.org, dri-devel@lists.freedesktop.org, laurent.pinchart@ideasonboard.com, daniel@ffwll.ch, jerry.cao@amlogic.com, linux-amlogic@lists.infradead.org, linux-arm-kernel@lists.infradead.org MIME-Version: 1.0 Sender: "linux-amlogic" Errors-To: linux-amlogic-bounces+patchwork-linux-amlogic=patchwork.kernel.org@lists.infradead.org X-Virus-Scanned: ClamAV using ClamSMTP Signed-off-by: Neil Armstrong --- .../bindings/display/meson/meson-drm.txt | 134 +++++++++++++++++++++ 1 file changed, 134 insertions(+) create mode 100644 Documentation/devicetree/bindings/display/meson/meson-drm.txt diff --git a/Documentation/devicetree/bindings/display/meson/meson-drm.txt b/Documentation/devicetree/bindings/display/meson/meson-drm.txt new file mode 100644 index 0000000..cf241be --- /dev/null +++ b/Documentation/devicetree/bindings/display/meson/meson-drm.txt @@ -0,0 +1,134 @@ +Amlogic Meson Display Controller +================================ + +The Amlogic Meson Display controller is composed of several components +that are going to be documented below: + +DMC|---------------VPU (Video Processing Unit)----------------|------HHI------| + | vd1 _______ _____________ _________________ | | +D |-------| |----| | | | | HDMI PLL | +D | vd2 | VIU | | Video Post | | Video Encoders |<---|-----VCLK | +R |-------| |----| Processing | | | | | + | osd2 | | | |---| Enci ----------|----|-----VDAC------| +R |-------| CSC |----| Scalers | | Encp ----------|----|----HDMI-TX----| +A | osd1 | | | Blenders | | Encl ----------|----|---------------| +M |-------|______|----|____________| |________________| | | +___|__________________________________________________________|_______________| + + +VIU: Video Input Unit +--------------------- + +The Video Input Unit is in charge of the pixel scanout from the DDR memory. +It fetches the frames addresses, stride and parameters from the "Canvas" memory. +This part is also in charge of the CSC (Colorspace Conversion). +It can handle 2 OSD Planes and 2 Video Planes. + +VPP: Video Post Processing +-------------------------- + +The Video Post Processing is in charge of the scaling and blending of the +various planes into a single pixel stream. +There is a special "pre-blending" used by the video planes with a dedicated +scaler and a "post-blending" to merge with the OSD Planes. +The OSD planes also have a dedicated scaler for one of the OSD. + +VENC: Video Encoders +-------------------- + +The VENC is composed of the multiple pixel encoders : + - ENCI : Interlace Video encoder for CVBS and Interlace HDMI + - ENCP : Progressive Video Encoder for HDMI + - ENCL : LCD LVDS Encoder +The VENC Unit gets a Pixel Clocks (VCLK) from a dedicated HDMI PLL and clock +tree and provides the scanout clock to the VPP and VIU. +The ENCI is connected to a single VDAC for Composite Output. +The ENCI and ENCP are connected to an on-chip HDMI Transceiver. + +Device Tree Bindings: +--------------------- + +VPU: Video Processing Unit +-------------------------- + +Required properties: +- compatible: value should be different for each SoC family as : + - GXBB (S905) : "amlogic,meson-gxbb-vpu" + - GXL (S905X, S905D) : "amlogic,meson-gxl-vpu" + - GXM (S912) : "amlogic,meson-gxm-vpu" + followed by the common "amlogic,meson-gx-vpu" +- reg: base address and size of he following memory-mapped regions : + - vpu + - hhi + - dmc +- reg-names: should contain the names of the previous memory regions +- interrupts: should contain the VENC Vsync interrupt number + +- ports: A ports node with endpoint definitions as defined in + Documentation/devicetree/bindings/media/video-interfaces.txt. The + second port should be the output endpoints for VENC connectors. + +CBVS Output +----------- + +The VENC can output Composite/CVBS output via a dedicated VDAC, usage of such +Composite output is optional. + +Required properties: +- compatible: value should be different for each SoC family as : + - GXBB (S905) : "amlogic,meson-gxbb-cvbs" + - GXL (S905X, S905D) : "amlogic,meson-gxl-cvbs" + - GXM (S912) : "amlogic,meson-gxm-cvbs" + followed by the common "amlogic,meson-gx-cvbs" + +- ports: A ports node with endpoint definitions as defined in + Documentation/devicetree/bindings/media/video-interfaces.txt. The + first port should be the input endpoints, connected ot the VPU node. + +Example: + +venc_cvbs: venc-cvbs { + compatible = "amlogic,meson-gxbb-cvbs"; + status = "okay"; + + ports { + #address-cells = <1>; + #size-cells = <0>; + + enc_cvbs_in: port@0 { + #address-cells = <1>; + #size-cells = <0>; + reg = <0>; + + venc_cvbs_in_vpu: endpoint@0 { + reg = <0>; + remote-endpoint = <&vpu_out_venc_cvbs>; + }; + }; + }; +}; + +vpu: vpu@d0100000 { + compatible = "amlogic,meson-gxbb-vpu"; + reg = <0x0 0xd0100000 0x0 0x100000>, + <0x0 0xc883c000 0x0 0x1000>, + <0x0 0xc8838000 0x0 0x1000>; + reg-names = "base", "hhi", "dmc"; + interrupts = ; + + ports { + #address-cells = <1>; + #size-cells = <0>; + + vpu_out: port@1 { + #address-cells = <1>; + #size-cells = <0>; + reg = <1>; + + vpu_out_venc_cvbs: endpoint@0 { + reg = <0>; + remote-endpoint = <&venc_cvbs_in_vpu>; + }; + }; + }; +};