From patchwork Fri Sep 7 17:41:36 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Haneen Mohammed X-Patchwork-Id: 10593637 Return-Path: Received: from mail.wl.linuxfoundation.org (pdx-wl-mail.web.codeaurora.org [172.30.200.125]) by pdx-korg-patchwork-2.web.codeaurora.org (Postfix) with ESMTP id DC105921 for ; Mon, 10 Sep 2018 07:10:56 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id C703428C0B for ; Mon, 10 Sep 2018 07:10:56 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id BB0D428C1A; Mon, 10 Sep 2018 07:10:56 +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=-5.2 required=2.0 tests=BAYES_00,DKIM_ADSP_CUSTOM_MED, FREEMAIL_FROM,MAILING_LIST_MULTI,RCVD_IN_DNSWL_MED 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 6B65028C0B for ; Mon, 10 Sep 2018 07:10:56 +0000 (UTC) Received: from gabe.freedesktop.org (localhost [127.0.0.1]) by gabe.freedesktop.org (Postfix) with ESMTP id E5B0E6E243; Mon, 10 Sep 2018 07:09:25 +0000 (UTC) X-Original-To: dri-devel@lists.freedesktop.org Delivered-To: dri-devel@lists.freedesktop.org Received: from mail-qk1-x743.google.com (mail-qk1-x743.google.com [IPv6:2607:f8b0:4864:20::743]) by gabe.freedesktop.org (Postfix) with ESMTPS id 065306E0C3 for ; Fri, 7 Sep 2018 17:41:40 +0000 (UTC) Received: by mail-qk1-x743.google.com with SMTP id d131-v6so10164196qke.11 for ; Fri, 07 Sep 2018 10:41:39 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:date:from:to:cc:subject:message-id:mime-version :content-disposition:user-agent; bh=Y2xLjTM3tGUg67NJj3T6K4A/uWgXqdT/NPRwv3UNO9Q=; b=SXzHfBgXjhHIZJ+jgAkZ8C0YXPOO0cSueb4Y04R6B0kRSMTwMy0bKkjzarZUBBSFNr a/cLRTw1T9Od0ojbojeoX+kRZsrBAlYujkM6FbyVX/6a82KY+2+u54TAgMNEzyoSD1IB ICoc/7I5izOKCYH/ipdbQ5+sEyN83Njo3+pmKE1j5qcJ9iOqS4F0DMp2jDvwQQMME2i9 2kuLm+hDDOO0DxpR33eELv4WEeb+/vEwZ/VKeV1rN2Thot5hVKIRI8vS8C0J670LGWJ3 s4MXSal0hwxou/fGczlPqVB9GUHL6/TXAMdHe3exERj2xiUrlO91756Y+ZGXnJjphvjz VXwQ== X-Gm-Message-State: APzg51AaUvYuFU3EH6uYSQsJeGf8pPBzM41LFMbewH4UQYiMQa6G5n0w vtdW5txCb9uW/l6C9NKQwSwHmkbR X-Google-Smtp-Source: ANB0VdZ6RVom2sCkObGioWMGjXQV3UBYI1JM+2mng5wWKOxjqZg/x/G2x+E2gBAcYtAIhJD8D1m8sQ== X-Received: by 2002:a37:b286:: with SMTP id b128-v6mr6779811qkf.158.1536342098782; Fri, 07 Sep 2018 10:41:38 -0700 (PDT) Received: from haneenDRM (dyn-160-39-8-144.dyn.columbia.edu. [160.39.8.144]) by smtp.gmail.com with ESMTPSA id a4-v6sm4894237qtn.26.2018.09.07.10.41.37 (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Fri, 07 Sep 2018 10:41:38 -0700 (PDT) Date: Fri, 7 Sep 2018 20:41:36 +0300 From: Haneen Mohammed To: dri-devel@lists.freedesktop.org Subject: [PATCH] drm/vkms: Add kerneldoc entry Message-ID: <20180907174136.GA2648@haneenDRM> MIME-Version: 1.0 Content-Disposition: inline User-Agent: Mutt/1.9.4 (2018-02-28) X-Mailman-Approved-At: Mon, 10 Sep 2018 07:09:17 +0000 X-BeenThere: dri-devel@lists.freedesktop.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: Direct Rendering Infrastructure - Development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: seanpaul@chromium.org, rodrigosiqueiramelo@gmail.com Errors-To: dri-devel-bounces@lists.freedesktop.org Sender: "dri-devel" X-Virus-Scanned: ClamAV using ClamSMTP Add an initial kerneldoc entry for vkms with a todo list. Signed-off-by: Haneen Mohammed --- Documentation/gpu/drivers.rst | 1 + Documentation/gpu/todo.rst | 12 ------------ Documentation/gpu/vkms.rst | 21 +++++++++++++++++++++ drivers/gpu/drm/vkms/vkms_drv.c | 9 +++++++++ 4 files changed, 31 insertions(+), 12 deletions(-) create mode 100644 Documentation/gpu/vkms.rst diff --git a/Documentation/gpu/drivers.rst b/Documentation/gpu/drivers.rst index 65be325bf282..7d2d3875ff1a 100644 --- a/Documentation/gpu/drivers.rst +++ b/Documentation/gpu/drivers.rst @@ -13,6 +13,7 @@ GPU Driver Documentation tve200 v3d vc4 + vkms bridge/dw-hdmi xen-front diff --git a/Documentation/gpu/todo.rst b/Documentation/gpu/todo.rst index a7c150d6b63f..f8dfa603e89f 100644 --- a/Documentation/gpu/todo.rst +++ b/Documentation/gpu/todo.rst @@ -398,18 +398,6 @@ the non-i915 specific modeset tests. Contact: Daniel Vetter -Create a virtual KMS driver for testing (vkms) ----------------------------------------------- - -With all the latest helpers it should be fairly simple to create a virtual KMS -driver useful for testing, or for running X or similar on headless machines -(to be able to still use the GPU). This would be similar to vgem, but aimed at -the modeset side. - -Once the basics are there there's tons of possibilities to extend it. - -Contact: Daniel Vetter - Driver Specific =============== diff --git a/Documentation/gpu/vkms.rst b/Documentation/gpu/vkms.rst new file mode 100644 index 000000000000..58bce5f4ec0a --- /dev/null +++ b/Documentation/gpu/vkms.rst @@ -0,0 +1,21 @@ +========================================== + drm/vkms Virtual Kernel Modesetting +========================================== + +.. kernel-doc:: drivers/gpu/drm/vkms/vkms_drv.c + :doc: vkms (Virtual Kernel Modesetting) + +TODO +==== + +CRC API +------- + +- Optimize CRC computation ``compute_crc()`` and plane blending ``blend()`` + +- Use the alpha value to blend vaddr_src with vaddr_dst instead of + overwriting it in ``blend()``. + +- Add igt test to check cleared alpha value for XRGB plane format. + +- Add igt test to check extreme alpha values i.e. fully opaque and fully transparent (intermediate values are affected by hw-specific rounding modes). diff --git a/drivers/gpu/drm/vkms/vkms_drv.c b/drivers/gpu/drm/vkms/vkms_drv.c index 7ce9a76fb940..73cd11845973 100644 --- a/drivers/gpu/drm/vkms/vkms_drv.c +++ b/drivers/gpu/drm/vkms/vkms_drv.c @@ -5,6 +5,15 @@ * (at your option) any later version. */ +/** + * DOC: vkms (Virtual Kernel Modesetting) + * + * vkms is a software-only model of a kms driver that is useful for testing, + * or for running X (or similar) on headless machines and be able to still + * use the GPU. vkms aims to enable a virtual display without the need for + * a hardware display capability. + */ + #include #include #include