152217195SDaniel Vetter /* 252217195SDaniel Vetter * Copyright (c) 2016 Intel Corporation 352217195SDaniel Vetter * 452217195SDaniel Vetter * Permission to use, copy, modify, distribute, and sell this software and its 552217195SDaniel Vetter * documentation for any purpose is hereby granted without fee, provided that 652217195SDaniel Vetter * the above copyright notice appear in all copies and that both that copyright 752217195SDaniel Vetter * notice and this permission notice appear in supporting documentation, and 852217195SDaniel Vetter * that the name of the copyright holders not be used in advertising or 952217195SDaniel Vetter * publicity pertaining to distribution of the software without specific, 1052217195SDaniel Vetter * written prior permission. The copyright holders make no representations 1152217195SDaniel Vetter * about the suitability of this software for any purpose. It is provided "as 1252217195SDaniel Vetter * is" without express or implied warranty. 1352217195SDaniel Vetter * 1452217195SDaniel Vetter * THE COPYRIGHT HOLDERS DISCLAIM ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, 1552217195SDaniel Vetter * INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO 1652217195SDaniel Vetter * EVENT SHALL THE COPYRIGHT HOLDERS BE LIABLE FOR ANY SPECIAL, INDIRECT OR 1752217195SDaniel Vetter * CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, 1852217195SDaniel Vetter * DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER 1952217195SDaniel Vetter * TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE 2052217195SDaniel Vetter * OF THIS SOFTWARE. 2152217195SDaniel Vetter */ 2252217195SDaniel Vetter 238f86c82aSSimon Ser #include <drm/drm_auth.h> 2452217195SDaniel Vetter #include <drm/drm_connector.h> 25d71d8a4bSMaxime Ripard #include <drm/drm_drv.h> 2652217195SDaniel Vetter #include <drm/drm_edid.h> 279338203cSLaurent Pinchart #include <drm/drm_encoder.h> 2899f45e32SDaniel Vetter #include <drm/drm_file.h> 29d71d8a4bSMaxime Ripard #include <drm/drm_panel.h> 30d71d8a4bSMaxime Ripard #include <drm/drm_print.h> 31334f74eeSHans de Goede #include <drm/drm_privacy_screen_consumer.h> 32968d81a6SJeykumar Sankaran #include <drm/drm_sysfs.h> 33d71d8a4bSMaxime Ripard #include <drm/drm_utils.h> 3499f45e32SDaniel Vetter 3573289afeSVille Syrjälä #include <linux/fb.h> 3699f45e32SDaniel Vetter #include <linux/uaccess.h> 3752217195SDaniel Vetter 3852217195SDaniel Vetter #include "drm_crtc_internal.h" 3952217195SDaniel Vetter #include "drm_internal.h" 4052217195SDaniel Vetter 41ae2a6da8SDaniel Vetter /** 42ae2a6da8SDaniel Vetter * DOC: overview 43ae2a6da8SDaniel Vetter * 44ae2a6da8SDaniel Vetter * In DRM connectors are the general abstraction for display sinks, and include 4584e543bcSAntonio Borneo * also fixed panels or anything else that can display pixels in some form. As 46ae2a6da8SDaniel Vetter * opposed to all other KMS objects representing hardware (like CRTC, encoder or 47ae2a6da8SDaniel Vetter * plane abstractions) connectors can be hotplugged and unplugged at runtime. 48ad093607SThierry Reding * Hence they are reference-counted using drm_connector_get() and 49ad093607SThierry Reding * drm_connector_put(). 50ae2a6da8SDaniel Vetter * 51d574528aSDaniel Vetter * KMS driver must create, initialize, register and attach at a &struct 52d574528aSDaniel Vetter * drm_connector for each such sink. The instance is created as other KMS 53aec97460SDaniel Vetter * objects and initialized by setting the following fields. The connector is 54aec97460SDaniel Vetter * initialized with a call to drm_connector_init() with a pointer to the 55aec97460SDaniel Vetter * &struct drm_connector_funcs and a connector type, and then exposed to 56aec97460SDaniel Vetter * userspace with a call to drm_connector_register(). 57ae2a6da8SDaniel Vetter * 58ae2a6da8SDaniel Vetter * Connectors must be attached to an encoder to be used. For devices that map 59ae2a6da8SDaniel Vetter * connectors to encoders 1:1, the connector should be attached at 60cde4c44dSDaniel Vetter * initialization time with a call to drm_connector_attach_encoder(). The 61d574528aSDaniel Vetter * driver must also set the &drm_connector.encoder field to point to the 62ae2a6da8SDaniel Vetter * attached encoder. 63ae2a6da8SDaniel Vetter * 64ae2a6da8SDaniel Vetter * For connectors which are not fixed (like built-in panels) the driver needs to 65ae2a6da8SDaniel Vetter * support hotplug notifications. The simplest way to do that is by using the 66ae2a6da8SDaniel Vetter * probe helpers, see drm_kms_helper_poll_init() for connectors which don't have 67ae2a6da8SDaniel Vetter * hardware support for hotplug interrupts. Connectors with hardware hotplug 68ae2a6da8SDaniel Vetter * support can instead use e.g. drm_helper_hpd_irq_event(). 69ae2a6da8SDaniel Vetter */ 70ae2a6da8SDaniel Vetter 713d3f7c1eSHans de Goede /* 723d3f7c1eSHans de Goede * Global connector list for drm_connector_find_by_fwnode(). 733d3f7c1eSHans de Goede * Note drm_connector_[un]register() first take connector->lock and then 743d3f7c1eSHans de Goede * take the connector_list_lock. 753d3f7c1eSHans de Goede */ 763d3f7c1eSHans de Goede static DEFINE_MUTEX(connector_list_lock); 773d3f7c1eSHans de Goede static LIST_HEAD(connector_list); 783d3f7c1eSHans de Goede 7952217195SDaniel Vetter struct drm_conn_prop_enum_list { 8052217195SDaniel Vetter int type; 8152217195SDaniel Vetter const char *name; 8252217195SDaniel Vetter struct ida ida; 8352217195SDaniel Vetter }; 8452217195SDaniel Vetter 8552217195SDaniel Vetter /* 8652217195SDaniel Vetter * Connector and encoder types. 8752217195SDaniel Vetter */ 8852217195SDaniel Vetter static struct drm_conn_prop_enum_list drm_connector_enum_list[] = { 8952217195SDaniel Vetter { DRM_MODE_CONNECTOR_Unknown, "Unknown" }, 9052217195SDaniel Vetter { DRM_MODE_CONNECTOR_VGA, "VGA" }, 9152217195SDaniel Vetter { DRM_MODE_CONNECTOR_DVII, "DVI-I" }, 9252217195SDaniel Vetter { DRM_MODE_CONNECTOR_DVID, "DVI-D" }, 9352217195SDaniel Vetter { DRM_MODE_CONNECTOR_DVIA, "DVI-A" }, 9452217195SDaniel Vetter { DRM_MODE_CONNECTOR_Composite, "Composite" }, 9552217195SDaniel Vetter { DRM_MODE_CONNECTOR_SVIDEO, "SVIDEO" }, 9652217195SDaniel Vetter { DRM_MODE_CONNECTOR_LVDS, "LVDS" }, 9752217195SDaniel Vetter { DRM_MODE_CONNECTOR_Component, "Component" }, 9852217195SDaniel Vetter { DRM_MODE_CONNECTOR_9PinDIN, "DIN" }, 9952217195SDaniel Vetter { DRM_MODE_CONNECTOR_DisplayPort, "DP" }, 10052217195SDaniel Vetter { DRM_MODE_CONNECTOR_HDMIA, "HDMI-A" }, 10152217195SDaniel Vetter { DRM_MODE_CONNECTOR_HDMIB, "HDMI-B" }, 10252217195SDaniel Vetter { DRM_MODE_CONNECTOR_TV, "TV" }, 10352217195SDaniel Vetter { DRM_MODE_CONNECTOR_eDP, "eDP" }, 10452217195SDaniel Vetter { DRM_MODE_CONNECTOR_VIRTUAL, "Virtual" }, 10552217195SDaniel Vetter { DRM_MODE_CONNECTOR_DSI, "DSI" }, 10652217195SDaniel Vetter { DRM_MODE_CONNECTOR_DPI, "DPI" }, 107935774cdSBrian Starkey { DRM_MODE_CONNECTOR_WRITEBACK, "Writeback" }, 108fc06bf1dSNoralf Trønnes { DRM_MODE_CONNECTOR_SPI, "SPI" }, 109757e2671SNoralf Trønnes { DRM_MODE_CONNECTOR_USB, "USB" }, 11052217195SDaniel Vetter }; 11152217195SDaniel Vetter 11252217195SDaniel Vetter void drm_connector_ida_init(void) 11352217195SDaniel Vetter { 11452217195SDaniel Vetter int i; 11552217195SDaniel Vetter 11652217195SDaniel Vetter for (i = 0; i < ARRAY_SIZE(drm_connector_enum_list); i++) 11752217195SDaniel Vetter ida_init(&drm_connector_enum_list[i].ida); 11852217195SDaniel Vetter } 11952217195SDaniel Vetter 12052217195SDaniel Vetter void drm_connector_ida_destroy(void) 12152217195SDaniel Vetter { 12252217195SDaniel Vetter int i; 12352217195SDaniel Vetter 12452217195SDaniel Vetter for (i = 0; i < ARRAY_SIZE(drm_connector_enum_list); i++) 12552217195SDaniel Vetter ida_destroy(&drm_connector_enum_list[i].ida); 12652217195SDaniel Vetter } 12752217195SDaniel Vetter 12852217195SDaniel Vetter /** 129b35f90f2SLaurent Pinchart * drm_get_connector_type_name - return a string for connector type 130b35f90f2SLaurent Pinchart * @type: The connector type (DRM_MODE_CONNECTOR_*) 131b35f90f2SLaurent Pinchart * 132b35f90f2SLaurent Pinchart * Returns: the name of the connector type, or NULL if the type is not valid. 133b35f90f2SLaurent Pinchart */ 134b35f90f2SLaurent Pinchart const char *drm_get_connector_type_name(unsigned int type) 135b35f90f2SLaurent Pinchart { 136b35f90f2SLaurent Pinchart if (type < ARRAY_SIZE(drm_connector_enum_list)) 137b35f90f2SLaurent Pinchart return drm_connector_enum_list[type].name; 138b35f90f2SLaurent Pinchart 139b35f90f2SLaurent Pinchart return NULL; 140b35f90f2SLaurent Pinchart } 141b35f90f2SLaurent Pinchart EXPORT_SYMBOL(drm_get_connector_type_name); 142b35f90f2SLaurent Pinchart 143b35f90f2SLaurent Pinchart /** 14452217195SDaniel Vetter * drm_connector_get_cmdline_mode - reads the user's cmdline mode 14584e543bcSAntonio Borneo * @connector: connector to query 14652217195SDaniel Vetter * 147ae2a6da8SDaniel Vetter * The kernel supports per-connector configuration of its consoles through 14852217195SDaniel Vetter * use of the video= parameter. This function parses that option and 14952217195SDaniel Vetter * extracts the user's specified mode (or enable/disable status) for a 15052217195SDaniel Vetter * particular connector. This is typically only used during the early fbdev 15152217195SDaniel Vetter * setup. 15252217195SDaniel Vetter */ 15352217195SDaniel Vetter static void drm_connector_get_cmdline_mode(struct drm_connector *connector) 15452217195SDaniel Vetter { 15552217195SDaniel Vetter struct drm_cmdline_mode *mode = &connector->cmdline_mode; 15652217195SDaniel Vetter char *option = NULL; 15752217195SDaniel Vetter 15852217195SDaniel Vetter if (fb_get_options(connector->name, &option)) 15952217195SDaniel Vetter return; 16052217195SDaniel Vetter 16152217195SDaniel Vetter if (!drm_mode_parse_command_line_for_connector(option, 16252217195SDaniel Vetter connector, 16352217195SDaniel Vetter mode)) 16452217195SDaniel Vetter return; 16552217195SDaniel Vetter 16652217195SDaniel Vetter if (mode->force) { 1676140cf20SJani Nikula DRM_INFO("forcing %s connector %s\n", connector->name, 1686140cf20SJani Nikula drm_get_connector_force_name(mode->force)); 16952217195SDaniel Vetter connector->force = mode->force; 17052217195SDaniel Vetter } 17152217195SDaniel Vetter 1720980939dSHans de Goede if (mode->panel_orientation != DRM_MODE_PANEL_ORIENTATION_UNKNOWN) { 1730980939dSHans de Goede DRM_INFO("cmdline forces connector %s panel_orientation to %d\n", 1740980939dSHans de Goede connector->name, mode->panel_orientation); 1750980939dSHans de Goede drm_connector_set_panel_orientation(connector, 1760980939dSHans de Goede mode->panel_orientation); 1770980939dSHans de Goede } 1780980939dSHans de Goede 1793aeeb13dSMaxime Ripard DRM_DEBUG_KMS("cmdline mode for connector %s %s %dx%d@%dHz%s%s%s\n", 18050b0946dSMaxime Ripard connector->name, mode->name, 18152217195SDaniel Vetter mode->xres, mode->yres, 18252217195SDaniel Vetter mode->refresh_specified ? mode->refresh : 60, 18352217195SDaniel Vetter mode->rb ? " reduced blanking" : "", 18452217195SDaniel Vetter mode->margins ? " with margins" : "", 18552217195SDaniel Vetter mode->interlace ? " interlaced" : ""); 18652217195SDaniel Vetter } 18752217195SDaniel Vetter 18852217195SDaniel Vetter static void drm_connector_free(struct kref *kref) 18952217195SDaniel Vetter { 19052217195SDaniel Vetter struct drm_connector *connector = 19152217195SDaniel Vetter container_of(kref, struct drm_connector, base.refcount); 19252217195SDaniel Vetter struct drm_device *dev = connector->dev; 19352217195SDaniel Vetter 19452217195SDaniel Vetter drm_mode_object_unregister(dev, &connector->base); 19552217195SDaniel Vetter connector->funcs->destroy(connector); 19652217195SDaniel Vetter } 19752217195SDaniel Vetter 198ea497bb9SDaniel Vetter void drm_connector_free_work_fn(struct work_struct *work) 199a703c550SDaniel Vetter { 200ea497bb9SDaniel Vetter struct drm_connector *connector, *n; 201ea497bb9SDaniel Vetter struct drm_device *dev = 202ea497bb9SDaniel Vetter container_of(work, struct drm_device, mode_config.connector_free_work); 203ea497bb9SDaniel Vetter struct drm_mode_config *config = &dev->mode_config; 204ea497bb9SDaniel Vetter unsigned long flags; 205ea497bb9SDaniel Vetter struct llist_node *freed; 206a703c550SDaniel Vetter 207ea497bb9SDaniel Vetter spin_lock_irqsave(&config->connector_list_lock, flags); 208ea497bb9SDaniel Vetter freed = llist_del_all(&config->connector_free_list); 209ea497bb9SDaniel Vetter spin_unlock_irqrestore(&config->connector_list_lock, flags); 210ea497bb9SDaniel Vetter 211ea497bb9SDaniel Vetter llist_for_each_entry_safe(connector, n, freed, free_node) { 212a703c550SDaniel Vetter drm_mode_object_unregister(dev, &connector->base); 213a703c550SDaniel Vetter connector->funcs->destroy(connector); 214a703c550SDaniel Vetter } 215ea497bb9SDaniel Vetter } 216a703c550SDaniel Vetter 217b11af8a2SMaxime Ripard static int __drm_connector_init(struct drm_device *dev, 21852217195SDaniel Vetter struct drm_connector *connector, 21952217195SDaniel Vetter const struct drm_connector_funcs *funcs, 220b11af8a2SMaxime Ripard int connector_type, 221b11af8a2SMaxime Ripard struct i2c_adapter *ddc) 22252217195SDaniel Vetter { 22352217195SDaniel Vetter struct drm_mode_config *config = &dev->mode_config; 22452217195SDaniel Vetter int ret; 22552217195SDaniel Vetter struct ida *connector_ida = 22652217195SDaniel Vetter &drm_connector_enum_list[connector_type].ida; 22752217195SDaniel Vetter 228ba1f665fSHaneen Mohammed WARN_ON(drm_drv_uses_atomic_modeset(dev) && 229ba1f665fSHaneen Mohammed (!funcs->atomic_destroy_state || 230ba1f665fSHaneen Mohammed !funcs->atomic_duplicate_state)); 231ba1f665fSHaneen Mohammed 2322135ea7aSThierry Reding ret = __drm_mode_object_add(dev, &connector->base, 23352217195SDaniel Vetter DRM_MODE_OBJECT_CONNECTOR, 23452217195SDaniel Vetter false, drm_connector_free); 23552217195SDaniel Vetter if (ret) 236613051daSDaniel Vetter return ret; 23752217195SDaniel Vetter 23852217195SDaniel Vetter connector->base.properties = &connector->properties; 23952217195SDaniel Vetter connector->dev = dev; 24052217195SDaniel Vetter connector->funcs = funcs; 24152217195SDaniel Vetter 2422a8d3eacSVille Syrjälä /* connector index is used with 32bit bitmasks */ 243e5d6eeeaSBo Liu ret = ida_alloc_max(&config->connector_ida, 31, GFP_KERNEL); 2442a8d3eacSVille Syrjälä if (ret < 0) { 2452a8d3eacSVille Syrjälä DRM_DEBUG_KMS("Failed to allocate %s connector index: %d\n", 2462a8d3eacSVille Syrjälä drm_connector_enum_list[connector_type].name, 2472a8d3eacSVille Syrjälä ret); 24852217195SDaniel Vetter goto out_put; 2492a8d3eacSVille Syrjälä } 25052217195SDaniel Vetter connector->index = ret; 25152217195SDaniel Vetter ret = 0; 25252217195SDaniel Vetter 25352217195SDaniel Vetter connector->connector_type = connector_type; 25452217195SDaniel Vetter connector->connector_type_id = 255e5d6eeeaSBo Liu ida_alloc_min(connector_ida, 1, GFP_KERNEL); 25652217195SDaniel Vetter if (connector->connector_type_id < 0) { 25752217195SDaniel Vetter ret = connector->connector_type_id; 25852217195SDaniel Vetter goto out_put_id; 25952217195SDaniel Vetter } 26052217195SDaniel Vetter connector->name = 26152217195SDaniel Vetter kasprintf(GFP_KERNEL, "%s-%d", 26252217195SDaniel Vetter drm_connector_enum_list[connector_type].name, 26352217195SDaniel Vetter connector->connector_type_id); 26452217195SDaniel Vetter if (!connector->name) { 26552217195SDaniel Vetter ret = -ENOMEM; 26652217195SDaniel Vetter goto out_put_type_id; 26752217195SDaniel Vetter } 26852217195SDaniel Vetter 269b11af8a2SMaxime Ripard /* provide ddc symlink in sysfs */ 270b11af8a2SMaxime Ripard connector->ddc = ddc; 271b11af8a2SMaxime Ripard 2723d3f7c1eSHans de Goede INIT_LIST_HEAD(&connector->global_connector_list_entry); 27352217195SDaniel Vetter INIT_LIST_HEAD(&connector->probed_modes); 27452217195SDaniel Vetter INIT_LIST_HEAD(&connector->modes); 275e73ab00eSDaniel Vetter mutex_init(&connector->mutex); 27652217195SDaniel Vetter connector->edid_blob_ptr = NULL; 2775186421cSStanislav Lisovskiy connector->epoch_counter = 0; 2782de3a078SManasi Navare connector->tile_blob_ptr = NULL; 27952217195SDaniel Vetter connector->status = connector_status_unknown; 2808d70f395SHans de Goede connector->display_info.panel_orientation = 2818d70f395SHans de Goede DRM_MODE_PANEL_ORIENTATION_UNKNOWN; 28252217195SDaniel Vetter 28352217195SDaniel Vetter drm_connector_get_cmdline_mode(connector); 28452217195SDaniel Vetter 28552217195SDaniel Vetter /* We should add connectors at the end to avoid upsetting the connector 286c2ce66daSBeatriz Martins de Carvalho * index too much. 287c2ce66daSBeatriz Martins de Carvalho */ 288613051daSDaniel Vetter spin_lock_irq(&config->connector_list_lock); 28952217195SDaniel Vetter list_add_tail(&connector->head, &config->connector_list); 29052217195SDaniel Vetter config->num_connector++; 291613051daSDaniel Vetter spin_unlock_irq(&config->connector_list_lock); 29252217195SDaniel Vetter 293935774cdSBrian Starkey if (connector_type != DRM_MODE_CONNECTOR_VIRTUAL && 294935774cdSBrian Starkey connector_type != DRM_MODE_CONNECTOR_WRITEBACK) 2956b7e2d5cSGerd Hoffmann drm_connector_attach_edid_property(connector); 29652217195SDaniel Vetter 29752217195SDaniel Vetter drm_object_attach_property(&connector->base, 29852217195SDaniel Vetter config->dpms_property, 0); 29952217195SDaniel Vetter 30040ee6fbeSManasi Navare drm_object_attach_property(&connector->base, 30140ee6fbeSManasi Navare config->link_status_property, 30240ee6fbeSManasi Navare 0); 30340ee6fbeSManasi Navare 30466660d4cSDave Airlie drm_object_attach_property(&connector->base, 30566660d4cSDave Airlie config->non_desktop_property, 30666660d4cSDave Airlie 0); 3072de3a078SManasi Navare drm_object_attach_property(&connector->base, 3082de3a078SManasi Navare config->tile_property, 3092de3a078SManasi Navare 0); 31066660d4cSDave Airlie 31152217195SDaniel Vetter if (drm_core_check_feature(dev, DRIVER_ATOMIC)) { 31252217195SDaniel Vetter drm_object_attach_property(&connector->base, config->prop_crtc_id, 0); 31352217195SDaniel Vetter } 31452217195SDaniel Vetter 31552217195SDaniel Vetter connector->debugfs_entry = NULL; 31652217195SDaniel Vetter out_put_type_id: 31752217195SDaniel Vetter if (ret) 318e5d6eeeaSBo Liu ida_free(connector_ida, connector->connector_type_id); 31952217195SDaniel Vetter out_put_id: 32052217195SDaniel Vetter if (ret) 321e5d6eeeaSBo Liu ida_free(&config->connector_ida, connector->index); 32252217195SDaniel Vetter out_put: 32352217195SDaniel Vetter if (ret) 32452217195SDaniel Vetter drm_mode_object_unregister(dev, &connector->base); 32552217195SDaniel Vetter 32652217195SDaniel Vetter return ret; 32752217195SDaniel Vetter } 328b11af8a2SMaxime Ripard 329b11af8a2SMaxime Ripard /** 330b11af8a2SMaxime Ripard * drm_connector_init - Init a preallocated connector 331b11af8a2SMaxime Ripard * @dev: DRM device 332b11af8a2SMaxime Ripard * @connector: the connector to init 333b11af8a2SMaxime Ripard * @funcs: callbacks for this connector 334b11af8a2SMaxime Ripard * @connector_type: user visible type of the connector 335b11af8a2SMaxime Ripard * 336b11af8a2SMaxime Ripard * Initialises a preallocated connector. Connectors should be 337b11af8a2SMaxime Ripard * subclassed as part of driver connector objects. 338b11af8a2SMaxime Ripard * 339b11af8a2SMaxime Ripard * At driver unload time the driver's &drm_connector_funcs.destroy hook 340b11af8a2SMaxime Ripard * should call drm_connector_cleanup() and free the connector structure. 341b11af8a2SMaxime Ripard * The connector structure should not be allocated with devm_kzalloc(). 342b11af8a2SMaxime Ripard * 343b11af8a2SMaxime Ripard * Returns: 344b11af8a2SMaxime Ripard * Zero on success, error code on failure. 345b11af8a2SMaxime Ripard */ 346b11af8a2SMaxime Ripard int drm_connector_init(struct drm_device *dev, 347b11af8a2SMaxime Ripard struct drm_connector *connector, 348b11af8a2SMaxime Ripard const struct drm_connector_funcs *funcs, 349b11af8a2SMaxime Ripard int connector_type) 350b11af8a2SMaxime Ripard { 351*a961b197SMaxime Ripard if (drm_WARN_ON(dev, !(funcs && funcs->destroy))) 352*a961b197SMaxime Ripard return -EINVAL; 353*a961b197SMaxime Ripard 354b11af8a2SMaxime Ripard return __drm_connector_init(dev, connector, funcs, connector_type, NULL); 355b11af8a2SMaxime Ripard } 35652217195SDaniel Vetter EXPORT_SYMBOL(drm_connector_init); 35752217195SDaniel Vetter 35852217195SDaniel Vetter /** 359100163dfSAndrzej Pietrasiewicz * drm_connector_init_with_ddc - Init a preallocated connector 360100163dfSAndrzej Pietrasiewicz * @dev: DRM device 361100163dfSAndrzej Pietrasiewicz * @connector: the connector to init 362100163dfSAndrzej Pietrasiewicz * @funcs: callbacks for this connector 363100163dfSAndrzej Pietrasiewicz * @connector_type: user visible type of the connector 364100163dfSAndrzej Pietrasiewicz * @ddc: pointer to the associated ddc adapter 365100163dfSAndrzej Pietrasiewicz * 366100163dfSAndrzej Pietrasiewicz * Initialises a preallocated connector. Connectors should be 367100163dfSAndrzej Pietrasiewicz * subclassed as part of driver connector objects. 368100163dfSAndrzej Pietrasiewicz * 36900ec947cSMaxime Ripard * At driver unload time the driver's &drm_connector_funcs.destroy hook 37000ec947cSMaxime Ripard * should call drm_connector_cleanup() and free the connector structure. 37100ec947cSMaxime Ripard * The connector structure should not be allocated with devm_kzalloc(). 37200ec947cSMaxime Ripard * 373100163dfSAndrzej Pietrasiewicz * Ensures that the ddc field of the connector is correctly set. 374100163dfSAndrzej Pietrasiewicz * 375100163dfSAndrzej Pietrasiewicz * Returns: 376100163dfSAndrzej Pietrasiewicz * Zero on success, error code on failure. 377100163dfSAndrzej Pietrasiewicz */ 378100163dfSAndrzej Pietrasiewicz int drm_connector_init_with_ddc(struct drm_device *dev, 379100163dfSAndrzej Pietrasiewicz struct drm_connector *connector, 380100163dfSAndrzej Pietrasiewicz const struct drm_connector_funcs *funcs, 381100163dfSAndrzej Pietrasiewicz int connector_type, 382100163dfSAndrzej Pietrasiewicz struct i2c_adapter *ddc) 383100163dfSAndrzej Pietrasiewicz { 384*a961b197SMaxime Ripard if (drm_WARN_ON(dev, !(funcs && funcs->destroy))) 385*a961b197SMaxime Ripard return -EINVAL; 386*a961b197SMaxime Ripard 387b11af8a2SMaxime Ripard return __drm_connector_init(dev, connector, funcs, connector_type, ddc); 388100163dfSAndrzej Pietrasiewicz } 389100163dfSAndrzej Pietrasiewicz EXPORT_SYMBOL(drm_connector_init_with_ddc); 390100163dfSAndrzej Pietrasiewicz 391100163dfSAndrzej Pietrasiewicz /** 3926b7e2d5cSGerd Hoffmann * drm_connector_attach_edid_property - attach edid property. 3936b7e2d5cSGerd Hoffmann * @connector: the connector 3946b7e2d5cSGerd Hoffmann * 3956b7e2d5cSGerd Hoffmann * Some connector types like DRM_MODE_CONNECTOR_VIRTUAL do not get a 3966b7e2d5cSGerd Hoffmann * edid property attached by default. This function can be used to 3976b7e2d5cSGerd Hoffmann * explicitly enable the edid property in these cases. 3986b7e2d5cSGerd Hoffmann */ 3996b7e2d5cSGerd Hoffmann void drm_connector_attach_edid_property(struct drm_connector *connector) 4006b7e2d5cSGerd Hoffmann { 4016b7e2d5cSGerd Hoffmann struct drm_mode_config *config = &connector->dev->mode_config; 4026b7e2d5cSGerd Hoffmann 4036b7e2d5cSGerd Hoffmann drm_object_attach_property(&connector->base, 4046b7e2d5cSGerd Hoffmann config->edid_property, 4056b7e2d5cSGerd Hoffmann 0); 4066b7e2d5cSGerd Hoffmann } 4076b7e2d5cSGerd Hoffmann EXPORT_SYMBOL(drm_connector_attach_edid_property); 4086b7e2d5cSGerd Hoffmann 4096b7e2d5cSGerd Hoffmann /** 410cde4c44dSDaniel Vetter * drm_connector_attach_encoder - attach a connector to an encoder 41152217195SDaniel Vetter * @connector: connector to attach 41252217195SDaniel Vetter * @encoder: encoder to attach @connector to 41352217195SDaniel Vetter * 41452217195SDaniel Vetter * This function links up a connector to an encoder. Note that the routing 41552217195SDaniel Vetter * restrictions between encoders and crtcs are exposed to userspace through the 41652217195SDaniel Vetter * possible_clones and possible_crtcs bitmasks. 41752217195SDaniel Vetter * 41852217195SDaniel Vetter * Returns: 41952217195SDaniel Vetter * Zero on success, negative errno on failure. 42052217195SDaniel Vetter */ 421cde4c44dSDaniel Vetter int drm_connector_attach_encoder(struct drm_connector *connector, 42252217195SDaniel Vetter struct drm_encoder *encoder) 42352217195SDaniel Vetter { 42452217195SDaniel Vetter /* 42552217195SDaniel Vetter * In the past, drivers have attempted to model the static association 42652217195SDaniel Vetter * of connector to encoder in simple connector/encoder devices using a 42752217195SDaniel Vetter * direct assignment of connector->encoder = encoder. This connection 42852217195SDaniel Vetter * is a logical one and the responsibility of the core, so drivers are 42952217195SDaniel Vetter * expected not to mess with this. 43052217195SDaniel Vetter * 43152217195SDaniel Vetter * Note that the error return should've been enough here, but a large 43252217195SDaniel Vetter * majority of drivers ignores the return value, so add in a big WARN 43352217195SDaniel Vetter * to get people's attention. 43452217195SDaniel Vetter */ 43552217195SDaniel Vetter if (WARN_ON(connector->encoder)) 43652217195SDaniel Vetter return -EINVAL; 43752217195SDaniel Vetter 43862afb4adSJosé Roberto de Souza connector->possible_encoders |= drm_encoder_mask(encoder); 43962afb4adSJosé Roberto de Souza 44052217195SDaniel Vetter return 0; 44152217195SDaniel Vetter } 442cde4c44dSDaniel Vetter EXPORT_SYMBOL(drm_connector_attach_encoder); 44352217195SDaniel Vetter 44438cb8d96SVille Syrjälä /** 44562afb4adSJosé Roberto de Souza * drm_connector_has_possible_encoder - check if the connector and encoder are 44662afb4adSJosé Roberto de Souza * associated with each other 44738cb8d96SVille Syrjälä * @connector: the connector 44838cb8d96SVille Syrjälä * @encoder: the encoder 44938cb8d96SVille Syrjälä * 45038cb8d96SVille Syrjälä * Returns: 45138cb8d96SVille Syrjälä * True if @encoder is one of the possible encoders for @connector. 45238cb8d96SVille Syrjälä */ 45338cb8d96SVille Syrjälä bool drm_connector_has_possible_encoder(struct drm_connector *connector, 45438cb8d96SVille Syrjälä struct drm_encoder *encoder) 45538cb8d96SVille Syrjälä { 45662afb4adSJosé Roberto de Souza return connector->possible_encoders & drm_encoder_mask(encoder); 45738cb8d96SVille Syrjälä } 45838cb8d96SVille Syrjälä EXPORT_SYMBOL(drm_connector_has_possible_encoder); 45938cb8d96SVille Syrjälä 46052217195SDaniel Vetter static void drm_mode_remove(struct drm_connector *connector, 46152217195SDaniel Vetter struct drm_display_mode *mode) 46252217195SDaniel Vetter { 46352217195SDaniel Vetter list_del(&mode->head); 46452217195SDaniel Vetter drm_mode_destroy(connector->dev, mode); 46552217195SDaniel Vetter } 46652217195SDaniel Vetter 46752217195SDaniel Vetter /** 46852217195SDaniel Vetter * drm_connector_cleanup - cleans up an initialised connector 46952217195SDaniel Vetter * @connector: connector to cleanup 47052217195SDaniel Vetter * 47152217195SDaniel Vetter * Cleans up the connector but doesn't free the object. 47252217195SDaniel Vetter */ 47352217195SDaniel Vetter void drm_connector_cleanup(struct drm_connector *connector) 47452217195SDaniel Vetter { 47552217195SDaniel Vetter struct drm_device *dev = connector->dev; 47652217195SDaniel Vetter struct drm_display_mode *mode, *t; 47752217195SDaniel Vetter 47852217195SDaniel Vetter /* The connector should have been removed from userspace long before 47952217195SDaniel Vetter * it is finally destroyed. 48052217195SDaniel Vetter */ 48139b50c60SLyude Paul if (WARN_ON(connector->registration_state == 48239b50c60SLyude Paul DRM_CONNECTOR_REGISTERED)) 48352217195SDaniel Vetter drm_connector_unregister(connector); 48452217195SDaniel Vetter 485334f74eeSHans de Goede if (connector->privacy_screen) { 486334f74eeSHans de Goede drm_privacy_screen_put(connector->privacy_screen); 487334f74eeSHans de Goede connector->privacy_screen = NULL; 488334f74eeSHans de Goede } 489334f74eeSHans de Goede 49052217195SDaniel Vetter if (connector->tile_group) { 49152217195SDaniel Vetter drm_mode_put_tile_group(dev, connector->tile_group); 49252217195SDaniel Vetter connector->tile_group = NULL; 49352217195SDaniel Vetter } 49452217195SDaniel Vetter 49552217195SDaniel Vetter list_for_each_entry_safe(mode, t, &connector->probed_modes, head) 49652217195SDaniel Vetter drm_mode_remove(connector, mode); 49752217195SDaniel Vetter 49852217195SDaniel Vetter list_for_each_entry_safe(mode, t, &connector->modes, head) 49952217195SDaniel Vetter drm_mode_remove(connector, mode); 50052217195SDaniel Vetter 501e5d6eeeaSBo Liu ida_free(&drm_connector_enum_list[connector->connector_type].ida, 50252217195SDaniel Vetter connector->connector_type_id); 50352217195SDaniel Vetter 504e5d6eeeaSBo Liu ida_free(&dev->mode_config.connector_ida, connector->index); 50552217195SDaniel Vetter 50652217195SDaniel Vetter kfree(connector->display_info.bus_formats); 50752217195SDaniel Vetter drm_mode_object_unregister(dev, &connector->base); 50852217195SDaniel Vetter kfree(connector->name); 50952217195SDaniel Vetter connector->name = NULL; 51048c429c6SHans de Goede fwnode_handle_put(connector->fwnode); 51148c429c6SHans de Goede connector->fwnode = NULL; 512613051daSDaniel Vetter spin_lock_irq(&dev->mode_config.connector_list_lock); 51352217195SDaniel Vetter list_del(&connector->head); 51452217195SDaniel Vetter dev->mode_config.num_connector--; 515613051daSDaniel Vetter spin_unlock_irq(&dev->mode_config.connector_list_lock); 51652217195SDaniel Vetter 51752217195SDaniel Vetter WARN_ON(connector->state && !connector->funcs->atomic_destroy_state); 51852217195SDaniel Vetter if (connector->state && connector->funcs->atomic_destroy_state) 51952217195SDaniel Vetter connector->funcs->atomic_destroy_state(connector, 52052217195SDaniel Vetter connector->state); 52152217195SDaniel Vetter 522e73ab00eSDaniel Vetter mutex_destroy(&connector->mutex); 523e73ab00eSDaniel Vetter 52452217195SDaniel Vetter memset(connector, 0, sizeof(*connector)); 52552217195SDaniel Vetter } 52652217195SDaniel Vetter EXPORT_SYMBOL(drm_connector_cleanup); 52752217195SDaniel Vetter 52852217195SDaniel Vetter /** 52952217195SDaniel Vetter * drm_connector_register - register a connector 53052217195SDaniel Vetter * @connector: the connector to register 53152217195SDaniel Vetter * 53269b22f51SDaniel Vetter * Register userspace interfaces for a connector. Only call this for connectors 53369b22f51SDaniel Vetter * which can be hotplugged after drm_dev_register() has been called already, 53469b22f51SDaniel Vetter * e.g. DP MST connectors. All other connectors will be registered automatically 53569b22f51SDaniel Vetter * when calling drm_dev_register(). 53652217195SDaniel Vetter * 537d87fbea5SMaxime Ripard * When the connector is no longer available, callers must call 538d87fbea5SMaxime Ripard * drm_connector_unregister(). 539d87fbea5SMaxime Ripard * 54052217195SDaniel Vetter * Returns: 54152217195SDaniel Vetter * Zero on success, error code on failure. 54252217195SDaniel Vetter */ 54352217195SDaniel Vetter int drm_connector_register(struct drm_connector *connector) 54452217195SDaniel Vetter { 545e73ab00eSDaniel Vetter int ret = 0; 54652217195SDaniel Vetter 547e6e7b48bSDaniel Vetter if (!connector->dev->registered) 548e6e7b48bSDaniel Vetter return 0; 549e6e7b48bSDaniel Vetter 550e73ab00eSDaniel Vetter mutex_lock(&connector->mutex); 55139b50c60SLyude Paul if (connector->registration_state != DRM_CONNECTOR_INITIALIZING) 552e73ab00eSDaniel Vetter goto unlock; 55352217195SDaniel Vetter 55452217195SDaniel Vetter ret = drm_sysfs_connector_add(connector); 55552217195SDaniel Vetter if (ret) 556e73ab00eSDaniel Vetter goto unlock; 55752217195SDaniel Vetter 558b792e640SGreg Kroah-Hartman drm_debugfs_connector_add(connector); 55952217195SDaniel Vetter 56052217195SDaniel Vetter if (connector->funcs->late_register) { 56152217195SDaniel Vetter ret = connector->funcs->late_register(connector); 56252217195SDaniel Vetter if (ret) 56352217195SDaniel Vetter goto err_debugfs; 56452217195SDaniel Vetter } 56552217195SDaniel Vetter 56652217195SDaniel Vetter drm_mode_object_register(connector->dev, &connector->base); 56752217195SDaniel Vetter 56839b50c60SLyude Paul connector->registration_state = DRM_CONNECTOR_REGISTERED; 569968d81a6SJeykumar Sankaran 570968d81a6SJeykumar Sankaran /* Let userspace know we have a new connector */ 571ad935754SSimon Ser drm_sysfs_connector_hotplug_event(connector); 572968d81a6SJeykumar Sankaran 573334f74eeSHans de Goede if (connector->privacy_screen) 574334f74eeSHans de Goede drm_privacy_screen_register_notifier(connector->privacy_screen, 575334f74eeSHans de Goede &connector->privacy_screen_notifier); 576334f74eeSHans de Goede 5773d3f7c1eSHans de Goede mutex_lock(&connector_list_lock); 5783d3f7c1eSHans de Goede list_add_tail(&connector->global_connector_list_entry, &connector_list); 5793d3f7c1eSHans de Goede mutex_unlock(&connector_list_lock); 580e73ab00eSDaniel Vetter goto unlock; 58152217195SDaniel Vetter 58252217195SDaniel Vetter err_debugfs: 58352217195SDaniel Vetter drm_debugfs_connector_remove(connector); 58452217195SDaniel Vetter drm_sysfs_connector_remove(connector); 585e73ab00eSDaniel Vetter unlock: 586e73ab00eSDaniel Vetter mutex_unlock(&connector->mutex); 58752217195SDaniel Vetter return ret; 58852217195SDaniel Vetter } 58952217195SDaniel Vetter EXPORT_SYMBOL(drm_connector_register); 59052217195SDaniel Vetter 59152217195SDaniel Vetter /** 59252217195SDaniel Vetter * drm_connector_unregister - unregister a connector 59352217195SDaniel Vetter * @connector: the connector to unregister 59452217195SDaniel Vetter * 59569b22f51SDaniel Vetter * Unregister userspace interfaces for a connector. Only call this for 596d87fbea5SMaxime Ripard * connectors which have been registered explicitly by calling 597d87fbea5SMaxime Ripard * drm_connector_register(). 59852217195SDaniel Vetter */ 59952217195SDaniel Vetter void drm_connector_unregister(struct drm_connector *connector) 60052217195SDaniel Vetter { 601e73ab00eSDaniel Vetter mutex_lock(&connector->mutex); 60239b50c60SLyude Paul if (connector->registration_state != DRM_CONNECTOR_REGISTERED) { 603e73ab00eSDaniel Vetter mutex_unlock(&connector->mutex); 60452217195SDaniel Vetter return; 605e73ab00eSDaniel Vetter } 60652217195SDaniel Vetter 6073d3f7c1eSHans de Goede mutex_lock(&connector_list_lock); 6083d3f7c1eSHans de Goede list_del_init(&connector->global_connector_list_entry); 6093d3f7c1eSHans de Goede mutex_unlock(&connector_list_lock); 6103d3f7c1eSHans de Goede 611334f74eeSHans de Goede if (connector->privacy_screen) 612334f74eeSHans de Goede drm_privacy_screen_unregister_notifier( 613334f74eeSHans de Goede connector->privacy_screen, 614334f74eeSHans de Goede &connector->privacy_screen_notifier); 615334f74eeSHans de Goede 61652217195SDaniel Vetter if (connector->funcs->early_unregister) 61752217195SDaniel Vetter connector->funcs->early_unregister(connector); 61852217195SDaniel Vetter 61952217195SDaniel Vetter drm_sysfs_connector_remove(connector); 62052217195SDaniel Vetter drm_debugfs_connector_remove(connector); 62152217195SDaniel Vetter 62239b50c60SLyude Paul connector->registration_state = DRM_CONNECTOR_UNREGISTERED; 623e73ab00eSDaniel Vetter mutex_unlock(&connector->mutex); 62452217195SDaniel Vetter } 62552217195SDaniel Vetter EXPORT_SYMBOL(drm_connector_unregister); 62652217195SDaniel Vetter 62752217195SDaniel Vetter void drm_connector_unregister_all(struct drm_device *dev) 62852217195SDaniel Vetter { 62952217195SDaniel Vetter struct drm_connector *connector; 630613051daSDaniel Vetter struct drm_connector_list_iter conn_iter; 63152217195SDaniel Vetter 632b982dab1SThierry Reding drm_connector_list_iter_begin(dev, &conn_iter); 633613051daSDaniel Vetter drm_for_each_connector_iter(connector, &conn_iter) 63452217195SDaniel Vetter drm_connector_unregister(connector); 635b982dab1SThierry Reding drm_connector_list_iter_end(&conn_iter); 63652217195SDaniel Vetter } 63752217195SDaniel Vetter 63852217195SDaniel Vetter int drm_connector_register_all(struct drm_device *dev) 63952217195SDaniel Vetter { 64052217195SDaniel Vetter struct drm_connector *connector; 641613051daSDaniel Vetter struct drm_connector_list_iter conn_iter; 642613051daSDaniel Vetter int ret = 0; 64352217195SDaniel Vetter 644b982dab1SThierry Reding drm_connector_list_iter_begin(dev, &conn_iter); 645613051daSDaniel Vetter drm_for_each_connector_iter(connector, &conn_iter) { 64652217195SDaniel Vetter ret = drm_connector_register(connector); 64752217195SDaniel Vetter if (ret) 648613051daSDaniel Vetter break; 64952217195SDaniel Vetter } 650b982dab1SThierry Reding drm_connector_list_iter_end(&conn_iter); 65152217195SDaniel Vetter 652613051daSDaniel Vetter if (ret) 65352217195SDaniel Vetter drm_connector_unregister_all(dev); 65452217195SDaniel Vetter return ret; 65552217195SDaniel Vetter } 65652217195SDaniel Vetter 65752217195SDaniel Vetter /** 65852217195SDaniel Vetter * drm_get_connector_status_name - return a string for connector status 65952217195SDaniel Vetter * @status: connector status to compute name of 66052217195SDaniel Vetter * 66152217195SDaniel Vetter * In contrast to the other drm_get_*_name functions this one here returns a 66252217195SDaniel Vetter * const pointer and hence is threadsafe. 663f85d9e59SRandy Dunlap * 664f85d9e59SRandy Dunlap * Returns: connector status string 66552217195SDaniel Vetter */ 66652217195SDaniel Vetter const char *drm_get_connector_status_name(enum drm_connector_status status) 66752217195SDaniel Vetter { 66852217195SDaniel Vetter if (status == connector_status_connected) 66952217195SDaniel Vetter return "connected"; 67052217195SDaniel Vetter else if (status == connector_status_disconnected) 67152217195SDaniel Vetter return "disconnected"; 67252217195SDaniel Vetter else 67352217195SDaniel Vetter return "unknown"; 67452217195SDaniel Vetter } 67552217195SDaniel Vetter EXPORT_SYMBOL(drm_get_connector_status_name); 67652217195SDaniel Vetter 6776140cf20SJani Nikula /** 6786140cf20SJani Nikula * drm_get_connector_force_name - return a string for connector force 6796140cf20SJani Nikula * @force: connector force to get name of 6806140cf20SJani Nikula * 6816140cf20SJani Nikula * Returns: const pointer to name. 6826140cf20SJani Nikula */ 6836140cf20SJani Nikula const char *drm_get_connector_force_name(enum drm_connector_force force) 6846140cf20SJani Nikula { 6856140cf20SJani Nikula switch (force) { 6866140cf20SJani Nikula case DRM_FORCE_UNSPECIFIED: 6876140cf20SJani Nikula return "unspecified"; 6886140cf20SJani Nikula case DRM_FORCE_OFF: 6896140cf20SJani Nikula return "off"; 6906140cf20SJani Nikula case DRM_FORCE_ON: 6916140cf20SJani Nikula return "on"; 6926140cf20SJani Nikula case DRM_FORCE_ON_DIGITAL: 6936140cf20SJani Nikula return "digital"; 6946140cf20SJani Nikula default: 6956140cf20SJani Nikula return "unknown"; 6966140cf20SJani Nikula } 6976140cf20SJani Nikula } 6986140cf20SJani Nikula 699613051daSDaniel Vetter #ifdef CONFIG_LOCKDEP 700613051daSDaniel Vetter static struct lockdep_map connector_list_iter_dep_map = { 701613051daSDaniel Vetter .name = "drm_connector_list_iter" 702613051daSDaniel Vetter }; 703613051daSDaniel Vetter #endif 704613051daSDaniel Vetter 705613051daSDaniel Vetter /** 706b982dab1SThierry Reding * drm_connector_list_iter_begin - initialize a connector_list iterator 707613051daSDaniel Vetter * @dev: DRM device 708613051daSDaniel Vetter * @iter: connector_list iterator 709613051daSDaniel Vetter * 710d574528aSDaniel Vetter * Sets @iter up to walk the &drm_mode_config.connector_list of @dev. @iter 711b982dab1SThierry Reding * must always be cleaned up again by calling drm_connector_list_iter_end(). 712613051daSDaniel Vetter * Iteration itself happens using drm_connector_list_iter_next() or 713613051daSDaniel Vetter * drm_for_each_connector_iter(). 714613051daSDaniel Vetter */ 715b982dab1SThierry Reding void drm_connector_list_iter_begin(struct drm_device *dev, 716613051daSDaniel Vetter struct drm_connector_list_iter *iter) 717613051daSDaniel Vetter { 718613051daSDaniel Vetter iter->dev = dev; 719613051daSDaniel Vetter iter->conn = NULL; 720613051daSDaniel Vetter lock_acquire_shared_recursive(&connector_list_iter_dep_map, 0, 1, NULL, _RET_IP_); 721613051daSDaniel Vetter } 722b982dab1SThierry Reding EXPORT_SYMBOL(drm_connector_list_iter_begin); 723613051daSDaniel Vetter 724a703c550SDaniel Vetter /* 725a703c550SDaniel Vetter * Extra-safe connector put function that works in any context. Should only be 726a703c550SDaniel Vetter * used from the connector_iter functions, where we never really expect to 727a703c550SDaniel Vetter * actually release the connector when dropping our final reference. 728a703c550SDaniel Vetter */ 729a703c550SDaniel Vetter static void 730ea497bb9SDaniel Vetter __drm_connector_put_safe(struct drm_connector *conn) 731a703c550SDaniel Vetter { 732ea497bb9SDaniel Vetter struct drm_mode_config *config = &conn->dev->mode_config; 733ea497bb9SDaniel Vetter 734ea497bb9SDaniel Vetter lockdep_assert_held(&config->connector_list_lock); 735ea497bb9SDaniel Vetter 736ea497bb9SDaniel Vetter if (!refcount_dec_and_test(&conn->base.refcount.refcount)) 737ea497bb9SDaniel Vetter return; 738ea497bb9SDaniel Vetter 739ea497bb9SDaniel Vetter llist_add(&conn->free_node, &config->connector_free_list); 740ea497bb9SDaniel Vetter schedule_work(&config->connector_free_work); 741a703c550SDaniel Vetter } 742a703c550SDaniel Vetter 743613051daSDaniel Vetter /** 744613051daSDaniel Vetter * drm_connector_list_iter_next - return next connector 7454f45c778SLyude Paul * @iter: connector_list iterator 746613051daSDaniel Vetter * 747f85d9e59SRandy Dunlap * Returns: the next connector for @iter, or NULL when the list walk has 748613051daSDaniel Vetter * completed. 749613051daSDaniel Vetter */ 750613051daSDaniel Vetter struct drm_connector * 751613051daSDaniel Vetter drm_connector_list_iter_next(struct drm_connector_list_iter *iter) 752613051daSDaniel Vetter { 753613051daSDaniel Vetter struct drm_connector *old_conn = iter->conn; 754613051daSDaniel Vetter struct drm_mode_config *config = &iter->dev->mode_config; 755613051daSDaniel Vetter struct list_head *lhead; 756613051daSDaniel Vetter unsigned long flags; 757613051daSDaniel Vetter 758613051daSDaniel Vetter spin_lock_irqsave(&config->connector_list_lock, flags); 759613051daSDaniel Vetter lhead = old_conn ? &old_conn->head : &config->connector_list; 760613051daSDaniel Vetter 761613051daSDaniel Vetter do { 762613051daSDaniel Vetter if (lhead->next == &config->connector_list) { 763613051daSDaniel Vetter iter->conn = NULL; 764613051daSDaniel Vetter break; 765613051daSDaniel Vetter } 766613051daSDaniel Vetter 767613051daSDaniel Vetter lhead = lhead->next; 768613051daSDaniel Vetter iter->conn = list_entry(lhead, struct drm_connector, head); 769613051daSDaniel Vetter 770613051daSDaniel Vetter /* loop until it's not a zombie connector */ 771613051daSDaniel Vetter } while (!kref_get_unless_zero(&iter->conn->base.refcount)); 772613051daSDaniel Vetter 773613051daSDaniel Vetter if (old_conn) 774ea497bb9SDaniel Vetter __drm_connector_put_safe(old_conn); 775ea497bb9SDaniel Vetter spin_unlock_irqrestore(&config->connector_list_lock, flags); 776613051daSDaniel Vetter 777613051daSDaniel Vetter return iter->conn; 778613051daSDaniel Vetter } 779613051daSDaniel Vetter EXPORT_SYMBOL(drm_connector_list_iter_next); 780613051daSDaniel Vetter 781613051daSDaniel Vetter /** 782b982dab1SThierry Reding * drm_connector_list_iter_end - tear down a connector_list iterator 783613051daSDaniel Vetter * @iter: connector_list iterator 784613051daSDaniel Vetter * 785613051daSDaniel Vetter * Tears down @iter and releases any resources (like &drm_connector references) 786613051daSDaniel Vetter * acquired while walking the list. This must always be called, both when the 787613051daSDaniel Vetter * iteration completes fully or when it was aborted without walking the entire 788613051daSDaniel Vetter * list. 789613051daSDaniel Vetter */ 790b982dab1SThierry Reding void drm_connector_list_iter_end(struct drm_connector_list_iter *iter) 791613051daSDaniel Vetter { 792ea497bb9SDaniel Vetter struct drm_mode_config *config = &iter->dev->mode_config; 793ea497bb9SDaniel Vetter unsigned long flags; 794ea497bb9SDaniel Vetter 795613051daSDaniel Vetter iter->dev = NULL; 796ea497bb9SDaniel Vetter if (iter->conn) { 797ea497bb9SDaniel Vetter spin_lock_irqsave(&config->connector_list_lock, flags); 798ea497bb9SDaniel Vetter __drm_connector_put_safe(iter->conn); 799ea497bb9SDaniel Vetter spin_unlock_irqrestore(&config->connector_list_lock, flags); 800ea497bb9SDaniel Vetter } 8015facae4fSQian Cai lock_release(&connector_list_iter_dep_map, _RET_IP_); 802613051daSDaniel Vetter } 803b982dab1SThierry Reding EXPORT_SYMBOL(drm_connector_list_iter_end); 804613051daSDaniel Vetter 80552217195SDaniel Vetter static const struct drm_prop_enum_list drm_subpixel_enum_list[] = { 80652217195SDaniel Vetter { SubPixelUnknown, "Unknown" }, 80752217195SDaniel Vetter { SubPixelHorizontalRGB, "Horizontal RGB" }, 80852217195SDaniel Vetter { SubPixelHorizontalBGR, "Horizontal BGR" }, 80952217195SDaniel Vetter { SubPixelVerticalRGB, "Vertical RGB" }, 81052217195SDaniel Vetter { SubPixelVerticalBGR, "Vertical BGR" }, 81152217195SDaniel Vetter { SubPixelNone, "None" }, 81252217195SDaniel Vetter }; 81352217195SDaniel Vetter 81452217195SDaniel Vetter /** 81552217195SDaniel Vetter * drm_get_subpixel_order_name - return a string for a given subpixel enum 81652217195SDaniel Vetter * @order: enum of subpixel_order 81752217195SDaniel Vetter * 81852217195SDaniel Vetter * Note you could abuse this and return something out of bounds, but that 81952217195SDaniel Vetter * would be a caller error. No unscrubbed user data should make it here. 820f85d9e59SRandy Dunlap * 821f85d9e59SRandy Dunlap * Returns: string describing an enumerated subpixel property 82252217195SDaniel Vetter */ 82352217195SDaniel Vetter const char *drm_get_subpixel_order_name(enum subpixel_order order) 82452217195SDaniel Vetter { 82552217195SDaniel Vetter return drm_subpixel_enum_list[order].name; 82652217195SDaniel Vetter } 82752217195SDaniel Vetter EXPORT_SYMBOL(drm_get_subpixel_order_name); 82852217195SDaniel Vetter 82952217195SDaniel Vetter static const struct drm_prop_enum_list drm_dpms_enum_list[] = { 83052217195SDaniel Vetter { DRM_MODE_DPMS_ON, "On" }, 83152217195SDaniel Vetter { DRM_MODE_DPMS_STANDBY, "Standby" }, 83252217195SDaniel Vetter { DRM_MODE_DPMS_SUSPEND, "Suspend" }, 83352217195SDaniel Vetter { DRM_MODE_DPMS_OFF, "Off" } 83452217195SDaniel Vetter }; 83552217195SDaniel Vetter DRM_ENUM_NAME_FN(drm_get_dpms_name, drm_dpms_enum_list) 83652217195SDaniel Vetter 83740ee6fbeSManasi Navare static const struct drm_prop_enum_list drm_link_status_enum_list[] = { 83840ee6fbeSManasi Navare { DRM_MODE_LINK_STATUS_GOOD, "Good" }, 83940ee6fbeSManasi Navare { DRM_MODE_LINK_STATUS_BAD, "Bad" }, 84040ee6fbeSManasi Navare }; 84140ee6fbeSManasi Navare 842b3c6c8bfSDaniel Vetter /** 843b3c6c8bfSDaniel Vetter * drm_display_info_set_bus_formats - set the supported bus formats 844b3c6c8bfSDaniel Vetter * @info: display info to store bus formats in 845b3c6c8bfSDaniel Vetter * @formats: array containing the supported bus formats 846b3c6c8bfSDaniel Vetter * @num_formats: the number of entries in the fmts array 847b3c6c8bfSDaniel Vetter * 848b3c6c8bfSDaniel Vetter * Store the supported bus formats in display info structure. 849b3c6c8bfSDaniel Vetter * See MEDIA_BUS_FMT_* definitions in include/uapi/linux/media-bus-format.h for 850b3c6c8bfSDaniel Vetter * a full list of available formats. 851f85d9e59SRandy Dunlap * 852f85d9e59SRandy Dunlap * Returns: 853f85d9e59SRandy Dunlap * 0 on success or a negative error code on failure. 854b3c6c8bfSDaniel Vetter */ 855b3c6c8bfSDaniel Vetter int drm_display_info_set_bus_formats(struct drm_display_info *info, 856b3c6c8bfSDaniel Vetter const u32 *formats, 857b3c6c8bfSDaniel Vetter unsigned int num_formats) 858b3c6c8bfSDaniel Vetter { 859b3c6c8bfSDaniel Vetter u32 *fmts = NULL; 860b3c6c8bfSDaniel Vetter 861b3c6c8bfSDaniel Vetter if (!formats && num_formats) 862b3c6c8bfSDaniel Vetter return -EINVAL; 863b3c6c8bfSDaniel Vetter 864b3c6c8bfSDaniel Vetter if (formats && num_formats) { 865b3c6c8bfSDaniel Vetter fmts = kmemdup(formats, sizeof(*formats) * num_formats, 866b3c6c8bfSDaniel Vetter GFP_KERNEL); 867b3c6c8bfSDaniel Vetter if (!fmts) 868b3c6c8bfSDaniel Vetter return -ENOMEM; 869b3c6c8bfSDaniel Vetter } 870b3c6c8bfSDaniel Vetter 871b3c6c8bfSDaniel Vetter kfree(info->bus_formats); 872b3c6c8bfSDaniel Vetter info->bus_formats = fmts; 873b3c6c8bfSDaniel Vetter info->num_bus_formats = num_formats; 874b3c6c8bfSDaniel Vetter 875b3c6c8bfSDaniel Vetter return 0; 876b3c6c8bfSDaniel Vetter } 877b3c6c8bfSDaniel Vetter EXPORT_SYMBOL(drm_display_info_set_bus_formats); 878b3c6c8bfSDaniel Vetter 87952217195SDaniel Vetter /* Optional connector properties. */ 88052217195SDaniel Vetter static const struct drm_prop_enum_list drm_scaling_mode_enum_list[] = { 88152217195SDaniel Vetter { DRM_MODE_SCALE_NONE, "None" }, 88252217195SDaniel Vetter { DRM_MODE_SCALE_FULLSCREEN, "Full" }, 88352217195SDaniel Vetter { DRM_MODE_SCALE_CENTER, "Center" }, 88452217195SDaniel Vetter { DRM_MODE_SCALE_ASPECT, "Full aspect" }, 88552217195SDaniel Vetter }; 88652217195SDaniel Vetter 88752217195SDaniel Vetter static const struct drm_prop_enum_list drm_aspect_ratio_enum_list[] = { 88852217195SDaniel Vetter { DRM_MODE_PICTURE_ASPECT_NONE, "Automatic" }, 88952217195SDaniel Vetter { DRM_MODE_PICTURE_ASPECT_4_3, "4:3" }, 89052217195SDaniel Vetter { DRM_MODE_PICTURE_ASPECT_16_9, "16:9" }, 89152217195SDaniel Vetter }; 89252217195SDaniel Vetter 89350525c33SStanislav Lisovskiy static const struct drm_prop_enum_list drm_content_type_enum_list[] = { 89450525c33SStanislav Lisovskiy { DRM_MODE_CONTENT_TYPE_NO_DATA, "No Data" }, 89550525c33SStanislav Lisovskiy { DRM_MODE_CONTENT_TYPE_GRAPHICS, "Graphics" }, 89650525c33SStanislav Lisovskiy { DRM_MODE_CONTENT_TYPE_PHOTO, "Photo" }, 89750525c33SStanislav Lisovskiy { DRM_MODE_CONTENT_TYPE_CINEMA, "Cinema" }, 89850525c33SStanislav Lisovskiy { DRM_MODE_CONTENT_TYPE_GAME, "Game" }, 89950525c33SStanislav Lisovskiy }; 90050525c33SStanislav Lisovskiy 9018d70f395SHans de Goede static const struct drm_prop_enum_list drm_panel_orientation_enum_list[] = { 9028d70f395SHans de Goede { DRM_MODE_PANEL_ORIENTATION_NORMAL, "Normal" }, 9038d70f395SHans de Goede { DRM_MODE_PANEL_ORIENTATION_BOTTOM_UP, "Upside Down" }, 9048d70f395SHans de Goede { DRM_MODE_PANEL_ORIENTATION_LEFT_UP, "Left Side Up" }, 9058d70f395SHans de Goede { DRM_MODE_PANEL_ORIENTATION_RIGHT_UP, "Right Side Up" }, 9068d70f395SHans de Goede }; 9078d70f395SHans de Goede 90852217195SDaniel Vetter static const struct drm_prop_enum_list drm_dvi_i_select_enum_list[] = { 90952217195SDaniel Vetter { DRM_MODE_SUBCONNECTOR_Automatic, "Automatic" }, /* DVI-I and TV-out */ 91052217195SDaniel Vetter { DRM_MODE_SUBCONNECTOR_DVID, "DVI-D" }, /* DVI-I */ 91152217195SDaniel Vetter { DRM_MODE_SUBCONNECTOR_DVIA, "DVI-A" }, /* DVI-I */ 91252217195SDaniel Vetter }; 91352217195SDaniel Vetter DRM_ENUM_NAME_FN(drm_get_dvi_i_select_name, drm_dvi_i_select_enum_list) 91452217195SDaniel Vetter 91552217195SDaniel Vetter static const struct drm_prop_enum_list drm_dvi_i_subconnector_enum_list[] = { 916e5b92773SOleg Vasilev { DRM_MODE_SUBCONNECTOR_Unknown, "Unknown" }, /* DVI-I, TV-out and DP */ 91752217195SDaniel Vetter { DRM_MODE_SUBCONNECTOR_DVID, "DVI-D" }, /* DVI-I */ 91852217195SDaniel Vetter { DRM_MODE_SUBCONNECTOR_DVIA, "DVI-A" }, /* DVI-I */ 91952217195SDaniel Vetter }; 92052217195SDaniel Vetter DRM_ENUM_NAME_FN(drm_get_dvi_i_subconnector_name, 92152217195SDaniel Vetter drm_dvi_i_subconnector_enum_list) 92252217195SDaniel Vetter 92352217195SDaniel Vetter static const struct drm_prop_enum_list drm_tv_select_enum_list[] = { 92452217195SDaniel Vetter { DRM_MODE_SUBCONNECTOR_Automatic, "Automatic" }, /* DVI-I and TV-out */ 92552217195SDaniel Vetter { DRM_MODE_SUBCONNECTOR_Composite, "Composite" }, /* TV-out */ 92652217195SDaniel Vetter { DRM_MODE_SUBCONNECTOR_SVIDEO, "SVIDEO" }, /* TV-out */ 92752217195SDaniel Vetter { DRM_MODE_SUBCONNECTOR_Component, "Component" }, /* TV-out */ 92852217195SDaniel Vetter { DRM_MODE_SUBCONNECTOR_SCART, "SCART" }, /* TV-out */ 92952217195SDaniel Vetter }; 93052217195SDaniel Vetter DRM_ENUM_NAME_FN(drm_get_tv_select_name, drm_tv_select_enum_list) 93152217195SDaniel Vetter 93252217195SDaniel Vetter static const struct drm_prop_enum_list drm_tv_subconnector_enum_list[] = { 933e5b92773SOleg Vasilev { DRM_MODE_SUBCONNECTOR_Unknown, "Unknown" }, /* DVI-I, TV-out and DP */ 93452217195SDaniel Vetter { DRM_MODE_SUBCONNECTOR_Composite, "Composite" }, /* TV-out */ 93552217195SDaniel Vetter { DRM_MODE_SUBCONNECTOR_SVIDEO, "SVIDEO" }, /* TV-out */ 93652217195SDaniel Vetter { DRM_MODE_SUBCONNECTOR_Component, "Component" }, /* TV-out */ 93752217195SDaniel Vetter { DRM_MODE_SUBCONNECTOR_SCART, "SCART" }, /* TV-out */ 93852217195SDaniel Vetter }; 93952217195SDaniel Vetter DRM_ENUM_NAME_FN(drm_get_tv_subconnector_name, 94052217195SDaniel Vetter drm_tv_subconnector_enum_list) 94152217195SDaniel Vetter 942e5b92773SOleg Vasilev static const struct drm_prop_enum_list drm_dp_subconnector_enum_list[] = { 943e5b92773SOleg Vasilev { DRM_MODE_SUBCONNECTOR_Unknown, "Unknown" }, /* DVI-I, TV-out and DP */ 944e5b92773SOleg Vasilev { DRM_MODE_SUBCONNECTOR_VGA, "VGA" }, /* DP */ 945e5b92773SOleg Vasilev { DRM_MODE_SUBCONNECTOR_DVID, "DVI-D" }, /* DP */ 946e5b92773SOleg Vasilev { DRM_MODE_SUBCONNECTOR_HDMIA, "HDMI" }, /* DP */ 947e5b92773SOleg Vasilev { DRM_MODE_SUBCONNECTOR_DisplayPort, "DP" }, /* DP */ 948e5b92773SOleg Vasilev { DRM_MODE_SUBCONNECTOR_Wireless, "Wireless" }, /* DP */ 949e5b92773SOleg Vasilev { DRM_MODE_SUBCONNECTOR_Native, "Native" }, /* DP */ 950e5b92773SOleg Vasilev }; 951e5b92773SOleg Vasilev 952e5b92773SOleg Vasilev DRM_ENUM_NAME_FN(drm_get_dp_subconnector_name, 953e5b92773SOleg Vasilev drm_dp_subconnector_enum_list) 954e5b92773SOleg Vasilev 955d2c6a405SUma Shankar static const struct drm_prop_enum_list hdmi_colorspaces[] = { 956d2c6a405SUma Shankar /* For Default case, driver will set the colorspace */ 957d2c6a405SUma Shankar { DRM_MODE_COLORIMETRY_DEFAULT, "Default" }, 958d2c6a405SUma Shankar /* Standard Definition Colorimetry based on CEA 861 */ 959d2c6a405SUma Shankar { DRM_MODE_COLORIMETRY_SMPTE_170M_YCC, "SMPTE_170M_YCC" }, 960d2c6a405SUma Shankar { DRM_MODE_COLORIMETRY_BT709_YCC, "BT709_YCC" }, 961d2c6a405SUma Shankar /* Standard Definition Colorimetry based on IEC 61966-2-4 */ 962d2c6a405SUma Shankar { DRM_MODE_COLORIMETRY_XVYCC_601, "XVYCC_601" }, 963d2c6a405SUma Shankar /* High Definition Colorimetry based on IEC 61966-2-4 */ 964d2c6a405SUma Shankar { DRM_MODE_COLORIMETRY_XVYCC_709, "XVYCC_709" }, 965d2c6a405SUma Shankar /* Colorimetry based on IEC 61966-2-1/Amendment 1 */ 966d2c6a405SUma Shankar { DRM_MODE_COLORIMETRY_SYCC_601, "SYCC_601" }, 967d2c6a405SUma Shankar /* Colorimetry based on IEC 61966-2-5 [33] */ 968d2c6a405SUma Shankar { DRM_MODE_COLORIMETRY_OPYCC_601, "opYCC_601" }, 969d2c6a405SUma Shankar /* Colorimetry based on IEC 61966-2-5 */ 970d2c6a405SUma Shankar { DRM_MODE_COLORIMETRY_OPRGB, "opRGB" }, 971d2c6a405SUma Shankar /* Colorimetry based on ITU-R BT.2020 */ 972d2c6a405SUma Shankar { DRM_MODE_COLORIMETRY_BT2020_CYCC, "BT2020_CYCC" }, 973d2c6a405SUma Shankar /* Colorimetry based on ITU-R BT.2020 */ 974d2c6a405SUma Shankar { DRM_MODE_COLORIMETRY_BT2020_RGB, "BT2020_RGB" }, 975d2c6a405SUma Shankar /* Colorimetry based on ITU-R BT.2020 */ 976d2c6a405SUma Shankar { DRM_MODE_COLORIMETRY_BT2020_YCC, "BT2020_YCC" }, 977d2c6a405SUma Shankar /* Added as part of Additional Colorimetry Extension in 861.G */ 978d2c6a405SUma Shankar { DRM_MODE_COLORIMETRY_DCI_P3_RGB_D65, "DCI-P3_RGB_D65" }, 979d2c6a405SUma Shankar { DRM_MODE_COLORIMETRY_DCI_P3_RGB_THEATER, "DCI-P3_RGB_Theater" }, 980d2c6a405SUma Shankar }; 981d2c6a405SUma Shankar 98245cf0e91SGwan-gyeong Mun /* 98345cf0e91SGwan-gyeong Mun * As per DP 1.4a spec, 2.2.5.7.5 VSC SDP Payload for Pixel Encoding/Colorimetry 98445cf0e91SGwan-gyeong Mun * Format Table 2-120 98545cf0e91SGwan-gyeong Mun */ 98645cf0e91SGwan-gyeong Mun static const struct drm_prop_enum_list dp_colorspaces[] = { 98745cf0e91SGwan-gyeong Mun /* For Default case, driver will set the colorspace */ 98845cf0e91SGwan-gyeong Mun { DRM_MODE_COLORIMETRY_DEFAULT, "Default" }, 98945cf0e91SGwan-gyeong Mun { DRM_MODE_COLORIMETRY_RGB_WIDE_FIXED, "RGB_Wide_Gamut_Fixed_Point" }, 99045cf0e91SGwan-gyeong Mun /* Colorimetry based on scRGB (IEC 61966-2-2) */ 99145cf0e91SGwan-gyeong Mun { DRM_MODE_COLORIMETRY_RGB_WIDE_FLOAT, "RGB_Wide_Gamut_Floating_Point" }, 99245cf0e91SGwan-gyeong Mun /* Colorimetry based on IEC 61966-2-5 */ 99345cf0e91SGwan-gyeong Mun { DRM_MODE_COLORIMETRY_OPRGB, "opRGB" }, 99445cf0e91SGwan-gyeong Mun /* Colorimetry based on SMPTE RP 431-2 */ 99545cf0e91SGwan-gyeong Mun { DRM_MODE_COLORIMETRY_DCI_P3_RGB_D65, "DCI-P3_RGB_D65" }, 99645cf0e91SGwan-gyeong Mun /* Colorimetry based on ITU-R BT.2020 */ 99745cf0e91SGwan-gyeong Mun { DRM_MODE_COLORIMETRY_BT2020_RGB, "BT2020_RGB" }, 99845cf0e91SGwan-gyeong Mun { DRM_MODE_COLORIMETRY_BT601_YCC, "BT601_YCC" }, 99945cf0e91SGwan-gyeong Mun { DRM_MODE_COLORIMETRY_BT709_YCC, "BT709_YCC" }, 100045cf0e91SGwan-gyeong Mun /* Standard Definition Colorimetry based on IEC 61966-2-4 */ 100145cf0e91SGwan-gyeong Mun { DRM_MODE_COLORIMETRY_XVYCC_601, "XVYCC_601" }, 100245cf0e91SGwan-gyeong Mun /* High Definition Colorimetry based on IEC 61966-2-4 */ 100345cf0e91SGwan-gyeong Mun { DRM_MODE_COLORIMETRY_XVYCC_709, "XVYCC_709" }, 100445cf0e91SGwan-gyeong Mun /* Colorimetry based on IEC 61966-2-1/Amendment 1 */ 100545cf0e91SGwan-gyeong Mun { DRM_MODE_COLORIMETRY_SYCC_601, "SYCC_601" }, 100645cf0e91SGwan-gyeong Mun /* Colorimetry based on IEC 61966-2-5 [33] */ 100745cf0e91SGwan-gyeong Mun { DRM_MODE_COLORIMETRY_OPYCC_601, "opYCC_601" }, 100845cf0e91SGwan-gyeong Mun /* Colorimetry based on ITU-R BT.2020 */ 100945cf0e91SGwan-gyeong Mun { DRM_MODE_COLORIMETRY_BT2020_CYCC, "BT2020_CYCC" }, 101045cf0e91SGwan-gyeong Mun /* Colorimetry based on ITU-R BT.2020 */ 101145cf0e91SGwan-gyeong Mun { DRM_MODE_COLORIMETRY_BT2020_YCC, "BT2020_YCC" }, 101245cf0e91SGwan-gyeong Mun }; 101345cf0e91SGwan-gyeong Mun 10144ada6f22SDaniel Vetter /** 10154ada6f22SDaniel Vetter * DOC: standard connector properties 10164ada6f22SDaniel Vetter * 10174ada6f22SDaniel Vetter * DRM connectors have a few standardized properties: 10184ada6f22SDaniel Vetter * 10194ada6f22SDaniel Vetter * EDID: 10204ada6f22SDaniel Vetter * Blob property which contains the current EDID read from the sink. This 10214ada6f22SDaniel Vetter * is useful to parse sink identification information like vendor, model 10224ada6f22SDaniel Vetter * and serial. Drivers should update this property by calling 1023c555f023SDaniel Vetter * drm_connector_update_edid_property(), usually after having parsed 10244ada6f22SDaniel Vetter * the EDID using drm_add_edid_modes(). Userspace cannot change this 10254ada6f22SDaniel Vetter * property. 102612767469SSimon Ser * 102712767469SSimon Ser * User-space should not parse the EDID to obtain information exposed via 102812767469SSimon Ser * other KMS properties (because the kernel might apply limits, quirks or 102912767469SSimon Ser * fixups to the EDID). For instance, user-space should not try to parse 103012767469SSimon Ser * mode lists from the EDID. 10314ada6f22SDaniel Vetter * DPMS: 10324ada6f22SDaniel Vetter * Legacy property for setting the power state of the connector. For atomic 10334ada6f22SDaniel Vetter * drivers this is only provided for backwards compatibility with existing 10344ada6f22SDaniel Vetter * drivers, it remaps to controlling the "ACTIVE" property on the CRTC the 10354ada6f22SDaniel Vetter * connector is linked to. Drivers should never set this property directly, 1036d574528aSDaniel Vetter * it is handled by the DRM core by calling the &drm_connector_funcs.dpms 1037144a7999SDaniel Vetter * callback. For atomic drivers the remapping to the "ACTIVE" property is 10381e3e4caeSSimon Ser * implemented in the DRM core. 1039d0d1aee5SDaniel Vetter * 1040d0d1aee5SDaniel Vetter * Note that this property cannot be set through the MODE_ATOMIC ioctl, 1041d0d1aee5SDaniel Vetter * userspace must use "ACTIVE" on the CRTC instead. 1042d0d1aee5SDaniel Vetter * 1043d0d1aee5SDaniel Vetter * WARNING: 1044d0d1aee5SDaniel Vetter * 1045d0d1aee5SDaniel Vetter * For userspace also running on legacy drivers the "DPMS" semantics are a 1046d0d1aee5SDaniel Vetter * lot more complicated. First, userspace cannot rely on the "DPMS" value 1047d0d1aee5SDaniel Vetter * returned by the GETCONNECTOR actually reflecting reality, because many 1048d0d1aee5SDaniel Vetter * drivers fail to update it. For atomic drivers this is taken care of in 1049d0d1aee5SDaniel Vetter * drm_atomic_helper_update_legacy_modeset_state(). 1050d0d1aee5SDaniel Vetter * 1051d0d1aee5SDaniel Vetter * The second issue is that the DPMS state is only well-defined when the 1052d0d1aee5SDaniel Vetter * connector is connected to a CRTC. In atomic the DRM core enforces that 1053d0d1aee5SDaniel Vetter * "ACTIVE" is off in such a case, no such checks exists for "DPMS". 1054d0d1aee5SDaniel Vetter * 1055d0d1aee5SDaniel Vetter * Finally, when enabling an output using the legacy SETCONFIG ioctl then 1056d0d1aee5SDaniel Vetter * "DPMS" is forced to ON. But see above, that might not be reflected in 1057d0d1aee5SDaniel Vetter * the software value on legacy drivers. 1058d0d1aee5SDaniel Vetter * 1059d0d1aee5SDaniel Vetter * Summarizing: Only set "DPMS" when the connector is known to be enabled, 1060d0d1aee5SDaniel Vetter * assume that a successful SETCONFIG call also sets "DPMS" to on, and 1061d0d1aee5SDaniel Vetter * never read back the value of "DPMS" because it can be incorrect. 10624ada6f22SDaniel Vetter * PATH: 10634ada6f22SDaniel Vetter * Connector path property to identify how this sink is physically 10644ada6f22SDaniel Vetter * connected. Used by DP MST. This should be set by calling 106597e14fbeSDaniel Vetter * drm_connector_set_path_property(), in the case of DP MST with the 10664ada6f22SDaniel Vetter * path property the MST manager created. Userspace cannot change this 10674ada6f22SDaniel Vetter * property. 10684ada6f22SDaniel Vetter * TILE: 10694ada6f22SDaniel Vetter * Connector tile group property to indicate how a set of DRM connector 10704ada6f22SDaniel Vetter * compose together into one logical screen. This is used by both high-res 10714ada6f22SDaniel Vetter * external screens (often only using a single cable, but exposing multiple 10724ada6f22SDaniel Vetter * DP MST sinks), or high-res integrated panels (like dual-link DSI) which 10734ada6f22SDaniel Vetter * are not gen-locked. Note that for tiled panels which are genlocked, like 10744ada6f22SDaniel Vetter * dual-link LVDS or dual-link DSI, the driver should try to not expose the 107584e543bcSAntonio Borneo * tiling and virtualise both &drm_crtc and &drm_plane if needed. Drivers 107697e14fbeSDaniel Vetter * should update this value using drm_connector_set_tile_property(). 10774ada6f22SDaniel Vetter * Userspace cannot change this property. 107840ee6fbeSManasi Navare * link-status: 1079716719a3SSean Paul * Connector link-status property to indicate the status of link. The 1080716719a3SSean Paul * default value of link-status is "GOOD". If something fails during or 1081716719a3SSean Paul * after modeset, the kernel driver may set this to "BAD" and issue a 1082716719a3SSean Paul * hotplug uevent. Drivers should update this value using 108397e14fbeSDaniel Vetter * drm_connector_set_link_status_property(). 1084a66da873SSimon Ser * 1085a66da873SSimon Ser * When user-space receives the hotplug uevent and detects a "BAD" 1086a66da873SSimon Ser * link-status, the sink doesn't receive pixels anymore (e.g. the screen 1087a66da873SSimon Ser * becomes completely black). The list of available modes may have 1088a66da873SSimon Ser * changed. User-space is expected to pick a new mode if the current one 1089a66da873SSimon Ser * has disappeared and perform a new modeset with link-status set to 1090a66da873SSimon Ser * "GOOD" to re-enable the connector. 1091a66da873SSimon Ser * 1092a66da873SSimon Ser * If multiple connectors share the same CRTC and one of them gets a "BAD" 1093a66da873SSimon Ser * link-status, the other are unaffected (ie. the sinks still continue to 1094a66da873SSimon Ser * receive pixels). 1095a66da873SSimon Ser * 1096a66da873SSimon Ser * When user-space performs an atomic commit on a connector with a "BAD" 1097a66da873SSimon Ser * link-status without resetting the property to "GOOD", the sink may 1098a66da873SSimon Ser * still not receive pixels. When user-space performs an atomic commit 1099a66da873SSimon Ser * which resets the link-status property to "GOOD" without the 1100a66da873SSimon Ser * ALLOW_MODESET flag set, it might fail because a modeset is required. 1101a66da873SSimon Ser * 1102a66da873SSimon Ser * User-space can only change link-status to "GOOD", changing it to "BAD" 1103a66da873SSimon Ser * is a no-op. 1104a66da873SSimon Ser * 1105a66da873SSimon Ser * For backwards compatibility with non-atomic userspace the kernel 1106a66da873SSimon Ser * tries to automatically set the link-status back to "GOOD" in the 1107a66da873SSimon Ser * SETCRTC IOCTL. This might fail if the mode is no longer valid, similar 1108a66da873SSimon Ser * to how it might fail if a different screen has been connected in the 1109a66da873SSimon Ser * interim. 111066660d4cSDave Airlie * non_desktop: 111166660d4cSDave Airlie * Indicates the output should be ignored for purposes of displaying a 111266660d4cSDave Airlie * standard desktop environment or console. This is most likely because 111366660d4cSDave Airlie * the output device is not rectilinear. 111424557865SSean Paul * Content Protection: 111524557865SSean Paul * This property is used by userspace to request the kernel protect future 111624557865SSean Paul * content communicated over the link. When requested, kernel will apply 111724557865SSean Paul * the appropriate means of protection (most often HDCP), and use the 111824557865SSean Paul * property to tell userspace the protection is active. 111924557865SSean Paul * 112024557865SSean Paul * Drivers can set this up by calling 112124557865SSean Paul * drm_connector_attach_content_protection_property() on initialization. 112224557865SSean Paul * 112324557865SSean Paul * The value of this property can be one of the following: 112424557865SSean Paul * 1125bbeba09fSDaniel Vetter * DRM_MODE_CONTENT_PROTECTION_UNDESIRED = 0 112624557865SSean Paul * The link is not protected, content is transmitted in the clear. 1127bbeba09fSDaniel Vetter * DRM_MODE_CONTENT_PROTECTION_DESIRED = 1 112824557865SSean Paul * Userspace has requested content protection, but the link is not 112924557865SSean Paul * currently protected. When in this state, kernel should enable 113024557865SSean Paul * Content Protection as soon as possible. 1131bbeba09fSDaniel Vetter * DRM_MODE_CONTENT_PROTECTION_ENABLED = 2 113224557865SSean Paul * Userspace has requested content protection, and the link is 113324557865SSean Paul * protected. Only the driver can set the property to this value. 113424557865SSean Paul * If userspace attempts to set to ENABLED, kernel will return 113524557865SSean Paul * -EINVAL. 113624557865SSean Paul * 113724557865SSean Paul * A few guidelines: 113824557865SSean Paul * 113924557865SSean Paul * - DESIRED state should be preserved until userspace de-asserts it by 114024557865SSean Paul * setting the property to UNDESIRED. This means ENABLED should only 114124557865SSean Paul * transition to UNDESIRED when the user explicitly requests it. 114224557865SSean Paul * - If the state is DESIRED, kernel should attempt to re-authenticate the 114324557865SSean Paul * link whenever possible. This includes across disable/enable, dpms, 114424557865SSean Paul * hotplug, downstream device changes, link status failures, etc.. 1145bb5a45d4SRamalingam C * - Kernel sends uevent with the connector id and property id through 1146bb5a45d4SRamalingam C * @drm_hdcp_update_content_protection, upon below kernel triggered 1147bb5a45d4SRamalingam C * scenarios: 114812db36bcSSean Paul * 114912db36bcSSean Paul * - DESIRED -> ENABLED (authentication success) 115012db36bcSSean Paul * - ENABLED -> DESIRED (termination of authentication) 1151bb5a45d4SRamalingam C * - Please note no uevents for userspace triggered property state changes, 1152bb5a45d4SRamalingam C * which can't fail such as 115312db36bcSSean Paul * 115412db36bcSSean Paul * - DESIRED/ENABLED -> UNDESIRED 115512db36bcSSean Paul * - UNDESIRED -> DESIRED 1156bb5a45d4SRamalingam C * - Userspace is responsible for polling the property or listen to uevents 1157bb5a45d4SRamalingam C * to determine when the value transitions from ENABLED to DESIRED. 1158bb5a45d4SRamalingam C * This signifies the link is no longer protected and userspace should 1159bb5a45d4SRamalingam C * take appropriate action (whatever that might be). 11604ada6f22SDaniel Vetter * 11617672dbbaSRamalingam C * HDCP Content Type: 11627672dbbaSRamalingam C * This Enum property is used by the userspace to declare the content type 11637672dbbaSRamalingam C * of the display stream, to kernel. Here display stream stands for any 11647672dbbaSRamalingam C * display content that userspace intended to display through HDCP 11657672dbbaSRamalingam C * encryption. 11667672dbbaSRamalingam C * 11677672dbbaSRamalingam C * Content Type of a stream is decided by the owner of the stream, as 11687672dbbaSRamalingam C * "HDCP Type0" or "HDCP Type1". 11697672dbbaSRamalingam C * 11707672dbbaSRamalingam C * The value of the property can be one of the below: 11717672dbbaSRamalingam C * - "HDCP Type0": DRM_MODE_HDCP_CONTENT_TYPE0 = 0 11727672dbbaSRamalingam C * - "HDCP Type1": DRM_MODE_HDCP_CONTENT_TYPE1 = 1 11737672dbbaSRamalingam C * 11747672dbbaSRamalingam C * When kernel starts the HDCP authentication (see "Content Protection" 11757672dbbaSRamalingam C * for details), it uses the content type in "HDCP Content Type" 11767672dbbaSRamalingam C * for performing the HDCP authentication with the display sink. 11777672dbbaSRamalingam C * 11787672dbbaSRamalingam C * Please note in HDCP spec versions, a link can be authenticated with 11797672dbbaSRamalingam C * HDCP 2.2 for Content Type 0/Content Type 1. Where as a link can be 11807672dbbaSRamalingam C * authenticated with HDCP1.4 only for Content Type 0(though it is implicit 11817672dbbaSRamalingam C * in nature. As there is no reference for Content Type in HDCP1.4). 11827672dbbaSRamalingam C * 11837672dbbaSRamalingam C * HDCP2.2 authentication protocol itself takes the "Content Type" as a 11847672dbbaSRamalingam C * parameter, which is a input for the DP HDCP2.2 encryption algo. 11857672dbbaSRamalingam C * 11867672dbbaSRamalingam C * In case of Type 0 content protection request, kernel driver can choose 11877672dbbaSRamalingam C * either of HDCP spec versions 1.4 and 2.2. When HDCP2.2 is used for 11887672dbbaSRamalingam C * "HDCP Type 0", a HDCP 2.2 capable repeater in the downstream can send 11897672dbbaSRamalingam C * that content to a HDCP 1.4 authenticated HDCP sink (Type0 link). 11907672dbbaSRamalingam C * But if the content is classified as "HDCP Type 1", above mentioned 11917672dbbaSRamalingam C * HDCP 2.2 repeater wont send the content to the HDCP sink as it can't 11927672dbbaSRamalingam C * authenticate the HDCP1.4 capable sink for "HDCP Type 1". 11937672dbbaSRamalingam C * 11947672dbbaSRamalingam C * Please note userspace can be ignorant of the HDCP versions used by the 11957672dbbaSRamalingam C * kernel driver to achieve the "HDCP Content Type". 11967672dbbaSRamalingam C * 11977672dbbaSRamalingam C * At current scenario, classifying a content as Type 1 ensures that the 11987672dbbaSRamalingam C * content will be displayed only through the HDCP2.2 encrypted link. 11997672dbbaSRamalingam C * 12007672dbbaSRamalingam C * Note that the HDCP Content Type property is introduced at HDCP 2.2, and 12017672dbbaSRamalingam C * defaults to type 0. It is only exposed by drivers supporting HDCP 2.2 12027672dbbaSRamalingam C * (hence supporting Type 0 and Type 1). Based on how next versions of 12037672dbbaSRamalingam C * HDCP specs are defined content Type could be used for higher versions 12047672dbbaSRamalingam C * too. 12057672dbbaSRamalingam C * 12067672dbbaSRamalingam C * If content type is changed when "Content Protection" is not UNDESIRED, 12077672dbbaSRamalingam C * then kernel will disable the HDCP and re-enable with new type in the 12087672dbbaSRamalingam C * same atomic commit. And when "Content Protection" is ENABLED, it means 12097672dbbaSRamalingam C * that link is HDCP authenticated and encrypted, for the transmission of 12107672dbbaSRamalingam C * the Type of stream mentioned at "HDCP Content Type". 12117672dbbaSRamalingam C * 1212a09db883SUma Shankar * HDR_OUTPUT_METADATA: 1213a09db883SUma Shankar * Connector property to enable userspace to send HDR Metadata to 1214a09db883SUma Shankar * driver. This metadata is based on the composition and blending 1215a09db883SUma Shankar * policies decided by user, taking into account the hardware and 1216a09db883SUma Shankar * sink capabilities. The driver gets this metadata and creates a 1217a09db883SUma Shankar * Dynamic Range and Mastering Infoframe (DRM) in case of HDMI, 1218a09db883SUma Shankar * SDP packet (Non-audio INFOFRAME SDP v1.3) for DP. This is then 1219a09db883SUma Shankar * sent to sink. This notifies the sink of the upcoming frame's Color 1220a09db883SUma Shankar * Encoding and Luminance parameters. 1221a09db883SUma Shankar * 1222a09db883SUma Shankar * Userspace first need to detect the HDR capabilities of sink by 1223a09db883SUma Shankar * reading and parsing the EDID. Details of HDR metadata for HDMI 1224a09db883SUma Shankar * are added in CTA 861.G spec. For DP , its defined in VESA DP 1225a09db883SUma Shankar * Standard v1.4. It needs to then get the metadata information 1226a09db883SUma Shankar * of the video/game/app content which are encoded in HDR (basically 1227a09db883SUma Shankar * using HDR transfer functions). With this information it needs to 1228a09db883SUma Shankar * decide on a blending policy and compose the relevant 1229a09db883SUma Shankar * layers/overlays into a common format. Once this blending is done, 1230a09db883SUma Shankar * userspace will be aware of the metadata of the composed frame to 1231a09db883SUma Shankar * be send to sink. It then uses this property to communicate this 1232a09db883SUma Shankar * metadata to driver which then make a Infoframe packet and sends 1233a09db883SUma Shankar * to sink based on the type of encoder connected. 1234a09db883SUma Shankar * 1235a09db883SUma Shankar * Userspace will be responsible to do Tone mapping operation in case: 1236a09db883SUma Shankar * - Some layers are HDR and others are SDR 1237a09db883SUma Shankar * - HDR layers luminance is not same as sink 12389f9b2559SSean Paul * 1239a09db883SUma Shankar * It will even need to do colorspace conversion and get all layers 1240a09db883SUma Shankar * to one common colorspace for blending. It can use either GL, Media 124184e543bcSAntonio Borneo * or display engine to get this done based on the capabilities of the 1242a09db883SUma Shankar * associated hardware. 1243a09db883SUma Shankar * 1244a09db883SUma Shankar * Driver expects metadata to be put in &struct hdr_output_metadata 1245a09db883SUma Shankar * structure from userspace. This is received as blob and stored in 1246a09db883SUma Shankar * &drm_connector_state.hdr_output_metadata. It parses EDID and saves the 1247a09db883SUma Shankar * sink metadata in &struct hdr_sink_metadata, as 1248a09db883SUma Shankar * &drm_connector.hdr_sink_metadata. Driver uses 1249a09db883SUma Shankar * drm_hdmi_infoframe_set_hdr_metadata() helper to set the HDR metadata, 1250a09db883SUma Shankar * hdmi_drm_infoframe_pack() to pack the infoframe as per spec, in case of 1251a09db883SUma Shankar * HDMI encoder. 1252a09db883SUma Shankar * 125347e22ff1SRadhakrishna Sripada * max bpc: 125447e22ff1SRadhakrishna Sripada * This range property is used by userspace to limit the bit depth. When 125547e22ff1SRadhakrishna Sripada * used the driver would limit the bpc in accordance with the valid range 125647e22ff1SRadhakrishna Sripada * supported by the hardware and sink. Drivers to use the function 125747e22ff1SRadhakrishna Sripada * drm_connector_attach_max_bpc_property() to create and attach the 125847e22ff1SRadhakrishna Sripada * property to the connector during initialization. 125947e22ff1SRadhakrishna Sripada * 12604ada6f22SDaniel Vetter * Connectors also have one standardized atomic property: 12614ada6f22SDaniel Vetter * 12624ada6f22SDaniel Vetter * CRTC_ID: 12634ada6f22SDaniel Vetter * Mode object ID of the &drm_crtc this connector should be connected to. 12648d70f395SHans de Goede * 12658d70f395SHans de Goede * Connectors for LCD panels may also have one standardized property: 12668d70f395SHans de Goede * 12678d70f395SHans de Goede * panel orientation: 12688d70f395SHans de Goede * On some devices the LCD panel is mounted in the casing in such a way 12698d70f395SHans de Goede * that the up/top side of the panel does not match with the top side of 12708d70f395SHans de Goede * the device. Userspace can use this property to check for this. 12718d70f395SHans de Goede * Note that input coordinates from touchscreens (input devices with 12728d70f395SHans de Goede * INPUT_PROP_DIRECT) will still map 1:1 to the actual LCD panel 12738d70f395SHans de Goede * coordinates, so if userspace rotates the picture to adjust for 12748d70f395SHans de Goede * the orientation it must also apply the same transformation to the 1275bbeba09fSDaniel Vetter * touchscreen input coordinates. This property is initialized by calling 127669654c63SDerek Basehore * drm_connector_set_panel_orientation() or 127769654c63SDerek Basehore * drm_connector_set_panel_orientation_with_quirk() 1278bbeba09fSDaniel Vetter * 1279bbeba09fSDaniel Vetter * scaling mode: 1280bbeba09fSDaniel Vetter * This property defines how a non-native mode is upscaled to the native 1281bbeba09fSDaniel Vetter * mode of an LCD panel: 1282bbeba09fSDaniel Vetter * 1283bbeba09fSDaniel Vetter * None: 1284bbeba09fSDaniel Vetter * No upscaling happens, scaling is left to the panel. Not all 1285bbeba09fSDaniel Vetter * drivers expose this mode. 1286bbeba09fSDaniel Vetter * Full: 1287bbeba09fSDaniel Vetter * The output is upscaled to the full resolution of the panel, 1288bbeba09fSDaniel Vetter * ignoring the aspect ratio. 1289bbeba09fSDaniel Vetter * Center: 1290bbeba09fSDaniel Vetter * No upscaling happens, the output is centered within the native 1291bbeba09fSDaniel Vetter * resolution the panel. 1292bbeba09fSDaniel Vetter * Full aspect: 1293bbeba09fSDaniel Vetter * The output is upscaled to maximize either the width or height 1294bbeba09fSDaniel Vetter * while retaining the aspect ratio. 1295bbeba09fSDaniel Vetter * 1296bbeba09fSDaniel Vetter * This property should be set up by calling 1297bbeba09fSDaniel Vetter * drm_connector_attach_scaling_mode_property(). Note that drivers 1298bbeba09fSDaniel Vetter * can also expose this property to external outputs, in which case they 1299bbeba09fSDaniel Vetter * must support "None", which should be the default (since external screens 1300bbeba09fSDaniel Vetter * have a built-in scaler). 1301e5b92773SOleg Vasilev * 1302e5b92773SOleg Vasilev * subconnector: 1303e5b92773SOleg Vasilev * This property is used by DVI-I, TVout and DisplayPort to indicate different 1304e5b92773SOleg Vasilev * connector subtypes. Enum values more or less match with those from main 1305e5b92773SOleg Vasilev * connector types. 1306e5b92773SOleg Vasilev * For DVI-I and TVout there is also a matching property "select subconnector" 1307e5b92773SOleg Vasilev * allowing to switch between signal types. 1308e5b92773SOleg Vasilev * DP subconnector corresponds to a downstream port. 1309107fe904SRajat Jain * 1310107fe904SRajat Jain * privacy-screen sw-state, privacy-screen hw-state: 1311107fe904SRajat Jain * These 2 optional properties can be used to query the state of the 1312107fe904SRajat Jain * electronic privacy screen that is available on some displays; and in 1313107fe904SRajat Jain * some cases also control the state. If a driver implements these 1314107fe904SRajat Jain * properties then both properties must be present. 1315107fe904SRajat Jain * 1316107fe904SRajat Jain * "privacy-screen hw-state" is read-only and reflects the actual state 1317107fe904SRajat Jain * of the privacy-screen, possible values: "Enabled", "Disabled, 1318107fe904SRajat Jain * "Enabled-locked", "Disabled-locked". The locked states indicate 1319107fe904SRajat Jain * that the state cannot be changed through the DRM API. E.g. there 1320107fe904SRajat Jain * might be devices where the firmware-setup options, or a hardware 1321107fe904SRajat Jain * slider-switch, offer always on / off modes. 1322107fe904SRajat Jain * 1323107fe904SRajat Jain * "privacy-screen sw-state" can be set to change the privacy-screen state 1324107fe904SRajat Jain * when not locked. In this case the driver must update the hw-state 1325107fe904SRajat Jain * property to reflect the new state on completion of the commit of the 1326107fe904SRajat Jain * sw-state property. Setting the sw-state property when the hw-state is 1327107fe904SRajat Jain * locked must be interpreted by the driver as a request to change the 1328107fe904SRajat Jain * state to the set state when the hw-state becomes unlocked. E.g. if 1329107fe904SRajat Jain * "privacy-screen hw-state" is "Enabled-locked" and the sw-state 1330107fe904SRajat Jain * gets set to "Disabled" followed by the user unlocking the state by 1331107fe904SRajat Jain * changing the slider-switch position, then the driver must set the 1332107fe904SRajat Jain * state to "Disabled" upon receiving the unlock event. 1333107fe904SRajat Jain * 1334107fe904SRajat Jain * In some cases the privacy-screen's actual state might change outside of 1335107fe904SRajat Jain * control of the DRM code. E.g. there might be a firmware handled hotkey 1336107fe904SRajat Jain * which toggles the actual state, or the actual state might be changed 1337107fe904SRajat Jain * through another userspace API such as writing /proc/acpi/ibm/lcdshadow. 1338107fe904SRajat Jain * In this case the driver must update both the hw-state and the sw-state 1339107fe904SRajat Jain * to reflect the new value, overwriting any pending state requests in the 1340107fe904SRajat Jain * sw-state. Any pending sw-state requests are thus discarded. 1341107fe904SRajat Jain * 1342107fe904SRajat Jain * Note that the ability for the state to change outside of control of 1343107fe904SRajat Jain * the DRM master process means that userspace must not cache the value 1344107fe904SRajat Jain * of the sw-state. Caching the sw-state value and including it in later 1345107fe904SRajat Jain * atomic commits may lead to overriding a state change done through e.g. 1346107fe904SRajat Jain * a firmware handled hotkey. Therefor userspace must not include the 1347107fe904SRajat Jain * privacy-screen sw-state in an atomic commit unless it wants to change 1348107fe904SRajat Jain * its value. 13494ada6f22SDaniel Vetter */ 13504ada6f22SDaniel Vetter 135152217195SDaniel Vetter int drm_connector_create_standard_properties(struct drm_device *dev) 135252217195SDaniel Vetter { 135352217195SDaniel Vetter struct drm_property *prop; 135452217195SDaniel Vetter 135552217195SDaniel Vetter prop = drm_property_create(dev, DRM_MODE_PROP_BLOB | 135652217195SDaniel Vetter DRM_MODE_PROP_IMMUTABLE, 135752217195SDaniel Vetter "EDID", 0); 135852217195SDaniel Vetter if (!prop) 135952217195SDaniel Vetter return -ENOMEM; 136052217195SDaniel Vetter dev->mode_config.edid_property = prop; 136152217195SDaniel Vetter 136252217195SDaniel Vetter prop = drm_property_create_enum(dev, 0, 136352217195SDaniel Vetter "DPMS", drm_dpms_enum_list, 136452217195SDaniel Vetter ARRAY_SIZE(drm_dpms_enum_list)); 136552217195SDaniel Vetter if (!prop) 136652217195SDaniel Vetter return -ENOMEM; 136752217195SDaniel Vetter dev->mode_config.dpms_property = prop; 136852217195SDaniel Vetter 136952217195SDaniel Vetter prop = drm_property_create(dev, 137052217195SDaniel Vetter DRM_MODE_PROP_BLOB | 137152217195SDaniel Vetter DRM_MODE_PROP_IMMUTABLE, 137252217195SDaniel Vetter "PATH", 0); 137352217195SDaniel Vetter if (!prop) 137452217195SDaniel Vetter return -ENOMEM; 137552217195SDaniel Vetter dev->mode_config.path_property = prop; 137652217195SDaniel Vetter 137752217195SDaniel Vetter prop = drm_property_create(dev, 137852217195SDaniel Vetter DRM_MODE_PROP_BLOB | 137952217195SDaniel Vetter DRM_MODE_PROP_IMMUTABLE, 138052217195SDaniel Vetter "TILE", 0); 138152217195SDaniel Vetter if (!prop) 138252217195SDaniel Vetter return -ENOMEM; 138352217195SDaniel Vetter dev->mode_config.tile_property = prop; 138452217195SDaniel Vetter 138540ee6fbeSManasi Navare prop = drm_property_create_enum(dev, 0, "link-status", 138640ee6fbeSManasi Navare drm_link_status_enum_list, 138740ee6fbeSManasi Navare ARRAY_SIZE(drm_link_status_enum_list)); 138840ee6fbeSManasi Navare if (!prop) 138940ee6fbeSManasi Navare return -ENOMEM; 139040ee6fbeSManasi Navare dev->mode_config.link_status_property = prop; 139140ee6fbeSManasi Navare 139266660d4cSDave Airlie prop = drm_property_create_bool(dev, DRM_MODE_PROP_IMMUTABLE, "non-desktop"); 139366660d4cSDave Airlie if (!prop) 139466660d4cSDave Airlie return -ENOMEM; 139566660d4cSDave Airlie dev->mode_config.non_desktop_property = prop; 139666660d4cSDave Airlie 1397fbb5d035SUma Shankar prop = drm_property_create(dev, DRM_MODE_PROP_BLOB, 1398fbb5d035SUma Shankar "HDR_OUTPUT_METADATA", 0); 1399fbb5d035SUma Shankar if (!prop) 1400fbb5d035SUma Shankar return -ENOMEM; 1401fbb5d035SUma Shankar dev->mode_config.hdr_output_metadata_property = prop; 1402fbb5d035SUma Shankar 140352217195SDaniel Vetter return 0; 140452217195SDaniel Vetter } 140552217195SDaniel Vetter 140652217195SDaniel Vetter /** 140752217195SDaniel Vetter * drm_mode_create_dvi_i_properties - create DVI-I specific connector properties 140852217195SDaniel Vetter * @dev: DRM device 140952217195SDaniel Vetter * 141052217195SDaniel Vetter * Called by a driver the first time a DVI-I connector is made. 1411f85d9e59SRandy Dunlap * 1412f85d9e59SRandy Dunlap * Returns: %0 141352217195SDaniel Vetter */ 141452217195SDaniel Vetter int drm_mode_create_dvi_i_properties(struct drm_device *dev) 141552217195SDaniel Vetter { 141652217195SDaniel Vetter struct drm_property *dvi_i_selector; 141752217195SDaniel Vetter struct drm_property *dvi_i_subconnector; 141852217195SDaniel Vetter 141952217195SDaniel Vetter if (dev->mode_config.dvi_i_select_subconnector_property) 142052217195SDaniel Vetter return 0; 142152217195SDaniel Vetter 142252217195SDaniel Vetter dvi_i_selector = 142352217195SDaniel Vetter drm_property_create_enum(dev, 0, 142452217195SDaniel Vetter "select subconnector", 142552217195SDaniel Vetter drm_dvi_i_select_enum_list, 142652217195SDaniel Vetter ARRAY_SIZE(drm_dvi_i_select_enum_list)); 142752217195SDaniel Vetter dev->mode_config.dvi_i_select_subconnector_property = dvi_i_selector; 142852217195SDaniel Vetter 142952217195SDaniel Vetter dvi_i_subconnector = drm_property_create_enum(dev, DRM_MODE_PROP_IMMUTABLE, 143052217195SDaniel Vetter "subconnector", 143152217195SDaniel Vetter drm_dvi_i_subconnector_enum_list, 143252217195SDaniel Vetter ARRAY_SIZE(drm_dvi_i_subconnector_enum_list)); 143352217195SDaniel Vetter dev->mode_config.dvi_i_subconnector_property = dvi_i_subconnector; 143452217195SDaniel Vetter 143552217195SDaniel Vetter return 0; 143652217195SDaniel Vetter } 143752217195SDaniel Vetter EXPORT_SYMBOL(drm_mode_create_dvi_i_properties); 143852217195SDaniel Vetter 143952217195SDaniel Vetter /** 1440e5b92773SOleg Vasilev * drm_connector_attach_dp_subconnector_property - create subconnector property for DP 1441e5b92773SOleg Vasilev * @connector: drm_connector to attach property 1442e5b92773SOleg Vasilev * 1443e5b92773SOleg Vasilev * Called by a driver when DP connector is created. 1444e5b92773SOleg Vasilev */ 1445e5b92773SOleg Vasilev void drm_connector_attach_dp_subconnector_property(struct drm_connector *connector) 1446e5b92773SOleg Vasilev { 1447e5b92773SOleg Vasilev struct drm_mode_config *mode_config = &connector->dev->mode_config; 1448e5b92773SOleg Vasilev 1449e5b92773SOleg Vasilev if (!mode_config->dp_subconnector_property) 1450e5b92773SOleg Vasilev mode_config->dp_subconnector_property = 1451e5b92773SOleg Vasilev drm_property_create_enum(connector->dev, 1452e5b92773SOleg Vasilev DRM_MODE_PROP_IMMUTABLE, 1453e5b92773SOleg Vasilev "subconnector", 1454e5b92773SOleg Vasilev drm_dp_subconnector_enum_list, 1455e5b92773SOleg Vasilev ARRAY_SIZE(drm_dp_subconnector_enum_list)); 1456e5b92773SOleg Vasilev 1457e5b92773SOleg Vasilev drm_object_attach_property(&connector->base, 1458e5b92773SOleg Vasilev mode_config->dp_subconnector_property, 1459e5b92773SOleg Vasilev DRM_MODE_SUBCONNECTOR_Unknown); 1460e5b92773SOleg Vasilev } 1461e5b92773SOleg Vasilev EXPORT_SYMBOL(drm_connector_attach_dp_subconnector_property); 1462e5b92773SOleg Vasilev 1463e5b92773SOleg Vasilev /** 146450525c33SStanislav Lisovskiy * DOC: HDMI connector properties 146550525c33SStanislav Lisovskiy * 146650525c33SStanislav Lisovskiy * content type (HDMI specific): 146750525c33SStanislav Lisovskiy * Indicates content type setting to be used in HDMI infoframes to indicate 14681e55a53aSMatt Roper * content type for the external device, so that it adjusts its display 146950525c33SStanislav Lisovskiy * settings accordingly. 147050525c33SStanislav Lisovskiy * 147150525c33SStanislav Lisovskiy * The value of this property can be one of the following: 147250525c33SStanislav Lisovskiy * 147350525c33SStanislav Lisovskiy * No Data: 147450525c33SStanislav Lisovskiy * Content type is unknown 147550525c33SStanislav Lisovskiy * Graphics: 147650525c33SStanislav Lisovskiy * Content type is graphics 147750525c33SStanislav Lisovskiy * Photo: 147850525c33SStanislav Lisovskiy * Content type is photo 147950525c33SStanislav Lisovskiy * Cinema: 148050525c33SStanislav Lisovskiy * Content type is cinema 148150525c33SStanislav Lisovskiy * Game: 148250525c33SStanislav Lisovskiy * Content type is game 148350525c33SStanislav Lisovskiy * 1484a0a33067SSimon Ser * The meaning of each content type is defined in CTA-861-G table 15. 1485a0a33067SSimon Ser * 148650525c33SStanislav Lisovskiy * Drivers can set up this property by calling 148750525c33SStanislav Lisovskiy * drm_connector_attach_content_type_property(). Decoding to 1488ba609631SDaniel Vetter * infoframe values is done through drm_hdmi_avi_infoframe_content_type(). 148950525c33SStanislav Lisovskiy */ 149050525c33SStanislav Lisovskiy 149150525c33SStanislav Lisovskiy /** 149250525c33SStanislav Lisovskiy * drm_connector_attach_content_type_property - attach content-type property 149350525c33SStanislav Lisovskiy * @connector: connector to attach content type property on. 149450525c33SStanislav Lisovskiy * 149550525c33SStanislav Lisovskiy * Called by a driver the first time a HDMI connector is made. 1496f85d9e59SRandy Dunlap * 1497f85d9e59SRandy Dunlap * Returns: %0 149850525c33SStanislav Lisovskiy */ 149950525c33SStanislav Lisovskiy int drm_connector_attach_content_type_property(struct drm_connector *connector) 150050525c33SStanislav Lisovskiy { 150150525c33SStanislav Lisovskiy if (!drm_mode_create_content_type_property(connector->dev)) 150250525c33SStanislav Lisovskiy drm_object_attach_property(&connector->base, 150350525c33SStanislav Lisovskiy connector->dev->mode_config.content_type_property, 150450525c33SStanislav Lisovskiy DRM_MODE_CONTENT_TYPE_NO_DATA); 150550525c33SStanislav Lisovskiy return 0; 150650525c33SStanislav Lisovskiy } 150750525c33SStanislav Lisovskiy EXPORT_SYMBOL(drm_connector_attach_content_type_property); 150850525c33SStanislav Lisovskiy 150950525c33SStanislav Lisovskiy /** 1510e9d2871fSMauro Carvalho Chehab * drm_connector_attach_tv_margin_properties - attach TV connector margin 1511e9d2871fSMauro Carvalho Chehab * properties 15126c4f52dcSBoris Brezillon * @connector: DRM connector 15136c4f52dcSBoris Brezillon * 15146c4f52dcSBoris Brezillon * Called by a driver when it needs to attach TV margin props to a connector. 15156c4f52dcSBoris Brezillon * Typically used on SDTV and HDMI connectors. 15166c4f52dcSBoris Brezillon */ 15176c4f52dcSBoris Brezillon void drm_connector_attach_tv_margin_properties(struct drm_connector *connector) 15186c4f52dcSBoris Brezillon { 15196c4f52dcSBoris Brezillon struct drm_device *dev = connector->dev; 15206c4f52dcSBoris Brezillon 15216c4f52dcSBoris Brezillon drm_object_attach_property(&connector->base, 15226c4f52dcSBoris Brezillon dev->mode_config.tv_left_margin_property, 15236c4f52dcSBoris Brezillon 0); 15246c4f52dcSBoris Brezillon drm_object_attach_property(&connector->base, 15256c4f52dcSBoris Brezillon dev->mode_config.tv_right_margin_property, 15266c4f52dcSBoris Brezillon 0); 15276c4f52dcSBoris Brezillon drm_object_attach_property(&connector->base, 15286c4f52dcSBoris Brezillon dev->mode_config.tv_top_margin_property, 15296c4f52dcSBoris Brezillon 0); 15306c4f52dcSBoris Brezillon drm_object_attach_property(&connector->base, 15316c4f52dcSBoris Brezillon dev->mode_config.tv_bottom_margin_property, 15326c4f52dcSBoris Brezillon 0); 15336c4f52dcSBoris Brezillon } 15346c4f52dcSBoris Brezillon EXPORT_SYMBOL(drm_connector_attach_tv_margin_properties); 15356c4f52dcSBoris Brezillon 15366c4f52dcSBoris Brezillon /** 15376c4f52dcSBoris Brezillon * drm_mode_create_tv_margin_properties - create TV connector margin properties 15386c4f52dcSBoris Brezillon * @dev: DRM device 15396c4f52dcSBoris Brezillon * 15406c4f52dcSBoris Brezillon * Called by a driver's HDMI connector initialization routine, this function 15416c4f52dcSBoris Brezillon * creates the TV margin properties for a given device. No need to call this 15426c4f52dcSBoris Brezillon * function for an SDTV connector, it's already called from 15436c4f52dcSBoris Brezillon * drm_mode_create_tv_properties(). 1544f85d9e59SRandy Dunlap * 1545f85d9e59SRandy Dunlap * Returns: 1546f85d9e59SRandy Dunlap * 0 on success or a negative error code on failure. 15476c4f52dcSBoris Brezillon */ 15486c4f52dcSBoris Brezillon int drm_mode_create_tv_margin_properties(struct drm_device *dev) 15496c4f52dcSBoris Brezillon { 15506c4f52dcSBoris Brezillon if (dev->mode_config.tv_left_margin_property) 15516c4f52dcSBoris Brezillon return 0; 15526c4f52dcSBoris Brezillon 15536c4f52dcSBoris Brezillon dev->mode_config.tv_left_margin_property = 15546c4f52dcSBoris Brezillon drm_property_create_range(dev, 0, "left margin", 0, 100); 15556c4f52dcSBoris Brezillon if (!dev->mode_config.tv_left_margin_property) 15566c4f52dcSBoris Brezillon return -ENOMEM; 15576c4f52dcSBoris Brezillon 15586c4f52dcSBoris Brezillon dev->mode_config.tv_right_margin_property = 15596c4f52dcSBoris Brezillon drm_property_create_range(dev, 0, "right margin", 0, 100); 15606c4f52dcSBoris Brezillon if (!dev->mode_config.tv_right_margin_property) 15616c4f52dcSBoris Brezillon return -ENOMEM; 15626c4f52dcSBoris Brezillon 15636c4f52dcSBoris Brezillon dev->mode_config.tv_top_margin_property = 15646c4f52dcSBoris Brezillon drm_property_create_range(dev, 0, "top margin", 0, 100); 15656c4f52dcSBoris Brezillon if (!dev->mode_config.tv_top_margin_property) 15666c4f52dcSBoris Brezillon return -ENOMEM; 15676c4f52dcSBoris Brezillon 15686c4f52dcSBoris Brezillon dev->mode_config.tv_bottom_margin_property = 15696c4f52dcSBoris Brezillon drm_property_create_range(dev, 0, "bottom margin", 0, 100); 15706c4f52dcSBoris Brezillon if (!dev->mode_config.tv_bottom_margin_property) 15716c4f52dcSBoris Brezillon return -ENOMEM; 15726c4f52dcSBoris Brezillon 15736c4f52dcSBoris Brezillon return 0; 15746c4f52dcSBoris Brezillon } 15756c4f52dcSBoris Brezillon EXPORT_SYMBOL(drm_mode_create_tv_margin_properties); 15766c4f52dcSBoris Brezillon 15776c4f52dcSBoris Brezillon /** 1578eda6887fSBoris Brezillon * drm_mode_create_tv_properties - create TV specific connector properties 157952217195SDaniel Vetter * @dev: DRM device 158052217195SDaniel Vetter * @num_modes: number of different TV formats (modes) supported 158152217195SDaniel Vetter * @modes: array of pointers to strings containing name of each format 158252217195SDaniel Vetter * 158352217195SDaniel Vetter * Called by a driver's TV initialization routine, this function creates 158452217195SDaniel Vetter * the TV specific connector properties for a given device. Caller is 158552217195SDaniel Vetter * responsible for allocating a list of format names and passing them to 158652217195SDaniel Vetter * this routine. 1587f85d9e59SRandy Dunlap * 1588f85d9e59SRandy Dunlap * Returns: 1589f85d9e59SRandy Dunlap * 0 on success or a negative error code on failure. 159052217195SDaniel Vetter */ 159152217195SDaniel Vetter int drm_mode_create_tv_properties(struct drm_device *dev, 159252217195SDaniel Vetter unsigned int num_modes, 159352217195SDaniel Vetter const char * const modes[]) 159452217195SDaniel Vetter { 159552217195SDaniel Vetter struct drm_property *tv_selector; 159652217195SDaniel Vetter struct drm_property *tv_subconnector; 159752217195SDaniel Vetter unsigned int i; 159852217195SDaniel Vetter 159952217195SDaniel Vetter if (dev->mode_config.tv_select_subconnector_property) 160052217195SDaniel Vetter return 0; 160152217195SDaniel Vetter 160252217195SDaniel Vetter /* 160352217195SDaniel Vetter * Basic connector properties 160452217195SDaniel Vetter */ 160552217195SDaniel Vetter tv_selector = drm_property_create_enum(dev, 0, 160652217195SDaniel Vetter "select subconnector", 160752217195SDaniel Vetter drm_tv_select_enum_list, 160852217195SDaniel Vetter ARRAY_SIZE(drm_tv_select_enum_list)); 160952217195SDaniel Vetter if (!tv_selector) 161052217195SDaniel Vetter goto nomem; 161152217195SDaniel Vetter 161252217195SDaniel Vetter dev->mode_config.tv_select_subconnector_property = tv_selector; 161352217195SDaniel Vetter 161452217195SDaniel Vetter tv_subconnector = 161552217195SDaniel Vetter drm_property_create_enum(dev, DRM_MODE_PROP_IMMUTABLE, 161652217195SDaniel Vetter "subconnector", 161752217195SDaniel Vetter drm_tv_subconnector_enum_list, 161852217195SDaniel Vetter ARRAY_SIZE(drm_tv_subconnector_enum_list)); 161952217195SDaniel Vetter if (!tv_subconnector) 162052217195SDaniel Vetter goto nomem; 162152217195SDaniel Vetter dev->mode_config.tv_subconnector_property = tv_subconnector; 162252217195SDaniel Vetter 162352217195SDaniel Vetter /* 162452217195SDaniel Vetter * Other, TV specific properties: margins & TV modes. 162552217195SDaniel Vetter */ 16266c4f52dcSBoris Brezillon if (drm_mode_create_tv_margin_properties(dev)) 162752217195SDaniel Vetter goto nomem; 162852217195SDaniel Vetter 162952217195SDaniel Vetter dev->mode_config.tv_mode_property = 163052217195SDaniel Vetter drm_property_create(dev, DRM_MODE_PROP_ENUM, 163152217195SDaniel Vetter "mode", num_modes); 163252217195SDaniel Vetter if (!dev->mode_config.tv_mode_property) 163352217195SDaniel Vetter goto nomem; 163452217195SDaniel Vetter 163552217195SDaniel Vetter for (i = 0; i < num_modes; i++) 163630e9db6dSVille Syrjälä drm_property_add_enum(dev->mode_config.tv_mode_property, 163752217195SDaniel Vetter i, modes[i]); 163852217195SDaniel Vetter 163952217195SDaniel Vetter dev->mode_config.tv_brightness_property = 164052217195SDaniel Vetter drm_property_create_range(dev, 0, "brightness", 0, 100); 164152217195SDaniel Vetter if (!dev->mode_config.tv_brightness_property) 164252217195SDaniel Vetter goto nomem; 164352217195SDaniel Vetter 164452217195SDaniel Vetter dev->mode_config.tv_contrast_property = 164552217195SDaniel Vetter drm_property_create_range(dev, 0, "contrast", 0, 100); 164652217195SDaniel Vetter if (!dev->mode_config.tv_contrast_property) 164752217195SDaniel Vetter goto nomem; 164852217195SDaniel Vetter 164952217195SDaniel Vetter dev->mode_config.tv_flicker_reduction_property = 165052217195SDaniel Vetter drm_property_create_range(dev, 0, "flicker reduction", 0, 100); 165152217195SDaniel Vetter if (!dev->mode_config.tv_flicker_reduction_property) 165252217195SDaniel Vetter goto nomem; 165352217195SDaniel Vetter 165452217195SDaniel Vetter dev->mode_config.tv_overscan_property = 165552217195SDaniel Vetter drm_property_create_range(dev, 0, "overscan", 0, 100); 165652217195SDaniel Vetter if (!dev->mode_config.tv_overscan_property) 165752217195SDaniel Vetter goto nomem; 165852217195SDaniel Vetter 165952217195SDaniel Vetter dev->mode_config.tv_saturation_property = 166052217195SDaniel Vetter drm_property_create_range(dev, 0, "saturation", 0, 100); 166152217195SDaniel Vetter if (!dev->mode_config.tv_saturation_property) 166252217195SDaniel Vetter goto nomem; 166352217195SDaniel Vetter 166452217195SDaniel Vetter dev->mode_config.tv_hue_property = 166552217195SDaniel Vetter drm_property_create_range(dev, 0, "hue", 0, 100); 166652217195SDaniel Vetter if (!dev->mode_config.tv_hue_property) 166752217195SDaniel Vetter goto nomem; 166852217195SDaniel Vetter 166952217195SDaniel Vetter return 0; 167052217195SDaniel Vetter nomem: 167152217195SDaniel Vetter return -ENOMEM; 167252217195SDaniel Vetter } 167352217195SDaniel Vetter EXPORT_SYMBOL(drm_mode_create_tv_properties); 167452217195SDaniel Vetter 167552217195SDaniel Vetter /** 167652217195SDaniel Vetter * drm_mode_create_scaling_mode_property - create scaling mode property 167752217195SDaniel Vetter * @dev: DRM device 167852217195SDaniel Vetter * 167952217195SDaniel Vetter * Called by a driver the first time it's needed, must be attached to desired 168052217195SDaniel Vetter * connectors. 16818f6e1e22SMaarten Lankhorst * 16828f6e1e22SMaarten Lankhorst * Atomic drivers should use drm_connector_attach_scaling_mode_property() 16839c2fce13SVille Syrjälä * instead to correctly assign &drm_connector_state.scaling_mode 16848f6e1e22SMaarten Lankhorst * in the atomic state. 1685f85d9e59SRandy Dunlap * 1686f85d9e59SRandy Dunlap * Returns: %0 168752217195SDaniel Vetter */ 168852217195SDaniel Vetter int drm_mode_create_scaling_mode_property(struct drm_device *dev) 168952217195SDaniel Vetter { 169052217195SDaniel Vetter struct drm_property *scaling_mode; 169152217195SDaniel Vetter 169252217195SDaniel Vetter if (dev->mode_config.scaling_mode_property) 169352217195SDaniel Vetter return 0; 169452217195SDaniel Vetter 169552217195SDaniel Vetter scaling_mode = 169652217195SDaniel Vetter drm_property_create_enum(dev, 0, "scaling mode", 169752217195SDaniel Vetter drm_scaling_mode_enum_list, 169852217195SDaniel Vetter ARRAY_SIZE(drm_scaling_mode_enum_list)); 169952217195SDaniel Vetter 170052217195SDaniel Vetter dev->mode_config.scaling_mode_property = scaling_mode; 170152217195SDaniel Vetter 170252217195SDaniel Vetter return 0; 170352217195SDaniel Vetter } 170452217195SDaniel Vetter EXPORT_SYMBOL(drm_mode_create_scaling_mode_property); 170552217195SDaniel Vetter 170652217195SDaniel Vetter /** 1707ab7a664fSNicholas Kazlauskas * DOC: Variable refresh properties 1708ab7a664fSNicholas Kazlauskas * 1709ab7a664fSNicholas Kazlauskas * Variable refresh rate capable displays can dynamically adjust their 1710ab7a664fSNicholas Kazlauskas * refresh rate by extending the duration of their vertical front porch 1711ab7a664fSNicholas Kazlauskas * until page flip or timeout occurs. This can reduce or remove stuttering 1712ab7a664fSNicholas Kazlauskas * and latency in scenarios where the page flip does not align with the 1713ab7a664fSNicholas Kazlauskas * vblank interval. 1714ab7a664fSNicholas Kazlauskas * 1715ab7a664fSNicholas Kazlauskas * An example scenario would be an application flipping at a constant rate 1716ab7a664fSNicholas Kazlauskas * of 48Hz on a 60Hz display. The page flip will frequently miss the vblank 1717ab7a664fSNicholas Kazlauskas * interval and the same contents will be displayed twice. This can be 1718ab7a664fSNicholas Kazlauskas * observed as stuttering for content with motion. 1719ab7a664fSNicholas Kazlauskas * 1720ab7a664fSNicholas Kazlauskas * If variable refresh rate was active on a display that supported a 1721ab7a664fSNicholas Kazlauskas * variable refresh range from 35Hz to 60Hz no stuttering would be observable 1722ab7a664fSNicholas Kazlauskas * for the example scenario. The minimum supported variable refresh rate of 1723ab7a664fSNicholas Kazlauskas * 35Hz is below the page flip frequency and the vertical front porch can 1724ab7a664fSNicholas Kazlauskas * be extended until the page flip occurs. The vblank interval will be 1725ab7a664fSNicholas Kazlauskas * directly aligned to the page flip rate. 1726ab7a664fSNicholas Kazlauskas * 1727ab7a664fSNicholas Kazlauskas * Not all userspace content is suitable for use with variable refresh rate. 1728ab7a664fSNicholas Kazlauskas * Large and frequent changes in vertical front porch duration may worsen 1729ab7a664fSNicholas Kazlauskas * perceived stuttering for input sensitive applications. 1730ab7a664fSNicholas Kazlauskas * 1731ab7a664fSNicholas Kazlauskas * Panel brightness will also vary with vertical front porch duration. Some 1732ab7a664fSNicholas Kazlauskas * panels may have noticeable differences in brightness between the minimum 1733ab7a664fSNicholas Kazlauskas * vertical front porch duration and the maximum vertical front porch duration. 1734ab7a664fSNicholas Kazlauskas * Large and frequent changes in vertical front porch duration may produce 1735ab7a664fSNicholas Kazlauskas * observable flickering for such panels. 1736ab7a664fSNicholas Kazlauskas * 1737ab7a664fSNicholas Kazlauskas * Userspace control for variable refresh rate is supported via properties 1738ab7a664fSNicholas Kazlauskas * on the &drm_connector and &drm_crtc objects. 1739ab7a664fSNicholas Kazlauskas * 1740ab7a664fSNicholas Kazlauskas * "vrr_capable": 1741ab7a664fSNicholas Kazlauskas * Optional &drm_connector boolean property that drivers should attach 1742ab7a664fSNicholas Kazlauskas * with drm_connector_attach_vrr_capable_property() on connectors that 1743ab7a664fSNicholas Kazlauskas * could support variable refresh rates. Drivers should update the 1744ab7a664fSNicholas Kazlauskas * property value by calling drm_connector_set_vrr_capable_property(). 1745ab7a664fSNicholas Kazlauskas * 1746ab7a664fSNicholas Kazlauskas * Absence of the property should indicate absence of support. 1747ab7a664fSNicholas Kazlauskas * 174877086014SDaniel Vetter * "VRR_ENABLED": 1749ab7a664fSNicholas Kazlauskas * Default &drm_crtc boolean property that notifies the driver that the 1750ab7a664fSNicholas Kazlauskas * content on the CRTC is suitable for variable refresh rate presentation. 1751ab7a664fSNicholas Kazlauskas * The driver will take this property as a hint to enable variable 1752ab7a664fSNicholas Kazlauskas * refresh rate support if the receiver supports it, ie. if the 1753ab7a664fSNicholas Kazlauskas * "vrr_capable" property is true on the &drm_connector object. The 1754ab7a664fSNicholas Kazlauskas * vertical front porch duration will be extended until page-flip or 1755ab7a664fSNicholas Kazlauskas * timeout when enabled. 1756ab7a664fSNicholas Kazlauskas * 1757ab7a664fSNicholas Kazlauskas * The minimum vertical front porch duration is defined as the vertical 1758ab7a664fSNicholas Kazlauskas * front porch duration for the current mode. 1759ab7a664fSNicholas Kazlauskas * 1760ab7a664fSNicholas Kazlauskas * The maximum vertical front porch duration is greater than or equal to 1761ab7a664fSNicholas Kazlauskas * the minimum vertical front porch duration. The duration is derived 1762ab7a664fSNicholas Kazlauskas * from the minimum supported variable refresh rate for the connector. 1763ab7a664fSNicholas Kazlauskas * 1764ab7a664fSNicholas Kazlauskas * The driver may place further restrictions within these minimum 1765ab7a664fSNicholas Kazlauskas * and maximum bounds. 1766ab7a664fSNicholas Kazlauskas */ 1767ab7a664fSNicholas Kazlauskas 1768ab7a664fSNicholas Kazlauskas /** 1769ba1b0f6cSNicholas Kazlauskas * drm_connector_attach_vrr_capable_property - creates the 1770ba1b0f6cSNicholas Kazlauskas * vrr_capable property 1771ba1b0f6cSNicholas Kazlauskas * @connector: connector to create the vrr_capable property on. 1772ba1b0f6cSNicholas Kazlauskas * 1773ba1b0f6cSNicholas Kazlauskas * This is used by atomic drivers to add support for querying 1774ba1b0f6cSNicholas Kazlauskas * variable refresh rate capability for a connector. 1775ba1b0f6cSNicholas Kazlauskas * 1776ba1b0f6cSNicholas Kazlauskas * Returns: 177784e543bcSAntonio Borneo * Zero on success, negative errno on failure. 1778ba1b0f6cSNicholas Kazlauskas */ 1779ba1b0f6cSNicholas Kazlauskas int drm_connector_attach_vrr_capable_property( 1780ba1b0f6cSNicholas Kazlauskas struct drm_connector *connector) 1781ba1b0f6cSNicholas Kazlauskas { 1782ba1b0f6cSNicholas Kazlauskas struct drm_device *dev = connector->dev; 1783ba1b0f6cSNicholas Kazlauskas struct drm_property *prop; 1784ba1b0f6cSNicholas Kazlauskas 1785ba1b0f6cSNicholas Kazlauskas if (!connector->vrr_capable_property) { 1786ba1b0f6cSNicholas Kazlauskas prop = drm_property_create_bool(dev, DRM_MODE_PROP_IMMUTABLE, 1787ba1b0f6cSNicholas Kazlauskas "vrr_capable"); 1788ba1b0f6cSNicholas Kazlauskas if (!prop) 1789ba1b0f6cSNicholas Kazlauskas return -ENOMEM; 1790ba1b0f6cSNicholas Kazlauskas 1791ba1b0f6cSNicholas Kazlauskas connector->vrr_capable_property = prop; 1792ba1b0f6cSNicholas Kazlauskas drm_object_attach_property(&connector->base, prop, 0); 1793ba1b0f6cSNicholas Kazlauskas } 1794ba1b0f6cSNicholas Kazlauskas 1795ba1b0f6cSNicholas Kazlauskas return 0; 1796ba1b0f6cSNicholas Kazlauskas } 1797ba1b0f6cSNicholas Kazlauskas EXPORT_SYMBOL(drm_connector_attach_vrr_capable_property); 1798ba1b0f6cSNicholas Kazlauskas 1799ba1b0f6cSNicholas Kazlauskas /** 18008f6e1e22SMaarten Lankhorst * drm_connector_attach_scaling_mode_property - attach atomic scaling mode property 18018f6e1e22SMaarten Lankhorst * @connector: connector to attach scaling mode property on. 18028f6e1e22SMaarten Lankhorst * @scaling_mode_mask: or'ed mask of BIT(%DRM_MODE_SCALE_\*). 18038f6e1e22SMaarten Lankhorst * 18048f6e1e22SMaarten Lankhorst * This is used to add support for scaling mode to atomic drivers. 18059c2fce13SVille Syrjälä * The scaling mode will be set to &drm_connector_state.scaling_mode 18068f6e1e22SMaarten Lankhorst * and can be used from &drm_connector_helper_funcs->atomic_check for validation. 18078f6e1e22SMaarten Lankhorst * 18088f6e1e22SMaarten Lankhorst * This is the atomic version of drm_mode_create_scaling_mode_property(). 18098f6e1e22SMaarten Lankhorst * 18108f6e1e22SMaarten Lankhorst * Returns: 18118f6e1e22SMaarten Lankhorst * Zero on success, negative errno on failure. 18128f6e1e22SMaarten Lankhorst */ 18138f6e1e22SMaarten Lankhorst int drm_connector_attach_scaling_mode_property(struct drm_connector *connector, 18148f6e1e22SMaarten Lankhorst u32 scaling_mode_mask) 18158f6e1e22SMaarten Lankhorst { 18168f6e1e22SMaarten Lankhorst struct drm_device *dev = connector->dev; 18178f6e1e22SMaarten Lankhorst struct drm_property *scaling_mode_property; 181830e9db6dSVille Syrjälä int i; 18198f6e1e22SMaarten Lankhorst const unsigned valid_scaling_mode_mask = 18208f6e1e22SMaarten Lankhorst (1U << ARRAY_SIZE(drm_scaling_mode_enum_list)) - 1; 18218f6e1e22SMaarten Lankhorst 18228f6e1e22SMaarten Lankhorst if (WARN_ON(hweight32(scaling_mode_mask) < 2 || 18238f6e1e22SMaarten Lankhorst scaling_mode_mask & ~valid_scaling_mode_mask)) 18248f6e1e22SMaarten Lankhorst return -EINVAL; 18258f6e1e22SMaarten Lankhorst 18268f6e1e22SMaarten Lankhorst scaling_mode_property = 18278f6e1e22SMaarten Lankhorst drm_property_create(dev, DRM_MODE_PROP_ENUM, "scaling mode", 18288f6e1e22SMaarten Lankhorst hweight32(scaling_mode_mask)); 18298f6e1e22SMaarten Lankhorst 18308f6e1e22SMaarten Lankhorst if (!scaling_mode_property) 18318f6e1e22SMaarten Lankhorst return -ENOMEM; 18328f6e1e22SMaarten Lankhorst 18338f6e1e22SMaarten Lankhorst for (i = 0; i < ARRAY_SIZE(drm_scaling_mode_enum_list); i++) { 18348f6e1e22SMaarten Lankhorst int ret; 18358f6e1e22SMaarten Lankhorst 18368f6e1e22SMaarten Lankhorst if (!(BIT(i) & scaling_mode_mask)) 18378f6e1e22SMaarten Lankhorst continue; 18388f6e1e22SMaarten Lankhorst 183930e9db6dSVille Syrjälä ret = drm_property_add_enum(scaling_mode_property, 18408f6e1e22SMaarten Lankhorst drm_scaling_mode_enum_list[i].type, 18418f6e1e22SMaarten Lankhorst drm_scaling_mode_enum_list[i].name); 18428f6e1e22SMaarten Lankhorst 18438f6e1e22SMaarten Lankhorst if (ret) { 18448f6e1e22SMaarten Lankhorst drm_property_destroy(dev, scaling_mode_property); 18458f6e1e22SMaarten Lankhorst 18468f6e1e22SMaarten Lankhorst return ret; 18478f6e1e22SMaarten Lankhorst } 18488f6e1e22SMaarten Lankhorst } 18498f6e1e22SMaarten Lankhorst 18508f6e1e22SMaarten Lankhorst drm_object_attach_property(&connector->base, 18518f6e1e22SMaarten Lankhorst scaling_mode_property, 0); 18528f6e1e22SMaarten Lankhorst 18538f6e1e22SMaarten Lankhorst connector->scaling_mode_property = scaling_mode_property; 18548f6e1e22SMaarten Lankhorst 18558f6e1e22SMaarten Lankhorst return 0; 18568f6e1e22SMaarten Lankhorst } 18578f6e1e22SMaarten Lankhorst EXPORT_SYMBOL(drm_connector_attach_scaling_mode_property); 18588f6e1e22SMaarten Lankhorst 18598f6e1e22SMaarten Lankhorst /** 186052217195SDaniel Vetter * drm_mode_create_aspect_ratio_property - create aspect ratio property 186152217195SDaniel Vetter * @dev: DRM device 186252217195SDaniel Vetter * 186352217195SDaniel Vetter * Called by a driver the first time it's needed, must be attached to desired 186452217195SDaniel Vetter * connectors. 186552217195SDaniel Vetter * 186652217195SDaniel Vetter * Returns: 186752217195SDaniel Vetter * Zero on success, negative errno on failure. 186852217195SDaniel Vetter */ 186952217195SDaniel Vetter int drm_mode_create_aspect_ratio_property(struct drm_device *dev) 187052217195SDaniel Vetter { 187152217195SDaniel Vetter if (dev->mode_config.aspect_ratio_property) 187252217195SDaniel Vetter return 0; 187352217195SDaniel Vetter 187452217195SDaniel Vetter dev->mode_config.aspect_ratio_property = 187552217195SDaniel Vetter drm_property_create_enum(dev, 0, "aspect ratio", 187652217195SDaniel Vetter drm_aspect_ratio_enum_list, 187752217195SDaniel Vetter ARRAY_SIZE(drm_aspect_ratio_enum_list)); 187852217195SDaniel Vetter 187952217195SDaniel Vetter if (dev->mode_config.aspect_ratio_property == NULL) 188052217195SDaniel Vetter return -ENOMEM; 188152217195SDaniel Vetter 188252217195SDaniel Vetter return 0; 188352217195SDaniel Vetter } 188452217195SDaniel Vetter EXPORT_SYMBOL(drm_mode_create_aspect_ratio_property); 188552217195SDaniel Vetter 188652217195SDaniel Vetter /** 1887d2c6a405SUma Shankar * DOC: standard connector properties 1888d2c6a405SUma Shankar * 1889d2c6a405SUma Shankar * Colorspace: 1890d2c6a405SUma Shankar * This property helps select a suitable colorspace based on the sink 1891d2c6a405SUma Shankar * capability. Modern sink devices support wider gamut like BT2020. 1892d2c6a405SUma Shankar * This helps switch to BT2020 mode if the BT2020 encoded video stream 1893d2c6a405SUma Shankar * is being played by the user, same for any other colorspace. Thereby 1894d2c6a405SUma Shankar * giving a good visual experience to users. 1895d2c6a405SUma Shankar * 1896d2c6a405SUma Shankar * The expectation from userspace is that it should parse the EDID 1897d2c6a405SUma Shankar * and get supported colorspaces. Use this property and switch to the 1898d2c6a405SUma Shankar * one supported. Sink supported colorspaces should be retrieved by 1899d2c6a405SUma Shankar * userspace from EDID and driver will not explicitly expose them. 1900d2c6a405SUma Shankar * 1901d2c6a405SUma Shankar * Basically the expectation from userspace is: 1902d2c6a405SUma Shankar * - Set up CRTC DEGAMMA/CTM/GAMMA to convert to some sink 1903d2c6a405SUma Shankar * colorspace 1904d2c6a405SUma Shankar * - Set this new property to let the sink know what it 1905d2c6a405SUma Shankar * converted the CRTC output to. 1906d2c6a405SUma Shankar * - This property is just to inform sink what colorspace 1907d2c6a405SUma Shankar * source is trying to drive. 1908d2c6a405SUma Shankar * 19098806cd3aSGwan-gyeong Mun * Because between HDMI and DP have different colorspaces, 191045cf0e91SGwan-gyeong Mun * drm_mode_create_hdmi_colorspace_property() is used for HDMI connector and 191145cf0e91SGwan-gyeong Mun * drm_mode_create_dp_colorspace_property() is used for DP connector. 1912d2c6a405SUma Shankar */ 19138806cd3aSGwan-gyeong Mun 19148806cd3aSGwan-gyeong Mun /** 19158806cd3aSGwan-gyeong Mun * drm_mode_create_hdmi_colorspace_property - create hdmi colorspace property 19168806cd3aSGwan-gyeong Mun * @connector: connector to create the Colorspace property on. 19178806cd3aSGwan-gyeong Mun * 19188806cd3aSGwan-gyeong Mun * Called by a driver the first time it's needed, must be attached to desired 19198806cd3aSGwan-gyeong Mun * HDMI connectors. 19208806cd3aSGwan-gyeong Mun * 19218806cd3aSGwan-gyeong Mun * Returns: 192284e543bcSAntonio Borneo * Zero on success, negative errno on failure. 19238806cd3aSGwan-gyeong Mun */ 19248806cd3aSGwan-gyeong Mun int drm_mode_create_hdmi_colorspace_property(struct drm_connector *connector) 1925d2c6a405SUma Shankar { 1926d2c6a405SUma Shankar struct drm_device *dev = connector->dev; 1927d2c6a405SUma Shankar 19288806cd3aSGwan-gyeong Mun if (connector->colorspace_property) 19298806cd3aSGwan-gyeong Mun return 0; 19308806cd3aSGwan-gyeong Mun 19318806cd3aSGwan-gyeong Mun connector->colorspace_property = 19328806cd3aSGwan-gyeong Mun drm_property_create_enum(dev, DRM_MODE_PROP_ENUM, "Colorspace", 1933d2c6a405SUma Shankar hdmi_colorspaces, 1934d2c6a405SUma Shankar ARRAY_SIZE(hdmi_colorspaces)); 19358806cd3aSGwan-gyeong Mun 19368806cd3aSGwan-gyeong Mun if (!connector->colorspace_property) 1937d2c6a405SUma Shankar return -ENOMEM; 1938d2c6a405SUma Shankar 1939d2c6a405SUma Shankar return 0; 1940d2c6a405SUma Shankar } 19418806cd3aSGwan-gyeong Mun EXPORT_SYMBOL(drm_mode_create_hdmi_colorspace_property); 1942d2c6a405SUma Shankar 1943d2c6a405SUma Shankar /** 194445cf0e91SGwan-gyeong Mun * drm_mode_create_dp_colorspace_property - create dp colorspace property 194545cf0e91SGwan-gyeong Mun * @connector: connector to create the Colorspace property on. 194645cf0e91SGwan-gyeong Mun * 194745cf0e91SGwan-gyeong Mun * Called by a driver the first time it's needed, must be attached to desired 194845cf0e91SGwan-gyeong Mun * DP connectors. 194945cf0e91SGwan-gyeong Mun * 195045cf0e91SGwan-gyeong Mun * Returns: 195184e543bcSAntonio Borneo * Zero on success, negative errno on failure. 195245cf0e91SGwan-gyeong Mun */ 195345cf0e91SGwan-gyeong Mun int drm_mode_create_dp_colorspace_property(struct drm_connector *connector) 195445cf0e91SGwan-gyeong Mun { 195545cf0e91SGwan-gyeong Mun struct drm_device *dev = connector->dev; 195645cf0e91SGwan-gyeong Mun 195745cf0e91SGwan-gyeong Mun if (connector->colorspace_property) 195845cf0e91SGwan-gyeong Mun return 0; 195945cf0e91SGwan-gyeong Mun 196045cf0e91SGwan-gyeong Mun connector->colorspace_property = 196145cf0e91SGwan-gyeong Mun drm_property_create_enum(dev, DRM_MODE_PROP_ENUM, "Colorspace", 196245cf0e91SGwan-gyeong Mun dp_colorspaces, 196345cf0e91SGwan-gyeong Mun ARRAY_SIZE(dp_colorspaces)); 196445cf0e91SGwan-gyeong Mun 196545cf0e91SGwan-gyeong Mun if (!connector->colorspace_property) 196645cf0e91SGwan-gyeong Mun return -ENOMEM; 196745cf0e91SGwan-gyeong Mun 196845cf0e91SGwan-gyeong Mun return 0; 196945cf0e91SGwan-gyeong Mun } 197045cf0e91SGwan-gyeong Mun EXPORT_SYMBOL(drm_mode_create_dp_colorspace_property); 197152217195SDaniel Vetter 197297e14fbeSDaniel Vetter /** 197352217195SDaniel Vetter * drm_mode_create_content_type_property - create content type property 197452217195SDaniel Vetter * @dev: DRM device 197597e14fbeSDaniel Vetter * 197652217195SDaniel Vetter * Called by a driver the first time it's needed, must be attached to desired 197752217195SDaniel Vetter * connectors. 197852217195SDaniel Vetter * 197952217195SDaniel Vetter * Returns: 198052217195SDaniel Vetter * Zero on success, negative errno on failure. 198152217195SDaniel Vetter */ 198252217195SDaniel Vetter int drm_mode_create_content_type_property(struct drm_device *dev) 198352217195SDaniel Vetter { 198452217195SDaniel Vetter if (dev->mode_config.content_type_property) 198597e14fbeSDaniel Vetter return 0; 198652217195SDaniel Vetter 198752217195SDaniel Vetter dev->mode_config.content_type_property = 198852217195SDaniel Vetter drm_property_create_enum(dev, 0, "content type", 198952217195SDaniel Vetter drm_content_type_enum_list, 199052217195SDaniel Vetter ARRAY_SIZE(drm_content_type_enum_list)); 199152217195SDaniel Vetter 199252217195SDaniel Vetter if (dev->mode_config.content_type_property == NULL) 199352217195SDaniel Vetter return -ENOMEM; 199452217195SDaniel Vetter 199552217195SDaniel Vetter return 0; 199652217195SDaniel Vetter } 199752217195SDaniel Vetter EXPORT_SYMBOL(drm_mode_create_content_type_property); 199852217195SDaniel Vetter 199952217195SDaniel Vetter /** 200052217195SDaniel Vetter * drm_mode_create_suggested_offset_properties - create suggests offset properties 200152217195SDaniel Vetter * @dev: DRM device 200252217195SDaniel Vetter * 200384e543bcSAntonio Borneo * Create the suggested x/y offset property for connectors. 2004f85d9e59SRandy Dunlap * 2005f85d9e59SRandy Dunlap * Returns: 2006f85d9e59SRandy Dunlap * 0 on success or a negative error code on failure. 200752217195SDaniel Vetter */ 200852217195SDaniel Vetter int drm_mode_create_suggested_offset_properties(struct drm_device *dev) 200952217195SDaniel Vetter { 201052217195SDaniel Vetter if (dev->mode_config.suggested_x_property && dev->mode_config.suggested_y_property) 201152217195SDaniel Vetter return 0; 201252217195SDaniel Vetter 201352217195SDaniel Vetter dev->mode_config.suggested_x_property = 201452217195SDaniel Vetter drm_property_create_range(dev, DRM_MODE_PROP_IMMUTABLE, "suggested X", 0, 0xffffffff); 201552217195SDaniel Vetter 201652217195SDaniel Vetter dev->mode_config.suggested_y_property = 201752217195SDaniel Vetter drm_property_create_range(dev, DRM_MODE_PROP_IMMUTABLE, "suggested Y", 0, 0xffffffff); 201852217195SDaniel Vetter 201952217195SDaniel Vetter if (dev->mode_config.suggested_x_property == NULL || 202052217195SDaniel Vetter dev->mode_config.suggested_y_property == NULL) 202152217195SDaniel Vetter return -ENOMEM; 202252217195SDaniel Vetter return 0; 202352217195SDaniel Vetter } 202452217195SDaniel Vetter EXPORT_SYMBOL(drm_mode_create_suggested_offset_properties); 202552217195SDaniel Vetter 202652217195SDaniel Vetter /** 202752217195SDaniel Vetter * drm_connector_set_path_property - set tile property on connector 202852217195SDaniel Vetter * @connector: connector to set property on. 202952217195SDaniel Vetter * @path: path to use for property; must not be NULL. 203052217195SDaniel Vetter * 203152217195SDaniel Vetter * This creates a property to expose to userspace to specify a 203252217195SDaniel Vetter * connector path. This is mainly used for DisplayPort MST where 203352217195SDaniel Vetter * connectors have a topology and we want to allow userspace to give 203452217195SDaniel Vetter * them more meaningful names. 203552217195SDaniel Vetter * 203652217195SDaniel Vetter * Returns: 203752217195SDaniel Vetter * Zero on success, negative errno on failure. 203852217195SDaniel Vetter */ 203952217195SDaniel Vetter int drm_connector_set_path_property(struct drm_connector *connector, 204052217195SDaniel Vetter const char *path) 204152217195SDaniel Vetter { 204252217195SDaniel Vetter struct drm_device *dev = connector->dev; 204352217195SDaniel Vetter int ret; 204452217195SDaniel Vetter 204552217195SDaniel Vetter ret = drm_property_replace_global_blob(dev, 204652217195SDaniel Vetter &connector->path_blob_ptr, 204752217195SDaniel Vetter strlen(path) + 1, 204852217195SDaniel Vetter path, 204952217195SDaniel Vetter &connector->base, 205052217195SDaniel Vetter dev->mode_config.path_property); 205152217195SDaniel Vetter return ret; 205252217195SDaniel Vetter } 205352217195SDaniel Vetter EXPORT_SYMBOL(drm_connector_set_path_property); 205452217195SDaniel Vetter 205552217195SDaniel Vetter /** 205652217195SDaniel Vetter * drm_connector_set_tile_property - set tile property on connector 205752217195SDaniel Vetter * @connector: connector to set property on. 205852217195SDaniel Vetter * 205952217195SDaniel Vetter * This looks up the tile information for a connector, and creates a 206052217195SDaniel Vetter * property for userspace to parse if it exists. The property is of 206152217195SDaniel Vetter * the form of 8 integers using ':' as a separator. 20622de3a078SManasi Navare * This is used for dual port tiled displays with DisplayPort SST 20632de3a078SManasi Navare * or DisplayPort MST connectors. 206452217195SDaniel Vetter * 206552217195SDaniel Vetter * Returns: 206652217195SDaniel Vetter * Zero on success, errno on failure. 206752217195SDaniel Vetter */ 206852217195SDaniel Vetter int drm_connector_set_tile_property(struct drm_connector *connector) 206952217195SDaniel Vetter { 207052217195SDaniel Vetter struct drm_device *dev = connector->dev; 207152217195SDaniel Vetter char tile[256]; 207252217195SDaniel Vetter int ret; 207352217195SDaniel Vetter 207452217195SDaniel Vetter if (!connector->has_tile) { 207552217195SDaniel Vetter ret = drm_property_replace_global_blob(dev, 207652217195SDaniel Vetter &connector->tile_blob_ptr, 207752217195SDaniel Vetter 0, 207852217195SDaniel Vetter NULL, 207952217195SDaniel Vetter &connector->base, 208052217195SDaniel Vetter dev->mode_config.tile_property); 208152217195SDaniel Vetter return ret; 208252217195SDaniel Vetter } 208352217195SDaniel Vetter 208452217195SDaniel Vetter snprintf(tile, 256, "%d:%d:%d:%d:%d:%d:%d:%d", 208552217195SDaniel Vetter connector->tile_group->id, connector->tile_is_single_monitor, 208652217195SDaniel Vetter connector->num_h_tile, connector->num_v_tile, 208752217195SDaniel Vetter connector->tile_h_loc, connector->tile_v_loc, 208852217195SDaniel Vetter connector->tile_h_size, connector->tile_v_size); 208952217195SDaniel Vetter 209052217195SDaniel Vetter ret = drm_property_replace_global_blob(dev, 209152217195SDaniel Vetter &connector->tile_blob_ptr, 209252217195SDaniel Vetter strlen(tile) + 1, 209352217195SDaniel Vetter tile, 209452217195SDaniel Vetter &connector->base, 209552217195SDaniel Vetter dev->mode_config.tile_property); 209652217195SDaniel Vetter return ret; 209752217195SDaniel Vetter } 209897e14fbeSDaniel Vetter EXPORT_SYMBOL(drm_connector_set_tile_property); 209952217195SDaniel Vetter 210052217195SDaniel Vetter /** 210197e14fbeSDaniel Vetter * drm_connector_set_link_status_property - Set link status property of a connector 210240ee6fbeSManasi Navare * @connector: drm connector 210340ee6fbeSManasi Navare * @link_status: new value of link status property (0: Good, 1: Bad) 210440ee6fbeSManasi Navare * 210540ee6fbeSManasi Navare * In usual working scenario, this link status property will always be set to 210640ee6fbeSManasi Navare * "GOOD". If something fails during or after a mode set, the kernel driver 210740ee6fbeSManasi Navare * may set this link status property to "BAD". The caller then needs to send a 210840ee6fbeSManasi Navare * hotplug uevent for userspace to re-check the valid modes through 210940ee6fbeSManasi Navare * GET_CONNECTOR_IOCTL and retry modeset. 211040ee6fbeSManasi Navare * 211140ee6fbeSManasi Navare * Note: Drivers cannot rely on userspace to support this property and 211240ee6fbeSManasi Navare * issue a modeset. As such, they may choose to handle issues (like 211340ee6fbeSManasi Navare * re-training a link) without userspace's intervention. 211440ee6fbeSManasi Navare * 211540ee6fbeSManasi Navare * The reason for adding this property is to handle link training failures, but 211640ee6fbeSManasi Navare * it is not limited to DP or link training. For example, if we implement 211740ee6fbeSManasi Navare * asynchronous setcrtc, this property can be used to report any failures in that. 211840ee6fbeSManasi Navare */ 211997e14fbeSDaniel Vetter void drm_connector_set_link_status_property(struct drm_connector *connector, 212040ee6fbeSManasi Navare uint64_t link_status) 212140ee6fbeSManasi Navare { 212240ee6fbeSManasi Navare struct drm_device *dev = connector->dev; 212340ee6fbeSManasi Navare 212440ee6fbeSManasi Navare drm_modeset_lock(&dev->mode_config.connection_mutex, NULL); 212540ee6fbeSManasi Navare connector->state->link_status = link_status; 212640ee6fbeSManasi Navare drm_modeset_unlock(&dev->mode_config.connection_mutex); 212740ee6fbeSManasi Navare } 212897e14fbeSDaniel Vetter EXPORT_SYMBOL(drm_connector_set_link_status_property); 212940ee6fbeSManasi Navare 21308d70f395SHans de Goede /** 213147e22ff1SRadhakrishna Sripada * drm_connector_attach_max_bpc_property - attach "max bpc" property 213247e22ff1SRadhakrishna Sripada * @connector: connector to attach max bpc property on. 213347e22ff1SRadhakrishna Sripada * @min: The minimum bit depth supported by the connector. 213447e22ff1SRadhakrishna Sripada * @max: The maximum bit depth supported by the connector. 213547e22ff1SRadhakrishna Sripada * 213647e22ff1SRadhakrishna Sripada * This is used to add support for limiting the bit depth on a connector. 213747e22ff1SRadhakrishna Sripada * 213847e22ff1SRadhakrishna Sripada * Returns: 213947e22ff1SRadhakrishna Sripada * Zero on success, negative errno on failure. 214047e22ff1SRadhakrishna Sripada */ 214147e22ff1SRadhakrishna Sripada int drm_connector_attach_max_bpc_property(struct drm_connector *connector, 214247e22ff1SRadhakrishna Sripada int min, int max) 214347e22ff1SRadhakrishna Sripada { 214447e22ff1SRadhakrishna Sripada struct drm_device *dev = connector->dev; 214547e22ff1SRadhakrishna Sripada struct drm_property *prop; 214647e22ff1SRadhakrishna Sripada 214747e22ff1SRadhakrishna Sripada prop = connector->max_bpc_property; 214847e22ff1SRadhakrishna Sripada if (!prop) { 214947e22ff1SRadhakrishna Sripada prop = drm_property_create_range(dev, 0, "max bpc", min, max); 215047e22ff1SRadhakrishna Sripada if (!prop) 215147e22ff1SRadhakrishna Sripada return -ENOMEM; 215247e22ff1SRadhakrishna Sripada 215347e22ff1SRadhakrishna Sripada connector->max_bpc_property = prop; 215447e22ff1SRadhakrishna Sripada } 215547e22ff1SRadhakrishna Sripada 215647e22ff1SRadhakrishna Sripada drm_object_attach_property(&connector->base, prop, max); 215747e22ff1SRadhakrishna Sripada connector->state->max_requested_bpc = max; 215847e22ff1SRadhakrishna Sripada connector->state->max_bpc = max; 215947e22ff1SRadhakrishna Sripada 216047e22ff1SRadhakrishna Sripada return 0; 216147e22ff1SRadhakrishna Sripada } 216247e22ff1SRadhakrishna Sripada EXPORT_SYMBOL(drm_connector_attach_max_bpc_property); 216347e22ff1SRadhakrishna Sripada 216447e22ff1SRadhakrishna Sripada /** 2165e057b52cSMaxime Ripard * drm_connector_attach_hdr_output_metadata_property - attach "HDR_OUTPUT_METADA" property 2166e057b52cSMaxime Ripard * @connector: connector to attach the property on. 2167e057b52cSMaxime Ripard * 2168e057b52cSMaxime Ripard * This is used to allow the userspace to send HDR Metadata to the 2169e057b52cSMaxime Ripard * driver. 2170e057b52cSMaxime Ripard * 2171e057b52cSMaxime Ripard * Returns: 2172e057b52cSMaxime Ripard * Zero on success, negative errno on failure. 2173e057b52cSMaxime Ripard */ 2174e057b52cSMaxime Ripard int drm_connector_attach_hdr_output_metadata_property(struct drm_connector *connector) 2175e057b52cSMaxime Ripard { 2176e057b52cSMaxime Ripard struct drm_device *dev = connector->dev; 2177e057b52cSMaxime Ripard struct drm_property *prop = dev->mode_config.hdr_output_metadata_property; 2178e057b52cSMaxime Ripard 2179e057b52cSMaxime Ripard drm_object_attach_property(&connector->base, prop, 0); 2180e057b52cSMaxime Ripard 2181e057b52cSMaxime Ripard return 0; 2182e057b52cSMaxime Ripard } 2183e057b52cSMaxime Ripard EXPORT_SYMBOL(drm_connector_attach_hdr_output_metadata_property); 2184e057b52cSMaxime Ripard 2185e057b52cSMaxime Ripard /** 218621f79128SMaxime Ripard * drm_connector_attach_colorspace_property - attach "Colorspace" property 218721f79128SMaxime Ripard * @connector: connector to attach the property on. 218821f79128SMaxime Ripard * 218921f79128SMaxime Ripard * This is used to allow the userspace to signal the output colorspace 219021f79128SMaxime Ripard * to the driver. 219121f79128SMaxime Ripard * 219221f79128SMaxime Ripard * Returns: 219321f79128SMaxime Ripard * Zero on success, negative errno on failure. 219421f79128SMaxime Ripard */ 219521f79128SMaxime Ripard int drm_connector_attach_colorspace_property(struct drm_connector *connector) 219621f79128SMaxime Ripard { 219721f79128SMaxime Ripard struct drm_property *prop = connector->colorspace_property; 219821f79128SMaxime Ripard 219921f79128SMaxime Ripard drm_object_attach_property(&connector->base, prop, DRM_MODE_COLORIMETRY_DEFAULT); 220021f79128SMaxime Ripard 220121f79128SMaxime Ripard return 0; 220221f79128SMaxime Ripard } 220321f79128SMaxime Ripard EXPORT_SYMBOL(drm_connector_attach_colorspace_property); 220421f79128SMaxime Ripard 220521f79128SMaxime Ripard /** 220672921cdfSMaxime Ripard * drm_connector_atomic_hdr_metadata_equal - checks if the hdr metadata changed 220772921cdfSMaxime Ripard * @old_state: old connector state to compare 220872921cdfSMaxime Ripard * @new_state: new connector state to compare 220972921cdfSMaxime Ripard * 221072921cdfSMaxime Ripard * This is used by HDR-enabled drivers to test whether the HDR metadata 221172921cdfSMaxime Ripard * have changed between two different connector state (and thus probably 221272921cdfSMaxime Ripard * requires a full blown mode change). 221372921cdfSMaxime Ripard * 221472921cdfSMaxime Ripard * Returns: 221572921cdfSMaxime Ripard * True if the metadata are equal, False otherwise 221672921cdfSMaxime Ripard */ 221772921cdfSMaxime Ripard bool drm_connector_atomic_hdr_metadata_equal(struct drm_connector_state *old_state, 221872921cdfSMaxime Ripard struct drm_connector_state *new_state) 221972921cdfSMaxime Ripard { 222072921cdfSMaxime Ripard struct drm_property_blob *old_blob = old_state->hdr_output_metadata; 222172921cdfSMaxime Ripard struct drm_property_blob *new_blob = new_state->hdr_output_metadata; 222272921cdfSMaxime Ripard 222372921cdfSMaxime Ripard if (!old_blob || !new_blob) 222472921cdfSMaxime Ripard return old_blob == new_blob; 222572921cdfSMaxime Ripard 222672921cdfSMaxime Ripard if (old_blob->length != new_blob->length) 222772921cdfSMaxime Ripard return false; 222872921cdfSMaxime Ripard 222972921cdfSMaxime Ripard return !memcmp(old_blob->data, new_blob->data, old_blob->length); 223072921cdfSMaxime Ripard } 223172921cdfSMaxime Ripard EXPORT_SYMBOL(drm_connector_atomic_hdr_metadata_equal); 223272921cdfSMaxime Ripard 223372921cdfSMaxime Ripard /** 2234ba1b0f6cSNicholas Kazlauskas * drm_connector_set_vrr_capable_property - sets the variable refresh rate 2235ba1b0f6cSNicholas Kazlauskas * capable property for a connector 2236ba1b0f6cSNicholas Kazlauskas * @connector: drm connector 2237ba1b0f6cSNicholas Kazlauskas * @capable: True if the connector is variable refresh rate capable 2238ba1b0f6cSNicholas Kazlauskas * 2239ba1b0f6cSNicholas Kazlauskas * Should be used by atomic drivers to update the indicated support for 2240ba1b0f6cSNicholas Kazlauskas * variable refresh rate over a connector. 2241ba1b0f6cSNicholas Kazlauskas */ 2242ba1b0f6cSNicholas Kazlauskas void drm_connector_set_vrr_capable_property( 2243ba1b0f6cSNicholas Kazlauskas struct drm_connector *connector, bool capable) 2244ba1b0f6cSNicholas Kazlauskas { 224562929726SManasi Navare if (!connector->vrr_capable_property) 224662929726SManasi Navare return; 224762929726SManasi Navare 2248ba1b0f6cSNicholas Kazlauskas drm_object_property_set_value(&connector->base, 2249ba1b0f6cSNicholas Kazlauskas connector->vrr_capable_property, 2250ba1b0f6cSNicholas Kazlauskas capable); 2251ba1b0f6cSNicholas Kazlauskas } 2252ba1b0f6cSNicholas Kazlauskas EXPORT_SYMBOL(drm_connector_set_vrr_capable_property); 2253ba1b0f6cSNicholas Kazlauskas 2254ba1b0f6cSNicholas Kazlauskas /** 225584e543bcSAntonio Borneo * drm_connector_set_panel_orientation - sets the connector's panel_orientation 225669654c63SDerek Basehore * @connector: connector for which to set the panel-orientation property. 225769654c63SDerek Basehore * @panel_orientation: drm_panel_orientation value to set 22588d70f395SHans de Goede * 225969654c63SDerek Basehore * This function sets the connector's panel_orientation and attaches 226069654c63SDerek Basehore * a "panel orientation" property to the connector. 22618d70f395SHans de Goede * 226269654c63SDerek Basehore * Calling this function on a connector where the panel_orientation has 226369654c63SDerek Basehore * already been set is a no-op (e.g. the orientation has been overridden with 226469654c63SDerek Basehore * a kernel commandline option). 226569654c63SDerek Basehore * 226669654c63SDerek Basehore * It is allowed to call this function with a panel_orientation of 226769654c63SDerek Basehore * DRM_MODE_PANEL_ORIENTATION_UNKNOWN, in which case it is a no-op. 22688d70f395SHans de Goede * 22695e41b01aSHsin-Yi Wang * The function shouldn't be called in panel after drm is registered (i.e. 22705e41b01aSHsin-Yi Wang * drm_dev_register() is called in drm). 22715e41b01aSHsin-Yi Wang * 22728d70f395SHans de Goede * Returns: 22738d70f395SHans de Goede * Zero on success, negative errno on failure. 22748d70f395SHans de Goede */ 227569654c63SDerek Basehore int drm_connector_set_panel_orientation( 227669654c63SDerek Basehore struct drm_connector *connector, 227769654c63SDerek Basehore enum drm_panel_orientation panel_orientation) 22788d70f395SHans de Goede { 22798d70f395SHans de Goede struct drm_device *dev = connector->dev; 22808d70f395SHans de Goede struct drm_display_info *info = &connector->display_info; 22818d70f395SHans de Goede struct drm_property *prop; 22828d70f395SHans de Goede 228369654c63SDerek Basehore /* Already set? */ 228469654c63SDerek Basehore if (info->panel_orientation != DRM_MODE_PANEL_ORIENTATION_UNKNOWN) 22858d70f395SHans de Goede return 0; 22868d70f395SHans de Goede 228769654c63SDerek Basehore /* Don't attach the property if the orientation is unknown */ 228869654c63SDerek Basehore if (panel_orientation == DRM_MODE_PANEL_ORIENTATION_UNKNOWN) 228969654c63SDerek Basehore return 0; 229069654c63SDerek Basehore 229169654c63SDerek Basehore info->panel_orientation = panel_orientation; 229269654c63SDerek Basehore 22938d70f395SHans de Goede prop = dev->mode_config.panel_orientation_property; 22948d70f395SHans de Goede if (!prop) { 22958d70f395SHans de Goede prop = drm_property_create_enum(dev, DRM_MODE_PROP_IMMUTABLE, 22968d70f395SHans de Goede "panel orientation", 22978d70f395SHans de Goede drm_panel_orientation_enum_list, 22988d70f395SHans de Goede ARRAY_SIZE(drm_panel_orientation_enum_list)); 22998d70f395SHans de Goede if (!prop) 23008d70f395SHans de Goede return -ENOMEM; 23018d70f395SHans de Goede 23028d70f395SHans de Goede dev->mode_config.panel_orientation_property = prop; 23038d70f395SHans de Goede } 23048d70f395SHans de Goede 23058d70f395SHans de Goede drm_object_attach_property(&connector->base, prop, 23068d70f395SHans de Goede info->panel_orientation); 23078d70f395SHans de Goede return 0; 23088d70f395SHans de Goede } 230969654c63SDerek Basehore EXPORT_SYMBOL(drm_connector_set_panel_orientation); 231069654c63SDerek Basehore 231169654c63SDerek Basehore /** 2312f85d9e59SRandy Dunlap * drm_connector_set_panel_orientation_with_quirk - set the 2313f85d9e59SRandy Dunlap * connector's panel_orientation after checking for quirks 231469654c63SDerek Basehore * @connector: connector for which to init the panel-orientation property. 231569654c63SDerek Basehore * @panel_orientation: drm_panel_orientation value to set 231669654c63SDerek Basehore * @width: width in pixels of the panel, used for panel quirk detection 231769654c63SDerek Basehore * @height: height in pixels of the panel, used for panel quirk detection 231869654c63SDerek Basehore * 231969654c63SDerek Basehore * Like drm_connector_set_panel_orientation(), but with a check for platform 232069654c63SDerek Basehore * specific (e.g. DMI based) quirks overriding the passed in panel_orientation. 232169654c63SDerek Basehore * 232269654c63SDerek Basehore * Returns: 232369654c63SDerek Basehore * Zero on success, negative errno on failure. 232469654c63SDerek Basehore */ 232569654c63SDerek Basehore int drm_connector_set_panel_orientation_with_quirk( 232669654c63SDerek Basehore struct drm_connector *connector, 232769654c63SDerek Basehore enum drm_panel_orientation panel_orientation, 232869654c63SDerek Basehore int width, int height) 232969654c63SDerek Basehore { 233069654c63SDerek Basehore int orientation_quirk; 233169654c63SDerek Basehore 233269654c63SDerek Basehore orientation_quirk = drm_get_panel_orientation_quirk(width, height); 233369654c63SDerek Basehore if (orientation_quirk != DRM_MODE_PANEL_ORIENTATION_UNKNOWN) 233469654c63SDerek Basehore panel_orientation = orientation_quirk; 233569654c63SDerek Basehore 233669654c63SDerek Basehore return drm_connector_set_panel_orientation(connector, 233769654c63SDerek Basehore panel_orientation); 233869654c63SDerek Basehore } 233969654c63SDerek Basehore EXPORT_SYMBOL(drm_connector_set_panel_orientation_with_quirk); 23408d70f395SHans de Goede 23415e41b01aSHsin-Yi Wang /** 23425e41b01aSHsin-Yi Wang * drm_connector_set_orientation_from_panel - 23435e41b01aSHsin-Yi Wang * set the connector's panel_orientation from panel's callback. 23445e41b01aSHsin-Yi Wang * @connector: connector for which to init the panel-orientation property. 23455e41b01aSHsin-Yi Wang * @panel: panel that can provide orientation information. 23465e41b01aSHsin-Yi Wang * 23475e41b01aSHsin-Yi Wang * Drm drivers should call this function before drm_dev_register(). 23485e41b01aSHsin-Yi Wang * Orientation is obtained from panel's .get_orientation() callback. 23495e41b01aSHsin-Yi Wang * 23505e41b01aSHsin-Yi Wang * Returns: 23515e41b01aSHsin-Yi Wang * Zero on success, negative errno on failure. 23525e41b01aSHsin-Yi Wang */ 23535e41b01aSHsin-Yi Wang int drm_connector_set_orientation_from_panel( 23545e41b01aSHsin-Yi Wang struct drm_connector *connector, 23555e41b01aSHsin-Yi Wang struct drm_panel *panel) 23565e41b01aSHsin-Yi Wang { 23575e41b01aSHsin-Yi Wang enum drm_panel_orientation orientation; 23585e41b01aSHsin-Yi Wang 23595e41b01aSHsin-Yi Wang if (panel && panel->funcs && panel->funcs->get_orientation) 23605e41b01aSHsin-Yi Wang orientation = panel->funcs->get_orientation(panel); 23615e41b01aSHsin-Yi Wang else 23625e41b01aSHsin-Yi Wang orientation = DRM_MODE_PANEL_ORIENTATION_UNKNOWN; 23635e41b01aSHsin-Yi Wang 23645e41b01aSHsin-Yi Wang return drm_connector_set_panel_orientation(connector, orientation); 23655e41b01aSHsin-Yi Wang } 23665e41b01aSHsin-Yi Wang EXPORT_SYMBOL(drm_connector_set_orientation_from_panel); 23675e41b01aSHsin-Yi Wang 2368107fe904SRajat Jain static const struct drm_prop_enum_list privacy_screen_enum[] = { 2369107fe904SRajat Jain { PRIVACY_SCREEN_DISABLED, "Disabled" }, 2370107fe904SRajat Jain { PRIVACY_SCREEN_ENABLED, "Enabled" }, 2371107fe904SRajat Jain { PRIVACY_SCREEN_DISABLED_LOCKED, "Disabled-locked" }, 2372107fe904SRajat Jain { PRIVACY_SCREEN_ENABLED_LOCKED, "Enabled-locked" }, 2373107fe904SRajat Jain }; 2374107fe904SRajat Jain 2375107fe904SRajat Jain /** 2376107fe904SRajat Jain * drm_connector_create_privacy_screen_properties - create the drm connecter's 2377107fe904SRajat Jain * privacy-screen properties. 2378107fe904SRajat Jain * @connector: connector for which to create the privacy-screen properties 2379107fe904SRajat Jain * 2380107fe904SRajat Jain * This function creates the "privacy-screen sw-state" and "privacy-screen 2381107fe904SRajat Jain * hw-state" properties for the connector. They are not attached. 2382107fe904SRajat Jain */ 2383107fe904SRajat Jain void 2384107fe904SRajat Jain drm_connector_create_privacy_screen_properties(struct drm_connector *connector) 2385107fe904SRajat Jain { 2386107fe904SRajat Jain if (connector->privacy_screen_sw_state_property) 2387107fe904SRajat Jain return; 2388107fe904SRajat Jain 2389107fe904SRajat Jain /* Note sw-state only supports the first 2 values of the enum */ 2390107fe904SRajat Jain connector->privacy_screen_sw_state_property = 2391107fe904SRajat Jain drm_property_create_enum(connector->dev, DRM_MODE_PROP_ENUM, 2392107fe904SRajat Jain "privacy-screen sw-state", 2393107fe904SRajat Jain privacy_screen_enum, 2); 2394107fe904SRajat Jain 2395107fe904SRajat Jain connector->privacy_screen_hw_state_property = 2396107fe904SRajat Jain drm_property_create_enum(connector->dev, 2397107fe904SRajat Jain DRM_MODE_PROP_IMMUTABLE | DRM_MODE_PROP_ENUM, 2398107fe904SRajat Jain "privacy-screen hw-state", 2399107fe904SRajat Jain privacy_screen_enum, 2400107fe904SRajat Jain ARRAY_SIZE(privacy_screen_enum)); 2401107fe904SRajat Jain } 2402107fe904SRajat Jain EXPORT_SYMBOL(drm_connector_create_privacy_screen_properties); 2403107fe904SRajat Jain 2404107fe904SRajat Jain /** 2405107fe904SRajat Jain * drm_connector_attach_privacy_screen_properties - attach the drm connecter's 2406107fe904SRajat Jain * privacy-screen properties. 2407107fe904SRajat Jain * @connector: connector on which to attach the privacy-screen properties 2408107fe904SRajat Jain * 2409107fe904SRajat Jain * This function attaches the "privacy-screen sw-state" and "privacy-screen 2410107fe904SRajat Jain * hw-state" properties to the connector. The initial state of both is set 2411107fe904SRajat Jain * to "Disabled". 2412107fe904SRajat Jain */ 2413107fe904SRajat Jain void 2414107fe904SRajat Jain drm_connector_attach_privacy_screen_properties(struct drm_connector *connector) 2415107fe904SRajat Jain { 2416107fe904SRajat Jain if (!connector->privacy_screen_sw_state_property) 2417107fe904SRajat Jain return; 2418107fe904SRajat Jain 2419107fe904SRajat Jain drm_object_attach_property(&connector->base, 2420107fe904SRajat Jain connector->privacy_screen_sw_state_property, 2421107fe904SRajat Jain PRIVACY_SCREEN_DISABLED); 2422107fe904SRajat Jain 2423107fe904SRajat Jain drm_object_attach_property(&connector->base, 2424107fe904SRajat Jain connector->privacy_screen_hw_state_property, 2425107fe904SRajat Jain PRIVACY_SCREEN_DISABLED); 2426107fe904SRajat Jain } 2427107fe904SRajat Jain EXPORT_SYMBOL(drm_connector_attach_privacy_screen_properties); 2428107fe904SRajat Jain 2429334f74eeSHans de Goede static void drm_connector_update_privacy_screen_properties( 2430334f74eeSHans de Goede struct drm_connector *connector, bool set_sw_state) 2431334f74eeSHans de Goede { 2432334f74eeSHans de Goede enum drm_privacy_screen_status sw_state, hw_state; 2433334f74eeSHans de Goede 2434334f74eeSHans de Goede drm_privacy_screen_get_state(connector->privacy_screen, 2435334f74eeSHans de Goede &sw_state, &hw_state); 2436334f74eeSHans de Goede 2437334f74eeSHans de Goede if (set_sw_state) 2438334f74eeSHans de Goede connector->state->privacy_screen_sw_state = sw_state; 2439334f74eeSHans de Goede drm_object_property_set_value(&connector->base, 2440334f74eeSHans de Goede connector->privacy_screen_hw_state_property, hw_state); 2441334f74eeSHans de Goede } 2442334f74eeSHans de Goede 2443334f74eeSHans de Goede static int drm_connector_privacy_screen_notifier( 2444334f74eeSHans de Goede struct notifier_block *nb, unsigned long action, void *data) 2445334f74eeSHans de Goede { 2446334f74eeSHans de Goede struct drm_connector *connector = 2447334f74eeSHans de Goede container_of(nb, struct drm_connector, privacy_screen_notifier); 2448334f74eeSHans de Goede struct drm_device *dev = connector->dev; 2449334f74eeSHans de Goede 2450334f74eeSHans de Goede drm_modeset_lock(&dev->mode_config.connection_mutex, NULL); 2451334f74eeSHans de Goede drm_connector_update_privacy_screen_properties(connector, true); 2452334f74eeSHans de Goede drm_modeset_unlock(&dev->mode_config.connection_mutex); 2453334f74eeSHans de Goede 2454334f74eeSHans de Goede drm_sysfs_connector_status_event(connector, 2455334f74eeSHans de Goede connector->privacy_screen_sw_state_property); 2456334f74eeSHans de Goede drm_sysfs_connector_status_event(connector, 2457334f74eeSHans de Goede connector->privacy_screen_hw_state_property); 2458334f74eeSHans de Goede 2459334f74eeSHans de Goede return NOTIFY_DONE; 2460334f74eeSHans de Goede } 2461334f74eeSHans de Goede 2462334f74eeSHans de Goede /** 2463334f74eeSHans de Goede * drm_connector_attach_privacy_screen_provider - attach a privacy-screen to 2464334f74eeSHans de Goede * the connector 2465334f74eeSHans de Goede * @connector: connector to attach the privacy-screen to 2466334f74eeSHans de Goede * @priv: drm_privacy_screen to attach 2467334f74eeSHans de Goede * 2468334f74eeSHans de Goede * Create and attach the standard privacy-screen properties and register 2469334f74eeSHans de Goede * a generic notifier for generating sysfs-connector-status-events 2470334f74eeSHans de Goede * on external changes to the privacy-screen status. 2471334f74eeSHans de Goede * This function takes ownership of the passed in drm_privacy_screen and will 2472334f74eeSHans de Goede * call drm_privacy_screen_put() on it when the connector is destroyed. 2473334f74eeSHans de Goede */ 2474334f74eeSHans de Goede void drm_connector_attach_privacy_screen_provider( 2475334f74eeSHans de Goede struct drm_connector *connector, struct drm_privacy_screen *priv) 2476334f74eeSHans de Goede { 2477334f74eeSHans de Goede connector->privacy_screen = priv; 2478334f74eeSHans de Goede connector->privacy_screen_notifier.notifier_call = 2479334f74eeSHans de Goede drm_connector_privacy_screen_notifier; 2480334f74eeSHans de Goede 2481334f74eeSHans de Goede drm_connector_create_privacy_screen_properties(connector); 2482334f74eeSHans de Goede drm_connector_update_privacy_screen_properties(connector, true); 2483334f74eeSHans de Goede drm_connector_attach_privacy_screen_properties(connector); 2484334f74eeSHans de Goede } 2485334f74eeSHans de Goede EXPORT_SYMBOL(drm_connector_attach_privacy_screen_provider); 2486334f74eeSHans de Goede 2487334f74eeSHans de Goede /** 2488334f74eeSHans de Goede * drm_connector_update_privacy_screen - update connector's privacy-screen sw-state 2489334f74eeSHans de Goede * @connector_state: connector-state to update the privacy-screen for 2490334f74eeSHans de Goede * 2491334f74eeSHans de Goede * This function calls drm_privacy_screen_set_sw_state() on the connector's 2492334f74eeSHans de Goede * privacy-screen. 2493334f74eeSHans de Goede * 2494334f74eeSHans de Goede * If the connector has no privacy-screen, then this is a no-op. 2495334f74eeSHans de Goede */ 2496334f74eeSHans de Goede void drm_connector_update_privacy_screen(const struct drm_connector_state *connector_state) 2497334f74eeSHans de Goede { 2498334f74eeSHans de Goede struct drm_connector *connector = connector_state->connector; 2499334f74eeSHans de Goede int ret; 2500334f74eeSHans de Goede 2501334f74eeSHans de Goede if (!connector->privacy_screen) 2502334f74eeSHans de Goede return; 2503334f74eeSHans de Goede 2504334f74eeSHans de Goede ret = drm_privacy_screen_set_sw_state(connector->privacy_screen, 2505334f74eeSHans de Goede connector_state->privacy_screen_sw_state); 2506334f74eeSHans de Goede if (ret) { 2507334f74eeSHans de Goede drm_err(connector->dev, "Error updating privacy-screen sw_state\n"); 2508334f74eeSHans de Goede return; 2509334f74eeSHans de Goede } 2510334f74eeSHans de Goede 2511334f74eeSHans de Goede /* The hw_state property value may have changed, update it. */ 2512334f74eeSHans de Goede drm_connector_update_privacy_screen_properties(connector, false); 2513334f74eeSHans de Goede } 2514334f74eeSHans de Goede EXPORT_SYMBOL(drm_connector_update_privacy_screen); 2515334f74eeSHans de Goede 251697e14fbeSDaniel Vetter int drm_connector_set_obj_prop(struct drm_mode_object *obj, 251752217195SDaniel Vetter struct drm_property *property, 251852217195SDaniel Vetter uint64_t value) 251952217195SDaniel Vetter { 252052217195SDaniel Vetter int ret = -EINVAL; 252152217195SDaniel Vetter struct drm_connector *connector = obj_to_connector(obj); 252252217195SDaniel Vetter 252352217195SDaniel Vetter /* Do DPMS ourselves */ 252452217195SDaniel Vetter if (property == connector->dev->mode_config.dpms_property) { 252552217195SDaniel Vetter ret = (*connector->funcs->dpms)(connector, (int)value); 252652217195SDaniel Vetter } else if (connector->funcs->set_property) 252752217195SDaniel Vetter ret = connector->funcs->set_property(connector, property, value); 252852217195SDaniel Vetter 2529144a7999SDaniel Vetter if (!ret) 253052217195SDaniel Vetter drm_object_property_set_value(&connector->base, property, value); 253152217195SDaniel Vetter return ret; 253252217195SDaniel Vetter } 253352217195SDaniel Vetter 253497e14fbeSDaniel Vetter int drm_connector_property_set_ioctl(struct drm_device *dev, 253552217195SDaniel Vetter void *data, struct drm_file *file_priv) 253652217195SDaniel Vetter { 253752217195SDaniel Vetter struct drm_mode_connector_set_property *conn_set_prop = data; 253852217195SDaniel Vetter struct drm_mode_obj_set_property obj_set_prop = { 253952217195SDaniel Vetter .value = conn_set_prop->value, 254052217195SDaniel Vetter .prop_id = conn_set_prop->prop_id, 254152217195SDaniel Vetter .obj_id = conn_set_prop->connector_id, 254252217195SDaniel Vetter .obj_type = DRM_MODE_OBJECT_CONNECTOR 254352217195SDaniel Vetter }; 254452217195SDaniel Vetter 254552217195SDaniel Vetter /* It does all the locking and checking we need */ 254652217195SDaniel Vetter return drm_mode_obj_set_property_ioctl(dev, &obj_set_prop, file_priv); 254752217195SDaniel Vetter } 254852217195SDaniel Vetter 254952217195SDaniel Vetter static struct drm_encoder *drm_connector_get_encoder(struct drm_connector *connector) 255052217195SDaniel Vetter { 255152217195SDaniel Vetter /* For atomic drivers only state objects are synchronously updated and 2552c2ce66daSBeatriz Martins de Carvalho * protected by modeset locks, so check those first. 2553c2ce66daSBeatriz Martins de Carvalho */ 255452217195SDaniel Vetter if (connector->state) 255552217195SDaniel Vetter return connector->state->best_encoder; 255652217195SDaniel Vetter return connector->encoder; 255752217195SDaniel Vetter } 255852217195SDaniel Vetter 2559c3ff0cdbSAnkit Nautiyal static bool 2560c3ff0cdbSAnkit Nautiyal drm_mode_expose_to_userspace(const struct drm_display_mode *mode, 25618445e2c5SVille Syrjälä const struct list_head *modes, 256252217195SDaniel Vetter const struct drm_file *file_priv) 256352217195SDaniel Vetter { 256452217195SDaniel Vetter /* 256552217195SDaniel Vetter * If user-space hasn't configured the driver to expose the stereo 3D 256652217195SDaniel Vetter * modes, don't expose them. 256752217195SDaniel Vetter */ 256852217195SDaniel Vetter if (!file_priv->stereo_allowed && drm_mode_is_stereo(mode)) 256952217195SDaniel Vetter return false; 2570c3ff0cdbSAnkit Nautiyal /* 2571c3ff0cdbSAnkit Nautiyal * If user-space hasn't configured the driver to expose the modes 2572c3ff0cdbSAnkit Nautiyal * with aspect-ratio, don't expose them. However if such a mode 2573c3ff0cdbSAnkit Nautiyal * is unique, let it be exposed, but reset the aspect-ratio flags 2574c3ff0cdbSAnkit Nautiyal * while preparing the list of user-modes. 2575c3ff0cdbSAnkit Nautiyal */ 2576c3ff0cdbSAnkit Nautiyal if (!file_priv->aspect_ratio_allowed) { 25778445e2c5SVille Syrjälä const struct drm_display_mode *mode_itr; 2578c3ff0cdbSAnkit Nautiyal 25798445e2c5SVille Syrjälä list_for_each_entry(mode_itr, modes, head) { 25808445e2c5SVille Syrjälä if (mode_itr->expose_to_userspace && 25818445e2c5SVille Syrjälä drm_mode_match(mode_itr, mode, 2582c3ff0cdbSAnkit Nautiyal DRM_MODE_MATCH_TIMINGS | 2583c3ff0cdbSAnkit Nautiyal DRM_MODE_MATCH_CLOCK | 2584c3ff0cdbSAnkit Nautiyal DRM_MODE_MATCH_FLAGS | 2585c3ff0cdbSAnkit Nautiyal DRM_MODE_MATCH_3D_FLAGS)) 2586c3ff0cdbSAnkit Nautiyal return false; 2587c3ff0cdbSAnkit Nautiyal } 25888445e2c5SVille Syrjälä } 258952217195SDaniel Vetter 259052217195SDaniel Vetter return true; 259152217195SDaniel Vetter } 259252217195SDaniel Vetter 259352217195SDaniel Vetter int drm_mode_getconnector(struct drm_device *dev, void *data, 259452217195SDaniel Vetter struct drm_file *file_priv) 259552217195SDaniel Vetter { 259652217195SDaniel Vetter struct drm_mode_get_connector *out_resp = data; 259752217195SDaniel Vetter struct drm_connector *connector; 259852217195SDaniel Vetter struct drm_encoder *encoder; 259952217195SDaniel Vetter struct drm_display_mode *mode; 260052217195SDaniel Vetter int mode_count = 0; 260152217195SDaniel Vetter int encoders_count = 0; 260252217195SDaniel Vetter int ret = 0; 260352217195SDaniel Vetter int copied = 0; 260452217195SDaniel Vetter struct drm_mode_modeinfo u_mode; 260552217195SDaniel Vetter struct drm_mode_modeinfo __user *mode_ptr; 260652217195SDaniel Vetter uint32_t __user *encoder_ptr; 2607869e76f7SDesmond Cheong Zhi Xi bool is_current_master; 260852217195SDaniel Vetter 260952217195SDaniel Vetter if (!drm_core_check_feature(dev, DRIVER_MODESET)) 261069fdf420SChris Wilson return -EOPNOTSUPP; 261152217195SDaniel Vetter 261252217195SDaniel Vetter memset(&u_mode, 0, sizeof(struct drm_mode_modeinfo)); 261352217195SDaniel Vetter 2614418da172SKeith Packard connector = drm_connector_lookup(dev, file_priv, out_resp->connector_id); 261591eefc05SDaniel Vetter if (!connector) 261691eefc05SDaniel Vetter return -ENOENT; 261752217195SDaniel Vetter 261862afb4adSJosé Roberto de Souza encoders_count = hweight32(connector->possible_encoders); 261991eefc05SDaniel Vetter 262091eefc05SDaniel Vetter if ((out_resp->count_encoders >= encoders_count) && encoders_count) { 262191eefc05SDaniel Vetter copied = 0; 262291eefc05SDaniel Vetter encoder_ptr = (uint32_t __user *)(unsigned long)(out_resp->encoders_ptr); 262383aefbb8SVille Syrjälä 262462afb4adSJosé Roberto de Souza drm_connector_for_each_possible_encoder(connector, encoder) { 262583aefbb8SVille Syrjälä if (put_user(encoder->base.id, encoder_ptr + copied)) { 262691eefc05SDaniel Vetter ret = -EFAULT; 2627e94ac351SDaniel Vetter goto out; 262891eefc05SDaniel Vetter } 262991eefc05SDaniel Vetter copied++; 263091eefc05SDaniel Vetter } 263191eefc05SDaniel Vetter } 263291eefc05SDaniel Vetter out_resp->count_encoders = encoders_count; 263391eefc05SDaniel Vetter 263491eefc05SDaniel Vetter out_resp->connector_id = connector->base.id; 263591eefc05SDaniel Vetter out_resp->connector_type = connector->connector_type; 263691eefc05SDaniel Vetter out_resp->connector_type_id = connector->connector_type_id; 263791eefc05SDaniel Vetter 2638869e76f7SDesmond Cheong Zhi Xi is_current_master = drm_is_current_master(file_priv); 2639869e76f7SDesmond Cheong Zhi Xi 264091eefc05SDaniel Vetter mutex_lock(&dev->mode_config.mutex); 264191eefc05SDaniel Vetter if (out_resp->count_modes == 0) { 2642869e76f7SDesmond Cheong Zhi Xi if (is_current_master) 264391eefc05SDaniel Vetter connector->funcs->fill_modes(connector, 264491eefc05SDaniel Vetter dev->mode_config.max_width, 264591eefc05SDaniel Vetter dev->mode_config.max_height); 26468f86c82aSSimon Ser else 26478f86c82aSSimon Ser drm_dbg_kms(dev, "User-space requested a forced probe on [CONNECTOR:%d:%s] but is not the DRM master, demoting to read-only probe", 26488f86c82aSSimon Ser connector->base.id, connector->name); 264991eefc05SDaniel Vetter } 265091eefc05SDaniel Vetter 265191eefc05SDaniel Vetter out_resp->mm_width = connector->display_info.width_mm; 265291eefc05SDaniel Vetter out_resp->mm_height = connector->display_info.height_mm; 265391eefc05SDaniel Vetter out_resp->subpixel = connector->display_info.subpixel_order; 265491eefc05SDaniel Vetter out_resp->connection = connector->status; 265591eefc05SDaniel Vetter 265691eefc05SDaniel Vetter /* delayed so we get modes regardless of pre-fill_modes state */ 26578445e2c5SVille Syrjälä list_for_each_entry(mode, &connector->modes, head) { 26588445e2c5SVille Syrjälä WARN_ON(mode->expose_to_userspace); 26598445e2c5SVille Syrjälä 26608445e2c5SVille Syrjälä if (drm_mode_expose_to_userspace(mode, &connector->modes, 2661c3ff0cdbSAnkit Nautiyal file_priv)) { 26628445e2c5SVille Syrjälä mode->expose_to_userspace = true; 266391eefc05SDaniel Vetter mode_count++; 2664c3ff0cdbSAnkit Nautiyal } 26658445e2c5SVille Syrjälä } 266691eefc05SDaniel Vetter 266752217195SDaniel Vetter /* 266852217195SDaniel Vetter * This ioctl is called twice, once to determine how much space is 266952217195SDaniel Vetter * needed, and the 2nd time to fill it. 267052217195SDaniel Vetter */ 267152217195SDaniel Vetter if ((out_resp->count_modes >= mode_count) && mode_count) { 267252217195SDaniel Vetter copied = 0; 267352217195SDaniel Vetter mode_ptr = (struct drm_mode_modeinfo __user *)(unsigned long)out_resp->modes_ptr; 26748445e2c5SVille Syrjälä list_for_each_entry(mode, &connector->modes, head) { 26758445e2c5SVille Syrjälä if (!mode->expose_to_userspace) 26768445e2c5SVille Syrjälä continue; 26778445e2c5SVille Syrjälä 26788445e2c5SVille Syrjälä /* Clear the tag for the next time around */ 26798445e2c5SVille Syrjälä mode->expose_to_userspace = false; 26808445e2c5SVille Syrjälä 268152217195SDaniel Vetter drm_mode_convert_to_umode(&u_mode, mode); 2682c3ff0cdbSAnkit Nautiyal /* 2683c3ff0cdbSAnkit Nautiyal * Reset aspect ratio flags of user-mode, if modes with 2684c3ff0cdbSAnkit Nautiyal * aspect-ratio are not supported. 2685c3ff0cdbSAnkit Nautiyal */ 2686c3ff0cdbSAnkit Nautiyal if (!file_priv->aspect_ratio_allowed) 2687c3ff0cdbSAnkit Nautiyal u_mode.flags &= ~DRM_MODE_FLAG_PIC_AR_MASK; 268852217195SDaniel Vetter if (copy_to_user(mode_ptr + copied, 268952217195SDaniel Vetter &u_mode, sizeof(u_mode))) { 269052217195SDaniel Vetter ret = -EFAULT; 26918445e2c5SVille Syrjälä 26928445e2c5SVille Syrjälä /* 26938445e2c5SVille Syrjälä * Clear the tag for the rest of 26948445e2c5SVille Syrjälä * the modes for the next time around. 26958445e2c5SVille Syrjälä */ 26968445e2c5SVille Syrjälä list_for_each_entry_continue(mode, &connector->modes, head) 26978445e2c5SVille Syrjälä mode->expose_to_userspace = false; 26988445e2c5SVille Syrjälä 2699e94ac351SDaniel Vetter mutex_unlock(&dev->mode_config.mutex); 2700e94ac351SDaniel Vetter 270152217195SDaniel Vetter goto out; 270252217195SDaniel Vetter } 270352217195SDaniel Vetter copied++; 270452217195SDaniel Vetter } 27058445e2c5SVille Syrjälä } else { 27068445e2c5SVille Syrjälä /* Clear the tag for the next time around */ 27078445e2c5SVille Syrjälä list_for_each_entry(mode, &connector->modes, head) 27088445e2c5SVille Syrjälä mode->expose_to_userspace = false; 270952217195SDaniel Vetter } 27108445e2c5SVille Syrjälä 271152217195SDaniel Vetter out_resp->count_modes = mode_count; 271252217195SDaniel Vetter mutex_unlock(&dev->mode_config.mutex); 2713e94ac351SDaniel Vetter 2714e94ac351SDaniel Vetter drm_modeset_lock(&dev->mode_config.connection_mutex, NULL); 2715e94ac351SDaniel Vetter encoder = drm_connector_get_encoder(connector); 2716e94ac351SDaniel Vetter if (encoder) 2717e94ac351SDaniel Vetter out_resp->encoder_id = encoder->base.id; 2718e94ac351SDaniel Vetter else 2719e94ac351SDaniel Vetter out_resp->encoder_id = 0; 2720e94ac351SDaniel Vetter 2721e94ac351SDaniel Vetter /* Only grab properties after probing, to make sure EDID and other 2722c2ce66daSBeatriz Martins de Carvalho * properties reflect the latest status. 2723c2ce66daSBeatriz Martins de Carvalho */ 2724e94ac351SDaniel Vetter ret = drm_mode_object_get_properties(&connector->base, file_priv->atomic, 2725e94ac351SDaniel Vetter (uint32_t __user *)(unsigned long)(out_resp->props_ptr), 2726e94ac351SDaniel Vetter (uint64_t __user *)(unsigned long)(out_resp->prop_values_ptr), 2727e94ac351SDaniel Vetter &out_resp->count_props); 2728e94ac351SDaniel Vetter drm_modeset_unlock(&dev->mode_config.connection_mutex); 2729e94ac351SDaniel Vetter 2730e94ac351SDaniel Vetter out: 2731ad093607SThierry Reding drm_connector_put(connector); 273252217195SDaniel Vetter 273352217195SDaniel Vetter return ret; 273452217195SDaniel Vetter } 273552217195SDaniel Vetter 27363d3f7c1eSHans de Goede /** 27373d3f7c1eSHans de Goede * drm_connector_find_by_fwnode - Find a connector based on the associated fwnode 27383d3f7c1eSHans de Goede * @fwnode: fwnode for which to find the matching drm_connector 27393d3f7c1eSHans de Goede * 27403d3f7c1eSHans de Goede * This functions looks up a drm_connector based on its associated fwnode. When 27413d3f7c1eSHans de Goede * a connector is found a reference to the connector is returned. The caller must 27423d3f7c1eSHans de Goede * call drm_connector_put() to release this reference when it is done with the 27433d3f7c1eSHans de Goede * connector. 27443d3f7c1eSHans de Goede * 27453d3f7c1eSHans de Goede * Returns: A reference to the found connector or an ERR_PTR(). 27463d3f7c1eSHans de Goede */ 27473d3f7c1eSHans de Goede struct drm_connector *drm_connector_find_by_fwnode(struct fwnode_handle *fwnode) 27483d3f7c1eSHans de Goede { 27493d3f7c1eSHans de Goede struct drm_connector *connector, *found = ERR_PTR(-ENODEV); 27503d3f7c1eSHans de Goede 27513d3f7c1eSHans de Goede if (!fwnode) 27523d3f7c1eSHans de Goede return ERR_PTR(-ENODEV); 27533d3f7c1eSHans de Goede 27543d3f7c1eSHans de Goede mutex_lock(&connector_list_lock); 27553d3f7c1eSHans de Goede 27563d3f7c1eSHans de Goede list_for_each_entry(connector, &connector_list, global_connector_list_entry) { 27573d3f7c1eSHans de Goede if (connector->fwnode == fwnode || 27583d3f7c1eSHans de Goede (connector->fwnode && connector->fwnode->secondary == fwnode)) { 27593d3f7c1eSHans de Goede drm_connector_get(connector); 27603d3f7c1eSHans de Goede found = connector; 27613d3f7c1eSHans de Goede break; 27623d3f7c1eSHans de Goede } 27633d3f7c1eSHans de Goede } 27643d3f7c1eSHans de Goede 27653d3f7c1eSHans de Goede mutex_unlock(&connector_list_lock); 27663d3f7c1eSHans de Goede 27673d3f7c1eSHans de Goede return found; 27683d3f7c1eSHans de Goede } 27693d3f7c1eSHans de Goede 277072ad4968SHans de Goede /** 277172ad4968SHans de Goede * drm_connector_oob_hotplug_event - Report out-of-band hotplug event to connector 2772f85d9e59SRandy Dunlap * @connector_fwnode: fwnode_handle to report the event on 277372ad4968SHans de Goede * 277472ad4968SHans de Goede * On some hardware a hotplug event notification may come from outside the display 277572ad4968SHans de Goede * driver / device. An example of this is some USB Type-C setups where the hardware 277672ad4968SHans de Goede * muxes the DisplayPort data and aux-lines but does not pass the altmode HPD 277772ad4968SHans de Goede * status bit to the GPU's DP HPD pin. 277872ad4968SHans de Goede * 277972ad4968SHans de Goede * This function can be used to report these out-of-band events after obtaining 278072ad4968SHans de Goede * a drm_connector reference through calling drm_connector_find_by_fwnode(). 278172ad4968SHans de Goede */ 278272ad4968SHans de Goede void drm_connector_oob_hotplug_event(struct fwnode_handle *connector_fwnode) 278372ad4968SHans de Goede { 278472ad4968SHans de Goede struct drm_connector *connector; 278572ad4968SHans de Goede 278672ad4968SHans de Goede connector = drm_connector_find_by_fwnode(connector_fwnode); 278772ad4968SHans de Goede if (IS_ERR(connector)) 278872ad4968SHans de Goede return; 278972ad4968SHans de Goede 279072ad4968SHans de Goede if (connector->funcs->oob_hotplug_event) 279172ad4968SHans de Goede connector->funcs->oob_hotplug_event(connector); 279272ad4968SHans de Goede 279372ad4968SHans de Goede drm_connector_put(connector); 279472ad4968SHans de Goede } 279572ad4968SHans de Goede EXPORT_SYMBOL(drm_connector_oob_hotplug_event); 279672ad4968SHans de Goede 27979498c19bSDaniel Vetter 27989498c19bSDaniel Vetter /** 27999498c19bSDaniel Vetter * DOC: Tile group 28009498c19bSDaniel Vetter * 28019498c19bSDaniel Vetter * Tile groups are used to represent tiled monitors with a unique integer 28029498c19bSDaniel Vetter * identifier. Tiled monitors using DisplayID v1.3 have a unique 8-byte handle, 28039498c19bSDaniel Vetter * we store this in a tile group, so we have a common identifier for all tiles 28049498c19bSDaniel Vetter * in a monitor group. The property is called "TILE". Drivers can manage tile 28059498c19bSDaniel Vetter * groups using drm_mode_create_tile_group(), drm_mode_put_tile_group() and 28069498c19bSDaniel Vetter * drm_mode_get_tile_group(). But this is only needed for internal panels where 28079498c19bSDaniel Vetter * the tile group information is exposed through a non-standard way. 28089498c19bSDaniel Vetter */ 28099498c19bSDaniel Vetter 28109498c19bSDaniel Vetter static void drm_tile_group_free(struct kref *kref) 28119498c19bSDaniel Vetter { 28129498c19bSDaniel Vetter struct drm_tile_group *tg = container_of(kref, struct drm_tile_group, refcount); 28139498c19bSDaniel Vetter struct drm_device *dev = tg->dev; 2814948de842SSuraj Upadhyay 28159498c19bSDaniel Vetter mutex_lock(&dev->mode_config.idr_mutex); 28169498c19bSDaniel Vetter idr_remove(&dev->mode_config.tile_idr, tg->id); 28179498c19bSDaniel Vetter mutex_unlock(&dev->mode_config.idr_mutex); 28189498c19bSDaniel Vetter kfree(tg); 28199498c19bSDaniel Vetter } 28209498c19bSDaniel Vetter 28219498c19bSDaniel Vetter /** 28229498c19bSDaniel Vetter * drm_mode_put_tile_group - drop a reference to a tile group. 28239498c19bSDaniel Vetter * @dev: DRM device 28249498c19bSDaniel Vetter * @tg: tile group to drop reference to. 28259498c19bSDaniel Vetter * 28269498c19bSDaniel Vetter * drop reference to tile group and free if 0. 28279498c19bSDaniel Vetter */ 28289498c19bSDaniel Vetter void drm_mode_put_tile_group(struct drm_device *dev, 28299498c19bSDaniel Vetter struct drm_tile_group *tg) 28309498c19bSDaniel Vetter { 28319498c19bSDaniel Vetter kref_put(&tg->refcount, drm_tile_group_free); 28329498c19bSDaniel Vetter } 28339498c19bSDaniel Vetter EXPORT_SYMBOL(drm_mode_put_tile_group); 28349498c19bSDaniel Vetter 28359498c19bSDaniel Vetter /** 28369498c19bSDaniel Vetter * drm_mode_get_tile_group - get a reference to an existing tile group 28379498c19bSDaniel Vetter * @dev: DRM device 28389498c19bSDaniel Vetter * @topology: 8-bytes unique per monitor. 28399498c19bSDaniel Vetter * 28409498c19bSDaniel Vetter * Use the unique bytes to get a reference to an existing tile group. 28419498c19bSDaniel Vetter * 28429498c19bSDaniel Vetter * RETURNS: 28439498c19bSDaniel Vetter * tile group or NULL if not found. 28449498c19bSDaniel Vetter */ 28459498c19bSDaniel Vetter struct drm_tile_group *drm_mode_get_tile_group(struct drm_device *dev, 2846267ea759SVille Syrjälä const char topology[8]) 28479498c19bSDaniel Vetter { 28489498c19bSDaniel Vetter struct drm_tile_group *tg; 28499498c19bSDaniel Vetter int id; 2850948de842SSuraj Upadhyay 28519498c19bSDaniel Vetter mutex_lock(&dev->mode_config.idr_mutex); 28529498c19bSDaniel Vetter idr_for_each_entry(&dev->mode_config.tile_idr, tg, id) { 28539498c19bSDaniel Vetter if (!memcmp(tg->group_data, topology, 8)) { 28549498c19bSDaniel Vetter if (!kref_get_unless_zero(&tg->refcount)) 28559498c19bSDaniel Vetter tg = NULL; 28569498c19bSDaniel Vetter mutex_unlock(&dev->mode_config.idr_mutex); 28579498c19bSDaniel Vetter return tg; 28589498c19bSDaniel Vetter } 28599498c19bSDaniel Vetter } 28609498c19bSDaniel Vetter mutex_unlock(&dev->mode_config.idr_mutex); 28619498c19bSDaniel Vetter return NULL; 28629498c19bSDaniel Vetter } 28639498c19bSDaniel Vetter EXPORT_SYMBOL(drm_mode_get_tile_group); 28649498c19bSDaniel Vetter 28659498c19bSDaniel Vetter /** 28669498c19bSDaniel Vetter * drm_mode_create_tile_group - create a tile group from a displayid description 28679498c19bSDaniel Vetter * @dev: DRM device 28689498c19bSDaniel Vetter * @topology: 8-bytes unique per monitor. 28699498c19bSDaniel Vetter * 28709498c19bSDaniel Vetter * Create a tile group for the unique monitor, and get a unique 28719498c19bSDaniel Vetter * identifier for the tile group. 28729498c19bSDaniel Vetter * 28739498c19bSDaniel Vetter * RETURNS: 2874705c8160SDan Carpenter * new tile group or NULL. 28759498c19bSDaniel Vetter */ 28769498c19bSDaniel Vetter struct drm_tile_group *drm_mode_create_tile_group(struct drm_device *dev, 2877267ea759SVille Syrjälä const char topology[8]) 28789498c19bSDaniel Vetter { 28799498c19bSDaniel Vetter struct drm_tile_group *tg; 28809498c19bSDaniel Vetter int ret; 28819498c19bSDaniel Vetter 28829498c19bSDaniel Vetter tg = kzalloc(sizeof(*tg), GFP_KERNEL); 28839498c19bSDaniel Vetter if (!tg) 2884705c8160SDan Carpenter return NULL; 28859498c19bSDaniel Vetter 28869498c19bSDaniel Vetter kref_init(&tg->refcount); 28879498c19bSDaniel Vetter memcpy(tg->group_data, topology, 8); 28889498c19bSDaniel Vetter tg->dev = dev; 28899498c19bSDaniel Vetter 28909498c19bSDaniel Vetter mutex_lock(&dev->mode_config.idr_mutex); 28919498c19bSDaniel Vetter ret = idr_alloc(&dev->mode_config.tile_idr, tg, 1, 0, GFP_KERNEL); 28929498c19bSDaniel Vetter if (ret >= 0) { 28939498c19bSDaniel Vetter tg->id = ret; 28949498c19bSDaniel Vetter } else { 28959498c19bSDaniel Vetter kfree(tg); 2896705c8160SDan Carpenter tg = NULL; 28979498c19bSDaniel Vetter } 28989498c19bSDaniel Vetter 28999498c19bSDaniel Vetter mutex_unlock(&dev->mode_config.idr_mutex); 29009498c19bSDaniel Vetter return tg; 29019498c19bSDaniel Vetter } 29029498c19bSDaniel Vetter EXPORT_SYMBOL(drm_mode_create_tile_group); 2903