From patchwork Tue Mar 21 15:25:49 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Neil Armstrong X-Patchwork-Id: 9636887 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 34421602D6 for ; Tue, 21 Mar 2017 15:26:53 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 2A2F82840E for ; Tue, 21 Mar 2017 15:26:53 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 1EF602841F; Tue, 21 Mar 2017 15:26:53 +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 C7D152840E for ; Tue, 21 Mar 2017 15:26:52 +0000 (UTC) Received: from gabe.freedesktop.org (localhost [127.0.0.1]) by gabe.freedesktop.org (Postfix) with ESMTP id 6E19489A83; Tue, 21 Mar 2017 15:26:13 +0000 (UTC) X-Original-To: dri-devel@lists.freedesktop.org Delivered-To: dri-devel@lists.freedesktop.org Received: from mail-wm0-x229.google.com (mail-wm0-x229.google.com [IPv6:2a00:1450:400c:c09::229]) by gabe.freedesktop.org (Postfix) with ESMTPS id 7AA8F8994A for ; Tue, 21 Mar 2017 15:26:08 +0000 (UTC) Received: by mail-wm0-x229.google.com with SMTP id n11so15205722wma.0 for ; Tue, 21 Mar 2017 08:26:08 -0700 (PDT) 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=d1UZbzdeYBYBijjUWMh60ScVZoaHTR4rSgflS1TnVyw=; b=pX/UuARqPoTEcbJX+EnbCizMzPFQ15z4b3SdoqesTROGdaCjA1O4ZsD5eTii9lrybw V2l86NE7YWY1EdmkkaBVviDHX6o9erNAMdZx8lLAYfTRd2HRMISsc/PQugNzrLm8k9/n Z9NROcOCAmHlRJrErmU+xcKoD3qpvR3BvAU5TUn8jAb4egGLH8o3t636SrkbBlgrWq1j J3E4HFANB8NuYpuzm5hqTvoYIGItYh8ae8j/orcgGtOWyxjSgl1RYG1NXwshi2+NAUPb EbXv8h9ABmt4CA6GL1c2bJvUw5Zwcwt5Z0W8Gx0w+2UxdsS0BJHfsQ6QWImUfWGezqZP vpqw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references; bh=d1UZbzdeYBYBijjUWMh60ScVZoaHTR4rSgflS1TnVyw=; b=Y/wLNIZyvLGOAzpoDS5VVMada3mrnACTLCtC7WD8B7DJi7/dx2fL1D2PFpws5BiOue kjlTdBT8KZgtiWyri5lTCLflMtx1/Zuu7aps8W1NoTlBey+bhCo/x0QiLWU4WpmUIDeP jCzeonOo8d6n4IL8GoRoMzltl4Fq1fRpGV8Ld8kLqOo1OdIlhbvhh5mAhU/8o486Njv5 9wycqhf85zSltbUAdoUMKQuw/mFc795US7yggLAHmCNz6fkFSaQuCnmAoFoGldhdDRK2 CLP4ROBe3Shhc6jgKLo5FJ6kvEVZCiumER0v1Gnz11+8dS5+NXxgvpWQpuYzu3vuov3y b7RA== X-Gm-Message-State: AFeK/H0hgPTK+BDGm+oBhk6xFXae08TQVT8i+t+DyW4r3pVyweCSb8fYAqZfR0d8O3UF6prQ X-Received: by 10.28.224.69 with SMTP id x66mr3340571wmg.21.1490109966992; Tue, 21 Mar 2017 08:26:06 -0700 (PDT) Received: from localhost.localdomain ([90.63.244.31]) by smtp.gmail.com with ESMTPSA id b13sm18088890wmf.6.2017.03.21.08.26.06 (version=TLS1_2 cipher=ECDHE-RSA-AES128-SHA bits=128/128); Tue, 21 Mar 2017 08:26:06 -0700 (PDT) From: Neil Armstrong To: airlied@linux.ie Subject: [PATCH v2 12/13] drm/meson: Add RST to bring together kerneldoc Date: Tue, 21 Mar 2017 16:25:49 +0100 Message-Id: <1490109950-21421-13-git-send-email-narmstrong@baylibre.com> X-Mailer: git-send-email 1.9.1 In-Reply-To: <1490109950-21421-1-git-send-email-narmstrong@baylibre.com> References: <1490109950-21421-1-git-send-email-narmstrong@baylibre.com> Cc: linux-amlogic@lists.infradead.org, linux-kernel@vger.kernel.org, linux-arm-kernel@lists.infradead.org, dri-devel@lists.freedesktop.org, Neil Armstrong X-BeenThere: dri-devel@lists.freedesktop.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: Direct Rendering Infrastructure - Development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , MIME-Version: 1.0 Errors-To: dri-devel-bounces@lists.freedesktop.org Sender: "dri-devel" X-Virus-Scanned: ClamAV using ClamSMTP Signed-off-by: Neil Armstrong --- Documentation/gpu/index.rst | 1 + Documentation/gpu/meson.rst | 61 +++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 62 insertions(+) create mode 100644 Documentation/gpu/meson.rst diff --git a/Documentation/gpu/index.rst b/Documentation/gpu/index.rst index e998ee0..7eceb97 100644 --- a/Documentation/gpu/index.rst +++ b/Documentation/gpu/index.rst @@ -11,6 +11,7 @@ Linux GPU Driver Developer's Guide drm-kms-helpers drm-uapi i915 + meson tinydrm vc4 vga-switcheroo diff --git a/Documentation/gpu/meson.rst b/Documentation/gpu/meson.rst new file mode 100644 index 0000000..479f6f5 --- /dev/null +++ b/Documentation/gpu/meson.rst @@ -0,0 +1,61 @@ +============================================= +drm/meson AmLogic Meson Video Processing Unit +============================================= + +.. kernel-doc:: drivers/gpu/drm/meson/meson_drv.c + :doc: Video Processing Unit + +Video Processing Unit +===================== + +The Amlogic Meson Display controller is composed of several components +that are going to be documented below: + +.. code:: + + 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 |-------|______|----|____________| |________________| | | + ___|__________________________________________________________|_______________| + +Video Input Unit +================ + +.. kernel-doc:: drivers/gpu/drm/meson/meson_viu.c + :doc: Video Input Unit + +Video Post Processing +===================== + +.. kernel-doc:: drivers/gpu/drm/meson/meson_vpp.c + :doc: Video Post Processing + +Video Encoder +============= + +.. kernel-doc:: drivers/gpu/drm/meson/meson_venc.c + :doc: Video Encoder + +Video Canvas Management +======================= + +.. kernel-doc:: drivers/gpu/drm/meson/meson_canvas.c + :doc: Canvas + +Video Clocks +============ + +.. kernel-doc:: drivers/gpu/drm/meson/meson_vclk.c + :doc: Video Clocks + +HDMI Video Output +================= + +.. kernel-doc:: drivers/gpu/drm/meson/meson_dw_hdmi.c + :doc: HDMI Output