From patchwork Fri Oct 5 20:39:48 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: "Kazlauskas, Nicholas" X-Patchwork-Id: 10628715 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 7341A184E for ; Fri, 5 Oct 2018 20:40:22 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 6441029A05 for ; Fri, 5 Oct 2018 20:40:22 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 58BF429A0C; Fri, 5 Oct 2018 20:40: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=-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 0A4B82999A for ; Fri, 5 Oct 2018 20:40:21 +0000 (UTC) Received: from gabe.freedesktop.org (localhost [127.0.0.1]) by gabe.freedesktop.org (Postfix) with ESMTP id ED9BA6E8EB; Fri, 5 Oct 2018 20:40:20 +0000 (UTC) X-Original-To: dri-devel@lists.freedesktop.org Delivered-To: dri-devel@lists.freedesktop.org Received: from NAM05-CO1-obe.outbound.protection.outlook.com (mail-co1nam05on0603.outbound.protection.outlook.com [IPv6:2a01:111:f400:fe50::603]) by gabe.freedesktop.org (Postfix) with ESMTPS id A23F16E8EB; Fri, 5 Oct 2018 20:40:19 +0000 (UTC) Received: from DM3PR12CA0049.namprd12.prod.outlook.com (2603:10b6:0:56::17) by DM3PR12MB0746.namprd12.prod.outlook.com (2a01:111:e400:5984::24) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.1185.25; Fri, 5 Oct 2018 20:40:17 +0000 Received: from DM3NAM03FT046.eop-NAM03.prod.protection.outlook.com (2a01:111:f400:7e49::206) by DM3PR12CA0049.outlook.office365.com (2603:10b6:0:56::17) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384) id 15.20.1207.21 via Frontend Transport; Fri, 5 Oct 2018 20:40:17 +0000 Received-SPF: None (protection.outlook.com: amd.com does not designate permitted sender hosts) Received: from SATLEXCHOV01.amd.com (165.204.84.17) by DM3NAM03FT046.mail.protection.outlook.com (10.152.83.87) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P384) id 15.20.1207.19 via Frontend Transport; Fri, 5 Oct 2018 20:40:16 +0000 Received: from kazbox.amd.com (10.180.168.240) by SATLEXCHOV01.amd.com (10.181.40.71) with Microsoft SMTP Server id 14.3.389.1; Fri, 5 Oct 2018 15:40:16 -0500 From: Nicholas Kazlauskas To: , Subject: [PATCH v3 3/4] drm: Document variable refresh properties Date: Fri, 5 Oct 2018 16:39:48 -0400 Message-ID: <20181005203949.6289-4-nicholas.kazlauskas@amd.com> X-Mailer: git-send-email 2.17.1 In-Reply-To: <20181005203949.6289-1-nicholas.kazlauskas@amd.com> References: <20181005203949.6289-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)(39850400004)(396003)(346002)(136003)(376002)(2980300002)(428003)(189003)(199004)(5024004)(105586002)(50466002)(305945005)(47776003)(81166006)(50226002)(8936002)(8676002)(316002)(81156014)(2906002)(356003)(72206003)(478600001)(68736007)(106466001)(36756003)(5660300001)(53416004)(97736004)(51416003)(7696005)(44832011)(77096007)(486006)(4326008)(53936002)(26005)(336012)(1076002)(104016004)(14444005)(86362001)(2616005)(16586007)(110136005)(54906003)(48376002)(446003)(126002)(186003)(426003)(476003)(6666003)(76176011)(11346002); DIR:OUT; SFP:1101; SCL:1; SRVR:DM3PR12MB0746; H:SATLEXCHOV01.amd.com; FPR:; SPF:None; LANG:en; PTR:InfoDomainNonexistent; MX:1; A:1; X-Microsoft-Exchange-Diagnostics: 1; DM3NAM03FT046; 1:DG2pjhYKA4t++d1Y8dNjaIOKzHueq5oUZbXMwOqJaHNLaYNQOCBsOVNgJZ3hS4+1CwKczHeu4VsJvqtrCBNeC8yWKpjT73s7Ypc3aR6Pa73DD1jg8uVkNA8kbOtPjhg4 X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 8e8a86b3-7d27-4953-294f-08d62b02c266 X-Microsoft-Antispam: BCL:0; PCL:0; RULEID:(7020095)(4652040)(8989299)(4534185)(4627221)(201703031133081)(201702281549075)(8990200)(5600074)(711020)(2017052603328)(7153060); SRVR:DM3PR12MB0746; X-Microsoft-Exchange-Diagnostics: 1; DM3PR12MB0746; 3:Mo6egc1L0bM35aPqDV+bF1YMz7jnXEIovRL0nPReJgXsBOUMApR2TfwpOdOJo+t2woKLkwgniDFbWgNanZHjDlQiTUlzF7MeV4c1Fe6btwWUK7DEo5vg9dRXmKNtZ0ahVTKSYLS4wVCWXOPhQN+OhAsydcCI9LzB5x4ctsOZBND6ncRFvlDAhxWh9Hp1pRSYMmwPA8yIJW76cFUYdIbUCF++C0kaOWfLogEIBv22iF08o0T7DK477TwJIMTS8/C7/udcDdNtrKu99X51f2BAsoNirdLhMS3D64Fu5NrJ0DgSLqc9fhn1wch3m4p5TpTacI9sv7YdQ2NKbnNgGynFd1CdT1uy3B1sCD0UxMgNjaM=; 25:skXas87qNe4TrmQ3dgo0VSqq9grC+FC0pDlOAdPoQ+gDP140g8rGjrtDO82BRYFkvvR5zLzXt1BiNuXuAUi/LyVSePfwgzDTrcdJrYbZsBh3YXpF/J8f9ofXJn8zuG+65lVMKSUw7nScZMg8pTTQS9d/ovV11VwCnonziVpgVxg7lv/hoIrWoWAehQ09R8l63zXAhCVkENgLGoTOf6VQzanOVZB3r5YIyC7nQHMqrTeHtTy+6OXA4oPt0IHyf/UOI0P4dvxUavhJ+4WkeAg3eEUWwbBDFYLgtj7bNXtp0qp5H69T0U5jadCHNUG+B/G4gvftTl5q5FCMh/A9rOzF8Q== X-MS-TrafficTypeDiagnostic: DM3PR12MB0746: X-Microsoft-Exchange-Diagnostics: 1; DM3PR12MB0746; 31:TNnVWI5ufUitn4Sylj1+rP6Y2Rahhq/EA2WKkuDqyvJbs6WheQ5xcABonjmqWM04gxyZoloyQJ3ffnan8eXpB9//favDXksCcaElSThndOjX4WdnaYSsVf+y/jzEDOArU1LvjBAdWXmdLYv/gq+qsO3/Ot2n350Yl6FmjYnYM8eGQFdlIcp0lb0Drq240zQLn5tPTNQQIkNgDYvMpgiV+Ld4aAWDvkwgPbAPKBZeRXg=; 20:DlwM0Qe7kCmtjwdEYxbQGzs6k+a7YxxuL8Xr8LsZShMnMouNWFtQK5GRKlzYwhJPuE4VYfQg0/18bQj9H7QCJDPFarqS5RH4WqJ8krkmkA9jlUw0fPhT0sDRVFXp0JSr9vgQzcwmEW6LlRaP92ClZCAfTAXrt4sVILVoIRJ+jy99HSqiCXBqMp32+xyRMiZ2AEenT3kLN1z3KDmcXtWY4ehpvJb+wrIY0Sid0lEHzdGpPI9fjQ4wpFNak3WdZisP/aQFautsd+rxir3Uo9Q76IH9xZc6Xt8dD8McF9kjxtzIurgffc0dplg6mqJLmatowwdVPNj8yK3hoyG5mtzLA2XodiG7+Vf8kDi/VY/tz2xtcZ0Uo7VpvwAwMjMO2eN14avCsOqxfYwjnfuuHKZ63eZ8QAXu2r8wd4rfpVeYOyx8mgBixv2zGEW2L4y/KGly8/OQelzukBLLqEJ8I6AKrkpXZ7BVXJhq7ei2raDPIDoxEUTAWXsv/bg1kLte36Zz 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)(5005006)(8121501046)(93006095)(93003095)(10201501046)(3231355)(944501410)(52105095)(3002001)(6055026)(149066)(150057)(6041310)(20161123558120)(201703131423095)(201702281528075)(20161123555045)(201703061421075)(201703061406153)(20161123562045)(20161123564045)(20161123560045)(201708071742011)(7699051); SRVR:DM3PR12MB0746; BCL:0; PCL:0; RULEID:; SRVR:DM3PR12MB0746; X-Microsoft-Exchange-Diagnostics: 1; DM3PR12MB0746; 4:uz3Kb0pyAC7WYgIzIqZWyShB2GMLrwIJ7mbmV1PfUm4yYbMN518XU/BKwABXffKuw/Ca7KCABnphZXWyK39Q0lfa41l/Y6qXjoUHTWaX9rNGDtHYDatB46cr6ipcjd/91Q+9jwh2zsmhRY0H/JxENPEkb748WbKzro99b6HDqONlGXAzk8TuKclCMzCoUhofU7gY1FTy2GjKt65Sj6C1UBxuoYi1Mlc8ah5ESZXIHqOvROCjEu2ZDupuU6Tlh6yWM4gPwTqHopwn87y1JR88/ofqUbO+nEMsmQOm8edbqak846AMCPZ66q1IhfJE8ML+ X-Forefront-PRVS: 0816F1D86E X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1; DM3PR12MB0746; 23:moOHflAC6mFS09KhijqAMTr6A6RKNnZ2oP4v0OcdU?= sTSNqIuJ7b321rd/DrZeHQ2gc7AYGlV8bgf/HsMeI1J2OFHH8ooVP+gX+lDfHv5LIE70lxqW39xc80XlcK7DHn3lDzxGt4O/Z/nEjUmaSTt8l9BNqkTACKRF0WoL4qgz238LwyGR+RQp9x6RXud8lK8pTQOYR6C1Hj87FCKaz2JFt6IHtZBMgkwRqVDWCVK221AJjzO/QV4Ke2NVL4p0CFk+GK7Z8YKf1M87YTaKHURvmdEH3SAF52jDdqKdwA//+Cr4I1x+X4tMckvG1OfjnqRBJJPXxdLM+mkv//zno+zDP++V4wjBuJE4eEuHtGPx1Djwu2jegrdRV2fvBuOHEsZxE93SDbRjL99Ra40MYkgrGYMiS8cbw+22YFvsaKUjlsOfTNvNMKXSVpkKmmJvldBklTHRJcZw1RSu6fze5fPiAPYYT0L915b7ULyhEwXO68nh8G9xRC9jrA5iH7QSQBaSlcIe7k9H2jyVi4TmskB/cz/gnH6Y4dt7DmCOD7bWUoRz2uEyIQyQB9z5AQL2/fJ4XBMgTQzsLpeCuhvYSbpKTrzh/QBeC7QnT1moy7ekLp0DbxhW7hqnSDNeb0Ryf1hq9vzd7EWOLuxqRkDFhtXyiQjJyT9hm8CnOootjHy0QEE6eARDwiWsd3/W/Zr1LM++RkfyHsc81SCG0sthE0iDpO/xUvqa/3RWvnEeV4JkjieS3xibjAXXLEyAaupoFZsCqJ0tUxvAWeREAAixXYt671TXxYwNkID0Y4ilKzg082B/npQ6I40/xcF7NaYEUb51xvL5ZQh695Pk0d5OwYIJKRCKKpmVCFppsEESzhTJCsaURzgsdynWod5QZ0V/lQ1SaU1SA2KMjgSWKV87apxgYxiOKnkPyMrL/Dfw2LQv8BvowxSaN875jpaWXMvNFvQyWbTHLSUQxxAOPrEzfd9tJMF02slcpJ8PL1siE/l6iF6UAjV/p1qtrsZgQj/D63shs/8b94GntG3YHBXSxGT6WL+slBsUYA9b/PrjbV0tjrKSRjf/kLVp1Jd+1eO0vd7hdcyMBu18MfBGJyaS2OvHGotOED/lu2yeONjaIfkODSEE8i4HYPJvUAZQ+7mGQwKErRNT/pOWO/QPrjT/ef58CsNlk/idLANkDRV/uiIi+n4G3gdTAFMJhDJodjsN9PyyLh0nZKgVNbzCk7gkGINow== X-Microsoft-Antispam-Message-Info: x1wV4imRhlzUsDMPBn1ww8o6VuQfZFIkr0E5YeQBw8dVyKV+eb43zDDFZ9RUON+efAz33bjHzqoQoKlYGLaHT6bO/6gnAFcY+2AdXgV5xEhPYbdp4k3MU3deI2xtd/Yl5+RWWT9XzclML/u/hIQlS08TCAL9ttITHsZg915cWQE2oXnDjKSVoDqZNtFuRMpbJgII6xn4qdxUEfikj/i3PCdnL2pH3KCKb3+DWwf+VW3jQLaAHZxn8YlprKhPHboyhi78UdGEV4HtUTGB31Q4PVGxB6d7Kvre7JvkUcKZ2EvXg95YXmJdrIB4NOwNywmQcKHGMSHmOFqoNk6+blRfsTmsV/N+RmYOYxfCpKm6dGI= X-Microsoft-Exchange-Diagnostics: 1; DM3PR12MB0746; 6:4gHMZZLbx1LQ59P05lsuUvxFjpBUotfDiStUdUzZRuaNxkmc4cPrSrrz3lM9qXNafDr1+jGYidmMjbMUtOsqWeZZOfgYC0H/Bc9F3fb8YfxZMFYgzPKSsfrSartc7oG0QUnOXsXY7BJmDKwpSleAGzn0AnK1sHUv9KDyYmq2nVtN7anFxCaU2OLqW7Gs6PRcOnLG08sItyIs0cPkfMxI5dywZvQLj7GCE91UayKbcew6HdZe7H3oD5swGPoJWIJy9fN5T9HcAiEf5Zwpf3x7LbsdQsAolpctdPpjCu7b3kkN3/pZPxaBWxtGqnctERLtp1qMz57kLIUHaqWnkvWNHVo5HjUlxZTjaXMx/Xnftie79nAgd0KtrEe7dZSXi9QPo2L0UdX3aBcICDrTWCyt8v2sNnNAkggCYtPxxvYzhh/tx6UxHdmWH3+jUHcYKBkCpSkL0QtaEoUpVq0B1jXnTA==; 5:akEJZMR/IMYbal8LbldYUMbwCCGqQ4l4n1VrBiaVmGKfyOHpuE49XpZQKQZrgd6c6JV2BDLBfYNN6n066FOF9p1xK2pQyJsGtBnxoJSw6POBBwq1v7+tFT9CGlOXKP21Xg2OTI24cgGZmKLS5twpzRAZ36ov5lkXDrGwoacdGu8=; 7:8r7iJ1/PPD/Pgt+Wu565Jw+cBw3mOtCfpJ7WALnDKTfvOmAol//EWbTjOwI5/hqFirbJ7SZsEkT7B70HEJnvo6CEKdRLirXwJjcsYDoMP3RLWZPzB9tzr0uBw540CrX/pb63U2N2JRkILWmpzz5q2QCF6zA5r8zMapvQNgvN2BbD0ygpaokMFMQlufNkcaZ2H1eeCy9IqsYeIpAqq1DG02zapnOtpB2mtFO/q8m1kOsUi1WhUPcDvOl4J0dxyHA2 SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-Microsoft-Exchange-Diagnostics: 1; DM3PR12MB0746; 20:NhvUruR31rN212OJefSGdUsEd0sg35jrrdOsh+vc11GgAfddKKMPoGOe5rxZe6MncH57fbO/PjARqGXaP9U99BX0K7Ph2KhEzh/M5S2sMM7uEgRkQoMqcNpWz9CnFiuqmpO60f1pPZfw1y1UzSukKvQlgwm9hOnsABkyKaJ85pc92PVuPuVNVS8jcM+4N8cWx2ixk+hDBrytLQYbQ012iOizU41pG090RNiuJbV2hJP1iUDsG73+SnFeS0upuA8h X-OriginatorOrg: amd.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 05 Oct 2018 20:40:16.7782 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 8e8a86b3-7d27-4953-294f-08d62b02c266 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=[SATLEXCHOV01.amd.com] X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: DM3PR12MB0746 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: nicolai.haehnle@amd.com, michel@daenzer.net, Christian.Koenig@amd.com, manasi.d.navare@intel.com, Alexander.Deucher@amd.com, Nicholas Kazlauskas , 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 3283703b9822..3b786f3c47ef 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