From patchwork Thu Oct 11 16:39:41 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: "Kazlauskas, Nicholas" X-Patchwork-Id: 10636997 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 5AB171508 for ; Thu, 11 Oct 2018 16:41:12 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 420AC2BC1B for ; Thu, 11 Oct 2018 16:41:12 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 357C32BC1A; Thu, 11 Oct 2018 16:41:12 +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=BAD_ENC_HEADER,BAYES_00, 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 B64612BC1A for ; Thu, 11 Oct 2018 16:41:11 +0000 (UTC) Received: from gabe.freedesktop.org (localhost [127.0.0.1]) by gabe.freedesktop.org (Postfix) with ESMTP id D899F6E0B0; Thu, 11 Oct 2018 16:41:10 +0000 (UTC) X-Original-To: dri-devel@lists.freedesktop.org Delivered-To: dri-devel@lists.freedesktop.org Received: from NAM01-SN1-obe.outbound.protection.outlook.com (mail-sn1nam01on0046.outbound.protection.outlook.com [104.47.32.46]) by gabe.freedesktop.org (Postfix) with ESMTPS id DFA556E0B0; Thu, 11 Oct 2018 16:41:09 +0000 (UTC) Received: from BN6PR12CA0044.namprd12.prod.outlook.com (2603:10b6:405:70::30) by SN1PR12MB0623.namprd12.prod.outlook.com (2a01:111:e400:c428::17) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.1207.27; Thu, 11 Oct 2018 16:41:07 +0000 Received: from CO1NAM03FT052.eop-NAM03.prod.protection.outlook.com (2a01:111:f400:7e48::204) by BN6PR12CA0044.outlook.office365.com (2603:10b6:405:70::30) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384) id 15.20.1228.23 via Frontend Transport; Thu, 11 Oct 2018 16:41:07 +0000 Received-SPF: None (protection.outlook.com: amd.com does not designate permitted sender hosts) Received: from SATLEXCHOV02.amd.com (165.204.84.17) by CO1NAM03FT052.mail.protection.outlook.com (10.152.81.213) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P384) id 15.20.1228.17 via Frontend Transport; Thu, 11 Oct 2018 16:41:06 +0000 Received: from kazbox.amd.com (10.180.168.240) by SATLEXCHOV02.amd.com (10.181.40.72) with Microsoft SMTP Server id 14.3.389.1; Thu, 11 Oct 2018 11:41:04 -0500 From: Nicholas Kazlauskas To: , Subject: [PATCH v4 3/4] drm: Document variable refresh properties Date: Thu, 11 Oct 2018 12:39:41 -0400 Message-ID: <20181011163942.28267-4-nicholas.kazlauskas@amd.com> X-Mailer: git-send-email 2.17.1 In-Reply-To: <20181011163942.28267-1-nicholas.kazlauskas@amd.com> References: <20181011163942.28267-1-nicholas.kazlauskas@amd.com> MIME-Version: 1.0 X-EOPAttributedMessage: 0 X-MS-Office365-Filtering-HT: Tenant X-Forefront-Antispam-Report: CIP:165.204.84.17; IPV:NLI; CTRY:US; EFV:NLI; SFV:NSPM; SFS:(10009020)(136003)(396003)(346002)(376002)(39860400002)(2980300002)(428003)(199004)(189003)(5660300001)(68736007)(36756003)(575784001)(86362001)(47776003)(104016004)(478600001)(51416003)(53416004)(316002)(77096007)(7696005)(72206003)(1076002)(110136005)(26005)(305945005)(16586007)(106466001)(2906002)(76176011)(105586002)(54906003)(14444005)(97736004)(426003)(126002)(2616005)(336012)(11346002)(476003)(8936002)(81156014)(81166006)(446003)(53936002)(8676002)(186003)(4326008)(48376002)(50466002)(5024004)(6666004)(44832011)(50226002)(486006)(356004); DIR:OUT; SFP:1101; SCL:1; SRVR:SN1PR12MB0623; H:SATLEXCHOV02.amd.com; FPR:; SPF:None; LANG:en; PTR:InfoDomainNonexistent; A:1; MX:1; X-Microsoft-Exchange-Diagnostics: 1; CO1NAM03FT052; 1:7NmAAY8UPAIONNdiCgVdJLi5ZRDLieiBJmKKz76WTx7Kuvs88QH8mI+AqGGN8bC6Gil1VJVA/sAEqXhnYl/kMjInc524FKFfg6fWgH6sM7oC0KMQEhyllH1SsyYXcjW9 X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: c57f067e-91ca-4d4d-6154-08d62f98576d X-Microsoft-Antispam: BCL:0; PCL:0; RULEID:(7020095)(4652040)(8989299)(4534185)(4627221)(201703031133081)(201702281549075)(8990200)(5600074)(711020)(2017052603328)(7153060); SRVR:SN1PR12MB0623; X-Microsoft-Exchange-Diagnostics: 1; SN1PR12MB0623; 3:DoGIBw+YL3LrFK3LD4OnTDmb59F1dEcIGf5Fynk5/mUNTSynYi2BWF2ce8xqAByRlZEsVJgULlD3slI4q0r4GCxTrvlFkCJ6StRQW/hCIl92lrgYnPtTuKA0O+jg4r23TYr3Anx+GQiTd1sPwZj8kj7IGxQOjy+6z/GOtNIGb+qPMNpDIKJ77buSfYflI/hS7a8BW0OYyM/qyz9f9SlBxAUkDQcT9ciRUQ0shZmkZqxD6Or8/cXKpELcPNZihu7JFDSzdTHg2Q9g1HYBV2iSfZLjDHfvEHu/2je50ehAcboecGaJpML+GssE1RnPW5Z38Xnu9xcstA/3/P9nC14fxcSnuB3Zz+FHsj6+U+T9WHE=; 25:+674jdwEJnaVITMZJzS8NXwhy9PRomBG5JVTgl9dunr7Qk/SePLfsPV70KD14EijHSFKcVbTwh3cF9Z2dKecK5P98jduI9PtxfoYLbf2p7Y00kXnJXaX8kQG6EMFE7S6PN7E33tfAZXOTy41pRb6dV0D5bQuPgvpSV52Rova7utaFSfsFtgKcIofBiShLSRX4sOi2rUrxql4KH+GACBNbDalDroIdS+Zf8FueU+M316tgkunuVHQSPdTgN/hC60D8pkiDDHlgoUmCkOUX3csV/VNg3LH9K0n1MeBa8+yb2zoU2J3oml4rRnMWeTDJK2YQgiD1das5OdAA1ay+dvNgw== X-MS-TrafficTypeDiagnostic: SN1PR12MB0623: X-Microsoft-Exchange-Diagnostics: 1; SN1PR12MB0623; 31:Q0XEMQidzmDU87v4FITbTNROsEC+ZIgZFEmIXmFd3PSveg5ATwugceEAeWSW028qkmITpGvFvQCORw60himD7W83u8enkdFgN3bk/tTvwZNAvOTtdk7BqrhuFnNkEKs6UTt4MqQMrfy9VQ8pVwsAXpqyHg1xVaqO4jGAT+ysBcgkhCCZmSCna7TdmNv9caQtZ9oE3ZygX3JMwHWR0bVDx76zVUYCnEASvFfgBikXlFs=; 20:8KqHJ8/cRbSZstEAcOp7fQQcYzuSpBxj3s0ev3as/opTDgIfEb2b1p7BizG3jf0+QADzyGu+fAuiTs5kFeP5HUn4iHtcfVnnssqlfBhhIOeVKkl8x3jdVc6MfCDmP7eZyP7akXCDyzOgQTNvvcEzVBrhNuLlDkdGfZkhouSwB161lxyqz9vH9lkoy5q0wsacXI+SRRoFLf2oGDn68YRGvKO4chDIrTEfUo5tDt6tWAm1/+sjN1Fo8UICekanYOTYApR+MReMSI495U+s8/UCVnmhnpM8JFT0+J+B6It5yhPGIlWCdYbK/2d77Ccr5gMDqkLlsyMYYOsWzxYl3yB3EdpClmgumZ6eFOcv6iV1Z2ZM1nEYpnXgQllqVdgVLtgsRkKgxODbgut3IF2f8WKw+9xwCJ9m+uxEDvN7ZfkBMBi0oQ7OltPA0f5iGemFoNRHGbZ/6sx1H68OV/H236whWsoJMI5VF+J8Ru9RY41cdw7tD5a4OZSaN/vjGMxvqvhL X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:(767451399110); X-MS-Exchange-SenderADCheck: 1 X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(8211001083)(6040522)(2401047)(8121501046)(5005006)(3231355)(944501410)(52105095)(10201501046)(93006095)(93003095)(3002001)(6055026)(149066)(150057)(6041310)(201703131423095)(201702281528075)(20161123555045)(201703061421075)(201703061406153)(20161123560045)(20161123558120)(20161123562045)(20161123564045)(201708071742011)(7699051)(76991055); SRVR:SN1PR12MB0623; BCL:0; PCL:0; RULEID:; SRVR:SN1PR12MB0623; X-Microsoft-Exchange-Diagnostics: 1; SN1PR12MB0623; 4:lybI4iOR/2M7CSTGMZNwyQ3Xf9O8dk4P8XY0z2xh+SmU5CHaVOgQM0eC0wgHN3uCg0+vVofnuJdIkd/f3K26NP9eJRvn1Veroe8VGAuxsYDJI8s7kMBnhzykWvAsF8OMxG13jN9Jmo8Li6vxY79W/Dn1n0zvXN3aF42wylK02yUXU42k10ZLr+Zq+1X8OvN1Wwrnf04lUPDF/OA+VWmp/2utbmNG7xZV2XqYNctJH7aQ1KXYSftEgtZTCgoqOklfZ0aHgaVslkXVkf7ItWyi/ptk1JPEPKEKgIQbx4n2MMDMp26+P2dA70II4dVdxZj/ X-Forefront-PRVS: 08220FA8D6 X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1; SN1PR12MB0623; 23:iycVbwN6GAWYH2kl2XNBEFUSCo8cReIS9Er9FC0Zn?= 2uwYk/vmjBS9YveMTvU5oIXxCmXL4EtEPgQ+jSlvVhgZABWD6Vy46FJQRquoaSEWT72zIhNVzgH+V7jEXF7JGDY2N/DH2Q/Bmw30iJ8XM72hws5GeL11B3SHF1dAvJkWV3cVAOVK1wTSVywojc5kOKJ2Q7eljBxFw7RGrpGalZJVA/iX07qsiexjpInduUcC8H0/Vs74xjOyymZRgc24/lGCkhYtFVgUz+H7peQrne4XNWYqtoKdKaQLPZiDgoknX03SP0LlSpFSpSs/S3YsI8BrkjmDbrud9XCEImS48loF72ITfJJO2qquUV5TY/hQJkVEObMdupvzPA5cjJcRUhe+6PIRsTVnD2kxWnAk/u9U6cRuZcvo4OgeK7gT498G9fvavMkZPA4XJ0pTGG8Y/YYfVzeU5S78ZxCPOYY9dL34TZ5puMJJa4O8aajsfP+rVum6Z21JflO7R4JJ9BxdrqxxuSpOm7+w2j/L9FHOqRd+vHqP87DnmsndId6Ho21vqlBLJnKhQeOlujEjaFs9/L2jjXuON7vizp12gO5hqgVp+3EqBq5VqsEz1CkNmuXBWWGQGdhNeyu58U4iicGD8Dr+lmnCwNGtyJpQ4sOOsWoFf/68cuHrCXoIoFHFKWek9nFWzVd/AH+oj1O41h/DAV/QB7OlDs7ga5nhbDO0LoKVZPQYwTF8Fag2QSNbYVv8mxwSyUrwAADcXVClMafe4TVIdtt6x/J5FKFlgOrkT9kNxdL1dyuqzCc6DFJuWG+N9QVpZR9iRHNZVYqkEEs1AZQqlgUK9v/7ly/SZTWgKVBf/Yss+uixlIMibK2n+N1g4LQ/pZ5HSGCtG40whU+KmuiH0JgdrPQqM2dGlo4zNQHbmG9yfW6SSeSsvW7mkEtsUt3r6rKes6ebf5qsGNVuS3TNrlwzNAwyR6jRv4A12bG4UUyyD+sGEfqvwO2PJgsLkK2a3n/zojMqs/4kw3k8kzfqognEAtadQTqo5vkv7O8lEP/y1P9XLs8utqpAerIvIKvZONua59MJ+vitDvtIp6EksOhMDfhoQozyfZuBbsRg9L9yDhCEYpwjWld+OribaWKQmKuLeTS23WVojNE8M3OdKGIkDgitcid8L6mo2LobhVjIBO/Dx81lxcl5btMmwLNKgyyjcGw4LDaal5vO4yxof832afKYERSwMtRm/Jkd8etNTW4HGm02R7Y0zmcgww= X-Microsoft-Antispam-Message-Info: nDJ6Nu7spBqrgqOyVbDe5uC6zJekz+z5+bZHzXYUXUo4HJPGF2sq0FCrTse4vSeH+qbyZA0u//s1CmqvOB7linUM7cJ0/DQHUL+iinwr3jnzo8skB6jX3GZ6LAUbFXeO4vZvpAPjDkKrl3vInx93MFDUYnhQXHC1XqZoXTu2/I09y4C4QzUd0lTD2VER1KbyEmdbrWNFmjG9in10xHdhBjmDIyNdWr99uKzLWY7IV2/SKJgaL+UkisnDk0JIkRK7qq9QyL4WEQB1b9QpSggJKCK06458UlzQFLBXDXuHRwGZv7D5muYvnUi8bP6Hw/FrkjmRv0ObDuKftW+0Vbps9RAxt1eUvX9XE6uvSfFCSwE= X-Microsoft-Exchange-Diagnostics: 1; SN1PR12MB0623; 6:Rs7ljX5USGgPnrFs1pNXAEZeU7NiQ2aybYEZX5FCS93L8amK2R/26n2L2MIak3bSLDuy18ivujYBAnrSMcYBYeVMhh9P6x5Cm9TuYWdfdWOKEw+C3l4/lMCrlb8ZCGBFmcvecuedKfixN5Pm61+CB0ZBzKJ6gA9BQbN49V5mMtqPdzBfzdPrDe4rar5YREu2lUaayd1A4J7sqPfALc4X4ZliUCuGF10F8mx7XS9fb7fHrLMfpDG8XIgtERikC3UWnSxt8NFJtC6OEJRQ3WffSeHfW1/oN+IB3UIvYsoM3EcM31bfl/MtCt61MH0SGxJj+Y8rwb3xT4lw+3W/6qsetAyNdWOZlrXnb3/JBWfGSSTuS/F2CNqezw5qcOxIfSPWiSvrJFGDc3Ldq/ZwUjm/IN0NyKAr9T9Q0CvK+aFODMXMxmNNxHGxcvS8qR5lD+f1KfpTuUxNav+kkokCCW5Zkw==; 5:e6aFLF3qX45/mUpTf5qmWyRRblDrxiM/4vqOUiI5eum86sjGWP7sjOED4ZDaOoRtw3NHN2F7aD+79hrTyUtoARcdpN4mMW7dKjfjDfuJHGVKikAl8DB7KIdCuTCgeqfx0ewkz7Xe1YuOPGz/HftqdCUeJg8mZJ46SZJYslnDtZI=; 7:GJF8Mh0xTHtHSZ6S4dX+gOX+m2k+DVashed4OpgU5CUQaidx3t4vsvuVckXc7INrq4/w7ENDtOJCmUzO1J9YAaGjW/jZQ5jxePrcJu6RIpuEqQc1J6/67JqoOXcXh1HZJM+Jacw5ZXs+DDJvlf1SmE0kD1eMcWYAkIXWl6Gw7ouYTSnJTrR21K2oxoG3Y4BmEGevFmz6ihORSi8QZ169Iy1x1pFuGUBzONnBagNNFms/I/STM8rI18C9tgbYAKwh SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-Microsoft-Exchange-Diagnostics: 1; SN1PR12MB0623; 20:h2pbWGv6jYcdGp2MMeKBIxS8at3bQy5qaJxwkq/8Nyw+rIyM6rHdIF70Xr2Jy/qwNMp8rdg2xzPEXb4TN0E3FsynJyu2YvmkOndceT3+YMOwWxYAahswc9qIXYkEldHcp62MHQEVZFlVXOXZatIOfefWcKfrRngOR5tEILwdzuhsZJkwK8IbPgaJcaV3aaPckakc1xahzU2Mpjjx4mfP2bAwEkOsfyohiLcEwxxMXGxI4fbNcMRqO2v8xT27m014 X-OriginatorOrg: amd.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 11 Oct 2018 16:41:06.4543 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: c57f067e-91ca-4d4d-6154-08d62f98576d X-MS-Exchange-CrossTenant-Id: 3dd8961f-e488-4e60-8e11-a82d994e183d X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=3dd8961f-e488-4e60-8e11-a82d994e183d; Ip=[165.204.84.17]; Helo=[SATLEXCHOV02.amd.com] X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: SN1PR12MB0623 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: daniel.vetter@ffwll.ch, michel@daenzer.net, Nicholas Kazlauskas , manasi.d.navare@intel.com, Alexander.Deucher@amd.com, Marek.Olsak@amd.com Errors-To: dri-devel-bounces@lists.freedesktop.org Sender: "dri-devel" X-Virus-Scanned: ClamAV using ClamSMTP These include the drm_connector 'vrr_capable' and the drm_crtc 'vrr_enabled' properties. Signed-off-by: Nicholas Kazlauskas --- Documentation/gpu/drm-kms.rst | 7 +++++++ drivers/gpu/drm/drm_connector.c | 22 ++++++++++++++++++++++ 2 files changed, 29 insertions(+) diff --git a/Documentation/gpu/drm-kms.rst b/Documentation/gpu/drm-kms.rst index 4b1501b4835b..8da2a178cf85 100644 --- a/Documentation/gpu/drm-kms.rst +++ b/Documentation/gpu/drm-kms.rst @@ -575,6 +575,13 @@ Explicit Fencing Properties .. kernel-doc:: drivers/gpu/drm/drm_atomic_uapi.c :doc: explicit fencing properties + +Variable Refresh Properties +--------------------------- + +.. kernel-doc:: drivers/gpu/drm/drm_connector.c + :doc: Variable refresh properties + Existing KMS Properties ----------------------- diff --git a/drivers/gpu/drm/drm_connector.c b/drivers/gpu/drm/drm_connector.c index f0deeb7298d0..2a12853ca917 100644 --- a/drivers/gpu/drm/drm_connector.c +++ b/drivers/gpu/drm/drm_connector.c @@ -1254,6 +1254,28 @@ int drm_mode_create_scaling_mode_property(struct drm_device *dev) } EXPORT_SYMBOL(drm_mode_create_scaling_mode_property); +/** + * DOC: Variable refresh properties + * + * Variable refresh rate control is supported via properties on the + * &drm_connector and &drm_crtc objects. + * + * "vrr_capable": + * Optional &drm_connector boolean property that drivers should attach + * with drm_connector_attach_vrr_capable_property() on connectors that + * could support variable refresh rates. Drivers should update the + * property value by calling drm_connector_set_vrr_capable_property(). + * + * Absence of the property should indicate absence of support. + * + * "vrr_enabled": + * Default &drm_crtc boolean property that notifies the driver that the + * variable refresh rate adjustment should be enabled for the CRTC. + * + * Support for variable refresh rate will depend on the "vrr_capable" + * property exposed on the &drm_connector object. + */ + /** * drm_connector_attach_vrr_capable_property - creates the * vrr_capable property