From patchwork Tue Apr 4 12:15:30 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Neil Armstrong X-Patchwork-Id: 9661501 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 2B9CA60352 for ; Tue, 4 Apr 2017 12:16:27 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 1E7B727CF3 for ; Tue, 4 Apr 2017 12:16:27 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 128A12850E; Tue, 4 Apr 2017 12:16:27 +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 94F3227CF3 for ; Tue, 4 Apr 2017 12:16:26 +0000 (UTC) Received: from gabe.freedesktop.org (localhost [127.0.0.1]) by gabe.freedesktop.org (Postfix) with ESMTP id EF0BA6E5BF; Tue, 4 Apr 2017 12:15:54 +0000 (UTC) X-Original-To: dri-devel@lists.freedesktop.org Delivered-To: dri-devel@lists.freedesktop.org Received: from mail-wr0-x22c.google.com (mail-wr0-x22c.google.com [IPv6:2a00:1450:400c:c0c::22c]) by gabe.freedesktop.org (Postfix) with ESMTPS id 6911C6E5BB for ; Tue, 4 Apr 2017 12:15:52 +0000 (UTC) Received: by mail-wr0-x22c.google.com with SMTP id w11so210515346wrc.3 for ; Tue, 04 Apr 2017 05:15:52 -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=kiQijCw8neXwFQOLDhsON1mCWphl+cQGY96w5h59Nyk=; b=o58k2Jga3QaeEBMxYKxBl+4SgLgCEdLFGkvH6z/frg8k/vA0tW6EnjX/nF9VobOv0h KlWgNGi/bk25nD1qaj4pEbqCkX85xk17q1Oz7BqQxICCRlFanvOMAwuG6CGD7MJRbzKD a4ZcZCGUoFU+FrC6cfkd8t+8y4QlCb/FpwFaKMABuAYLoJDT7kZ2nRAp5BFrVHD970B7 5xEHlftZDFxhczlXnZkh11FsjlY0YjUjYcvQiFUbBRW2WvKSsKPzDsnwW/oUdrMI2SOo kfQSq1rPJ5e3/6br/yVqzAg2Q7bB/Q0jAmGHbhk0iwDPQfHyfDeULZ2yLY3vYfXJFB9f gXtQ== 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=kiQijCw8neXwFQOLDhsON1mCWphl+cQGY96w5h59Nyk=; b=DfuKtrg0H6a07v/nFA2bBY87KOz9BXowXSFRAcGF3ONJ3PtFmslOVwgJ46VQYAL0rf F+Gz1qphBdpow7KIahjX9BRPGvVeGTBOJQoLg1h12DCogSJT8Uypnf30QsWMhZFBo9ce 3MBq/pmcejCI1rZBNoeXst8WvreJzD1U919zQfUqPjAKAPQaF5wkxZUFX5kL1wTWUBJS Z3JRsuARoegBZjbvxkC1Z/qiZ4j3KoI7vUH6ODm6+uBBfTEuRDoP1b/yRi1izDlp+AK5 lcTnlR4I5sTlbcEj1e2ruRNTmYS2HpwVZAKaYJM6wkpOAX7IyNjbRK/RwgrakcJMCeHm KCHQ== X-Gm-Message-State: AFeK/H1a3/y4pVIiuAFphYene45Le2ljPR3fj5v+aBJmGLkZ0XuKUEcJ G5WN1NjoYthiU0p/ X-Received: by 10.28.180.87 with SMTP id d84mr14329670wmf.118.1491308150370; Tue, 04 Apr 2017 05:15:50 -0700 (PDT) Received: from zoidberg.local ([90.63.244.31]) by smtp.gmail.com with ESMTPSA id a66sm250242wrc.58.2017.04.04.05.15.49 (version=TLS1_2 cipher=ECDHE-RSA-AES128-SHA bits=128/128); Tue, 04 Apr 2017 05:15:49 -0700 (PDT) From: Neil Armstrong To: airlied@linux.ie Subject: [PATCH v3 10/11] drm/meson: Add RST to bring together kerneldoc Date: Tue, 4 Apr 2017 14:15:30 +0200 Message-Id: <1491308131-22071-11-git-send-email-narmstrong@baylibre.com> X-Mailer: git-send-email 1.9.1 In-Reply-To: <1491308131-22071-1-git-send-email-narmstrong@baylibre.com> References: <1491308131-22071-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 Acked-by: Daniel Vetter 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