From patchwork Fri Jun 9 13:44:27 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Geert Uytterhoeven X-Patchwork-Id: 105645 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a59:994d:0:b0:3d9:f83d:47d9 with SMTP id k13csp962022vqr; Fri, 9 Jun 2023 06:51:34 -0700 (PDT) X-Google-Smtp-Source: ACHHUZ7206Wq5StubvRD+10JeLCB8hlCqQqCNIRjMGT8Wvu56+R12zJMXiILEIH71Eoq9IE85Z2q X-Received: by 2002:a92:cbd2:0:b0:338:18f1:db72 with SMTP id s18-20020a92cbd2000000b0033818f1db72mr1588404ilq.29.1686318694180; Fri, 09 Jun 2023 06:51:34 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1686318694; cv=none; d=google.com; s=arc-20160816; b=aSsQngQ7s/aHpaS0fQSG3OPWk3UYmLNU6Xh37sHTVJM59ep+MEAn91dmVEMtryNNwx XOvMzyTkyOSU5ePJnIEo+LAjr+Y8ZL3uxviO4AqMXrd5ml91prMRtYyQE9hnpOnUNNFm +OvesGw/DaTGwhSS01+yKeB+mWtv3zysVpmtuBpu531HLStYAHwWbJ/Qrj/Jm2NkT7Rw 9oFGO9CSCrMdU+dXhNLlE8GbsxACQ87RTwEiuKH78XTcoeNDd6Le+ZaeIvbrHkYRFIgv j6XIRUdiVoqDvqv5Ye4NFLSoleWsua14tSZ91O8gchtUg5CN5YxilnGW8VtTgrHk9BIX w7dg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from; bh=qLsSk7kh5zHgSeuoiARQKdV3jmuU4exT+q/UC8Qr2wU=; b=wPliYpo4UhpikaAK6IKgqiwBZQF/tayL4WAiMk4WGRs/EdSTGKc0LbFJFTIF1O1m8l IHNfhpi+PlfwsI6XYXcSHjnalMI/bxThWnFq1YbNQXsBdU5deyqt0FmrymaWMSG1i7+s xKES/NtfspYkLuTx5lHdPVqbQkMpk5LJrmMRwEB8DlGPkCI99PnJDzwtfr8O4tpAofNQ XYd0Y7CC6Q0x5DNjLx+W8SGX66zApUX4HqXQNblFBVX8Wid6jsKXpKQekVEuSN93dj8G hn0gK+hMvxB8qYYEGP/lPe1bTvZ8WsLCgIqsUGyEdPWu4yZOCEl1Ii2jJQPxubOTD1B+ Abmg== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id b5-20020a63eb45000000b0053b8c98d14bsi2622380pgk.859.2023.06.09.06.51.19; Fri, 09 Jun 2023 06:51:34 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20; Authentication-Results: mx.google.com; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S241336AbjFINo6 (ORCPT + 99 others); Fri, 9 Jun 2023 09:44:58 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:54772 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S239848AbjFINoq (ORCPT ); Fri, 9 Jun 2023 09:44:46 -0400 Received: from michel.telenet-ops.be (michel.telenet-ops.be [IPv6:2a02:1800:110:4::f00:18]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id C5BB735A9 for ; Fri, 9 Jun 2023 06:44:43 -0700 (PDT) Received: from ramsan.of.borg ([IPv6:2a02:1810:ac12:ed30:a1e2:1b31:cba3:390d]) by michel.telenet-ops.be with bizsmtp id 71kZ2A00512zQ4r061kZpM; Fri, 09 Jun 2023 15:44:42 +0200 Received: from rox.of.borg ([192.168.97.57]) by ramsan.of.borg with esmtp (Exim 4.95) (envelope-from ) id 1q7cPS-008La3-2T; Fri, 09 Jun 2023 15:44:33 +0200 Received: from geert by rox.of.borg with local (Exim 4.95) (envelope-from ) id 1q7cPp-00GCTQ-3L; Fri, 09 Jun 2023 15:44:33 +0200 From: Geert Uytterhoeven To: Maarten Lankhorst , Maxime Ripard , Thomas Zimmermann , David Airlie , Daniel Vetter , Jonathan Corbet , Jyri Sarha , Tomi Valkeinen , Laurent Pinchart , Bagas Sanjaya Cc: dri-devel@lists.freedesktop.org, linux-doc@vger.kernel.org, linux-renesas-soc@vger.kernel.org, linux-kernel@vger.kernel.org, Geert Uytterhoeven , Javier Martinez Canillas Subject: [PATCH v2 1/4] drm/todo: Add atomic modesetting references Date: Fri, 9 Jun 2023 15:44:27 +0200 Message-Id: X-Mailer: git-send-email 2.34.1 In-Reply-To: References: MIME-Version: 1.0 X-Spam-Status: No, score=-2.4 required=5.0 tests=BAYES_00, HEADER_FROM_DIFFERENT_DOMAINS,RCVD_IN_DNSWL_LOW,SPF_HELO_NONE,SPF_NONE, T_SCC_BODY_TEXT_LINE,URIBL_BLOCKED autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on lindbergh.monkeyblade.net Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-getmail-retrieved-from-mailbox: =?utf-8?q?INBOX?= X-GMAIL-THRID: =?utf-8?q?1768233311217151627?= X-GMAIL-MSGID: =?utf-8?q?1768233311217151627?= The section about converting existing KMS drivers to atomic modesetting mentions the existence of a conversion guide, but does not reference it. While the guide is old and rusty, it still contains useful information, so add a link to it. Also link to the LWN.net articles that give an overview about the atomic mode setting design. While at it, remove the reference to unconverted virtual HW drivers, as they've been converted. Signed-off-by: Geert Uytterhoeven Reviewed-by: Javier Martinez Canillas Reviewed-by: Laurent Pinchart --- v2: - Add Reviewed-by, - Drop double space after full stop, - Use footnotes for references, - Remore reference to unconverted virtual HW drivers. --- Documentation/gpu/todo.rst | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/Documentation/gpu/todo.rst b/Documentation/gpu/todo.rst index 68bdafa0284f55f6..6c328613c049fc1d 100644 --- a/Documentation/gpu/todo.rst +++ b/Documentation/gpu/todo.rst @@ -49,14 +49,18 @@ converted over. Modern compositors like Wayland or Surfaceflinger on Android really want an atomic modeset interface, so this is all about the bright future. -There is a conversion guide for atomic and all you need is a GPU for a -non-converted driver (again virtual HW drivers for KVM are still all -suitable). +There is a conversion guide for atomic [1]_ and all you need is a GPU for a +non-converted driver. The "Atomic mode setting design overview" series [2]_ +[3]_ at LWN.net can also be helpful. As part of this drivers also need to convert to universal plane (which means exposing primary & cursor as proper plane objects). But that's much easier to do by directly using the new atomic helper driver callbacks. + .. [1] https://blog.ffwll.ch/2014/11/atomic-modeset-support-for-kms-drivers.html + .. [2] https://lwn.net/Articles/653071/ + .. [3] https://lwn.net/Articles/653466/ + Contact: Daniel Vetter, respective driver maintainers Level: Advanced