From patchwork Fri Mar 3 10:14:28 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Neil Armstrong X-Patchwork-Id: 9602465 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 12FF6600CB for ; Fri, 3 Mar 2017 10:14:46 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 0611F285F7 for ; Fri, 3 Mar 2017 10:14:46 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id EF0D628606; Fri, 3 Mar 2017 10:14:45 +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 74A2F285F7 for ; Fri, 3 Mar 2017 10:14:45 +0000 (UTC) Received: from gabe.freedesktop.org (localhost [127.0.0.1]) by gabe.freedesktop.org (Postfix) with ESMTP id BE10F6ECD1; Fri, 3 Mar 2017 10:14:42 +0000 (UTC) X-Original-To: dri-devel@lists.freedesktop.org Delivered-To: dri-devel@lists.freedesktop.org Received: from mail-wr0-x22b.google.com (mail-wr0-x22b.google.com [IPv6:2a00:1450:400c:c0c::22b]) by gabe.freedesktop.org (Postfix) with ESMTPS id 1566C6ECC7 for ; Fri, 3 Mar 2017 10:14:41 +0000 (UTC) Received: by mail-wr0-x22b.google.com with SMTP id u108so70379142wrb.3 for ; Fri, 03 Mar 2017 02:14:41 -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=d1UZbzdeYBYBijjUWMh60ScVZoaHTR4rSgflS1TnVyw=; b=GTGemxSXTbPQXDPgHjRo+U7ZniJJsbd0sHCQqbYrAheVWvM6wj2dtKCh/Wt2iD1r29 NAytQCn6I5Yk86nn33QvSaKOLAn0HDOdFEHEywPGDp7i10qT/pqPy8gWZ99SackOH8fu Pb275XAaCCsJ62Du89/KXxVxUGAMTs6owejMxMyHFTtbV/ub0LQiFITVdHuT++i/7lZJ hCsyrwc+nFHKXn6iTkQuosXpcQ0TSCXA5jm91bPgIon3wGoKe9lvRPRTwazdBUgveOVg yL4M7SDOSrKlPWm3q2+XPPeILK3bhVzFDl7LZEyE04mfGkWqYjP/sdnNzWyBg39Sh6n2 hEcA== 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=mYgZfflXyrcuoVCkTVBC6iAj0SMOd+KbCh+Bg/8J5r7/yPt+CGsNxnR7QRkBcl2keB P6ojQpJFFuzfcNegGYekO011EnfjVJHSpzmnFpZi9zdI8OVhlpBIf1EZxS8EgrFgbNbQ kzCZ+dPKfnirbjrat60rgHLZmGXZLD4TJUfxgc3PbaV6dmzyEFa2gphiAZmSxfoR5+dD ZWRYs0SaMLhCGLHvhK4XWI3tbD891ct3+fToA+pbeqT/OeIm05UcTVYFrGNe05PFAUlF Anp7NQ8gfvMjYtIjjea+QZD+KWF8Icnf7xtJDktMNaOrX2SYtuHdNWduShv6yS/gVHDp H2wg== X-Gm-Message-State: AMke39mOV2jtASQyNT+Owepe3hIsBwSiqC+qI5UwGKTLecnLf0DfTLiBd3DZqsNfn3Az7O79 X-Received: by 10.223.129.230 with SMTP id 93mr1748870wra.41.1488536079698; Fri, 03 Mar 2017 02:14:39 -0800 (PST) Received: from localhost.localdomain ([90.63.244.31]) by smtp.gmail.com with ESMTPSA id c9sm2426562wmf.18.2017.03.03.02.14.38 (version=TLS1_2 cipher=ECDHE-RSA-AES128-SHA bits=128/128); Fri, 03 Mar 2017 02:14:39 -0800 (PST) From: Neil Armstrong To: airlied@linux.ie, daniel.vetter@ffwll.ch Subject: [RFC PATCH 2/2] drm/meson: Add RST to bring together kerneldoc Date: Fri, 3 Mar 2017 11:14:28 +0100 Message-Id: <1488536068-9407-3-git-send-email-narmstrong@baylibre.com> X-Mailer: git-send-email 1.9.1 In-Reply-To: <1488536068-9407-1-git-send-email-narmstrong@baylibre.com> References: <1488536068-9407-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