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: 9636991 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 07275602CC for ; Tue, 21 Mar 2017 15:46:23 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id EEF9928338 for ; Tue, 21 Mar 2017 15:46:22 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id E3D772840E; Tue, 21 Mar 2017 15:46:22 +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=-1.9 required=2.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID autolearn=unavailable version=3.3.1 Received: from bombadil.infradead.org (bombadil.infradead.org [65.50.211.133]) (using TLSv1.2 with cipher AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.wl.linuxfoundation.org (Postfix) with ESMTPS id 6209828338 for ; Tue, 21 Mar 2017 15:46:22 +0000 (UTC) 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=60n+hJtQDr+ujPttH1wsgrOjVWPnA8z1O2FIwv+Kpk8=; b=DCsA9gZPZM2aSZem05vttMug5r ZCO6K3w/7PuJtYg4qYqcNtuITe4NAFH5+q/Uhez/xutMyvRYIqvj1nJBSivsHDBjoEoI3e28c7Oc9 PpGaUJCYQQG8+PGweM3FNmWMY7yeSfc+Va5jTOz5iry5+pWMRg8e6sIlbXghVt/8upXw4lsCndNyd 5b1d/cYfZu+xAJBoD1XbhxXLO+I2kXE4rsWt4qUH4AzoA5JSu49lS1FBvNbVl96amb63Fw6GLVaiw pBVfsNvTp6Hq08PZb5soJCKpmdj3igXqforbK0ZR4P+uoQhaUfUw7G2PS1nDjSyTxHCVv1069rJBT eivZKCyA==; Received: from localhost ([127.0.0.1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.87 #1 (Red Hat Linux)) id 1cqLzJ-00081x-1S; Tue, 21 Mar 2017 15:46:21 +0000 Received: from casper.infradead.org ([2001:770:15f::2]) by bombadil.infradead.org with esmtps (Exim 4.87 #1 (Red Hat Linux)) id 1cqLkF-0005Jw-RM for linux-arm-kernel@bombadil.infradead.org; Tue, 21 Mar 2017 15:30:48 +0000 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=casper.20170209; h=References:In-Reply-To:Message-Id:Date: Subject:Cc:To:From:Sender:Reply-To:MIME-Version:Content-Type: Content-Transfer-Encoding:Content-ID:Content-Description:Resent-Date: Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:List-Id: List-Help:List-Unsubscribe:List-Subscribe:List-Post:List-Owner:List-Archive; bh=d1UZbzdeYBYBijjUWMh60ScVZoaHTR4rSgflS1TnVyw=; b=pu2P2y9Sr8/zEwwUmnxLGPytC nGzZnqIiNWP9b4Ce0ViJDVc6/SvGEgi/ktVD+tYaKUa/CILUcdds0C6TQfUabs/z3PzclCnauDvhC GQ/QHE7+Rr5t+YyOy0NvLKuEUX+2Yvm0a4LeI44eQ2Fe3tWWGLWwAzADVXQK1VaDY7oGtHN9DXksB ZcjWZOiH8gPWJo8IN5dwpx+9f64iC4T67Jpg9h8oV2pEkgHFOIuHGyBK3dVh9JCODvc9+aiQBsNTS NMhPQVvnpC9krrj/Ahb66D7ZD5iNZSvBsrfu1i9JMTkSfpcn2+TeuVADdnfgpVNZRYZO/Z5ubyGUl oDAcwCAsg==; Received: from mail-wm0-x22d.google.com ([2a00:1450:400c:c09::22d]) by casper.infradead.org with esmtps (Exim 4.87 #1 (Red Hat Linux)) id 1cqLg4-0001EZ-Ch for linux-arm-kernel@lists.infradead.org; Tue, 21 Mar 2017 15:26:31 +0000 Received: by mail-wm0-x22d.google.com with SMTP id u132so14785141wmg.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=ixkptu/st+jct1O9jiW6YJ8LLUkd/pufQmcuy3ndNquKTAht1dr80WaFUGhnMqPU77 kEtphCjK4L+u/B7WPaJEyPHbfcTQoJKLcr3BFvCg8dRUcwoidkWaVXc6XEHZZOE771L7 UWz01CR+gD/Cs+BsnJssyiTEJeDFFYaHV3dgu3c1p+3DMb3VpXxRWpFgw+6Fo2M+yZHO cKg/VvYrzs1VoYOm35MjS3BHTDQO7gKsAVGT6KBViRl09p8RYWTX1cKK87h/Pi+x9xre isu4IJ5b1tYmLn/tVHn0Y6ipeZM3ISlj2yns0Z1lQ7qwfFMFJG3dHq7Sq5r+rTj+IRUZ JK6A== X-Gm-Message-State: AFeK/H3MS0Eq1sK/R3bgZR/LyXYAPKFdmoH8ktU3D1ZFMlOvT3m7ynw0cT/O7uBAUTGIs+mH 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> X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20170321_152628_466300_1BF5489D X-CRM114-Status: GOOD ( 13.77 ) X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.21 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: linux-amlogic@lists.infradead.org, linux-kernel@vger.kernel.org, linux-arm-kernel@lists.infradead.org, dri-devel@lists.freedesktop.org, Neil Armstrong MIME-Version: 1.0 Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+patchwork-linux-arm=patchwork.kernel.org@lists.infradead.org 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