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> 2552217195SDaniel Vetter #include <drm/drm_edid.h> 269338203cSLaurent Pinchart #include <drm/drm_encoder.h> 275e41b01aSHsin-Yi Wang #include <drm/drm_panel.h> 288d70f395SHans de Goede #include <drm/drm_utils.h> 2999f45e32SDaniel Vetter #include <drm/drm_print.h> 3099f45e32SDaniel Vetter #include <drm/drm_drv.h> 3199f45e32SDaniel Vetter #include <drm/drm_file.h> 32334f74eeSHans de Goede #include <drm/drm_privacy_screen_consumer.h> 33968d81a6SJeykumar Sankaran #include <drm/drm_sysfs.h> 3499f45e32SDaniel Vetter 35*73289afeSVille 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 21752217195SDaniel Vetter /** 21852217195SDaniel Vetter * drm_connector_init - Init a preallocated connector 21952217195SDaniel Vetter * @dev: DRM device 22052217195SDaniel Vetter * @connector: the connector to init 22152217195SDaniel Vetter * @funcs: callbacks for this connector 22252217195SDaniel Vetter * @connector_type: user visible type of the connector 22352217195SDaniel Vetter * 22452217195SDaniel Vetter * Initialises a preallocated connector. Connectors should be 22552217195SDaniel Vetter * subclassed as part of driver connector objects. 22652217195SDaniel Vetter * 22752217195SDaniel Vetter * Returns: 22852217195SDaniel Vetter * Zero on success, error code on failure. 22952217195SDaniel Vetter */ 23052217195SDaniel Vetter int drm_connector_init(struct drm_device *dev, 23152217195SDaniel Vetter struct drm_connector *connector, 23252217195SDaniel Vetter const struct drm_connector_funcs *funcs, 23352217195SDaniel Vetter int connector_type) 23452217195SDaniel Vetter { 23552217195SDaniel Vetter struct drm_mode_config *config = &dev->mode_config; 23652217195SDaniel Vetter int ret; 23752217195SDaniel Vetter struct ida *connector_ida = 23852217195SDaniel Vetter &drm_connector_enum_list[connector_type].ida; 23952217195SDaniel Vetter 240ba1f665fSHaneen Mohammed WARN_ON(drm_drv_uses_atomic_modeset(dev) && 241ba1f665fSHaneen Mohammed (!funcs->atomic_destroy_state || 242ba1f665fSHaneen Mohammed !funcs->atomic_duplicate_state)); 243ba1f665fSHaneen Mohammed 2442135ea7aSThierry Reding ret = __drm_mode_object_add(dev, &connector->base, 24552217195SDaniel Vetter DRM_MODE_OBJECT_CONNECTOR, 24652217195SDaniel Vetter false, drm_connector_free); 24752217195SDaniel Vetter if (ret) 248613051daSDaniel Vetter return ret; 24952217195SDaniel Vetter 25052217195SDaniel Vetter connector->base.properties = &connector->properties; 25152217195SDaniel Vetter connector->dev = dev; 25252217195SDaniel Vetter connector->funcs = funcs; 25352217195SDaniel Vetter 2542a8d3eacSVille Syrjälä /* connector index is used with 32bit bitmasks */ 255e5d6eeeaSBo Liu ret = ida_alloc_max(&config->connector_ida, 31, GFP_KERNEL); 2562a8d3eacSVille Syrjälä if (ret < 0) { 2572a8d3eacSVille Syrjälä DRM_DEBUG_KMS("Failed to allocate %s connector index: %d\n", 2582a8d3eacSVille Syrjälä drm_connector_enum_list[connector_type].name, 2592a8d3eacSVille Syrjälä ret); 26052217195SDaniel Vetter goto out_put; 2612a8d3eacSVille Syrjälä } 26252217195SDaniel Vetter connector->index = ret; 26352217195SDaniel Vetter ret = 0; 26452217195SDaniel Vetter 26552217195SDaniel Vetter connector->connector_type = connector_type; 26652217195SDaniel Vetter connector->connector_type_id = 267e5d6eeeaSBo Liu ida_alloc_min(connector_ida, 1, GFP_KERNEL); 26852217195SDaniel Vetter if (connector->connector_type_id < 0) { 26952217195SDaniel Vetter ret = connector->connector_type_id; 27052217195SDaniel Vetter goto out_put_id; 27152217195SDaniel Vetter } 27252217195SDaniel Vetter connector->name = 27352217195SDaniel Vetter kasprintf(GFP_KERNEL, "%s-%d", 27452217195SDaniel Vetter drm_connector_enum_list[connector_type].name, 27552217195SDaniel Vetter connector->connector_type_id); 27652217195SDaniel Vetter if (!connector->name) { 27752217195SDaniel Vetter ret = -ENOMEM; 27852217195SDaniel Vetter goto out_put_type_id; 27952217195SDaniel Vetter } 28052217195SDaniel Vetter 2813d3f7c1eSHans de Goede INIT_LIST_HEAD(&connector->global_connector_list_entry); 28252217195SDaniel Vetter INIT_LIST_HEAD(&connector->probed_modes); 28352217195SDaniel Vetter INIT_LIST_HEAD(&connector->modes); 284e73ab00eSDaniel Vetter mutex_init(&connector->mutex); 28552217195SDaniel Vetter connector->edid_blob_ptr = NULL; 2865186421cSStanislav Lisovskiy connector->epoch_counter = 0; 2872de3a078SManasi Navare connector->tile_blob_ptr = NULL; 28852217195SDaniel Vetter connector->status = connector_status_unknown; 2898d70f395SHans de Goede connector->display_info.panel_orientation = 2908d70f395SHans de Goede DRM_MODE_PANEL_ORIENTATION_UNKNOWN; 29152217195SDaniel Vetter 29252217195SDaniel Vetter drm_connector_get_cmdline_mode(connector); 29352217195SDaniel Vetter 29452217195SDaniel Vetter /* We should add connectors at the end to avoid upsetting the connector 295c2ce66daSBeatriz Martins de Carvalho * index too much. 296c2ce66daSBeatriz Martins de Carvalho */ 297613051daSDaniel Vetter spin_lock_irq(&config->connector_list_lock); 29852217195SDaniel Vetter list_add_tail(&connector->head, &config->connector_list); 29952217195SDaniel Vetter config->num_connector++; 300613051daSDaniel Vetter spin_unlock_irq(&config->connector_list_lock); 30152217195SDaniel Vetter 302935774cdSBrian Starkey if (connector_type != DRM_MODE_CONNECTOR_VIRTUAL && 303935774cdSBrian Starkey connector_type != DRM_MODE_CONNECTOR_WRITEBACK) 3046b7e2d5cSGerd Hoffmann drm_connector_attach_edid_property(connector); 30552217195SDaniel Vetter 30652217195SDaniel Vetter drm_object_attach_property(&connector->base, 30752217195SDaniel Vetter config->dpms_property, 0); 30852217195SDaniel Vetter 30940ee6fbeSManasi Navare drm_object_attach_property(&connector->base, 31040ee6fbeSManasi Navare config->link_status_property, 31140ee6fbeSManasi Navare 0); 31240ee6fbeSManasi Navare 31366660d4cSDave Airlie drm_object_attach_property(&connector->base, 31466660d4cSDave Airlie config->non_desktop_property, 31566660d4cSDave Airlie 0); 3162de3a078SManasi Navare drm_object_attach_property(&connector->base, 3172de3a078SManasi Navare config->tile_property, 3182de3a078SManasi Navare 0); 31966660d4cSDave Airlie 32052217195SDaniel Vetter if (drm_core_check_feature(dev, DRIVER_ATOMIC)) { 32152217195SDaniel Vetter drm_object_attach_property(&connector->base, config->prop_crtc_id, 0); 32252217195SDaniel Vetter } 32352217195SDaniel Vetter 32452217195SDaniel Vetter connector->debugfs_entry = NULL; 32552217195SDaniel Vetter out_put_type_id: 32652217195SDaniel Vetter if (ret) 327e5d6eeeaSBo Liu ida_free(connector_ida, connector->connector_type_id); 32852217195SDaniel Vetter out_put_id: 32952217195SDaniel Vetter if (ret) 330e5d6eeeaSBo Liu ida_free(&config->connector_ida, connector->index); 33152217195SDaniel Vetter out_put: 33252217195SDaniel Vetter if (ret) 33352217195SDaniel Vetter drm_mode_object_unregister(dev, &connector->base); 33452217195SDaniel Vetter 33552217195SDaniel Vetter return ret; 33652217195SDaniel Vetter } 33752217195SDaniel Vetter EXPORT_SYMBOL(drm_connector_init); 33852217195SDaniel Vetter 33952217195SDaniel Vetter /** 340100163dfSAndrzej Pietrasiewicz * drm_connector_init_with_ddc - Init a preallocated connector 341100163dfSAndrzej Pietrasiewicz * @dev: DRM device 342100163dfSAndrzej Pietrasiewicz * @connector: the connector to init 343100163dfSAndrzej Pietrasiewicz * @funcs: callbacks for this connector 344100163dfSAndrzej Pietrasiewicz * @connector_type: user visible type of the connector 345100163dfSAndrzej Pietrasiewicz * @ddc: pointer to the associated ddc adapter 346100163dfSAndrzej Pietrasiewicz * 347100163dfSAndrzej Pietrasiewicz * Initialises a preallocated connector. Connectors should be 348100163dfSAndrzej Pietrasiewicz * subclassed as part of driver connector objects. 349100163dfSAndrzej Pietrasiewicz * 350100163dfSAndrzej Pietrasiewicz * Ensures that the ddc field of the connector is correctly set. 351100163dfSAndrzej Pietrasiewicz * 352100163dfSAndrzej Pietrasiewicz * Returns: 353100163dfSAndrzej Pietrasiewicz * Zero on success, error code on failure. 354100163dfSAndrzej Pietrasiewicz */ 355100163dfSAndrzej Pietrasiewicz int drm_connector_init_with_ddc(struct drm_device *dev, 356100163dfSAndrzej Pietrasiewicz struct drm_connector *connector, 357100163dfSAndrzej Pietrasiewicz const struct drm_connector_funcs *funcs, 358100163dfSAndrzej Pietrasiewicz int connector_type, 359100163dfSAndrzej Pietrasiewicz struct i2c_adapter *ddc) 360100163dfSAndrzej Pietrasiewicz { 361100163dfSAndrzej Pietrasiewicz int ret; 362100163dfSAndrzej Pietrasiewicz 363100163dfSAndrzej Pietrasiewicz ret = drm_connector_init(dev, connector, funcs, connector_type); 364100163dfSAndrzej Pietrasiewicz if (ret) 365100163dfSAndrzej Pietrasiewicz return ret; 366100163dfSAndrzej Pietrasiewicz 367100163dfSAndrzej Pietrasiewicz /* provide ddc symlink in sysfs */ 368100163dfSAndrzej Pietrasiewicz connector->ddc = ddc; 369100163dfSAndrzej Pietrasiewicz 370100163dfSAndrzej Pietrasiewicz return ret; 371100163dfSAndrzej Pietrasiewicz } 372100163dfSAndrzej Pietrasiewicz EXPORT_SYMBOL(drm_connector_init_with_ddc); 373100163dfSAndrzej Pietrasiewicz 374100163dfSAndrzej Pietrasiewicz /** 3756b7e2d5cSGerd Hoffmann * drm_connector_attach_edid_property - attach edid property. 3766b7e2d5cSGerd Hoffmann * @connector: the connector 3776b7e2d5cSGerd Hoffmann * 3786b7e2d5cSGerd Hoffmann * Some connector types like DRM_MODE_CONNECTOR_VIRTUAL do not get a 3796b7e2d5cSGerd Hoffmann * edid property attached by default. This function can be used to 3806b7e2d5cSGerd Hoffmann * explicitly enable the edid property in these cases. 3816b7e2d5cSGerd Hoffmann */ 3826b7e2d5cSGerd Hoffmann void drm_connector_attach_edid_property(struct drm_connector *connector) 3836b7e2d5cSGerd Hoffmann { 3846b7e2d5cSGerd Hoffmann struct drm_mode_config *config = &connector->dev->mode_config; 3856b7e2d5cSGerd Hoffmann 3866b7e2d5cSGerd Hoffmann drm_object_attach_property(&connector->base, 3876b7e2d5cSGerd Hoffmann config->edid_property, 3886b7e2d5cSGerd Hoffmann 0); 3896b7e2d5cSGerd Hoffmann } 3906b7e2d5cSGerd Hoffmann EXPORT_SYMBOL(drm_connector_attach_edid_property); 3916b7e2d5cSGerd Hoffmann 3926b7e2d5cSGerd Hoffmann /** 393cde4c44dSDaniel Vetter * drm_connector_attach_encoder - attach a connector to an encoder 39452217195SDaniel Vetter * @connector: connector to attach 39552217195SDaniel Vetter * @encoder: encoder to attach @connector to 39652217195SDaniel Vetter * 39752217195SDaniel Vetter * This function links up a connector to an encoder. Note that the routing 39852217195SDaniel Vetter * restrictions between encoders and crtcs are exposed to userspace through the 39952217195SDaniel Vetter * possible_clones and possible_crtcs bitmasks. 40052217195SDaniel Vetter * 40152217195SDaniel Vetter * Returns: 40252217195SDaniel Vetter * Zero on success, negative errno on failure. 40352217195SDaniel Vetter */ 404cde4c44dSDaniel Vetter int drm_connector_attach_encoder(struct drm_connector *connector, 40552217195SDaniel Vetter struct drm_encoder *encoder) 40652217195SDaniel Vetter { 40752217195SDaniel Vetter /* 40852217195SDaniel Vetter * In the past, drivers have attempted to model the static association 40952217195SDaniel Vetter * of connector to encoder in simple connector/encoder devices using a 41052217195SDaniel Vetter * direct assignment of connector->encoder = encoder. This connection 41152217195SDaniel Vetter * is a logical one and the responsibility of the core, so drivers are 41252217195SDaniel Vetter * expected not to mess with this. 41352217195SDaniel Vetter * 41452217195SDaniel Vetter * Note that the error return should've been enough here, but a large 41552217195SDaniel Vetter * majority of drivers ignores the return value, so add in a big WARN 41652217195SDaniel Vetter * to get people's attention. 41752217195SDaniel Vetter */ 41852217195SDaniel Vetter if (WARN_ON(connector->encoder)) 41952217195SDaniel Vetter return -EINVAL; 42052217195SDaniel Vetter 42162afb4adSJosé Roberto de Souza connector->possible_encoders |= drm_encoder_mask(encoder); 42262afb4adSJosé Roberto de Souza 42352217195SDaniel Vetter return 0; 42452217195SDaniel Vetter } 425cde4c44dSDaniel Vetter EXPORT_SYMBOL(drm_connector_attach_encoder); 42652217195SDaniel Vetter 42738cb8d96SVille Syrjälä /** 42862afb4adSJosé Roberto de Souza * drm_connector_has_possible_encoder - check if the connector and encoder are 42962afb4adSJosé Roberto de Souza * associated with each other 43038cb8d96SVille Syrjälä * @connector: the connector 43138cb8d96SVille Syrjälä * @encoder: the encoder 43238cb8d96SVille Syrjälä * 43338cb8d96SVille Syrjälä * Returns: 43438cb8d96SVille Syrjälä * True if @encoder is one of the possible encoders for @connector. 43538cb8d96SVille Syrjälä */ 43638cb8d96SVille Syrjälä bool drm_connector_has_possible_encoder(struct drm_connector *connector, 43738cb8d96SVille Syrjälä struct drm_encoder *encoder) 43838cb8d96SVille Syrjälä { 43962afb4adSJosé Roberto de Souza return connector->possible_encoders & drm_encoder_mask(encoder); 44038cb8d96SVille Syrjälä } 44138cb8d96SVille Syrjälä EXPORT_SYMBOL(drm_connector_has_possible_encoder); 44238cb8d96SVille Syrjälä 44352217195SDaniel Vetter static void drm_mode_remove(struct drm_connector *connector, 44452217195SDaniel Vetter struct drm_display_mode *mode) 44552217195SDaniel Vetter { 44652217195SDaniel Vetter list_del(&mode->head); 44752217195SDaniel Vetter drm_mode_destroy(connector->dev, mode); 44852217195SDaniel Vetter } 44952217195SDaniel Vetter 45052217195SDaniel Vetter /** 45152217195SDaniel Vetter * drm_connector_cleanup - cleans up an initialised connector 45252217195SDaniel Vetter * @connector: connector to cleanup 45352217195SDaniel Vetter * 45452217195SDaniel Vetter * Cleans up the connector but doesn't free the object. 45552217195SDaniel Vetter */ 45652217195SDaniel Vetter void drm_connector_cleanup(struct drm_connector *connector) 45752217195SDaniel Vetter { 45852217195SDaniel Vetter struct drm_device *dev = connector->dev; 45952217195SDaniel Vetter struct drm_display_mode *mode, *t; 46052217195SDaniel Vetter 46152217195SDaniel Vetter /* The connector should have been removed from userspace long before 46252217195SDaniel Vetter * it is finally destroyed. 46352217195SDaniel Vetter */ 46439b50c60SLyude Paul if (WARN_ON(connector->registration_state == 46539b50c60SLyude Paul DRM_CONNECTOR_REGISTERED)) 46652217195SDaniel Vetter drm_connector_unregister(connector); 46752217195SDaniel Vetter 468334f74eeSHans de Goede if (connector->privacy_screen) { 469334f74eeSHans de Goede drm_privacy_screen_put(connector->privacy_screen); 470334f74eeSHans de Goede connector->privacy_screen = NULL; 471334f74eeSHans de Goede } 472334f74eeSHans de Goede 47352217195SDaniel Vetter if (connector->tile_group) { 47452217195SDaniel Vetter drm_mode_put_tile_group(dev, connector->tile_group); 47552217195SDaniel Vetter connector->tile_group = NULL; 47652217195SDaniel Vetter } 47752217195SDaniel Vetter 47852217195SDaniel Vetter list_for_each_entry_safe(mode, t, &connector->probed_modes, head) 47952217195SDaniel Vetter drm_mode_remove(connector, mode); 48052217195SDaniel Vetter 48152217195SDaniel Vetter list_for_each_entry_safe(mode, t, &connector->modes, head) 48252217195SDaniel Vetter drm_mode_remove(connector, mode); 48352217195SDaniel Vetter 484e5d6eeeaSBo Liu ida_free(&drm_connector_enum_list[connector->connector_type].ida, 48552217195SDaniel Vetter connector->connector_type_id); 48652217195SDaniel Vetter 487e5d6eeeaSBo Liu ida_free(&dev->mode_config.connector_ida, connector->index); 48852217195SDaniel Vetter 48952217195SDaniel Vetter kfree(connector->display_info.bus_formats); 49052217195SDaniel Vetter drm_mode_object_unregister(dev, &connector->base); 49152217195SDaniel Vetter kfree(connector->name); 49252217195SDaniel Vetter connector->name = NULL; 49348c429c6SHans de Goede fwnode_handle_put(connector->fwnode); 49448c429c6SHans de Goede connector->fwnode = NULL; 495613051daSDaniel Vetter spin_lock_irq(&dev->mode_config.connector_list_lock); 49652217195SDaniel Vetter list_del(&connector->head); 49752217195SDaniel Vetter dev->mode_config.num_connector--; 498613051daSDaniel Vetter spin_unlock_irq(&dev->mode_config.connector_list_lock); 49952217195SDaniel Vetter 50052217195SDaniel Vetter WARN_ON(connector->state && !connector->funcs->atomic_destroy_state); 50152217195SDaniel Vetter if (connector->state && connector->funcs->atomic_destroy_state) 50252217195SDaniel Vetter connector->funcs->atomic_destroy_state(connector, 50352217195SDaniel Vetter connector->state); 50452217195SDaniel Vetter 505e73ab00eSDaniel Vetter mutex_destroy(&connector->mutex); 506e73ab00eSDaniel Vetter 50752217195SDaniel Vetter memset(connector, 0, sizeof(*connector)); 50852217195SDaniel Vetter } 50952217195SDaniel Vetter EXPORT_SYMBOL(drm_connector_cleanup); 51052217195SDaniel Vetter 51152217195SDaniel Vetter /** 51252217195SDaniel Vetter * drm_connector_register - register a connector 51352217195SDaniel Vetter * @connector: the connector to register 51452217195SDaniel Vetter * 51569b22f51SDaniel Vetter * Register userspace interfaces for a connector. Only call this for connectors 51669b22f51SDaniel Vetter * which can be hotplugged after drm_dev_register() has been called already, 51769b22f51SDaniel Vetter * e.g. DP MST connectors. All other connectors will be registered automatically 51869b22f51SDaniel Vetter * when calling drm_dev_register(). 51952217195SDaniel Vetter * 52052217195SDaniel Vetter * Returns: 52152217195SDaniel Vetter * Zero on success, error code on failure. 52252217195SDaniel Vetter */ 52352217195SDaniel Vetter int drm_connector_register(struct drm_connector *connector) 52452217195SDaniel Vetter { 525e73ab00eSDaniel Vetter int ret = 0; 52652217195SDaniel Vetter 527e6e7b48bSDaniel Vetter if (!connector->dev->registered) 528e6e7b48bSDaniel Vetter return 0; 529e6e7b48bSDaniel Vetter 530e73ab00eSDaniel Vetter mutex_lock(&connector->mutex); 53139b50c60SLyude Paul if (connector->registration_state != DRM_CONNECTOR_INITIALIZING) 532e73ab00eSDaniel Vetter goto unlock; 53352217195SDaniel Vetter 53452217195SDaniel Vetter ret = drm_sysfs_connector_add(connector); 53552217195SDaniel Vetter if (ret) 536e73ab00eSDaniel Vetter goto unlock; 53752217195SDaniel Vetter 538b792e640SGreg Kroah-Hartman drm_debugfs_connector_add(connector); 53952217195SDaniel Vetter 54052217195SDaniel Vetter if (connector->funcs->late_register) { 54152217195SDaniel Vetter ret = connector->funcs->late_register(connector); 54252217195SDaniel Vetter if (ret) 54352217195SDaniel Vetter goto err_debugfs; 54452217195SDaniel Vetter } 54552217195SDaniel Vetter 54652217195SDaniel Vetter drm_mode_object_register(connector->dev, &connector->base); 54752217195SDaniel Vetter 54839b50c60SLyude Paul connector->registration_state = DRM_CONNECTOR_REGISTERED; 549968d81a6SJeykumar Sankaran 550968d81a6SJeykumar Sankaran /* Let userspace know we have a new connector */ 551ad935754SSimon Ser drm_sysfs_connector_hotplug_event(connector); 552968d81a6SJeykumar Sankaran 553334f74eeSHans de Goede if (connector->privacy_screen) 554334f74eeSHans de Goede drm_privacy_screen_register_notifier(connector->privacy_screen, 555334f74eeSHans de Goede &connector->privacy_screen_notifier); 556334f74eeSHans de Goede 5573d3f7c1eSHans de Goede mutex_lock(&connector_list_lock); 5583d3f7c1eSHans de Goede list_add_tail(&connector->global_connector_list_entry, &connector_list); 5593d3f7c1eSHans de Goede mutex_unlock(&connector_list_lock); 560e73ab00eSDaniel Vetter goto unlock; 56152217195SDaniel Vetter 56252217195SDaniel Vetter err_debugfs: 56352217195SDaniel Vetter drm_debugfs_connector_remove(connector); 56452217195SDaniel Vetter drm_sysfs_connector_remove(connector); 565e73ab00eSDaniel Vetter unlock: 566e73ab00eSDaniel Vetter mutex_unlock(&connector->mutex); 56752217195SDaniel Vetter return ret; 56852217195SDaniel Vetter } 56952217195SDaniel Vetter EXPORT_SYMBOL(drm_connector_register); 57052217195SDaniel Vetter 57152217195SDaniel Vetter /** 57252217195SDaniel Vetter * drm_connector_unregister - unregister a connector 57352217195SDaniel Vetter * @connector: the connector to unregister 57452217195SDaniel Vetter * 57569b22f51SDaniel Vetter * Unregister userspace interfaces for a connector. Only call this for 57669b22f51SDaniel Vetter * connectors which have registered explicitly by calling drm_dev_register(), 57769b22f51SDaniel Vetter * since connectors are unregistered automatically when drm_dev_unregister() is 57869b22f51SDaniel Vetter * called. 57952217195SDaniel Vetter */ 58052217195SDaniel Vetter void drm_connector_unregister(struct drm_connector *connector) 58152217195SDaniel Vetter { 582e73ab00eSDaniel Vetter mutex_lock(&connector->mutex); 58339b50c60SLyude Paul if (connector->registration_state != DRM_CONNECTOR_REGISTERED) { 584e73ab00eSDaniel Vetter mutex_unlock(&connector->mutex); 58552217195SDaniel Vetter return; 586e73ab00eSDaniel Vetter } 58752217195SDaniel Vetter 5883d3f7c1eSHans de Goede mutex_lock(&connector_list_lock); 5893d3f7c1eSHans de Goede list_del_init(&connector->global_connector_list_entry); 5903d3f7c1eSHans de Goede mutex_unlock(&connector_list_lock); 5913d3f7c1eSHans de Goede 592334f74eeSHans de Goede if (connector->privacy_screen) 593334f74eeSHans de Goede drm_privacy_screen_unregister_notifier( 594334f74eeSHans de Goede connector->privacy_screen, 595334f74eeSHans de Goede &connector->privacy_screen_notifier); 596334f74eeSHans de Goede 59752217195SDaniel Vetter if (connector->funcs->early_unregister) 59852217195SDaniel Vetter connector->funcs->early_unregister(connector); 59952217195SDaniel Vetter 60052217195SDaniel Vetter drm_sysfs_connector_remove(connector); 60152217195SDaniel Vetter drm_debugfs_connector_remove(connector); 60252217195SDaniel Vetter 60339b50c60SLyude Paul connector->registration_state = DRM_CONNECTOR_UNREGISTERED; 604e73ab00eSDaniel Vetter mutex_unlock(&connector->mutex); 60552217195SDaniel Vetter } 60652217195SDaniel Vetter EXPORT_SYMBOL(drm_connector_unregister); 60752217195SDaniel Vetter 60852217195SDaniel Vetter void drm_connector_unregister_all(struct drm_device *dev) 60952217195SDaniel Vetter { 61052217195SDaniel Vetter struct drm_connector *connector; 611613051daSDaniel Vetter struct drm_connector_list_iter conn_iter; 61252217195SDaniel Vetter 613b982dab1SThierry Reding drm_connector_list_iter_begin(dev, &conn_iter); 614613051daSDaniel Vetter drm_for_each_connector_iter(connector, &conn_iter) 61552217195SDaniel Vetter drm_connector_unregister(connector); 616b982dab1SThierry Reding drm_connector_list_iter_end(&conn_iter); 61752217195SDaniel Vetter } 61852217195SDaniel Vetter 61952217195SDaniel Vetter int drm_connector_register_all(struct drm_device *dev) 62052217195SDaniel Vetter { 62152217195SDaniel Vetter struct drm_connector *connector; 622613051daSDaniel Vetter struct drm_connector_list_iter conn_iter; 623613051daSDaniel Vetter int ret = 0; 62452217195SDaniel Vetter 625b982dab1SThierry Reding drm_connector_list_iter_begin(dev, &conn_iter); 626613051daSDaniel Vetter drm_for_each_connector_iter(connector, &conn_iter) { 62752217195SDaniel Vetter ret = drm_connector_register(connector); 62852217195SDaniel Vetter if (ret) 629613051daSDaniel Vetter break; 63052217195SDaniel Vetter } 631b982dab1SThierry Reding drm_connector_list_iter_end(&conn_iter); 63252217195SDaniel Vetter 633613051daSDaniel Vetter if (ret) 63452217195SDaniel Vetter drm_connector_unregister_all(dev); 63552217195SDaniel Vetter return ret; 63652217195SDaniel Vetter } 63752217195SDaniel Vetter 63852217195SDaniel Vetter /** 63952217195SDaniel Vetter * drm_get_connector_status_name - return a string for connector status 64052217195SDaniel Vetter * @status: connector status to compute name of 64152217195SDaniel Vetter * 64252217195SDaniel Vetter * In contrast to the other drm_get_*_name functions this one here returns a 64352217195SDaniel Vetter * const pointer and hence is threadsafe. 644f85d9e59SRandy Dunlap * 645f85d9e59SRandy Dunlap * Returns: connector status string 64652217195SDaniel Vetter */ 64752217195SDaniel Vetter const char *drm_get_connector_status_name(enum drm_connector_status status) 64852217195SDaniel Vetter { 64952217195SDaniel Vetter if (status == connector_status_connected) 65052217195SDaniel Vetter return "connected"; 65152217195SDaniel Vetter else if (status == connector_status_disconnected) 65252217195SDaniel Vetter return "disconnected"; 65352217195SDaniel Vetter else 65452217195SDaniel Vetter return "unknown"; 65552217195SDaniel Vetter } 65652217195SDaniel Vetter EXPORT_SYMBOL(drm_get_connector_status_name); 65752217195SDaniel Vetter 6586140cf20SJani Nikula /** 6596140cf20SJani Nikula * drm_get_connector_force_name - return a string for connector force 6606140cf20SJani Nikula * @force: connector force to get name of 6616140cf20SJani Nikula * 6626140cf20SJani Nikula * Returns: const pointer to name. 6636140cf20SJani Nikula */ 6646140cf20SJani Nikula const char *drm_get_connector_force_name(enum drm_connector_force force) 6656140cf20SJani Nikula { 6666140cf20SJani Nikula switch (force) { 6676140cf20SJani Nikula case DRM_FORCE_UNSPECIFIED: 6686140cf20SJani Nikula return "unspecified"; 6696140cf20SJani Nikula case DRM_FORCE_OFF: 6706140cf20SJani Nikula return "off"; 6716140cf20SJani Nikula case DRM_FORCE_ON: 6726140cf20SJani Nikula return "on"; 6736140cf20SJani Nikula case DRM_FORCE_ON_DIGITAL: 6746140cf20SJani Nikula return "digital"; 6756140cf20SJani Nikula default: 6766140cf20SJani Nikula return "unknown"; 6776140cf20SJani Nikula } 6786140cf20SJani Nikula } 6796140cf20SJani Nikula 680613051daSDaniel Vetter #ifdef CONFIG_LOCKDEP 681613051daSDaniel Vetter static struct lockdep_map connector_list_iter_dep_map = { 682613051daSDaniel Vetter .name = "drm_connector_list_iter" 683613051daSDaniel Vetter }; 684613051daSDaniel Vetter #endif 685613051daSDaniel Vetter 686613051daSDaniel Vetter /** 687b982dab1SThierry Reding * drm_connector_list_iter_begin - initialize a connector_list iterator 688613051daSDaniel Vetter * @dev: DRM device 689613051daSDaniel Vetter * @iter: connector_list iterator 690613051daSDaniel Vetter * 691d574528aSDaniel Vetter * Sets @iter up to walk the &drm_mode_config.connector_list of @dev. @iter 692b982dab1SThierry Reding * must always be cleaned up again by calling drm_connector_list_iter_end(). 693613051daSDaniel Vetter * Iteration itself happens using drm_connector_list_iter_next() or 694613051daSDaniel Vetter * drm_for_each_connector_iter(). 695613051daSDaniel Vetter */ 696b982dab1SThierry Reding void drm_connector_list_iter_begin(struct drm_device *dev, 697613051daSDaniel Vetter struct drm_connector_list_iter *iter) 698613051daSDaniel Vetter { 699613051daSDaniel Vetter iter->dev = dev; 700613051daSDaniel Vetter iter->conn = NULL; 701613051daSDaniel Vetter lock_acquire_shared_recursive(&connector_list_iter_dep_map, 0, 1, NULL, _RET_IP_); 702613051daSDaniel Vetter } 703b982dab1SThierry Reding EXPORT_SYMBOL(drm_connector_list_iter_begin); 704613051daSDaniel Vetter 705a703c550SDaniel Vetter /* 706a703c550SDaniel Vetter * Extra-safe connector put function that works in any context. Should only be 707a703c550SDaniel Vetter * used from the connector_iter functions, where we never really expect to 708a703c550SDaniel Vetter * actually release the connector when dropping our final reference. 709a703c550SDaniel Vetter */ 710a703c550SDaniel Vetter static void 711ea497bb9SDaniel Vetter __drm_connector_put_safe(struct drm_connector *conn) 712a703c550SDaniel Vetter { 713ea497bb9SDaniel Vetter struct drm_mode_config *config = &conn->dev->mode_config; 714ea497bb9SDaniel Vetter 715ea497bb9SDaniel Vetter lockdep_assert_held(&config->connector_list_lock); 716ea497bb9SDaniel Vetter 717ea497bb9SDaniel Vetter if (!refcount_dec_and_test(&conn->base.refcount.refcount)) 718ea497bb9SDaniel Vetter return; 719ea497bb9SDaniel Vetter 720ea497bb9SDaniel Vetter llist_add(&conn->free_node, &config->connector_free_list); 721ea497bb9SDaniel Vetter schedule_work(&config->connector_free_work); 722a703c550SDaniel Vetter } 723a703c550SDaniel Vetter 724613051daSDaniel Vetter /** 725613051daSDaniel Vetter * drm_connector_list_iter_next - return next connector 7264f45c778SLyude Paul * @iter: connector_list iterator 727613051daSDaniel Vetter * 728f85d9e59SRandy Dunlap * Returns: the next connector for @iter, or NULL when the list walk has 729613051daSDaniel Vetter * completed. 730613051daSDaniel Vetter */ 731613051daSDaniel Vetter struct drm_connector * 732613051daSDaniel Vetter drm_connector_list_iter_next(struct drm_connector_list_iter *iter) 733613051daSDaniel Vetter { 734613051daSDaniel Vetter struct drm_connector *old_conn = iter->conn; 735613051daSDaniel Vetter struct drm_mode_config *config = &iter->dev->mode_config; 736613051daSDaniel Vetter struct list_head *lhead; 737613051daSDaniel Vetter unsigned long flags; 738613051daSDaniel Vetter 739613051daSDaniel Vetter spin_lock_irqsave(&config->connector_list_lock, flags); 740613051daSDaniel Vetter lhead = old_conn ? &old_conn->head : &config->connector_list; 741613051daSDaniel Vetter 742613051daSDaniel Vetter do { 743613051daSDaniel Vetter if (lhead->next == &config->connector_list) { 744613051daSDaniel Vetter iter->conn = NULL; 745613051daSDaniel Vetter break; 746613051daSDaniel Vetter } 747613051daSDaniel Vetter 748613051daSDaniel Vetter lhead = lhead->next; 749613051daSDaniel Vetter iter->conn = list_entry(lhead, struct drm_connector, head); 750613051daSDaniel Vetter 751613051daSDaniel Vetter /* loop until it's not a zombie connector */ 752613051daSDaniel Vetter } while (!kref_get_unless_zero(&iter->conn->base.refcount)); 753613051daSDaniel Vetter 754613051daSDaniel Vetter if (old_conn) 755ea497bb9SDaniel Vetter __drm_connector_put_safe(old_conn); 756ea497bb9SDaniel Vetter spin_unlock_irqrestore(&config->connector_list_lock, flags); 757613051daSDaniel Vetter 758613051daSDaniel Vetter return iter->conn; 759613051daSDaniel Vetter } 760613051daSDaniel Vetter EXPORT_SYMBOL(drm_connector_list_iter_next); 761613051daSDaniel Vetter 762613051daSDaniel Vetter /** 763b982dab1SThierry Reding * drm_connector_list_iter_end - tear down a connector_list iterator 764613051daSDaniel Vetter * @iter: connector_list iterator 765613051daSDaniel Vetter * 766613051daSDaniel Vetter * Tears down @iter and releases any resources (like &drm_connector references) 767613051daSDaniel Vetter * acquired while walking the list. This must always be called, both when the 768613051daSDaniel Vetter * iteration completes fully or when it was aborted without walking the entire 769613051daSDaniel Vetter * list. 770613051daSDaniel Vetter */ 771b982dab1SThierry Reding void drm_connector_list_iter_end(struct drm_connector_list_iter *iter) 772613051daSDaniel Vetter { 773ea497bb9SDaniel Vetter struct drm_mode_config *config = &iter->dev->mode_config; 774ea497bb9SDaniel Vetter unsigned long flags; 775ea497bb9SDaniel Vetter 776613051daSDaniel Vetter iter->dev = NULL; 777ea497bb9SDaniel Vetter if (iter->conn) { 778ea497bb9SDaniel Vetter spin_lock_irqsave(&config->connector_list_lock, flags); 779ea497bb9SDaniel Vetter __drm_connector_put_safe(iter->conn); 780ea497bb9SDaniel Vetter spin_unlock_irqrestore(&config->connector_list_lock, flags); 781ea497bb9SDaniel Vetter } 7825facae4fSQian Cai lock_release(&connector_list_iter_dep_map, _RET_IP_); 783613051daSDaniel Vetter } 784b982dab1SThierry Reding EXPORT_SYMBOL(drm_connector_list_iter_end); 785613051daSDaniel Vetter 78652217195SDaniel Vetter static const struct drm_prop_enum_list drm_subpixel_enum_list[] = { 78752217195SDaniel Vetter { SubPixelUnknown, "Unknown" }, 78852217195SDaniel Vetter { SubPixelHorizontalRGB, "Horizontal RGB" }, 78952217195SDaniel Vetter { SubPixelHorizontalBGR, "Horizontal BGR" }, 79052217195SDaniel Vetter { SubPixelVerticalRGB, "Vertical RGB" }, 79152217195SDaniel Vetter { SubPixelVerticalBGR, "Vertical BGR" }, 79252217195SDaniel Vetter { SubPixelNone, "None" }, 79352217195SDaniel Vetter }; 79452217195SDaniel Vetter 79552217195SDaniel Vetter /** 79652217195SDaniel Vetter * drm_get_subpixel_order_name - return a string for a given subpixel enum 79752217195SDaniel Vetter * @order: enum of subpixel_order 79852217195SDaniel Vetter * 79952217195SDaniel Vetter * Note you could abuse this and return something out of bounds, but that 80052217195SDaniel Vetter * would be a caller error. No unscrubbed user data should make it here. 801f85d9e59SRandy Dunlap * 802f85d9e59SRandy Dunlap * Returns: string describing an enumerated subpixel property 80352217195SDaniel Vetter */ 80452217195SDaniel Vetter const char *drm_get_subpixel_order_name(enum subpixel_order order) 80552217195SDaniel Vetter { 80652217195SDaniel Vetter return drm_subpixel_enum_list[order].name; 80752217195SDaniel Vetter } 80852217195SDaniel Vetter EXPORT_SYMBOL(drm_get_subpixel_order_name); 80952217195SDaniel Vetter 81052217195SDaniel Vetter static const struct drm_prop_enum_list drm_dpms_enum_list[] = { 81152217195SDaniel Vetter { DRM_MODE_DPMS_ON, "On" }, 81252217195SDaniel Vetter { DRM_MODE_DPMS_STANDBY, "Standby" }, 81352217195SDaniel Vetter { DRM_MODE_DPMS_SUSPEND, "Suspend" }, 81452217195SDaniel Vetter { DRM_MODE_DPMS_OFF, "Off" } 81552217195SDaniel Vetter }; 81652217195SDaniel Vetter DRM_ENUM_NAME_FN(drm_get_dpms_name, drm_dpms_enum_list) 81752217195SDaniel Vetter 81840ee6fbeSManasi Navare static const struct drm_prop_enum_list drm_link_status_enum_list[] = { 81940ee6fbeSManasi Navare { DRM_MODE_LINK_STATUS_GOOD, "Good" }, 82040ee6fbeSManasi Navare { DRM_MODE_LINK_STATUS_BAD, "Bad" }, 82140ee6fbeSManasi Navare }; 82240ee6fbeSManasi Navare 823b3c6c8bfSDaniel Vetter /** 824b3c6c8bfSDaniel Vetter * drm_display_info_set_bus_formats - set the supported bus formats 825b3c6c8bfSDaniel Vetter * @info: display info to store bus formats in 826b3c6c8bfSDaniel Vetter * @formats: array containing the supported bus formats 827b3c6c8bfSDaniel Vetter * @num_formats: the number of entries in the fmts array 828b3c6c8bfSDaniel Vetter * 829b3c6c8bfSDaniel Vetter * Store the supported bus formats in display info structure. 830b3c6c8bfSDaniel Vetter * See MEDIA_BUS_FMT_* definitions in include/uapi/linux/media-bus-format.h for 831b3c6c8bfSDaniel Vetter * a full list of available formats. 832f85d9e59SRandy Dunlap * 833f85d9e59SRandy Dunlap * Returns: 834f85d9e59SRandy Dunlap * 0 on success or a negative error code on failure. 835b3c6c8bfSDaniel Vetter */ 836b3c6c8bfSDaniel Vetter int drm_display_info_set_bus_formats(struct drm_display_info *info, 837b3c6c8bfSDaniel Vetter const u32 *formats, 838b3c6c8bfSDaniel Vetter unsigned int num_formats) 839b3c6c8bfSDaniel Vetter { 840b3c6c8bfSDaniel Vetter u32 *fmts = NULL; 841b3c6c8bfSDaniel Vetter 842b3c6c8bfSDaniel Vetter if (!formats && num_formats) 843b3c6c8bfSDaniel Vetter return -EINVAL; 844b3c6c8bfSDaniel Vetter 845b3c6c8bfSDaniel Vetter if (formats && num_formats) { 846b3c6c8bfSDaniel Vetter fmts = kmemdup(formats, sizeof(*formats) * num_formats, 847b3c6c8bfSDaniel Vetter GFP_KERNEL); 848b3c6c8bfSDaniel Vetter if (!fmts) 849b3c6c8bfSDaniel Vetter return -ENOMEM; 850b3c6c8bfSDaniel Vetter } 851b3c6c8bfSDaniel Vetter 852b3c6c8bfSDaniel Vetter kfree(info->bus_formats); 853b3c6c8bfSDaniel Vetter info->bus_formats = fmts; 854b3c6c8bfSDaniel Vetter info->num_bus_formats = num_formats; 855b3c6c8bfSDaniel Vetter 856b3c6c8bfSDaniel Vetter return 0; 857b3c6c8bfSDaniel Vetter } 858b3c6c8bfSDaniel Vetter EXPORT_SYMBOL(drm_display_info_set_bus_formats); 859b3c6c8bfSDaniel Vetter 86052217195SDaniel Vetter /* Optional connector properties. */ 86152217195SDaniel Vetter static const struct drm_prop_enum_list drm_scaling_mode_enum_list[] = { 86252217195SDaniel Vetter { DRM_MODE_SCALE_NONE, "None" }, 86352217195SDaniel Vetter { DRM_MODE_SCALE_FULLSCREEN, "Full" }, 86452217195SDaniel Vetter { DRM_MODE_SCALE_CENTER, "Center" }, 86552217195SDaniel Vetter { DRM_MODE_SCALE_ASPECT, "Full aspect" }, 86652217195SDaniel Vetter }; 86752217195SDaniel Vetter 86852217195SDaniel Vetter static const struct drm_prop_enum_list drm_aspect_ratio_enum_list[] = { 86952217195SDaniel Vetter { DRM_MODE_PICTURE_ASPECT_NONE, "Automatic" }, 87052217195SDaniel Vetter { DRM_MODE_PICTURE_ASPECT_4_3, "4:3" }, 87152217195SDaniel Vetter { DRM_MODE_PICTURE_ASPECT_16_9, "16:9" }, 87252217195SDaniel Vetter }; 87352217195SDaniel Vetter 87450525c33SStanislav Lisovskiy static const struct drm_prop_enum_list drm_content_type_enum_list[] = { 87550525c33SStanislav Lisovskiy { DRM_MODE_CONTENT_TYPE_NO_DATA, "No Data" }, 87650525c33SStanislav Lisovskiy { DRM_MODE_CONTENT_TYPE_GRAPHICS, "Graphics" }, 87750525c33SStanislav Lisovskiy { DRM_MODE_CONTENT_TYPE_PHOTO, "Photo" }, 87850525c33SStanislav Lisovskiy { DRM_MODE_CONTENT_TYPE_CINEMA, "Cinema" }, 87950525c33SStanislav Lisovskiy { DRM_MODE_CONTENT_TYPE_GAME, "Game" }, 88050525c33SStanislav Lisovskiy }; 88150525c33SStanislav Lisovskiy 8828d70f395SHans de Goede static const struct drm_prop_enum_list drm_panel_orientation_enum_list[] = { 8838d70f395SHans de Goede { DRM_MODE_PANEL_ORIENTATION_NORMAL, "Normal" }, 8848d70f395SHans de Goede { DRM_MODE_PANEL_ORIENTATION_BOTTOM_UP, "Upside Down" }, 8858d70f395SHans de Goede { DRM_MODE_PANEL_ORIENTATION_LEFT_UP, "Left Side Up" }, 8868d70f395SHans de Goede { DRM_MODE_PANEL_ORIENTATION_RIGHT_UP, "Right Side Up" }, 8878d70f395SHans de Goede }; 8888d70f395SHans de Goede 88952217195SDaniel Vetter static const struct drm_prop_enum_list drm_dvi_i_select_enum_list[] = { 89052217195SDaniel Vetter { DRM_MODE_SUBCONNECTOR_Automatic, "Automatic" }, /* DVI-I and TV-out */ 89152217195SDaniel Vetter { DRM_MODE_SUBCONNECTOR_DVID, "DVI-D" }, /* DVI-I */ 89252217195SDaniel Vetter { DRM_MODE_SUBCONNECTOR_DVIA, "DVI-A" }, /* DVI-I */ 89352217195SDaniel Vetter }; 89452217195SDaniel Vetter DRM_ENUM_NAME_FN(drm_get_dvi_i_select_name, drm_dvi_i_select_enum_list) 89552217195SDaniel Vetter 89652217195SDaniel Vetter static const struct drm_prop_enum_list drm_dvi_i_subconnector_enum_list[] = { 897e5b92773SOleg Vasilev { DRM_MODE_SUBCONNECTOR_Unknown, "Unknown" }, /* DVI-I, TV-out and DP */ 89852217195SDaniel Vetter { DRM_MODE_SUBCONNECTOR_DVID, "DVI-D" }, /* DVI-I */ 89952217195SDaniel Vetter { DRM_MODE_SUBCONNECTOR_DVIA, "DVI-A" }, /* DVI-I */ 90052217195SDaniel Vetter }; 90152217195SDaniel Vetter DRM_ENUM_NAME_FN(drm_get_dvi_i_subconnector_name, 90252217195SDaniel Vetter drm_dvi_i_subconnector_enum_list) 90352217195SDaniel Vetter 90452217195SDaniel Vetter static const struct drm_prop_enum_list drm_tv_select_enum_list[] = { 90552217195SDaniel Vetter { DRM_MODE_SUBCONNECTOR_Automatic, "Automatic" }, /* DVI-I and TV-out */ 90652217195SDaniel Vetter { DRM_MODE_SUBCONNECTOR_Composite, "Composite" }, /* TV-out */ 90752217195SDaniel Vetter { DRM_MODE_SUBCONNECTOR_SVIDEO, "SVIDEO" }, /* TV-out */ 90852217195SDaniel Vetter { DRM_MODE_SUBCONNECTOR_Component, "Component" }, /* TV-out */ 90952217195SDaniel Vetter { DRM_MODE_SUBCONNECTOR_SCART, "SCART" }, /* TV-out */ 91052217195SDaniel Vetter }; 91152217195SDaniel Vetter DRM_ENUM_NAME_FN(drm_get_tv_select_name, drm_tv_select_enum_list) 91252217195SDaniel Vetter 91352217195SDaniel Vetter static const struct drm_prop_enum_list drm_tv_subconnector_enum_list[] = { 914e5b92773SOleg Vasilev { DRM_MODE_SUBCONNECTOR_Unknown, "Unknown" }, /* DVI-I, TV-out and DP */ 91552217195SDaniel Vetter { DRM_MODE_SUBCONNECTOR_Composite, "Composite" }, /* TV-out */ 91652217195SDaniel Vetter { DRM_MODE_SUBCONNECTOR_SVIDEO, "SVIDEO" }, /* TV-out */ 91752217195SDaniel Vetter { DRM_MODE_SUBCONNECTOR_Component, "Component" }, /* TV-out */ 91852217195SDaniel Vetter { DRM_MODE_SUBCONNECTOR_SCART, "SCART" }, /* TV-out */ 91952217195SDaniel Vetter }; 92052217195SDaniel Vetter DRM_ENUM_NAME_FN(drm_get_tv_subconnector_name, 92152217195SDaniel Vetter drm_tv_subconnector_enum_list) 92252217195SDaniel Vetter 923e5b92773SOleg Vasilev static const struct drm_prop_enum_list drm_dp_subconnector_enum_list[] = { 924e5b92773SOleg Vasilev { DRM_MODE_SUBCONNECTOR_Unknown, "Unknown" }, /* DVI-I, TV-out and DP */ 925e5b92773SOleg Vasilev { DRM_MODE_SUBCONNECTOR_VGA, "VGA" }, /* DP */ 926e5b92773SOleg Vasilev { DRM_MODE_SUBCONNECTOR_DVID, "DVI-D" }, /* DP */ 927e5b92773SOleg Vasilev { DRM_MODE_SUBCONNECTOR_HDMIA, "HDMI" }, /* DP */ 928e5b92773SOleg Vasilev { DRM_MODE_SUBCONNECTOR_DisplayPort, "DP" }, /* DP */ 929e5b92773SOleg Vasilev { DRM_MODE_SUBCONNECTOR_Wireless, "Wireless" }, /* DP */ 930e5b92773SOleg Vasilev { DRM_MODE_SUBCONNECTOR_Native, "Native" }, /* DP */ 931e5b92773SOleg Vasilev }; 932e5b92773SOleg Vasilev 933e5b92773SOleg Vasilev DRM_ENUM_NAME_FN(drm_get_dp_subconnector_name, 934e5b92773SOleg Vasilev drm_dp_subconnector_enum_list) 935e5b92773SOleg Vasilev 936d2c6a405SUma Shankar static const struct drm_prop_enum_list hdmi_colorspaces[] = { 937d2c6a405SUma Shankar /* For Default case, driver will set the colorspace */ 938d2c6a405SUma Shankar { DRM_MODE_COLORIMETRY_DEFAULT, "Default" }, 939d2c6a405SUma Shankar /* Standard Definition Colorimetry based on CEA 861 */ 940d2c6a405SUma Shankar { DRM_MODE_COLORIMETRY_SMPTE_170M_YCC, "SMPTE_170M_YCC" }, 941d2c6a405SUma Shankar { DRM_MODE_COLORIMETRY_BT709_YCC, "BT709_YCC" }, 942d2c6a405SUma Shankar /* Standard Definition Colorimetry based on IEC 61966-2-4 */ 943d2c6a405SUma Shankar { DRM_MODE_COLORIMETRY_XVYCC_601, "XVYCC_601" }, 944d2c6a405SUma Shankar /* High Definition Colorimetry based on IEC 61966-2-4 */ 945d2c6a405SUma Shankar { DRM_MODE_COLORIMETRY_XVYCC_709, "XVYCC_709" }, 946d2c6a405SUma Shankar /* Colorimetry based on IEC 61966-2-1/Amendment 1 */ 947d2c6a405SUma Shankar { DRM_MODE_COLORIMETRY_SYCC_601, "SYCC_601" }, 948d2c6a405SUma Shankar /* Colorimetry based on IEC 61966-2-5 [33] */ 949d2c6a405SUma Shankar { DRM_MODE_COLORIMETRY_OPYCC_601, "opYCC_601" }, 950d2c6a405SUma Shankar /* Colorimetry based on IEC 61966-2-5 */ 951d2c6a405SUma Shankar { DRM_MODE_COLORIMETRY_OPRGB, "opRGB" }, 952d2c6a405SUma Shankar /* Colorimetry based on ITU-R BT.2020 */ 953d2c6a405SUma Shankar { DRM_MODE_COLORIMETRY_BT2020_CYCC, "BT2020_CYCC" }, 954d2c6a405SUma Shankar /* Colorimetry based on ITU-R BT.2020 */ 955d2c6a405SUma Shankar { DRM_MODE_COLORIMETRY_BT2020_RGB, "BT2020_RGB" }, 956d2c6a405SUma Shankar /* Colorimetry based on ITU-R BT.2020 */ 957d2c6a405SUma Shankar { DRM_MODE_COLORIMETRY_BT2020_YCC, "BT2020_YCC" }, 958d2c6a405SUma Shankar /* Added as part of Additional Colorimetry Extension in 861.G */ 959d2c6a405SUma Shankar { DRM_MODE_COLORIMETRY_DCI_P3_RGB_D65, "DCI-P3_RGB_D65" }, 960d2c6a405SUma Shankar { DRM_MODE_COLORIMETRY_DCI_P3_RGB_THEATER, "DCI-P3_RGB_Theater" }, 961d2c6a405SUma Shankar }; 962d2c6a405SUma Shankar 96345cf0e91SGwan-gyeong Mun /* 96445cf0e91SGwan-gyeong Mun * As per DP 1.4a spec, 2.2.5.7.5 VSC SDP Payload for Pixel Encoding/Colorimetry 96545cf0e91SGwan-gyeong Mun * Format Table 2-120 96645cf0e91SGwan-gyeong Mun */ 96745cf0e91SGwan-gyeong Mun static const struct drm_prop_enum_list dp_colorspaces[] = { 96845cf0e91SGwan-gyeong Mun /* For Default case, driver will set the colorspace */ 96945cf0e91SGwan-gyeong Mun { DRM_MODE_COLORIMETRY_DEFAULT, "Default" }, 97045cf0e91SGwan-gyeong Mun { DRM_MODE_COLORIMETRY_RGB_WIDE_FIXED, "RGB_Wide_Gamut_Fixed_Point" }, 97145cf0e91SGwan-gyeong Mun /* Colorimetry based on scRGB (IEC 61966-2-2) */ 97245cf0e91SGwan-gyeong Mun { DRM_MODE_COLORIMETRY_RGB_WIDE_FLOAT, "RGB_Wide_Gamut_Floating_Point" }, 97345cf0e91SGwan-gyeong Mun /* Colorimetry based on IEC 61966-2-5 */ 97445cf0e91SGwan-gyeong Mun { DRM_MODE_COLORIMETRY_OPRGB, "opRGB" }, 97545cf0e91SGwan-gyeong Mun /* Colorimetry based on SMPTE RP 431-2 */ 97645cf0e91SGwan-gyeong Mun { DRM_MODE_COLORIMETRY_DCI_P3_RGB_D65, "DCI-P3_RGB_D65" }, 97745cf0e91SGwan-gyeong Mun /* Colorimetry based on ITU-R BT.2020 */ 97845cf0e91SGwan-gyeong Mun { DRM_MODE_COLORIMETRY_BT2020_RGB, "BT2020_RGB" }, 97945cf0e91SGwan-gyeong Mun { DRM_MODE_COLORIMETRY_BT601_YCC, "BT601_YCC" }, 98045cf0e91SGwan-gyeong Mun { DRM_MODE_COLORIMETRY_BT709_YCC, "BT709_YCC" }, 98145cf0e91SGwan-gyeong Mun /* Standard Definition Colorimetry based on IEC 61966-2-4 */ 98245cf0e91SGwan-gyeong Mun { DRM_MODE_COLORIMETRY_XVYCC_601, "XVYCC_601" }, 98345cf0e91SGwan-gyeong Mun /* High Definition Colorimetry based on IEC 61966-2-4 */ 98445cf0e91SGwan-gyeong Mun { DRM_MODE_COLORIMETRY_XVYCC_709, "XVYCC_709" }, 98545cf0e91SGwan-gyeong Mun /* Colorimetry based on IEC 61966-2-1/Amendment 1 */ 98645cf0e91SGwan-gyeong Mun { DRM_MODE_COLORIMETRY_SYCC_601, "SYCC_601" }, 98745cf0e91SGwan-gyeong Mun /* Colorimetry based on IEC 61966-2-5 [33] */ 98845cf0e91SGwan-gyeong Mun { DRM_MODE_COLORIMETRY_OPYCC_601, "opYCC_601" }, 98945cf0e91SGwan-gyeong Mun /* Colorimetry based on ITU-R BT.2020 */ 99045cf0e91SGwan-gyeong Mun { DRM_MODE_COLORIMETRY_BT2020_CYCC, "BT2020_CYCC" }, 99145cf0e91SGwan-gyeong Mun /* Colorimetry based on ITU-R BT.2020 */ 99245cf0e91SGwan-gyeong Mun { DRM_MODE_COLORIMETRY_BT2020_YCC, "BT2020_YCC" }, 99345cf0e91SGwan-gyeong Mun }; 99445cf0e91SGwan-gyeong Mun 9954ada6f22SDaniel Vetter /** 9964ada6f22SDaniel Vetter * DOC: standard connector properties 9974ada6f22SDaniel Vetter * 9984ada6f22SDaniel Vetter * DRM connectors have a few standardized properties: 9994ada6f22SDaniel Vetter * 10004ada6f22SDaniel Vetter * EDID: 10014ada6f22SDaniel Vetter * Blob property which contains the current EDID read from the sink. This 10024ada6f22SDaniel Vetter * is useful to parse sink identification information like vendor, model 10034ada6f22SDaniel Vetter * and serial. Drivers should update this property by calling 1004c555f023SDaniel Vetter * drm_connector_update_edid_property(), usually after having parsed 10054ada6f22SDaniel Vetter * the EDID using drm_add_edid_modes(). Userspace cannot change this 10064ada6f22SDaniel Vetter * property. 100712767469SSimon Ser * 100812767469SSimon Ser * User-space should not parse the EDID to obtain information exposed via 100912767469SSimon Ser * other KMS properties (because the kernel might apply limits, quirks or 101012767469SSimon Ser * fixups to the EDID). For instance, user-space should not try to parse 101112767469SSimon Ser * mode lists from the EDID. 10124ada6f22SDaniel Vetter * DPMS: 10134ada6f22SDaniel Vetter * Legacy property for setting the power state of the connector. For atomic 10144ada6f22SDaniel Vetter * drivers this is only provided for backwards compatibility with existing 10154ada6f22SDaniel Vetter * drivers, it remaps to controlling the "ACTIVE" property on the CRTC the 10164ada6f22SDaniel Vetter * connector is linked to. Drivers should never set this property directly, 1017d574528aSDaniel Vetter * it is handled by the DRM core by calling the &drm_connector_funcs.dpms 1018144a7999SDaniel Vetter * callback. For atomic drivers the remapping to the "ACTIVE" property is 10191e3e4caeSSimon Ser * implemented in the DRM core. 1020d0d1aee5SDaniel Vetter * 1021d0d1aee5SDaniel Vetter * Note that this property cannot be set through the MODE_ATOMIC ioctl, 1022d0d1aee5SDaniel Vetter * userspace must use "ACTIVE" on the CRTC instead. 1023d0d1aee5SDaniel Vetter * 1024d0d1aee5SDaniel Vetter * WARNING: 1025d0d1aee5SDaniel Vetter * 1026d0d1aee5SDaniel Vetter * For userspace also running on legacy drivers the "DPMS" semantics are a 1027d0d1aee5SDaniel Vetter * lot more complicated. First, userspace cannot rely on the "DPMS" value 1028d0d1aee5SDaniel Vetter * returned by the GETCONNECTOR actually reflecting reality, because many 1029d0d1aee5SDaniel Vetter * drivers fail to update it. For atomic drivers this is taken care of in 1030d0d1aee5SDaniel Vetter * drm_atomic_helper_update_legacy_modeset_state(). 1031d0d1aee5SDaniel Vetter * 1032d0d1aee5SDaniel Vetter * The second issue is that the DPMS state is only well-defined when the 1033d0d1aee5SDaniel Vetter * connector is connected to a CRTC. In atomic the DRM core enforces that 1034d0d1aee5SDaniel Vetter * "ACTIVE" is off in such a case, no such checks exists for "DPMS". 1035d0d1aee5SDaniel Vetter * 1036d0d1aee5SDaniel Vetter * Finally, when enabling an output using the legacy SETCONFIG ioctl then 1037d0d1aee5SDaniel Vetter * "DPMS" is forced to ON. But see above, that might not be reflected in 1038d0d1aee5SDaniel Vetter * the software value on legacy drivers. 1039d0d1aee5SDaniel Vetter * 1040d0d1aee5SDaniel Vetter * Summarizing: Only set "DPMS" when the connector is known to be enabled, 1041d0d1aee5SDaniel Vetter * assume that a successful SETCONFIG call also sets "DPMS" to on, and 1042d0d1aee5SDaniel Vetter * never read back the value of "DPMS" because it can be incorrect. 10434ada6f22SDaniel Vetter * PATH: 10444ada6f22SDaniel Vetter * Connector path property to identify how this sink is physically 10454ada6f22SDaniel Vetter * connected. Used by DP MST. This should be set by calling 104697e14fbeSDaniel Vetter * drm_connector_set_path_property(), in the case of DP MST with the 10474ada6f22SDaniel Vetter * path property the MST manager created. Userspace cannot change this 10484ada6f22SDaniel Vetter * property. 10494ada6f22SDaniel Vetter * TILE: 10504ada6f22SDaniel Vetter * Connector tile group property to indicate how a set of DRM connector 10514ada6f22SDaniel Vetter * compose together into one logical screen. This is used by both high-res 10524ada6f22SDaniel Vetter * external screens (often only using a single cable, but exposing multiple 10534ada6f22SDaniel Vetter * DP MST sinks), or high-res integrated panels (like dual-link DSI) which 10544ada6f22SDaniel Vetter * are not gen-locked. Note that for tiled panels which are genlocked, like 10554ada6f22SDaniel Vetter * dual-link LVDS or dual-link DSI, the driver should try to not expose the 105684e543bcSAntonio Borneo * tiling and virtualise both &drm_crtc and &drm_plane if needed. Drivers 105797e14fbeSDaniel Vetter * should update this value using drm_connector_set_tile_property(). 10584ada6f22SDaniel Vetter * Userspace cannot change this property. 105940ee6fbeSManasi Navare * link-status: 1060716719a3SSean Paul * Connector link-status property to indicate the status of link. The 1061716719a3SSean Paul * default value of link-status is "GOOD". If something fails during or 1062716719a3SSean Paul * after modeset, the kernel driver may set this to "BAD" and issue a 1063716719a3SSean Paul * hotplug uevent. Drivers should update this value using 106497e14fbeSDaniel Vetter * drm_connector_set_link_status_property(). 1065a66da873SSimon Ser * 1066a66da873SSimon Ser * When user-space receives the hotplug uevent and detects a "BAD" 1067a66da873SSimon Ser * link-status, the sink doesn't receive pixels anymore (e.g. the screen 1068a66da873SSimon Ser * becomes completely black). The list of available modes may have 1069a66da873SSimon Ser * changed. User-space is expected to pick a new mode if the current one 1070a66da873SSimon Ser * has disappeared and perform a new modeset with link-status set to 1071a66da873SSimon Ser * "GOOD" to re-enable the connector. 1072a66da873SSimon Ser * 1073a66da873SSimon Ser * If multiple connectors share the same CRTC and one of them gets a "BAD" 1074a66da873SSimon Ser * link-status, the other are unaffected (ie. the sinks still continue to 1075a66da873SSimon Ser * receive pixels). 1076a66da873SSimon Ser * 1077a66da873SSimon Ser * When user-space performs an atomic commit on a connector with a "BAD" 1078a66da873SSimon Ser * link-status without resetting the property to "GOOD", the sink may 1079a66da873SSimon Ser * still not receive pixels. When user-space performs an atomic commit 1080a66da873SSimon Ser * which resets the link-status property to "GOOD" without the 1081a66da873SSimon Ser * ALLOW_MODESET flag set, it might fail because a modeset is required. 1082a66da873SSimon Ser * 1083a66da873SSimon Ser * User-space can only change link-status to "GOOD", changing it to "BAD" 1084a66da873SSimon Ser * is a no-op. 1085a66da873SSimon Ser * 1086a66da873SSimon Ser * For backwards compatibility with non-atomic userspace the kernel 1087a66da873SSimon Ser * tries to automatically set the link-status back to "GOOD" in the 1088a66da873SSimon Ser * SETCRTC IOCTL. This might fail if the mode is no longer valid, similar 1089a66da873SSimon Ser * to how it might fail if a different screen has been connected in the 1090a66da873SSimon Ser * interim. 109166660d4cSDave Airlie * non_desktop: 109266660d4cSDave Airlie * Indicates the output should be ignored for purposes of displaying a 109366660d4cSDave Airlie * standard desktop environment or console. This is most likely because 109466660d4cSDave Airlie * the output device is not rectilinear. 109524557865SSean Paul * Content Protection: 109624557865SSean Paul * This property is used by userspace to request the kernel protect future 109724557865SSean Paul * content communicated over the link. When requested, kernel will apply 109824557865SSean Paul * the appropriate means of protection (most often HDCP), and use the 109924557865SSean Paul * property to tell userspace the protection is active. 110024557865SSean Paul * 110124557865SSean Paul * Drivers can set this up by calling 110224557865SSean Paul * drm_connector_attach_content_protection_property() on initialization. 110324557865SSean Paul * 110424557865SSean Paul * The value of this property can be one of the following: 110524557865SSean Paul * 1106bbeba09fSDaniel Vetter * DRM_MODE_CONTENT_PROTECTION_UNDESIRED = 0 110724557865SSean Paul * The link is not protected, content is transmitted in the clear. 1108bbeba09fSDaniel Vetter * DRM_MODE_CONTENT_PROTECTION_DESIRED = 1 110924557865SSean Paul * Userspace has requested content protection, but the link is not 111024557865SSean Paul * currently protected. When in this state, kernel should enable 111124557865SSean Paul * Content Protection as soon as possible. 1112bbeba09fSDaniel Vetter * DRM_MODE_CONTENT_PROTECTION_ENABLED = 2 111324557865SSean Paul * Userspace has requested content protection, and the link is 111424557865SSean Paul * protected. Only the driver can set the property to this value. 111524557865SSean Paul * If userspace attempts to set to ENABLED, kernel will return 111624557865SSean Paul * -EINVAL. 111724557865SSean Paul * 111824557865SSean Paul * A few guidelines: 111924557865SSean Paul * 112024557865SSean Paul * - DESIRED state should be preserved until userspace de-asserts it by 112124557865SSean Paul * setting the property to UNDESIRED. This means ENABLED should only 112224557865SSean Paul * transition to UNDESIRED when the user explicitly requests it. 112324557865SSean Paul * - If the state is DESIRED, kernel should attempt to re-authenticate the 112424557865SSean Paul * link whenever possible. This includes across disable/enable, dpms, 112524557865SSean Paul * hotplug, downstream device changes, link status failures, etc.. 1126bb5a45d4SRamalingam C * - Kernel sends uevent with the connector id and property id through 1127bb5a45d4SRamalingam C * @drm_hdcp_update_content_protection, upon below kernel triggered 1128bb5a45d4SRamalingam C * scenarios: 112912db36bcSSean Paul * 113012db36bcSSean Paul * - DESIRED -> ENABLED (authentication success) 113112db36bcSSean Paul * - ENABLED -> DESIRED (termination of authentication) 1132bb5a45d4SRamalingam C * - Please note no uevents for userspace triggered property state changes, 1133bb5a45d4SRamalingam C * which can't fail such as 113412db36bcSSean Paul * 113512db36bcSSean Paul * - DESIRED/ENABLED -> UNDESIRED 113612db36bcSSean Paul * - UNDESIRED -> DESIRED 1137bb5a45d4SRamalingam C * - Userspace is responsible for polling the property or listen to uevents 1138bb5a45d4SRamalingam C * to determine when the value transitions from ENABLED to DESIRED. 1139bb5a45d4SRamalingam C * This signifies the link is no longer protected and userspace should 1140bb5a45d4SRamalingam C * take appropriate action (whatever that might be). 11414ada6f22SDaniel Vetter * 11427672dbbaSRamalingam C * HDCP Content Type: 11437672dbbaSRamalingam C * This Enum property is used by the userspace to declare the content type 11447672dbbaSRamalingam C * of the display stream, to kernel. Here display stream stands for any 11457672dbbaSRamalingam C * display content that userspace intended to display through HDCP 11467672dbbaSRamalingam C * encryption. 11477672dbbaSRamalingam C * 11487672dbbaSRamalingam C * Content Type of a stream is decided by the owner of the stream, as 11497672dbbaSRamalingam C * "HDCP Type0" or "HDCP Type1". 11507672dbbaSRamalingam C * 11517672dbbaSRamalingam C * The value of the property can be one of the below: 11527672dbbaSRamalingam C * - "HDCP Type0": DRM_MODE_HDCP_CONTENT_TYPE0 = 0 11537672dbbaSRamalingam C * - "HDCP Type1": DRM_MODE_HDCP_CONTENT_TYPE1 = 1 11547672dbbaSRamalingam C * 11557672dbbaSRamalingam C * When kernel starts the HDCP authentication (see "Content Protection" 11567672dbbaSRamalingam C * for details), it uses the content type in "HDCP Content Type" 11577672dbbaSRamalingam C * for performing the HDCP authentication with the display sink. 11587672dbbaSRamalingam C * 11597672dbbaSRamalingam C * Please note in HDCP spec versions, a link can be authenticated with 11607672dbbaSRamalingam C * HDCP 2.2 for Content Type 0/Content Type 1. Where as a link can be 11617672dbbaSRamalingam C * authenticated with HDCP1.4 only for Content Type 0(though it is implicit 11627672dbbaSRamalingam C * in nature. As there is no reference for Content Type in HDCP1.4). 11637672dbbaSRamalingam C * 11647672dbbaSRamalingam C * HDCP2.2 authentication protocol itself takes the "Content Type" as a 11657672dbbaSRamalingam C * parameter, which is a input for the DP HDCP2.2 encryption algo. 11667672dbbaSRamalingam C * 11677672dbbaSRamalingam C * In case of Type 0 content protection request, kernel driver can choose 11687672dbbaSRamalingam C * either of HDCP spec versions 1.4 and 2.2. When HDCP2.2 is used for 11697672dbbaSRamalingam C * "HDCP Type 0", a HDCP 2.2 capable repeater in the downstream can send 11707672dbbaSRamalingam C * that content to a HDCP 1.4 authenticated HDCP sink (Type0 link). 11717672dbbaSRamalingam C * But if the content is classified as "HDCP Type 1", above mentioned 11727672dbbaSRamalingam C * HDCP 2.2 repeater wont send the content to the HDCP sink as it can't 11737672dbbaSRamalingam C * authenticate the HDCP1.4 capable sink for "HDCP Type 1". 11747672dbbaSRamalingam C * 11757672dbbaSRamalingam C * Please note userspace can be ignorant of the HDCP versions used by the 11767672dbbaSRamalingam C * kernel driver to achieve the "HDCP Content Type". 11777672dbbaSRamalingam C * 11787672dbbaSRamalingam C * At current scenario, classifying a content as Type 1 ensures that the 11797672dbbaSRamalingam C * content will be displayed only through the HDCP2.2 encrypted link. 11807672dbbaSRamalingam C * 11817672dbbaSRamalingam C * Note that the HDCP Content Type property is introduced at HDCP 2.2, and 11827672dbbaSRamalingam C * defaults to type 0. It is only exposed by drivers supporting HDCP 2.2 11837672dbbaSRamalingam C * (hence supporting Type 0 and Type 1). Based on how next versions of 11847672dbbaSRamalingam C * HDCP specs are defined content Type could be used for higher versions 11857672dbbaSRamalingam C * too. 11867672dbbaSRamalingam C * 11877672dbbaSRamalingam C * If content type is changed when "Content Protection" is not UNDESIRED, 11887672dbbaSRamalingam C * then kernel will disable the HDCP and re-enable with new type in the 11897672dbbaSRamalingam C * same atomic commit. And when "Content Protection" is ENABLED, it means 11907672dbbaSRamalingam C * that link is HDCP authenticated and encrypted, for the transmission of 11917672dbbaSRamalingam C * the Type of stream mentioned at "HDCP Content Type". 11927672dbbaSRamalingam C * 1193a09db883SUma Shankar * HDR_OUTPUT_METADATA: 1194a09db883SUma Shankar * Connector property to enable userspace to send HDR Metadata to 1195a09db883SUma Shankar * driver. This metadata is based on the composition and blending 1196a09db883SUma Shankar * policies decided by user, taking into account the hardware and 1197a09db883SUma Shankar * sink capabilities. The driver gets this metadata and creates a 1198a09db883SUma Shankar * Dynamic Range and Mastering Infoframe (DRM) in case of HDMI, 1199a09db883SUma Shankar * SDP packet (Non-audio INFOFRAME SDP v1.3) for DP. This is then 1200a09db883SUma Shankar * sent to sink. This notifies the sink of the upcoming frame's Color 1201a09db883SUma Shankar * Encoding and Luminance parameters. 1202a09db883SUma Shankar * 1203a09db883SUma Shankar * Userspace first need to detect the HDR capabilities of sink by 1204a09db883SUma Shankar * reading and parsing the EDID. Details of HDR metadata for HDMI 1205a09db883SUma Shankar * are added in CTA 861.G spec. For DP , its defined in VESA DP 1206a09db883SUma Shankar * Standard v1.4. It needs to then get the metadata information 1207a09db883SUma Shankar * of the video/game/app content which are encoded in HDR (basically 1208a09db883SUma Shankar * using HDR transfer functions). With this information it needs to 1209a09db883SUma Shankar * decide on a blending policy and compose the relevant 1210a09db883SUma Shankar * layers/overlays into a common format. Once this blending is done, 1211a09db883SUma Shankar * userspace will be aware of the metadata of the composed frame to 1212a09db883SUma Shankar * be send to sink. It then uses this property to communicate this 1213a09db883SUma Shankar * metadata to driver which then make a Infoframe packet and sends 1214a09db883SUma Shankar * to sink based on the type of encoder connected. 1215a09db883SUma Shankar * 1216a09db883SUma Shankar * Userspace will be responsible to do Tone mapping operation in case: 1217a09db883SUma Shankar * - Some layers are HDR and others are SDR 1218a09db883SUma Shankar * - HDR layers luminance is not same as sink 12199f9b2559SSean Paul * 1220a09db883SUma Shankar * It will even need to do colorspace conversion and get all layers 1221a09db883SUma Shankar * to one common colorspace for blending. It can use either GL, Media 122284e543bcSAntonio Borneo * or display engine to get this done based on the capabilities of the 1223a09db883SUma Shankar * associated hardware. 1224a09db883SUma Shankar * 1225a09db883SUma Shankar * Driver expects metadata to be put in &struct hdr_output_metadata 1226a09db883SUma Shankar * structure from userspace. This is received as blob and stored in 1227a09db883SUma Shankar * &drm_connector_state.hdr_output_metadata. It parses EDID and saves the 1228a09db883SUma Shankar * sink metadata in &struct hdr_sink_metadata, as 1229a09db883SUma Shankar * &drm_connector.hdr_sink_metadata. Driver uses 1230a09db883SUma Shankar * drm_hdmi_infoframe_set_hdr_metadata() helper to set the HDR metadata, 1231a09db883SUma Shankar * hdmi_drm_infoframe_pack() to pack the infoframe as per spec, in case of 1232a09db883SUma Shankar * HDMI encoder. 1233a09db883SUma Shankar * 123447e22ff1SRadhakrishna Sripada * max bpc: 123547e22ff1SRadhakrishna Sripada * This range property is used by userspace to limit the bit depth. When 123647e22ff1SRadhakrishna Sripada * used the driver would limit the bpc in accordance with the valid range 123747e22ff1SRadhakrishna Sripada * supported by the hardware and sink. Drivers to use the function 123847e22ff1SRadhakrishna Sripada * drm_connector_attach_max_bpc_property() to create and attach the 123947e22ff1SRadhakrishna Sripada * property to the connector during initialization. 124047e22ff1SRadhakrishna Sripada * 12414ada6f22SDaniel Vetter * Connectors also have one standardized atomic property: 12424ada6f22SDaniel Vetter * 12434ada6f22SDaniel Vetter * CRTC_ID: 12444ada6f22SDaniel Vetter * Mode object ID of the &drm_crtc this connector should be connected to. 12458d70f395SHans de Goede * 12468d70f395SHans de Goede * Connectors for LCD panels may also have one standardized property: 12478d70f395SHans de Goede * 12488d70f395SHans de Goede * panel orientation: 12498d70f395SHans de Goede * On some devices the LCD panel is mounted in the casing in such a way 12508d70f395SHans de Goede * that the up/top side of the panel does not match with the top side of 12518d70f395SHans de Goede * the device. Userspace can use this property to check for this. 12528d70f395SHans de Goede * Note that input coordinates from touchscreens (input devices with 12538d70f395SHans de Goede * INPUT_PROP_DIRECT) will still map 1:1 to the actual LCD panel 12548d70f395SHans de Goede * coordinates, so if userspace rotates the picture to adjust for 12558d70f395SHans de Goede * the orientation it must also apply the same transformation to the 1256bbeba09fSDaniel Vetter * touchscreen input coordinates. This property is initialized by calling 125769654c63SDerek Basehore * drm_connector_set_panel_orientation() or 125869654c63SDerek Basehore * drm_connector_set_panel_orientation_with_quirk() 1259bbeba09fSDaniel Vetter * 1260bbeba09fSDaniel Vetter * scaling mode: 1261bbeba09fSDaniel Vetter * This property defines how a non-native mode is upscaled to the native 1262bbeba09fSDaniel Vetter * mode of an LCD panel: 1263bbeba09fSDaniel Vetter * 1264bbeba09fSDaniel Vetter * None: 1265bbeba09fSDaniel Vetter * No upscaling happens, scaling is left to the panel. Not all 1266bbeba09fSDaniel Vetter * drivers expose this mode. 1267bbeba09fSDaniel Vetter * Full: 1268bbeba09fSDaniel Vetter * The output is upscaled to the full resolution of the panel, 1269bbeba09fSDaniel Vetter * ignoring the aspect ratio. 1270bbeba09fSDaniel Vetter * Center: 1271bbeba09fSDaniel Vetter * No upscaling happens, the output is centered within the native 1272bbeba09fSDaniel Vetter * resolution the panel. 1273bbeba09fSDaniel Vetter * Full aspect: 1274bbeba09fSDaniel Vetter * The output is upscaled to maximize either the width or height 1275bbeba09fSDaniel Vetter * while retaining the aspect ratio. 1276bbeba09fSDaniel Vetter * 1277bbeba09fSDaniel Vetter * This property should be set up by calling 1278bbeba09fSDaniel Vetter * drm_connector_attach_scaling_mode_property(). Note that drivers 1279bbeba09fSDaniel Vetter * can also expose this property to external outputs, in which case they 1280bbeba09fSDaniel Vetter * must support "None", which should be the default (since external screens 1281bbeba09fSDaniel Vetter * have a built-in scaler). 1282e5b92773SOleg Vasilev * 1283e5b92773SOleg Vasilev * subconnector: 1284e5b92773SOleg Vasilev * This property is used by DVI-I, TVout and DisplayPort to indicate different 1285e5b92773SOleg Vasilev * connector subtypes. Enum values more or less match with those from main 1286e5b92773SOleg Vasilev * connector types. 1287e5b92773SOleg Vasilev * For DVI-I and TVout there is also a matching property "select subconnector" 1288e5b92773SOleg Vasilev * allowing to switch between signal types. 1289e5b92773SOleg Vasilev * DP subconnector corresponds to a downstream port. 1290107fe904SRajat Jain * 1291107fe904SRajat Jain * privacy-screen sw-state, privacy-screen hw-state: 1292107fe904SRajat Jain * These 2 optional properties can be used to query the state of the 1293107fe904SRajat Jain * electronic privacy screen that is available on some displays; and in 1294107fe904SRajat Jain * some cases also control the state. If a driver implements these 1295107fe904SRajat Jain * properties then both properties must be present. 1296107fe904SRajat Jain * 1297107fe904SRajat Jain * "privacy-screen hw-state" is read-only and reflects the actual state 1298107fe904SRajat Jain * of the privacy-screen, possible values: "Enabled", "Disabled, 1299107fe904SRajat Jain * "Enabled-locked", "Disabled-locked". The locked states indicate 1300107fe904SRajat Jain * that the state cannot be changed through the DRM API. E.g. there 1301107fe904SRajat Jain * might be devices where the firmware-setup options, or a hardware 1302107fe904SRajat Jain * slider-switch, offer always on / off modes. 1303107fe904SRajat Jain * 1304107fe904SRajat Jain * "privacy-screen sw-state" can be set to change the privacy-screen state 1305107fe904SRajat Jain * when not locked. In this case the driver must update the hw-state 1306107fe904SRajat Jain * property to reflect the new state on completion of the commit of the 1307107fe904SRajat Jain * sw-state property. Setting the sw-state property when the hw-state is 1308107fe904SRajat Jain * locked must be interpreted by the driver as a request to change the 1309107fe904SRajat Jain * state to the set state when the hw-state becomes unlocked. E.g. if 1310107fe904SRajat Jain * "privacy-screen hw-state" is "Enabled-locked" and the sw-state 1311107fe904SRajat Jain * gets set to "Disabled" followed by the user unlocking the state by 1312107fe904SRajat Jain * changing the slider-switch position, then the driver must set the 1313107fe904SRajat Jain * state to "Disabled" upon receiving the unlock event. 1314107fe904SRajat Jain * 1315107fe904SRajat Jain * In some cases the privacy-screen's actual state might change outside of 1316107fe904SRajat Jain * control of the DRM code. E.g. there might be a firmware handled hotkey 1317107fe904SRajat Jain * which toggles the actual state, or the actual state might be changed 1318107fe904SRajat Jain * through another userspace API such as writing /proc/acpi/ibm/lcdshadow. 1319107fe904SRajat Jain * In this case the driver must update both the hw-state and the sw-state 1320107fe904SRajat Jain * to reflect the new value, overwriting any pending state requests in the 1321107fe904SRajat Jain * sw-state. Any pending sw-state requests are thus discarded. 1322107fe904SRajat Jain * 1323107fe904SRajat Jain * Note that the ability for the state to change outside of control of 1324107fe904SRajat Jain * the DRM master process means that userspace must not cache the value 1325107fe904SRajat Jain * of the sw-state. Caching the sw-state value and including it in later 1326107fe904SRajat Jain * atomic commits may lead to overriding a state change done through e.g. 1327107fe904SRajat Jain * a firmware handled hotkey. Therefor userspace must not include the 1328107fe904SRajat Jain * privacy-screen sw-state in an atomic commit unless it wants to change 1329107fe904SRajat Jain * its value. 13304ada6f22SDaniel Vetter */ 13314ada6f22SDaniel Vetter 133252217195SDaniel Vetter int drm_connector_create_standard_properties(struct drm_device *dev) 133352217195SDaniel Vetter { 133452217195SDaniel Vetter struct drm_property *prop; 133552217195SDaniel Vetter 133652217195SDaniel Vetter prop = drm_property_create(dev, DRM_MODE_PROP_BLOB | 133752217195SDaniel Vetter DRM_MODE_PROP_IMMUTABLE, 133852217195SDaniel Vetter "EDID", 0); 133952217195SDaniel Vetter if (!prop) 134052217195SDaniel Vetter return -ENOMEM; 134152217195SDaniel Vetter dev->mode_config.edid_property = prop; 134252217195SDaniel Vetter 134352217195SDaniel Vetter prop = drm_property_create_enum(dev, 0, 134452217195SDaniel Vetter "DPMS", drm_dpms_enum_list, 134552217195SDaniel Vetter ARRAY_SIZE(drm_dpms_enum_list)); 134652217195SDaniel Vetter if (!prop) 134752217195SDaniel Vetter return -ENOMEM; 134852217195SDaniel Vetter dev->mode_config.dpms_property = prop; 134952217195SDaniel Vetter 135052217195SDaniel Vetter prop = drm_property_create(dev, 135152217195SDaniel Vetter DRM_MODE_PROP_BLOB | 135252217195SDaniel Vetter DRM_MODE_PROP_IMMUTABLE, 135352217195SDaniel Vetter "PATH", 0); 135452217195SDaniel Vetter if (!prop) 135552217195SDaniel Vetter return -ENOMEM; 135652217195SDaniel Vetter dev->mode_config.path_property = prop; 135752217195SDaniel Vetter 135852217195SDaniel Vetter prop = drm_property_create(dev, 135952217195SDaniel Vetter DRM_MODE_PROP_BLOB | 136052217195SDaniel Vetter DRM_MODE_PROP_IMMUTABLE, 136152217195SDaniel Vetter "TILE", 0); 136252217195SDaniel Vetter if (!prop) 136352217195SDaniel Vetter return -ENOMEM; 136452217195SDaniel Vetter dev->mode_config.tile_property = prop; 136552217195SDaniel Vetter 136640ee6fbeSManasi Navare prop = drm_property_create_enum(dev, 0, "link-status", 136740ee6fbeSManasi Navare drm_link_status_enum_list, 136840ee6fbeSManasi Navare ARRAY_SIZE(drm_link_status_enum_list)); 136940ee6fbeSManasi Navare if (!prop) 137040ee6fbeSManasi Navare return -ENOMEM; 137140ee6fbeSManasi Navare dev->mode_config.link_status_property = prop; 137240ee6fbeSManasi Navare 137366660d4cSDave Airlie prop = drm_property_create_bool(dev, DRM_MODE_PROP_IMMUTABLE, "non-desktop"); 137466660d4cSDave Airlie if (!prop) 137566660d4cSDave Airlie return -ENOMEM; 137666660d4cSDave Airlie dev->mode_config.non_desktop_property = prop; 137766660d4cSDave Airlie 1378fbb5d035SUma Shankar prop = drm_property_create(dev, DRM_MODE_PROP_BLOB, 1379fbb5d035SUma Shankar "HDR_OUTPUT_METADATA", 0); 1380fbb5d035SUma Shankar if (!prop) 1381fbb5d035SUma Shankar return -ENOMEM; 1382fbb5d035SUma Shankar dev->mode_config.hdr_output_metadata_property = prop; 1383fbb5d035SUma Shankar 138452217195SDaniel Vetter return 0; 138552217195SDaniel Vetter } 138652217195SDaniel Vetter 138752217195SDaniel Vetter /** 138852217195SDaniel Vetter * drm_mode_create_dvi_i_properties - create DVI-I specific connector properties 138952217195SDaniel Vetter * @dev: DRM device 139052217195SDaniel Vetter * 139152217195SDaniel Vetter * Called by a driver the first time a DVI-I connector is made. 1392f85d9e59SRandy Dunlap * 1393f85d9e59SRandy Dunlap * Returns: %0 139452217195SDaniel Vetter */ 139552217195SDaniel Vetter int drm_mode_create_dvi_i_properties(struct drm_device *dev) 139652217195SDaniel Vetter { 139752217195SDaniel Vetter struct drm_property *dvi_i_selector; 139852217195SDaniel Vetter struct drm_property *dvi_i_subconnector; 139952217195SDaniel Vetter 140052217195SDaniel Vetter if (dev->mode_config.dvi_i_select_subconnector_property) 140152217195SDaniel Vetter return 0; 140252217195SDaniel Vetter 140352217195SDaniel Vetter dvi_i_selector = 140452217195SDaniel Vetter drm_property_create_enum(dev, 0, 140552217195SDaniel Vetter "select subconnector", 140652217195SDaniel Vetter drm_dvi_i_select_enum_list, 140752217195SDaniel Vetter ARRAY_SIZE(drm_dvi_i_select_enum_list)); 140852217195SDaniel Vetter dev->mode_config.dvi_i_select_subconnector_property = dvi_i_selector; 140952217195SDaniel Vetter 141052217195SDaniel Vetter dvi_i_subconnector = drm_property_create_enum(dev, DRM_MODE_PROP_IMMUTABLE, 141152217195SDaniel Vetter "subconnector", 141252217195SDaniel Vetter drm_dvi_i_subconnector_enum_list, 141352217195SDaniel Vetter ARRAY_SIZE(drm_dvi_i_subconnector_enum_list)); 141452217195SDaniel Vetter dev->mode_config.dvi_i_subconnector_property = dvi_i_subconnector; 141552217195SDaniel Vetter 141652217195SDaniel Vetter return 0; 141752217195SDaniel Vetter } 141852217195SDaniel Vetter EXPORT_SYMBOL(drm_mode_create_dvi_i_properties); 141952217195SDaniel Vetter 142052217195SDaniel Vetter /** 1421e5b92773SOleg Vasilev * drm_connector_attach_dp_subconnector_property - create subconnector property for DP 1422e5b92773SOleg Vasilev * @connector: drm_connector to attach property 1423e5b92773SOleg Vasilev * 1424e5b92773SOleg Vasilev * Called by a driver when DP connector is created. 1425e5b92773SOleg Vasilev */ 1426e5b92773SOleg Vasilev void drm_connector_attach_dp_subconnector_property(struct drm_connector *connector) 1427e5b92773SOleg Vasilev { 1428e5b92773SOleg Vasilev struct drm_mode_config *mode_config = &connector->dev->mode_config; 1429e5b92773SOleg Vasilev 1430e5b92773SOleg Vasilev if (!mode_config->dp_subconnector_property) 1431e5b92773SOleg Vasilev mode_config->dp_subconnector_property = 1432e5b92773SOleg Vasilev drm_property_create_enum(connector->dev, 1433e5b92773SOleg Vasilev DRM_MODE_PROP_IMMUTABLE, 1434e5b92773SOleg Vasilev "subconnector", 1435e5b92773SOleg Vasilev drm_dp_subconnector_enum_list, 1436e5b92773SOleg Vasilev ARRAY_SIZE(drm_dp_subconnector_enum_list)); 1437e5b92773SOleg Vasilev 1438e5b92773SOleg Vasilev drm_object_attach_property(&connector->base, 1439e5b92773SOleg Vasilev mode_config->dp_subconnector_property, 1440e5b92773SOleg Vasilev DRM_MODE_SUBCONNECTOR_Unknown); 1441e5b92773SOleg Vasilev } 1442e5b92773SOleg Vasilev EXPORT_SYMBOL(drm_connector_attach_dp_subconnector_property); 1443e5b92773SOleg Vasilev 1444e5b92773SOleg Vasilev /** 144550525c33SStanislav Lisovskiy * DOC: HDMI connector properties 144650525c33SStanislav Lisovskiy * 144750525c33SStanislav Lisovskiy * content type (HDMI specific): 144850525c33SStanislav Lisovskiy * Indicates content type setting to be used in HDMI infoframes to indicate 14491e55a53aSMatt Roper * content type for the external device, so that it adjusts its display 145050525c33SStanislav Lisovskiy * settings accordingly. 145150525c33SStanislav Lisovskiy * 145250525c33SStanislav Lisovskiy * The value of this property can be one of the following: 145350525c33SStanislav Lisovskiy * 145450525c33SStanislav Lisovskiy * No Data: 145550525c33SStanislav Lisovskiy * Content type is unknown 145650525c33SStanislav Lisovskiy * Graphics: 145750525c33SStanislav Lisovskiy * Content type is graphics 145850525c33SStanislav Lisovskiy * Photo: 145950525c33SStanislav Lisovskiy * Content type is photo 146050525c33SStanislav Lisovskiy * Cinema: 146150525c33SStanislav Lisovskiy * Content type is cinema 146250525c33SStanislav Lisovskiy * Game: 146350525c33SStanislav Lisovskiy * Content type is game 146450525c33SStanislav Lisovskiy * 1465a0a33067SSimon Ser * The meaning of each content type is defined in CTA-861-G table 15. 1466a0a33067SSimon Ser * 146750525c33SStanislav Lisovskiy * Drivers can set up this property by calling 146850525c33SStanislav Lisovskiy * drm_connector_attach_content_type_property(). Decoding to 1469ba609631SDaniel Vetter * infoframe values is done through drm_hdmi_avi_infoframe_content_type(). 147050525c33SStanislav Lisovskiy */ 147150525c33SStanislav Lisovskiy 147250525c33SStanislav Lisovskiy /** 147350525c33SStanislav Lisovskiy * drm_connector_attach_content_type_property - attach content-type property 147450525c33SStanislav Lisovskiy * @connector: connector to attach content type property on. 147550525c33SStanislav Lisovskiy * 147650525c33SStanislav Lisovskiy * Called by a driver the first time a HDMI connector is made. 1477f85d9e59SRandy Dunlap * 1478f85d9e59SRandy Dunlap * Returns: %0 147950525c33SStanislav Lisovskiy */ 148050525c33SStanislav Lisovskiy int drm_connector_attach_content_type_property(struct drm_connector *connector) 148150525c33SStanislav Lisovskiy { 148250525c33SStanislav Lisovskiy if (!drm_mode_create_content_type_property(connector->dev)) 148350525c33SStanislav Lisovskiy drm_object_attach_property(&connector->base, 148450525c33SStanislav Lisovskiy connector->dev->mode_config.content_type_property, 148550525c33SStanislav Lisovskiy DRM_MODE_CONTENT_TYPE_NO_DATA); 148650525c33SStanislav Lisovskiy return 0; 148750525c33SStanislav Lisovskiy } 148850525c33SStanislav Lisovskiy EXPORT_SYMBOL(drm_connector_attach_content_type_property); 148950525c33SStanislav Lisovskiy 149050525c33SStanislav Lisovskiy /** 1491e9d2871fSMauro Carvalho Chehab * drm_connector_attach_tv_margin_properties - attach TV connector margin 1492e9d2871fSMauro Carvalho Chehab * properties 14936c4f52dcSBoris Brezillon * @connector: DRM connector 14946c4f52dcSBoris Brezillon * 14956c4f52dcSBoris Brezillon * Called by a driver when it needs to attach TV margin props to a connector. 14966c4f52dcSBoris Brezillon * Typically used on SDTV and HDMI connectors. 14976c4f52dcSBoris Brezillon */ 14986c4f52dcSBoris Brezillon void drm_connector_attach_tv_margin_properties(struct drm_connector *connector) 14996c4f52dcSBoris Brezillon { 15006c4f52dcSBoris Brezillon struct drm_device *dev = connector->dev; 15016c4f52dcSBoris Brezillon 15026c4f52dcSBoris Brezillon drm_object_attach_property(&connector->base, 15036c4f52dcSBoris Brezillon dev->mode_config.tv_left_margin_property, 15046c4f52dcSBoris Brezillon 0); 15056c4f52dcSBoris Brezillon drm_object_attach_property(&connector->base, 15066c4f52dcSBoris Brezillon dev->mode_config.tv_right_margin_property, 15076c4f52dcSBoris Brezillon 0); 15086c4f52dcSBoris Brezillon drm_object_attach_property(&connector->base, 15096c4f52dcSBoris Brezillon dev->mode_config.tv_top_margin_property, 15106c4f52dcSBoris Brezillon 0); 15116c4f52dcSBoris Brezillon drm_object_attach_property(&connector->base, 15126c4f52dcSBoris Brezillon dev->mode_config.tv_bottom_margin_property, 15136c4f52dcSBoris Brezillon 0); 15146c4f52dcSBoris Brezillon } 15156c4f52dcSBoris Brezillon EXPORT_SYMBOL(drm_connector_attach_tv_margin_properties); 15166c4f52dcSBoris Brezillon 15176c4f52dcSBoris Brezillon /** 15186c4f52dcSBoris Brezillon * drm_mode_create_tv_margin_properties - create TV connector margin properties 15196c4f52dcSBoris Brezillon * @dev: DRM device 15206c4f52dcSBoris Brezillon * 15216c4f52dcSBoris Brezillon * Called by a driver's HDMI connector initialization routine, this function 15226c4f52dcSBoris Brezillon * creates the TV margin properties for a given device. No need to call this 15236c4f52dcSBoris Brezillon * function for an SDTV connector, it's already called from 15246c4f52dcSBoris Brezillon * drm_mode_create_tv_properties(). 1525f85d9e59SRandy Dunlap * 1526f85d9e59SRandy Dunlap * Returns: 1527f85d9e59SRandy Dunlap * 0 on success or a negative error code on failure. 15286c4f52dcSBoris Brezillon */ 15296c4f52dcSBoris Brezillon int drm_mode_create_tv_margin_properties(struct drm_device *dev) 15306c4f52dcSBoris Brezillon { 15316c4f52dcSBoris Brezillon if (dev->mode_config.tv_left_margin_property) 15326c4f52dcSBoris Brezillon return 0; 15336c4f52dcSBoris Brezillon 15346c4f52dcSBoris Brezillon dev->mode_config.tv_left_margin_property = 15356c4f52dcSBoris Brezillon drm_property_create_range(dev, 0, "left margin", 0, 100); 15366c4f52dcSBoris Brezillon if (!dev->mode_config.tv_left_margin_property) 15376c4f52dcSBoris Brezillon return -ENOMEM; 15386c4f52dcSBoris Brezillon 15396c4f52dcSBoris Brezillon dev->mode_config.tv_right_margin_property = 15406c4f52dcSBoris Brezillon drm_property_create_range(dev, 0, "right margin", 0, 100); 15416c4f52dcSBoris Brezillon if (!dev->mode_config.tv_right_margin_property) 15426c4f52dcSBoris Brezillon return -ENOMEM; 15436c4f52dcSBoris Brezillon 15446c4f52dcSBoris Brezillon dev->mode_config.tv_top_margin_property = 15456c4f52dcSBoris Brezillon drm_property_create_range(dev, 0, "top margin", 0, 100); 15466c4f52dcSBoris Brezillon if (!dev->mode_config.tv_top_margin_property) 15476c4f52dcSBoris Brezillon return -ENOMEM; 15486c4f52dcSBoris Brezillon 15496c4f52dcSBoris Brezillon dev->mode_config.tv_bottom_margin_property = 15506c4f52dcSBoris Brezillon drm_property_create_range(dev, 0, "bottom margin", 0, 100); 15516c4f52dcSBoris Brezillon if (!dev->mode_config.tv_bottom_margin_property) 15526c4f52dcSBoris Brezillon return -ENOMEM; 15536c4f52dcSBoris Brezillon 15546c4f52dcSBoris Brezillon return 0; 15556c4f52dcSBoris Brezillon } 15566c4f52dcSBoris Brezillon EXPORT_SYMBOL(drm_mode_create_tv_margin_properties); 15576c4f52dcSBoris Brezillon 15586c4f52dcSBoris Brezillon /** 1559eda6887fSBoris Brezillon * drm_mode_create_tv_properties - create TV specific connector properties 156052217195SDaniel Vetter * @dev: DRM device 156152217195SDaniel Vetter * @num_modes: number of different TV formats (modes) supported 156252217195SDaniel Vetter * @modes: array of pointers to strings containing name of each format 156352217195SDaniel Vetter * 156452217195SDaniel Vetter * Called by a driver's TV initialization routine, this function creates 156552217195SDaniel Vetter * the TV specific connector properties for a given device. Caller is 156652217195SDaniel Vetter * responsible for allocating a list of format names and passing them to 156752217195SDaniel Vetter * this routine. 1568f85d9e59SRandy Dunlap * 1569f85d9e59SRandy Dunlap * Returns: 1570f85d9e59SRandy Dunlap * 0 on success or a negative error code on failure. 157152217195SDaniel Vetter */ 157252217195SDaniel Vetter int drm_mode_create_tv_properties(struct drm_device *dev, 157352217195SDaniel Vetter unsigned int num_modes, 157452217195SDaniel Vetter const char * const modes[]) 157552217195SDaniel Vetter { 157652217195SDaniel Vetter struct drm_property *tv_selector; 157752217195SDaniel Vetter struct drm_property *tv_subconnector; 157852217195SDaniel Vetter unsigned int i; 157952217195SDaniel Vetter 158052217195SDaniel Vetter if (dev->mode_config.tv_select_subconnector_property) 158152217195SDaniel Vetter return 0; 158252217195SDaniel Vetter 158352217195SDaniel Vetter /* 158452217195SDaniel Vetter * Basic connector properties 158552217195SDaniel Vetter */ 158652217195SDaniel Vetter tv_selector = drm_property_create_enum(dev, 0, 158752217195SDaniel Vetter "select subconnector", 158852217195SDaniel Vetter drm_tv_select_enum_list, 158952217195SDaniel Vetter ARRAY_SIZE(drm_tv_select_enum_list)); 159052217195SDaniel Vetter if (!tv_selector) 159152217195SDaniel Vetter goto nomem; 159252217195SDaniel Vetter 159352217195SDaniel Vetter dev->mode_config.tv_select_subconnector_property = tv_selector; 159452217195SDaniel Vetter 159552217195SDaniel Vetter tv_subconnector = 159652217195SDaniel Vetter drm_property_create_enum(dev, DRM_MODE_PROP_IMMUTABLE, 159752217195SDaniel Vetter "subconnector", 159852217195SDaniel Vetter drm_tv_subconnector_enum_list, 159952217195SDaniel Vetter ARRAY_SIZE(drm_tv_subconnector_enum_list)); 160052217195SDaniel Vetter if (!tv_subconnector) 160152217195SDaniel Vetter goto nomem; 160252217195SDaniel Vetter dev->mode_config.tv_subconnector_property = tv_subconnector; 160352217195SDaniel Vetter 160452217195SDaniel Vetter /* 160552217195SDaniel Vetter * Other, TV specific properties: margins & TV modes. 160652217195SDaniel Vetter */ 16076c4f52dcSBoris Brezillon if (drm_mode_create_tv_margin_properties(dev)) 160852217195SDaniel Vetter goto nomem; 160952217195SDaniel Vetter 161052217195SDaniel Vetter dev->mode_config.tv_mode_property = 161152217195SDaniel Vetter drm_property_create(dev, DRM_MODE_PROP_ENUM, 161252217195SDaniel Vetter "mode", num_modes); 161352217195SDaniel Vetter if (!dev->mode_config.tv_mode_property) 161452217195SDaniel Vetter goto nomem; 161552217195SDaniel Vetter 161652217195SDaniel Vetter for (i = 0; i < num_modes; i++) 161730e9db6dSVille Syrjälä drm_property_add_enum(dev->mode_config.tv_mode_property, 161852217195SDaniel Vetter i, modes[i]); 161952217195SDaniel Vetter 162052217195SDaniel Vetter dev->mode_config.tv_brightness_property = 162152217195SDaniel Vetter drm_property_create_range(dev, 0, "brightness", 0, 100); 162252217195SDaniel Vetter if (!dev->mode_config.tv_brightness_property) 162352217195SDaniel Vetter goto nomem; 162452217195SDaniel Vetter 162552217195SDaniel Vetter dev->mode_config.tv_contrast_property = 162652217195SDaniel Vetter drm_property_create_range(dev, 0, "contrast", 0, 100); 162752217195SDaniel Vetter if (!dev->mode_config.tv_contrast_property) 162852217195SDaniel Vetter goto nomem; 162952217195SDaniel Vetter 163052217195SDaniel Vetter dev->mode_config.tv_flicker_reduction_property = 163152217195SDaniel Vetter drm_property_create_range(dev, 0, "flicker reduction", 0, 100); 163252217195SDaniel Vetter if (!dev->mode_config.tv_flicker_reduction_property) 163352217195SDaniel Vetter goto nomem; 163452217195SDaniel Vetter 163552217195SDaniel Vetter dev->mode_config.tv_overscan_property = 163652217195SDaniel Vetter drm_property_create_range(dev, 0, "overscan", 0, 100); 163752217195SDaniel Vetter if (!dev->mode_config.tv_overscan_property) 163852217195SDaniel Vetter goto nomem; 163952217195SDaniel Vetter 164052217195SDaniel Vetter dev->mode_config.tv_saturation_property = 164152217195SDaniel Vetter drm_property_create_range(dev, 0, "saturation", 0, 100); 164252217195SDaniel Vetter if (!dev->mode_config.tv_saturation_property) 164352217195SDaniel Vetter goto nomem; 164452217195SDaniel Vetter 164552217195SDaniel Vetter dev->mode_config.tv_hue_property = 164652217195SDaniel Vetter drm_property_create_range(dev, 0, "hue", 0, 100); 164752217195SDaniel Vetter if (!dev->mode_config.tv_hue_property) 164852217195SDaniel Vetter goto nomem; 164952217195SDaniel Vetter 165052217195SDaniel Vetter return 0; 165152217195SDaniel Vetter nomem: 165252217195SDaniel Vetter return -ENOMEM; 165352217195SDaniel Vetter } 165452217195SDaniel Vetter EXPORT_SYMBOL(drm_mode_create_tv_properties); 165552217195SDaniel Vetter 165652217195SDaniel Vetter /** 165752217195SDaniel Vetter * drm_mode_create_scaling_mode_property - create scaling mode property 165852217195SDaniel Vetter * @dev: DRM device 165952217195SDaniel Vetter * 166052217195SDaniel Vetter * Called by a driver the first time it's needed, must be attached to desired 166152217195SDaniel Vetter * connectors. 16628f6e1e22SMaarten Lankhorst * 16638f6e1e22SMaarten Lankhorst * Atomic drivers should use drm_connector_attach_scaling_mode_property() 16649c2fce13SVille Syrjälä * instead to correctly assign &drm_connector_state.scaling_mode 16658f6e1e22SMaarten Lankhorst * in the atomic state. 1666f85d9e59SRandy Dunlap * 1667f85d9e59SRandy Dunlap * Returns: %0 166852217195SDaniel Vetter */ 166952217195SDaniel Vetter int drm_mode_create_scaling_mode_property(struct drm_device *dev) 167052217195SDaniel Vetter { 167152217195SDaniel Vetter struct drm_property *scaling_mode; 167252217195SDaniel Vetter 167352217195SDaniel Vetter if (dev->mode_config.scaling_mode_property) 167452217195SDaniel Vetter return 0; 167552217195SDaniel Vetter 167652217195SDaniel Vetter scaling_mode = 167752217195SDaniel Vetter drm_property_create_enum(dev, 0, "scaling mode", 167852217195SDaniel Vetter drm_scaling_mode_enum_list, 167952217195SDaniel Vetter ARRAY_SIZE(drm_scaling_mode_enum_list)); 168052217195SDaniel Vetter 168152217195SDaniel Vetter dev->mode_config.scaling_mode_property = scaling_mode; 168252217195SDaniel Vetter 168352217195SDaniel Vetter return 0; 168452217195SDaniel Vetter } 168552217195SDaniel Vetter EXPORT_SYMBOL(drm_mode_create_scaling_mode_property); 168652217195SDaniel Vetter 168752217195SDaniel Vetter /** 1688ab7a664fSNicholas Kazlauskas * DOC: Variable refresh properties 1689ab7a664fSNicholas Kazlauskas * 1690ab7a664fSNicholas Kazlauskas * Variable refresh rate capable displays can dynamically adjust their 1691ab7a664fSNicholas Kazlauskas * refresh rate by extending the duration of their vertical front porch 1692ab7a664fSNicholas Kazlauskas * until page flip or timeout occurs. This can reduce or remove stuttering 1693ab7a664fSNicholas Kazlauskas * and latency in scenarios where the page flip does not align with the 1694ab7a664fSNicholas Kazlauskas * vblank interval. 1695ab7a664fSNicholas Kazlauskas * 1696ab7a664fSNicholas Kazlauskas * An example scenario would be an application flipping at a constant rate 1697ab7a664fSNicholas Kazlauskas * of 48Hz on a 60Hz display. The page flip will frequently miss the vblank 1698ab7a664fSNicholas Kazlauskas * interval and the same contents will be displayed twice. This can be 1699ab7a664fSNicholas Kazlauskas * observed as stuttering for content with motion. 1700ab7a664fSNicholas Kazlauskas * 1701ab7a664fSNicholas Kazlauskas * If variable refresh rate was active on a display that supported a 1702ab7a664fSNicholas Kazlauskas * variable refresh range from 35Hz to 60Hz no stuttering would be observable 1703ab7a664fSNicholas Kazlauskas * for the example scenario. The minimum supported variable refresh rate of 1704ab7a664fSNicholas Kazlauskas * 35Hz is below the page flip frequency and the vertical front porch can 1705ab7a664fSNicholas Kazlauskas * be extended until the page flip occurs. The vblank interval will be 1706ab7a664fSNicholas Kazlauskas * directly aligned to the page flip rate. 1707ab7a664fSNicholas Kazlauskas * 1708ab7a664fSNicholas Kazlauskas * Not all userspace content is suitable for use with variable refresh rate. 1709ab7a664fSNicholas Kazlauskas * Large and frequent changes in vertical front porch duration may worsen 1710ab7a664fSNicholas Kazlauskas * perceived stuttering for input sensitive applications. 1711ab7a664fSNicholas Kazlauskas * 1712ab7a664fSNicholas Kazlauskas * Panel brightness will also vary with vertical front porch duration. Some 1713ab7a664fSNicholas Kazlauskas * panels may have noticeable differences in brightness between the minimum 1714ab7a664fSNicholas Kazlauskas * vertical front porch duration and the maximum vertical front porch duration. 1715ab7a664fSNicholas Kazlauskas * Large and frequent changes in vertical front porch duration may produce 1716ab7a664fSNicholas Kazlauskas * observable flickering for such panels. 1717ab7a664fSNicholas Kazlauskas * 1718ab7a664fSNicholas Kazlauskas * Userspace control for variable refresh rate is supported via properties 1719ab7a664fSNicholas Kazlauskas * on the &drm_connector and &drm_crtc objects. 1720ab7a664fSNicholas Kazlauskas * 1721ab7a664fSNicholas Kazlauskas * "vrr_capable": 1722ab7a664fSNicholas Kazlauskas * Optional &drm_connector boolean property that drivers should attach 1723ab7a664fSNicholas Kazlauskas * with drm_connector_attach_vrr_capable_property() on connectors that 1724ab7a664fSNicholas Kazlauskas * could support variable refresh rates. Drivers should update the 1725ab7a664fSNicholas Kazlauskas * property value by calling drm_connector_set_vrr_capable_property(). 1726ab7a664fSNicholas Kazlauskas * 1727ab7a664fSNicholas Kazlauskas * Absence of the property should indicate absence of support. 1728ab7a664fSNicholas Kazlauskas * 172977086014SDaniel Vetter * "VRR_ENABLED": 1730ab7a664fSNicholas Kazlauskas * Default &drm_crtc boolean property that notifies the driver that the 1731ab7a664fSNicholas Kazlauskas * content on the CRTC is suitable for variable refresh rate presentation. 1732ab7a664fSNicholas Kazlauskas * The driver will take this property as a hint to enable variable 1733ab7a664fSNicholas Kazlauskas * refresh rate support if the receiver supports it, ie. if the 1734ab7a664fSNicholas Kazlauskas * "vrr_capable" property is true on the &drm_connector object. The 1735ab7a664fSNicholas Kazlauskas * vertical front porch duration will be extended until page-flip or 1736ab7a664fSNicholas Kazlauskas * timeout when enabled. 1737ab7a664fSNicholas Kazlauskas * 1738ab7a664fSNicholas Kazlauskas * The minimum vertical front porch duration is defined as the vertical 1739ab7a664fSNicholas Kazlauskas * front porch duration for the current mode. 1740ab7a664fSNicholas Kazlauskas * 1741ab7a664fSNicholas Kazlauskas * The maximum vertical front porch duration is greater than or equal to 1742ab7a664fSNicholas Kazlauskas * the minimum vertical front porch duration. The duration is derived 1743ab7a664fSNicholas Kazlauskas * from the minimum supported variable refresh rate for the connector. 1744ab7a664fSNicholas Kazlauskas * 1745ab7a664fSNicholas Kazlauskas * The driver may place further restrictions within these minimum 1746ab7a664fSNicholas Kazlauskas * and maximum bounds. 1747ab7a664fSNicholas Kazlauskas */ 1748ab7a664fSNicholas Kazlauskas 1749ab7a664fSNicholas Kazlauskas /** 1750ba1b0f6cSNicholas Kazlauskas * drm_connector_attach_vrr_capable_property - creates the 1751ba1b0f6cSNicholas Kazlauskas * vrr_capable property 1752ba1b0f6cSNicholas Kazlauskas * @connector: connector to create the vrr_capable property on. 1753ba1b0f6cSNicholas Kazlauskas * 1754ba1b0f6cSNicholas Kazlauskas * This is used by atomic drivers to add support for querying 1755ba1b0f6cSNicholas Kazlauskas * variable refresh rate capability for a connector. 1756ba1b0f6cSNicholas Kazlauskas * 1757ba1b0f6cSNicholas Kazlauskas * Returns: 175884e543bcSAntonio Borneo * Zero on success, negative errno on failure. 1759ba1b0f6cSNicholas Kazlauskas */ 1760ba1b0f6cSNicholas Kazlauskas int drm_connector_attach_vrr_capable_property( 1761ba1b0f6cSNicholas Kazlauskas struct drm_connector *connector) 1762ba1b0f6cSNicholas Kazlauskas { 1763ba1b0f6cSNicholas Kazlauskas struct drm_device *dev = connector->dev; 1764ba1b0f6cSNicholas Kazlauskas struct drm_property *prop; 1765ba1b0f6cSNicholas Kazlauskas 1766ba1b0f6cSNicholas Kazlauskas if (!connector->vrr_capable_property) { 1767ba1b0f6cSNicholas Kazlauskas prop = drm_property_create_bool(dev, DRM_MODE_PROP_IMMUTABLE, 1768ba1b0f6cSNicholas Kazlauskas "vrr_capable"); 1769ba1b0f6cSNicholas Kazlauskas if (!prop) 1770ba1b0f6cSNicholas Kazlauskas return -ENOMEM; 1771ba1b0f6cSNicholas Kazlauskas 1772ba1b0f6cSNicholas Kazlauskas connector->vrr_capable_property = prop; 1773ba1b0f6cSNicholas Kazlauskas drm_object_attach_property(&connector->base, prop, 0); 1774ba1b0f6cSNicholas Kazlauskas } 1775ba1b0f6cSNicholas Kazlauskas 1776ba1b0f6cSNicholas Kazlauskas return 0; 1777ba1b0f6cSNicholas Kazlauskas } 1778ba1b0f6cSNicholas Kazlauskas EXPORT_SYMBOL(drm_connector_attach_vrr_capable_property); 1779ba1b0f6cSNicholas Kazlauskas 1780ba1b0f6cSNicholas Kazlauskas /** 17818f6e1e22SMaarten Lankhorst * drm_connector_attach_scaling_mode_property - attach atomic scaling mode property 17828f6e1e22SMaarten Lankhorst * @connector: connector to attach scaling mode property on. 17838f6e1e22SMaarten Lankhorst * @scaling_mode_mask: or'ed mask of BIT(%DRM_MODE_SCALE_\*). 17848f6e1e22SMaarten Lankhorst * 17858f6e1e22SMaarten Lankhorst * This is used to add support for scaling mode to atomic drivers. 17869c2fce13SVille Syrjälä * The scaling mode will be set to &drm_connector_state.scaling_mode 17878f6e1e22SMaarten Lankhorst * and can be used from &drm_connector_helper_funcs->atomic_check for validation. 17888f6e1e22SMaarten Lankhorst * 17898f6e1e22SMaarten Lankhorst * This is the atomic version of drm_mode_create_scaling_mode_property(). 17908f6e1e22SMaarten Lankhorst * 17918f6e1e22SMaarten Lankhorst * Returns: 17928f6e1e22SMaarten Lankhorst * Zero on success, negative errno on failure. 17938f6e1e22SMaarten Lankhorst */ 17948f6e1e22SMaarten Lankhorst int drm_connector_attach_scaling_mode_property(struct drm_connector *connector, 17958f6e1e22SMaarten Lankhorst u32 scaling_mode_mask) 17968f6e1e22SMaarten Lankhorst { 17978f6e1e22SMaarten Lankhorst struct drm_device *dev = connector->dev; 17988f6e1e22SMaarten Lankhorst struct drm_property *scaling_mode_property; 179930e9db6dSVille Syrjälä int i; 18008f6e1e22SMaarten Lankhorst const unsigned valid_scaling_mode_mask = 18018f6e1e22SMaarten Lankhorst (1U << ARRAY_SIZE(drm_scaling_mode_enum_list)) - 1; 18028f6e1e22SMaarten Lankhorst 18038f6e1e22SMaarten Lankhorst if (WARN_ON(hweight32(scaling_mode_mask) < 2 || 18048f6e1e22SMaarten Lankhorst scaling_mode_mask & ~valid_scaling_mode_mask)) 18058f6e1e22SMaarten Lankhorst return -EINVAL; 18068f6e1e22SMaarten Lankhorst 18078f6e1e22SMaarten Lankhorst scaling_mode_property = 18088f6e1e22SMaarten Lankhorst drm_property_create(dev, DRM_MODE_PROP_ENUM, "scaling mode", 18098f6e1e22SMaarten Lankhorst hweight32(scaling_mode_mask)); 18108f6e1e22SMaarten Lankhorst 18118f6e1e22SMaarten Lankhorst if (!scaling_mode_property) 18128f6e1e22SMaarten Lankhorst return -ENOMEM; 18138f6e1e22SMaarten Lankhorst 18148f6e1e22SMaarten Lankhorst for (i = 0; i < ARRAY_SIZE(drm_scaling_mode_enum_list); i++) { 18158f6e1e22SMaarten Lankhorst int ret; 18168f6e1e22SMaarten Lankhorst 18178f6e1e22SMaarten Lankhorst if (!(BIT(i) & scaling_mode_mask)) 18188f6e1e22SMaarten Lankhorst continue; 18198f6e1e22SMaarten Lankhorst 182030e9db6dSVille Syrjälä ret = drm_property_add_enum(scaling_mode_property, 18218f6e1e22SMaarten Lankhorst drm_scaling_mode_enum_list[i].type, 18228f6e1e22SMaarten Lankhorst drm_scaling_mode_enum_list[i].name); 18238f6e1e22SMaarten Lankhorst 18248f6e1e22SMaarten Lankhorst if (ret) { 18258f6e1e22SMaarten Lankhorst drm_property_destroy(dev, scaling_mode_property); 18268f6e1e22SMaarten Lankhorst 18278f6e1e22SMaarten Lankhorst return ret; 18288f6e1e22SMaarten Lankhorst } 18298f6e1e22SMaarten Lankhorst } 18308f6e1e22SMaarten Lankhorst 18318f6e1e22SMaarten Lankhorst drm_object_attach_property(&connector->base, 18328f6e1e22SMaarten Lankhorst scaling_mode_property, 0); 18338f6e1e22SMaarten Lankhorst 18348f6e1e22SMaarten Lankhorst connector->scaling_mode_property = scaling_mode_property; 18358f6e1e22SMaarten Lankhorst 18368f6e1e22SMaarten Lankhorst return 0; 18378f6e1e22SMaarten Lankhorst } 18388f6e1e22SMaarten Lankhorst EXPORT_SYMBOL(drm_connector_attach_scaling_mode_property); 18398f6e1e22SMaarten Lankhorst 18408f6e1e22SMaarten Lankhorst /** 184152217195SDaniel Vetter * drm_mode_create_aspect_ratio_property - create aspect ratio property 184252217195SDaniel Vetter * @dev: DRM device 184352217195SDaniel Vetter * 184452217195SDaniel Vetter * Called by a driver the first time it's needed, must be attached to desired 184552217195SDaniel Vetter * connectors. 184652217195SDaniel Vetter * 184752217195SDaniel Vetter * Returns: 184852217195SDaniel Vetter * Zero on success, negative errno on failure. 184952217195SDaniel Vetter */ 185052217195SDaniel Vetter int drm_mode_create_aspect_ratio_property(struct drm_device *dev) 185152217195SDaniel Vetter { 185252217195SDaniel Vetter if (dev->mode_config.aspect_ratio_property) 185352217195SDaniel Vetter return 0; 185452217195SDaniel Vetter 185552217195SDaniel Vetter dev->mode_config.aspect_ratio_property = 185652217195SDaniel Vetter drm_property_create_enum(dev, 0, "aspect ratio", 185752217195SDaniel Vetter drm_aspect_ratio_enum_list, 185852217195SDaniel Vetter ARRAY_SIZE(drm_aspect_ratio_enum_list)); 185952217195SDaniel Vetter 186052217195SDaniel Vetter if (dev->mode_config.aspect_ratio_property == NULL) 186152217195SDaniel Vetter return -ENOMEM; 186252217195SDaniel Vetter 186352217195SDaniel Vetter return 0; 186452217195SDaniel Vetter } 186552217195SDaniel Vetter EXPORT_SYMBOL(drm_mode_create_aspect_ratio_property); 186652217195SDaniel Vetter 186752217195SDaniel Vetter /** 1868d2c6a405SUma Shankar * DOC: standard connector properties 1869d2c6a405SUma Shankar * 1870d2c6a405SUma Shankar * Colorspace: 1871d2c6a405SUma Shankar * This property helps select a suitable colorspace based on the sink 1872d2c6a405SUma Shankar * capability. Modern sink devices support wider gamut like BT2020. 1873d2c6a405SUma Shankar * This helps switch to BT2020 mode if the BT2020 encoded video stream 1874d2c6a405SUma Shankar * is being played by the user, same for any other colorspace. Thereby 1875d2c6a405SUma Shankar * giving a good visual experience to users. 1876d2c6a405SUma Shankar * 1877d2c6a405SUma Shankar * The expectation from userspace is that it should parse the EDID 1878d2c6a405SUma Shankar * and get supported colorspaces. Use this property and switch to the 1879d2c6a405SUma Shankar * one supported. Sink supported colorspaces should be retrieved by 1880d2c6a405SUma Shankar * userspace from EDID and driver will not explicitly expose them. 1881d2c6a405SUma Shankar * 1882d2c6a405SUma Shankar * Basically the expectation from userspace is: 1883d2c6a405SUma Shankar * - Set up CRTC DEGAMMA/CTM/GAMMA to convert to some sink 1884d2c6a405SUma Shankar * colorspace 1885d2c6a405SUma Shankar * - Set this new property to let the sink know what it 1886d2c6a405SUma Shankar * converted the CRTC output to. 1887d2c6a405SUma Shankar * - This property is just to inform sink what colorspace 1888d2c6a405SUma Shankar * source is trying to drive. 1889d2c6a405SUma Shankar * 18908806cd3aSGwan-gyeong Mun * Because between HDMI and DP have different colorspaces, 189145cf0e91SGwan-gyeong Mun * drm_mode_create_hdmi_colorspace_property() is used for HDMI connector and 189245cf0e91SGwan-gyeong Mun * drm_mode_create_dp_colorspace_property() is used for DP connector. 1893d2c6a405SUma Shankar */ 18948806cd3aSGwan-gyeong Mun 18958806cd3aSGwan-gyeong Mun /** 18968806cd3aSGwan-gyeong Mun * drm_mode_create_hdmi_colorspace_property - create hdmi colorspace property 18978806cd3aSGwan-gyeong Mun * @connector: connector to create the Colorspace property on. 18988806cd3aSGwan-gyeong Mun * 18998806cd3aSGwan-gyeong Mun * Called by a driver the first time it's needed, must be attached to desired 19008806cd3aSGwan-gyeong Mun * HDMI connectors. 19018806cd3aSGwan-gyeong Mun * 19028806cd3aSGwan-gyeong Mun * Returns: 190384e543bcSAntonio Borneo * Zero on success, negative errno on failure. 19048806cd3aSGwan-gyeong Mun */ 19058806cd3aSGwan-gyeong Mun int drm_mode_create_hdmi_colorspace_property(struct drm_connector *connector) 1906d2c6a405SUma Shankar { 1907d2c6a405SUma Shankar struct drm_device *dev = connector->dev; 1908d2c6a405SUma Shankar 19098806cd3aSGwan-gyeong Mun if (connector->colorspace_property) 19108806cd3aSGwan-gyeong Mun return 0; 19118806cd3aSGwan-gyeong Mun 19128806cd3aSGwan-gyeong Mun connector->colorspace_property = 19138806cd3aSGwan-gyeong Mun drm_property_create_enum(dev, DRM_MODE_PROP_ENUM, "Colorspace", 1914d2c6a405SUma Shankar hdmi_colorspaces, 1915d2c6a405SUma Shankar ARRAY_SIZE(hdmi_colorspaces)); 19168806cd3aSGwan-gyeong Mun 19178806cd3aSGwan-gyeong Mun if (!connector->colorspace_property) 1918d2c6a405SUma Shankar return -ENOMEM; 1919d2c6a405SUma Shankar 1920d2c6a405SUma Shankar return 0; 1921d2c6a405SUma Shankar } 19228806cd3aSGwan-gyeong Mun EXPORT_SYMBOL(drm_mode_create_hdmi_colorspace_property); 1923d2c6a405SUma Shankar 1924d2c6a405SUma Shankar /** 192545cf0e91SGwan-gyeong Mun * drm_mode_create_dp_colorspace_property - create dp colorspace property 192645cf0e91SGwan-gyeong Mun * @connector: connector to create the Colorspace property on. 192745cf0e91SGwan-gyeong Mun * 192845cf0e91SGwan-gyeong Mun * Called by a driver the first time it's needed, must be attached to desired 192945cf0e91SGwan-gyeong Mun * DP connectors. 193045cf0e91SGwan-gyeong Mun * 193145cf0e91SGwan-gyeong Mun * Returns: 193284e543bcSAntonio Borneo * Zero on success, negative errno on failure. 193345cf0e91SGwan-gyeong Mun */ 193445cf0e91SGwan-gyeong Mun int drm_mode_create_dp_colorspace_property(struct drm_connector *connector) 193545cf0e91SGwan-gyeong Mun { 193645cf0e91SGwan-gyeong Mun struct drm_device *dev = connector->dev; 193745cf0e91SGwan-gyeong Mun 193845cf0e91SGwan-gyeong Mun if (connector->colorspace_property) 193945cf0e91SGwan-gyeong Mun return 0; 194045cf0e91SGwan-gyeong Mun 194145cf0e91SGwan-gyeong Mun connector->colorspace_property = 194245cf0e91SGwan-gyeong Mun drm_property_create_enum(dev, DRM_MODE_PROP_ENUM, "Colorspace", 194345cf0e91SGwan-gyeong Mun dp_colorspaces, 194445cf0e91SGwan-gyeong Mun ARRAY_SIZE(dp_colorspaces)); 194545cf0e91SGwan-gyeong Mun 194645cf0e91SGwan-gyeong Mun if (!connector->colorspace_property) 194745cf0e91SGwan-gyeong Mun return -ENOMEM; 194845cf0e91SGwan-gyeong Mun 194945cf0e91SGwan-gyeong Mun return 0; 195045cf0e91SGwan-gyeong Mun } 195145cf0e91SGwan-gyeong Mun EXPORT_SYMBOL(drm_mode_create_dp_colorspace_property); 195252217195SDaniel Vetter 195397e14fbeSDaniel Vetter /** 195452217195SDaniel Vetter * drm_mode_create_content_type_property - create content type property 195552217195SDaniel Vetter * @dev: DRM device 195697e14fbeSDaniel Vetter * 195752217195SDaniel Vetter * Called by a driver the first time it's needed, must be attached to desired 195852217195SDaniel Vetter * connectors. 195952217195SDaniel Vetter * 196052217195SDaniel Vetter * Returns: 196152217195SDaniel Vetter * Zero on success, negative errno on failure. 196252217195SDaniel Vetter */ 196352217195SDaniel Vetter int drm_mode_create_content_type_property(struct drm_device *dev) 196452217195SDaniel Vetter { 196552217195SDaniel Vetter if (dev->mode_config.content_type_property) 196697e14fbeSDaniel Vetter return 0; 196752217195SDaniel Vetter 196852217195SDaniel Vetter dev->mode_config.content_type_property = 196952217195SDaniel Vetter drm_property_create_enum(dev, 0, "content type", 197052217195SDaniel Vetter drm_content_type_enum_list, 197152217195SDaniel Vetter ARRAY_SIZE(drm_content_type_enum_list)); 197252217195SDaniel Vetter 197352217195SDaniel Vetter if (dev->mode_config.content_type_property == NULL) 197452217195SDaniel Vetter return -ENOMEM; 197552217195SDaniel Vetter 197652217195SDaniel Vetter return 0; 197752217195SDaniel Vetter } 197852217195SDaniel Vetter EXPORT_SYMBOL(drm_mode_create_content_type_property); 197952217195SDaniel Vetter 198052217195SDaniel Vetter /** 198152217195SDaniel Vetter * drm_mode_create_suggested_offset_properties - create suggests offset properties 198252217195SDaniel Vetter * @dev: DRM device 198352217195SDaniel Vetter * 198484e543bcSAntonio Borneo * Create the suggested x/y offset property for connectors. 1985f85d9e59SRandy Dunlap * 1986f85d9e59SRandy Dunlap * Returns: 1987f85d9e59SRandy Dunlap * 0 on success or a negative error code on failure. 198852217195SDaniel Vetter */ 198952217195SDaniel Vetter int drm_mode_create_suggested_offset_properties(struct drm_device *dev) 199052217195SDaniel Vetter { 199152217195SDaniel Vetter if (dev->mode_config.suggested_x_property && dev->mode_config.suggested_y_property) 199252217195SDaniel Vetter return 0; 199352217195SDaniel Vetter 199452217195SDaniel Vetter dev->mode_config.suggested_x_property = 199552217195SDaniel Vetter drm_property_create_range(dev, DRM_MODE_PROP_IMMUTABLE, "suggested X", 0, 0xffffffff); 199652217195SDaniel Vetter 199752217195SDaniel Vetter dev->mode_config.suggested_y_property = 199852217195SDaniel Vetter drm_property_create_range(dev, DRM_MODE_PROP_IMMUTABLE, "suggested Y", 0, 0xffffffff); 199952217195SDaniel Vetter 200052217195SDaniel Vetter if (dev->mode_config.suggested_x_property == NULL || 200152217195SDaniel Vetter dev->mode_config.suggested_y_property == NULL) 200252217195SDaniel Vetter return -ENOMEM; 200352217195SDaniel Vetter return 0; 200452217195SDaniel Vetter } 200552217195SDaniel Vetter EXPORT_SYMBOL(drm_mode_create_suggested_offset_properties); 200652217195SDaniel Vetter 200752217195SDaniel Vetter /** 200852217195SDaniel Vetter * drm_connector_set_path_property - set tile property on connector 200952217195SDaniel Vetter * @connector: connector to set property on. 201052217195SDaniel Vetter * @path: path to use for property; must not be NULL. 201152217195SDaniel Vetter * 201252217195SDaniel Vetter * This creates a property to expose to userspace to specify a 201352217195SDaniel Vetter * connector path. This is mainly used for DisplayPort MST where 201452217195SDaniel Vetter * connectors have a topology and we want to allow userspace to give 201552217195SDaniel Vetter * them more meaningful names. 201652217195SDaniel Vetter * 201752217195SDaniel Vetter * Returns: 201852217195SDaniel Vetter * Zero on success, negative errno on failure. 201952217195SDaniel Vetter */ 202052217195SDaniel Vetter int drm_connector_set_path_property(struct drm_connector *connector, 202152217195SDaniel Vetter const char *path) 202252217195SDaniel Vetter { 202352217195SDaniel Vetter struct drm_device *dev = connector->dev; 202452217195SDaniel Vetter int ret; 202552217195SDaniel Vetter 202652217195SDaniel Vetter ret = drm_property_replace_global_blob(dev, 202752217195SDaniel Vetter &connector->path_blob_ptr, 202852217195SDaniel Vetter strlen(path) + 1, 202952217195SDaniel Vetter path, 203052217195SDaniel Vetter &connector->base, 203152217195SDaniel Vetter dev->mode_config.path_property); 203252217195SDaniel Vetter return ret; 203352217195SDaniel Vetter } 203452217195SDaniel Vetter EXPORT_SYMBOL(drm_connector_set_path_property); 203552217195SDaniel Vetter 203652217195SDaniel Vetter /** 203752217195SDaniel Vetter * drm_connector_set_tile_property - set tile property on connector 203852217195SDaniel Vetter * @connector: connector to set property on. 203952217195SDaniel Vetter * 204052217195SDaniel Vetter * This looks up the tile information for a connector, and creates a 204152217195SDaniel Vetter * property for userspace to parse if it exists. The property is of 204252217195SDaniel Vetter * the form of 8 integers using ':' as a separator. 20432de3a078SManasi Navare * This is used for dual port tiled displays with DisplayPort SST 20442de3a078SManasi Navare * or DisplayPort MST connectors. 204552217195SDaniel Vetter * 204652217195SDaniel Vetter * Returns: 204752217195SDaniel Vetter * Zero on success, errno on failure. 204852217195SDaniel Vetter */ 204952217195SDaniel Vetter int drm_connector_set_tile_property(struct drm_connector *connector) 205052217195SDaniel Vetter { 205152217195SDaniel Vetter struct drm_device *dev = connector->dev; 205252217195SDaniel Vetter char tile[256]; 205352217195SDaniel Vetter int ret; 205452217195SDaniel Vetter 205552217195SDaniel Vetter if (!connector->has_tile) { 205652217195SDaniel Vetter ret = drm_property_replace_global_blob(dev, 205752217195SDaniel Vetter &connector->tile_blob_ptr, 205852217195SDaniel Vetter 0, 205952217195SDaniel Vetter NULL, 206052217195SDaniel Vetter &connector->base, 206152217195SDaniel Vetter dev->mode_config.tile_property); 206252217195SDaniel Vetter return ret; 206352217195SDaniel Vetter } 206452217195SDaniel Vetter 206552217195SDaniel Vetter snprintf(tile, 256, "%d:%d:%d:%d:%d:%d:%d:%d", 206652217195SDaniel Vetter connector->tile_group->id, connector->tile_is_single_monitor, 206752217195SDaniel Vetter connector->num_h_tile, connector->num_v_tile, 206852217195SDaniel Vetter connector->tile_h_loc, connector->tile_v_loc, 206952217195SDaniel Vetter connector->tile_h_size, connector->tile_v_size); 207052217195SDaniel Vetter 207152217195SDaniel Vetter ret = drm_property_replace_global_blob(dev, 207252217195SDaniel Vetter &connector->tile_blob_ptr, 207352217195SDaniel Vetter strlen(tile) + 1, 207452217195SDaniel Vetter tile, 207552217195SDaniel Vetter &connector->base, 207652217195SDaniel Vetter dev->mode_config.tile_property); 207752217195SDaniel Vetter return ret; 207852217195SDaniel Vetter } 207997e14fbeSDaniel Vetter EXPORT_SYMBOL(drm_connector_set_tile_property); 208052217195SDaniel Vetter 208152217195SDaniel Vetter /** 208297e14fbeSDaniel Vetter * drm_connector_set_link_status_property - Set link status property of a connector 208340ee6fbeSManasi Navare * @connector: drm connector 208440ee6fbeSManasi Navare * @link_status: new value of link status property (0: Good, 1: Bad) 208540ee6fbeSManasi Navare * 208640ee6fbeSManasi Navare * In usual working scenario, this link status property will always be set to 208740ee6fbeSManasi Navare * "GOOD". If something fails during or after a mode set, the kernel driver 208840ee6fbeSManasi Navare * may set this link status property to "BAD". The caller then needs to send a 208940ee6fbeSManasi Navare * hotplug uevent for userspace to re-check the valid modes through 209040ee6fbeSManasi Navare * GET_CONNECTOR_IOCTL and retry modeset. 209140ee6fbeSManasi Navare * 209240ee6fbeSManasi Navare * Note: Drivers cannot rely on userspace to support this property and 209340ee6fbeSManasi Navare * issue a modeset. As such, they may choose to handle issues (like 209440ee6fbeSManasi Navare * re-training a link) without userspace's intervention. 209540ee6fbeSManasi Navare * 209640ee6fbeSManasi Navare * The reason for adding this property is to handle link training failures, but 209740ee6fbeSManasi Navare * it is not limited to DP or link training. For example, if we implement 209840ee6fbeSManasi Navare * asynchronous setcrtc, this property can be used to report any failures in that. 209940ee6fbeSManasi Navare */ 210097e14fbeSDaniel Vetter void drm_connector_set_link_status_property(struct drm_connector *connector, 210140ee6fbeSManasi Navare uint64_t link_status) 210240ee6fbeSManasi Navare { 210340ee6fbeSManasi Navare struct drm_device *dev = connector->dev; 210440ee6fbeSManasi Navare 210540ee6fbeSManasi Navare drm_modeset_lock(&dev->mode_config.connection_mutex, NULL); 210640ee6fbeSManasi Navare connector->state->link_status = link_status; 210740ee6fbeSManasi Navare drm_modeset_unlock(&dev->mode_config.connection_mutex); 210840ee6fbeSManasi Navare } 210997e14fbeSDaniel Vetter EXPORT_SYMBOL(drm_connector_set_link_status_property); 211040ee6fbeSManasi Navare 21118d70f395SHans de Goede /** 211247e22ff1SRadhakrishna Sripada * drm_connector_attach_max_bpc_property - attach "max bpc" property 211347e22ff1SRadhakrishna Sripada * @connector: connector to attach max bpc property on. 211447e22ff1SRadhakrishna Sripada * @min: The minimum bit depth supported by the connector. 211547e22ff1SRadhakrishna Sripada * @max: The maximum bit depth supported by the connector. 211647e22ff1SRadhakrishna Sripada * 211747e22ff1SRadhakrishna Sripada * This is used to add support for limiting the bit depth on a connector. 211847e22ff1SRadhakrishna Sripada * 211947e22ff1SRadhakrishna Sripada * Returns: 212047e22ff1SRadhakrishna Sripada * Zero on success, negative errno on failure. 212147e22ff1SRadhakrishna Sripada */ 212247e22ff1SRadhakrishna Sripada int drm_connector_attach_max_bpc_property(struct drm_connector *connector, 212347e22ff1SRadhakrishna Sripada int min, int max) 212447e22ff1SRadhakrishna Sripada { 212547e22ff1SRadhakrishna Sripada struct drm_device *dev = connector->dev; 212647e22ff1SRadhakrishna Sripada struct drm_property *prop; 212747e22ff1SRadhakrishna Sripada 212847e22ff1SRadhakrishna Sripada prop = connector->max_bpc_property; 212947e22ff1SRadhakrishna Sripada if (!prop) { 213047e22ff1SRadhakrishna Sripada prop = drm_property_create_range(dev, 0, "max bpc", min, max); 213147e22ff1SRadhakrishna Sripada if (!prop) 213247e22ff1SRadhakrishna Sripada return -ENOMEM; 213347e22ff1SRadhakrishna Sripada 213447e22ff1SRadhakrishna Sripada connector->max_bpc_property = prop; 213547e22ff1SRadhakrishna Sripada } 213647e22ff1SRadhakrishna Sripada 213747e22ff1SRadhakrishna Sripada drm_object_attach_property(&connector->base, prop, max); 213847e22ff1SRadhakrishna Sripada connector->state->max_requested_bpc = max; 213947e22ff1SRadhakrishna Sripada connector->state->max_bpc = max; 214047e22ff1SRadhakrishna Sripada 214147e22ff1SRadhakrishna Sripada return 0; 214247e22ff1SRadhakrishna Sripada } 214347e22ff1SRadhakrishna Sripada EXPORT_SYMBOL(drm_connector_attach_max_bpc_property); 214447e22ff1SRadhakrishna Sripada 214547e22ff1SRadhakrishna Sripada /** 2146e057b52cSMaxime Ripard * drm_connector_attach_hdr_output_metadata_property - attach "HDR_OUTPUT_METADA" property 2147e057b52cSMaxime Ripard * @connector: connector to attach the property on. 2148e057b52cSMaxime Ripard * 2149e057b52cSMaxime Ripard * This is used to allow the userspace to send HDR Metadata to the 2150e057b52cSMaxime Ripard * driver. 2151e057b52cSMaxime Ripard * 2152e057b52cSMaxime Ripard * Returns: 2153e057b52cSMaxime Ripard * Zero on success, negative errno on failure. 2154e057b52cSMaxime Ripard */ 2155e057b52cSMaxime Ripard int drm_connector_attach_hdr_output_metadata_property(struct drm_connector *connector) 2156e057b52cSMaxime Ripard { 2157e057b52cSMaxime Ripard struct drm_device *dev = connector->dev; 2158e057b52cSMaxime Ripard struct drm_property *prop = dev->mode_config.hdr_output_metadata_property; 2159e057b52cSMaxime Ripard 2160e057b52cSMaxime Ripard drm_object_attach_property(&connector->base, prop, 0); 2161e057b52cSMaxime Ripard 2162e057b52cSMaxime Ripard return 0; 2163e057b52cSMaxime Ripard } 2164e057b52cSMaxime Ripard EXPORT_SYMBOL(drm_connector_attach_hdr_output_metadata_property); 2165e057b52cSMaxime Ripard 2166e057b52cSMaxime Ripard /** 216721f79128SMaxime Ripard * drm_connector_attach_colorspace_property - attach "Colorspace" property 216821f79128SMaxime Ripard * @connector: connector to attach the property on. 216921f79128SMaxime Ripard * 217021f79128SMaxime Ripard * This is used to allow the userspace to signal the output colorspace 217121f79128SMaxime Ripard * to the driver. 217221f79128SMaxime Ripard * 217321f79128SMaxime Ripard * Returns: 217421f79128SMaxime Ripard * Zero on success, negative errno on failure. 217521f79128SMaxime Ripard */ 217621f79128SMaxime Ripard int drm_connector_attach_colorspace_property(struct drm_connector *connector) 217721f79128SMaxime Ripard { 217821f79128SMaxime Ripard struct drm_property *prop = connector->colorspace_property; 217921f79128SMaxime Ripard 218021f79128SMaxime Ripard drm_object_attach_property(&connector->base, prop, DRM_MODE_COLORIMETRY_DEFAULT); 218121f79128SMaxime Ripard 218221f79128SMaxime Ripard return 0; 218321f79128SMaxime Ripard } 218421f79128SMaxime Ripard EXPORT_SYMBOL(drm_connector_attach_colorspace_property); 218521f79128SMaxime Ripard 218621f79128SMaxime Ripard /** 218772921cdfSMaxime Ripard * drm_connector_atomic_hdr_metadata_equal - checks if the hdr metadata changed 218872921cdfSMaxime Ripard * @old_state: old connector state to compare 218972921cdfSMaxime Ripard * @new_state: new connector state to compare 219072921cdfSMaxime Ripard * 219172921cdfSMaxime Ripard * This is used by HDR-enabled drivers to test whether the HDR metadata 219272921cdfSMaxime Ripard * have changed between two different connector state (and thus probably 219372921cdfSMaxime Ripard * requires a full blown mode change). 219472921cdfSMaxime Ripard * 219572921cdfSMaxime Ripard * Returns: 219672921cdfSMaxime Ripard * True if the metadata are equal, False otherwise 219772921cdfSMaxime Ripard */ 219872921cdfSMaxime Ripard bool drm_connector_atomic_hdr_metadata_equal(struct drm_connector_state *old_state, 219972921cdfSMaxime Ripard struct drm_connector_state *new_state) 220072921cdfSMaxime Ripard { 220172921cdfSMaxime Ripard struct drm_property_blob *old_blob = old_state->hdr_output_metadata; 220272921cdfSMaxime Ripard struct drm_property_blob *new_blob = new_state->hdr_output_metadata; 220372921cdfSMaxime Ripard 220472921cdfSMaxime Ripard if (!old_blob || !new_blob) 220572921cdfSMaxime Ripard return old_blob == new_blob; 220672921cdfSMaxime Ripard 220772921cdfSMaxime Ripard if (old_blob->length != new_blob->length) 220872921cdfSMaxime Ripard return false; 220972921cdfSMaxime Ripard 221072921cdfSMaxime Ripard return !memcmp(old_blob->data, new_blob->data, old_blob->length); 221172921cdfSMaxime Ripard } 221272921cdfSMaxime Ripard EXPORT_SYMBOL(drm_connector_atomic_hdr_metadata_equal); 221372921cdfSMaxime Ripard 221472921cdfSMaxime Ripard /** 2215ba1b0f6cSNicholas Kazlauskas * drm_connector_set_vrr_capable_property - sets the variable refresh rate 2216ba1b0f6cSNicholas Kazlauskas * capable property for a connector 2217ba1b0f6cSNicholas Kazlauskas * @connector: drm connector 2218ba1b0f6cSNicholas Kazlauskas * @capable: True if the connector is variable refresh rate capable 2219ba1b0f6cSNicholas Kazlauskas * 2220ba1b0f6cSNicholas Kazlauskas * Should be used by atomic drivers to update the indicated support for 2221ba1b0f6cSNicholas Kazlauskas * variable refresh rate over a connector. 2222ba1b0f6cSNicholas Kazlauskas */ 2223ba1b0f6cSNicholas Kazlauskas void drm_connector_set_vrr_capable_property( 2224ba1b0f6cSNicholas Kazlauskas struct drm_connector *connector, bool capable) 2225ba1b0f6cSNicholas Kazlauskas { 222662929726SManasi Navare if (!connector->vrr_capable_property) 222762929726SManasi Navare return; 222862929726SManasi Navare 2229ba1b0f6cSNicholas Kazlauskas drm_object_property_set_value(&connector->base, 2230ba1b0f6cSNicholas Kazlauskas connector->vrr_capable_property, 2231ba1b0f6cSNicholas Kazlauskas capable); 2232ba1b0f6cSNicholas Kazlauskas } 2233ba1b0f6cSNicholas Kazlauskas EXPORT_SYMBOL(drm_connector_set_vrr_capable_property); 2234ba1b0f6cSNicholas Kazlauskas 2235ba1b0f6cSNicholas Kazlauskas /** 223684e543bcSAntonio Borneo * drm_connector_set_panel_orientation - sets the connector's panel_orientation 223769654c63SDerek Basehore * @connector: connector for which to set the panel-orientation property. 223869654c63SDerek Basehore * @panel_orientation: drm_panel_orientation value to set 22398d70f395SHans de Goede * 224069654c63SDerek Basehore * This function sets the connector's panel_orientation and attaches 224169654c63SDerek Basehore * a "panel orientation" property to the connector. 22428d70f395SHans de Goede * 224369654c63SDerek Basehore * Calling this function on a connector where the panel_orientation has 224469654c63SDerek Basehore * already been set is a no-op (e.g. the orientation has been overridden with 224569654c63SDerek Basehore * a kernel commandline option). 224669654c63SDerek Basehore * 224769654c63SDerek Basehore * It is allowed to call this function with a panel_orientation of 224869654c63SDerek Basehore * DRM_MODE_PANEL_ORIENTATION_UNKNOWN, in which case it is a no-op. 22498d70f395SHans de Goede * 22505e41b01aSHsin-Yi Wang * The function shouldn't be called in panel after drm is registered (i.e. 22515e41b01aSHsin-Yi Wang * drm_dev_register() is called in drm). 22525e41b01aSHsin-Yi Wang * 22538d70f395SHans de Goede * Returns: 22548d70f395SHans de Goede * Zero on success, negative errno on failure. 22558d70f395SHans de Goede */ 225669654c63SDerek Basehore int drm_connector_set_panel_orientation( 225769654c63SDerek Basehore struct drm_connector *connector, 225869654c63SDerek Basehore enum drm_panel_orientation panel_orientation) 22598d70f395SHans de Goede { 22608d70f395SHans de Goede struct drm_device *dev = connector->dev; 22618d70f395SHans de Goede struct drm_display_info *info = &connector->display_info; 22628d70f395SHans de Goede struct drm_property *prop; 22638d70f395SHans de Goede 226469654c63SDerek Basehore /* Already set? */ 226569654c63SDerek Basehore if (info->panel_orientation != DRM_MODE_PANEL_ORIENTATION_UNKNOWN) 22668d70f395SHans de Goede return 0; 22678d70f395SHans de Goede 226869654c63SDerek Basehore /* Don't attach the property if the orientation is unknown */ 226969654c63SDerek Basehore if (panel_orientation == DRM_MODE_PANEL_ORIENTATION_UNKNOWN) 227069654c63SDerek Basehore return 0; 227169654c63SDerek Basehore 227269654c63SDerek Basehore info->panel_orientation = panel_orientation; 227369654c63SDerek Basehore 22748d70f395SHans de Goede prop = dev->mode_config.panel_orientation_property; 22758d70f395SHans de Goede if (!prop) { 22768d70f395SHans de Goede prop = drm_property_create_enum(dev, DRM_MODE_PROP_IMMUTABLE, 22778d70f395SHans de Goede "panel orientation", 22788d70f395SHans de Goede drm_panel_orientation_enum_list, 22798d70f395SHans de Goede ARRAY_SIZE(drm_panel_orientation_enum_list)); 22808d70f395SHans de Goede if (!prop) 22818d70f395SHans de Goede return -ENOMEM; 22828d70f395SHans de Goede 22838d70f395SHans de Goede dev->mode_config.panel_orientation_property = prop; 22848d70f395SHans de Goede } 22858d70f395SHans de Goede 22868d70f395SHans de Goede drm_object_attach_property(&connector->base, prop, 22878d70f395SHans de Goede info->panel_orientation); 22888d70f395SHans de Goede return 0; 22898d70f395SHans de Goede } 229069654c63SDerek Basehore EXPORT_SYMBOL(drm_connector_set_panel_orientation); 229169654c63SDerek Basehore 229269654c63SDerek Basehore /** 2293f85d9e59SRandy Dunlap * drm_connector_set_panel_orientation_with_quirk - set the 2294f85d9e59SRandy Dunlap * connector's panel_orientation after checking for quirks 229569654c63SDerek Basehore * @connector: connector for which to init the panel-orientation property. 229669654c63SDerek Basehore * @panel_orientation: drm_panel_orientation value to set 229769654c63SDerek Basehore * @width: width in pixels of the panel, used for panel quirk detection 229869654c63SDerek Basehore * @height: height in pixels of the panel, used for panel quirk detection 229969654c63SDerek Basehore * 230069654c63SDerek Basehore * Like drm_connector_set_panel_orientation(), but with a check for platform 230169654c63SDerek Basehore * specific (e.g. DMI based) quirks overriding the passed in panel_orientation. 230269654c63SDerek Basehore * 230369654c63SDerek Basehore * Returns: 230469654c63SDerek Basehore * Zero on success, negative errno on failure. 230569654c63SDerek Basehore */ 230669654c63SDerek Basehore int drm_connector_set_panel_orientation_with_quirk( 230769654c63SDerek Basehore struct drm_connector *connector, 230869654c63SDerek Basehore enum drm_panel_orientation panel_orientation, 230969654c63SDerek Basehore int width, int height) 231069654c63SDerek Basehore { 231169654c63SDerek Basehore int orientation_quirk; 231269654c63SDerek Basehore 231369654c63SDerek Basehore orientation_quirk = drm_get_panel_orientation_quirk(width, height); 231469654c63SDerek Basehore if (orientation_quirk != DRM_MODE_PANEL_ORIENTATION_UNKNOWN) 231569654c63SDerek Basehore panel_orientation = orientation_quirk; 231669654c63SDerek Basehore 231769654c63SDerek Basehore return drm_connector_set_panel_orientation(connector, 231869654c63SDerek Basehore panel_orientation); 231969654c63SDerek Basehore } 232069654c63SDerek Basehore EXPORT_SYMBOL(drm_connector_set_panel_orientation_with_quirk); 23218d70f395SHans de Goede 23225e41b01aSHsin-Yi Wang /** 23235e41b01aSHsin-Yi Wang * drm_connector_set_orientation_from_panel - 23245e41b01aSHsin-Yi Wang * set the connector's panel_orientation from panel's callback. 23255e41b01aSHsin-Yi Wang * @connector: connector for which to init the panel-orientation property. 23265e41b01aSHsin-Yi Wang * @panel: panel that can provide orientation information. 23275e41b01aSHsin-Yi Wang * 23285e41b01aSHsin-Yi Wang * Drm drivers should call this function before drm_dev_register(). 23295e41b01aSHsin-Yi Wang * Orientation is obtained from panel's .get_orientation() callback. 23305e41b01aSHsin-Yi Wang * 23315e41b01aSHsin-Yi Wang * Returns: 23325e41b01aSHsin-Yi Wang * Zero on success, negative errno on failure. 23335e41b01aSHsin-Yi Wang */ 23345e41b01aSHsin-Yi Wang int drm_connector_set_orientation_from_panel( 23355e41b01aSHsin-Yi Wang struct drm_connector *connector, 23365e41b01aSHsin-Yi Wang struct drm_panel *panel) 23375e41b01aSHsin-Yi Wang { 23385e41b01aSHsin-Yi Wang enum drm_panel_orientation orientation; 23395e41b01aSHsin-Yi Wang 23405e41b01aSHsin-Yi Wang if (panel && panel->funcs && panel->funcs->get_orientation) 23415e41b01aSHsin-Yi Wang orientation = panel->funcs->get_orientation(panel); 23425e41b01aSHsin-Yi Wang else 23435e41b01aSHsin-Yi Wang orientation = DRM_MODE_PANEL_ORIENTATION_UNKNOWN; 23445e41b01aSHsin-Yi Wang 23455e41b01aSHsin-Yi Wang return drm_connector_set_panel_orientation(connector, orientation); 23465e41b01aSHsin-Yi Wang } 23475e41b01aSHsin-Yi Wang EXPORT_SYMBOL(drm_connector_set_orientation_from_panel); 23485e41b01aSHsin-Yi Wang 2349107fe904SRajat Jain static const struct drm_prop_enum_list privacy_screen_enum[] = { 2350107fe904SRajat Jain { PRIVACY_SCREEN_DISABLED, "Disabled" }, 2351107fe904SRajat Jain { PRIVACY_SCREEN_ENABLED, "Enabled" }, 2352107fe904SRajat Jain { PRIVACY_SCREEN_DISABLED_LOCKED, "Disabled-locked" }, 2353107fe904SRajat Jain { PRIVACY_SCREEN_ENABLED_LOCKED, "Enabled-locked" }, 2354107fe904SRajat Jain }; 2355107fe904SRajat Jain 2356107fe904SRajat Jain /** 2357107fe904SRajat Jain * drm_connector_create_privacy_screen_properties - create the drm connecter's 2358107fe904SRajat Jain * privacy-screen properties. 2359107fe904SRajat Jain * @connector: connector for which to create the privacy-screen properties 2360107fe904SRajat Jain * 2361107fe904SRajat Jain * This function creates the "privacy-screen sw-state" and "privacy-screen 2362107fe904SRajat Jain * hw-state" properties for the connector. They are not attached. 2363107fe904SRajat Jain */ 2364107fe904SRajat Jain void 2365107fe904SRajat Jain drm_connector_create_privacy_screen_properties(struct drm_connector *connector) 2366107fe904SRajat Jain { 2367107fe904SRajat Jain if (connector->privacy_screen_sw_state_property) 2368107fe904SRajat Jain return; 2369107fe904SRajat Jain 2370107fe904SRajat Jain /* Note sw-state only supports the first 2 values of the enum */ 2371107fe904SRajat Jain connector->privacy_screen_sw_state_property = 2372107fe904SRajat Jain drm_property_create_enum(connector->dev, DRM_MODE_PROP_ENUM, 2373107fe904SRajat Jain "privacy-screen sw-state", 2374107fe904SRajat Jain privacy_screen_enum, 2); 2375107fe904SRajat Jain 2376107fe904SRajat Jain connector->privacy_screen_hw_state_property = 2377107fe904SRajat Jain drm_property_create_enum(connector->dev, 2378107fe904SRajat Jain DRM_MODE_PROP_IMMUTABLE | DRM_MODE_PROP_ENUM, 2379107fe904SRajat Jain "privacy-screen hw-state", 2380107fe904SRajat Jain privacy_screen_enum, 2381107fe904SRajat Jain ARRAY_SIZE(privacy_screen_enum)); 2382107fe904SRajat Jain } 2383107fe904SRajat Jain EXPORT_SYMBOL(drm_connector_create_privacy_screen_properties); 2384107fe904SRajat Jain 2385107fe904SRajat Jain /** 2386107fe904SRajat Jain * drm_connector_attach_privacy_screen_properties - attach the drm connecter's 2387107fe904SRajat Jain * privacy-screen properties. 2388107fe904SRajat Jain * @connector: connector on which to attach the privacy-screen properties 2389107fe904SRajat Jain * 2390107fe904SRajat Jain * This function attaches the "privacy-screen sw-state" and "privacy-screen 2391107fe904SRajat Jain * hw-state" properties to the connector. The initial state of both is set 2392107fe904SRajat Jain * to "Disabled". 2393107fe904SRajat Jain */ 2394107fe904SRajat Jain void 2395107fe904SRajat Jain drm_connector_attach_privacy_screen_properties(struct drm_connector *connector) 2396107fe904SRajat Jain { 2397107fe904SRajat Jain if (!connector->privacy_screen_sw_state_property) 2398107fe904SRajat Jain return; 2399107fe904SRajat Jain 2400107fe904SRajat Jain drm_object_attach_property(&connector->base, 2401107fe904SRajat Jain connector->privacy_screen_sw_state_property, 2402107fe904SRajat Jain PRIVACY_SCREEN_DISABLED); 2403107fe904SRajat Jain 2404107fe904SRajat Jain drm_object_attach_property(&connector->base, 2405107fe904SRajat Jain connector->privacy_screen_hw_state_property, 2406107fe904SRajat Jain PRIVACY_SCREEN_DISABLED); 2407107fe904SRajat Jain } 2408107fe904SRajat Jain EXPORT_SYMBOL(drm_connector_attach_privacy_screen_properties); 2409107fe904SRajat Jain 2410334f74eeSHans de Goede static void drm_connector_update_privacy_screen_properties( 2411334f74eeSHans de Goede struct drm_connector *connector, bool set_sw_state) 2412334f74eeSHans de Goede { 2413334f74eeSHans de Goede enum drm_privacy_screen_status sw_state, hw_state; 2414334f74eeSHans de Goede 2415334f74eeSHans de Goede drm_privacy_screen_get_state(connector->privacy_screen, 2416334f74eeSHans de Goede &sw_state, &hw_state); 2417334f74eeSHans de Goede 2418334f74eeSHans de Goede if (set_sw_state) 2419334f74eeSHans de Goede connector->state->privacy_screen_sw_state = sw_state; 2420334f74eeSHans de Goede drm_object_property_set_value(&connector->base, 2421334f74eeSHans de Goede connector->privacy_screen_hw_state_property, hw_state); 2422334f74eeSHans de Goede } 2423334f74eeSHans de Goede 2424334f74eeSHans de Goede static int drm_connector_privacy_screen_notifier( 2425334f74eeSHans de Goede struct notifier_block *nb, unsigned long action, void *data) 2426334f74eeSHans de Goede { 2427334f74eeSHans de Goede struct drm_connector *connector = 2428334f74eeSHans de Goede container_of(nb, struct drm_connector, privacy_screen_notifier); 2429334f74eeSHans de Goede struct drm_device *dev = connector->dev; 2430334f74eeSHans de Goede 2431334f74eeSHans de Goede drm_modeset_lock(&dev->mode_config.connection_mutex, NULL); 2432334f74eeSHans de Goede drm_connector_update_privacy_screen_properties(connector, true); 2433334f74eeSHans de Goede drm_modeset_unlock(&dev->mode_config.connection_mutex); 2434334f74eeSHans de Goede 2435334f74eeSHans de Goede drm_sysfs_connector_status_event(connector, 2436334f74eeSHans de Goede connector->privacy_screen_sw_state_property); 2437334f74eeSHans de Goede drm_sysfs_connector_status_event(connector, 2438334f74eeSHans de Goede connector->privacy_screen_hw_state_property); 2439334f74eeSHans de Goede 2440334f74eeSHans de Goede return NOTIFY_DONE; 2441334f74eeSHans de Goede } 2442334f74eeSHans de Goede 2443334f74eeSHans de Goede /** 2444334f74eeSHans de Goede * drm_connector_attach_privacy_screen_provider - attach a privacy-screen to 2445334f74eeSHans de Goede * the connector 2446334f74eeSHans de Goede * @connector: connector to attach the privacy-screen to 2447334f74eeSHans de Goede * @priv: drm_privacy_screen to attach 2448334f74eeSHans de Goede * 2449334f74eeSHans de Goede * Create and attach the standard privacy-screen properties and register 2450334f74eeSHans de Goede * a generic notifier for generating sysfs-connector-status-events 2451334f74eeSHans de Goede * on external changes to the privacy-screen status. 2452334f74eeSHans de Goede * This function takes ownership of the passed in drm_privacy_screen and will 2453334f74eeSHans de Goede * call drm_privacy_screen_put() on it when the connector is destroyed. 2454334f74eeSHans de Goede */ 2455334f74eeSHans de Goede void drm_connector_attach_privacy_screen_provider( 2456334f74eeSHans de Goede struct drm_connector *connector, struct drm_privacy_screen *priv) 2457334f74eeSHans de Goede { 2458334f74eeSHans de Goede connector->privacy_screen = priv; 2459334f74eeSHans de Goede connector->privacy_screen_notifier.notifier_call = 2460334f74eeSHans de Goede drm_connector_privacy_screen_notifier; 2461334f74eeSHans de Goede 2462334f74eeSHans de Goede drm_connector_create_privacy_screen_properties(connector); 2463334f74eeSHans de Goede drm_connector_update_privacy_screen_properties(connector, true); 2464334f74eeSHans de Goede drm_connector_attach_privacy_screen_properties(connector); 2465334f74eeSHans de Goede } 2466334f74eeSHans de Goede EXPORT_SYMBOL(drm_connector_attach_privacy_screen_provider); 2467334f74eeSHans de Goede 2468334f74eeSHans de Goede /** 2469334f74eeSHans de Goede * drm_connector_update_privacy_screen - update connector's privacy-screen sw-state 2470334f74eeSHans de Goede * @connector_state: connector-state to update the privacy-screen for 2471334f74eeSHans de Goede * 2472334f74eeSHans de Goede * This function calls drm_privacy_screen_set_sw_state() on the connector's 2473334f74eeSHans de Goede * privacy-screen. 2474334f74eeSHans de Goede * 2475334f74eeSHans de Goede * If the connector has no privacy-screen, then this is a no-op. 2476334f74eeSHans de Goede */ 2477334f74eeSHans de Goede void drm_connector_update_privacy_screen(const struct drm_connector_state *connector_state) 2478334f74eeSHans de Goede { 2479334f74eeSHans de Goede struct drm_connector *connector = connector_state->connector; 2480334f74eeSHans de Goede int ret; 2481334f74eeSHans de Goede 2482334f74eeSHans de Goede if (!connector->privacy_screen) 2483334f74eeSHans de Goede return; 2484334f74eeSHans de Goede 2485334f74eeSHans de Goede ret = drm_privacy_screen_set_sw_state(connector->privacy_screen, 2486334f74eeSHans de Goede connector_state->privacy_screen_sw_state); 2487334f74eeSHans de Goede if (ret) { 2488334f74eeSHans de Goede drm_err(connector->dev, "Error updating privacy-screen sw_state\n"); 2489334f74eeSHans de Goede return; 2490334f74eeSHans de Goede } 2491334f74eeSHans de Goede 2492334f74eeSHans de Goede /* The hw_state property value may have changed, update it. */ 2493334f74eeSHans de Goede drm_connector_update_privacy_screen_properties(connector, false); 2494334f74eeSHans de Goede } 2495334f74eeSHans de Goede EXPORT_SYMBOL(drm_connector_update_privacy_screen); 2496334f74eeSHans de Goede 249797e14fbeSDaniel Vetter int drm_connector_set_obj_prop(struct drm_mode_object *obj, 249852217195SDaniel Vetter struct drm_property *property, 249952217195SDaniel Vetter uint64_t value) 250052217195SDaniel Vetter { 250152217195SDaniel Vetter int ret = -EINVAL; 250252217195SDaniel Vetter struct drm_connector *connector = obj_to_connector(obj); 250352217195SDaniel Vetter 250452217195SDaniel Vetter /* Do DPMS ourselves */ 250552217195SDaniel Vetter if (property == connector->dev->mode_config.dpms_property) { 250652217195SDaniel Vetter ret = (*connector->funcs->dpms)(connector, (int)value); 250752217195SDaniel Vetter } else if (connector->funcs->set_property) 250852217195SDaniel Vetter ret = connector->funcs->set_property(connector, property, value); 250952217195SDaniel Vetter 2510144a7999SDaniel Vetter if (!ret) 251152217195SDaniel Vetter drm_object_property_set_value(&connector->base, property, value); 251252217195SDaniel Vetter return ret; 251352217195SDaniel Vetter } 251452217195SDaniel Vetter 251597e14fbeSDaniel Vetter int drm_connector_property_set_ioctl(struct drm_device *dev, 251652217195SDaniel Vetter void *data, struct drm_file *file_priv) 251752217195SDaniel Vetter { 251852217195SDaniel Vetter struct drm_mode_connector_set_property *conn_set_prop = data; 251952217195SDaniel Vetter struct drm_mode_obj_set_property obj_set_prop = { 252052217195SDaniel Vetter .value = conn_set_prop->value, 252152217195SDaniel Vetter .prop_id = conn_set_prop->prop_id, 252252217195SDaniel Vetter .obj_id = conn_set_prop->connector_id, 252352217195SDaniel Vetter .obj_type = DRM_MODE_OBJECT_CONNECTOR 252452217195SDaniel Vetter }; 252552217195SDaniel Vetter 252652217195SDaniel Vetter /* It does all the locking and checking we need */ 252752217195SDaniel Vetter return drm_mode_obj_set_property_ioctl(dev, &obj_set_prop, file_priv); 252852217195SDaniel Vetter } 252952217195SDaniel Vetter 253052217195SDaniel Vetter static struct drm_encoder *drm_connector_get_encoder(struct drm_connector *connector) 253152217195SDaniel Vetter { 253252217195SDaniel Vetter /* For atomic drivers only state objects are synchronously updated and 2533c2ce66daSBeatriz Martins de Carvalho * protected by modeset locks, so check those first. 2534c2ce66daSBeatriz Martins de Carvalho */ 253552217195SDaniel Vetter if (connector->state) 253652217195SDaniel Vetter return connector->state->best_encoder; 253752217195SDaniel Vetter return connector->encoder; 253852217195SDaniel Vetter } 253952217195SDaniel Vetter 2540c3ff0cdbSAnkit Nautiyal static bool 2541c3ff0cdbSAnkit Nautiyal drm_mode_expose_to_userspace(const struct drm_display_mode *mode, 25428445e2c5SVille Syrjälä const struct list_head *modes, 254352217195SDaniel Vetter const struct drm_file *file_priv) 254452217195SDaniel Vetter { 254552217195SDaniel Vetter /* 254652217195SDaniel Vetter * If user-space hasn't configured the driver to expose the stereo 3D 254752217195SDaniel Vetter * modes, don't expose them. 254852217195SDaniel Vetter */ 254952217195SDaniel Vetter if (!file_priv->stereo_allowed && drm_mode_is_stereo(mode)) 255052217195SDaniel Vetter return false; 2551c3ff0cdbSAnkit Nautiyal /* 2552c3ff0cdbSAnkit Nautiyal * If user-space hasn't configured the driver to expose the modes 2553c3ff0cdbSAnkit Nautiyal * with aspect-ratio, don't expose them. However if such a mode 2554c3ff0cdbSAnkit Nautiyal * is unique, let it be exposed, but reset the aspect-ratio flags 2555c3ff0cdbSAnkit Nautiyal * while preparing the list of user-modes. 2556c3ff0cdbSAnkit Nautiyal */ 2557c3ff0cdbSAnkit Nautiyal if (!file_priv->aspect_ratio_allowed) { 25588445e2c5SVille Syrjälä const struct drm_display_mode *mode_itr; 2559c3ff0cdbSAnkit Nautiyal 25608445e2c5SVille Syrjälä list_for_each_entry(mode_itr, modes, head) { 25618445e2c5SVille Syrjälä if (mode_itr->expose_to_userspace && 25628445e2c5SVille Syrjälä drm_mode_match(mode_itr, mode, 2563c3ff0cdbSAnkit Nautiyal DRM_MODE_MATCH_TIMINGS | 2564c3ff0cdbSAnkit Nautiyal DRM_MODE_MATCH_CLOCK | 2565c3ff0cdbSAnkit Nautiyal DRM_MODE_MATCH_FLAGS | 2566c3ff0cdbSAnkit Nautiyal DRM_MODE_MATCH_3D_FLAGS)) 2567c3ff0cdbSAnkit Nautiyal return false; 2568c3ff0cdbSAnkit Nautiyal } 25698445e2c5SVille Syrjälä } 257052217195SDaniel Vetter 257152217195SDaniel Vetter return true; 257252217195SDaniel Vetter } 257352217195SDaniel Vetter 257452217195SDaniel Vetter int drm_mode_getconnector(struct drm_device *dev, void *data, 257552217195SDaniel Vetter struct drm_file *file_priv) 257652217195SDaniel Vetter { 257752217195SDaniel Vetter struct drm_mode_get_connector *out_resp = data; 257852217195SDaniel Vetter struct drm_connector *connector; 257952217195SDaniel Vetter struct drm_encoder *encoder; 258052217195SDaniel Vetter struct drm_display_mode *mode; 258152217195SDaniel Vetter int mode_count = 0; 258252217195SDaniel Vetter int encoders_count = 0; 258352217195SDaniel Vetter int ret = 0; 258452217195SDaniel Vetter int copied = 0; 258552217195SDaniel Vetter struct drm_mode_modeinfo u_mode; 258652217195SDaniel Vetter struct drm_mode_modeinfo __user *mode_ptr; 258752217195SDaniel Vetter uint32_t __user *encoder_ptr; 2588869e76f7SDesmond Cheong Zhi Xi bool is_current_master; 258952217195SDaniel Vetter 259052217195SDaniel Vetter if (!drm_core_check_feature(dev, DRIVER_MODESET)) 259169fdf420SChris Wilson return -EOPNOTSUPP; 259252217195SDaniel Vetter 259352217195SDaniel Vetter memset(&u_mode, 0, sizeof(struct drm_mode_modeinfo)); 259452217195SDaniel Vetter 2595418da172SKeith Packard connector = drm_connector_lookup(dev, file_priv, out_resp->connector_id); 259691eefc05SDaniel Vetter if (!connector) 259791eefc05SDaniel Vetter return -ENOENT; 259852217195SDaniel Vetter 259962afb4adSJosé Roberto de Souza encoders_count = hweight32(connector->possible_encoders); 260091eefc05SDaniel Vetter 260191eefc05SDaniel Vetter if ((out_resp->count_encoders >= encoders_count) && encoders_count) { 260291eefc05SDaniel Vetter copied = 0; 260391eefc05SDaniel Vetter encoder_ptr = (uint32_t __user *)(unsigned long)(out_resp->encoders_ptr); 260483aefbb8SVille Syrjälä 260562afb4adSJosé Roberto de Souza drm_connector_for_each_possible_encoder(connector, encoder) { 260683aefbb8SVille Syrjälä if (put_user(encoder->base.id, encoder_ptr + copied)) { 260791eefc05SDaniel Vetter ret = -EFAULT; 2608e94ac351SDaniel Vetter goto out; 260991eefc05SDaniel Vetter } 261091eefc05SDaniel Vetter copied++; 261191eefc05SDaniel Vetter } 261291eefc05SDaniel Vetter } 261391eefc05SDaniel Vetter out_resp->count_encoders = encoders_count; 261491eefc05SDaniel Vetter 261591eefc05SDaniel Vetter out_resp->connector_id = connector->base.id; 261691eefc05SDaniel Vetter out_resp->connector_type = connector->connector_type; 261791eefc05SDaniel Vetter out_resp->connector_type_id = connector->connector_type_id; 261891eefc05SDaniel Vetter 2619869e76f7SDesmond Cheong Zhi Xi is_current_master = drm_is_current_master(file_priv); 2620869e76f7SDesmond Cheong Zhi Xi 262191eefc05SDaniel Vetter mutex_lock(&dev->mode_config.mutex); 262291eefc05SDaniel Vetter if (out_resp->count_modes == 0) { 2623869e76f7SDesmond Cheong Zhi Xi if (is_current_master) 262491eefc05SDaniel Vetter connector->funcs->fill_modes(connector, 262591eefc05SDaniel Vetter dev->mode_config.max_width, 262691eefc05SDaniel Vetter dev->mode_config.max_height); 26278f86c82aSSimon Ser else 26288f86c82aSSimon 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", 26298f86c82aSSimon Ser connector->base.id, connector->name); 263091eefc05SDaniel Vetter } 263191eefc05SDaniel Vetter 263291eefc05SDaniel Vetter out_resp->mm_width = connector->display_info.width_mm; 263391eefc05SDaniel Vetter out_resp->mm_height = connector->display_info.height_mm; 263491eefc05SDaniel Vetter out_resp->subpixel = connector->display_info.subpixel_order; 263591eefc05SDaniel Vetter out_resp->connection = connector->status; 263691eefc05SDaniel Vetter 263791eefc05SDaniel Vetter /* delayed so we get modes regardless of pre-fill_modes state */ 26388445e2c5SVille Syrjälä list_for_each_entry(mode, &connector->modes, head) { 26398445e2c5SVille Syrjälä WARN_ON(mode->expose_to_userspace); 26408445e2c5SVille Syrjälä 26418445e2c5SVille Syrjälä if (drm_mode_expose_to_userspace(mode, &connector->modes, 2642c3ff0cdbSAnkit Nautiyal file_priv)) { 26438445e2c5SVille Syrjälä mode->expose_to_userspace = true; 264491eefc05SDaniel Vetter mode_count++; 2645c3ff0cdbSAnkit Nautiyal } 26468445e2c5SVille Syrjälä } 264791eefc05SDaniel Vetter 264852217195SDaniel Vetter /* 264952217195SDaniel Vetter * This ioctl is called twice, once to determine how much space is 265052217195SDaniel Vetter * needed, and the 2nd time to fill it. 265152217195SDaniel Vetter */ 265252217195SDaniel Vetter if ((out_resp->count_modes >= mode_count) && mode_count) { 265352217195SDaniel Vetter copied = 0; 265452217195SDaniel Vetter mode_ptr = (struct drm_mode_modeinfo __user *)(unsigned long)out_resp->modes_ptr; 26558445e2c5SVille Syrjälä list_for_each_entry(mode, &connector->modes, head) { 26568445e2c5SVille Syrjälä if (!mode->expose_to_userspace) 26578445e2c5SVille Syrjälä continue; 26588445e2c5SVille Syrjälä 26598445e2c5SVille Syrjälä /* Clear the tag for the next time around */ 26608445e2c5SVille Syrjälä mode->expose_to_userspace = false; 26618445e2c5SVille Syrjälä 266252217195SDaniel Vetter drm_mode_convert_to_umode(&u_mode, mode); 2663c3ff0cdbSAnkit Nautiyal /* 2664c3ff0cdbSAnkit Nautiyal * Reset aspect ratio flags of user-mode, if modes with 2665c3ff0cdbSAnkit Nautiyal * aspect-ratio are not supported. 2666c3ff0cdbSAnkit Nautiyal */ 2667c3ff0cdbSAnkit Nautiyal if (!file_priv->aspect_ratio_allowed) 2668c3ff0cdbSAnkit Nautiyal u_mode.flags &= ~DRM_MODE_FLAG_PIC_AR_MASK; 266952217195SDaniel Vetter if (copy_to_user(mode_ptr + copied, 267052217195SDaniel Vetter &u_mode, sizeof(u_mode))) { 267152217195SDaniel Vetter ret = -EFAULT; 26728445e2c5SVille Syrjälä 26738445e2c5SVille Syrjälä /* 26748445e2c5SVille Syrjälä * Clear the tag for the rest of 26758445e2c5SVille Syrjälä * the modes for the next time around. 26768445e2c5SVille Syrjälä */ 26778445e2c5SVille Syrjälä list_for_each_entry_continue(mode, &connector->modes, head) 26788445e2c5SVille Syrjälä mode->expose_to_userspace = false; 26798445e2c5SVille Syrjälä 2680e94ac351SDaniel Vetter mutex_unlock(&dev->mode_config.mutex); 2681e94ac351SDaniel Vetter 268252217195SDaniel Vetter goto out; 268352217195SDaniel Vetter } 268452217195SDaniel Vetter copied++; 268552217195SDaniel Vetter } 26868445e2c5SVille Syrjälä } else { 26878445e2c5SVille Syrjälä /* Clear the tag for the next time around */ 26888445e2c5SVille Syrjälä list_for_each_entry(mode, &connector->modes, head) 26898445e2c5SVille Syrjälä mode->expose_to_userspace = false; 269052217195SDaniel Vetter } 26918445e2c5SVille Syrjälä 269252217195SDaniel Vetter out_resp->count_modes = mode_count; 269352217195SDaniel Vetter mutex_unlock(&dev->mode_config.mutex); 2694e94ac351SDaniel Vetter 2695e94ac351SDaniel Vetter drm_modeset_lock(&dev->mode_config.connection_mutex, NULL); 2696e94ac351SDaniel Vetter encoder = drm_connector_get_encoder(connector); 2697e94ac351SDaniel Vetter if (encoder) 2698e94ac351SDaniel Vetter out_resp->encoder_id = encoder->base.id; 2699e94ac351SDaniel Vetter else 2700e94ac351SDaniel Vetter out_resp->encoder_id = 0; 2701e94ac351SDaniel Vetter 2702e94ac351SDaniel Vetter /* Only grab properties after probing, to make sure EDID and other 2703c2ce66daSBeatriz Martins de Carvalho * properties reflect the latest status. 2704c2ce66daSBeatriz Martins de Carvalho */ 2705e94ac351SDaniel Vetter ret = drm_mode_object_get_properties(&connector->base, file_priv->atomic, 2706e94ac351SDaniel Vetter (uint32_t __user *)(unsigned long)(out_resp->props_ptr), 2707e94ac351SDaniel Vetter (uint64_t __user *)(unsigned long)(out_resp->prop_values_ptr), 2708e94ac351SDaniel Vetter &out_resp->count_props); 2709e94ac351SDaniel Vetter drm_modeset_unlock(&dev->mode_config.connection_mutex); 2710e94ac351SDaniel Vetter 2711e94ac351SDaniel Vetter out: 2712ad093607SThierry Reding drm_connector_put(connector); 271352217195SDaniel Vetter 271452217195SDaniel Vetter return ret; 271552217195SDaniel Vetter } 271652217195SDaniel Vetter 27173d3f7c1eSHans de Goede /** 27183d3f7c1eSHans de Goede * drm_connector_find_by_fwnode - Find a connector based on the associated fwnode 27193d3f7c1eSHans de Goede * @fwnode: fwnode for which to find the matching drm_connector 27203d3f7c1eSHans de Goede * 27213d3f7c1eSHans de Goede * This functions looks up a drm_connector based on its associated fwnode. When 27223d3f7c1eSHans de Goede * a connector is found a reference to the connector is returned. The caller must 27233d3f7c1eSHans de Goede * call drm_connector_put() to release this reference when it is done with the 27243d3f7c1eSHans de Goede * connector. 27253d3f7c1eSHans de Goede * 27263d3f7c1eSHans de Goede * Returns: A reference to the found connector or an ERR_PTR(). 27273d3f7c1eSHans de Goede */ 27283d3f7c1eSHans de Goede struct drm_connector *drm_connector_find_by_fwnode(struct fwnode_handle *fwnode) 27293d3f7c1eSHans de Goede { 27303d3f7c1eSHans de Goede struct drm_connector *connector, *found = ERR_PTR(-ENODEV); 27313d3f7c1eSHans de Goede 27323d3f7c1eSHans de Goede if (!fwnode) 27333d3f7c1eSHans de Goede return ERR_PTR(-ENODEV); 27343d3f7c1eSHans de Goede 27353d3f7c1eSHans de Goede mutex_lock(&connector_list_lock); 27363d3f7c1eSHans de Goede 27373d3f7c1eSHans de Goede list_for_each_entry(connector, &connector_list, global_connector_list_entry) { 27383d3f7c1eSHans de Goede if (connector->fwnode == fwnode || 27393d3f7c1eSHans de Goede (connector->fwnode && connector->fwnode->secondary == fwnode)) { 27403d3f7c1eSHans de Goede drm_connector_get(connector); 27413d3f7c1eSHans de Goede found = connector; 27423d3f7c1eSHans de Goede break; 27433d3f7c1eSHans de Goede } 27443d3f7c1eSHans de Goede } 27453d3f7c1eSHans de Goede 27463d3f7c1eSHans de Goede mutex_unlock(&connector_list_lock); 27473d3f7c1eSHans de Goede 27483d3f7c1eSHans de Goede return found; 27493d3f7c1eSHans de Goede } 27503d3f7c1eSHans de Goede 275172ad4968SHans de Goede /** 275272ad4968SHans de Goede * drm_connector_oob_hotplug_event - Report out-of-band hotplug event to connector 2753f85d9e59SRandy Dunlap * @connector_fwnode: fwnode_handle to report the event on 275472ad4968SHans de Goede * 275572ad4968SHans de Goede * On some hardware a hotplug event notification may come from outside the display 275672ad4968SHans de Goede * driver / device. An example of this is some USB Type-C setups where the hardware 275772ad4968SHans de Goede * muxes the DisplayPort data and aux-lines but does not pass the altmode HPD 275872ad4968SHans de Goede * status bit to the GPU's DP HPD pin. 275972ad4968SHans de Goede * 276072ad4968SHans de Goede * This function can be used to report these out-of-band events after obtaining 276172ad4968SHans de Goede * a drm_connector reference through calling drm_connector_find_by_fwnode(). 276272ad4968SHans de Goede */ 276372ad4968SHans de Goede void drm_connector_oob_hotplug_event(struct fwnode_handle *connector_fwnode) 276472ad4968SHans de Goede { 276572ad4968SHans de Goede struct drm_connector *connector; 276672ad4968SHans de Goede 276772ad4968SHans de Goede connector = drm_connector_find_by_fwnode(connector_fwnode); 276872ad4968SHans de Goede if (IS_ERR(connector)) 276972ad4968SHans de Goede return; 277072ad4968SHans de Goede 277172ad4968SHans de Goede if (connector->funcs->oob_hotplug_event) 277272ad4968SHans de Goede connector->funcs->oob_hotplug_event(connector); 277372ad4968SHans de Goede 277472ad4968SHans de Goede drm_connector_put(connector); 277572ad4968SHans de Goede } 277672ad4968SHans de Goede EXPORT_SYMBOL(drm_connector_oob_hotplug_event); 277772ad4968SHans de Goede 27789498c19bSDaniel Vetter 27799498c19bSDaniel Vetter /** 27809498c19bSDaniel Vetter * DOC: Tile group 27819498c19bSDaniel Vetter * 27829498c19bSDaniel Vetter * Tile groups are used to represent tiled monitors with a unique integer 27839498c19bSDaniel Vetter * identifier. Tiled monitors using DisplayID v1.3 have a unique 8-byte handle, 27849498c19bSDaniel Vetter * we store this in a tile group, so we have a common identifier for all tiles 27859498c19bSDaniel Vetter * in a monitor group. The property is called "TILE". Drivers can manage tile 27869498c19bSDaniel Vetter * groups using drm_mode_create_tile_group(), drm_mode_put_tile_group() and 27879498c19bSDaniel Vetter * drm_mode_get_tile_group(). But this is only needed for internal panels where 27889498c19bSDaniel Vetter * the tile group information is exposed through a non-standard way. 27899498c19bSDaniel Vetter */ 27909498c19bSDaniel Vetter 27919498c19bSDaniel Vetter static void drm_tile_group_free(struct kref *kref) 27929498c19bSDaniel Vetter { 27939498c19bSDaniel Vetter struct drm_tile_group *tg = container_of(kref, struct drm_tile_group, refcount); 27949498c19bSDaniel Vetter struct drm_device *dev = tg->dev; 2795948de842SSuraj Upadhyay 27969498c19bSDaniel Vetter mutex_lock(&dev->mode_config.idr_mutex); 27979498c19bSDaniel Vetter idr_remove(&dev->mode_config.tile_idr, tg->id); 27989498c19bSDaniel Vetter mutex_unlock(&dev->mode_config.idr_mutex); 27999498c19bSDaniel Vetter kfree(tg); 28009498c19bSDaniel Vetter } 28019498c19bSDaniel Vetter 28029498c19bSDaniel Vetter /** 28039498c19bSDaniel Vetter * drm_mode_put_tile_group - drop a reference to a tile group. 28049498c19bSDaniel Vetter * @dev: DRM device 28059498c19bSDaniel Vetter * @tg: tile group to drop reference to. 28069498c19bSDaniel Vetter * 28079498c19bSDaniel Vetter * drop reference to tile group and free if 0. 28089498c19bSDaniel Vetter */ 28099498c19bSDaniel Vetter void drm_mode_put_tile_group(struct drm_device *dev, 28109498c19bSDaniel Vetter struct drm_tile_group *tg) 28119498c19bSDaniel Vetter { 28129498c19bSDaniel Vetter kref_put(&tg->refcount, drm_tile_group_free); 28139498c19bSDaniel Vetter } 28149498c19bSDaniel Vetter EXPORT_SYMBOL(drm_mode_put_tile_group); 28159498c19bSDaniel Vetter 28169498c19bSDaniel Vetter /** 28179498c19bSDaniel Vetter * drm_mode_get_tile_group - get a reference to an existing tile group 28189498c19bSDaniel Vetter * @dev: DRM device 28199498c19bSDaniel Vetter * @topology: 8-bytes unique per monitor. 28209498c19bSDaniel Vetter * 28219498c19bSDaniel Vetter * Use the unique bytes to get a reference to an existing tile group. 28229498c19bSDaniel Vetter * 28239498c19bSDaniel Vetter * RETURNS: 28249498c19bSDaniel Vetter * tile group or NULL if not found. 28259498c19bSDaniel Vetter */ 28269498c19bSDaniel Vetter struct drm_tile_group *drm_mode_get_tile_group(struct drm_device *dev, 2827267ea759SVille Syrjälä const char topology[8]) 28289498c19bSDaniel Vetter { 28299498c19bSDaniel Vetter struct drm_tile_group *tg; 28309498c19bSDaniel Vetter int id; 2831948de842SSuraj Upadhyay 28329498c19bSDaniel Vetter mutex_lock(&dev->mode_config.idr_mutex); 28339498c19bSDaniel Vetter idr_for_each_entry(&dev->mode_config.tile_idr, tg, id) { 28349498c19bSDaniel Vetter if (!memcmp(tg->group_data, topology, 8)) { 28359498c19bSDaniel Vetter if (!kref_get_unless_zero(&tg->refcount)) 28369498c19bSDaniel Vetter tg = NULL; 28379498c19bSDaniel Vetter mutex_unlock(&dev->mode_config.idr_mutex); 28389498c19bSDaniel Vetter return tg; 28399498c19bSDaniel Vetter } 28409498c19bSDaniel Vetter } 28419498c19bSDaniel Vetter mutex_unlock(&dev->mode_config.idr_mutex); 28429498c19bSDaniel Vetter return NULL; 28439498c19bSDaniel Vetter } 28449498c19bSDaniel Vetter EXPORT_SYMBOL(drm_mode_get_tile_group); 28459498c19bSDaniel Vetter 28469498c19bSDaniel Vetter /** 28479498c19bSDaniel Vetter * drm_mode_create_tile_group - create a tile group from a displayid description 28489498c19bSDaniel Vetter * @dev: DRM device 28499498c19bSDaniel Vetter * @topology: 8-bytes unique per monitor. 28509498c19bSDaniel Vetter * 28519498c19bSDaniel Vetter * Create a tile group for the unique monitor, and get a unique 28529498c19bSDaniel Vetter * identifier for the tile group. 28539498c19bSDaniel Vetter * 28549498c19bSDaniel Vetter * RETURNS: 2855705c8160SDan Carpenter * new tile group or NULL. 28569498c19bSDaniel Vetter */ 28579498c19bSDaniel Vetter struct drm_tile_group *drm_mode_create_tile_group(struct drm_device *dev, 2858267ea759SVille Syrjälä const char topology[8]) 28599498c19bSDaniel Vetter { 28609498c19bSDaniel Vetter struct drm_tile_group *tg; 28619498c19bSDaniel Vetter int ret; 28629498c19bSDaniel Vetter 28639498c19bSDaniel Vetter tg = kzalloc(sizeof(*tg), GFP_KERNEL); 28649498c19bSDaniel Vetter if (!tg) 2865705c8160SDan Carpenter return NULL; 28669498c19bSDaniel Vetter 28679498c19bSDaniel Vetter kref_init(&tg->refcount); 28689498c19bSDaniel Vetter memcpy(tg->group_data, topology, 8); 28699498c19bSDaniel Vetter tg->dev = dev; 28709498c19bSDaniel Vetter 28719498c19bSDaniel Vetter mutex_lock(&dev->mode_config.idr_mutex); 28729498c19bSDaniel Vetter ret = idr_alloc(&dev->mode_config.tile_idr, tg, 1, 0, GFP_KERNEL); 28739498c19bSDaniel Vetter if (ret >= 0) { 28749498c19bSDaniel Vetter tg->id = ret; 28759498c19bSDaniel Vetter } else { 28769498c19bSDaniel Vetter kfree(tg); 2877705c8160SDan Carpenter tg = NULL; 28789498c19bSDaniel Vetter } 28799498c19bSDaniel Vetter 28809498c19bSDaniel Vetter mutex_unlock(&dev->mode_config.idr_mutex); 28819498c19bSDaniel Vetter return tg; 28829498c19bSDaniel Vetter } 28839498c19bSDaniel Vetter EXPORT_SYMBOL(drm_mode_create_tile_group); 2884