From patchwork Fri Oct 12 16:44:57 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: "Kazlauskas, Nicholas" X-Patchwork-Id: 10638907 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 B0DBE112B for ; Fri, 12 Oct 2018 16:46:51 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id A0E442B67B for ; Fri, 12 Oct 2018 16:46:51 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 94C322B973; Fri, 12 Oct 2018 16:46:51 +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 438502B67B for ; Fri, 12 Oct 2018 16:46:51 +0000 (UTC) Received: from gabe.freedesktop.org (localhost [127.0.0.1]) by gabe.freedesktop.org (Postfix) with ESMTP id 39A868999C; Fri, 12 Oct 2018 16:46:50 +0000 (UTC) X-Original-To: dri-devel@lists.freedesktop.org Delivered-To: dri-devel@lists.freedesktop.org Received: from NAM02-CY1-obe.outbound.protection.outlook.com (mail-cys01nam02on0071.outbound.protection.outlook.com [104.47.37.71]) by gabe.freedesktop.org (Postfix) with ESMTPS id 480C48999C; Fri, 12 Oct 2018 16:46:48 +0000 (UTC) Received: from MWHPR1201CA0005.namprd12.prod.outlook.com (2603:10b6:301:4a::15) 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; Fri, 12 Oct 2018 16:46:46 +0000 Received: from DM3NAM03FT011.eop-NAM03.prod.protection.outlook.com (2a01:111:f400:7e49::206) by MWHPR1201CA0005.outlook.office365.com (2603:10b6:301:4a::15) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.1228.23 via Frontend Transport; Fri, 12 Oct 2018 16:46:45 +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 DM3NAM03FT011.mail.protection.outlook.com (10.152.82.88) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384) id 15.20.1250.12 via Frontend Transport; Fri, 12 Oct 2018 16:46:44 +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, 12 Oct 2018 11:46:44 -0500 From: Nicholas Kazlauskas To: , Subject: [PATCH v5 3/4] drm: Document variable refresh properties Date: Fri, 12 Oct 2018 12:44:57 -0400 Message-ID: <20181012164458.12864-4-nicholas.kazlauskas@amd.com> X-Mailer: git-send-email 2.17.1 In-Reply-To: <20181012164458.12864-1-nicholas.kazlauskas@amd.com> References: <20181012164458.12864-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)(396003)(136003)(39860400002)(346002)(376002)(2980300002)(428003)(3190300001)(189003)(199004)(68736007)(575784001)(36756003)(104016004)(86362001)(47776003)(51416003)(53416004)(316002)(7696005)(72206003)(16586007)(110136005)(1076002)(26005)(305945005)(106466001)(5660300001)(478600001)(54906003)(77096007)(14444005)(336012)(126002)(476003)(426003)(97736004)(11346002)(105586002)(2616005)(2906002)(8936002)(76176011)(81166006)(81156014)(53936002)(39060400002)(446003)(8676002)(4326008)(48376002)(186003)(50466002)(44832011)(486006)(5024004)(50226002)(6666004)(356004); DIR:OUT; SFP:1101; SCL:1; SRVR:SN1PR12MB0623; H:SATLEXCHOV01.amd.com; FPR:; SPF:None; LANG:en; PTR:InfoDomainNonexistent; MX:1; A:1; X-Microsoft-Exchange-Diagnostics: 1; DM3NAM03FT011; 1:I93TvEZdMmxjaf29Z/joTRHkFakNSTZcL8FhMEOiR3IxejzXGtUNHVO0afXd8zqRYq+UFfWuvQQbtru3jWQJaEryVi3DTO/94mg5NlPuvH8bMtA8CoZTFugWfQwIaB7l X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: cd8ec03d-0499-410e-85b6-08d630624b9c 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:0eVODqs63gOTsVVcOFOfI/Ki9PPsPcVPJc8ktSFgv5lXboCRYz3YB4/yEg5zrgIrwdXc+jrf39oQOL4juEAPtL2sus/O8CI6CejIKhrOmA6b78cletMeMAxSWr0XgJK7lhdXld1NNraU2R6QWDUAymNx6H6zyXQtlruppvZE2WNxXqiOi25ssB9DaHzGM5ZrLKWh1A7gFYsjQDt6UCXpuDQT0YA2JJ2tGzCp5wOkH2TRA9tNdswmMHRLOwV408DaliRUCLkbuyvUL1B8HOqJr5+RfOqhv+83vpUxkWTLDibVMUnHo2ki1l2NevtsTfAL4Ec/tHAXH1j9aJgVjLegLdUY/P7IZ9oglH1alItscsQ=; 25:2dl8WspvuT6qrPHrXJynXm1xx02f7iV9Iylr5HDk3Z22r46bpL/76ieX+BPyzPL7s3iYFjbXwZqGefXMobm3fhiIa6M32hXLnud0JgcpPODXv33Z9k0jRFAKWUnhU9FayY5NagtLNVP4TF0/g4fYFLOtjwrMCXLgY94tbeskt8+C99OmMXhm9Rz8vkFH/5ljVDR35dCxvbdYBWnx5AE2jBxTr305bblEmSR2ufyBQACEZbUrBhb6x9Z47WjWUbDa92veJh/CxCdDkFtFIoB1iqlRHrGdfznaGYvA4Au4tFtDswValYFaf3aWSMQUnAmeZnMrC3lsf2HLwTbo84LDyg== X-MS-TrafficTypeDiagnostic: SN1PR12MB0623: X-Microsoft-Exchange-Diagnostics: 1; SN1PR12MB0623; 31:Rzt+2GN8zp3H6iOYHz7ZvdWStGDvCjgUACUz8zNKmE4i3zyCDNY24LEZIdlbbU3XZw2ri0Lil/DHmzeSqbSEC9deKFvKl6zdgFsZ9Jg3AH/aPsuzYo8iFDtuPhLqRGOMb7l+1v+ltk8486wXRzdcMFp+BXuMT/1ITqV1X6L1TEvy5snByjhr6xa5FNC9h8/OEafY0mfZHwqdhdL8aUO28+CAR+qCSlECesF8NAlP984=; 20:pgrCvlGdtulqXZv9ik5IfWvaTZdY0VMF6F6I1y2/kHUozEUXn6xl5hYARP0amS61SxRO+6YsqaauKQ4ZItAK+rehsoySLuoBmUMkA0WUQbhr0i/46sjXQJC2QYitUBK1P5XNr58amws9Rz/s+FMnxqPQra60Cy93zI8+oDj71u66adbQtVlurymapQV+sfkhho3xRo8iERefckKHutUFPzB3TYV75w4IUvT5YSkRmFr0LrJZ9gZvPGlU+rC16df9y9Tf9R3YenLddIsYyUgPnxHiGVpVAC5/ktcjko2ILxVF2rh/t4+VpyaGFK+Y6QvSo+aAT6XYX2tP905BUfXbw1AEEpiAFoUM8CNWeD1fm9IAcLf5LpQMCy6A8S3O5RH1QjB+0LBXZWJSuBM0zw/6wwFcZHr5uQLvnHqPTFyYog8ijtDf+31edOwufV+8ouMOGxZDmhL7wh9Iuoj+JWcfIP3m963xqgIIoIMfzxqSl25JUaW9D3NhmzNmjehugAvq 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)(20161123564045)(20161123560045)(201703131423095)(201702281528075)(20161123555045)(201703061421075)(201703061406153)(20161123562045)(20161123558120)(201708071742011)(7699051)(76991067); SRVR:SN1PR12MB0623; BCL:0; PCL:0; RULEID:; SRVR:SN1PR12MB0623; X-Microsoft-Exchange-Diagnostics: 1; SN1PR12MB0623; 4:zXgB49/MIJbNX4lWmAaYDdr51e75pHM2DxoFh6Vz91In0YQzsiV88JkKrz2TEQ4NqmyvMWLlzqrdJi28Ku+i/fLvpFpmvTOx/PlSmRSO6trvmJuehC3YqlCJRuX/tB5PDMvjS46GDiop/qMd8Rmcf+cIddWBCn64imWhDgv5zNiuhBlWjbFPkrbDcMPmRxf1kzCZtJAnNTVZ5/RnfAO6fdbjqwuBmq5Suq8pLQAC4vc4JOhGPpOiGXupRDeIl5dI2ldZNyqPvI/4Wz3Qwt3WYMI3D9qF/xwKm67pQ9Vsun6gAG7K+GJ5Gjt060/BKdPe X-Forefront-PRVS: 0823A5777B X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1; SN1PR12MB0623; 23:2ouImfDnS5K9o69U1/RlDNOhz9qpEAVWUTV1EKjEU?= IzmzCN5Ix1D4rF19g9H+uRp2FoNJevwazKBCTzDioiLDJjjXW4HmluN0M5ITQDEZB2Y4OyyG34U91b6MxEkEhEUunQETSsQD3aeNWQ2MvVL1NQBoFH/Arze3JiOIx0aCw81NIGFZu9hTWqlzAx2+t12n1VFX/rh5bY7qGxrIQ1n4v/BDfgG64ae6On8H/Fb2MK7OtOvxH4ij1hA1ceMdBBBByh3gK21flRZwnyuh9U7NcvwOL9A3b6RM2+41m5UeEmlBWkaB3EPCAnYFG6fQ94YtNsw6ctgI8Ne8IP8R8G2935PB0C3PxyAHiAaCkDnYZok2OwnWDr/jV0B6i/aJMHzq8Xx8VBhRLd7GohTM00rfar6Dfxq3UbEr5VOLe2bKhce1gePyHAksG+hU40xyDjLJsYYB9agdDtFGTUXaIFJ4oR5vmoMRuJU0hmApvocDQBjrO7TZobt7PsbBwz9ozmHV2MHQql48DGZmOglk8LxiFEL4HzcMPtKX4yHfOy04ua/UAxywpo4iAKB2HXRTiB6QiOJ4odTeEZGnUehjt0truRMvLcLTnUp0C5kHeEbejcoq6meARUGH2j8srAkQ38D2VqHEo77ion442cawvtOgzIrwipdV9Wvhbd0XmknTmDiR8O/FkjDXbjGxRLIRy4gvwi6HsVtMgKPT+QCeISvxa9MLabwgcXbmR6atXiHRMJ7R4QvDggpRhbH6LP08pSy3MyPnuirLxwqWI722hjbkmGfW4g7SX5RHM2+8vVO/Kx5hpXENCcb9j0AFk7uOiw1ZNO74Utdc//ppizrRl7ihKo/9pX5PeeeN72Xh80S7Xux3W2/EzQEGoCeWIHzdX7kmIXtE0MTxIMZZMyZZ+0LGRFMVgDXpFtXLWE7BnYsRzDD5i9OpuF/ZyIF6QTPim/G8QgTUP3EsSwKJ0CV76aPwDV9XUdMoh3Zq4hDfnZA+A5NNiv0OXgNYNoSoABC7TV/9iMnD8oKb8HUk1I2ZP+FXmM3NaYLgV8L4biCKR3geXeGHgwB1m2K/HCbDJaNyUO9W9+81+dIiFP13pcFBmAoewYDEyY7MSjqSvebhaB68brRSuaCG0EsQiVpRpIkFbbyBn9VeK6KFxb45HVxbKPTCdgTVvY02mrWsqygNMaw9JxicvMM+hz3qZRHGTkXp7HQ8Xpm7XJUJkMpuO06I8zbLCNS8UFZS9RPJd3P8yOJlzadbjNeD7vLbF6I27BqkO734z5WB4N1A5Tu6Yuo8MMDhNlLzAMHKNNtl5xfa6n6708= X-Microsoft-Antispam-Message-Info: PvGfLRkkpWCLVOgDMJ3FIaiSXq2u8zp+93qN5I7FtKchHD0sAh/bdvZ42XxssnR/o421XdPvrKVq8Xq7LChcly5TA+u3bF0pWE427TcaJvTfW9sNYYBWwE8wE1AC4UnDee1s4GmBj/XC5EsD/SF52zsY7RPkp+5nuBGx2SUYqdCFp2QI70hpBvM14KQ7vpwvVvUn5Uo8W6Zj5i5dviNYHnnVVoBrMvGGGjup3Ixs0pfctaqgcG2M/Rsjr+unO5TbHGA6DoPFuWZ8k9MFqn6Dk7Hw6mdBYPRIc0+QK2P5LjMGYGzbTUP29NgsfmYU9VbMlDFCgrW5OJu7YPL5Y6hdkvrL5YInPJs4M7j97WWGYOA= X-Microsoft-Exchange-Diagnostics: 1; SN1PR12MB0623; 6:JxjOfEqIJQVwMQzETU3ncLIG9hlDT4EGMBk1R+ePUZLb65zjvJqMJWMo/x+mpBtugXvXdqWwemk22HglTwWhPyk7qWk27BUWN6B00/5SxibVXkOPmLilWiqbzwrrH6CnyWT19yXh4MYn/7dVrnLkk3GafNJXHr1jeEJNAMtW48l7I5vllAk+eXRD1GLCj3Z6+TTywY+waRBfHSVNkNX/tH51TOE7WFedOoRV9Buf+5VEYXKYR6bDMlpfeby9Gddud49E1qyF9EdVNRJYsnUaMwSgNBtrKGSRxLbosys6RpnDhOvrohdKqAZQ4fRKkQY0igiHcillle0ZcNDziQWjinr7dws9CtYbslGOQlWwteltdRRg3sHcxREpGp6yh9fGw9H+JSddoOrRftFhrCSd12QdGlETWYU6VHjThe4Mv+XvNwBQkdpHnvuXtr9ix9EamDwpHi9BmizGJafoc77ecg==; 5:GL8y0h8G05C1V+uO/FHOyNeRCMV4yzvNJgvfgfv0+k+VuFtX3DulKDcPf1nM3un/dcWyymuQF0ICoGf3ooa3Jh0/LSFRpXycKNiwpHGraXLkZ8hL3K/wlkCFb25ek1upPgOFjx8mBQpbKnsWTYBMylsp1Ihf7LG5KmdoNYhdxLE=; 7:B1z6o6KSYjBoNTRqz0WvLsPI5uFi8Ts1uLZDmrMMhRiCUXcjPNmATu8QvghdV4LMAkFSHrGlSNNT8SB4hMdaZZS8K2UcbS7tnvwJrQ9CGOHkTlHkWa6RA2v+83NfOcdIaQbG4YgkkkMV+7Yqo0vX1mdrYZH2ixtrUHA8BIBXcnvFm6dMFlQVcTRPAOi0/63xOY6V5TJZVFKPDVNE9QlOm0FJoY/mBagkZcaP3XE3Yrm8NLiJT3e5dSrnUJTEW97A SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-Microsoft-Exchange-Diagnostics: 1; SN1PR12MB0623; 20:Ts6O2knhdNwTN4UwfPPVLQ28lCXbRckQlTMJUnWuyyCgQZxSRXxqS3zg/bcr0rEEpDxXvtHYjhnBTbrpGGvtbT8aWel59/CXRebX/zYMT9bmrA+LMPNfMEfkkNSAhfDtEtR3xcBboOXC6n97Y5a5v7MysOpu2/Bo2V74gJxwQkUHn3BDwSlVqI8rG3k5VuED8TBuDE4jjzTYLZ9ATMS91sWOUU4XxdzkQH3ugDeaQhXFiMq7n/ku3x5T0t+eeBLK X-OriginatorOrg: amd.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 12 Oct 2018 16:46:44.7199 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: cd8ec03d-0499-410e-85b6-08d630624b9c 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: 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, 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 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