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 2352217195SDaniel Vetter #include <drm/drm_connector.h> 2452217195SDaniel Vetter #include <drm/drm_edid.h> 259338203cSLaurent Pinchart #include <drm/drm_encoder.h> 268d70f395SHans de Goede #include <drm/drm_utils.h> 2799f45e32SDaniel Vetter #include <drm/drm_print.h> 2899f45e32SDaniel Vetter #include <drm/drm_drv.h> 2999f45e32SDaniel Vetter #include <drm/drm_file.h> 3099f45e32SDaniel Vetter 3199f45e32SDaniel Vetter #include <linux/uaccess.h> 3252217195SDaniel Vetter 3352217195SDaniel Vetter #include "drm_crtc_internal.h" 3452217195SDaniel Vetter #include "drm_internal.h" 3552217195SDaniel Vetter 36ae2a6da8SDaniel Vetter /** 37ae2a6da8SDaniel Vetter * DOC: overview 38ae2a6da8SDaniel Vetter * 39ae2a6da8SDaniel Vetter * In DRM connectors are the general abstraction for display sinks, and include 40ae2a6da8SDaniel Vetter * als fixed panels or anything else that can display pixels in some form. As 41ae2a6da8SDaniel Vetter * opposed to all other KMS objects representing hardware (like CRTC, encoder or 42ae2a6da8SDaniel Vetter * plane abstractions) connectors can be hotplugged and unplugged at runtime. 43ad093607SThierry Reding * Hence they are reference-counted using drm_connector_get() and 44ad093607SThierry Reding * drm_connector_put(). 45ae2a6da8SDaniel Vetter * 46d574528aSDaniel Vetter * KMS driver must create, initialize, register and attach at a &struct 47d574528aSDaniel Vetter * drm_connector for each such sink. The instance is created as other KMS 48aec97460SDaniel Vetter * objects and initialized by setting the following fields. The connector is 49aec97460SDaniel Vetter * initialized with a call to drm_connector_init() with a pointer to the 50aec97460SDaniel Vetter * &struct drm_connector_funcs and a connector type, and then exposed to 51aec97460SDaniel Vetter * userspace with a call to drm_connector_register(). 52ae2a6da8SDaniel Vetter * 53ae2a6da8SDaniel Vetter * Connectors must be attached to an encoder to be used. For devices that map 54ae2a6da8SDaniel Vetter * connectors to encoders 1:1, the connector should be attached at 55cde4c44dSDaniel Vetter * initialization time with a call to drm_connector_attach_encoder(). The 56d574528aSDaniel Vetter * driver must also set the &drm_connector.encoder field to point to the 57ae2a6da8SDaniel Vetter * attached encoder. 58ae2a6da8SDaniel Vetter * 59ae2a6da8SDaniel Vetter * For connectors which are not fixed (like built-in panels) the driver needs to 60ae2a6da8SDaniel Vetter * support hotplug notifications. The simplest way to do that is by using the 61ae2a6da8SDaniel Vetter * probe helpers, see drm_kms_helper_poll_init() for connectors which don't have 62ae2a6da8SDaniel Vetter * hardware support for hotplug interrupts. Connectors with hardware hotplug 63ae2a6da8SDaniel Vetter * support can instead use e.g. drm_helper_hpd_irq_event(). 64ae2a6da8SDaniel Vetter */ 65ae2a6da8SDaniel Vetter 6652217195SDaniel Vetter struct drm_conn_prop_enum_list { 6752217195SDaniel Vetter int type; 6852217195SDaniel Vetter const char *name; 6952217195SDaniel Vetter struct ida ida; 7052217195SDaniel Vetter }; 7152217195SDaniel Vetter 7252217195SDaniel Vetter /* 7352217195SDaniel Vetter * Connector and encoder types. 7452217195SDaniel Vetter */ 7552217195SDaniel Vetter static struct drm_conn_prop_enum_list drm_connector_enum_list[] = { 7652217195SDaniel Vetter { DRM_MODE_CONNECTOR_Unknown, "Unknown" }, 7752217195SDaniel Vetter { DRM_MODE_CONNECTOR_VGA, "VGA" }, 7852217195SDaniel Vetter { DRM_MODE_CONNECTOR_DVII, "DVI-I" }, 7952217195SDaniel Vetter { DRM_MODE_CONNECTOR_DVID, "DVI-D" }, 8052217195SDaniel Vetter { DRM_MODE_CONNECTOR_DVIA, "DVI-A" }, 8152217195SDaniel Vetter { DRM_MODE_CONNECTOR_Composite, "Composite" }, 8252217195SDaniel Vetter { DRM_MODE_CONNECTOR_SVIDEO, "SVIDEO" }, 8352217195SDaniel Vetter { DRM_MODE_CONNECTOR_LVDS, "LVDS" }, 8452217195SDaniel Vetter { DRM_MODE_CONNECTOR_Component, "Component" }, 8552217195SDaniel Vetter { DRM_MODE_CONNECTOR_9PinDIN, "DIN" }, 8652217195SDaniel Vetter { DRM_MODE_CONNECTOR_DisplayPort, "DP" }, 8752217195SDaniel Vetter { DRM_MODE_CONNECTOR_HDMIA, "HDMI-A" }, 8852217195SDaniel Vetter { DRM_MODE_CONNECTOR_HDMIB, "HDMI-B" }, 8952217195SDaniel Vetter { DRM_MODE_CONNECTOR_TV, "TV" }, 9052217195SDaniel Vetter { DRM_MODE_CONNECTOR_eDP, "eDP" }, 9152217195SDaniel Vetter { DRM_MODE_CONNECTOR_VIRTUAL, "Virtual" }, 9252217195SDaniel Vetter { DRM_MODE_CONNECTOR_DSI, "DSI" }, 9352217195SDaniel Vetter { DRM_MODE_CONNECTOR_DPI, "DPI" }, 94935774cdSBrian Starkey { DRM_MODE_CONNECTOR_WRITEBACK, "Writeback" }, 9552217195SDaniel Vetter }; 9652217195SDaniel Vetter 9752217195SDaniel Vetter void drm_connector_ida_init(void) 9852217195SDaniel Vetter { 9952217195SDaniel Vetter int i; 10052217195SDaniel Vetter 10152217195SDaniel Vetter for (i = 0; i < ARRAY_SIZE(drm_connector_enum_list); i++) 10252217195SDaniel Vetter ida_init(&drm_connector_enum_list[i].ida); 10352217195SDaniel Vetter } 10452217195SDaniel Vetter 10552217195SDaniel Vetter void drm_connector_ida_destroy(void) 10652217195SDaniel Vetter { 10752217195SDaniel Vetter int i; 10852217195SDaniel Vetter 10952217195SDaniel Vetter for (i = 0; i < ARRAY_SIZE(drm_connector_enum_list); i++) 11052217195SDaniel Vetter ida_destroy(&drm_connector_enum_list[i].ida); 11152217195SDaniel Vetter } 11252217195SDaniel Vetter 11352217195SDaniel Vetter /** 11452217195SDaniel Vetter * drm_connector_get_cmdline_mode - reads the user's cmdline mode 11552217195SDaniel Vetter * @connector: connector to quwery 11652217195SDaniel Vetter * 117ae2a6da8SDaniel Vetter * The kernel supports per-connector configuration of its consoles through 11852217195SDaniel Vetter * use of the video= parameter. This function parses that option and 11952217195SDaniel Vetter * extracts the user's specified mode (or enable/disable status) for a 12052217195SDaniel Vetter * particular connector. This is typically only used during the early fbdev 12152217195SDaniel Vetter * setup. 12252217195SDaniel Vetter */ 12352217195SDaniel Vetter static void drm_connector_get_cmdline_mode(struct drm_connector *connector) 12452217195SDaniel Vetter { 12552217195SDaniel Vetter struct drm_cmdline_mode *mode = &connector->cmdline_mode; 12652217195SDaniel Vetter char *option = NULL; 12752217195SDaniel Vetter 12852217195SDaniel Vetter if (fb_get_options(connector->name, &option)) 12952217195SDaniel Vetter return; 13052217195SDaniel Vetter 13152217195SDaniel Vetter if (!drm_mode_parse_command_line_for_connector(option, 13252217195SDaniel Vetter connector, 13352217195SDaniel Vetter mode)) 13452217195SDaniel Vetter return; 13552217195SDaniel Vetter 13652217195SDaniel Vetter if (mode->force) { 1376140cf20SJani Nikula DRM_INFO("forcing %s connector %s\n", connector->name, 1386140cf20SJani Nikula drm_get_connector_force_name(mode->force)); 13952217195SDaniel Vetter connector->force = mode->force; 14052217195SDaniel Vetter } 14152217195SDaniel Vetter 14252217195SDaniel Vetter DRM_DEBUG_KMS("cmdline mode for connector %s %dx%d@%dHz%s%s%s\n", 14352217195SDaniel Vetter connector->name, 14452217195SDaniel Vetter mode->xres, mode->yres, 14552217195SDaniel Vetter mode->refresh_specified ? mode->refresh : 60, 14652217195SDaniel Vetter mode->rb ? " reduced blanking" : "", 14752217195SDaniel Vetter mode->margins ? " with margins" : "", 14852217195SDaniel Vetter mode->interlace ? " interlaced" : ""); 14952217195SDaniel Vetter } 15052217195SDaniel Vetter 15152217195SDaniel Vetter static void drm_connector_free(struct kref *kref) 15252217195SDaniel Vetter { 15352217195SDaniel Vetter struct drm_connector *connector = 15452217195SDaniel Vetter container_of(kref, struct drm_connector, base.refcount); 15552217195SDaniel Vetter struct drm_device *dev = connector->dev; 15652217195SDaniel Vetter 15752217195SDaniel Vetter drm_mode_object_unregister(dev, &connector->base); 15852217195SDaniel Vetter connector->funcs->destroy(connector); 15952217195SDaniel Vetter } 16052217195SDaniel Vetter 161ea497bb9SDaniel Vetter void drm_connector_free_work_fn(struct work_struct *work) 162a703c550SDaniel Vetter { 163ea497bb9SDaniel Vetter struct drm_connector *connector, *n; 164ea497bb9SDaniel Vetter struct drm_device *dev = 165ea497bb9SDaniel Vetter container_of(work, struct drm_device, mode_config.connector_free_work); 166ea497bb9SDaniel Vetter struct drm_mode_config *config = &dev->mode_config; 167ea497bb9SDaniel Vetter unsigned long flags; 168ea497bb9SDaniel Vetter struct llist_node *freed; 169a703c550SDaniel Vetter 170ea497bb9SDaniel Vetter spin_lock_irqsave(&config->connector_list_lock, flags); 171ea497bb9SDaniel Vetter freed = llist_del_all(&config->connector_free_list); 172ea497bb9SDaniel Vetter spin_unlock_irqrestore(&config->connector_list_lock, flags); 173ea497bb9SDaniel Vetter 174ea497bb9SDaniel Vetter llist_for_each_entry_safe(connector, n, freed, free_node) { 175a703c550SDaniel Vetter drm_mode_object_unregister(dev, &connector->base); 176a703c550SDaniel Vetter connector->funcs->destroy(connector); 177a703c550SDaniel Vetter } 178ea497bb9SDaniel Vetter } 179a703c550SDaniel Vetter 18052217195SDaniel Vetter /** 18152217195SDaniel Vetter * drm_connector_init - Init a preallocated connector 18252217195SDaniel Vetter * @dev: DRM device 18352217195SDaniel Vetter * @connector: the connector to init 18452217195SDaniel Vetter * @funcs: callbacks for this connector 18552217195SDaniel Vetter * @connector_type: user visible type of the connector 18652217195SDaniel Vetter * 18752217195SDaniel Vetter * Initialises a preallocated connector. Connectors should be 18852217195SDaniel Vetter * subclassed as part of driver connector objects. 18952217195SDaniel Vetter * 19052217195SDaniel Vetter * Returns: 19152217195SDaniel Vetter * Zero on success, error code on failure. 19252217195SDaniel Vetter */ 19352217195SDaniel Vetter int drm_connector_init(struct drm_device *dev, 19452217195SDaniel Vetter struct drm_connector *connector, 19552217195SDaniel Vetter const struct drm_connector_funcs *funcs, 19652217195SDaniel Vetter int connector_type) 19752217195SDaniel Vetter { 19852217195SDaniel Vetter struct drm_mode_config *config = &dev->mode_config; 19952217195SDaniel Vetter int ret; 20052217195SDaniel Vetter struct ida *connector_ida = 20152217195SDaniel Vetter &drm_connector_enum_list[connector_type].ida; 20252217195SDaniel Vetter 203ba1f665fSHaneen Mohammed WARN_ON(drm_drv_uses_atomic_modeset(dev) && 204ba1f665fSHaneen Mohammed (!funcs->atomic_destroy_state || 205ba1f665fSHaneen Mohammed !funcs->atomic_duplicate_state)); 206ba1f665fSHaneen Mohammed 2072135ea7aSThierry Reding ret = __drm_mode_object_add(dev, &connector->base, 20852217195SDaniel Vetter DRM_MODE_OBJECT_CONNECTOR, 20952217195SDaniel Vetter false, drm_connector_free); 21052217195SDaniel Vetter if (ret) 211613051daSDaniel Vetter return ret; 21252217195SDaniel Vetter 21352217195SDaniel Vetter connector->base.properties = &connector->properties; 21452217195SDaniel Vetter connector->dev = dev; 21552217195SDaniel Vetter connector->funcs = funcs; 21652217195SDaniel Vetter 2172a8d3eacSVille Syrjälä /* connector index is used with 32bit bitmasks */ 2182a8d3eacSVille Syrjälä ret = ida_simple_get(&config->connector_ida, 0, 32, GFP_KERNEL); 2192a8d3eacSVille Syrjälä if (ret < 0) { 2202a8d3eacSVille Syrjälä DRM_DEBUG_KMS("Failed to allocate %s connector index: %d\n", 2212a8d3eacSVille Syrjälä drm_connector_enum_list[connector_type].name, 2222a8d3eacSVille Syrjälä ret); 22352217195SDaniel Vetter goto out_put; 2242a8d3eacSVille Syrjälä } 22552217195SDaniel Vetter connector->index = ret; 22652217195SDaniel Vetter ret = 0; 22752217195SDaniel Vetter 22852217195SDaniel Vetter connector->connector_type = connector_type; 22952217195SDaniel Vetter connector->connector_type_id = 23052217195SDaniel Vetter ida_simple_get(connector_ida, 1, 0, GFP_KERNEL); 23152217195SDaniel Vetter if (connector->connector_type_id < 0) { 23252217195SDaniel Vetter ret = connector->connector_type_id; 23352217195SDaniel Vetter goto out_put_id; 23452217195SDaniel Vetter } 23552217195SDaniel Vetter connector->name = 23652217195SDaniel Vetter kasprintf(GFP_KERNEL, "%s-%d", 23752217195SDaniel Vetter drm_connector_enum_list[connector_type].name, 23852217195SDaniel Vetter connector->connector_type_id); 23952217195SDaniel Vetter if (!connector->name) { 24052217195SDaniel Vetter ret = -ENOMEM; 24152217195SDaniel Vetter goto out_put_type_id; 24252217195SDaniel Vetter } 24352217195SDaniel Vetter 24452217195SDaniel Vetter INIT_LIST_HEAD(&connector->probed_modes); 24552217195SDaniel Vetter INIT_LIST_HEAD(&connector->modes); 246e73ab00eSDaniel Vetter mutex_init(&connector->mutex); 24752217195SDaniel Vetter connector->edid_blob_ptr = NULL; 24852217195SDaniel Vetter connector->status = connector_status_unknown; 2498d70f395SHans de Goede connector->display_info.panel_orientation = 2508d70f395SHans de Goede DRM_MODE_PANEL_ORIENTATION_UNKNOWN; 25152217195SDaniel Vetter 25252217195SDaniel Vetter drm_connector_get_cmdline_mode(connector); 25352217195SDaniel Vetter 25452217195SDaniel Vetter /* We should add connectors at the end to avoid upsetting the connector 25552217195SDaniel Vetter * index too much. */ 256613051daSDaniel Vetter spin_lock_irq(&config->connector_list_lock); 25752217195SDaniel Vetter list_add_tail(&connector->head, &config->connector_list); 25852217195SDaniel Vetter config->num_connector++; 259613051daSDaniel Vetter spin_unlock_irq(&config->connector_list_lock); 26052217195SDaniel Vetter 261935774cdSBrian Starkey if (connector_type != DRM_MODE_CONNECTOR_VIRTUAL && 262935774cdSBrian Starkey connector_type != DRM_MODE_CONNECTOR_WRITEBACK) 2636b7e2d5cSGerd Hoffmann drm_connector_attach_edid_property(connector); 26452217195SDaniel Vetter 26552217195SDaniel Vetter drm_object_attach_property(&connector->base, 26652217195SDaniel Vetter config->dpms_property, 0); 26752217195SDaniel Vetter 26840ee6fbeSManasi Navare drm_object_attach_property(&connector->base, 26940ee6fbeSManasi Navare config->link_status_property, 27040ee6fbeSManasi Navare 0); 27140ee6fbeSManasi Navare 27266660d4cSDave Airlie drm_object_attach_property(&connector->base, 27366660d4cSDave Airlie config->non_desktop_property, 27466660d4cSDave Airlie 0); 27566660d4cSDave Airlie 27652217195SDaniel Vetter if (drm_core_check_feature(dev, DRIVER_ATOMIC)) { 27752217195SDaniel Vetter drm_object_attach_property(&connector->base, config->prop_crtc_id, 0); 27852217195SDaniel Vetter } 27952217195SDaniel Vetter 28052217195SDaniel Vetter connector->debugfs_entry = NULL; 28152217195SDaniel Vetter out_put_type_id: 28252217195SDaniel Vetter if (ret) 283587680c1SChristophe JAILLET ida_simple_remove(connector_ida, connector->connector_type_id); 28452217195SDaniel Vetter out_put_id: 28552217195SDaniel Vetter if (ret) 286587680c1SChristophe JAILLET ida_simple_remove(&config->connector_ida, connector->index); 28752217195SDaniel Vetter out_put: 28852217195SDaniel Vetter if (ret) 28952217195SDaniel Vetter drm_mode_object_unregister(dev, &connector->base); 29052217195SDaniel Vetter 29152217195SDaniel Vetter return ret; 29252217195SDaniel Vetter } 29352217195SDaniel Vetter EXPORT_SYMBOL(drm_connector_init); 29452217195SDaniel Vetter 29552217195SDaniel Vetter /** 2966b7e2d5cSGerd Hoffmann * drm_connector_attach_edid_property - attach edid property. 2976b7e2d5cSGerd Hoffmann * @connector: the connector 2986b7e2d5cSGerd Hoffmann * 2996b7e2d5cSGerd Hoffmann * Some connector types like DRM_MODE_CONNECTOR_VIRTUAL do not get a 3006b7e2d5cSGerd Hoffmann * edid property attached by default. This function can be used to 3016b7e2d5cSGerd Hoffmann * explicitly enable the edid property in these cases. 3026b7e2d5cSGerd Hoffmann */ 3036b7e2d5cSGerd Hoffmann void drm_connector_attach_edid_property(struct drm_connector *connector) 3046b7e2d5cSGerd Hoffmann { 3056b7e2d5cSGerd Hoffmann struct drm_mode_config *config = &connector->dev->mode_config; 3066b7e2d5cSGerd Hoffmann 3076b7e2d5cSGerd Hoffmann drm_object_attach_property(&connector->base, 3086b7e2d5cSGerd Hoffmann config->edid_property, 3096b7e2d5cSGerd Hoffmann 0); 3106b7e2d5cSGerd Hoffmann } 3116b7e2d5cSGerd Hoffmann EXPORT_SYMBOL(drm_connector_attach_edid_property); 3126b7e2d5cSGerd Hoffmann 3136b7e2d5cSGerd Hoffmann /** 314cde4c44dSDaniel Vetter * drm_connector_attach_encoder - attach a connector to an encoder 31552217195SDaniel Vetter * @connector: connector to attach 31652217195SDaniel Vetter * @encoder: encoder to attach @connector to 31752217195SDaniel Vetter * 31852217195SDaniel Vetter * This function links up a connector to an encoder. Note that the routing 31952217195SDaniel Vetter * restrictions between encoders and crtcs are exposed to userspace through the 32052217195SDaniel Vetter * possible_clones and possible_crtcs bitmasks. 32152217195SDaniel Vetter * 32252217195SDaniel Vetter * Returns: 32352217195SDaniel Vetter * Zero on success, negative errno on failure. 32452217195SDaniel Vetter */ 325cde4c44dSDaniel Vetter int drm_connector_attach_encoder(struct drm_connector *connector, 32652217195SDaniel Vetter struct drm_encoder *encoder) 32752217195SDaniel Vetter { 32852217195SDaniel Vetter int i; 32952217195SDaniel Vetter 33052217195SDaniel Vetter /* 33152217195SDaniel Vetter * In the past, drivers have attempted to model the static association 33252217195SDaniel Vetter * of connector to encoder in simple connector/encoder devices using a 33352217195SDaniel Vetter * direct assignment of connector->encoder = encoder. This connection 33452217195SDaniel Vetter * is a logical one and the responsibility of the core, so drivers are 33552217195SDaniel Vetter * expected not to mess with this. 33652217195SDaniel Vetter * 33752217195SDaniel Vetter * Note that the error return should've been enough here, but a large 33852217195SDaniel Vetter * majority of drivers ignores the return value, so add in a big WARN 33952217195SDaniel Vetter * to get people's attention. 34052217195SDaniel Vetter */ 34152217195SDaniel Vetter if (WARN_ON(connector->encoder)) 34252217195SDaniel Vetter return -EINVAL; 34352217195SDaniel Vetter 34483aefbb8SVille Syrjälä for (i = 0; i < ARRAY_SIZE(connector->encoder_ids); i++) { 34552217195SDaniel Vetter if (connector->encoder_ids[i] == 0) { 34652217195SDaniel Vetter connector->encoder_ids[i] = encoder->base.id; 34752217195SDaniel Vetter return 0; 34852217195SDaniel Vetter } 34952217195SDaniel Vetter } 35052217195SDaniel Vetter return -ENOMEM; 35152217195SDaniel Vetter } 352cde4c44dSDaniel Vetter EXPORT_SYMBOL(drm_connector_attach_encoder); 35352217195SDaniel Vetter 35438cb8d96SVille Syrjälä /** 35538cb8d96SVille Syrjälä * drm_connector_has_possible_encoder - check if the connector and encoder are assosicated with each other 35638cb8d96SVille Syrjälä * @connector: the connector 35738cb8d96SVille Syrjälä * @encoder: the encoder 35838cb8d96SVille Syrjälä * 35938cb8d96SVille Syrjälä * Returns: 36038cb8d96SVille Syrjälä * True if @encoder is one of the possible encoders for @connector. 36138cb8d96SVille Syrjälä */ 36238cb8d96SVille Syrjälä bool drm_connector_has_possible_encoder(struct drm_connector *connector, 36338cb8d96SVille Syrjälä struct drm_encoder *encoder) 36438cb8d96SVille Syrjälä { 36538cb8d96SVille Syrjälä struct drm_encoder *enc; 36638cb8d96SVille Syrjälä int i; 36738cb8d96SVille Syrjälä 36838cb8d96SVille Syrjälä drm_connector_for_each_possible_encoder(connector, enc, i) { 36938cb8d96SVille Syrjälä if (enc == encoder) 37038cb8d96SVille Syrjälä return true; 37138cb8d96SVille Syrjälä } 37238cb8d96SVille Syrjälä 37338cb8d96SVille Syrjälä return false; 37438cb8d96SVille Syrjälä } 37538cb8d96SVille Syrjälä EXPORT_SYMBOL(drm_connector_has_possible_encoder); 37638cb8d96SVille Syrjälä 37752217195SDaniel Vetter static void drm_mode_remove(struct drm_connector *connector, 37852217195SDaniel Vetter struct drm_display_mode *mode) 37952217195SDaniel Vetter { 38052217195SDaniel Vetter list_del(&mode->head); 38152217195SDaniel Vetter drm_mode_destroy(connector->dev, mode); 38252217195SDaniel Vetter } 38352217195SDaniel Vetter 38452217195SDaniel Vetter /** 38552217195SDaniel Vetter * drm_connector_cleanup - cleans up an initialised connector 38652217195SDaniel Vetter * @connector: connector to cleanup 38752217195SDaniel Vetter * 38852217195SDaniel Vetter * Cleans up the connector but doesn't free the object. 38952217195SDaniel Vetter */ 39052217195SDaniel Vetter void drm_connector_cleanup(struct drm_connector *connector) 39152217195SDaniel Vetter { 39252217195SDaniel Vetter struct drm_device *dev = connector->dev; 39352217195SDaniel Vetter struct drm_display_mode *mode, *t; 39452217195SDaniel Vetter 39552217195SDaniel Vetter /* The connector should have been removed from userspace long before 39652217195SDaniel Vetter * it is finally destroyed. 39752217195SDaniel Vetter */ 39839b50c60SLyude Paul if (WARN_ON(connector->registration_state == 39939b50c60SLyude Paul DRM_CONNECTOR_REGISTERED)) 40052217195SDaniel Vetter drm_connector_unregister(connector); 40152217195SDaniel Vetter 40252217195SDaniel Vetter if (connector->tile_group) { 40352217195SDaniel Vetter drm_mode_put_tile_group(dev, connector->tile_group); 40452217195SDaniel Vetter connector->tile_group = NULL; 40552217195SDaniel Vetter } 40652217195SDaniel Vetter 40752217195SDaniel Vetter list_for_each_entry_safe(mode, t, &connector->probed_modes, head) 40852217195SDaniel Vetter drm_mode_remove(connector, mode); 40952217195SDaniel Vetter 41052217195SDaniel Vetter list_for_each_entry_safe(mode, t, &connector->modes, head) 41152217195SDaniel Vetter drm_mode_remove(connector, mode); 41252217195SDaniel Vetter 4139a47dba1SChristophe JAILLET ida_simple_remove(&drm_connector_enum_list[connector->connector_type].ida, 41452217195SDaniel Vetter connector->connector_type_id); 41552217195SDaniel Vetter 4169a47dba1SChristophe JAILLET ida_simple_remove(&dev->mode_config.connector_ida, 41752217195SDaniel Vetter connector->index); 41852217195SDaniel Vetter 41952217195SDaniel Vetter kfree(connector->display_info.bus_formats); 42052217195SDaniel Vetter drm_mode_object_unregister(dev, &connector->base); 42152217195SDaniel Vetter kfree(connector->name); 42252217195SDaniel Vetter connector->name = NULL; 423613051daSDaniel Vetter spin_lock_irq(&dev->mode_config.connector_list_lock); 42452217195SDaniel Vetter list_del(&connector->head); 42552217195SDaniel Vetter dev->mode_config.num_connector--; 426613051daSDaniel Vetter spin_unlock_irq(&dev->mode_config.connector_list_lock); 42752217195SDaniel Vetter 42852217195SDaniel Vetter WARN_ON(connector->state && !connector->funcs->atomic_destroy_state); 42952217195SDaniel Vetter if (connector->state && connector->funcs->atomic_destroy_state) 43052217195SDaniel Vetter connector->funcs->atomic_destroy_state(connector, 43152217195SDaniel Vetter connector->state); 43252217195SDaniel Vetter 433e73ab00eSDaniel Vetter mutex_destroy(&connector->mutex); 434e73ab00eSDaniel Vetter 43552217195SDaniel Vetter memset(connector, 0, sizeof(*connector)); 43652217195SDaniel Vetter } 43752217195SDaniel Vetter EXPORT_SYMBOL(drm_connector_cleanup); 43852217195SDaniel Vetter 43952217195SDaniel Vetter /** 44052217195SDaniel Vetter * drm_connector_register - register a connector 44152217195SDaniel Vetter * @connector: the connector to register 44252217195SDaniel Vetter * 44352217195SDaniel Vetter * Register userspace interfaces for a connector 44452217195SDaniel Vetter * 44552217195SDaniel Vetter * Returns: 44652217195SDaniel Vetter * Zero on success, error code on failure. 44752217195SDaniel Vetter */ 44852217195SDaniel Vetter int drm_connector_register(struct drm_connector *connector) 44952217195SDaniel Vetter { 450e73ab00eSDaniel Vetter int ret = 0; 45152217195SDaniel Vetter 452e6e7b48bSDaniel Vetter if (!connector->dev->registered) 453e6e7b48bSDaniel Vetter return 0; 454e6e7b48bSDaniel Vetter 455e73ab00eSDaniel Vetter mutex_lock(&connector->mutex); 45639b50c60SLyude Paul if (connector->registration_state != DRM_CONNECTOR_INITIALIZING) 457e73ab00eSDaniel Vetter goto unlock; 45852217195SDaniel Vetter 45952217195SDaniel Vetter ret = drm_sysfs_connector_add(connector); 46052217195SDaniel Vetter if (ret) 461e73ab00eSDaniel Vetter goto unlock; 46252217195SDaniel Vetter 46352217195SDaniel Vetter ret = drm_debugfs_connector_add(connector); 46452217195SDaniel Vetter if (ret) { 46552217195SDaniel Vetter goto err_sysfs; 46652217195SDaniel Vetter } 46752217195SDaniel Vetter 46852217195SDaniel Vetter if (connector->funcs->late_register) { 46952217195SDaniel Vetter ret = connector->funcs->late_register(connector); 47052217195SDaniel Vetter if (ret) 47152217195SDaniel Vetter goto err_debugfs; 47252217195SDaniel Vetter } 47352217195SDaniel Vetter 47452217195SDaniel Vetter drm_mode_object_register(connector->dev, &connector->base); 47552217195SDaniel Vetter 47639b50c60SLyude Paul connector->registration_state = DRM_CONNECTOR_REGISTERED; 477e73ab00eSDaniel Vetter goto unlock; 47852217195SDaniel Vetter 47952217195SDaniel Vetter err_debugfs: 48052217195SDaniel Vetter drm_debugfs_connector_remove(connector); 48152217195SDaniel Vetter err_sysfs: 48252217195SDaniel Vetter drm_sysfs_connector_remove(connector); 483e73ab00eSDaniel Vetter unlock: 484e73ab00eSDaniel Vetter mutex_unlock(&connector->mutex); 48552217195SDaniel Vetter return ret; 48652217195SDaniel Vetter } 48752217195SDaniel Vetter EXPORT_SYMBOL(drm_connector_register); 48852217195SDaniel Vetter 48952217195SDaniel Vetter /** 49052217195SDaniel Vetter * drm_connector_unregister - unregister a connector 49152217195SDaniel Vetter * @connector: the connector to unregister 49252217195SDaniel Vetter * 49352217195SDaniel Vetter * Unregister userspace interfaces for a connector 49452217195SDaniel Vetter */ 49552217195SDaniel Vetter void drm_connector_unregister(struct drm_connector *connector) 49652217195SDaniel Vetter { 497e73ab00eSDaniel Vetter mutex_lock(&connector->mutex); 49839b50c60SLyude Paul if (connector->registration_state != DRM_CONNECTOR_REGISTERED) { 499e73ab00eSDaniel Vetter mutex_unlock(&connector->mutex); 50052217195SDaniel Vetter return; 501e73ab00eSDaniel Vetter } 50252217195SDaniel Vetter 50352217195SDaniel Vetter if (connector->funcs->early_unregister) 50452217195SDaniel Vetter connector->funcs->early_unregister(connector); 50552217195SDaniel Vetter 50652217195SDaniel Vetter drm_sysfs_connector_remove(connector); 50752217195SDaniel Vetter drm_debugfs_connector_remove(connector); 50852217195SDaniel Vetter 50939b50c60SLyude Paul connector->registration_state = DRM_CONNECTOR_UNREGISTERED; 510e73ab00eSDaniel Vetter mutex_unlock(&connector->mutex); 51152217195SDaniel Vetter } 51252217195SDaniel Vetter EXPORT_SYMBOL(drm_connector_unregister); 51352217195SDaniel Vetter 51452217195SDaniel Vetter void drm_connector_unregister_all(struct drm_device *dev) 51552217195SDaniel Vetter { 51652217195SDaniel Vetter struct drm_connector *connector; 517613051daSDaniel Vetter struct drm_connector_list_iter conn_iter; 51852217195SDaniel Vetter 519b982dab1SThierry Reding drm_connector_list_iter_begin(dev, &conn_iter); 520613051daSDaniel Vetter drm_for_each_connector_iter(connector, &conn_iter) 52152217195SDaniel Vetter drm_connector_unregister(connector); 522b982dab1SThierry Reding drm_connector_list_iter_end(&conn_iter); 52352217195SDaniel Vetter } 52452217195SDaniel Vetter 52552217195SDaniel Vetter int drm_connector_register_all(struct drm_device *dev) 52652217195SDaniel Vetter { 52752217195SDaniel Vetter struct drm_connector *connector; 528613051daSDaniel Vetter struct drm_connector_list_iter conn_iter; 529613051daSDaniel Vetter int ret = 0; 53052217195SDaniel Vetter 531b982dab1SThierry Reding drm_connector_list_iter_begin(dev, &conn_iter); 532613051daSDaniel Vetter drm_for_each_connector_iter(connector, &conn_iter) { 53352217195SDaniel Vetter ret = drm_connector_register(connector); 53452217195SDaniel Vetter if (ret) 535613051daSDaniel Vetter break; 53652217195SDaniel Vetter } 537b982dab1SThierry Reding drm_connector_list_iter_end(&conn_iter); 53852217195SDaniel Vetter 539613051daSDaniel Vetter if (ret) 54052217195SDaniel Vetter drm_connector_unregister_all(dev); 54152217195SDaniel Vetter return ret; 54252217195SDaniel Vetter } 54352217195SDaniel Vetter 54452217195SDaniel Vetter /** 54552217195SDaniel Vetter * drm_get_connector_status_name - return a string for connector status 54652217195SDaniel Vetter * @status: connector status to compute name of 54752217195SDaniel Vetter * 54852217195SDaniel Vetter * In contrast to the other drm_get_*_name functions this one here returns a 54952217195SDaniel Vetter * const pointer and hence is threadsafe. 55052217195SDaniel Vetter */ 55152217195SDaniel Vetter const char *drm_get_connector_status_name(enum drm_connector_status status) 55252217195SDaniel Vetter { 55352217195SDaniel Vetter if (status == connector_status_connected) 55452217195SDaniel Vetter return "connected"; 55552217195SDaniel Vetter else if (status == connector_status_disconnected) 55652217195SDaniel Vetter return "disconnected"; 55752217195SDaniel Vetter else 55852217195SDaniel Vetter return "unknown"; 55952217195SDaniel Vetter } 56052217195SDaniel Vetter EXPORT_SYMBOL(drm_get_connector_status_name); 56152217195SDaniel Vetter 5626140cf20SJani Nikula /** 5636140cf20SJani Nikula * drm_get_connector_force_name - return a string for connector force 5646140cf20SJani Nikula * @force: connector force to get name of 5656140cf20SJani Nikula * 5666140cf20SJani Nikula * Returns: const pointer to name. 5676140cf20SJani Nikula */ 5686140cf20SJani Nikula const char *drm_get_connector_force_name(enum drm_connector_force force) 5696140cf20SJani Nikula { 5706140cf20SJani Nikula switch (force) { 5716140cf20SJani Nikula case DRM_FORCE_UNSPECIFIED: 5726140cf20SJani Nikula return "unspecified"; 5736140cf20SJani Nikula case DRM_FORCE_OFF: 5746140cf20SJani Nikula return "off"; 5756140cf20SJani Nikula case DRM_FORCE_ON: 5766140cf20SJani Nikula return "on"; 5776140cf20SJani Nikula case DRM_FORCE_ON_DIGITAL: 5786140cf20SJani Nikula return "digital"; 5796140cf20SJani Nikula default: 5806140cf20SJani Nikula return "unknown"; 5816140cf20SJani Nikula } 5826140cf20SJani Nikula } 5836140cf20SJani Nikula 584613051daSDaniel Vetter #ifdef CONFIG_LOCKDEP 585613051daSDaniel Vetter static struct lockdep_map connector_list_iter_dep_map = { 586613051daSDaniel Vetter .name = "drm_connector_list_iter" 587613051daSDaniel Vetter }; 588613051daSDaniel Vetter #endif 589613051daSDaniel Vetter 590613051daSDaniel Vetter /** 591b982dab1SThierry Reding * drm_connector_list_iter_begin - initialize a connector_list iterator 592613051daSDaniel Vetter * @dev: DRM device 593613051daSDaniel Vetter * @iter: connector_list iterator 594613051daSDaniel Vetter * 595d574528aSDaniel Vetter * Sets @iter up to walk the &drm_mode_config.connector_list of @dev. @iter 596b982dab1SThierry Reding * must always be cleaned up again by calling drm_connector_list_iter_end(). 597613051daSDaniel Vetter * Iteration itself happens using drm_connector_list_iter_next() or 598613051daSDaniel Vetter * drm_for_each_connector_iter(). 599613051daSDaniel Vetter */ 600b982dab1SThierry Reding void drm_connector_list_iter_begin(struct drm_device *dev, 601613051daSDaniel Vetter struct drm_connector_list_iter *iter) 602613051daSDaniel Vetter { 603613051daSDaniel Vetter iter->dev = dev; 604613051daSDaniel Vetter iter->conn = NULL; 605613051daSDaniel Vetter lock_acquire_shared_recursive(&connector_list_iter_dep_map, 0, 1, NULL, _RET_IP_); 606613051daSDaniel Vetter } 607b982dab1SThierry Reding EXPORT_SYMBOL(drm_connector_list_iter_begin); 608613051daSDaniel Vetter 609a703c550SDaniel Vetter /* 610a703c550SDaniel Vetter * Extra-safe connector put function that works in any context. Should only be 611a703c550SDaniel Vetter * used from the connector_iter functions, where we never really expect to 612a703c550SDaniel Vetter * actually release the connector when dropping our final reference. 613a703c550SDaniel Vetter */ 614a703c550SDaniel Vetter static void 615ea497bb9SDaniel Vetter __drm_connector_put_safe(struct drm_connector *conn) 616a703c550SDaniel Vetter { 617ea497bb9SDaniel Vetter struct drm_mode_config *config = &conn->dev->mode_config; 618ea497bb9SDaniel Vetter 619ea497bb9SDaniel Vetter lockdep_assert_held(&config->connector_list_lock); 620ea497bb9SDaniel Vetter 621ea497bb9SDaniel Vetter if (!refcount_dec_and_test(&conn->base.refcount.refcount)) 622ea497bb9SDaniel Vetter return; 623ea497bb9SDaniel Vetter 624ea497bb9SDaniel Vetter llist_add(&conn->free_node, &config->connector_free_list); 625ea497bb9SDaniel Vetter schedule_work(&config->connector_free_work); 626a703c550SDaniel Vetter } 627a703c550SDaniel Vetter 628613051daSDaniel Vetter /** 629613051daSDaniel Vetter * drm_connector_list_iter_next - return next connector 6304f45c778SLyude Paul * @iter: connector_list iterator 631613051daSDaniel Vetter * 632613051daSDaniel Vetter * Returns the next connector for @iter, or NULL when the list walk has 633613051daSDaniel Vetter * completed. 634613051daSDaniel Vetter */ 635613051daSDaniel Vetter struct drm_connector * 636613051daSDaniel Vetter drm_connector_list_iter_next(struct drm_connector_list_iter *iter) 637613051daSDaniel Vetter { 638613051daSDaniel Vetter struct drm_connector *old_conn = iter->conn; 639613051daSDaniel Vetter struct drm_mode_config *config = &iter->dev->mode_config; 640613051daSDaniel Vetter struct list_head *lhead; 641613051daSDaniel Vetter unsigned long flags; 642613051daSDaniel Vetter 643613051daSDaniel Vetter spin_lock_irqsave(&config->connector_list_lock, flags); 644613051daSDaniel Vetter lhead = old_conn ? &old_conn->head : &config->connector_list; 645613051daSDaniel Vetter 646613051daSDaniel Vetter do { 647613051daSDaniel Vetter if (lhead->next == &config->connector_list) { 648613051daSDaniel Vetter iter->conn = NULL; 649613051daSDaniel Vetter break; 650613051daSDaniel Vetter } 651613051daSDaniel Vetter 652613051daSDaniel Vetter lhead = lhead->next; 653613051daSDaniel Vetter iter->conn = list_entry(lhead, struct drm_connector, head); 654613051daSDaniel Vetter 655613051daSDaniel Vetter /* loop until it's not a zombie connector */ 656613051daSDaniel Vetter } while (!kref_get_unless_zero(&iter->conn->base.refcount)); 657613051daSDaniel Vetter 658613051daSDaniel Vetter if (old_conn) 659ea497bb9SDaniel Vetter __drm_connector_put_safe(old_conn); 660ea497bb9SDaniel Vetter spin_unlock_irqrestore(&config->connector_list_lock, flags); 661613051daSDaniel Vetter 662613051daSDaniel Vetter return iter->conn; 663613051daSDaniel Vetter } 664613051daSDaniel Vetter EXPORT_SYMBOL(drm_connector_list_iter_next); 665613051daSDaniel Vetter 666613051daSDaniel Vetter /** 667b982dab1SThierry Reding * drm_connector_list_iter_end - tear down a connector_list iterator 668613051daSDaniel Vetter * @iter: connector_list iterator 669613051daSDaniel Vetter * 670613051daSDaniel Vetter * Tears down @iter and releases any resources (like &drm_connector references) 671613051daSDaniel Vetter * acquired while walking the list. This must always be called, both when the 672613051daSDaniel Vetter * iteration completes fully or when it was aborted without walking the entire 673613051daSDaniel Vetter * list. 674613051daSDaniel Vetter */ 675b982dab1SThierry Reding void drm_connector_list_iter_end(struct drm_connector_list_iter *iter) 676613051daSDaniel Vetter { 677ea497bb9SDaniel Vetter struct drm_mode_config *config = &iter->dev->mode_config; 678ea497bb9SDaniel Vetter unsigned long flags; 679ea497bb9SDaniel Vetter 680613051daSDaniel Vetter iter->dev = NULL; 681ea497bb9SDaniel Vetter if (iter->conn) { 682ea497bb9SDaniel Vetter spin_lock_irqsave(&config->connector_list_lock, flags); 683ea497bb9SDaniel Vetter __drm_connector_put_safe(iter->conn); 684ea497bb9SDaniel Vetter spin_unlock_irqrestore(&config->connector_list_lock, flags); 685ea497bb9SDaniel Vetter } 686613051daSDaniel Vetter lock_release(&connector_list_iter_dep_map, 0, _RET_IP_); 687613051daSDaniel Vetter } 688b982dab1SThierry Reding EXPORT_SYMBOL(drm_connector_list_iter_end); 689613051daSDaniel Vetter 69052217195SDaniel Vetter static const struct drm_prop_enum_list drm_subpixel_enum_list[] = { 69152217195SDaniel Vetter { SubPixelUnknown, "Unknown" }, 69252217195SDaniel Vetter { SubPixelHorizontalRGB, "Horizontal RGB" }, 69352217195SDaniel Vetter { SubPixelHorizontalBGR, "Horizontal BGR" }, 69452217195SDaniel Vetter { SubPixelVerticalRGB, "Vertical RGB" }, 69552217195SDaniel Vetter { SubPixelVerticalBGR, "Vertical BGR" }, 69652217195SDaniel Vetter { SubPixelNone, "None" }, 69752217195SDaniel Vetter }; 69852217195SDaniel Vetter 69952217195SDaniel Vetter /** 70052217195SDaniel Vetter * drm_get_subpixel_order_name - return a string for a given subpixel enum 70152217195SDaniel Vetter * @order: enum of subpixel_order 70252217195SDaniel Vetter * 70352217195SDaniel Vetter * Note you could abuse this and return something out of bounds, but that 70452217195SDaniel Vetter * would be a caller error. No unscrubbed user data should make it here. 70552217195SDaniel Vetter */ 70652217195SDaniel Vetter const char *drm_get_subpixel_order_name(enum subpixel_order order) 70752217195SDaniel Vetter { 70852217195SDaniel Vetter return drm_subpixel_enum_list[order].name; 70952217195SDaniel Vetter } 71052217195SDaniel Vetter EXPORT_SYMBOL(drm_get_subpixel_order_name); 71152217195SDaniel Vetter 71252217195SDaniel Vetter static const struct drm_prop_enum_list drm_dpms_enum_list[] = { 71352217195SDaniel Vetter { DRM_MODE_DPMS_ON, "On" }, 71452217195SDaniel Vetter { DRM_MODE_DPMS_STANDBY, "Standby" }, 71552217195SDaniel Vetter { DRM_MODE_DPMS_SUSPEND, "Suspend" }, 71652217195SDaniel Vetter { DRM_MODE_DPMS_OFF, "Off" } 71752217195SDaniel Vetter }; 71852217195SDaniel Vetter DRM_ENUM_NAME_FN(drm_get_dpms_name, drm_dpms_enum_list) 71952217195SDaniel Vetter 72040ee6fbeSManasi Navare static const struct drm_prop_enum_list drm_link_status_enum_list[] = { 72140ee6fbeSManasi Navare { DRM_MODE_LINK_STATUS_GOOD, "Good" }, 72240ee6fbeSManasi Navare { DRM_MODE_LINK_STATUS_BAD, "Bad" }, 72340ee6fbeSManasi Navare }; 72440ee6fbeSManasi Navare 725b3c6c8bfSDaniel Vetter /** 726b3c6c8bfSDaniel Vetter * drm_display_info_set_bus_formats - set the supported bus formats 727b3c6c8bfSDaniel Vetter * @info: display info to store bus formats in 728b3c6c8bfSDaniel Vetter * @formats: array containing the supported bus formats 729b3c6c8bfSDaniel Vetter * @num_formats: the number of entries in the fmts array 730b3c6c8bfSDaniel Vetter * 731b3c6c8bfSDaniel Vetter * Store the supported bus formats in display info structure. 732b3c6c8bfSDaniel Vetter * See MEDIA_BUS_FMT_* definitions in include/uapi/linux/media-bus-format.h for 733b3c6c8bfSDaniel Vetter * a full list of available formats. 734b3c6c8bfSDaniel Vetter */ 735b3c6c8bfSDaniel Vetter int drm_display_info_set_bus_formats(struct drm_display_info *info, 736b3c6c8bfSDaniel Vetter const u32 *formats, 737b3c6c8bfSDaniel Vetter unsigned int num_formats) 738b3c6c8bfSDaniel Vetter { 739b3c6c8bfSDaniel Vetter u32 *fmts = NULL; 740b3c6c8bfSDaniel Vetter 741b3c6c8bfSDaniel Vetter if (!formats && num_formats) 742b3c6c8bfSDaniel Vetter return -EINVAL; 743b3c6c8bfSDaniel Vetter 744b3c6c8bfSDaniel Vetter if (formats && num_formats) { 745b3c6c8bfSDaniel Vetter fmts = kmemdup(formats, sizeof(*formats) * num_formats, 746b3c6c8bfSDaniel Vetter GFP_KERNEL); 747b3c6c8bfSDaniel Vetter if (!fmts) 748b3c6c8bfSDaniel Vetter return -ENOMEM; 749b3c6c8bfSDaniel Vetter } 750b3c6c8bfSDaniel Vetter 751b3c6c8bfSDaniel Vetter kfree(info->bus_formats); 752b3c6c8bfSDaniel Vetter info->bus_formats = fmts; 753b3c6c8bfSDaniel Vetter info->num_bus_formats = num_formats; 754b3c6c8bfSDaniel Vetter 755b3c6c8bfSDaniel Vetter return 0; 756b3c6c8bfSDaniel Vetter } 757b3c6c8bfSDaniel Vetter EXPORT_SYMBOL(drm_display_info_set_bus_formats); 758b3c6c8bfSDaniel Vetter 75952217195SDaniel Vetter /* Optional connector properties. */ 76052217195SDaniel Vetter static const struct drm_prop_enum_list drm_scaling_mode_enum_list[] = { 76152217195SDaniel Vetter { DRM_MODE_SCALE_NONE, "None" }, 76252217195SDaniel Vetter { DRM_MODE_SCALE_FULLSCREEN, "Full" }, 76352217195SDaniel Vetter { DRM_MODE_SCALE_CENTER, "Center" }, 76452217195SDaniel Vetter { DRM_MODE_SCALE_ASPECT, "Full aspect" }, 76552217195SDaniel Vetter }; 76652217195SDaniel Vetter 76752217195SDaniel Vetter static const struct drm_prop_enum_list drm_aspect_ratio_enum_list[] = { 76852217195SDaniel Vetter { DRM_MODE_PICTURE_ASPECT_NONE, "Automatic" }, 76952217195SDaniel Vetter { DRM_MODE_PICTURE_ASPECT_4_3, "4:3" }, 77052217195SDaniel Vetter { DRM_MODE_PICTURE_ASPECT_16_9, "16:9" }, 77152217195SDaniel Vetter }; 77252217195SDaniel Vetter 77350525c33SStanislav Lisovskiy static const struct drm_prop_enum_list drm_content_type_enum_list[] = { 77450525c33SStanislav Lisovskiy { DRM_MODE_CONTENT_TYPE_NO_DATA, "No Data" }, 77550525c33SStanislav Lisovskiy { DRM_MODE_CONTENT_TYPE_GRAPHICS, "Graphics" }, 77650525c33SStanislav Lisovskiy { DRM_MODE_CONTENT_TYPE_PHOTO, "Photo" }, 77750525c33SStanislav Lisovskiy { DRM_MODE_CONTENT_TYPE_CINEMA, "Cinema" }, 77850525c33SStanislav Lisovskiy { DRM_MODE_CONTENT_TYPE_GAME, "Game" }, 77950525c33SStanislav Lisovskiy }; 78050525c33SStanislav Lisovskiy 7818d70f395SHans de Goede static const struct drm_prop_enum_list drm_panel_orientation_enum_list[] = { 7828d70f395SHans de Goede { DRM_MODE_PANEL_ORIENTATION_NORMAL, "Normal" }, 7838d70f395SHans de Goede { DRM_MODE_PANEL_ORIENTATION_BOTTOM_UP, "Upside Down" }, 7848d70f395SHans de Goede { DRM_MODE_PANEL_ORIENTATION_LEFT_UP, "Left Side Up" }, 7858d70f395SHans de Goede { DRM_MODE_PANEL_ORIENTATION_RIGHT_UP, "Right Side Up" }, 7868d70f395SHans de Goede }; 7878d70f395SHans de Goede 78852217195SDaniel Vetter static const struct drm_prop_enum_list drm_dvi_i_select_enum_list[] = { 78952217195SDaniel Vetter { DRM_MODE_SUBCONNECTOR_Automatic, "Automatic" }, /* DVI-I and TV-out */ 79052217195SDaniel Vetter { DRM_MODE_SUBCONNECTOR_DVID, "DVI-D" }, /* DVI-I */ 79152217195SDaniel Vetter { DRM_MODE_SUBCONNECTOR_DVIA, "DVI-A" }, /* DVI-I */ 79252217195SDaniel Vetter }; 79352217195SDaniel Vetter DRM_ENUM_NAME_FN(drm_get_dvi_i_select_name, drm_dvi_i_select_enum_list) 79452217195SDaniel Vetter 79552217195SDaniel Vetter static const struct drm_prop_enum_list drm_dvi_i_subconnector_enum_list[] = { 79652217195SDaniel Vetter { DRM_MODE_SUBCONNECTOR_Unknown, "Unknown" }, /* DVI-I and TV-out */ 79752217195SDaniel Vetter { DRM_MODE_SUBCONNECTOR_DVID, "DVI-D" }, /* DVI-I */ 79852217195SDaniel Vetter { DRM_MODE_SUBCONNECTOR_DVIA, "DVI-A" }, /* DVI-I */ 79952217195SDaniel Vetter }; 80052217195SDaniel Vetter DRM_ENUM_NAME_FN(drm_get_dvi_i_subconnector_name, 80152217195SDaniel Vetter drm_dvi_i_subconnector_enum_list) 80252217195SDaniel Vetter 80352217195SDaniel Vetter static const struct drm_prop_enum_list drm_tv_select_enum_list[] = { 80452217195SDaniel Vetter { DRM_MODE_SUBCONNECTOR_Automatic, "Automatic" }, /* DVI-I and TV-out */ 80552217195SDaniel Vetter { DRM_MODE_SUBCONNECTOR_Composite, "Composite" }, /* TV-out */ 80652217195SDaniel Vetter { DRM_MODE_SUBCONNECTOR_SVIDEO, "SVIDEO" }, /* TV-out */ 80752217195SDaniel Vetter { DRM_MODE_SUBCONNECTOR_Component, "Component" }, /* TV-out */ 80852217195SDaniel Vetter { DRM_MODE_SUBCONNECTOR_SCART, "SCART" }, /* TV-out */ 80952217195SDaniel Vetter }; 81052217195SDaniel Vetter DRM_ENUM_NAME_FN(drm_get_tv_select_name, drm_tv_select_enum_list) 81152217195SDaniel Vetter 81252217195SDaniel Vetter static const struct drm_prop_enum_list drm_tv_subconnector_enum_list[] = { 81352217195SDaniel Vetter { DRM_MODE_SUBCONNECTOR_Unknown, "Unknown" }, /* DVI-I and TV-out */ 81452217195SDaniel Vetter { DRM_MODE_SUBCONNECTOR_Composite, "Composite" }, /* TV-out */ 81552217195SDaniel Vetter { DRM_MODE_SUBCONNECTOR_SVIDEO, "SVIDEO" }, /* TV-out */ 81652217195SDaniel Vetter { DRM_MODE_SUBCONNECTOR_Component, "Component" }, /* TV-out */ 81752217195SDaniel Vetter { DRM_MODE_SUBCONNECTOR_SCART, "SCART" }, /* TV-out */ 81852217195SDaniel Vetter }; 81952217195SDaniel Vetter DRM_ENUM_NAME_FN(drm_get_tv_subconnector_name, 82052217195SDaniel Vetter drm_tv_subconnector_enum_list) 82152217195SDaniel Vetter 82224557865SSean Paul static struct drm_prop_enum_list drm_cp_enum_list[] = { 82324557865SSean Paul { DRM_MODE_CONTENT_PROTECTION_UNDESIRED, "Undesired" }, 82424557865SSean Paul { DRM_MODE_CONTENT_PROTECTION_DESIRED, "Desired" }, 82524557865SSean Paul { DRM_MODE_CONTENT_PROTECTION_ENABLED, "Enabled" }, 82624557865SSean Paul }; 82724557865SSean Paul DRM_ENUM_NAME_FN(drm_get_content_protection_name, drm_cp_enum_list) 82824557865SSean Paul 829*d2c6a405SUma Shankar static const struct drm_prop_enum_list hdmi_colorspaces[] = { 830*d2c6a405SUma Shankar /* For Default case, driver will set the colorspace */ 831*d2c6a405SUma Shankar { DRM_MODE_COLORIMETRY_DEFAULT, "Default" }, 832*d2c6a405SUma Shankar /* Standard Definition Colorimetry based on CEA 861 */ 833*d2c6a405SUma Shankar { DRM_MODE_COLORIMETRY_SMPTE_170M_YCC, "SMPTE_170M_YCC" }, 834*d2c6a405SUma Shankar { DRM_MODE_COLORIMETRY_BT709_YCC, "BT709_YCC" }, 835*d2c6a405SUma Shankar /* Standard Definition Colorimetry based on IEC 61966-2-4 */ 836*d2c6a405SUma Shankar { DRM_MODE_COLORIMETRY_XVYCC_601, "XVYCC_601" }, 837*d2c6a405SUma Shankar /* High Definition Colorimetry based on IEC 61966-2-4 */ 838*d2c6a405SUma Shankar { DRM_MODE_COLORIMETRY_XVYCC_709, "XVYCC_709" }, 839*d2c6a405SUma Shankar /* Colorimetry based on IEC 61966-2-1/Amendment 1 */ 840*d2c6a405SUma Shankar { DRM_MODE_COLORIMETRY_SYCC_601, "SYCC_601" }, 841*d2c6a405SUma Shankar /* Colorimetry based on IEC 61966-2-5 [33] */ 842*d2c6a405SUma Shankar { DRM_MODE_COLORIMETRY_OPYCC_601, "opYCC_601" }, 843*d2c6a405SUma Shankar /* Colorimetry based on IEC 61966-2-5 */ 844*d2c6a405SUma Shankar { DRM_MODE_COLORIMETRY_OPRGB, "opRGB" }, 845*d2c6a405SUma Shankar /* Colorimetry based on ITU-R BT.2020 */ 846*d2c6a405SUma Shankar { DRM_MODE_COLORIMETRY_BT2020_CYCC, "BT2020_CYCC" }, 847*d2c6a405SUma Shankar /* Colorimetry based on ITU-R BT.2020 */ 848*d2c6a405SUma Shankar { DRM_MODE_COLORIMETRY_BT2020_RGB, "BT2020_RGB" }, 849*d2c6a405SUma Shankar /* Colorimetry based on ITU-R BT.2020 */ 850*d2c6a405SUma Shankar { DRM_MODE_COLORIMETRY_BT2020_YCC, "BT2020_YCC" }, 851*d2c6a405SUma Shankar /* Added as part of Additional Colorimetry Extension in 861.G */ 852*d2c6a405SUma Shankar { DRM_MODE_COLORIMETRY_DCI_P3_RGB_D65, "DCI-P3_RGB_D65" }, 853*d2c6a405SUma Shankar { DRM_MODE_COLORIMETRY_DCI_P3_RGB_THEATER, "DCI-P3_RGB_Theater" }, 854*d2c6a405SUma Shankar }; 855*d2c6a405SUma Shankar 8564ada6f22SDaniel Vetter /** 8574ada6f22SDaniel Vetter * DOC: standard connector properties 8584ada6f22SDaniel Vetter * 8594ada6f22SDaniel Vetter * DRM connectors have a few standardized properties: 8604ada6f22SDaniel Vetter * 8614ada6f22SDaniel Vetter * EDID: 8624ada6f22SDaniel Vetter * Blob property which contains the current EDID read from the sink. This 8634ada6f22SDaniel Vetter * is useful to parse sink identification information like vendor, model 8644ada6f22SDaniel Vetter * and serial. Drivers should update this property by calling 865c555f023SDaniel Vetter * drm_connector_update_edid_property(), usually after having parsed 8664ada6f22SDaniel Vetter * the EDID using drm_add_edid_modes(). Userspace cannot change this 8674ada6f22SDaniel Vetter * property. 8684ada6f22SDaniel Vetter * DPMS: 8694ada6f22SDaniel Vetter * Legacy property for setting the power state of the connector. For atomic 8704ada6f22SDaniel Vetter * drivers this is only provided for backwards compatibility with existing 8714ada6f22SDaniel Vetter * drivers, it remaps to controlling the "ACTIVE" property on the CRTC the 8724ada6f22SDaniel Vetter * connector is linked to. Drivers should never set this property directly, 873d574528aSDaniel Vetter * it is handled by the DRM core by calling the &drm_connector_funcs.dpms 874144a7999SDaniel Vetter * callback. For atomic drivers the remapping to the "ACTIVE" property is 875144a7999SDaniel Vetter * implemented in the DRM core. This is the only standard connector 876144a7999SDaniel Vetter * property that userspace can change. 877d0d1aee5SDaniel Vetter * 878d0d1aee5SDaniel Vetter * Note that this property cannot be set through the MODE_ATOMIC ioctl, 879d0d1aee5SDaniel Vetter * userspace must use "ACTIVE" on the CRTC instead. 880d0d1aee5SDaniel Vetter * 881d0d1aee5SDaniel Vetter * WARNING: 882d0d1aee5SDaniel Vetter * 883d0d1aee5SDaniel Vetter * For userspace also running on legacy drivers the "DPMS" semantics are a 884d0d1aee5SDaniel Vetter * lot more complicated. First, userspace cannot rely on the "DPMS" value 885d0d1aee5SDaniel Vetter * returned by the GETCONNECTOR actually reflecting reality, because many 886d0d1aee5SDaniel Vetter * drivers fail to update it. For atomic drivers this is taken care of in 887d0d1aee5SDaniel Vetter * drm_atomic_helper_update_legacy_modeset_state(). 888d0d1aee5SDaniel Vetter * 889d0d1aee5SDaniel Vetter * The second issue is that the DPMS state is only well-defined when the 890d0d1aee5SDaniel Vetter * connector is connected to a CRTC. In atomic the DRM core enforces that 891d0d1aee5SDaniel Vetter * "ACTIVE" is off in such a case, no such checks exists for "DPMS". 892d0d1aee5SDaniel Vetter * 893d0d1aee5SDaniel Vetter * Finally, when enabling an output using the legacy SETCONFIG ioctl then 894d0d1aee5SDaniel Vetter * "DPMS" is forced to ON. But see above, that might not be reflected in 895d0d1aee5SDaniel Vetter * the software value on legacy drivers. 896d0d1aee5SDaniel Vetter * 897d0d1aee5SDaniel Vetter * Summarizing: Only set "DPMS" when the connector is known to be enabled, 898d0d1aee5SDaniel Vetter * assume that a successful SETCONFIG call also sets "DPMS" to on, and 899d0d1aee5SDaniel Vetter * never read back the value of "DPMS" because it can be incorrect. 9004ada6f22SDaniel Vetter * PATH: 9014ada6f22SDaniel Vetter * Connector path property to identify how this sink is physically 9024ada6f22SDaniel Vetter * connected. Used by DP MST. This should be set by calling 90397e14fbeSDaniel Vetter * drm_connector_set_path_property(), in the case of DP MST with the 9044ada6f22SDaniel Vetter * path property the MST manager created. Userspace cannot change this 9054ada6f22SDaniel Vetter * property. 9064ada6f22SDaniel Vetter * TILE: 9074ada6f22SDaniel Vetter * Connector tile group property to indicate how a set of DRM connector 9084ada6f22SDaniel Vetter * compose together into one logical screen. This is used by both high-res 9094ada6f22SDaniel Vetter * external screens (often only using a single cable, but exposing multiple 9104ada6f22SDaniel Vetter * DP MST sinks), or high-res integrated panels (like dual-link DSI) which 9114ada6f22SDaniel Vetter * are not gen-locked. Note that for tiled panels which are genlocked, like 9124ada6f22SDaniel Vetter * dual-link LVDS or dual-link DSI, the driver should try to not expose the 9134ada6f22SDaniel Vetter * tiling and virtualize both &drm_crtc and &drm_plane if needed. Drivers 91497e14fbeSDaniel Vetter * should update this value using drm_connector_set_tile_property(). 9154ada6f22SDaniel Vetter * Userspace cannot change this property. 91640ee6fbeSManasi Navare * link-status: 917716719a3SSean Paul * Connector link-status property to indicate the status of link. The 918716719a3SSean Paul * default value of link-status is "GOOD". If something fails during or 919716719a3SSean Paul * after modeset, the kernel driver may set this to "BAD" and issue a 920716719a3SSean Paul * hotplug uevent. Drivers should update this value using 92197e14fbeSDaniel Vetter * drm_connector_set_link_status_property(). 92266660d4cSDave Airlie * non_desktop: 92366660d4cSDave Airlie * Indicates the output should be ignored for purposes of displaying a 92466660d4cSDave Airlie * standard desktop environment or console. This is most likely because 92566660d4cSDave Airlie * the output device is not rectilinear. 92624557865SSean Paul * Content Protection: 92724557865SSean Paul * This property is used by userspace to request the kernel protect future 92824557865SSean Paul * content communicated over the link. When requested, kernel will apply 92924557865SSean Paul * the appropriate means of protection (most often HDCP), and use the 93024557865SSean Paul * property to tell userspace the protection is active. 93124557865SSean Paul * 93224557865SSean Paul * Drivers can set this up by calling 93324557865SSean Paul * drm_connector_attach_content_protection_property() on initialization. 93424557865SSean Paul * 93524557865SSean Paul * The value of this property can be one of the following: 93624557865SSean Paul * 937bbeba09fSDaniel Vetter * DRM_MODE_CONTENT_PROTECTION_UNDESIRED = 0 93824557865SSean Paul * The link is not protected, content is transmitted in the clear. 939bbeba09fSDaniel Vetter * DRM_MODE_CONTENT_PROTECTION_DESIRED = 1 94024557865SSean Paul * Userspace has requested content protection, but the link is not 94124557865SSean Paul * currently protected. When in this state, kernel should enable 94224557865SSean Paul * Content Protection as soon as possible. 943bbeba09fSDaniel Vetter * DRM_MODE_CONTENT_PROTECTION_ENABLED = 2 94424557865SSean Paul * Userspace has requested content protection, and the link is 94524557865SSean Paul * protected. Only the driver can set the property to this value. 94624557865SSean Paul * If userspace attempts to set to ENABLED, kernel will return 94724557865SSean Paul * -EINVAL. 94824557865SSean Paul * 94924557865SSean Paul * A few guidelines: 95024557865SSean Paul * 95124557865SSean Paul * - DESIRED state should be preserved until userspace de-asserts it by 95224557865SSean Paul * setting the property to UNDESIRED. This means ENABLED should only 95324557865SSean Paul * transition to UNDESIRED when the user explicitly requests it. 95424557865SSean Paul * - If the state is DESIRED, kernel should attempt to re-authenticate the 95524557865SSean Paul * link whenever possible. This includes across disable/enable, dpms, 95624557865SSean Paul * hotplug, downstream device changes, link status failures, etc.. 95724557865SSean Paul * - Userspace is responsible for polling the property to determine when 95824557865SSean Paul * the value transitions from ENABLED to DESIRED. This signifies the link 95924557865SSean Paul * is no longer protected and userspace should take appropriate action 96024557865SSean Paul * (whatever that might be). 9614ada6f22SDaniel Vetter * 96247e22ff1SRadhakrishna Sripada * max bpc: 96347e22ff1SRadhakrishna Sripada * This range property is used by userspace to limit the bit depth. When 96447e22ff1SRadhakrishna Sripada * used the driver would limit the bpc in accordance with the valid range 96547e22ff1SRadhakrishna Sripada * supported by the hardware and sink. Drivers to use the function 96647e22ff1SRadhakrishna Sripada * drm_connector_attach_max_bpc_property() to create and attach the 96747e22ff1SRadhakrishna Sripada * property to the connector during initialization. 96847e22ff1SRadhakrishna Sripada * 9694ada6f22SDaniel Vetter * Connectors also have one standardized atomic property: 9704ada6f22SDaniel Vetter * 9714ada6f22SDaniel Vetter * CRTC_ID: 9724ada6f22SDaniel Vetter * Mode object ID of the &drm_crtc this connector should be connected to. 9738d70f395SHans de Goede * 9748d70f395SHans de Goede * Connectors for LCD panels may also have one standardized property: 9758d70f395SHans de Goede * 9768d70f395SHans de Goede * panel orientation: 9778d70f395SHans de Goede * On some devices the LCD panel is mounted in the casing in such a way 9788d70f395SHans de Goede * that the up/top side of the panel does not match with the top side of 9798d70f395SHans de Goede * the device. Userspace can use this property to check for this. 9808d70f395SHans de Goede * Note that input coordinates from touchscreens (input devices with 9818d70f395SHans de Goede * INPUT_PROP_DIRECT) will still map 1:1 to the actual LCD panel 9828d70f395SHans de Goede * coordinates, so if userspace rotates the picture to adjust for 9838d70f395SHans de Goede * the orientation it must also apply the same transformation to the 984bbeba09fSDaniel Vetter * touchscreen input coordinates. This property is initialized by calling 985bbeba09fSDaniel Vetter * drm_connector_init_panel_orientation_property(). 986bbeba09fSDaniel Vetter * 987bbeba09fSDaniel Vetter * scaling mode: 988bbeba09fSDaniel Vetter * This property defines how a non-native mode is upscaled to the native 989bbeba09fSDaniel Vetter * mode of an LCD panel: 990bbeba09fSDaniel Vetter * 991bbeba09fSDaniel Vetter * None: 992bbeba09fSDaniel Vetter * No upscaling happens, scaling is left to the panel. Not all 993bbeba09fSDaniel Vetter * drivers expose this mode. 994bbeba09fSDaniel Vetter * Full: 995bbeba09fSDaniel Vetter * The output is upscaled to the full resolution of the panel, 996bbeba09fSDaniel Vetter * ignoring the aspect ratio. 997bbeba09fSDaniel Vetter * Center: 998bbeba09fSDaniel Vetter * No upscaling happens, the output is centered within the native 999bbeba09fSDaniel Vetter * resolution the panel. 1000bbeba09fSDaniel Vetter * Full aspect: 1001bbeba09fSDaniel Vetter * The output is upscaled to maximize either the width or height 1002bbeba09fSDaniel Vetter * while retaining the aspect ratio. 1003bbeba09fSDaniel Vetter * 1004bbeba09fSDaniel Vetter * This property should be set up by calling 1005bbeba09fSDaniel Vetter * drm_connector_attach_scaling_mode_property(). Note that drivers 1006bbeba09fSDaniel Vetter * can also expose this property to external outputs, in which case they 1007bbeba09fSDaniel Vetter * must support "None", which should be the default (since external screens 1008bbeba09fSDaniel Vetter * have a built-in scaler). 10094ada6f22SDaniel Vetter */ 10104ada6f22SDaniel Vetter 101152217195SDaniel Vetter int drm_connector_create_standard_properties(struct drm_device *dev) 101252217195SDaniel Vetter { 101352217195SDaniel Vetter struct drm_property *prop; 101452217195SDaniel Vetter 101552217195SDaniel Vetter prop = drm_property_create(dev, DRM_MODE_PROP_BLOB | 101652217195SDaniel Vetter DRM_MODE_PROP_IMMUTABLE, 101752217195SDaniel Vetter "EDID", 0); 101852217195SDaniel Vetter if (!prop) 101952217195SDaniel Vetter return -ENOMEM; 102052217195SDaniel Vetter dev->mode_config.edid_property = prop; 102152217195SDaniel Vetter 102252217195SDaniel Vetter prop = drm_property_create_enum(dev, 0, 102352217195SDaniel Vetter "DPMS", drm_dpms_enum_list, 102452217195SDaniel Vetter ARRAY_SIZE(drm_dpms_enum_list)); 102552217195SDaniel Vetter if (!prop) 102652217195SDaniel Vetter return -ENOMEM; 102752217195SDaniel Vetter dev->mode_config.dpms_property = prop; 102852217195SDaniel Vetter 102952217195SDaniel Vetter prop = drm_property_create(dev, 103052217195SDaniel Vetter DRM_MODE_PROP_BLOB | 103152217195SDaniel Vetter DRM_MODE_PROP_IMMUTABLE, 103252217195SDaniel Vetter "PATH", 0); 103352217195SDaniel Vetter if (!prop) 103452217195SDaniel Vetter return -ENOMEM; 103552217195SDaniel Vetter dev->mode_config.path_property = prop; 103652217195SDaniel Vetter 103752217195SDaniel Vetter prop = drm_property_create(dev, 103852217195SDaniel Vetter DRM_MODE_PROP_BLOB | 103952217195SDaniel Vetter DRM_MODE_PROP_IMMUTABLE, 104052217195SDaniel Vetter "TILE", 0); 104152217195SDaniel Vetter if (!prop) 104252217195SDaniel Vetter return -ENOMEM; 104352217195SDaniel Vetter dev->mode_config.tile_property = prop; 104452217195SDaniel Vetter 104540ee6fbeSManasi Navare prop = drm_property_create_enum(dev, 0, "link-status", 104640ee6fbeSManasi Navare drm_link_status_enum_list, 104740ee6fbeSManasi Navare ARRAY_SIZE(drm_link_status_enum_list)); 104840ee6fbeSManasi Navare if (!prop) 104940ee6fbeSManasi Navare return -ENOMEM; 105040ee6fbeSManasi Navare dev->mode_config.link_status_property = prop; 105140ee6fbeSManasi Navare 105266660d4cSDave Airlie prop = drm_property_create_bool(dev, DRM_MODE_PROP_IMMUTABLE, "non-desktop"); 105366660d4cSDave Airlie if (!prop) 105466660d4cSDave Airlie return -ENOMEM; 105566660d4cSDave Airlie dev->mode_config.non_desktop_property = prop; 105666660d4cSDave Airlie 105752217195SDaniel Vetter return 0; 105852217195SDaniel Vetter } 105952217195SDaniel Vetter 106052217195SDaniel Vetter /** 106152217195SDaniel Vetter * drm_mode_create_dvi_i_properties - create DVI-I specific connector properties 106252217195SDaniel Vetter * @dev: DRM device 106352217195SDaniel Vetter * 106452217195SDaniel Vetter * Called by a driver the first time a DVI-I connector is made. 106552217195SDaniel Vetter */ 106652217195SDaniel Vetter int drm_mode_create_dvi_i_properties(struct drm_device *dev) 106752217195SDaniel Vetter { 106852217195SDaniel Vetter struct drm_property *dvi_i_selector; 106952217195SDaniel Vetter struct drm_property *dvi_i_subconnector; 107052217195SDaniel Vetter 107152217195SDaniel Vetter if (dev->mode_config.dvi_i_select_subconnector_property) 107252217195SDaniel Vetter return 0; 107352217195SDaniel Vetter 107452217195SDaniel Vetter dvi_i_selector = 107552217195SDaniel Vetter drm_property_create_enum(dev, 0, 107652217195SDaniel Vetter "select subconnector", 107752217195SDaniel Vetter drm_dvi_i_select_enum_list, 107852217195SDaniel Vetter ARRAY_SIZE(drm_dvi_i_select_enum_list)); 107952217195SDaniel Vetter dev->mode_config.dvi_i_select_subconnector_property = dvi_i_selector; 108052217195SDaniel Vetter 108152217195SDaniel Vetter dvi_i_subconnector = drm_property_create_enum(dev, DRM_MODE_PROP_IMMUTABLE, 108252217195SDaniel Vetter "subconnector", 108352217195SDaniel Vetter drm_dvi_i_subconnector_enum_list, 108452217195SDaniel Vetter ARRAY_SIZE(drm_dvi_i_subconnector_enum_list)); 108552217195SDaniel Vetter dev->mode_config.dvi_i_subconnector_property = dvi_i_subconnector; 108652217195SDaniel Vetter 108752217195SDaniel Vetter return 0; 108852217195SDaniel Vetter } 108952217195SDaniel Vetter EXPORT_SYMBOL(drm_mode_create_dvi_i_properties); 109052217195SDaniel Vetter 109152217195SDaniel Vetter /** 109250525c33SStanislav Lisovskiy * DOC: HDMI connector properties 109350525c33SStanislav Lisovskiy * 109450525c33SStanislav Lisovskiy * content type (HDMI specific): 109550525c33SStanislav Lisovskiy * Indicates content type setting to be used in HDMI infoframes to indicate 10961e55a53aSMatt Roper * content type for the external device, so that it adjusts its display 109750525c33SStanislav Lisovskiy * settings accordingly. 109850525c33SStanislav Lisovskiy * 109950525c33SStanislav Lisovskiy * The value of this property can be one of the following: 110050525c33SStanislav Lisovskiy * 110150525c33SStanislav Lisovskiy * No Data: 110250525c33SStanislav Lisovskiy * Content type is unknown 110350525c33SStanislav Lisovskiy * Graphics: 110450525c33SStanislav Lisovskiy * Content type is graphics 110550525c33SStanislav Lisovskiy * Photo: 110650525c33SStanislav Lisovskiy * Content type is photo 110750525c33SStanislav Lisovskiy * Cinema: 110850525c33SStanislav Lisovskiy * Content type is cinema 110950525c33SStanislav Lisovskiy * Game: 111050525c33SStanislav Lisovskiy * Content type is game 111150525c33SStanislav Lisovskiy * 111250525c33SStanislav Lisovskiy * Drivers can set up this property by calling 111350525c33SStanislav Lisovskiy * drm_connector_attach_content_type_property(). Decoding to 1114ba609631SDaniel Vetter * infoframe values is done through drm_hdmi_avi_infoframe_content_type(). 111550525c33SStanislav Lisovskiy */ 111650525c33SStanislav Lisovskiy 111750525c33SStanislav Lisovskiy /** 111850525c33SStanislav Lisovskiy * drm_connector_attach_content_type_property - attach content-type property 111950525c33SStanislav Lisovskiy * @connector: connector to attach content type property on. 112050525c33SStanislav Lisovskiy * 112150525c33SStanislav Lisovskiy * Called by a driver the first time a HDMI connector is made. 112250525c33SStanislav Lisovskiy */ 112350525c33SStanislav Lisovskiy int drm_connector_attach_content_type_property(struct drm_connector *connector) 112450525c33SStanislav Lisovskiy { 112550525c33SStanislav Lisovskiy if (!drm_mode_create_content_type_property(connector->dev)) 112650525c33SStanislav Lisovskiy drm_object_attach_property(&connector->base, 112750525c33SStanislav Lisovskiy connector->dev->mode_config.content_type_property, 112850525c33SStanislav Lisovskiy DRM_MODE_CONTENT_TYPE_NO_DATA); 112950525c33SStanislav Lisovskiy return 0; 113050525c33SStanislav Lisovskiy } 113150525c33SStanislav Lisovskiy EXPORT_SYMBOL(drm_connector_attach_content_type_property); 113250525c33SStanislav Lisovskiy 113350525c33SStanislav Lisovskiy 113450525c33SStanislav Lisovskiy /** 113550525c33SStanislav Lisovskiy * drm_hdmi_avi_infoframe_content_type() - fill the HDMI AVI infoframe 113650525c33SStanislav Lisovskiy * content type information, based 113750525c33SStanislav Lisovskiy * on correspondent DRM property. 113850525c33SStanislav Lisovskiy * @frame: HDMI AVI infoframe 113950525c33SStanislav Lisovskiy * @conn_state: DRM display connector state 114050525c33SStanislav Lisovskiy * 114150525c33SStanislav Lisovskiy */ 114250525c33SStanislav Lisovskiy void drm_hdmi_avi_infoframe_content_type(struct hdmi_avi_infoframe *frame, 114350525c33SStanislav Lisovskiy const struct drm_connector_state *conn_state) 114450525c33SStanislav Lisovskiy { 114550525c33SStanislav Lisovskiy switch (conn_state->content_type) { 114650525c33SStanislav Lisovskiy case DRM_MODE_CONTENT_TYPE_GRAPHICS: 114750525c33SStanislav Lisovskiy frame->content_type = HDMI_CONTENT_TYPE_GRAPHICS; 114850525c33SStanislav Lisovskiy break; 114950525c33SStanislav Lisovskiy case DRM_MODE_CONTENT_TYPE_CINEMA: 115050525c33SStanislav Lisovskiy frame->content_type = HDMI_CONTENT_TYPE_CINEMA; 115150525c33SStanislav Lisovskiy break; 115250525c33SStanislav Lisovskiy case DRM_MODE_CONTENT_TYPE_GAME: 115350525c33SStanislav Lisovskiy frame->content_type = HDMI_CONTENT_TYPE_GAME; 115450525c33SStanislav Lisovskiy break; 115550525c33SStanislav Lisovskiy case DRM_MODE_CONTENT_TYPE_PHOTO: 115650525c33SStanislav Lisovskiy frame->content_type = HDMI_CONTENT_TYPE_PHOTO; 115750525c33SStanislav Lisovskiy break; 115850525c33SStanislav Lisovskiy default: 115950525c33SStanislav Lisovskiy /* Graphics is the default(0) */ 116050525c33SStanislav Lisovskiy frame->content_type = HDMI_CONTENT_TYPE_GRAPHICS; 116150525c33SStanislav Lisovskiy } 116250525c33SStanislav Lisovskiy 116350525c33SStanislav Lisovskiy frame->itc = conn_state->content_type != DRM_MODE_CONTENT_TYPE_NO_DATA; 116450525c33SStanislav Lisovskiy } 116550525c33SStanislav Lisovskiy EXPORT_SYMBOL(drm_hdmi_avi_infoframe_content_type); 116650525c33SStanislav Lisovskiy 116750525c33SStanislav Lisovskiy /** 11686c4f52dcSBoris Brezillon * drm_mode_attach_tv_margin_properties - attach TV connector margin properties 11696c4f52dcSBoris Brezillon * @connector: DRM connector 11706c4f52dcSBoris Brezillon * 11716c4f52dcSBoris Brezillon * Called by a driver when it needs to attach TV margin props to a connector. 11726c4f52dcSBoris Brezillon * Typically used on SDTV and HDMI connectors. 11736c4f52dcSBoris Brezillon */ 11746c4f52dcSBoris Brezillon void drm_connector_attach_tv_margin_properties(struct drm_connector *connector) 11756c4f52dcSBoris Brezillon { 11766c4f52dcSBoris Brezillon struct drm_device *dev = connector->dev; 11776c4f52dcSBoris Brezillon 11786c4f52dcSBoris Brezillon drm_object_attach_property(&connector->base, 11796c4f52dcSBoris Brezillon dev->mode_config.tv_left_margin_property, 11806c4f52dcSBoris Brezillon 0); 11816c4f52dcSBoris Brezillon drm_object_attach_property(&connector->base, 11826c4f52dcSBoris Brezillon dev->mode_config.tv_right_margin_property, 11836c4f52dcSBoris Brezillon 0); 11846c4f52dcSBoris Brezillon drm_object_attach_property(&connector->base, 11856c4f52dcSBoris Brezillon dev->mode_config.tv_top_margin_property, 11866c4f52dcSBoris Brezillon 0); 11876c4f52dcSBoris Brezillon drm_object_attach_property(&connector->base, 11886c4f52dcSBoris Brezillon dev->mode_config.tv_bottom_margin_property, 11896c4f52dcSBoris Brezillon 0); 11906c4f52dcSBoris Brezillon } 11916c4f52dcSBoris Brezillon EXPORT_SYMBOL(drm_connector_attach_tv_margin_properties); 11926c4f52dcSBoris Brezillon 11936c4f52dcSBoris Brezillon /** 11946c4f52dcSBoris Brezillon * drm_mode_create_tv_margin_properties - create TV connector margin properties 11956c4f52dcSBoris Brezillon * @dev: DRM device 11966c4f52dcSBoris Brezillon * 11976c4f52dcSBoris Brezillon * Called by a driver's HDMI connector initialization routine, this function 11986c4f52dcSBoris Brezillon * creates the TV margin properties for a given device. No need to call this 11996c4f52dcSBoris Brezillon * function for an SDTV connector, it's already called from 12006c4f52dcSBoris Brezillon * drm_mode_create_tv_properties(). 12016c4f52dcSBoris Brezillon */ 12026c4f52dcSBoris Brezillon int drm_mode_create_tv_margin_properties(struct drm_device *dev) 12036c4f52dcSBoris Brezillon { 12046c4f52dcSBoris Brezillon if (dev->mode_config.tv_left_margin_property) 12056c4f52dcSBoris Brezillon return 0; 12066c4f52dcSBoris Brezillon 12076c4f52dcSBoris Brezillon dev->mode_config.tv_left_margin_property = 12086c4f52dcSBoris Brezillon drm_property_create_range(dev, 0, "left margin", 0, 100); 12096c4f52dcSBoris Brezillon if (!dev->mode_config.tv_left_margin_property) 12106c4f52dcSBoris Brezillon return -ENOMEM; 12116c4f52dcSBoris Brezillon 12126c4f52dcSBoris Brezillon dev->mode_config.tv_right_margin_property = 12136c4f52dcSBoris Brezillon drm_property_create_range(dev, 0, "right margin", 0, 100); 12146c4f52dcSBoris Brezillon if (!dev->mode_config.tv_right_margin_property) 12156c4f52dcSBoris Brezillon return -ENOMEM; 12166c4f52dcSBoris Brezillon 12176c4f52dcSBoris Brezillon dev->mode_config.tv_top_margin_property = 12186c4f52dcSBoris Brezillon drm_property_create_range(dev, 0, "top margin", 0, 100); 12196c4f52dcSBoris Brezillon if (!dev->mode_config.tv_top_margin_property) 12206c4f52dcSBoris Brezillon return -ENOMEM; 12216c4f52dcSBoris Brezillon 12226c4f52dcSBoris Brezillon dev->mode_config.tv_bottom_margin_property = 12236c4f52dcSBoris Brezillon drm_property_create_range(dev, 0, "bottom margin", 0, 100); 12246c4f52dcSBoris Brezillon if (!dev->mode_config.tv_bottom_margin_property) 12256c4f52dcSBoris Brezillon return -ENOMEM; 12266c4f52dcSBoris Brezillon 12276c4f52dcSBoris Brezillon return 0; 12286c4f52dcSBoris Brezillon } 12296c4f52dcSBoris Brezillon EXPORT_SYMBOL(drm_mode_create_tv_margin_properties); 12306c4f52dcSBoris Brezillon 12316c4f52dcSBoris Brezillon /** 1232eda6887fSBoris Brezillon * drm_mode_create_tv_properties - create TV specific connector properties 123352217195SDaniel Vetter * @dev: DRM device 123452217195SDaniel Vetter * @num_modes: number of different TV formats (modes) supported 123552217195SDaniel Vetter * @modes: array of pointers to strings containing name of each format 123652217195SDaniel Vetter * 123752217195SDaniel Vetter * Called by a driver's TV initialization routine, this function creates 123852217195SDaniel Vetter * the TV specific connector properties for a given device. Caller is 123952217195SDaniel Vetter * responsible for allocating a list of format names and passing them to 124052217195SDaniel Vetter * this routine. 124152217195SDaniel Vetter */ 124252217195SDaniel Vetter int drm_mode_create_tv_properties(struct drm_device *dev, 124352217195SDaniel Vetter unsigned int num_modes, 124452217195SDaniel Vetter const char * const modes[]) 124552217195SDaniel Vetter { 124652217195SDaniel Vetter struct drm_property *tv_selector; 124752217195SDaniel Vetter struct drm_property *tv_subconnector; 124852217195SDaniel Vetter unsigned int i; 124952217195SDaniel Vetter 125052217195SDaniel Vetter if (dev->mode_config.tv_select_subconnector_property) 125152217195SDaniel Vetter return 0; 125252217195SDaniel Vetter 125352217195SDaniel Vetter /* 125452217195SDaniel Vetter * Basic connector properties 125552217195SDaniel Vetter */ 125652217195SDaniel Vetter tv_selector = drm_property_create_enum(dev, 0, 125752217195SDaniel Vetter "select subconnector", 125852217195SDaniel Vetter drm_tv_select_enum_list, 125952217195SDaniel Vetter ARRAY_SIZE(drm_tv_select_enum_list)); 126052217195SDaniel Vetter if (!tv_selector) 126152217195SDaniel Vetter goto nomem; 126252217195SDaniel Vetter 126352217195SDaniel Vetter dev->mode_config.tv_select_subconnector_property = tv_selector; 126452217195SDaniel Vetter 126552217195SDaniel Vetter tv_subconnector = 126652217195SDaniel Vetter drm_property_create_enum(dev, DRM_MODE_PROP_IMMUTABLE, 126752217195SDaniel Vetter "subconnector", 126852217195SDaniel Vetter drm_tv_subconnector_enum_list, 126952217195SDaniel Vetter ARRAY_SIZE(drm_tv_subconnector_enum_list)); 127052217195SDaniel Vetter if (!tv_subconnector) 127152217195SDaniel Vetter goto nomem; 127252217195SDaniel Vetter dev->mode_config.tv_subconnector_property = tv_subconnector; 127352217195SDaniel Vetter 127452217195SDaniel Vetter /* 127552217195SDaniel Vetter * Other, TV specific properties: margins & TV modes. 127652217195SDaniel Vetter */ 12776c4f52dcSBoris Brezillon if (drm_mode_create_tv_margin_properties(dev)) 127852217195SDaniel Vetter goto nomem; 127952217195SDaniel Vetter 128052217195SDaniel Vetter dev->mode_config.tv_mode_property = 128152217195SDaniel Vetter drm_property_create(dev, DRM_MODE_PROP_ENUM, 128252217195SDaniel Vetter "mode", num_modes); 128352217195SDaniel Vetter if (!dev->mode_config.tv_mode_property) 128452217195SDaniel Vetter goto nomem; 128552217195SDaniel Vetter 128652217195SDaniel Vetter for (i = 0; i < num_modes; i++) 128730e9db6dSVille Syrjälä drm_property_add_enum(dev->mode_config.tv_mode_property, 128852217195SDaniel Vetter i, modes[i]); 128952217195SDaniel Vetter 129052217195SDaniel Vetter dev->mode_config.tv_brightness_property = 129152217195SDaniel Vetter drm_property_create_range(dev, 0, "brightness", 0, 100); 129252217195SDaniel Vetter if (!dev->mode_config.tv_brightness_property) 129352217195SDaniel Vetter goto nomem; 129452217195SDaniel Vetter 129552217195SDaniel Vetter dev->mode_config.tv_contrast_property = 129652217195SDaniel Vetter drm_property_create_range(dev, 0, "contrast", 0, 100); 129752217195SDaniel Vetter if (!dev->mode_config.tv_contrast_property) 129852217195SDaniel Vetter goto nomem; 129952217195SDaniel Vetter 130052217195SDaniel Vetter dev->mode_config.tv_flicker_reduction_property = 130152217195SDaniel Vetter drm_property_create_range(dev, 0, "flicker reduction", 0, 100); 130252217195SDaniel Vetter if (!dev->mode_config.tv_flicker_reduction_property) 130352217195SDaniel Vetter goto nomem; 130452217195SDaniel Vetter 130552217195SDaniel Vetter dev->mode_config.tv_overscan_property = 130652217195SDaniel Vetter drm_property_create_range(dev, 0, "overscan", 0, 100); 130752217195SDaniel Vetter if (!dev->mode_config.tv_overscan_property) 130852217195SDaniel Vetter goto nomem; 130952217195SDaniel Vetter 131052217195SDaniel Vetter dev->mode_config.tv_saturation_property = 131152217195SDaniel Vetter drm_property_create_range(dev, 0, "saturation", 0, 100); 131252217195SDaniel Vetter if (!dev->mode_config.tv_saturation_property) 131352217195SDaniel Vetter goto nomem; 131452217195SDaniel Vetter 131552217195SDaniel Vetter dev->mode_config.tv_hue_property = 131652217195SDaniel Vetter drm_property_create_range(dev, 0, "hue", 0, 100); 131752217195SDaniel Vetter if (!dev->mode_config.tv_hue_property) 131852217195SDaniel Vetter goto nomem; 131952217195SDaniel Vetter 132052217195SDaniel Vetter return 0; 132152217195SDaniel Vetter nomem: 132252217195SDaniel Vetter return -ENOMEM; 132352217195SDaniel Vetter } 132452217195SDaniel Vetter EXPORT_SYMBOL(drm_mode_create_tv_properties); 132552217195SDaniel Vetter 132652217195SDaniel Vetter /** 132752217195SDaniel Vetter * drm_mode_create_scaling_mode_property - create scaling mode property 132852217195SDaniel Vetter * @dev: DRM device 132952217195SDaniel Vetter * 133052217195SDaniel Vetter * Called by a driver the first time it's needed, must be attached to desired 133152217195SDaniel Vetter * connectors. 13328f6e1e22SMaarten Lankhorst * 13338f6e1e22SMaarten Lankhorst * Atomic drivers should use drm_connector_attach_scaling_mode_property() 13348f6e1e22SMaarten Lankhorst * instead to correctly assign &drm_connector_state.picture_aspect_ratio 13358f6e1e22SMaarten Lankhorst * in the atomic state. 133652217195SDaniel Vetter */ 133752217195SDaniel Vetter int drm_mode_create_scaling_mode_property(struct drm_device *dev) 133852217195SDaniel Vetter { 133952217195SDaniel Vetter struct drm_property *scaling_mode; 134052217195SDaniel Vetter 134152217195SDaniel Vetter if (dev->mode_config.scaling_mode_property) 134252217195SDaniel Vetter return 0; 134352217195SDaniel Vetter 134452217195SDaniel Vetter scaling_mode = 134552217195SDaniel Vetter drm_property_create_enum(dev, 0, "scaling mode", 134652217195SDaniel Vetter drm_scaling_mode_enum_list, 134752217195SDaniel Vetter ARRAY_SIZE(drm_scaling_mode_enum_list)); 134852217195SDaniel Vetter 134952217195SDaniel Vetter dev->mode_config.scaling_mode_property = scaling_mode; 135052217195SDaniel Vetter 135152217195SDaniel Vetter return 0; 135252217195SDaniel Vetter } 135352217195SDaniel Vetter EXPORT_SYMBOL(drm_mode_create_scaling_mode_property); 135452217195SDaniel Vetter 135552217195SDaniel Vetter /** 1356ab7a664fSNicholas Kazlauskas * DOC: Variable refresh properties 1357ab7a664fSNicholas Kazlauskas * 1358ab7a664fSNicholas Kazlauskas * Variable refresh rate capable displays can dynamically adjust their 1359ab7a664fSNicholas Kazlauskas * refresh rate by extending the duration of their vertical front porch 1360ab7a664fSNicholas Kazlauskas * until page flip or timeout occurs. This can reduce or remove stuttering 1361ab7a664fSNicholas Kazlauskas * and latency in scenarios where the page flip does not align with the 1362ab7a664fSNicholas Kazlauskas * vblank interval. 1363ab7a664fSNicholas Kazlauskas * 1364ab7a664fSNicholas Kazlauskas * An example scenario would be an application flipping at a constant rate 1365ab7a664fSNicholas Kazlauskas * of 48Hz on a 60Hz display. The page flip will frequently miss the vblank 1366ab7a664fSNicholas Kazlauskas * interval and the same contents will be displayed twice. This can be 1367ab7a664fSNicholas Kazlauskas * observed as stuttering for content with motion. 1368ab7a664fSNicholas Kazlauskas * 1369ab7a664fSNicholas Kazlauskas * If variable refresh rate was active on a display that supported a 1370ab7a664fSNicholas Kazlauskas * variable refresh range from 35Hz to 60Hz no stuttering would be observable 1371ab7a664fSNicholas Kazlauskas * for the example scenario. The minimum supported variable refresh rate of 1372ab7a664fSNicholas Kazlauskas * 35Hz is below the page flip frequency and the vertical front porch can 1373ab7a664fSNicholas Kazlauskas * be extended until the page flip occurs. The vblank interval will be 1374ab7a664fSNicholas Kazlauskas * directly aligned to the page flip rate. 1375ab7a664fSNicholas Kazlauskas * 1376ab7a664fSNicholas Kazlauskas * Not all userspace content is suitable for use with variable refresh rate. 1377ab7a664fSNicholas Kazlauskas * Large and frequent changes in vertical front porch duration may worsen 1378ab7a664fSNicholas Kazlauskas * perceived stuttering for input sensitive applications. 1379ab7a664fSNicholas Kazlauskas * 1380ab7a664fSNicholas Kazlauskas * Panel brightness will also vary with vertical front porch duration. Some 1381ab7a664fSNicholas Kazlauskas * panels may have noticeable differences in brightness between the minimum 1382ab7a664fSNicholas Kazlauskas * vertical front porch duration and the maximum vertical front porch duration. 1383ab7a664fSNicholas Kazlauskas * Large and frequent changes in vertical front porch duration may produce 1384ab7a664fSNicholas Kazlauskas * observable flickering for such panels. 1385ab7a664fSNicholas Kazlauskas * 1386ab7a664fSNicholas Kazlauskas * Userspace control for variable refresh rate is supported via properties 1387ab7a664fSNicholas Kazlauskas * on the &drm_connector and &drm_crtc objects. 1388ab7a664fSNicholas Kazlauskas * 1389ab7a664fSNicholas Kazlauskas * "vrr_capable": 1390ab7a664fSNicholas Kazlauskas * Optional &drm_connector boolean property that drivers should attach 1391ab7a664fSNicholas Kazlauskas * with drm_connector_attach_vrr_capable_property() on connectors that 1392ab7a664fSNicholas Kazlauskas * could support variable refresh rates. Drivers should update the 1393ab7a664fSNicholas Kazlauskas * property value by calling drm_connector_set_vrr_capable_property(). 1394ab7a664fSNicholas Kazlauskas * 1395ab7a664fSNicholas Kazlauskas * Absence of the property should indicate absence of support. 1396ab7a664fSNicholas Kazlauskas * 139777086014SDaniel Vetter * "VRR_ENABLED": 1398ab7a664fSNicholas Kazlauskas * Default &drm_crtc boolean property that notifies the driver that the 1399ab7a664fSNicholas Kazlauskas * content on the CRTC is suitable for variable refresh rate presentation. 1400ab7a664fSNicholas Kazlauskas * The driver will take this property as a hint to enable variable 1401ab7a664fSNicholas Kazlauskas * refresh rate support if the receiver supports it, ie. if the 1402ab7a664fSNicholas Kazlauskas * "vrr_capable" property is true on the &drm_connector object. The 1403ab7a664fSNicholas Kazlauskas * vertical front porch duration will be extended until page-flip or 1404ab7a664fSNicholas Kazlauskas * timeout when enabled. 1405ab7a664fSNicholas Kazlauskas * 1406ab7a664fSNicholas Kazlauskas * The minimum vertical front porch duration is defined as the vertical 1407ab7a664fSNicholas Kazlauskas * front porch duration for the current mode. 1408ab7a664fSNicholas Kazlauskas * 1409ab7a664fSNicholas Kazlauskas * The maximum vertical front porch duration is greater than or equal to 1410ab7a664fSNicholas Kazlauskas * the minimum vertical front porch duration. The duration is derived 1411ab7a664fSNicholas Kazlauskas * from the minimum supported variable refresh rate for the connector. 1412ab7a664fSNicholas Kazlauskas * 1413ab7a664fSNicholas Kazlauskas * The driver may place further restrictions within these minimum 1414ab7a664fSNicholas Kazlauskas * and maximum bounds. 1415ab7a664fSNicholas Kazlauskas * 1416ab7a664fSNicholas Kazlauskas * The semantics for the vertical blank timestamp differ when 1417ab7a664fSNicholas Kazlauskas * variable refresh rate is active. The vertical blank timestamp 1418ab7a664fSNicholas Kazlauskas * is defined to be an estimate using the current mode's fixed 1419ab7a664fSNicholas Kazlauskas * refresh rate timings. The semantics for the page-flip event 1420ab7a664fSNicholas Kazlauskas * timestamp remain the same. 1421ab7a664fSNicholas Kazlauskas */ 1422ab7a664fSNicholas Kazlauskas 1423ab7a664fSNicholas Kazlauskas /** 1424ba1b0f6cSNicholas Kazlauskas * drm_connector_attach_vrr_capable_property - creates the 1425ba1b0f6cSNicholas Kazlauskas * vrr_capable property 1426ba1b0f6cSNicholas Kazlauskas * @connector: connector to create the vrr_capable property on. 1427ba1b0f6cSNicholas Kazlauskas * 1428ba1b0f6cSNicholas Kazlauskas * This is used by atomic drivers to add support for querying 1429ba1b0f6cSNicholas Kazlauskas * variable refresh rate capability for a connector. 1430ba1b0f6cSNicholas Kazlauskas * 1431ba1b0f6cSNicholas Kazlauskas * Returns: 1432ba1b0f6cSNicholas Kazlauskas * Zero on success, negative errono on failure. 1433ba1b0f6cSNicholas Kazlauskas */ 1434ba1b0f6cSNicholas Kazlauskas int drm_connector_attach_vrr_capable_property( 1435ba1b0f6cSNicholas Kazlauskas struct drm_connector *connector) 1436ba1b0f6cSNicholas Kazlauskas { 1437ba1b0f6cSNicholas Kazlauskas struct drm_device *dev = connector->dev; 1438ba1b0f6cSNicholas Kazlauskas struct drm_property *prop; 1439ba1b0f6cSNicholas Kazlauskas 1440ba1b0f6cSNicholas Kazlauskas if (!connector->vrr_capable_property) { 1441ba1b0f6cSNicholas Kazlauskas prop = drm_property_create_bool(dev, DRM_MODE_PROP_IMMUTABLE, 1442ba1b0f6cSNicholas Kazlauskas "vrr_capable"); 1443ba1b0f6cSNicholas Kazlauskas if (!prop) 1444ba1b0f6cSNicholas Kazlauskas return -ENOMEM; 1445ba1b0f6cSNicholas Kazlauskas 1446ba1b0f6cSNicholas Kazlauskas connector->vrr_capable_property = prop; 1447ba1b0f6cSNicholas Kazlauskas drm_object_attach_property(&connector->base, prop, 0); 1448ba1b0f6cSNicholas Kazlauskas } 1449ba1b0f6cSNicholas Kazlauskas 1450ba1b0f6cSNicholas Kazlauskas return 0; 1451ba1b0f6cSNicholas Kazlauskas } 1452ba1b0f6cSNicholas Kazlauskas EXPORT_SYMBOL(drm_connector_attach_vrr_capable_property); 1453ba1b0f6cSNicholas Kazlauskas 1454ba1b0f6cSNicholas Kazlauskas /** 14558f6e1e22SMaarten Lankhorst * drm_connector_attach_scaling_mode_property - attach atomic scaling mode property 14568f6e1e22SMaarten Lankhorst * @connector: connector to attach scaling mode property on. 14578f6e1e22SMaarten Lankhorst * @scaling_mode_mask: or'ed mask of BIT(%DRM_MODE_SCALE_\*). 14588f6e1e22SMaarten Lankhorst * 14598f6e1e22SMaarten Lankhorst * This is used to add support for scaling mode to atomic drivers. 14608f6e1e22SMaarten Lankhorst * The scaling mode will be set to &drm_connector_state.picture_aspect_ratio 14618f6e1e22SMaarten Lankhorst * and can be used from &drm_connector_helper_funcs->atomic_check for validation. 14628f6e1e22SMaarten Lankhorst * 14638f6e1e22SMaarten Lankhorst * This is the atomic version of drm_mode_create_scaling_mode_property(). 14648f6e1e22SMaarten Lankhorst * 14658f6e1e22SMaarten Lankhorst * Returns: 14668f6e1e22SMaarten Lankhorst * Zero on success, negative errno on failure. 14678f6e1e22SMaarten Lankhorst */ 14688f6e1e22SMaarten Lankhorst int drm_connector_attach_scaling_mode_property(struct drm_connector *connector, 14698f6e1e22SMaarten Lankhorst u32 scaling_mode_mask) 14708f6e1e22SMaarten Lankhorst { 14718f6e1e22SMaarten Lankhorst struct drm_device *dev = connector->dev; 14728f6e1e22SMaarten Lankhorst struct drm_property *scaling_mode_property; 147330e9db6dSVille Syrjälä int i; 14748f6e1e22SMaarten Lankhorst const unsigned valid_scaling_mode_mask = 14758f6e1e22SMaarten Lankhorst (1U << ARRAY_SIZE(drm_scaling_mode_enum_list)) - 1; 14768f6e1e22SMaarten Lankhorst 14778f6e1e22SMaarten Lankhorst if (WARN_ON(hweight32(scaling_mode_mask) < 2 || 14788f6e1e22SMaarten Lankhorst scaling_mode_mask & ~valid_scaling_mode_mask)) 14798f6e1e22SMaarten Lankhorst return -EINVAL; 14808f6e1e22SMaarten Lankhorst 14818f6e1e22SMaarten Lankhorst scaling_mode_property = 14828f6e1e22SMaarten Lankhorst drm_property_create(dev, DRM_MODE_PROP_ENUM, "scaling mode", 14838f6e1e22SMaarten Lankhorst hweight32(scaling_mode_mask)); 14848f6e1e22SMaarten Lankhorst 14858f6e1e22SMaarten Lankhorst if (!scaling_mode_property) 14868f6e1e22SMaarten Lankhorst return -ENOMEM; 14878f6e1e22SMaarten Lankhorst 14888f6e1e22SMaarten Lankhorst for (i = 0; i < ARRAY_SIZE(drm_scaling_mode_enum_list); i++) { 14898f6e1e22SMaarten Lankhorst int ret; 14908f6e1e22SMaarten Lankhorst 14918f6e1e22SMaarten Lankhorst if (!(BIT(i) & scaling_mode_mask)) 14928f6e1e22SMaarten Lankhorst continue; 14938f6e1e22SMaarten Lankhorst 149430e9db6dSVille Syrjälä ret = drm_property_add_enum(scaling_mode_property, 14958f6e1e22SMaarten Lankhorst drm_scaling_mode_enum_list[i].type, 14968f6e1e22SMaarten Lankhorst drm_scaling_mode_enum_list[i].name); 14978f6e1e22SMaarten Lankhorst 14988f6e1e22SMaarten Lankhorst if (ret) { 14998f6e1e22SMaarten Lankhorst drm_property_destroy(dev, scaling_mode_property); 15008f6e1e22SMaarten Lankhorst 15018f6e1e22SMaarten Lankhorst return ret; 15028f6e1e22SMaarten Lankhorst } 15038f6e1e22SMaarten Lankhorst } 15048f6e1e22SMaarten Lankhorst 15058f6e1e22SMaarten Lankhorst drm_object_attach_property(&connector->base, 15068f6e1e22SMaarten Lankhorst scaling_mode_property, 0); 15078f6e1e22SMaarten Lankhorst 15088f6e1e22SMaarten Lankhorst connector->scaling_mode_property = scaling_mode_property; 15098f6e1e22SMaarten Lankhorst 15108f6e1e22SMaarten Lankhorst return 0; 15118f6e1e22SMaarten Lankhorst } 15128f6e1e22SMaarten Lankhorst EXPORT_SYMBOL(drm_connector_attach_scaling_mode_property); 15138f6e1e22SMaarten Lankhorst 15148f6e1e22SMaarten Lankhorst /** 151524557865SSean Paul * drm_connector_attach_content_protection_property - attach content protection 151624557865SSean Paul * property 151724557865SSean Paul * 151824557865SSean Paul * @connector: connector to attach CP property on. 151924557865SSean Paul * 152024557865SSean Paul * This is used to add support for content protection on select connectors. 152124557865SSean Paul * Content Protection is intentionally vague to allow for different underlying 152224557865SSean Paul * technologies, however it is most implemented by HDCP. 152324557865SSean Paul * 152424557865SSean Paul * The content protection will be set to &drm_connector_state.content_protection 152524557865SSean Paul * 152624557865SSean Paul * Returns: 152724557865SSean Paul * Zero on success, negative errno on failure. 152824557865SSean Paul */ 152924557865SSean Paul int drm_connector_attach_content_protection_property( 153024557865SSean Paul struct drm_connector *connector) 153124557865SSean Paul { 153224557865SSean Paul struct drm_device *dev = connector->dev; 153324557865SSean Paul struct drm_property *prop; 153424557865SSean Paul 153524557865SSean Paul prop = drm_property_create_enum(dev, 0, "Content Protection", 153624557865SSean Paul drm_cp_enum_list, 153724557865SSean Paul ARRAY_SIZE(drm_cp_enum_list)); 153824557865SSean Paul if (!prop) 153924557865SSean Paul return -ENOMEM; 154024557865SSean Paul 154124557865SSean Paul drm_object_attach_property(&connector->base, prop, 154224557865SSean Paul DRM_MODE_CONTENT_PROTECTION_UNDESIRED); 154324557865SSean Paul 154424557865SSean Paul connector->content_protection_property = prop; 154524557865SSean Paul 154624557865SSean Paul return 0; 154724557865SSean Paul } 154824557865SSean Paul EXPORT_SYMBOL(drm_connector_attach_content_protection_property); 154924557865SSean Paul 155024557865SSean Paul /** 155152217195SDaniel Vetter * drm_mode_create_aspect_ratio_property - create aspect ratio property 155252217195SDaniel Vetter * @dev: DRM device 155352217195SDaniel Vetter * 155452217195SDaniel Vetter * Called by a driver the first time it's needed, must be attached to desired 155552217195SDaniel Vetter * connectors. 155652217195SDaniel Vetter * 155752217195SDaniel Vetter * Returns: 155852217195SDaniel Vetter * Zero on success, negative errno on failure. 155952217195SDaniel Vetter */ 156052217195SDaniel Vetter int drm_mode_create_aspect_ratio_property(struct drm_device *dev) 156152217195SDaniel Vetter { 156252217195SDaniel Vetter if (dev->mode_config.aspect_ratio_property) 156352217195SDaniel Vetter return 0; 156452217195SDaniel Vetter 156552217195SDaniel Vetter dev->mode_config.aspect_ratio_property = 156652217195SDaniel Vetter drm_property_create_enum(dev, 0, "aspect ratio", 156752217195SDaniel Vetter drm_aspect_ratio_enum_list, 156852217195SDaniel Vetter ARRAY_SIZE(drm_aspect_ratio_enum_list)); 156952217195SDaniel Vetter 157052217195SDaniel Vetter if (dev->mode_config.aspect_ratio_property == NULL) 157152217195SDaniel Vetter return -ENOMEM; 157252217195SDaniel Vetter 157352217195SDaniel Vetter return 0; 157452217195SDaniel Vetter } 157552217195SDaniel Vetter EXPORT_SYMBOL(drm_mode_create_aspect_ratio_property); 157652217195SDaniel Vetter 157752217195SDaniel Vetter /** 1578*d2c6a405SUma Shankar * DOC: standard connector properties 1579*d2c6a405SUma Shankar * 1580*d2c6a405SUma Shankar * Colorspace: 1581*d2c6a405SUma Shankar * drm_mode_create_colorspace_property - create colorspace property 1582*d2c6a405SUma Shankar * This property helps select a suitable colorspace based on the sink 1583*d2c6a405SUma Shankar * capability. Modern sink devices support wider gamut like BT2020. 1584*d2c6a405SUma Shankar * This helps switch to BT2020 mode if the BT2020 encoded video stream 1585*d2c6a405SUma Shankar * is being played by the user, same for any other colorspace. Thereby 1586*d2c6a405SUma Shankar * giving a good visual experience to users. 1587*d2c6a405SUma Shankar * 1588*d2c6a405SUma Shankar * The expectation from userspace is that it should parse the EDID 1589*d2c6a405SUma Shankar * and get supported colorspaces. Use this property and switch to the 1590*d2c6a405SUma Shankar * one supported. Sink supported colorspaces should be retrieved by 1591*d2c6a405SUma Shankar * userspace from EDID and driver will not explicitly expose them. 1592*d2c6a405SUma Shankar * 1593*d2c6a405SUma Shankar * Basically the expectation from userspace is: 1594*d2c6a405SUma Shankar * - Set up CRTC DEGAMMA/CTM/GAMMA to convert to some sink 1595*d2c6a405SUma Shankar * colorspace 1596*d2c6a405SUma Shankar * - Set this new property to let the sink know what it 1597*d2c6a405SUma Shankar * converted the CRTC output to. 1598*d2c6a405SUma Shankar * - This property is just to inform sink what colorspace 1599*d2c6a405SUma Shankar * source is trying to drive. 1600*d2c6a405SUma Shankar * 1601*d2c6a405SUma Shankar * Called by a driver the first time it's needed, must be attached to desired 1602*d2c6a405SUma Shankar * connectors. 1603*d2c6a405SUma Shankar */ 1604*d2c6a405SUma Shankar int drm_mode_create_colorspace_property(struct drm_connector *connector) 1605*d2c6a405SUma Shankar { 1606*d2c6a405SUma Shankar struct drm_device *dev = connector->dev; 1607*d2c6a405SUma Shankar struct drm_property *prop; 1608*d2c6a405SUma Shankar 1609*d2c6a405SUma Shankar if (connector->connector_type == DRM_MODE_CONNECTOR_HDMIA || 1610*d2c6a405SUma Shankar connector->connector_type == DRM_MODE_CONNECTOR_HDMIB) { 1611*d2c6a405SUma Shankar prop = drm_property_create_enum(dev, DRM_MODE_PROP_ENUM, 1612*d2c6a405SUma Shankar "Colorspace", 1613*d2c6a405SUma Shankar hdmi_colorspaces, 1614*d2c6a405SUma Shankar ARRAY_SIZE(hdmi_colorspaces)); 1615*d2c6a405SUma Shankar if (!prop) 1616*d2c6a405SUma Shankar return -ENOMEM; 1617*d2c6a405SUma Shankar } else { 1618*d2c6a405SUma Shankar DRM_DEBUG_KMS("Colorspace property not supported\n"); 1619*d2c6a405SUma Shankar return 0; 1620*d2c6a405SUma Shankar } 1621*d2c6a405SUma Shankar 1622*d2c6a405SUma Shankar connector->colorspace_property = prop; 1623*d2c6a405SUma Shankar 1624*d2c6a405SUma Shankar return 0; 1625*d2c6a405SUma Shankar } 1626*d2c6a405SUma Shankar EXPORT_SYMBOL(drm_mode_create_colorspace_property); 1627*d2c6a405SUma Shankar 1628*d2c6a405SUma Shankar /** 162950525c33SStanislav Lisovskiy * drm_mode_create_content_type_property - create content type property 163050525c33SStanislav Lisovskiy * @dev: DRM device 163150525c33SStanislav Lisovskiy * 163250525c33SStanislav Lisovskiy * Called by a driver the first time it's needed, must be attached to desired 163350525c33SStanislav Lisovskiy * connectors. 163450525c33SStanislav Lisovskiy * 163550525c33SStanislav Lisovskiy * Returns: 163650525c33SStanislav Lisovskiy * Zero on success, negative errno on failure. 163750525c33SStanislav Lisovskiy */ 163850525c33SStanislav Lisovskiy int drm_mode_create_content_type_property(struct drm_device *dev) 163950525c33SStanislav Lisovskiy { 164050525c33SStanislav Lisovskiy if (dev->mode_config.content_type_property) 164150525c33SStanislav Lisovskiy return 0; 164250525c33SStanislav Lisovskiy 164350525c33SStanislav Lisovskiy dev->mode_config.content_type_property = 164450525c33SStanislav Lisovskiy drm_property_create_enum(dev, 0, "content type", 164550525c33SStanislav Lisovskiy drm_content_type_enum_list, 164650525c33SStanislav Lisovskiy ARRAY_SIZE(drm_content_type_enum_list)); 164750525c33SStanislav Lisovskiy 164850525c33SStanislav Lisovskiy if (dev->mode_config.content_type_property == NULL) 164950525c33SStanislav Lisovskiy return -ENOMEM; 165050525c33SStanislav Lisovskiy 165150525c33SStanislav Lisovskiy return 0; 165250525c33SStanislav Lisovskiy } 165350525c33SStanislav Lisovskiy EXPORT_SYMBOL(drm_mode_create_content_type_property); 165450525c33SStanislav Lisovskiy 165550525c33SStanislav Lisovskiy /** 165652217195SDaniel Vetter * drm_mode_create_suggested_offset_properties - create suggests offset properties 165752217195SDaniel Vetter * @dev: DRM device 165852217195SDaniel Vetter * 165952217195SDaniel Vetter * Create the the suggested x/y offset property for connectors. 166052217195SDaniel Vetter */ 166152217195SDaniel Vetter int drm_mode_create_suggested_offset_properties(struct drm_device *dev) 166252217195SDaniel Vetter { 166352217195SDaniel Vetter if (dev->mode_config.suggested_x_property && dev->mode_config.suggested_y_property) 166452217195SDaniel Vetter return 0; 166552217195SDaniel Vetter 166652217195SDaniel Vetter dev->mode_config.suggested_x_property = 166752217195SDaniel Vetter drm_property_create_range(dev, DRM_MODE_PROP_IMMUTABLE, "suggested X", 0, 0xffffffff); 166852217195SDaniel Vetter 166952217195SDaniel Vetter dev->mode_config.suggested_y_property = 167052217195SDaniel Vetter drm_property_create_range(dev, DRM_MODE_PROP_IMMUTABLE, "suggested Y", 0, 0xffffffff); 167152217195SDaniel Vetter 167252217195SDaniel Vetter if (dev->mode_config.suggested_x_property == NULL || 167352217195SDaniel Vetter dev->mode_config.suggested_y_property == NULL) 167452217195SDaniel Vetter return -ENOMEM; 167552217195SDaniel Vetter return 0; 167652217195SDaniel Vetter } 167752217195SDaniel Vetter EXPORT_SYMBOL(drm_mode_create_suggested_offset_properties); 167852217195SDaniel Vetter 167952217195SDaniel Vetter /** 168097e14fbeSDaniel Vetter * drm_connector_set_path_property - set tile property on connector 168152217195SDaniel Vetter * @connector: connector to set property on. 168252217195SDaniel Vetter * @path: path to use for property; must not be NULL. 168352217195SDaniel Vetter * 168452217195SDaniel Vetter * This creates a property to expose to userspace to specify a 168552217195SDaniel Vetter * connector path. This is mainly used for DisplayPort MST where 168652217195SDaniel Vetter * connectors have a topology and we want to allow userspace to give 168752217195SDaniel Vetter * them more meaningful names. 168852217195SDaniel Vetter * 168952217195SDaniel Vetter * Returns: 169052217195SDaniel Vetter * Zero on success, negative errno on failure. 169152217195SDaniel Vetter */ 169297e14fbeSDaniel Vetter int drm_connector_set_path_property(struct drm_connector *connector, 169352217195SDaniel Vetter const char *path) 169452217195SDaniel Vetter { 169552217195SDaniel Vetter struct drm_device *dev = connector->dev; 169652217195SDaniel Vetter int ret; 169752217195SDaniel Vetter 169852217195SDaniel Vetter ret = drm_property_replace_global_blob(dev, 169952217195SDaniel Vetter &connector->path_blob_ptr, 170052217195SDaniel Vetter strlen(path) + 1, 170152217195SDaniel Vetter path, 170252217195SDaniel Vetter &connector->base, 170352217195SDaniel Vetter dev->mode_config.path_property); 170452217195SDaniel Vetter return ret; 170552217195SDaniel Vetter } 170697e14fbeSDaniel Vetter EXPORT_SYMBOL(drm_connector_set_path_property); 170752217195SDaniel Vetter 170852217195SDaniel Vetter /** 170997e14fbeSDaniel Vetter * drm_connector_set_tile_property - set tile property on connector 171052217195SDaniel Vetter * @connector: connector to set property on. 171152217195SDaniel Vetter * 171252217195SDaniel Vetter * This looks up the tile information for a connector, and creates a 171352217195SDaniel Vetter * property for userspace to parse if it exists. The property is of 171452217195SDaniel Vetter * the form of 8 integers using ':' as a separator. 171552217195SDaniel Vetter * 171652217195SDaniel Vetter * Returns: 171752217195SDaniel Vetter * Zero on success, errno on failure. 171852217195SDaniel Vetter */ 171997e14fbeSDaniel Vetter int drm_connector_set_tile_property(struct drm_connector *connector) 172052217195SDaniel Vetter { 172152217195SDaniel Vetter struct drm_device *dev = connector->dev; 172252217195SDaniel Vetter char tile[256]; 172352217195SDaniel Vetter int ret; 172452217195SDaniel Vetter 172552217195SDaniel Vetter if (!connector->has_tile) { 172652217195SDaniel Vetter ret = drm_property_replace_global_blob(dev, 172752217195SDaniel Vetter &connector->tile_blob_ptr, 172852217195SDaniel Vetter 0, 172952217195SDaniel Vetter NULL, 173052217195SDaniel Vetter &connector->base, 173152217195SDaniel Vetter dev->mode_config.tile_property); 173252217195SDaniel Vetter return ret; 173352217195SDaniel Vetter } 173452217195SDaniel Vetter 173552217195SDaniel Vetter snprintf(tile, 256, "%d:%d:%d:%d:%d:%d:%d:%d", 173652217195SDaniel Vetter connector->tile_group->id, connector->tile_is_single_monitor, 173752217195SDaniel Vetter connector->num_h_tile, connector->num_v_tile, 173852217195SDaniel Vetter connector->tile_h_loc, connector->tile_v_loc, 173952217195SDaniel Vetter connector->tile_h_size, connector->tile_v_size); 174052217195SDaniel Vetter 174152217195SDaniel Vetter ret = drm_property_replace_global_blob(dev, 174252217195SDaniel Vetter &connector->tile_blob_ptr, 174352217195SDaniel Vetter strlen(tile) + 1, 174452217195SDaniel Vetter tile, 174552217195SDaniel Vetter &connector->base, 174652217195SDaniel Vetter dev->mode_config.tile_property); 174752217195SDaniel Vetter return ret; 174852217195SDaniel Vetter } 174997e14fbeSDaniel Vetter EXPORT_SYMBOL(drm_connector_set_tile_property); 175052217195SDaniel Vetter 175152217195SDaniel Vetter /** 1752c555f023SDaniel Vetter * drm_connector_update_edid_property - update the edid property of a connector 175352217195SDaniel Vetter * @connector: drm connector 175452217195SDaniel Vetter * @edid: new value of the edid property 175552217195SDaniel Vetter * 175652217195SDaniel Vetter * This function creates a new blob modeset object and assigns its id to the 175752217195SDaniel Vetter * connector's edid property. 175852217195SDaniel Vetter * 175952217195SDaniel Vetter * Returns: 176052217195SDaniel Vetter * Zero on success, negative errno on failure. 176152217195SDaniel Vetter */ 1762c555f023SDaniel Vetter int drm_connector_update_edid_property(struct drm_connector *connector, 176352217195SDaniel Vetter const struct edid *edid) 176452217195SDaniel Vetter { 176552217195SDaniel Vetter struct drm_device *dev = connector->dev; 176652217195SDaniel Vetter size_t size = 0; 176752217195SDaniel Vetter int ret; 176852217195SDaniel Vetter 176952217195SDaniel Vetter /* ignore requests to set edid when overridden */ 177052217195SDaniel Vetter if (connector->override_edid) 177152217195SDaniel Vetter return 0; 177252217195SDaniel Vetter 177352217195SDaniel Vetter if (edid) 177452217195SDaniel Vetter size = EDID_LENGTH * (1 + edid->extensions); 177552217195SDaniel Vetter 1776170178feSKeith Packard /* Set the display info, using edid if available, otherwise 1777170178feSKeith Packard * reseting the values to defaults. This duplicates the work 1778170178feSKeith Packard * done in drm_add_edid_modes, but that function is not 1779170178feSKeith Packard * consistently called before this one in all drivers and the 1780170178feSKeith Packard * computation is cheap enough that it seems better to 1781170178feSKeith Packard * duplicate it rather than attempt to ensure some arbitrary 1782170178feSKeith Packard * ordering of calls. 1783170178feSKeith Packard */ 1784170178feSKeith Packard if (edid) 1785170178feSKeith Packard drm_add_display_info(connector, edid); 1786170178feSKeith Packard else 1787170178feSKeith Packard drm_reset_display_info(connector); 1788170178feSKeith Packard 178966660d4cSDave Airlie drm_object_property_set_value(&connector->base, 179066660d4cSDave Airlie dev->mode_config.non_desktop_property, 179166660d4cSDave Airlie connector->display_info.non_desktop); 179266660d4cSDave Airlie 179352217195SDaniel Vetter ret = drm_property_replace_global_blob(dev, 179452217195SDaniel Vetter &connector->edid_blob_ptr, 179552217195SDaniel Vetter size, 179652217195SDaniel Vetter edid, 179752217195SDaniel Vetter &connector->base, 179852217195SDaniel Vetter dev->mode_config.edid_property); 179952217195SDaniel Vetter return ret; 180052217195SDaniel Vetter } 1801c555f023SDaniel Vetter EXPORT_SYMBOL(drm_connector_update_edid_property); 180252217195SDaniel Vetter 180340ee6fbeSManasi Navare /** 180497e14fbeSDaniel Vetter * drm_connector_set_link_status_property - Set link status property of a connector 180540ee6fbeSManasi Navare * @connector: drm connector 180640ee6fbeSManasi Navare * @link_status: new value of link status property (0: Good, 1: Bad) 180740ee6fbeSManasi Navare * 180840ee6fbeSManasi Navare * In usual working scenario, this link status property will always be set to 180940ee6fbeSManasi Navare * "GOOD". If something fails during or after a mode set, the kernel driver 181040ee6fbeSManasi Navare * may set this link status property to "BAD". The caller then needs to send a 181140ee6fbeSManasi Navare * hotplug uevent for userspace to re-check the valid modes through 181240ee6fbeSManasi Navare * GET_CONNECTOR_IOCTL and retry modeset. 181340ee6fbeSManasi Navare * 181440ee6fbeSManasi Navare * Note: Drivers cannot rely on userspace to support this property and 181540ee6fbeSManasi Navare * issue a modeset. As such, they may choose to handle issues (like 181640ee6fbeSManasi Navare * re-training a link) without userspace's intervention. 181740ee6fbeSManasi Navare * 181840ee6fbeSManasi Navare * The reason for adding this property is to handle link training failures, but 181940ee6fbeSManasi Navare * it is not limited to DP or link training. For example, if we implement 182040ee6fbeSManasi Navare * asynchronous setcrtc, this property can be used to report any failures in that. 182140ee6fbeSManasi Navare */ 182297e14fbeSDaniel Vetter void drm_connector_set_link_status_property(struct drm_connector *connector, 182340ee6fbeSManasi Navare uint64_t link_status) 182440ee6fbeSManasi Navare { 182540ee6fbeSManasi Navare struct drm_device *dev = connector->dev; 182640ee6fbeSManasi Navare 182740ee6fbeSManasi Navare drm_modeset_lock(&dev->mode_config.connection_mutex, NULL); 182840ee6fbeSManasi Navare connector->state->link_status = link_status; 182940ee6fbeSManasi Navare drm_modeset_unlock(&dev->mode_config.connection_mutex); 183040ee6fbeSManasi Navare } 183197e14fbeSDaniel Vetter EXPORT_SYMBOL(drm_connector_set_link_status_property); 183240ee6fbeSManasi Navare 18338d70f395SHans de Goede /** 183447e22ff1SRadhakrishna Sripada * drm_connector_attach_max_bpc_property - attach "max bpc" property 183547e22ff1SRadhakrishna Sripada * @connector: connector to attach max bpc property on. 183647e22ff1SRadhakrishna Sripada * @min: The minimum bit depth supported by the connector. 183747e22ff1SRadhakrishna Sripada * @max: The maximum bit depth supported by the connector. 183847e22ff1SRadhakrishna Sripada * 183947e22ff1SRadhakrishna Sripada * This is used to add support for limiting the bit depth on a connector. 184047e22ff1SRadhakrishna Sripada * 184147e22ff1SRadhakrishna Sripada * Returns: 184247e22ff1SRadhakrishna Sripada * Zero on success, negative errno on failure. 184347e22ff1SRadhakrishna Sripada */ 184447e22ff1SRadhakrishna Sripada int drm_connector_attach_max_bpc_property(struct drm_connector *connector, 184547e22ff1SRadhakrishna Sripada int min, int max) 184647e22ff1SRadhakrishna Sripada { 184747e22ff1SRadhakrishna Sripada struct drm_device *dev = connector->dev; 184847e22ff1SRadhakrishna Sripada struct drm_property *prop; 184947e22ff1SRadhakrishna Sripada 185047e22ff1SRadhakrishna Sripada prop = connector->max_bpc_property; 185147e22ff1SRadhakrishna Sripada if (!prop) { 185247e22ff1SRadhakrishna Sripada prop = drm_property_create_range(dev, 0, "max bpc", min, max); 185347e22ff1SRadhakrishna Sripada if (!prop) 185447e22ff1SRadhakrishna Sripada return -ENOMEM; 185547e22ff1SRadhakrishna Sripada 185647e22ff1SRadhakrishna Sripada connector->max_bpc_property = prop; 185747e22ff1SRadhakrishna Sripada } 185847e22ff1SRadhakrishna Sripada 185947e22ff1SRadhakrishna Sripada drm_object_attach_property(&connector->base, prop, max); 186047e22ff1SRadhakrishna Sripada connector->state->max_requested_bpc = max; 186147e22ff1SRadhakrishna Sripada connector->state->max_bpc = max; 186247e22ff1SRadhakrishna Sripada 186347e22ff1SRadhakrishna Sripada return 0; 186447e22ff1SRadhakrishna Sripada } 186547e22ff1SRadhakrishna Sripada EXPORT_SYMBOL(drm_connector_attach_max_bpc_property); 186647e22ff1SRadhakrishna Sripada 186747e22ff1SRadhakrishna Sripada /** 1868ba1b0f6cSNicholas Kazlauskas * drm_connector_set_vrr_capable_property - sets the variable refresh rate 1869ba1b0f6cSNicholas Kazlauskas * capable property for a connector 1870ba1b0f6cSNicholas Kazlauskas * @connector: drm connector 1871ba1b0f6cSNicholas Kazlauskas * @capable: True if the connector is variable refresh rate capable 1872ba1b0f6cSNicholas Kazlauskas * 1873ba1b0f6cSNicholas Kazlauskas * Should be used by atomic drivers to update the indicated support for 1874ba1b0f6cSNicholas Kazlauskas * variable refresh rate over a connector. 1875ba1b0f6cSNicholas Kazlauskas */ 1876ba1b0f6cSNicholas Kazlauskas void drm_connector_set_vrr_capable_property( 1877ba1b0f6cSNicholas Kazlauskas struct drm_connector *connector, bool capable) 1878ba1b0f6cSNicholas Kazlauskas { 1879ba1b0f6cSNicholas Kazlauskas drm_object_property_set_value(&connector->base, 1880ba1b0f6cSNicholas Kazlauskas connector->vrr_capable_property, 1881ba1b0f6cSNicholas Kazlauskas capable); 1882ba1b0f6cSNicholas Kazlauskas } 1883ba1b0f6cSNicholas Kazlauskas EXPORT_SYMBOL(drm_connector_set_vrr_capable_property); 1884ba1b0f6cSNicholas Kazlauskas 1885ba1b0f6cSNicholas Kazlauskas /** 18868d70f395SHans de Goede * drm_connector_init_panel_orientation_property - 18878d70f395SHans de Goede * initialize the connecters panel_orientation property 18888d70f395SHans de Goede * @connector: connector for which to init the panel-orientation property. 18898d70f395SHans de Goede * @width: width in pixels of the panel, used for panel quirk detection 18908d70f395SHans de Goede * @height: height in pixels of the panel, used for panel quirk detection 18918d70f395SHans de Goede * 18928d70f395SHans de Goede * This function should only be called for built-in panels, after setting 18938d70f395SHans de Goede * connector->display_info.panel_orientation first (if known). 18948d70f395SHans de Goede * 18958d70f395SHans de Goede * This function will check for platform specific (e.g. DMI based) quirks 18968d70f395SHans de Goede * overriding display_info.panel_orientation first, then if panel_orientation 18978d70f395SHans de Goede * is not DRM_MODE_PANEL_ORIENTATION_UNKNOWN it will attach the 18988d70f395SHans de Goede * "panel orientation" property to the connector. 18998d70f395SHans de Goede * 19008d70f395SHans de Goede * Returns: 19018d70f395SHans de Goede * Zero on success, negative errno on failure. 19028d70f395SHans de Goede */ 19038d70f395SHans de Goede int drm_connector_init_panel_orientation_property( 19048d70f395SHans de Goede struct drm_connector *connector, int width, int height) 19058d70f395SHans de Goede { 19068d70f395SHans de Goede struct drm_device *dev = connector->dev; 19078d70f395SHans de Goede struct drm_display_info *info = &connector->display_info; 19088d70f395SHans de Goede struct drm_property *prop; 19098d70f395SHans de Goede int orientation_quirk; 19108d70f395SHans de Goede 19118d70f395SHans de Goede orientation_quirk = drm_get_panel_orientation_quirk(width, height); 19128d70f395SHans de Goede if (orientation_quirk != DRM_MODE_PANEL_ORIENTATION_UNKNOWN) 19138d70f395SHans de Goede info->panel_orientation = orientation_quirk; 19148d70f395SHans de Goede 19158d70f395SHans de Goede if (info->panel_orientation == DRM_MODE_PANEL_ORIENTATION_UNKNOWN) 19168d70f395SHans de Goede return 0; 19178d70f395SHans de Goede 19188d70f395SHans de Goede prop = dev->mode_config.panel_orientation_property; 19198d70f395SHans de Goede if (!prop) { 19208d70f395SHans de Goede prop = drm_property_create_enum(dev, DRM_MODE_PROP_IMMUTABLE, 19218d70f395SHans de Goede "panel orientation", 19228d70f395SHans de Goede drm_panel_orientation_enum_list, 19238d70f395SHans de Goede ARRAY_SIZE(drm_panel_orientation_enum_list)); 19248d70f395SHans de Goede if (!prop) 19258d70f395SHans de Goede return -ENOMEM; 19268d70f395SHans de Goede 19278d70f395SHans de Goede dev->mode_config.panel_orientation_property = prop; 19288d70f395SHans de Goede } 19298d70f395SHans de Goede 19308d70f395SHans de Goede drm_object_attach_property(&connector->base, prop, 19318d70f395SHans de Goede info->panel_orientation); 19328d70f395SHans de Goede return 0; 19338d70f395SHans de Goede } 19348d70f395SHans de Goede EXPORT_SYMBOL(drm_connector_init_panel_orientation_property); 19358d70f395SHans de Goede 193697e14fbeSDaniel Vetter int drm_connector_set_obj_prop(struct drm_mode_object *obj, 193752217195SDaniel Vetter struct drm_property *property, 193852217195SDaniel Vetter uint64_t value) 193952217195SDaniel Vetter { 194052217195SDaniel Vetter int ret = -EINVAL; 194152217195SDaniel Vetter struct drm_connector *connector = obj_to_connector(obj); 194252217195SDaniel Vetter 194352217195SDaniel Vetter /* Do DPMS ourselves */ 194452217195SDaniel Vetter if (property == connector->dev->mode_config.dpms_property) { 194552217195SDaniel Vetter ret = (*connector->funcs->dpms)(connector, (int)value); 194652217195SDaniel Vetter } else if (connector->funcs->set_property) 194752217195SDaniel Vetter ret = connector->funcs->set_property(connector, property, value); 194852217195SDaniel Vetter 1949144a7999SDaniel Vetter if (!ret) 195052217195SDaniel Vetter drm_object_property_set_value(&connector->base, property, value); 195152217195SDaniel Vetter return ret; 195252217195SDaniel Vetter } 195352217195SDaniel Vetter 195497e14fbeSDaniel Vetter int drm_connector_property_set_ioctl(struct drm_device *dev, 195552217195SDaniel Vetter void *data, struct drm_file *file_priv) 195652217195SDaniel Vetter { 195752217195SDaniel Vetter struct drm_mode_connector_set_property *conn_set_prop = data; 195852217195SDaniel Vetter struct drm_mode_obj_set_property obj_set_prop = { 195952217195SDaniel Vetter .value = conn_set_prop->value, 196052217195SDaniel Vetter .prop_id = conn_set_prop->prop_id, 196152217195SDaniel Vetter .obj_id = conn_set_prop->connector_id, 196252217195SDaniel Vetter .obj_type = DRM_MODE_OBJECT_CONNECTOR 196352217195SDaniel Vetter }; 196452217195SDaniel Vetter 196552217195SDaniel Vetter /* It does all the locking and checking we need */ 196652217195SDaniel Vetter return drm_mode_obj_set_property_ioctl(dev, &obj_set_prop, file_priv); 196752217195SDaniel Vetter } 196852217195SDaniel Vetter 196952217195SDaniel Vetter static struct drm_encoder *drm_connector_get_encoder(struct drm_connector *connector) 197052217195SDaniel Vetter { 197152217195SDaniel Vetter /* For atomic drivers only state objects are synchronously updated and 197252217195SDaniel Vetter * protected by modeset locks, so check those first. */ 197352217195SDaniel Vetter if (connector->state) 197452217195SDaniel Vetter return connector->state->best_encoder; 197552217195SDaniel Vetter return connector->encoder; 197652217195SDaniel Vetter } 197752217195SDaniel Vetter 1978c3ff0cdbSAnkit Nautiyal static bool 1979c3ff0cdbSAnkit Nautiyal drm_mode_expose_to_userspace(const struct drm_display_mode *mode, 1980c3ff0cdbSAnkit Nautiyal const struct list_head *export_list, 198152217195SDaniel Vetter const struct drm_file *file_priv) 198252217195SDaniel Vetter { 198352217195SDaniel Vetter /* 198452217195SDaniel Vetter * If user-space hasn't configured the driver to expose the stereo 3D 198552217195SDaniel Vetter * modes, don't expose them. 198652217195SDaniel Vetter */ 198752217195SDaniel Vetter if (!file_priv->stereo_allowed && drm_mode_is_stereo(mode)) 198852217195SDaniel Vetter return false; 1989c3ff0cdbSAnkit Nautiyal /* 1990c3ff0cdbSAnkit Nautiyal * If user-space hasn't configured the driver to expose the modes 1991c3ff0cdbSAnkit Nautiyal * with aspect-ratio, don't expose them. However if such a mode 1992c3ff0cdbSAnkit Nautiyal * is unique, let it be exposed, but reset the aspect-ratio flags 1993c3ff0cdbSAnkit Nautiyal * while preparing the list of user-modes. 1994c3ff0cdbSAnkit Nautiyal */ 1995c3ff0cdbSAnkit Nautiyal if (!file_priv->aspect_ratio_allowed) { 1996c3ff0cdbSAnkit Nautiyal struct drm_display_mode *mode_itr; 1997c3ff0cdbSAnkit Nautiyal 1998c3ff0cdbSAnkit Nautiyal list_for_each_entry(mode_itr, export_list, export_head) 1999c3ff0cdbSAnkit Nautiyal if (drm_mode_match(mode_itr, mode, 2000c3ff0cdbSAnkit Nautiyal DRM_MODE_MATCH_TIMINGS | 2001c3ff0cdbSAnkit Nautiyal DRM_MODE_MATCH_CLOCK | 2002c3ff0cdbSAnkit Nautiyal DRM_MODE_MATCH_FLAGS | 2003c3ff0cdbSAnkit Nautiyal DRM_MODE_MATCH_3D_FLAGS)) 2004c3ff0cdbSAnkit Nautiyal return false; 2005c3ff0cdbSAnkit Nautiyal } 200652217195SDaniel Vetter 200752217195SDaniel Vetter return true; 200852217195SDaniel Vetter } 200952217195SDaniel Vetter 201052217195SDaniel Vetter int drm_mode_getconnector(struct drm_device *dev, void *data, 201152217195SDaniel Vetter struct drm_file *file_priv) 201252217195SDaniel Vetter { 201352217195SDaniel Vetter struct drm_mode_get_connector *out_resp = data; 201452217195SDaniel Vetter struct drm_connector *connector; 201552217195SDaniel Vetter struct drm_encoder *encoder; 201652217195SDaniel Vetter struct drm_display_mode *mode; 201752217195SDaniel Vetter int mode_count = 0; 201852217195SDaniel Vetter int encoders_count = 0; 201952217195SDaniel Vetter int ret = 0; 202052217195SDaniel Vetter int copied = 0; 202152217195SDaniel Vetter int i; 202252217195SDaniel Vetter struct drm_mode_modeinfo u_mode; 202352217195SDaniel Vetter struct drm_mode_modeinfo __user *mode_ptr; 202452217195SDaniel Vetter uint32_t __user *encoder_ptr; 2025c3ff0cdbSAnkit Nautiyal LIST_HEAD(export_list); 202652217195SDaniel Vetter 202752217195SDaniel Vetter if (!drm_core_check_feature(dev, DRIVER_MODESET)) 202869fdf420SChris Wilson return -EOPNOTSUPP; 202952217195SDaniel Vetter 203052217195SDaniel Vetter memset(&u_mode, 0, sizeof(struct drm_mode_modeinfo)); 203152217195SDaniel Vetter 2032418da172SKeith Packard connector = drm_connector_lookup(dev, file_priv, out_resp->connector_id); 203391eefc05SDaniel Vetter if (!connector) 203491eefc05SDaniel Vetter return -ENOENT; 203552217195SDaniel Vetter 203683aefbb8SVille Syrjälä drm_connector_for_each_possible_encoder(connector, encoder, i) 203791eefc05SDaniel Vetter encoders_count++; 203891eefc05SDaniel Vetter 203991eefc05SDaniel Vetter if ((out_resp->count_encoders >= encoders_count) && encoders_count) { 204091eefc05SDaniel Vetter copied = 0; 204191eefc05SDaniel Vetter encoder_ptr = (uint32_t __user *)(unsigned long)(out_resp->encoders_ptr); 204283aefbb8SVille Syrjälä 204383aefbb8SVille Syrjälä drm_connector_for_each_possible_encoder(connector, encoder, i) { 204483aefbb8SVille Syrjälä if (put_user(encoder->base.id, encoder_ptr + copied)) { 204591eefc05SDaniel Vetter ret = -EFAULT; 2046e94ac351SDaniel Vetter goto out; 204791eefc05SDaniel Vetter } 204891eefc05SDaniel Vetter copied++; 204991eefc05SDaniel Vetter } 205091eefc05SDaniel Vetter } 205191eefc05SDaniel Vetter out_resp->count_encoders = encoders_count; 205291eefc05SDaniel Vetter 205391eefc05SDaniel Vetter out_resp->connector_id = connector->base.id; 205491eefc05SDaniel Vetter out_resp->connector_type = connector->connector_type; 205591eefc05SDaniel Vetter out_resp->connector_type_id = connector->connector_type_id; 205691eefc05SDaniel Vetter 205791eefc05SDaniel Vetter mutex_lock(&dev->mode_config.mutex); 205891eefc05SDaniel Vetter if (out_resp->count_modes == 0) { 205991eefc05SDaniel Vetter connector->funcs->fill_modes(connector, 206091eefc05SDaniel Vetter dev->mode_config.max_width, 206191eefc05SDaniel Vetter dev->mode_config.max_height); 206291eefc05SDaniel Vetter } 206391eefc05SDaniel Vetter 206491eefc05SDaniel Vetter out_resp->mm_width = connector->display_info.width_mm; 206591eefc05SDaniel Vetter out_resp->mm_height = connector->display_info.height_mm; 206691eefc05SDaniel Vetter out_resp->subpixel = connector->display_info.subpixel_order; 206791eefc05SDaniel Vetter out_resp->connection = connector->status; 206891eefc05SDaniel Vetter 206991eefc05SDaniel Vetter /* delayed so we get modes regardless of pre-fill_modes state */ 207091eefc05SDaniel Vetter list_for_each_entry(mode, &connector->modes, head) 2071c3ff0cdbSAnkit Nautiyal if (drm_mode_expose_to_userspace(mode, &export_list, 2072c3ff0cdbSAnkit Nautiyal file_priv)) { 2073c3ff0cdbSAnkit Nautiyal list_add_tail(&mode->export_head, &export_list); 207491eefc05SDaniel Vetter mode_count++; 2075c3ff0cdbSAnkit Nautiyal } 207691eefc05SDaniel Vetter 207752217195SDaniel Vetter /* 207852217195SDaniel Vetter * This ioctl is called twice, once to determine how much space is 207952217195SDaniel Vetter * needed, and the 2nd time to fill it. 2080c3ff0cdbSAnkit Nautiyal * The modes that need to be exposed to the user are maintained in the 2081c3ff0cdbSAnkit Nautiyal * 'export_list'. When the ioctl is called first time to determine the, 2082c3ff0cdbSAnkit Nautiyal * space, the export_list gets filled, to find the no.of modes. In the 2083c3ff0cdbSAnkit Nautiyal * 2nd time, the user modes are filled, one by one from the export_list. 208452217195SDaniel Vetter */ 208552217195SDaniel Vetter if ((out_resp->count_modes >= mode_count) && mode_count) { 208652217195SDaniel Vetter copied = 0; 208752217195SDaniel Vetter mode_ptr = (struct drm_mode_modeinfo __user *)(unsigned long)out_resp->modes_ptr; 2088c3ff0cdbSAnkit Nautiyal list_for_each_entry(mode, &export_list, export_head) { 208952217195SDaniel Vetter drm_mode_convert_to_umode(&u_mode, mode); 2090c3ff0cdbSAnkit Nautiyal /* 2091c3ff0cdbSAnkit Nautiyal * Reset aspect ratio flags of user-mode, if modes with 2092c3ff0cdbSAnkit Nautiyal * aspect-ratio are not supported. 2093c3ff0cdbSAnkit Nautiyal */ 2094c3ff0cdbSAnkit Nautiyal if (!file_priv->aspect_ratio_allowed) 2095c3ff0cdbSAnkit Nautiyal u_mode.flags &= ~DRM_MODE_FLAG_PIC_AR_MASK; 209652217195SDaniel Vetter if (copy_to_user(mode_ptr + copied, 209752217195SDaniel Vetter &u_mode, sizeof(u_mode))) { 209852217195SDaniel Vetter ret = -EFAULT; 2099e94ac351SDaniel Vetter mutex_unlock(&dev->mode_config.mutex); 2100e94ac351SDaniel Vetter 210152217195SDaniel Vetter goto out; 210252217195SDaniel Vetter } 210352217195SDaniel Vetter copied++; 210452217195SDaniel Vetter } 210552217195SDaniel Vetter } 210652217195SDaniel Vetter out_resp->count_modes = mode_count; 210752217195SDaniel Vetter mutex_unlock(&dev->mode_config.mutex); 2108e94ac351SDaniel Vetter 2109e94ac351SDaniel Vetter drm_modeset_lock(&dev->mode_config.connection_mutex, NULL); 2110e94ac351SDaniel Vetter encoder = drm_connector_get_encoder(connector); 2111e94ac351SDaniel Vetter if (encoder) 2112e94ac351SDaniel Vetter out_resp->encoder_id = encoder->base.id; 2113e94ac351SDaniel Vetter else 2114e94ac351SDaniel Vetter out_resp->encoder_id = 0; 2115e94ac351SDaniel Vetter 2116e94ac351SDaniel Vetter /* Only grab properties after probing, to make sure EDID and other 2117e94ac351SDaniel Vetter * properties reflect the latest status. */ 2118e94ac351SDaniel Vetter ret = drm_mode_object_get_properties(&connector->base, file_priv->atomic, 2119e94ac351SDaniel Vetter (uint32_t __user *)(unsigned long)(out_resp->props_ptr), 2120e94ac351SDaniel Vetter (uint64_t __user *)(unsigned long)(out_resp->prop_values_ptr), 2121e94ac351SDaniel Vetter &out_resp->count_props); 2122e94ac351SDaniel Vetter drm_modeset_unlock(&dev->mode_config.connection_mutex); 2123e94ac351SDaniel Vetter 2124e94ac351SDaniel Vetter out: 2125ad093607SThierry Reding drm_connector_put(connector); 212652217195SDaniel Vetter 212752217195SDaniel Vetter return ret; 212852217195SDaniel Vetter } 212952217195SDaniel Vetter 21309498c19bSDaniel Vetter 21319498c19bSDaniel Vetter /** 21329498c19bSDaniel Vetter * DOC: Tile group 21339498c19bSDaniel Vetter * 21349498c19bSDaniel Vetter * Tile groups are used to represent tiled monitors with a unique integer 21359498c19bSDaniel Vetter * identifier. Tiled monitors using DisplayID v1.3 have a unique 8-byte handle, 21369498c19bSDaniel Vetter * we store this in a tile group, so we have a common identifier for all tiles 21379498c19bSDaniel Vetter * in a monitor group. The property is called "TILE". Drivers can manage tile 21389498c19bSDaniel Vetter * groups using drm_mode_create_tile_group(), drm_mode_put_tile_group() and 21399498c19bSDaniel Vetter * drm_mode_get_tile_group(). But this is only needed for internal panels where 21409498c19bSDaniel Vetter * the tile group information is exposed through a non-standard way. 21419498c19bSDaniel Vetter */ 21429498c19bSDaniel Vetter 21439498c19bSDaniel Vetter static void drm_tile_group_free(struct kref *kref) 21449498c19bSDaniel Vetter { 21459498c19bSDaniel Vetter struct drm_tile_group *tg = container_of(kref, struct drm_tile_group, refcount); 21469498c19bSDaniel Vetter struct drm_device *dev = tg->dev; 21479498c19bSDaniel Vetter mutex_lock(&dev->mode_config.idr_mutex); 21489498c19bSDaniel Vetter idr_remove(&dev->mode_config.tile_idr, tg->id); 21499498c19bSDaniel Vetter mutex_unlock(&dev->mode_config.idr_mutex); 21509498c19bSDaniel Vetter kfree(tg); 21519498c19bSDaniel Vetter } 21529498c19bSDaniel Vetter 21539498c19bSDaniel Vetter /** 21549498c19bSDaniel Vetter * drm_mode_put_tile_group - drop a reference to a tile group. 21559498c19bSDaniel Vetter * @dev: DRM device 21569498c19bSDaniel Vetter * @tg: tile group to drop reference to. 21579498c19bSDaniel Vetter * 21589498c19bSDaniel Vetter * drop reference to tile group and free if 0. 21599498c19bSDaniel Vetter */ 21609498c19bSDaniel Vetter void drm_mode_put_tile_group(struct drm_device *dev, 21619498c19bSDaniel Vetter struct drm_tile_group *tg) 21629498c19bSDaniel Vetter { 21639498c19bSDaniel Vetter kref_put(&tg->refcount, drm_tile_group_free); 21649498c19bSDaniel Vetter } 21659498c19bSDaniel Vetter EXPORT_SYMBOL(drm_mode_put_tile_group); 21669498c19bSDaniel Vetter 21679498c19bSDaniel Vetter /** 21689498c19bSDaniel Vetter * drm_mode_get_tile_group - get a reference to an existing tile group 21699498c19bSDaniel Vetter * @dev: DRM device 21709498c19bSDaniel Vetter * @topology: 8-bytes unique per monitor. 21719498c19bSDaniel Vetter * 21729498c19bSDaniel Vetter * Use the unique bytes to get a reference to an existing tile group. 21739498c19bSDaniel Vetter * 21749498c19bSDaniel Vetter * RETURNS: 21759498c19bSDaniel Vetter * tile group or NULL if not found. 21769498c19bSDaniel Vetter */ 21779498c19bSDaniel Vetter struct drm_tile_group *drm_mode_get_tile_group(struct drm_device *dev, 21789498c19bSDaniel Vetter char topology[8]) 21799498c19bSDaniel Vetter { 21809498c19bSDaniel Vetter struct drm_tile_group *tg; 21819498c19bSDaniel Vetter int id; 21829498c19bSDaniel Vetter mutex_lock(&dev->mode_config.idr_mutex); 21839498c19bSDaniel Vetter idr_for_each_entry(&dev->mode_config.tile_idr, tg, id) { 21849498c19bSDaniel Vetter if (!memcmp(tg->group_data, topology, 8)) { 21859498c19bSDaniel Vetter if (!kref_get_unless_zero(&tg->refcount)) 21869498c19bSDaniel Vetter tg = NULL; 21879498c19bSDaniel Vetter mutex_unlock(&dev->mode_config.idr_mutex); 21889498c19bSDaniel Vetter return tg; 21899498c19bSDaniel Vetter } 21909498c19bSDaniel Vetter } 21919498c19bSDaniel Vetter mutex_unlock(&dev->mode_config.idr_mutex); 21929498c19bSDaniel Vetter return NULL; 21939498c19bSDaniel Vetter } 21949498c19bSDaniel Vetter EXPORT_SYMBOL(drm_mode_get_tile_group); 21959498c19bSDaniel Vetter 21969498c19bSDaniel Vetter /** 21979498c19bSDaniel Vetter * drm_mode_create_tile_group - create a tile group from a displayid description 21989498c19bSDaniel Vetter * @dev: DRM device 21999498c19bSDaniel Vetter * @topology: 8-bytes unique per monitor. 22009498c19bSDaniel Vetter * 22019498c19bSDaniel Vetter * Create a tile group for the unique monitor, and get a unique 22029498c19bSDaniel Vetter * identifier for the tile group. 22039498c19bSDaniel Vetter * 22049498c19bSDaniel Vetter * RETURNS: 2205705c8160SDan Carpenter * new tile group or NULL. 22069498c19bSDaniel Vetter */ 22079498c19bSDaniel Vetter struct drm_tile_group *drm_mode_create_tile_group(struct drm_device *dev, 22089498c19bSDaniel Vetter char topology[8]) 22099498c19bSDaniel Vetter { 22109498c19bSDaniel Vetter struct drm_tile_group *tg; 22119498c19bSDaniel Vetter int ret; 22129498c19bSDaniel Vetter 22139498c19bSDaniel Vetter tg = kzalloc(sizeof(*tg), GFP_KERNEL); 22149498c19bSDaniel Vetter if (!tg) 2215705c8160SDan Carpenter return NULL; 22169498c19bSDaniel Vetter 22179498c19bSDaniel Vetter kref_init(&tg->refcount); 22189498c19bSDaniel Vetter memcpy(tg->group_data, topology, 8); 22199498c19bSDaniel Vetter tg->dev = dev; 22209498c19bSDaniel Vetter 22219498c19bSDaniel Vetter mutex_lock(&dev->mode_config.idr_mutex); 22229498c19bSDaniel Vetter ret = idr_alloc(&dev->mode_config.tile_idr, tg, 1, 0, GFP_KERNEL); 22239498c19bSDaniel Vetter if (ret >= 0) { 22249498c19bSDaniel Vetter tg->id = ret; 22259498c19bSDaniel Vetter } else { 22269498c19bSDaniel Vetter kfree(tg); 2227705c8160SDan Carpenter tg = NULL; 22289498c19bSDaniel Vetter } 22299498c19bSDaniel Vetter 22309498c19bSDaniel Vetter mutex_unlock(&dev->mode_config.idr_mutex); 22319498c19bSDaniel Vetter return tg; 22329498c19bSDaniel Vetter } 22339498c19bSDaniel Vetter EXPORT_SYMBOL(drm_mode_create_tile_group); 2234