1/* 2 * Copyright (c) 2016 Intel Corporation 3 * 4 * Permission to use, copy, modify, distribute, and sell this software and its 5 * documentation for any purpose is hereby granted without fee, provided that 6 * the above copyright notice appear in all copies and that both that copyright 7 * notice and this permission notice appear in supporting documentation, and 8 * that the name of the copyright holders not be used in advertising or 9 * publicity pertaining to distribution of the software without specific, 10 * written prior permission. The copyright holders make no representations 11 * about the suitability of this software for any purpose. It is provided "as 12 * is" without express or implied warranty. 13 * 14 * THE COPYRIGHT HOLDERS DISCLAIM ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, 15 * INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO 16 * EVENT SHALL THE COPYRIGHT HOLDERS BE LIABLE FOR ANY SPECIAL, INDIRECT OR 17 * CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, 18 * DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER 19 * TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE 20 * OF THIS SOFTWARE. 21 */ 22 23#include <drm/drm_auth.h> 24#include <drm/drm_connector.h> 25#include <drm/drm_drv.h> 26#include <drm/drm_edid.h> 27#include <drm/drm_encoder.h> 28#include <drm/drm_file.h> 29#include <drm/drm_managed.h> 30#include <drm/drm_panel.h> 31#include <drm/drm_print.h> 32#include <drm/drm_privacy_screen_consumer.h> 33#include <drm/drm_sysfs.h> 34#include <drm/drm_utils.h> 35 36#include <linux/property.h> 37#include <linux/uaccess.h> 38#include <linux/backlight.h> 39 40#include <video/cmdline.h> 41 42#include "drm_crtc_internal.h" 43#include "drm_internal.h" 44 45/** 46 * DOC: overview 47 * 48 * In DRM connectors are the general abstraction for display sinks, and include 49 * also fixed panels or anything else that can display pixels in some form. As 50 * opposed to all other KMS objects representing hardware (like CRTC, encoder or 51 * plane abstractions) connectors can be hotplugged and unplugged at runtime. 52 * Hence they are reference-counted using drm_connector_get() and 53 * drm_connector_put(). 54 * 55 * KMS driver must create, initialize, register and attach at a &struct 56 * drm_connector for each such sink. The instance is created as other KMS 57 * objects and initialized by setting the following fields. The connector is 58 * initialized with a call to drm_connector_init() with a pointer to the 59 * &struct drm_connector_funcs and a connector type, and then exposed to 60 * userspace with a call to drm_connector_register(). 61 * 62 * Connectors must be attached to an encoder to be used. For devices that map 63 * connectors to encoders 1:1, the connector should be attached at 64 * initialization time with a call to drm_connector_attach_encoder(). The 65 * driver must also set the &drm_connector.encoder field to point to the 66 * attached encoder. 67 * 68 * For connectors which are not fixed (like built-in panels) the driver needs to 69 * support hotplug notifications. The simplest way to do that is by using the 70 * probe helpers, see drm_kms_helper_poll_init() for connectors which don't have 71 * hardware support for hotplug interrupts. Connectors with hardware hotplug 72 * support can instead use e.g. drm_helper_hpd_irq_event(). 73 */ 74 75/* 76 * Global connector list for drm_connector_find_by_fwnode(). 77 * Note drm_connector_[un]register() first take connector->lock and then 78 * take the connector_list_lock. 79 */ 80static DEFINE_MUTEX(connector_list_lock); 81static DRM_LIST_HEAD(connector_list); 82 83struct drm_conn_prop_enum_list { 84 int type; 85 const char *name; 86 struct ida ida; 87}; 88 89/* 90 * Connector and encoder types. 91 */ 92static struct drm_conn_prop_enum_list drm_connector_enum_list[] = { 93 { DRM_MODE_CONNECTOR_Unknown, "Unknown" }, 94 { DRM_MODE_CONNECTOR_VGA, "VGA" }, 95 { DRM_MODE_CONNECTOR_DVII, "DVI-I" }, 96 { DRM_MODE_CONNECTOR_DVID, "DVI-D" }, 97 { DRM_MODE_CONNECTOR_DVIA, "DVI-A" }, 98 { DRM_MODE_CONNECTOR_Composite, "Composite" }, 99 { DRM_MODE_CONNECTOR_SVIDEO, "SVIDEO" }, 100 { DRM_MODE_CONNECTOR_LVDS, "LVDS" }, 101 { DRM_MODE_CONNECTOR_Component, "Component" }, 102 { DRM_MODE_CONNECTOR_9PinDIN, "DIN" }, 103 { DRM_MODE_CONNECTOR_DisplayPort, "DP" }, 104 { DRM_MODE_CONNECTOR_HDMIA, "HDMI-A" }, 105 { DRM_MODE_CONNECTOR_HDMIB, "HDMI-B" }, 106 { DRM_MODE_CONNECTOR_TV, "TV" }, 107 { DRM_MODE_CONNECTOR_eDP, "eDP" }, 108 { DRM_MODE_CONNECTOR_VIRTUAL, "Virtual" }, 109 { DRM_MODE_CONNECTOR_DSI, "DSI" }, 110 { DRM_MODE_CONNECTOR_DPI, "DPI" }, 111 { DRM_MODE_CONNECTOR_WRITEBACK, "Writeback" }, 112 { DRM_MODE_CONNECTOR_SPI, "SPI" }, 113 { DRM_MODE_CONNECTOR_USB, "USB" }, 114}; 115 116void drm_connector_ida_init(void) 117{ 118 int i; 119 120 for (i = 0; i < ARRAY_SIZE(drm_connector_enum_list); i++) 121 ida_init(&drm_connector_enum_list[i].ida); 122} 123 124void drm_connector_ida_destroy(void) 125{ 126 int i; 127 128 for (i = 0; i < ARRAY_SIZE(drm_connector_enum_list); i++) 129 ida_destroy(&drm_connector_enum_list[i].ida); 130} 131 132/** 133 * drm_get_connector_type_name - return a string for connector type 134 * @type: The connector type (DRM_MODE_CONNECTOR_*) 135 * 136 * Returns: the name of the connector type, or NULL if the type is not valid. 137 */ 138const char *drm_get_connector_type_name(unsigned int type) 139{ 140 if (type < ARRAY_SIZE(drm_connector_enum_list)) 141 return drm_connector_enum_list[type].name; 142 143 return NULL; 144} 145EXPORT_SYMBOL(drm_get_connector_type_name); 146 147/** 148 * drm_connector_get_cmdline_mode - reads the user's cmdline mode 149 * @connector: connector to query 150 * 151 * The kernel supports per-connector configuration of its consoles through 152 * use of the video= parameter. This function parses that option and 153 * extracts the user's specified mode (or enable/disable status) for a 154 * particular connector. This is typically only used during the early fbdev 155 * setup. 156 */ 157static void drm_connector_get_cmdline_mode(struct drm_connector *connector) 158{ 159 struct drm_cmdline_mode *mode = &connector->cmdline_mode; 160 const char *option; 161 162 option = video_get_options(connector->name); 163 if (!option) 164 return; 165 166 if (!drm_mode_parse_command_line_for_connector(option, 167 connector, 168 mode)) 169 return; 170 171 if (mode->force) { 172 DRM_INFO("forcing %s connector %s\n", connector->name, 173 drm_get_connector_force_name(mode->force)); 174 connector->force = mode->force; 175 } 176 177 if (mode->panel_orientation != DRM_MODE_PANEL_ORIENTATION_UNKNOWN) { 178 DRM_INFO("cmdline forces connector %s panel_orientation to %d\n", 179 connector->name, mode->panel_orientation); 180 drm_connector_set_panel_orientation(connector, 181 mode->panel_orientation); 182 } 183 184 DRM_DEBUG_KMS("cmdline mode for connector %s %s %dx%d@%dHz%s%s%s\n", 185 connector->name, mode->name, 186 mode->xres, mode->yres, 187 mode->refresh_specified ? mode->refresh : 60, 188 mode->rb ? " reduced blanking" : "", 189 mode->margins ? " with margins" : "", 190 mode->interlace ? " interlaced" : ""); 191} 192 193static void drm_connector_free(struct kref *kref) 194{ 195 struct drm_connector *connector = 196 container_of(kref, struct drm_connector, base.refcount); 197 struct drm_device *dev = connector->dev; 198 199 drm_mode_object_unregister(dev, &connector->base); 200 connector->funcs->destroy(connector); 201} 202 203void drm_connector_free_work_fn(struct work_struct *work) 204{ 205 struct drm_connector *connector, *n; 206 struct drm_device *dev = 207 container_of(work, struct drm_device, mode_config.connector_free_work); 208 struct drm_mode_config *config = &dev->mode_config; 209 unsigned long flags; 210 struct llist_node *freed; 211 212 spin_lock_irqsave(&config->connector_list_lock, flags); 213 freed = llist_del_all(&config->connector_free_list); 214 spin_unlock_irqrestore(&config->connector_list_lock, flags); 215 216 llist_for_each_entry_safe(connector, n, freed, free_node) { 217 drm_mode_object_unregister(dev, &connector->base); 218 connector->funcs->destroy(connector); 219 } 220} 221 222static int __drm_connector_init(struct drm_device *dev, 223 struct drm_connector *connector, 224 const struct drm_connector_funcs *funcs, 225 int connector_type, 226 struct i2c_adapter *ddc) 227{ 228 struct drm_mode_config *config = &dev->mode_config; 229 int ret; 230 struct ida *connector_ida = 231 &drm_connector_enum_list[connector_type].ida; 232 233 WARN_ON(drm_drv_uses_atomic_modeset(dev) && 234 (!funcs->atomic_destroy_state || 235 !funcs->atomic_duplicate_state)); 236 237 ret = __drm_mode_object_add(dev, &connector->base, 238 DRM_MODE_OBJECT_CONNECTOR, 239 false, drm_connector_free); 240 if (ret) 241 return ret; 242 243 connector->base.properties = &connector->properties; 244 connector->dev = dev; 245 connector->funcs = funcs; 246 247 /* connector index is used with 32bit bitmasks */ 248 ret = ida_alloc_max(&config->connector_ida, 31, GFP_KERNEL); 249 if (ret < 0) { 250 DRM_DEBUG_KMS("Failed to allocate %s connector index: %d\n", 251 drm_connector_enum_list[connector_type].name, 252 ret); 253 goto out_put; 254 } 255 connector->index = ret; 256 ret = 0; 257 258 connector->connector_type = connector_type; 259 connector->connector_type_id = 260 ida_alloc_min(connector_ida, 1, GFP_KERNEL); 261 if (connector->connector_type_id < 0) { 262 ret = connector->connector_type_id; 263 goto out_put_id; 264 } 265 connector->name = 266 kasprintf(GFP_KERNEL, "%s-%d", 267 drm_connector_enum_list[connector_type].name, 268 connector->connector_type_id); 269 if (!connector->name) { 270 ret = -ENOMEM; 271 goto out_put_type_id; 272 } 273 274 /* provide ddc symlink in sysfs */ 275 connector->ddc = ddc; 276 277 INIT_LIST_HEAD(&connector->global_connector_list_entry); 278 INIT_LIST_HEAD(&connector->probed_modes); 279 INIT_LIST_HEAD(&connector->modes); 280 rw_init(&connector->mutex, "cnlk"); 281 rw_init(&connector->edid_override_mutex, "eolk"); 282 connector->edid_blob_ptr = NULL; 283 connector->epoch_counter = 0; 284 connector->tile_blob_ptr = NULL; 285 connector->status = connector_status_unknown; 286 connector->display_info.panel_orientation = 287 DRM_MODE_PANEL_ORIENTATION_UNKNOWN; 288 289 drm_connector_get_cmdline_mode(connector); 290 291 /* We should add connectors at the end to avoid upsetting the connector 292 * index too much. 293 */ 294 spin_lock_irq(&config->connector_list_lock); 295 list_add_tail(&connector->head, &config->connector_list); 296 config->num_connector++; 297 spin_unlock_irq(&config->connector_list_lock); 298 299 if (connector_type != DRM_MODE_CONNECTOR_VIRTUAL && 300 connector_type != DRM_MODE_CONNECTOR_WRITEBACK) 301 drm_connector_attach_edid_property(connector); 302 303 drm_object_attach_property(&connector->base, 304 config->dpms_property, 0); 305 306 drm_object_attach_property(&connector->base, 307 config->link_status_property, 308 0); 309 310 drm_object_attach_property(&connector->base, 311 config->non_desktop_property, 312 0); 313 drm_object_attach_property(&connector->base, 314 config->tile_property, 315 0); 316 317 if (drm_core_check_feature(dev, DRIVER_ATOMIC)) { 318 drm_object_attach_property(&connector->base, config->prop_crtc_id, 0); 319 } 320 321 connector->debugfs_entry = NULL; 322out_put_type_id: 323 if (ret) 324 ida_free(connector_ida, connector->connector_type_id); 325out_put_id: 326 if (ret) 327 ida_free(&config->connector_ida, connector->index); 328out_put: 329 if (ret) 330 drm_mode_object_unregister(dev, &connector->base); 331 332 return ret; 333} 334 335/** 336 * drm_connector_init - Init a preallocated connector 337 * @dev: DRM device 338 * @connector: the connector to init 339 * @funcs: callbacks for this connector 340 * @connector_type: user visible type of the connector 341 * 342 * Initialises a preallocated connector. Connectors should be 343 * subclassed as part of driver connector objects. 344 * 345 * At driver unload time the driver's &drm_connector_funcs.destroy hook 346 * should call drm_connector_cleanup() and free the connector structure. 347 * The connector structure should not be allocated with devm_kzalloc(). 348 * 349 * Note: consider using drmm_connector_init() instead of 350 * drm_connector_init() to let the DRM managed resource infrastructure 351 * take care of cleanup and deallocation. 352 * 353 * Returns: 354 * Zero on success, error code on failure. 355 */ 356int drm_connector_init(struct drm_device *dev, 357 struct drm_connector *connector, 358 const struct drm_connector_funcs *funcs, 359 int connector_type) 360{ 361 if (drm_WARN_ON(dev, !(funcs && funcs->destroy))) 362 return -EINVAL; 363 364 return __drm_connector_init(dev, connector, funcs, connector_type, NULL); 365} 366EXPORT_SYMBOL(drm_connector_init); 367 368/** 369 * drm_connector_init_with_ddc - Init a preallocated connector 370 * @dev: DRM device 371 * @connector: the connector to init 372 * @funcs: callbacks for this connector 373 * @connector_type: user visible type of the connector 374 * @ddc: pointer to the associated ddc adapter 375 * 376 * Initialises a preallocated connector. Connectors should be 377 * subclassed as part of driver connector objects. 378 * 379 * At driver unload time the driver's &drm_connector_funcs.destroy hook 380 * should call drm_connector_cleanup() and free the connector structure. 381 * The connector structure should not be allocated with devm_kzalloc(). 382 * 383 * Ensures that the ddc field of the connector is correctly set. 384 * 385 * Note: consider using drmm_connector_init() instead of 386 * drm_connector_init_with_ddc() to let the DRM managed resource 387 * infrastructure take care of cleanup and deallocation. 388 * 389 * Returns: 390 * Zero on success, error code on failure. 391 */ 392int drm_connector_init_with_ddc(struct drm_device *dev, 393 struct drm_connector *connector, 394 const struct drm_connector_funcs *funcs, 395 int connector_type, 396 struct i2c_adapter *ddc) 397{ 398 if (drm_WARN_ON(dev, !(funcs && funcs->destroy))) 399 return -EINVAL; 400 401 return __drm_connector_init(dev, connector, funcs, connector_type, ddc); 402} 403EXPORT_SYMBOL(drm_connector_init_with_ddc); 404 405static void drm_connector_cleanup_action(struct drm_device *dev, 406 void *ptr) 407{ 408 struct drm_connector *connector = ptr; 409 410 drm_connector_cleanup(connector); 411} 412 413/** 414 * drmm_connector_init - Init a preallocated connector 415 * @dev: DRM device 416 * @connector: the connector to init 417 * @funcs: callbacks for this connector 418 * @connector_type: user visible type of the connector 419 * @ddc: optional pointer to the associated ddc adapter 420 * 421 * Initialises a preallocated connector. Connectors should be 422 * subclassed as part of driver connector objects. 423 * 424 * Cleanup is automatically handled with a call to 425 * drm_connector_cleanup() in a DRM-managed action. 426 * 427 * The connector structure should be allocated with drmm_kzalloc(). 428 * 429 * Returns: 430 * Zero on success, error code on failure. 431 */ 432int drmm_connector_init(struct drm_device *dev, 433 struct drm_connector *connector, 434 const struct drm_connector_funcs *funcs, 435 int connector_type, 436 struct i2c_adapter *ddc) 437{ 438 int ret; 439 440 if (drm_WARN_ON(dev, funcs && funcs->destroy)) 441 return -EINVAL; 442 443 ret = __drm_connector_init(dev, connector, funcs, connector_type, ddc); 444 if (ret) 445 return ret; 446 447 ret = drmm_add_action_or_reset(dev, drm_connector_cleanup_action, 448 connector); 449 if (ret) 450 return ret; 451 452 return 0; 453} 454EXPORT_SYMBOL(drmm_connector_init); 455 456/** 457 * drm_connector_attach_edid_property - attach edid property. 458 * @connector: the connector 459 * 460 * Some connector types like DRM_MODE_CONNECTOR_VIRTUAL do not get a 461 * edid property attached by default. This function can be used to 462 * explicitly enable the edid property in these cases. 463 */ 464void drm_connector_attach_edid_property(struct drm_connector *connector) 465{ 466 struct drm_mode_config *config = &connector->dev->mode_config; 467 468 drm_object_attach_property(&connector->base, 469 config->edid_property, 470 0); 471} 472EXPORT_SYMBOL(drm_connector_attach_edid_property); 473 474/** 475 * drm_connector_attach_encoder - attach a connector to an encoder 476 * @connector: connector to attach 477 * @encoder: encoder to attach @connector to 478 * 479 * This function links up a connector to an encoder. Note that the routing 480 * restrictions between encoders and crtcs are exposed to userspace through the 481 * possible_clones and possible_crtcs bitmasks. 482 * 483 * Returns: 484 * Zero on success, negative errno on failure. 485 */ 486int drm_connector_attach_encoder(struct drm_connector *connector, 487 struct drm_encoder *encoder) 488{ 489 /* 490 * In the past, drivers have attempted to model the static association 491 * of connector to encoder in simple connector/encoder devices using a 492 * direct assignment of connector->encoder = encoder. This connection 493 * is a logical one and the responsibility of the core, so drivers are 494 * expected not to mess with this. 495 * 496 * Note that the error return should've been enough here, but a large 497 * majority of drivers ignores the return value, so add in a big WARN 498 * to get people's attention. 499 */ 500 if (WARN_ON(connector->encoder)) 501 return -EINVAL; 502 503 connector->possible_encoders |= drm_encoder_mask(encoder); 504 505 return 0; 506} 507EXPORT_SYMBOL(drm_connector_attach_encoder); 508 509/** 510 * drm_connector_has_possible_encoder - check if the connector and encoder are 511 * associated with each other 512 * @connector: the connector 513 * @encoder: the encoder 514 * 515 * Returns: 516 * True if @encoder is one of the possible encoders for @connector. 517 */ 518bool drm_connector_has_possible_encoder(struct drm_connector *connector, 519 struct drm_encoder *encoder) 520{ 521 return connector->possible_encoders & drm_encoder_mask(encoder); 522} 523EXPORT_SYMBOL(drm_connector_has_possible_encoder); 524 525static void drm_mode_remove(struct drm_connector *connector, 526 struct drm_display_mode *mode) 527{ 528 list_del(&mode->head); 529 drm_mode_destroy(connector->dev, mode); 530} 531 532/** 533 * drm_connector_cleanup - cleans up an initialised connector 534 * @connector: connector to cleanup 535 * 536 * Cleans up the connector but doesn't free the object. 537 */ 538void drm_connector_cleanup(struct drm_connector *connector) 539{ 540 struct drm_device *dev = connector->dev; 541 struct drm_display_mode *mode, *t; 542 543 /* The connector should have been removed from userspace long before 544 * it is finally destroyed. 545 */ 546 if (WARN_ON(connector->registration_state == 547 DRM_CONNECTOR_REGISTERED)) 548 drm_connector_unregister(connector); 549 550 if (connector->privacy_screen) { 551 drm_privacy_screen_put(connector->privacy_screen); 552 connector->privacy_screen = NULL; 553 } 554 555 if (connector->tile_group) { 556 drm_mode_put_tile_group(dev, connector->tile_group); 557 connector->tile_group = NULL; 558 } 559 560 list_for_each_entry_safe(mode, t, &connector->probed_modes, head) 561 drm_mode_remove(connector, mode); 562 563 list_for_each_entry_safe(mode, t, &connector->modes, head) 564 drm_mode_remove(connector, mode); 565 566 ida_free(&drm_connector_enum_list[connector->connector_type].ida, 567 connector->connector_type_id); 568 569 ida_free(&dev->mode_config.connector_ida, connector->index); 570 571 kfree(connector->display_info.bus_formats); 572 kfree(connector->display_info.vics); 573 drm_mode_object_unregister(dev, &connector->base); 574 kfree(connector->name); 575 connector->name = NULL; 576 fwnode_handle_put(connector->fwnode); 577 connector->fwnode = NULL; 578 spin_lock_irq(&dev->mode_config.connector_list_lock); 579 list_del(&connector->head); 580 dev->mode_config.num_connector--; 581 spin_unlock_irq(&dev->mode_config.connector_list_lock); 582 583 WARN_ON(connector->state && !connector->funcs->atomic_destroy_state); 584 if (connector->state && connector->funcs->atomic_destroy_state) 585 connector->funcs->atomic_destroy_state(connector, 586 connector->state); 587 588 mutex_destroy(&connector->mutex); 589 590 memset(connector, 0, sizeof(*connector)); 591 592 if (dev->registered) 593 drm_sysfs_hotplug_event(dev); 594} 595EXPORT_SYMBOL(drm_connector_cleanup); 596 597/** 598 * drm_connector_register - register a connector 599 * @connector: the connector to register 600 * 601 * Register userspace interfaces for a connector. Only call this for connectors 602 * which can be hotplugged after drm_dev_register() has been called already, 603 * e.g. DP MST connectors. All other connectors will be registered automatically 604 * when calling drm_dev_register(). 605 * 606 * When the connector is no longer available, callers must call 607 * drm_connector_unregister(). 608 * 609 * Returns: 610 * Zero on success, error code on failure. 611 */ 612int drm_connector_register(struct drm_connector *connector) 613{ 614 int ret = 0; 615 616 if (!connector->dev->registered) 617 return 0; 618 619 mutex_lock(&connector->mutex); 620 if (connector->registration_state != DRM_CONNECTOR_INITIALIZING) 621 goto unlock; 622 623 ret = drm_sysfs_connector_add(connector); 624 if (ret) 625 goto unlock; 626 627 drm_debugfs_connector_add(connector); 628 629 if (connector->funcs->late_register) { 630 ret = connector->funcs->late_register(connector); 631 if (ret) 632 goto err_debugfs; 633 } 634 635 drm_mode_object_register(connector->dev, &connector->base); 636 637 connector->registration_state = DRM_CONNECTOR_REGISTERED; 638 639 /* Let userspace know we have a new connector */ 640 drm_sysfs_connector_hotplug_event(connector); 641 642 if (connector->privacy_screen) 643 drm_privacy_screen_register_notifier(connector->privacy_screen, 644 &connector->privacy_screen_notifier); 645 646 mutex_lock(&connector_list_lock); 647 list_add_tail(&connector->global_connector_list_entry, &connector_list); 648 mutex_unlock(&connector_list_lock); 649 goto unlock; 650 651err_debugfs: 652 drm_debugfs_connector_remove(connector); 653 drm_sysfs_connector_remove(connector); 654unlock: 655 mutex_unlock(&connector->mutex); 656 return ret; 657} 658EXPORT_SYMBOL(drm_connector_register); 659 660/** 661 * drm_connector_unregister - unregister a connector 662 * @connector: the connector to unregister 663 * 664 * Unregister userspace interfaces for a connector. Only call this for 665 * connectors which have been registered explicitly by calling 666 * drm_connector_register(). 667 */ 668void drm_connector_unregister(struct drm_connector *connector) 669{ 670 mutex_lock(&connector->mutex); 671 if (connector->registration_state != DRM_CONNECTOR_REGISTERED) { 672 mutex_unlock(&connector->mutex); 673 return; 674 } 675 676 mutex_lock(&connector_list_lock); 677 list_del_init(&connector->global_connector_list_entry); 678 mutex_unlock(&connector_list_lock); 679 680 if (connector->privacy_screen) 681 drm_privacy_screen_unregister_notifier( 682 connector->privacy_screen, 683 &connector->privacy_screen_notifier); 684 685 if (connector->funcs->early_unregister) 686 connector->funcs->early_unregister(connector); 687 688 drm_sysfs_connector_remove(connector); 689 drm_debugfs_connector_remove(connector); 690 691 connector->registration_state = DRM_CONNECTOR_UNREGISTERED; 692 mutex_unlock(&connector->mutex); 693} 694EXPORT_SYMBOL(drm_connector_unregister); 695 696void drm_connector_unregister_all(struct drm_device *dev) 697{ 698 struct drm_connector *connector; 699 struct drm_connector_list_iter conn_iter; 700 701 drm_connector_list_iter_begin(dev, &conn_iter); 702 drm_for_each_connector_iter(connector, &conn_iter) 703 drm_connector_unregister(connector); 704 drm_connector_list_iter_end(&conn_iter); 705} 706 707int drm_connector_register_all(struct drm_device *dev) 708{ 709 struct drm_connector *connector; 710 struct drm_connector_list_iter conn_iter; 711 int ret = 0; 712 713 drm_connector_list_iter_begin(dev, &conn_iter); 714 drm_for_each_connector_iter(connector, &conn_iter) { 715 ret = drm_connector_register(connector); 716 if (ret) 717 break; 718 } 719 drm_connector_list_iter_end(&conn_iter); 720 721 if (ret) 722 drm_connector_unregister_all(dev); 723 return ret; 724} 725 726/** 727 * drm_get_connector_status_name - return a string for connector status 728 * @status: connector status to compute name of 729 * 730 * In contrast to the other drm_get_*_name functions this one here returns a 731 * const pointer and hence is threadsafe. 732 * 733 * Returns: connector status string 734 */ 735const char *drm_get_connector_status_name(enum drm_connector_status status) 736{ 737 if (status == connector_status_connected) 738 return "connected"; 739 else if (status == connector_status_disconnected) 740 return "disconnected"; 741 else 742 return "unknown"; 743} 744EXPORT_SYMBOL(drm_get_connector_status_name); 745 746/** 747 * drm_get_connector_force_name - return a string for connector force 748 * @force: connector force to get name of 749 * 750 * Returns: const pointer to name. 751 */ 752const char *drm_get_connector_force_name(enum drm_connector_force force) 753{ 754 switch (force) { 755 case DRM_FORCE_UNSPECIFIED: 756 return "unspecified"; 757 case DRM_FORCE_OFF: 758 return "off"; 759 case DRM_FORCE_ON: 760 return "on"; 761 case DRM_FORCE_ON_DIGITAL: 762 return "digital"; 763 default: 764 return "unknown"; 765 } 766} 767 768#ifdef CONFIG_LOCKDEP 769static struct lockdep_map connector_list_iter_dep_map = { 770 .name = "drm_connector_list_iter" 771}; 772#endif 773 774/** 775 * drm_connector_list_iter_begin - initialize a connector_list iterator 776 * @dev: DRM device 777 * @iter: connector_list iterator 778 * 779 * Sets @iter up to walk the &drm_mode_config.connector_list of @dev. @iter 780 * must always be cleaned up again by calling drm_connector_list_iter_end(). 781 * Iteration itself happens using drm_connector_list_iter_next() or 782 * drm_for_each_connector_iter(). 783 */ 784void drm_connector_list_iter_begin(struct drm_device *dev, 785 struct drm_connector_list_iter *iter) 786{ 787 iter->dev = dev; 788 iter->conn = NULL; 789 lock_acquire_shared_recursive(&connector_list_iter_dep_map, 0, 1, NULL, _RET_IP_); 790} 791EXPORT_SYMBOL(drm_connector_list_iter_begin); 792 793/* 794 * Extra-safe connector put function that works in any context. Should only be 795 * used from the connector_iter functions, where we never really expect to 796 * actually release the connector when dropping our final reference. 797 */ 798static void 799__drm_connector_put_safe(struct drm_connector *conn) 800{ 801 struct drm_mode_config *config = &conn->dev->mode_config; 802 803 lockdep_assert_held(&config->connector_list_lock); 804 805 if (!refcount_dec_and_test(&conn->base.refcount.refcount)) 806 return; 807 808 llist_add(&conn->free_node, &config->connector_free_list); 809 schedule_work(&config->connector_free_work); 810} 811 812/** 813 * drm_connector_list_iter_next - return next connector 814 * @iter: connector_list iterator 815 * 816 * Returns: the next connector for @iter, or NULL when the list walk has 817 * completed. 818 */ 819struct drm_connector * 820drm_connector_list_iter_next(struct drm_connector_list_iter *iter) 821{ 822 struct drm_connector *old_conn = iter->conn; 823 struct drm_mode_config *config = &iter->dev->mode_config; 824 struct list_head *lhead; 825 unsigned long flags; 826 827 spin_lock_irqsave(&config->connector_list_lock, flags); 828 lhead = old_conn ? &old_conn->head : &config->connector_list; 829 830 do { 831 if (lhead->next == &config->connector_list) { 832 iter->conn = NULL; 833 break; 834 } 835 836 lhead = lhead->next; 837 iter->conn = list_entry(lhead, struct drm_connector, head); 838 839 /* loop until it's not a zombie connector */ 840 } while (!kref_get_unless_zero(&iter->conn->base.refcount)); 841 842 if (old_conn) 843 __drm_connector_put_safe(old_conn); 844 spin_unlock_irqrestore(&config->connector_list_lock, flags); 845 846 return iter->conn; 847} 848EXPORT_SYMBOL(drm_connector_list_iter_next); 849 850/** 851 * drm_connector_list_iter_end - tear down a connector_list iterator 852 * @iter: connector_list iterator 853 * 854 * Tears down @iter and releases any resources (like &drm_connector references) 855 * acquired while walking the list. This must always be called, both when the 856 * iteration completes fully or when it was aborted without walking the entire 857 * list. 858 */ 859void drm_connector_list_iter_end(struct drm_connector_list_iter *iter) 860{ 861 struct drm_mode_config *config = &iter->dev->mode_config; 862 unsigned long flags; 863 864 iter->dev = NULL; 865 if (iter->conn) { 866 spin_lock_irqsave(&config->connector_list_lock, flags); 867 __drm_connector_put_safe(iter->conn); 868 spin_unlock_irqrestore(&config->connector_list_lock, flags); 869 } 870 lock_release(&connector_list_iter_dep_map, _RET_IP_); 871} 872EXPORT_SYMBOL(drm_connector_list_iter_end); 873 874static const struct drm_prop_enum_list drm_subpixel_enum_list[] = { 875 { SubPixelUnknown, "Unknown" }, 876 { SubPixelHorizontalRGB, "Horizontal RGB" }, 877 { SubPixelHorizontalBGR, "Horizontal BGR" }, 878 { SubPixelVerticalRGB, "Vertical RGB" }, 879 { SubPixelVerticalBGR, "Vertical BGR" }, 880 { SubPixelNone, "None" }, 881}; 882 883/** 884 * drm_get_subpixel_order_name - return a string for a given subpixel enum 885 * @order: enum of subpixel_order 886 * 887 * Note you could abuse this and return something out of bounds, but that 888 * would be a caller error. No unscrubbed user data should make it here. 889 * 890 * Returns: string describing an enumerated subpixel property 891 */ 892const char *drm_get_subpixel_order_name(enum subpixel_order order) 893{ 894 return drm_subpixel_enum_list[order].name; 895} 896EXPORT_SYMBOL(drm_get_subpixel_order_name); 897 898static const struct drm_prop_enum_list drm_dpms_enum_list[] = { 899 { DRM_MODE_DPMS_ON, "On" }, 900 { DRM_MODE_DPMS_STANDBY, "Standby" }, 901 { DRM_MODE_DPMS_SUSPEND, "Suspend" }, 902 { DRM_MODE_DPMS_OFF, "Off" } 903}; 904DRM_ENUM_NAME_FN(drm_get_dpms_name, drm_dpms_enum_list) 905 906static const struct drm_prop_enum_list drm_link_status_enum_list[] = { 907 { DRM_MODE_LINK_STATUS_GOOD, "Good" }, 908 { DRM_MODE_LINK_STATUS_BAD, "Bad" }, 909}; 910 911/** 912 * drm_display_info_set_bus_formats - set the supported bus formats 913 * @info: display info to store bus formats in 914 * @formats: array containing the supported bus formats 915 * @num_formats: the number of entries in the fmts array 916 * 917 * Store the supported bus formats in display info structure. 918 * See MEDIA_BUS_FMT_* definitions in include/uapi/linux/media-bus-format.h for 919 * a full list of available formats. 920 * 921 * Returns: 922 * 0 on success or a negative error code on failure. 923 */ 924int drm_display_info_set_bus_formats(struct drm_display_info *info, 925 const u32 *formats, 926 unsigned int num_formats) 927{ 928 u32 *fmts = NULL; 929 930 if (!formats && num_formats) 931 return -EINVAL; 932 933 if (formats && num_formats) { 934 fmts = kmemdup(formats, sizeof(*formats) * num_formats, 935 GFP_KERNEL); 936 if (!fmts) 937 return -ENOMEM; 938 } 939 940 kfree(info->bus_formats); 941 info->bus_formats = fmts; 942 info->num_bus_formats = num_formats; 943 944 return 0; 945} 946EXPORT_SYMBOL(drm_display_info_set_bus_formats); 947 948/* Optional connector properties. */ 949static const struct drm_prop_enum_list drm_scaling_mode_enum_list[] = { 950 { DRM_MODE_SCALE_NONE, "None" }, 951 { DRM_MODE_SCALE_FULLSCREEN, "Full" }, 952 { DRM_MODE_SCALE_CENTER, "Center" }, 953 { DRM_MODE_SCALE_ASPECT, "Full aspect" }, 954}; 955 956static const struct drm_prop_enum_list drm_aspect_ratio_enum_list[] = { 957 { DRM_MODE_PICTURE_ASPECT_NONE, "Automatic" }, 958 { DRM_MODE_PICTURE_ASPECT_4_3, "4:3" }, 959 { DRM_MODE_PICTURE_ASPECT_16_9, "16:9" }, 960}; 961 962static const struct drm_prop_enum_list drm_content_type_enum_list[] = { 963 { DRM_MODE_CONTENT_TYPE_NO_DATA, "No Data" }, 964 { DRM_MODE_CONTENT_TYPE_GRAPHICS, "Graphics" }, 965 { DRM_MODE_CONTENT_TYPE_PHOTO, "Photo" }, 966 { DRM_MODE_CONTENT_TYPE_CINEMA, "Cinema" }, 967 { DRM_MODE_CONTENT_TYPE_GAME, "Game" }, 968}; 969 970static const struct drm_prop_enum_list drm_panel_orientation_enum_list[] = { 971 { DRM_MODE_PANEL_ORIENTATION_NORMAL, "Normal" }, 972 { DRM_MODE_PANEL_ORIENTATION_BOTTOM_UP, "Upside Down" }, 973 { DRM_MODE_PANEL_ORIENTATION_LEFT_UP, "Left Side Up" }, 974 { DRM_MODE_PANEL_ORIENTATION_RIGHT_UP, "Right Side Up" }, 975}; 976 977static const struct drm_prop_enum_list drm_dvi_i_select_enum_list[] = { 978 { DRM_MODE_SUBCONNECTOR_Automatic, "Automatic" }, /* DVI-I and TV-out */ 979 { DRM_MODE_SUBCONNECTOR_DVID, "DVI-D" }, /* DVI-I */ 980 { DRM_MODE_SUBCONNECTOR_DVIA, "DVI-A" }, /* DVI-I */ 981}; 982DRM_ENUM_NAME_FN(drm_get_dvi_i_select_name, drm_dvi_i_select_enum_list) 983 984static const struct drm_prop_enum_list drm_dvi_i_subconnector_enum_list[] = { 985 { DRM_MODE_SUBCONNECTOR_Unknown, "Unknown" }, /* DVI-I, TV-out and DP */ 986 { DRM_MODE_SUBCONNECTOR_DVID, "DVI-D" }, /* DVI-I */ 987 { DRM_MODE_SUBCONNECTOR_DVIA, "DVI-A" }, /* DVI-I */ 988}; 989DRM_ENUM_NAME_FN(drm_get_dvi_i_subconnector_name, 990 drm_dvi_i_subconnector_enum_list) 991 992static const struct drm_prop_enum_list drm_tv_mode_enum_list[] = { 993 { DRM_MODE_TV_MODE_NTSC, "NTSC" }, 994 { DRM_MODE_TV_MODE_NTSC_443, "NTSC-443" }, 995 { DRM_MODE_TV_MODE_NTSC_J, "NTSC-J" }, 996 { DRM_MODE_TV_MODE_PAL, "PAL" }, 997 { DRM_MODE_TV_MODE_PAL_M, "PAL-M" }, 998 { DRM_MODE_TV_MODE_PAL_N, "PAL-N" }, 999 { DRM_MODE_TV_MODE_SECAM, "SECAM" }, 1000}; 1001DRM_ENUM_NAME_FN(drm_get_tv_mode_name, drm_tv_mode_enum_list) 1002 1003/** 1004 * drm_get_tv_mode_from_name - Translates a TV mode name into its enum value 1005 * @name: TV Mode name we want to convert 1006 * @len: Length of @name 1007 * 1008 * Translates @name into an enum drm_connector_tv_mode. 1009 * 1010 * Returns: the enum value on success, a negative errno otherwise. 1011 */ 1012int drm_get_tv_mode_from_name(const char *name, size_t len) 1013{ 1014 unsigned int i; 1015 1016 for (i = 0; i < ARRAY_SIZE(drm_tv_mode_enum_list); i++) { 1017 const struct drm_prop_enum_list *item = &drm_tv_mode_enum_list[i]; 1018 1019 if (strlen(item->name) == len && !strncmp(item->name, name, len)) 1020 return item->type; 1021 } 1022 1023 return -EINVAL; 1024} 1025EXPORT_SYMBOL(drm_get_tv_mode_from_name); 1026 1027static const struct drm_prop_enum_list drm_tv_select_enum_list[] = { 1028 { DRM_MODE_SUBCONNECTOR_Automatic, "Automatic" }, /* DVI-I and TV-out */ 1029 { DRM_MODE_SUBCONNECTOR_Composite, "Composite" }, /* TV-out */ 1030 { DRM_MODE_SUBCONNECTOR_SVIDEO, "SVIDEO" }, /* TV-out */ 1031 { DRM_MODE_SUBCONNECTOR_Component, "Component" }, /* TV-out */ 1032 { DRM_MODE_SUBCONNECTOR_SCART, "SCART" }, /* TV-out */ 1033}; 1034DRM_ENUM_NAME_FN(drm_get_tv_select_name, drm_tv_select_enum_list) 1035 1036static const struct drm_prop_enum_list drm_tv_subconnector_enum_list[] = { 1037 { DRM_MODE_SUBCONNECTOR_Unknown, "Unknown" }, /* DVI-I, TV-out and DP */ 1038 { DRM_MODE_SUBCONNECTOR_Composite, "Composite" }, /* TV-out */ 1039 { DRM_MODE_SUBCONNECTOR_SVIDEO, "SVIDEO" }, /* TV-out */ 1040 { DRM_MODE_SUBCONNECTOR_Component, "Component" }, /* TV-out */ 1041 { DRM_MODE_SUBCONNECTOR_SCART, "SCART" }, /* TV-out */ 1042}; 1043DRM_ENUM_NAME_FN(drm_get_tv_subconnector_name, 1044 drm_tv_subconnector_enum_list) 1045 1046static const struct drm_prop_enum_list drm_dp_subconnector_enum_list[] = { 1047 { DRM_MODE_SUBCONNECTOR_Unknown, "Unknown" }, /* DVI-I, TV-out and DP */ 1048 { DRM_MODE_SUBCONNECTOR_VGA, "VGA" }, /* DP */ 1049 { DRM_MODE_SUBCONNECTOR_DVID, "DVI-D" }, /* DP */ 1050 { DRM_MODE_SUBCONNECTOR_HDMIA, "HDMI" }, /* DP */ 1051 { DRM_MODE_SUBCONNECTOR_DisplayPort, "DP" }, /* DP */ 1052 { DRM_MODE_SUBCONNECTOR_Wireless, "Wireless" }, /* DP */ 1053 { DRM_MODE_SUBCONNECTOR_Native, "Native" }, /* DP */ 1054}; 1055 1056DRM_ENUM_NAME_FN(drm_get_dp_subconnector_name, 1057 drm_dp_subconnector_enum_list) 1058 1059 1060static const char * const colorspace_names[] = { 1061 /* For Default case, driver will set the colorspace */ 1062 [DRM_MODE_COLORIMETRY_DEFAULT] = "Default", 1063 /* Standard Definition Colorimetry based on CEA 861 */ 1064 [DRM_MODE_COLORIMETRY_SMPTE_170M_YCC] = "SMPTE_170M_YCC", 1065 [DRM_MODE_COLORIMETRY_BT709_YCC] = "BT709_YCC", 1066 /* Standard Definition Colorimetry based on IEC 61966-2-4 */ 1067 [DRM_MODE_COLORIMETRY_XVYCC_601] = "XVYCC_601", 1068 /* High Definition Colorimetry based on IEC 61966-2-4 */ 1069 [DRM_MODE_COLORIMETRY_XVYCC_709] = "XVYCC_709", 1070 /* Colorimetry based on IEC 61966-2-1/Amendment 1 */ 1071 [DRM_MODE_COLORIMETRY_SYCC_601] = "SYCC_601", 1072 /* Colorimetry based on IEC 61966-2-5 [33] */ 1073 [DRM_MODE_COLORIMETRY_OPYCC_601] = "opYCC_601", 1074 /* Colorimetry based on IEC 61966-2-5 */ 1075 [DRM_MODE_COLORIMETRY_OPRGB] = "opRGB", 1076 /* Colorimetry based on ITU-R BT.2020 */ 1077 [DRM_MODE_COLORIMETRY_BT2020_CYCC] = "BT2020_CYCC", 1078 /* Colorimetry based on ITU-R BT.2020 */ 1079 [DRM_MODE_COLORIMETRY_BT2020_RGB] = "BT2020_RGB", 1080 /* Colorimetry based on ITU-R BT.2020 */ 1081 [DRM_MODE_COLORIMETRY_BT2020_YCC] = "BT2020_YCC", 1082 /* Added as part of Additional Colorimetry Extension in 861.G */ 1083 [DRM_MODE_COLORIMETRY_DCI_P3_RGB_D65] = "DCI-P3_RGB_D65", 1084 [DRM_MODE_COLORIMETRY_DCI_P3_RGB_THEATER] = "DCI-P3_RGB_Theater", 1085 [DRM_MODE_COLORIMETRY_RGB_WIDE_FIXED] = "RGB_WIDE_FIXED", 1086 /* Colorimetry based on scRGB (IEC 61966-2-2) */ 1087 [DRM_MODE_COLORIMETRY_RGB_WIDE_FLOAT] = "RGB_WIDE_FLOAT", 1088 [DRM_MODE_COLORIMETRY_BT601_YCC] = "BT601_YCC", 1089}; 1090 1091/** 1092 * drm_get_colorspace_name - return a string for color encoding 1093 * @colorspace: color space to compute name of 1094 * 1095 * In contrast to the other drm_get_*_name functions this one here returns a 1096 * const pointer and hence is threadsafe. 1097 */ 1098const char *drm_get_colorspace_name(enum drm_colorspace colorspace) 1099{ 1100 if (colorspace < ARRAY_SIZE(colorspace_names) && colorspace_names[colorspace]) 1101 return colorspace_names[colorspace]; 1102 else 1103 return "(null)"; 1104} 1105 1106static const u32 hdmi_colorspaces = 1107 BIT(DRM_MODE_COLORIMETRY_SMPTE_170M_YCC) | 1108 BIT(DRM_MODE_COLORIMETRY_BT709_YCC) | 1109 BIT(DRM_MODE_COLORIMETRY_XVYCC_601) | 1110 BIT(DRM_MODE_COLORIMETRY_XVYCC_709) | 1111 BIT(DRM_MODE_COLORIMETRY_SYCC_601) | 1112 BIT(DRM_MODE_COLORIMETRY_OPYCC_601) | 1113 BIT(DRM_MODE_COLORIMETRY_OPRGB) | 1114 BIT(DRM_MODE_COLORIMETRY_BT2020_CYCC) | 1115 BIT(DRM_MODE_COLORIMETRY_BT2020_RGB) | 1116 BIT(DRM_MODE_COLORIMETRY_BT2020_YCC) | 1117 BIT(DRM_MODE_COLORIMETRY_DCI_P3_RGB_D65) | 1118 BIT(DRM_MODE_COLORIMETRY_DCI_P3_RGB_THEATER); 1119 1120/* 1121 * As per DP 1.4a spec, 2.2.5.7.5 VSC SDP Payload for Pixel Encoding/Colorimetry 1122 * Format Table 2-120 1123 */ 1124static const u32 dp_colorspaces = 1125 BIT(DRM_MODE_COLORIMETRY_RGB_WIDE_FIXED) | 1126 BIT(DRM_MODE_COLORIMETRY_RGB_WIDE_FLOAT) | 1127 BIT(DRM_MODE_COLORIMETRY_OPRGB) | 1128 BIT(DRM_MODE_COLORIMETRY_DCI_P3_RGB_D65) | 1129 BIT(DRM_MODE_COLORIMETRY_BT2020_RGB) | 1130 BIT(DRM_MODE_COLORIMETRY_BT601_YCC) | 1131 BIT(DRM_MODE_COLORIMETRY_BT709_YCC) | 1132 BIT(DRM_MODE_COLORIMETRY_XVYCC_601) | 1133 BIT(DRM_MODE_COLORIMETRY_XVYCC_709) | 1134 BIT(DRM_MODE_COLORIMETRY_SYCC_601) | 1135 BIT(DRM_MODE_COLORIMETRY_OPYCC_601) | 1136 BIT(DRM_MODE_COLORIMETRY_BT2020_CYCC) | 1137 BIT(DRM_MODE_COLORIMETRY_BT2020_YCC); 1138 1139/** 1140 * DOC: standard connector properties 1141 * 1142 * DRM connectors have a few standardized properties: 1143 * 1144 * EDID: 1145 * Blob property which contains the current EDID read from the sink. This 1146 * is useful to parse sink identification information like vendor, model 1147 * and serial. Drivers should update this property by calling 1148 * drm_connector_update_edid_property(), usually after having parsed 1149 * the EDID using drm_add_edid_modes(). Userspace cannot change this 1150 * property. 1151 * 1152 * User-space should not parse the EDID to obtain information exposed via 1153 * other KMS properties (because the kernel might apply limits, quirks or 1154 * fixups to the EDID). For instance, user-space should not try to parse 1155 * mode lists from the EDID. 1156 * DPMS: 1157 * Legacy property for setting the power state of the connector. For atomic 1158 * drivers this is only provided for backwards compatibility with existing 1159 * drivers, it remaps to controlling the "ACTIVE" property on the CRTC the 1160 * connector is linked to. Drivers should never set this property directly, 1161 * it is handled by the DRM core by calling the &drm_connector_funcs.dpms 1162 * callback. For atomic drivers the remapping to the "ACTIVE" property is 1163 * implemented in the DRM core. 1164 * 1165 * Note that this property cannot be set through the MODE_ATOMIC ioctl, 1166 * userspace must use "ACTIVE" on the CRTC instead. 1167 * 1168 * WARNING: 1169 * 1170 * For userspace also running on legacy drivers the "DPMS" semantics are a 1171 * lot more complicated. First, userspace cannot rely on the "DPMS" value 1172 * returned by the GETCONNECTOR actually reflecting reality, because many 1173 * drivers fail to update it. For atomic drivers this is taken care of in 1174 * drm_atomic_helper_update_legacy_modeset_state(). 1175 * 1176 * The second issue is that the DPMS state is only well-defined when the 1177 * connector is connected to a CRTC. In atomic the DRM core enforces that 1178 * "ACTIVE" is off in such a case, no such checks exists for "DPMS". 1179 * 1180 * Finally, when enabling an output using the legacy SETCONFIG ioctl then 1181 * "DPMS" is forced to ON. But see above, that might not be reflected in 1182 * the software value on legacy drivers. 1183 * 1184 * Summarizing: Only set "DPMS" when the connector is known to be enabled, 1185 * assume that a successful SETCONFIG call also sets "DPMS" to on, and 1186 * never read back the value of "DPMS" because it can be incorrect. 1187 * PATH: 1188 * Connector path property to identify how this sink is physically 1189 * connected. Used by DP MST. This should be set by calling 1190 * drm_connector_set_path_property(), in the case of DP MST with the 1191 * path property the MST manager created. Userspace cannot change this 1192 * property. 1193 * TILE: 1194 * Connector tile group property to indicate how a set of DRM connector 1195 * compose together into one logical screen. This is used by both high-res 1196 * external screens (often only using a single cable, but exposing multiple 1197 * DP MST sinks), or high-res integrated panels (like dual-link DSI) which 1198 * are not gen-locked. Note that for tiled panels which are genlocked, like 1199 * dual-link LVDS or dual-link DSI, the driver should try to not expose the 1200 * tiling and virtualise both &drm_crtc and &drm_plane if needed. Drivers 1201 * should update this value using drm_connector_set_tile_property(). 1202 * Userspace cannot change this property. 1203 * link-status: 1204 * Connector link-status property to indicate the status of link. The 1205 * default value of link-status is "GOOD". If something fails during or 1206 * after modeset, the kernel driver may set this to "BAD" and issue a 1207 * hotplug uevent. Drivers should update this value using 1208 * drm_connector_set_link_status_property(). 1209 * 1210 * When user-space receives the hotplug uevent and detects a "BAD" 1211 * link-status, the sink doesn't receive pixels anymore (e.g. the screen 1212 * becomes completely black). The list of available modes may have 1213 * changed. User-space is expected to pick a new mode if the current one 1214 * has disappeared and perform a new modeset with link-status set to 1215 * "GOOD" to re-enable the connector. 1216 * 1217 * If multiple connectors share the same CRTC and one of them gets a "BAD" 1218 * link-status, the other are unaffected (ie. the sinks still continue to 1219 * receive pixels). 1220 * 1221 * When user-space performs an atomic commit on a connector with a "BAD" 1222 * link-status without resetting the property to "GOOD", the sink may 1223 * still not receive pixels. When user-space performs an atomic commit 1224 * which resets the link-status property to "GOOD" without the 1225 * ALLOW_MODESET flag set, it might fail because a modeset is required. 1226 * 1227 * User-space can only change link-status to "GOOD", changing it to "BAD" 1228 * is a no-op. 1229 * 1230 * For backwards compatibility with non-atomic userspace the kernel 1231 * tries to automatically set the link-status back to "GOOD" in the 1232 * SETCRTC IOCTL. This might fail if the mode is no longer valid, similar 1233 * to how it might fail if a different screen has been connected in the 1234 * interim. 1235 * non_desktop: 1236 * Indicates the output should be ignored for purposes of displaying a 1237 * standard desktop environment or console. This is most likely because 1238 * the output device is not rectilinear. 1239 * Content Protection: 1240 * This property is used by userspace to request the kernel protect future 1241 * content communicated over the link. When requested, kernel will apply 1242 * the appropriate means of protection (most often HDCP), and use the 1243 * property to tell userspace the protection is active. 1244 * 1245 * Drivers can set this up by calling 1246 * drm_connector_attach_content_protection_property() on initialization. 1247 * 1248 * The value of this property can be one of the following: 1249 * 1250 * DRM_MODE_CONTENT_PROTECTION_UNDESIRED = 0 1251 * The link is not protected, content is transmitted in the clear. 1252 * DRM_MODE_CONTENT_PROTECTION_DESIRED = 1 1253 * Userspace has requested content protection, but the link is not 1254 * currently protected. When in this state, kernel should enable 1255 * Content Protection as soon as possible. 1256 * DRM_MODE_CONTENT_PROTECTION_ENABLED = 2 1257 * Userspace has requested content protection, and the link is 1258 * protected. Only the driver can set the property to this value. 1259 * If userspace attempts to set to ENABLED, kernel will return 1260 * -EINVAL. 1261 * 1262 * A few guidelines: 1263 * 1264 * - DESIRED state should be preserved until userspace de-asserts it by 1265 * setting the property to UNDESIRED. This means ENABLED should only 1266 * transition to UNDESIRED when the user explicitly requests it. 1267 * - If the state is DESIRED, kernel should attempt to re-authenticate the 1268 * link whenever possible. This includes across disable/enable, dpms, 1269 * hotplug, downstream device changes, link status failures, etc.. 1270 * - Kernel sends uevent with the connector id and property id through 1271 * @drm_hdcp_update_content_protection, upon below kernel triggered 1272 * scenarios: 1273 * 1274 * - DESIRED -> ENABLED (authentication success) 1275 * - ENABLED -> DESIRED (termination of authentication) 1276 * - Please note no uevents for userspace triggered property state changes, 1277 * which can't fail such as 1278 * 1279 * - DESIRED/ENABLED -> UNDESIRED 1280 * - UNDESIRED -> DESIRED 1281 * - Userspace is responsible for polling the property or listen to uevents 1282 * to determine when the value transitions from ENABLED to DESIRED. 1283 * This signifies the link is no longer protected and userspace should 1284 * take appropriate action (whatever that might be). 1285 * 1286 * HDCP Content Type: 1287 * This Enum property is used by the userspace to declare the content type 1288 * of the display stream, to kernel. Here display stream stands for any 1289 * display content that userspace intended to display through HDCP 1290 * encryption. 1291 * 1292 * Content Type of a stream is decided by the owner of the stream, as 1293 * "HDCP Type0" or "HDCP Type1". 1294 * 1295 * The value of the property can be one of the below: 1296 * - "HDCP Type0": DRM_MODE_HDCP_CONTENT_TYPE0 = 0 1297 * - "HDCP Type1": DRM_MODE_HDCP_CONTENT_TYPE1 = 1 1298 * 1299 * When kernel starts the HDCP authentication (see "Content Protection" 1300 * for details), it uses the content type in "HDCP Content Type" 1301 * for performing the HDCP authentication with the display sink. 1302 * 1303 * Please note in HDCP spec versions, a link can be authenticated with 1304 * HDCP 2.2 for Content Type 0/Content Type 1. Where as a link can be 1305 * authenticated with HDCP1.4 only for Content Type 0(though it is implicit 1306 * in nature. As there is no reference for Content Type in HDCP1.4). 1307 * 1308 * HDCP2.2 authentication protocol itself takes the "Content Type" as a 1309 * parameter, which is a input for the DP HDCP2.2 encryption algo. 1310 * 1311 * In case of Type 0 content protection request, kernel driver can choose 1312 * either of HDCP spec versions 1.4 and 2.2. When HDCP2.2 is used for 1313 * "HDCP Type 0", a HDCP 2.2 capable repeater in the downstream can send 1314 * that content to a HDCP 1.4 authenticated HDCP sink (Type0 link). 1315 * But if the content is classified as "HDCP Type 1", above mentioned 1316 * HDCP 2.2 repeater wont send the content to the HDCP sink as it can't 1317 * authenticate the HDCP1.4 capable sink for "HDCP Type 1". 1318 * 1319 * Please note userspace can be ignorant of the HDCP versions used by the 1320 * kernel driver to achieve the "HDCP Content Type". 1321 * 1322 * At current scenario, classifying a content as Type 1 ensures that the 1323 * content will be displayed only through the HDCP2.2 encrypted link. 1324 * 1325 * Note that the HDCP Content Type property is introduced at HDCP 2.2, and 1326 * defaults to type 0. It is only exposed by drivers supporting HDCP 2.2 1327 * (hence supporting Type 0 and Type 1). Based on how next versions of 1328 * HDCP specs are defined content Type could be used for higher versions 1329 * too. 1330 * 1331 * If content type is changed when "Content Protection" is not UNDESIRED, 1332 * then kernel will disable the HDCP and re-enable with new type in the 1333 * same atomic commit. And when "Content Protection" is ENABLED, it means 1334 * that link is HDCP authenticated and encrypted, for the transmission of 1335 * the Type of stream mentioned at "HDCP Content Type". 1336 * 1337 * HDR_OUTPUT_METADATA: 1338 * Connector property to enable userspace to send HDR Metadata to 1339 * driver. This metadata is based on the composition and blending 1340 * policies decided by user, taking into account the hardware and 1341 * sink capabilities. The driver gets this metadata and creates a 1342 * Dynamic Range and Mastering Infoframe (DRM) in case of HDMI, 1343 * SDP packet (Non-audio INFOFRAME SDP v1.3) for DP. This is then 1344 * sent to sink. This notifies the sink of the upcoming frame's Color 1345 * Encoding and Luminance parameters. 1346 * 1347 * Userspace first need to detect the HDR capabilities of sink by 1348 * reading and parsing the EDID. Details of HDR metadata for HDMI 1349 * are added in CTA 861.G spec. For DP , its defined in VESA DP 1350 * Standard v1.4. It needs to then get the metadata information 1351 * of the video/game/app content which are encoded in HDR (basically 1352 * using HDR transfer functions). With this information it needs to 1353 * decide on a blending policy and compose the relevant 1354 * layers/overlays into a common format. Once this blending is done, 1355 * userspace will be aware of the metadata of the composed frame to 1356 * be send to sink. It then uses this property to communicate this 1357 * metadata to driver which then make a Infoframe packet and sends 1358 * to sink based on the type of encoder connected. 1359 * 1360 * Userspace will be responsible to do Tone mapping operation in case: 1361 * - Some layers are HDR and others are SDR 1362 * - HDR layers luminance is not same as sink 1363 * 1364 * It will even need to do colorspace conversion and get all layers 1365 * to one common colorspace for blending. It can use either GL, Media 1366 * or display engine to get this done based on the capabilities of the 1367 * associated hardware. 1368 * 1369 * Driver expects metadata to be put in &struct hdr_output_metadata 1370 * structure from userspace. This is received as blob and stored in 1371 * &drm_connector_state.hdr_output_metadata. It parses EDID and saves the 1372 * sink metadata in &struct hdr_sink_metadata, as 1373 * &drm_connector.hdr_sink_metadata. Driver uses 1374 * drm_hdmi_infoframe_set_hdr_metadata() helper to set the HDR metadata, 1375 * hdmi_drm_infoframe_pack() to pack the infoframe as per spec, in case of 1376 * HDMI encoder. 1377 * 1378 * max bpc: 1379 * This range property is used by userspace to limit the bit depth. When 1380 * used the driver would limit the bpc in accordance with the valid range 1381 * supported by the hardware and sink. Drivers to use the function 1382 * drm_connector_attach_max_bpc_property() to create and attach the 1383 * property to the connector during initialization. 1384 * 1385 * Connectors also have one standardized atomic property: 1386 * 1387 * CRTC_ID: 1388 * Mode object ID of the &drm_crtc this connector should be connected to. 1389 * 1390 * Connectors for LCD panels may also have one standardized property: 1391 * 1392 * panel orientation: 1393 * On some devices the LCD panel is mounted in the casing in such a way 1394 * that the up/top side of the panel does not match with the top side of 1395 * the device. Userspace can use this property to check for this. 1396 * Note that input coordinates from touchscreens (input devices with 1397 * INPUT_PROP_DIRECT) will still map 1:1 to the actual LCD panel 1398 * coordinates, so if userspace rotates the picture to adjust for 1399 * the orientation it must also apply the same transformation to the 1400 * touchscreen input coordinates. This property is initialized by calling 1401 * drm_connector_set_panel_orientation() or 1402 * drm_connector_set_panel_orientation_with_quirk() 1403 * 1404 * scaling mode: 1405 * This property defines how a non-native mode is upscaled to the native 1406 * mode of an LCD panel: 1407 * 1408 * None: 1409 * No upscaling happens, scaling is left to the panel. Not all 1410 * drivers expose this mode. 1411 * Full: 1412 * The output is upscaled to the full resolution of the panel, 1413 * ignoring the aspect ratio. 1414 * Center: 1415 * No upscaling happens, the output is centered within the native 1416 * resolution the panel. 1417 * Full aspect: 1418 * The output is upscaled to maximize either the width or height 1419 * while retaining the aspect ratio. 1420 * 1421 * This property should be set up by calling 1422 * drm_connector_attach_scaling_mode_property(). Note that drivers 1423 * can also expose this property to external outputs, in which case they 1424 * must support "None", which should be the default (since external screens 1425 * have a built-in scaler). 1426 * 1427 * subconnector: 1428 * This property is used by DVI-I, TVout and DisplayPort to indicate different 1429 * connector subtypes. Enum values more or less match with those from main 1430 * connector types. 1431 * For DVI-I and TVout there is also a matching property "select subconnector" 1432 * allowing to switch between signal types. 1433 * DP subconnector corresponds to a downstream port. 1434 * 1435 * privacy-screen sw-state, privacy-screen hw-state: 1436 * These 2 optional properties can be used to query the state of the 1437 * electronic privacy screen that is available on some displays; and in 1438 * some cases also control the state. If a driver implements these 1439 * properties then both properties must be present. 1440 * 1441 * "privacy-screen hw-state" is read-only and reflects the actual state 1442 * of the privacy-screen, possible values: "Enabled", "Disabled, 1443 * "Enabled-locked", "Disabled-locked". The locked states indicate 1444 * that the state cannot be changed through the DRM API. E.g. there 1445 * might be devices where the firmware-setup options, or a hardware 1446 * slider-switch, offer always on / off modes. 1447 * 1448 * "privacy-screen sw-state" can be set to change the privacy-screen state 1449 * when not locked. In this case the driver must update the hw-state 1450 * property to reflect the new state on completion of the commit of the 1451 * sw-state property. Setting the sw-state property when the hw-state is 1452 * locked must be interpreted by the driver as a request to change the 1453 * state to the set state when the hw-state becomes unlocked. E.g. if 1454 * "privacy-screen hw-state" is "Enabled-locked" and the sw-state 1455 * gets set to "Disabled" followed by the user unlocking the state by 1456 * changing the slider-switch position, then the driver must set the 1457 * state to "Disabled" upon receiving the unlock event. 1458 * 1459 * In some cases the privacy-screen's actual state might change outside of 1460 * control of the DRM code. E.g. there might be a firmware handled hotkey 1461 * which toggles the actual state, or the actual state might be changed 1462 * through another userspace API such as writing /proc/acpi/ibm/lcdshadow. 1463 * In this case the driver must update both the hw-state and the sw-state 1464 * to reflect the new value, overwriting any pending state requests in the 1465 * sw-state. Any pending sw-state requests are thus discarded. 1466 * 1467 * Note that the ability for the state to change outside of control of 1468 * the DRM master process means that userspace must not cache the value 1469 * of the sw-state. Caching the sw-state value and including it in later 1470 * atomic commits may lead to overriding a state change done through e.g. 1471 * a firmware handled hotkey. Therefor userspace must not include the 1472 * privacy-screen sw-state in an atomic commit unless it wants to change 1473 * its value. 1474 * 1475 * left margin, right margin, top margin, bottom margin: 1476 * Add margins to the connector's viewport. This is typically used to 1477 * mitigate overscan on TVs. 1478 * 1479 * The value is the size in pixels of the black border which will be 1480 * added. The attached CRTC's content will be scaled to fill the whole 1481 * area inside the margin. 1482 * 1483 * The margins configuration might be sent to the sink, e.g. via HDMI AVI 1484 * InfoFrames. 1485 * 1486 * Drivers can set up these properties by calling 1487 * drm_mode_create_tv_margin_properties(). 1488 */ 1489 1490int drm_connector_create_standard_properties(struct drm_device *dev) 1491{ 1492 struct drm_property *prop; 1493 1494 prop = drm_property_create(dev, DRM_MODE_PROP_BLOB | 1495 DRM_MODE_PROP_IMMUTABLE, 1496 "EDID", 0); 1497 if (!prop) 1498 return -ENOMEM; 1499 dev->mode_config.edid_property = prop; 1500 1501 prop = drm_property_create_enum(dev, 0, 1502 "DPMS", drm_dpms_enum_list, 1503 ARRAY_SIZE(drm_dpms_enum_list)); 1504 if (!prop) 1505 return -ENOMEM; 1506 dev->mode_config.dpms_property = prop; 1507 1508 prop = drm_property_create(dev, 1509 DRM_MODE_PROP_BLOB | 1510 DRM_MODE_PROP_IMMUTABLE, 1511 "PATH", 0); 1512 if (!prop) 1513 return -ENOMEM; 1514 dev->mode_config.path_property = prop; 1515 1516 prop = drm_property_create(dev, 1517 DRM_MODE_PROP_BLOB | 1518 DRM_MODE_PROP_IMMUTABLE, 1519 "TILE", 0); 1520 if (!prop) 1521 return -ENOMEM; 1522 dev->mode_config.tile_property = prop; 1523 1524 prop = drm_property_create_enum(dev, 0, "link-status", 1525 drm_link_status_enum_list, 1526 ARRAY_SIZE(drm_link_status_enum_list)); 1527 if (!prop) 1528 return -ENOMEM; 1529 dev->mode_config.link_status_property = prop; 1530 1531 prop = drm_property_create_bool(dev, DRM_MODE_PROP_IMMUTABLE, "non-desktop"); 1532 if (!prop) 1533 return -ENOMEM; 1534 dev->mode_config.non_desktop_property = prop; 1535 1536 prop = drm_property_create(dev, DRM_MODE_PROP_BLOB, 1537 "HDR_OUTPUT_METADATA", 0); 1538 if (!prop) 1539 return -ENOMEM; 1540 dev->mode_config.hdr_output_metadata_property = prop; 1541 1542 return 0; 1543} 1544 1545/** 1546 * drm_mode_create_dvi_i_properties - create DVI-I specific connector properties 1547 * @dev: DRM device 1548 * 1549 * Called by a driver the first time a DVI-I connector is made. 1550 * 1551 * Returns: %0 1552 */ 1553int drm_mode_create_dvi_i_properties(struct drm_device *dev) 1554{ 1555 struct drm_property *dvi_i_selector; 1556 struct drm_property *dvi_i_subconnector; 1557 1558 if (dev->mode_config.dvi_i_select_subconnector_property) 1559 return 0; 1560 1561 dvi_i_selector = 1562 drm_property_create_enum(dev, 0, 1563 "select subconnector", 1564 drm_dvi_i_select_enum_list, 1565 ARRAY_SIZE(drm_dvi_i_select_enum_list)); 1566 dev->mode_config.dvi_i_select_subconnector_property = dvi_i_selector; 1567 1568 dvi_i_subconnector = drm_property_create_enum(dev, DRM_MODE_PROP_IMMUTABLE, 1569 "subconnector", 1570 drm_dvi_i_subconnector_enum_list, 1571 ARRAY_SIZE(drm_dvi_i_subconnector_enum_list)); 1572 dev->mode_config.dvi_i_subconnector_property = dvi_i_subconnector; 1573 1574 return 0; 1575} 1576EXPORT_SYMBOL(drm_mode_create_dvi_i_properties); 1577 1578/** 1579 * drm_connector_attach_dp_subconnector_property - create subconnector property for DP 1580 * @connector: drm_connector to attach property 1581 * 1582 * Called by a driver when DP connector is created. 1583 */ 1584void drm_connector_attach_dp_subconnector_property(struct drm_connector *connector) 1585{ 1586 struct drm_mode_config *mode_config = &connector->dev->mode_config; 1587 1588 if (!mode_config->dp_subconnector_property) 1589 mode_config->dp_subconnector_property = 1590 drm_property_create_enum(connector->dev, 1591 DRM_MODE_PROP_IMMUTABLE, 1592 "subconnector", 1593 drm_dp_subconnector_enum_list, 1594 ARRAY_SIZE(drm_dp_subconnector_enum_list)); 1595 1596 drm_object_attach_property(&connector->base, 1597 mode_config->dp_subconnector_property, 1598 DRM_MODE_SUBCONNECTOR_Unknown); 1599} 1600EXPORT_SYMBOL(drm_connector_attach_dp_subconnector_property); 1601 1602/** 1603 * DOC: HDMI connector properties 1604 * 1605 * content type (HDMI specific): 1606 * Indicates content type setting to be used in HDMI infoframes to indicate 1607 * content type for the external device, so that it adjusts its display 1608 * settings accordingly. 1609 * 1610 * The value of this property can be one of the following: 1611 * 1612 * No Data: 1613 * Content type is unknown 1614 * Graphics: 1615 * Content type is graphics 1616 * Photo: 1617 * Content type is photo 1618 * Cinema: 1619 * Content type is cinema 1620 * Game: 1621 * Content type is game 1622 * 1623 * The meaning of each content type is defined in CTA-861-G table 15. 1624 * 1625 * Drivers can set up this property by calling 1626 * drm_connector_attach_content_type_property(). Decoding to 1627 * infoframe values is done through drm_hdmi_avi_infoframe_content_type(). 1628 */ 1629 1630/* 1631 * TODO: Document the properties: 1632 * - brightness 1633 * - contrast 1634 * - flicker reduction 1635 * - hue 1636 * - mode 1637 * - overscan 1638 * - saturation 1639 * - select subconnector 1640 */ 1641/** 1642 * DOC: Analog TV Connector Properties 1643 * 1644 * TV Mode: 1645 * Indicates the TV Mode used on an analog TV connector. The value 1646 * of this property can be one of the following: 1647 * 1648 * NTSC: 1649 * TV Mode is CCIR System M (aka 525-lines) together with 1650 * the NTSC Color Encoding. 1651 * 1652 * NTSC-443: 1653 * 1654 * TV Mode is CCIR System M (aka 525-lines) together with 1655 * the NTSC Color Encoding, but with a color subcarrier 1656 * frequency of 4.43MHz 1657 * 1658 * NTSC-J: 1659 * 1660 * TV Mode is CCIR System M (aka 525-lines) together with 1661 * the NTSC Color Encoding, but with a black level equal to 1662 * the blanking level. 1663 * 1664 * PAL: 1665 * 1666 * TV Mode is CCIR System B (aka 625-lines) together with 1667 * the PAL Color Encoding. 1668 * 1669 * PAL-M: 1670 * 1671 * TV Mode is CCIR System M (aka 525-lines) together with 1672 * the PAL Color Encoding. 1673 * 1674 * PAL-N: 1675 * 1676 * TV Mode is CCIR System N together with the PAL Color 1677 * Encoding, a color subcarrier frequency of 3.58MHz, the 1678 * SECAM color space, and narrower channels than other PAL 1679 * variants. 1680 * 1681 * SECAM: 1682 * 1683 * TV Mode is CCIR System B (aka 625-lines) together with 1684 * the SECAM Color Encoding. 1685 * 1686 * Drivers can set up this property by calling 1687 * drm_mode_create_tv_properties(). 1688 */ 1689 1690/** 1691 * drm_connector_attach_content_type_property - attach content-type property 1692 * @connector: connector to attach content type property on. 1693 * 1694 * Called by a driver the first time a HDMI connector is made. 1695 * 1696 * Returns: %0 1697 */ 1698int drm_connector_attach_content_type_property(struct drm_connector *connector) 1699{ 1700 if (!drm_mode_create_content_type_property(connector->dev)) 1701 drm_object_attach_property(&connector->base, 1702 connector->dev->mode_config.content_type_property, 1703 DRM_MODE_CONTENT_TYPE_NO_DATA); 1704 return 0; 1705} 1706EXPORT_SYMBOL(drm_connector_attach_content_type_property); 1707 1708/** 1709 * drm_connector_attach_tv_margin_properties - attach TV connector margin 1710 * properties 1711 * @connector: DRM connector 1712 * 1713 * Called by a driver when it needs to attach TV margin props to a connector. 1714 * Typically used on SDTV and HDMI connectors. 1715 */ 1716void drm_connector_attach_tv_margin_properties(struct drm_connector *connector) 1717{ 1718 struct drm_device *dev = connector->dev; 1719 1720 drm_object_attach_property(&connector->base, 1721 dev->mode_config.tv_left_margin_property, 1722 0); 1723 drm_object_attach_property(&connector->base, 1724 dev->mode_config.tv_right_margin_property, 1725 0); 1726 drm_object_attach_property(&connector->base, 1727 dev->mode_config.tv_top_margin_property, 1728 0); 1729 drm_object_attach_property(&connector->base, 1730 dev->mode_config.tv_bottom_margin_property, 1731 0); 1732} 1733EXPORT_SYMBOL(drm_connector_attach_tv_margin_properties); 1734 1735/** 1736 * drm_mode_create_tv_margin_properties - create TV connector margin properties 1737 * @dev: DRM device 1738 * 1739 * Called by a driver's HDMI connector initialization routine, this function 1740 * creates the TV margin properties for a given device. No need to call this 1741 * function for an SDTV connector, it's already called from 1742 * drm_mode_create_tv_properties_legacy(). 1743 * 1744 * Returns: 1745 * 0 on success or a negative error code on failure. 1746 */ 1747int drm_mode_create_tv_margin_properties(struct drm_device *dev) 1748{ 1749 if (dev->mode_config.tv_left_margin_property) 1750 return 0; 1751 1752 dev->mode_config.tv_left_margin_property = 1753 drm_property_create_range(dev, 0, "left margin", 0, 100); 1754 if (!dev->mode_config.tv_left_margin_property) 1755 return -ENOMEM; 1756 1757 dev->mode_config.tv_right_margin_property = 1758 drm_property_create_range(dev, 0, "right margin", 0, 100); 1759 if (!dev->mode_config.tv_right_margin_property) 1760 return -ENOMEM; 1761 1762 dev->mode_config.tv_top_margin_property = 1763 drm_property_create_range(dev, 0, "top margin", 0, 100); 1764 if (!dev->mode_config.tv_top_margin_property) 1765 return -ENOMEM; 1766 1767 dev->mode_config.tv_bottom_margin_property = 1768 drm_property_create_range(dev, 0, "bottom margin", 0, 100); 1769 if (!dev->mode_config.tv_bottom_margin_property) 1770 return -ENOMEM; 1771 1772 return 0; 1773} 1774EXPORT_SYMBOL(drm_mode_create_tv_margin_properties); 1775 1776/** 1777 * drm_mode_create_tv_properties_legacy - create TV specific connector properties 1778 * @dev: DRM device 1779 * @num_modes: number of different TV formats (modes) supported 1780 * @modes: array of pointers to strings containing name of each format 1781 * 1782 * Called by a driver's TV initialization routine, this function creates 1783 * the TV specific connector properties for a given device. Caller is 1784 * responsible for allocating a list of format names and passing them to 1785 * this routine. 1786 * 1787 * NOTE: This functions registers the deprecated "mode" connector 1788 * property to select the analog TV mode (ie, NTSC, PAL, etc.). New 1789 * drivers must use drm_mode_create_tv_properties() instead. 1790 * 1791 * Returns: 1792 * 0 on success or a negative error code on failure. 1793 */ 1794int drm_mode_create_tv_properties_legacy(struct drm_device *dev, 1795 unsigned int num_modes, 1796 const char * const modes[]) 1797{ 1798 struct drm_property *tv_selector; 1799 struct drm_property *tv_subconnector; 1800 unsigned int i; 1801 1802 if (dev->mode_config.tv_select_subconnector_property) 1803 return 0; 1804 1805 /* 1806 * Basic connector properties 1807 */ 1808 tv_selector = drm_property_create_enum(dev, 0, 1809 "select subconnector", 1810 drm_tv_select_enum_list, 1811 ARRAY_SIZE(drm_tv_select_enum_list)); 1812 if (!tv_selector) 1813 goto nomem; 1814 1815 dev->mode_config.tv_select_subconnector_property = tv_selector; 1816 1817 tv_subconnector = 1818 drm_property_create_enum(dev, DRM_MODE_PROP_IMMUTABLE, 1819 "subconnector", 1820 drm_tv_subconnector_enum_list, 1821 ARRAY_SIZE(drm_tv_subconnector_enum_list)); 1822 if (!tv_subconnector) 1823 goto nomem; 1824 dev->mode_config.tv_subconnector_property = tv_subconnector; 1825 1826 /* 1827 * Other, TV specific properties: margins & TV modes. 1828 */ 1829 if (drm_mode_create_tv_margin_properties(dev)) 1830 goto nomem; 1831 1832 if (num_modes) { 1833 dev->mode_config.legacy_tv_mode_property = 1834 drm_property_create(dev, DRM_MODE_PROP_ENUM, 1835 "mode", num_modes); 1836 if (!dev->mode_config.legacy_tv_mode_property) 1837 goto nomem; 1838 1839 for (i = 0; i < num_modes; i++) 1840 drm_property_add_enum(dev->mode_config.legacy_tv_mode_property, 1841 i, modes[i]); 1842 } 1843 1844 dev->mode_config.tv_brightness_property = 1845 drm_property_create_range(dev, 0, "brightness", 0, 100); 1846 if (!dev->mode_config.tv_brightness_property) 1847 goto nomem; 1848 1849 dev->mode_config.tv_contrast_property = 1850 drm_property_create_range(dev, 0, "contrast", 0, 100); 1851 if (!dev->mode_config.tv_contrast_property) 1852 goto nomem; 1853 1854 dev->mode_config.tv_flicker_reduction_property = 1855 drm_property_create_range(dev, 0, "flicker reduction", 0, 100); 1856 if (!dev->mode_config.tv_flicker_reduction_property) 1857 goto nomem; 1858 1859 dev->mode_config.tv_overscan_property = 1860 drm_property_create_range(dev, 0, "overscan", 0, 100); 1861 if (!dev->mode_config.tv_overscan_property) 1862 goto nomem; 1863 1864 dev->mode_config.tv_saturation_property = 1865 drm_property_create_range(dev, 0, "saturation", 0, 100); 1866 if (!dev->mode_config.tv_saturation_property) 1867 goto nomem; 1868 1869 dev->mode_config.tv_hue_property = 1870 drm_property_create_range(dev, 0, "hue", 0, 100); 1871 if (!dev->mode_config.tv_hue_property) 1872 goto nomem; 1873 1874 return 0; 1875nomem: 1876 return -ENOMEM; 1877} 1878EXPORT_SYMBOL(drm_mode_create_tv_properties_legacy); 1879 1880/** 1881 * drm_mode_create_tv_properties - create TV specific connector properties 1882 * @dev: DRM device 1883 * @supported_tv_modes: Bitmask of TV modes supported (See DRM_MODE_TV_MODE_*) 1884 * 1885 * Called by a driver's TV initialization routine, this function creates 1886 * the TV specific connector properties for a given device. 1887 * 1888 * Returns: 1889 * 0 on success or a negative error code on failure. 1890 */ 1891int drm_mode_create_tv_properties(struct drm_device *dev, 1892 unsigned int supported_tv_modes) 1893{ 1894 struct drm_prop_enum_list tv_mode_list[DRM_MODE_TV_MODE_MAX]; 1895 struct drm_property *tv_mode; 1896 unsigned int i, len = 0; 1897 1898 if (dev->mode_config.tv_mode_property) 1899 return 0; 1900 1901 for (i = 0; i < DRM_MODE_TV_MODE_MAX; i++) { 1902 if (!(supported_tv_modes & BIT(i))) 1903 continue; 1904 1905 tv_mode_list[len].type = i; 1906 tv_mode_list[len].name = drm_get_tv_mode_name(i); 1907 len++; 1908 } 1909 1910 tv_mode = drm_property_create_enum(dev, 0, "TV mode", 1911 tv_mode_list, len); 1912 if (!tv_mode) 1913 return -ENOMEM; 1914 1915 dev->mode_config.tv_mode_property = tv_mode; 1916 1917 return drm_mode_create_tv_properties_legacy(dev, 0, NULL); 1918} 1919EXPORT_SYMBOL(drm_mode_create_tv_properties); 1920 1921/** 1922 * drm_mode_create_scaling_mode_property - create scaling mode property 1923 * @dev: DRM device 1924 * 1925 * Called by a driver the first time it's needed, must be attached to desired 1926 * connectors. 1927 * 1928 * Atomic drivers should use drm_connector_attach_scaling_mode_property() 1929 * instead to correctly assign &drm_connector_state.scaling_mode 1930 * in the atomic state. 1931 * 1932 * Returns: %0 1933 */ 1934int drm_mode_create_scaling_mode_property(struct drm_device *dev) 1935{ 1936 struct drm_property *scaling_mode; 1937 1938 if (dev->mode_config.scaling_mode_property) 1939 return 0; 1940 1941 scaling_mode = 1942 drm_property_create_enum(dev, 0, "scaling mode", 1943 drm_scaling_mode_enum_list, 1944 ARRAY_SIZE(drm_scaling_mode_enum_list)); 1945 1946 dev->mode_config.scaling_mode_property = scaling_mode; 1947 1948 return 0; 1949} 1950EXPORT_SYMBOL(drm_mode_create_scaling_mode_property); 1951 1952/** 1953 * DOC: Variable refresh properties 1954 * 1955 * Variable refresh rate capable displays can dynamically adjust their 1956 * refresh rate by extending the duration of their vertical front porch 1957 * until page flip or timeout occurs. This can reduce or remove stuttering 1958 * and latency in scenarios where the page flip does not align with the 1959 * vblank interval. 1960 * 1961 * An example scenario would be an application flipping at a constant rate 1962 * of 48Hz on a 60Hz display. The page flip will frequently miss the vblank 1963 * interval and the same contents will be displayed twice. This can be 1964 * observed as stuttering for content with motion. 1965 * 1966 * If variable refresh rate was active on a display that supported a 1967 * variable refresh range from 35Hz to 60Hz no stuttering would be observable 1968 * for the example scenario. The minimum supported variable refresh rate of 1969 * 35Hz is below the page flip frequency and the vertical front porch can 1970 * be extended until the page flip occurs. The vblank interval will be 1971 * directly aligned to the page flip rate. 1972 * 1973 * Not all userspace content is suitable for use with variable refresh rate. 1974 * Large and frequent changes in vertical front porch duration may worsen 1975 * perceived stuttering for input sensitive applications. 1976 * 1977 * Panel brightness will also vary with vertical front porch duration. Some 1978 * panels may have noticeable differences in brightness between the minimum 1979 * vertical front porch duration and the maximum vertical front porch duration. 1980 * Large and frequent changes in vertical front porch duration may produce 1981 * observable flickering for such panels. 1982 * 1983 * Userspace control for variable refresh rate is supported via properties 1984 * on the &drm_connector and &drm_crtc objects. 1985 * 1986 * "vrr_capable": 1987 * Optional &drm_connector boolean property that drivers should attach 1988 * with drm_connector_attach_vrr_capable_property() on connectors that 1989 * could support variable refresh rates. Drivers should update the 1990 * property value by calling drm_connector_set_vrr_capable_property(). 1991 * 1992 * Absence of the property should indicate absence of support. 1993 * 1994 * "VRR_ENABLED": 1995 * Default &drm_crtc boolean property that notifies the driver that the 1996 * content on the CRTC is suitable for variable refresh rate presentation. 1997 * The driver will take this property as a hint to enable variable 1998 * refresh rate support if the receiver supports it, ie. if the 1999 * "vrr_capable" property is true on the &drm_connector object. The 2000 * vertical front porch duration will be extended until page-flip or 2001 * timeout when enabled. 2002 * 2003 * The minimum vertical front porch duration is defined as the vertical 2004 * front porch duration for the current mode. 2005 * 2006 * The maximum vertical front porch duration is greater than or equal to 2007 * the minimum vertical front porch duration. The duration is derived 2008 * from the minimum supported variable refresh rate for the connector. 2009 * 2010 * The driver may place further restrictions within these minimum 2011 * and maximum bounds. 2012 */ 2013 2014/** 2015 * drm_connector_attach_vrr_capable_property - creates the 2016 * vrr_capable property 2017 * @connector: connector to create the vrr_capable property on. 2018 * 2019 * This is used by atomic drivers to add support for querying 2020 * variable refresh rate capability for a connector. 2021 * 2022 * Returns: 2023 * Zero on success, negative errno on failure. 2024 */ 2025int drm_connector_attach_vrr_capable_property( 2026 struct drm_connector *connector) 2027{ 2028 struct drm_device *dev = connector->dev; 2029 struct drm_property *prop; 2030 2031 if (!connector->vrr_capable_property) { 2032 prop = drm_property_create_bool(dev, DRM_MODE_PROP_IMMUTABLE, 2033 "vrr_capable"); 2034 if (!prop) 2035 return -ENOMEM; 2036 2037 connector->vrr_capable_property = prop; 2038 drm_object_attach_property(&connector->base, prop, 0); 2039 } 2040 2041 return 0; 2042} 2043EXPORT_SYMBOL(drm_connector_attach_vrr_capable_property); 2044 2045/** 2046 * drm_connector_attach_scaling_mode_property - attach atomic scaling mode property 2047 * @connector: connector to attach scaling mode property on. 2048 * @scaling_mode_mask: or'ed mask of BIT(%DRM_MODE_SCALE_\*). 2049 * 2050 * This is used to add support for scaling mode to atomic drivers. 2051 * The scaling mode will be set to &drm_connector_state.scaling_mode 2052 * and can be used from &drm_connector_helper_funcs->atomic_check for validation. 2053 * 2054 * This is the atomic version of drm_mode_create_scaling_mode_property(). 2055 * 2056 * Returns: 2057 * Zero on success, negative errno on failure. 2058 */ 2059int drm_connector_attach_scaling_mode_property(struct drm_connector *connector, 2060 u32 scaling_mode_mask) 2061{ 2062 struct drm_device *dev = connector->dev; 2063 struct drm_property *scaling_mode_property; 2064 int i; 2065 const unsigned valid_scaling_mode_mask = 2066 (1U << ARRAY_SIZE(drm_scaling_mode_enum_list)) - 1; 2067 2068 if (WARN_ON(hweight32(scaling_mode_mask) < 2 || 2069 scaling_mode_mask & ~valid_scaling_mode_mask)) 2070 return -EINVAL; 2071 2072 scaling_mode_property = 2073 drm_property_create(dev, DRM_MODE_PROP_ENUM, "scaling mode", 2074 hweight32(scaling_mode_mask)); 2075 2076 if (!scaling_mode_property) 2077 return -ENOMEM; 2078 2079 for (i = 0; i < ARRAY_SIZE(drm_scaling_mode_enum_list); i++) { 2080 int ret; 2081 2082 if (!(BIT(i) & scaling_mode_mask)) 2083 continue; 2084 2085 ret = drm_property_add_enum(scaling_mode_property, 2086 drm_scaling_mode_enum_list[i].type, 2087 drm_scaling_mode_enum_list[i].name); 2088 2089 if (ret) { 2090 drm_property_destroy(dev, scaling_mode_property); 2091 2092 return ret; 2093 } 2094 } 2095 2096 drm_object_attach_property(&connector->base, 2097 scaling_mode_property, 0); 2098 2099 connector->scaling_mode_property = scaling_mode_property; 2100 2101 return 0; 2102} 2103EXPORT_SYMBOL(drm_connector_attach_scaling_mode_property); 2104 2105/** 2106 * drm_mode_create_aspect_ratio_property - create aspect ratio property 2107 * @dev: DRM device 2108 * 2109 * Called by a driver the first time it's needed, must be attached to desired 2110 * connectors. 2111 * 2112 * Returns: 2113 * Zero on success, negative errno on failure. 2114 */ 2115int drm_mode_create_aspect_ratio_property(struct drm_device *dev) 2116{ 2117 if (dev->mode_config.aspect_ratio_property) 2118 return 0; 2119 2120 dev->mode_config.aspect_ratio_property = 2121 drm_property_create_enum(dev, 0, "aspect ratio", 2122 drm_aspect_ratio_enum_list, 2123 ARRAY_SIZE(drm_aspect_ratio_enum_list)); 2124 2125 if (dev->mode_config.aspect_ratio_property == NULL) 2126 return -ENOMEM; 2127 2128 return 0; 2129} 2130EXPORT_SYMBOL(drm_mode_create_aspect_ratio_property); 2131 2132/** 2133 * DOC: standard connector properties 2134 * 2135 * Colorspace: 2136 * This property helps select a suitable colorspace based on the sink 2137 * capability. Modern sink devices support wider gamut like BT2020. 2138 * This helps switch to BT2020 mode if the BT2020 encoded video stream 2139 * is being played by the user, same for any other colorspace. Thereby 2140 * giving a good visual experience to users. 2141 * 2142 * The expectation from userspace is that it should parse the EDID 2143 * and get supported colorspaces. Use this property and switch to the 2144 * one supported. Sink supported colorspaces should be retrieved by 2145 * userspace from EDID and driver will not explicitly expose them. 2146 * 2147 * Basically the expectation from userspace is: 2148 * - Set up CRTC DEGAMMA/CTM/GAMMA to convert to some sink 2149 * colorspace 2150 * - Set this new property to let the sink know what it 2151 * converted the CRTC output to. 2152 * - This property is just to inform sink what colorspace 2153 * source is trying to drive. 2154 * 2155 * Because between HDMI and DP have different colorspaces, 2156 * drm_mode_create_hdmi_colorspace_property() is used for HDMI connector and 2157 * drm_mode_create_dp_colorspace_property() is used for DP connector. 2158 */ 2159 2160static int drm_mode_create_colorspace_property(struct drm_connector *connector, 2161 u32 supported_colorspaces) 2162{ 2163 struct drm_device *dev = connector->dev; 2164 u32 colorspaces = supported_colorspaces | BIT(DRM_MODE_COLORIMETRY_DEFAULT); 2165 struct drm_prop_enum_list enum_list[DRM_MODE_COLORIMETRY_COUNT]; 2166 int i, len; 2167 2168 if (connector->colorspace_property) 2169 return 0; 2170 2171 if (!supported_colorspaces) { 2172 drm_err(dev, "No supported colorspaces provded on [CONNECTOR:%d:%s]\n", 2173 connector->base.id, connector->name); 2174 return -EINVAL; 2175 } 2176 2177 if ((supported_colorspaces & -BIT(DRM_MODE_COLORIMETRY_COUNT)) != 0) { 2178 drm_err(dev, "Unknown colorspace provded on [CONNECTOR:%d:%s]\n", 2179 connector->base.id, connector->name); 2180 return -EINVAL; 2181 } 2182 2183 len = 0; 2184 for (i = 0; i < DRM_MODE_COLORIMETRY_COUNT; i++) { 2185 if ((colorspaces & BIT(i)) == 0) 2186 continue; 2187 2188 enum_list[len].type = i; 2189 enum_list[len].name = colorspace_names[i]; 2190 len++; 2191 } 2192 2193 connector->colorspace_property = 2194 drm_property_create_enum(dev, DRM_MODE_PROP_ENUM, "Colorspace", 2195 enum_list, 2196 len); 2197 2198 if (!connector->colorspace_property) 2199 return -ENOMEM; 2200 2201 return 0; 2202} 2203 2204/** 2205 * drm_mode_create_hdmi_colorspace_property - create hdmi colorspace property 2206 * @connector: connector to create the Colorspace property on. 2207 * @supported_colorspaces: bitmap of supported color spaces 2208 * 2209 * Called by a driver the first time it's needed, must be attached to desired 2210 * HDMI connectors. 2211 * 2212 * Returns: 2213 * Zero on success, negative errno on failure. 2214 */ 2215int drm_mode_create_hdmi_colorspace_property(struct drm_connector *connector, 2216 u32 supported_colorspaces) 2217{ 2218 u32 colorspaces; 2219 2220 if (supported_colorspaces) 2221 colorspaces = supported_colorspaces & hdmi_colorspaces; 2222 else 2223 colorspaces = hdmi_colorspaces; 2224 2225 return drm_mode_create_colorspace_property(connector, colorspaces); 2226} 2227EXPORT_SYMBOL(drm_mode_create_hdmi_colorspace_property); 2228 2229/** 2230 * drm_mode_create_dp_colorspace_property - create dp colorspace property 2231 * @connector: connector to create the Colorspace property on. 2232 * @supported_colorspaces: bitmap of supported color spaces 2233 * 2234 * Called by a driver the first time it's needed, must be attached to desired 2235 * DP connectors. 2236 * 2237 * Returns: 2238 * Zero on success, negative errno on failure. 2239 */ 2240int drm_mode_create_dp_colorspace_property(struct drm_connector *connector, 2241 u32 supported_colorspaces) 2242{ 2243 u32 colorspaces; 2244 2245 if (supported_colorspaces) 2246 colorspaces = supported_colorspaces & dp_colorspaces; 2247 else 2248 colorspaces = dp_colorspaces; 2249 2250 return drm_mode_create_colorspace_property(connector, colorspaces); 2251} 2252EXPORT_SYMBOL(drm_mode_create_dp_colorspace_property); 2253 2254/** 2255 * drm_mode_create_content_type_property - create content type property 2256 * @dev: DRM device 2257 * 2258 * Called by a driver the first time it's needed, must be attached to desired 2259 * connectors. 2260 * 2261 * Returns: 2262 * Zero on success, negative errno on failure. 2263 */ 2264int drm_mode_create_content_type_property(struct drm_device *dev) 2265{ 2266 if (dev->mode_config.content_type_property) 2267 return 0; 2268 2269 dev->mode_config.content_type_property = 2270 drm_property_create_enum(dev, 0, "content type", 2271 drm_content_type_enum_list, 2272 ARRAY_SIZE(drm_content_type_enum_list)); 2273 2274 if (dev->mode_config.content_type_property == NULL) 2275 return -ENOMEM; 2276 2277 return 0; 2278} 2279EXPORT_SYMBOL(drm_mode_create_content_type_property); 2280 2281/** 2282 * drm_mode_create_suggested_offset_properties - create suggests offset properties 2283 * @dev: DRM device 2284 * 2285 * Create the suggested x/y offset property for connectors. 2286 * 2287 * Returns: 2288 * 0 on success or a negative error code on failure. 2289 */ 2290int drm_mode_create_suggested_offset_properties(struct drm_device *dev) 2291{ 2292 if (dev->mode_config.suggested_x_property && dev->mode_config.suggested_y_property) 2293 return 0; 2294 2295 dev->mode_config.suggested_x_property = 2296 drm_property_create_range(dev, DRM_MODE_PROP_IMMUTABLE, "suggested X", 0, 0xffffffff); 2297 2298 dev->mode_config.suggested_y_property = 2299 drm_property_create_range(dev, DRM_MODE_PROP_IMMUTABLE, "suggested Y", 0, 0xffffffff); 2300 2301 if (dev->mode_config.suggested_x_property == NULL || 2302 dev->mode_config.suggested_y_property == NULL) 2303 return -ENOMEM; 2304 return 0; 2305} 2306EXPORT_SYMBOL(drm_mode_create_suggested_offset_properties); 2307 2308/** 2309 * drm_connector_set_path_property - set tile property on connector 2310 * @connector: connector to set property on. 2311 * @path: path to use for property; must not be NULL. 2312 * 2313 * This creates a property to expose to userspace to specify a 2314 * connector path. This is mainly used for DisplayPort MST where 2315 * connectors have a topology and we want to allow userspace to give 2316 * them more meaningful names. 2317 * 2318 * Returns: 2319 * Zero on success, negative errno on failure. 2320 */ 2321int drm_connector_set_path_property(struct drm_connector *connector, 2322 const char *path) 2323{ 2324 struct drm_device *dev = connector->dev; 2325 int ret; 2326 2327 ret = drm_property_replace_global_blob(dev, 2328 &connector->path_blob_ptr, 2329 strlen(path) + 1, 2330 path, 2331 &connector->base, 2332 dev->mode_config.path_property); 2333 return ret; 2334} 2335EXPORT_SYMBOL(drm_connector_set_path_property); 2336 2337/** 2338 * drm_connector_set_tile_property - set tile property on connector 2339 * @connector: connector to set property on. 2340 * 2341 * This looks up the tile information for a connector, and creates a 2342 * property for userspace to parse if it exists. The property is of 2343 * the form of 8 integers using ':' as a separator. 2344 * This is used for dual port tiled displays with DisplayPort SST 2345 * or DisplayPort MST connectors. 2346 * 2347 * Returns: 2348 * Zero on success, errno on failure. 2349 */ 2350int drm_connector_set_tile_property(struct drm_connector *connector) 2351{ 2352 struct drm_device *dev = connector->dev; 2353 char tile[256]; 2354 int ret; 2355 2356 if (!connector->has_tile) { 2357 ret = drm_property_replace_global_blob(dev, 2358 &connector->tile_blob_ptr, 2359 0, 2360 NULL, 2361 &connector->base, 2362 dev->mode_config.tile_property); 2363 return ret; 2364 } 2365 2366 snprintf(tile, 256, "%d:%d:%d:%d:%d:%d:%d:%d", 2367 connector->tile_group->id, connector->tile_is_single_monitor, 2368 connector->num_h_tile, connector->num_v_tile, 2369 connector->tile_h_loc, connector->tile_v_loc, 2370 connector->tile_h_size, connector->tile_v_size); 2371 2372 ret = drm_property_replace_global_blob(dev, 2373 &connector->tile_blob_ptr, 2374 strlen(tile) + 1, 2375 tile, 2376 &connector->base, 2377 dev->mode_config.tile_property); 2378 return ret; 2379} 2380EXPORT_SYMBOL(drm_connector_set_tile_property); 2381 2382/** 2383 * drm_connector_set_link_status_property - Set link status property of a connector 2384 * @connector: drm connector 2385 * @link_status: new value of link status property (0: Good, 1: Bad) 2386 * 2387 * In usual working scenario, this link status property will always be set to 2388 * "GOOD". If something fails during or after a mode set, the kernel driver 2389 * may set this link status property to "BAD". The caller then needs to send a 2390 * hotplug uevent for userspace to re-check the valid modes through 2391 * GET_CONNECTOR_IOCTL and retry modeset. 2392 * 2393 * Note: Drivers cannot rely on userspace to support this property and 2394 * issue a modeset. As such, they may choose to handle issues (like 2395 * re-training a link) without userspace's intervention. 2396 * 2397 * The reason for adding this property is to handle link training failures, but 2398 * it is not limited to DP or link training. For example, if we implement 2399 * asynchronous setcrtc, this property can be used to report any failures in that. 2400 */ 2401void drm_connector_set_link_status_property(struct drm_connector *connector, 2402 uint64_t link_status) 2403{ 2404 struct drm_device *dev = connector->dev; 2405 2406 drm_modeset_lock(&dev->mode_config.connection_mutex, NULL); 2407 connector->state->link_status = link_status; 2408 drm_modeset_unlock(&dev->mode_config.connection_mutex); 2409} 2410EXPORT_SYMBOL(drm_connector_set_link_status_property); 2411 2412/** 2413 * drm_connector_attach_max_bpc_property - attach "max bpc" property 2414 * @connector: connector to attach max bpc property on. 2415 * @min: The minimum bit depth supported by the connector. 2416 * @max: The maximum bit depth supported by the connector. 2417 * 2418 * This is used to add support for limiting the bit depth on a connector. 2419 * 2420 * Returns: 2421 * Zero on success, negative errno on failure. 2422 */ 2423int drm_connector_attach_max_bpc_property(struct drm_connector *connector, 2424 int min, int max) 2425{ 2426 struct drm_device *dev = connector->dev; 2427 struct drm_property *prop; 2428 2429 prop = connector->max_bpc_property; 2430 if (!prop) { 2431 prop = drm_property_create_range(dev, 0, "max bpc", min, max); 2432 if (!prop) 2433 return -ENOMEM; 2434 2435 connector->max_bpc_property = prop; 2436 } 2437 2438 drm_object_attach_property(&connector->base, prop, max); 2439 connector->state->max_requested_bpc = max; 2440 connector->state->max_bpc = max; 2441 2442 return 0; 2443} 2444EXPORT_SYMBOL(drm_connector_attach_max_bpc_property); 2445 2446/** 2447 * drm_connector_attach_hdr_output_metadata_property - attach "HDR_OUTPUT_METADA" property 2448 * @connector: connector to attach the property on. 2449 * 2450 * This is used to allow the userspace to send HDR Metadata to the 2451 * driver. 2452 * 2453 * Returns: 2454 * Zero on success, negative errno on failure. 2455 */ 2456int drm_connector_attach_hdr_output_metadata_property(struct drm_connector *connector) 2457{ 2458 struct drm_device *dev = connector->dev; 2459 struct drm_property *prop = dev->mode_config.hdr_output_metadata_property; 2460 2461 drm_object_attach_property(&connector->base, prop, 0); 2462 2463 return 0; 2464} 2465EXPORT_SYMBOL(drm_connector_attach_hdr_output_metadata_property); 2466 2467/** 2468 * drm_connector_attach_colorspace_property - attach "Colorspace" property 2469 * @connector: connector to attach the property on. 2470 * 2471 * This is used to allow the userspace to signal the output colorspace 2472 * to the driver. 2473 * 2474 * Returns: 2475 * Zero on success, negative errno on failure. 2476 */ 2477int drm_connector_attach_colorspace_property(struct drm_connector *connector) 2478{ 2479 struct drm_property *prop = connector->colorspace_property; 2480 2481 drm_object_attach_property(&connector->base, prop, DRM_MODE_COLORIMETRY_DEFAULT); 2482 2483 return 0; 2484} 2485EXPORT_SYMBOL(drm_connector_attach_colorspace_property); 2486 2487/** 2488 * drm_connector_atomic_hdr_metadata_equal - checks if the hdr metadata changed 2489 * @old_state: old connector state to compare 2490 * @new_state: new connector state to compare 2491 * 2492 * This is used by HDR-enabled drivers to test whether the HDR metadata 2493 * have changed between two different connector state (and thus probably 2494 * requires a full blown mode change). 2495 * 2496 * Returns: 2497 * True if the metadata are equal, False otherwise 2498 */ 2499bool drm_connector_atomic_hdr_metadata_equal(struct drm_connector_state *old_state, 2500 struct drm_connector_state *new_state) 2501{ 2502 struct drm_property_blob *old_blob = old_state->hdr_output_metadata; 2503 struct drm_property_blob *new_blob = new_state->hdr_output_metadata; 2504 2505 if (!old_blob || !new_blob) 2506 return old_blob == new_blob; 2507 2508 if (old_blob->length != new_blob->length) 2509 return false; 2510 2511 return !memcmp(old_blob->data, new_blob->data, old_blob->length); 2512} 2513EXPORT_SYMBOL(drm_connector_atomic_hdr_metadata_equal); 2514 2515/** 2516 * drm_connector_set_vrr_capable_property - sets the variable refresh rate 2517 * capable property for a connector 2518 * @connector: drm connector 2519 * @capable: True if the connector is variable refresh rate capable 2520 * 2521 * Should be used by atomic drivers to update the indicated support for 2522 * variable refresh rate over a connector. 2523 */ 2524void drm_connector_set_vrr_capable_property( 2525 struct drm_connector *connector, bool capable) 2526{ 2527 if (!connector->vrr_capable_property) 2528 return; 2529 2530 drm_object_property_set_value(&connector->base, 2531 connector->vrr_capable_property, 2532 capable); 2533} 2534EXPORT_SYMBOL(drm_connector_set_vrr_capable_property); 2535 2536/** 2537 * drm_connector_set_panel_orientation - sets the connector's panel_orientation 2538 * @connector: connector for which to set the panel-orientation property. 2539 * @panel_orientation: drm_panel_orientation value to set 2540 * 2541 * This function sets the connector's panel_orientation and attaches 2542 * a "panel orientation" property to the connector. 2543 * 2544 * Calling this function on a connector where the panel_orientation has 2545 * already been set is a no-op (e.g. the orientation has been overridden with 2546 * a kernel commandline option). 2547 * 2548 * It is allowed to call this function with a panel_orientation of 2549 * DRM_MODE_PANEL_ORIENTATION_UNKNOWN, in which case it is a no-op. 2550 * 2551 * The function shouldn't be called in panel after drm is registered (i.e. 2552 * drm_dev_register() is called in drm). 2553 * 2554 * Returns: 2555 * Zero on success, negative errno on failure. 2556 */ 2557int drm_connector_set_panel_orientation( 2558 struct drm_connector *connector, 2559 enum drm_panel_orientation panel_orientation) 2560{ 2561 struct drm_device *dev = connector->dev; 2562 struct drm_display_info *info = &connector->display_info; 2563 struct drm_property *prop; 2564 2565 /* Already set? */ 2566 if (info->panel_orientation != DRM_MODE_PANEL_ORIENTATION_UNKNOWN) 2567 return 0; 2568 2569 /* Don't attach the property if the orientation is unknown */ 2570 if (panel_orientation == DRM_MODE_PANEL_ORIENTATION_UNKNOWN) 2571 return 0; 2572 2573 info->panel_orientation = panel_orientation; 2574 2575 prop = dev->mode_config.panel_orientation_property; 2576 if (!prop) { 2577 prop = drm_property_create_enum(dev, DRM_MODE_PROP_IMMUTABLE, 2578 "panel orientation", 2579 drm_panel_orientation_enum_list, 2580 ARRAY_SIZE(drm_panel_orientation_enum_list)); 2581 if (!prop) 2582 return -ENOMEM; 2583 2584 dev->mode_config.panel_orientation_property = prop; 2585 } 2586 2587 drm_object_attach_property(&connector->base, prop, 2588 info->panel_orientation); 2589 return 0; 2590} 2591EXPORT_SYMBOL(drm_connector_set_panel_orientation); 2592 2593/** 2594 * drm_connector_set_panel_orientation_with_quirk - set the 2595 * connector's panel_orientation after checking for quirks 2596 * @connector: connector for which to init the panel-orientation property. 2597 * @panel_orientation: drm_panel_orientation value to set 2598 * @width: width in pixels of the panel, used for panel quirk detection 2599 * @height: height in pixels of the panel, used for panel quirk detection 2600 * 2601 * Like drm_connector_set_panel_orientation(), but with a check for platform 2602 * specific (e.g. DMI based) quirks overriding the passed in panel_orientation. 2603 * 2604 * Returns: 2605 * Zero on success, negative errno on failure. 2606 */ 2607int drm_connector_set_panel_orientation_with_quirk( 2608 struct drm_connector *connector, 2609 enum drm_panel_orientation panel_orientation, 2610 int width, int height) 2611{ 2612 int orientation_quirk; 2613 2614 orientation_quirk = drm_get_panel_orientation_quirk(width, height); 2615 if (orientation_quirk != DRM_MODE_PANEL_ORIENTATION_UNKNOWN) 2616 panel_orientation = orientation_quirk; 2617 2618 return drm_connector_set_panel_orientation(connector, 2619 panel_orientation); 2620} 2621EXPORT_SYMBOL(drm_connector_set_panel_orientation_with_quirk); 2622 2623/** 2624 * drm_connector_set_orientation_from_panel - 2625 * set the connector's panel_orientation from panel's callback. 2626 * @connector: connector for which to init the panel-orientation property. 2627 * @panel: panel that can provide orientation information. 2628 * 2629 * Drm drivers should call this function before drm_dev_register(). 2630 * Orientation is obtained from panel's .get_orientation() callback. 2631 * 2632 * Returns: 2633 * Zero on success, negative errno on failure. 2634 */ 2635int drm_connector_set_orientation_from_panel( 2636 struct drm_connector *connector, 2637 struct drm_panel *panel) 2638{ 2639 enum drm_panel_orientation orientation; 2640 2641 if (panel && panel->funcs && panel->funcs->get_orientation) 2642 orientation = panel->funcs->get_orientation(panel); 2643 else 2644 orientation = DRM_MODE_PANEL_ORIENTATION_UNKNOWN; 2645 2646 return drm_connector_set_panel_orientation(connector, orientation); 2647} 2648EXPORT_SYMBOL(drm_connector_set_orientation_from_panel); 2649 2650static const struct drm_prop_enum_list privacy_screen_enum[] = { 2651 { PRIVACY_SCREEN_DISABLED, "Disabled" }, 2652 { PRIVACY_SCREEN_ENABLED, "Enabled" }, 2653 { PRIVACY_SCREEN_DISABLED_LOCKED, "Disabled-locked" }, 2654 { PRIVACY_SCREEN_ENABLED_LOCKED, "Enabled-locked" }, 2655}; 2656 2657/** 2658 * drm_connector_create_privacy_screen_properties - create the drm connecter's 2659 * privacy-screen properties. 2660 * @connector: connector for which to create the privacy-screen properties 2661 * 2662 * This function creates the "privacy-screen sw-state" and "privacy-screen 2663 * hw-state" properties for the connector. They are not attached. 2664 */ 2665void 2666drm_connector_create_privacy_screen_properties(struct drm_connector *connector) 2667{ 2668 if (connector->privacy_screen_sw_state_property) 2669 return; 2670 2671 /* Note sw-state only supports the first 2 values of the enum */ 2672 connector->privacy_screen_sw_state_property = 2673 drm_property_create_enum(connector->dev, DRM_MODE_PROP_ENUM, 2674 "privacy-screen sw-state", 2675 privacy_screen_enum, 2); 2676 2677 connector->privacy_screen_hw_state_property = 2678 drm_property_create_enum(connector->dev, 2679 DRM_MODE_PROP_IMMUTABLE | DRM_MODE_PROP_ENUM, 2680 "privacy-screen hw-state", 2681 privacy_screen_enum, 2682 ARRAY_SIZE(privacy_screen_enum)); 2683} 2684EXPORT_SYMBOL(drm_connector_create_privacy_screen_properties); 2685 2686/** 2687 * drm_connector_attach_privacy_screen_properties - attach the drm connecter's 2688 * privacy-screen properties. 2689 * @connector: connector on which to attach the privacy-screen properties 2690 * 2691 * This function attaches the "privacy-screen sw-state" and "privacy-screen 2692 * hw-state" properties to the connector. The initial state of both is set 2693 * to "Disabled". 2694 */ 2695void 2696drm_connector_attach_privacy_screen_properties(struct drm_connector *connector) 2697{ 2698 if (!connector->privacy_screen_sw_state_property) 2699 return; 2700 2701 drm_object_attach_property(&connector->base, 2702 connector->privacy_screen_sw_state_property, 2703 PRIVACY_SCREEN_DISABLED); 2704 2705 drm_object_attach_property(&connector->base, 2706 connector->privacy_screen_hw_state_property, 2707 PRIVACY_SCREEN_DISABLED); 2708} 2709EXPORT_SYMBOL(drm_connector_attach_privacy_screen_properties); 2710 2711static void drm_connector_update_privacy_screen_properties( 2712 struct drm_connector *connector, bool set_sw_state) 2713{ 2714 enum drm_privacy_screen_status sw_state, hw_state; 2715 2716 drm_privacy_screen_get_state(connector->privacy_screen, 2717 &sw_state, &hw_state); 2718 2719 if (set_sw_state) 2720 connector->state->privacy_screen_sw_state = sw_state; 2721 drm_object_property_set_value(&connector->base, 2722 connector->privacy_screen_hw_state_property, hw_state); 2723} 2724 2725static int drm_connector_privacy_screen_notifier( 2726 struct notifier_block *nb, unsigned long action, void *data) 2727{ 2728 struct drm_connector *connector = 2729 container_of(nb, struct drm_connector, privacy_screen_notifier); 2730 struct drm_device *dev = connector->dev; 2731 2732 drm_modeset_lock(&dev->mode_config.connection_mutex, NULL); 2733 drm_connector_update_privacy_screen_properties(connector, true); 2734 drm_modeset_unlock(&dev->mode_config.connection_mutex); 2735 2736 drm_sysfs_connector_property_event(connector, 2737 connector->privacy_screen_sw_state_property); 2738 drm_sysfs_connector_property_event(connector, 2739 connector->privacy_screen_hw_state_property); 2740 2741 return NOTIFY_DONE; 2742} 2743 2744/** 2745 * drm_connector_attach_privacy_screen_provider - attach a privacy-screen to 2746 * the connector 2747 * @connector: connector to attach the privacy-screen to 2748 * @priv: drm_privacy_screen to attach 2749 * 2750 * Create and attach the standard privacy-screen properties and register 2751 * a generic notifier for generating sysfs-connector-status-events 2752 * on external changes to the privacy-screen status. 2753 * This function takes ownership of the passed in drm_privacy_screen and will 2754 * call drm_privacy_screen_put() on it when the connector is destroyed. 2755 */ 2756void drm_connector_attach_privacy_screen_provider( 2757 struct drm_connector *connector, struct drm_privacy_screen *priv) 2758{ 2759 connector->privacy_screen = priv; 2760 connector->privacy_screen_notifier.notifier_call = 2761 drm_connector_privacy_screen_notifier; 2762 2763 drm_connector_create_privacy_screen_properties(connector); 2764 drm_connector_update_privacy_screen_properties(connector, true); 2765 drm_connector_attach_privacy_screen_properties(connector); 2766} 2767EXPORT_SYMBOL(drm_connector_attach_privacy_screen_provider); 2768 2769/** 2770 * drm_connector_update_privacy_screen - update connector's privacy-screen sw-state 2771 * @connector_state: connector-state to update the privacy-screen for 2772 * 2773 * This function calls drm_privacy_screen_set_sw_state() on the connector's 2774 * privacy-screen. 2775 * 2776 * If the connector has no privacy-screen, then this is a no-op. 2777 */ 2778void drm_connector_update_privacy_screen(const struct drm_connector_state *connector_state) 2779{ 2780 struct drm_connector *connector = connector_state->connector; 2781 int ret; 2782 2783 if (!connector->privacy_screen) 2784 return; 2785 2786 ret = drm_privacy_screen_set_sw_state(connector->privacy_screen, 2787 connector_state->privacy_screen_sw_state); 2788 if (ret) { 2789 drm_err(connector->dev, "Error updating privacy-screen sw_state\n"); 2790 return; 2791 } 2792 2793 /* The hw_state property value may have changed, update it. */ 2794 drm_connector_update_privacy_screen_properties(connector, false); 2795} 2796EXPORT_SYMBOL(drm_connector_update_privacy_screen); 2797 2798int drm_connector_set_obj_prop(struct drm_mode_object *obj, 2799 struct drm_property *property, 2800 uint64_t value) 2801{ 2802 int ret = -EINVAL; 2803 struct drm_connector *connector = obj_to_connector(obj); 2804 2805 /* Do DPMS ourselves */ 2806 if (property == connector->dev->mode_config.dpms_property) { 2807 ret = (*connector->funcs->dpms)(connector, (int)value); 2808#ifdef __OpenBSD__ 2809 } else if (property == connector->backlight_property) { 2810 connector->backlight_device->props.brightness = value; 2811 backlight_schedule_update_status(connector->backlight_device); 2812 knote_locked(&connector->dev->note, NOTE_CHANGE); 2813 ret = 0; 2814#endif 2815 } else if (connector->funcs->set_property) 2816 ret = connector->funcs->set_property(connector, property, value); 2817 2818 if (!ret) 2819 drm_object_property_set_value(&connector->base, property, value); 2820 return ret; 2821} 2822 2823int drm_connector_property_set_ioctl(struct drm_device *dev, 2824 void *data, struct drm_file *file_priv) 2825{ 2826 struct drm_mode_connector_set_property *conn_set_prop = data; 2827 struct drm_mode_obj_set_property obj_set_prop = { 2828 .value = conn_set_prop->value, 2829 .prop_id = conn_set_prop->prop_id, 2830 .obj_id = conn_set_prop->connector_id, 2831 .obj_type = DRM_MODE_OBJECT_CONNECTOR 2832 }; 2833 2834 /* It does all the locking and checking we need */ 2835 return drm_mode_obj_set_property_ioctl(dev, &obj_set_prop, file_priv); 2836} 2837 2838static struct drm_encoder *drm_connector_get_encoder(struct drm_connector *connector) 2839{ 2840 /* For atomic drivers only state objects are synchronously updated and 2841 * protected by modeset locks, so check those first. 2842 */ 2843 if (connector->state) 2844 return connector->state->best_encoder; 2845 return connector->encoder; 2846} 2847 2848static bool 2849drm_mode_expose_to_userspace(const struct drm_display_mode *mode, 2850 const struct list_head *modes, 2851 const struct drm_file *file_priv) 2852{ 2853 /* 2854 * If user-space hasn't configured the driver to expose the stereo 3D 2855 * modes, don't expose them. 2856 */ 2857 if (!file_priv->stereo_allowed && drm_mode_is_stereo(mode)) 2858 return false; 2859 /* 2860 * If user-space hasn't configured the driver to expose the modes 2861 * with aspect-ratio, don't expose them. However if such a mode 2862 * is unique, let it be exposed, but reset the aspect-ratio flags 2863 * while preparing the list of user-modes. 2864 */ 2865 if (!file_priv->aspect_ratio_allowed) { 2866 const struct drm_display_mode *mode_itr; 2867 2868 list_for_each_entry(mode_itr, modes, head) { 2869 if (mode_itr->expose_to_userspace && 2870 drm_mode_match(mode_itr, mode, 2871 DRM_MODE_MATCH_TIMINGS | 2872 DRM_MODE_MATCH_CLOCK | 2873 DRM_MODE_MATCH_FLAGS | 2874 DRM_MODE_MATCH_3D_FLAGS)) 2875 return false; 2876 } 2877 } 2878 2879 return true; 2880} 2881 2882int drm_mode_getconnector(struct drm_device *dev, void *data, 2883 struct drm_file *file_priv) 2884{ 2885 struct drm_mode_get_connector *out_resp = data; 2886 struct drm_connector *connector; 2887 struct drm_encoder *encoder; 2888 struct drm_display_mode *mode; 2889 int mode_count = 0; 2890 int encoders_count = 0; 2891 int ret = 0; 2892 int copied = 0; 2893 struct drm_mode_modeinfo u_mode; 2894 struct drm_mode_modeinfo __user *mode_ptr; 2895 uint32_t __user *encoder_ptr; 2896 bool is_current_master; 2897 2898 if (!drm_core_check_feature(dev, DRIVER_MODESET)) 2899 return -EOPNOTSUPP; 2900 2901 memset(&u_mode, 0, sizeof(struct drm_mode_modeinfo)); 2902 2903 connector = drm_connector_lookup(dev, file_priv, out_resp->connector_id); 2904 if (!connector) 2905 return -ENOENT; 2906 2907 encoders_count = hweight32(connector->possible_encoders); 2908 2909 if ((out_resp->count_encoders >= encoders_count) && encoders_count) { 2910 copied = 0; 2911 encoder_ptr = (uint32_t __user *)(unsigned long)(out_resp->encoders_ptr); 2912 2913 drm_connector_for_each_possible_encoder(connector, encoder) { 2914 if (put_user(encoder->base.id, encoder_ptr + copied)) { 2915 ret = -EFAULT; 2916 goto out; 2917 } 2918 copied++; 2919 } 2920 } 2921 out_resp->count_encoders = encoders_count; 2922 2923 out_resp->connector_id = connector->base.id; 2924 out_resp->connector_type = connector->connector_type; 2925 out_resp->connector_type_id = connector->connector_type_id; 2926 2927 is_current_master = drm_is_current_master(file_priv); 2928 2929 mutex_lock(&dev->mode_config.mutex); 2930 if (out_resp->count_modes == 0) { 2931 if (is_current_master) 2932 connector->funcs->fill_modes(connector, 2933 dev->mode_config.max_width, 2934 dev->mode_config.max_height); 2935 else 2936 drm_dbg_kms(dev, "User-space requested a forced probe on [CONNECTOR:%d:%s] but is not the DRM master, demoting to read-only probe\n", 2937 connector->base.id, connector->name); 2938 } 2939 2940 out_resp->mm_width = connector->display_info.width_mm; 2941 out_resp->mm_height = connector->display_info.height_mm; 2942 out_resp->subpixel = connector->display_info.subpixel_order; 2943 out_resp->connection = connector->status; 2944 2945 /* delayed so we get modes regardless of pre-fill_modes state */ 2946 list_for_each_entry(mode, &connector->modes, head) { 2947 WARN_ON(mode->expose_to_userspace); 2948 2949 if (drm_mode_expose_to_userspace(mode, &connector->modes, 2950 file_priv)) { 2951 mode->expose_to_userspace = true; 2952 mode_count++; 2953 } 2954 } 2955 2956 /* 2957 * This ioctl is called twice, once to determine how much space is 2958 * needed, and the 2nd time to fill it. 2959 */ 2960 if ((out_resp->count_modes >= mode_count) && mode_count) { 2961 copied = 0; 2962 mode_ptr = (struct drm_mode_modeinfo __user *)(unsigned long)out_resp->modes_ptr; 2963 list_for_each_entry(mode, &connector->modes, head) { 2964 if (!mode->expose_to_userspace) 2965 continue; 2966 2967 /* Clear the tag for the next time around */ 2968 mode->expose_to_userspace = false; 2969 2970 drm_mode_convert_to_umode(&u_mode, mode); 2971 /* 2972 * Reset aspect ratio flags of user-mode, if modes with 2973 * aspect-ratio are not supported. 2974 */ 2975 if (!file_priv->aspect_ratio_allowed) 2976 u_mode.flags &= ~DRM_MODE_FLAG_PIC_AR_MASK; 2977 if (copy_to_user(mode_ptr + copied, 2978 &u_mode, sizeof(u_mode))) { 2979 ret = -EFAULT; 2980 2981 /* 2982 * Clear the tag for the rest of 2983 * the modes for the next time around. 2984 */ 2985 list_for_each_entry_continue(mode, &connector->modes, head) 2986 mode->expose_to_userspace = false; 2987 2988 mutex_unlock(&dev->mode_config.mutex); 2989 2990 goto out; 2991 } 2992 copied++; 2993 } 2994 } else { 2995 /* Clear the tag for the next time around */ 2996 list_for_each_entry(mode, &connector->modes, head) 2997 mode->expose_to_userspace = false; 2998 } 2999 3000 out_resp->count_modes = mode_count; 3001 mutex_unlock(&dev->mode_config.mutex); 3002 3003 drm_modeset_lock(&dev->mode_config.connection_mutex, NULL); 3004 encoder = drm_connector_get_encoder(connector); 3005 if (encoder) 3006 out_resp->encoder_id = encoder->base.id; 3007 else 3008 out_resp->encoder_id = 0; 3009 3010 /* Only grab properties after probing, to make sure EDID and other 3011 * properties reflect the latest status. 3012 */ 3013 ret = drm_mode_object_get_properties(&connector->base, file_priv->atomic, 3014 (uint32_t __user *)(unsigned long)(out_resp->props_ptr), 3015 (uint64_t __user *)(unsigned long)(out_resp->prop_values_ptr), 3016 &out_resp->count_props); 3017 drm_modeset_unlock(&dev->mode_config.connection_mutex); 3018 3019out: 3020 drm_connector_put(connector); 3021 3022 return ret; 3023} 3024 3025/** 3026 * drm_connector_find_by_fwnode - Find a connector based on the associated fwnode 3027 * @fwnode: fwnode for which to find the matching drm_connector 3028 * 3029 * This functions looks up a drm_connector based on its associated fwnode. When 3030 * a connector is found a reference to the connector is returned. The caller must 3031 * call drm_connector_put() to release this reference when it is done with the 3032 * connector. 3033 * 3034 * Returns: A reference to the found connector or an ERR_PTR(). 3035 */ 3036struct drm_connector *drm_connector_find_by_fwnode(struct fwnode_handle *fwnode) 3037{ 3038 struct drm_connector *connector, *found = ERR_PTR(-ENODEV); 3039 3040 if (!fwnode) 3041 return ERR_PTR(-ENODEV); 3042 3043 mutex_lock(&connector_list_lock); 3044 3045 list_for_each_entry(connector, &connector_list, global_connector_list_entry) { 3046 if (connector->fwnode == fwnode || 3047 (connector->fwnode && connector->fwnode->secondary == fwnode)) { 3048 drm_connector_get(connector); 3049 found = connector; 3050 break; 3051 } 3052 } 3053 3054 mutex_unlock(&connector_list_lock); 3055 3056 return found; 3057} 3058 3059/** 3060 * drm_connector_oob_hotplug_event - Report out-of-band hotplug event to connector 3061 * @connector_fwnode: fwnode_handle to report the event on 3062 * 3063 * On some hardware a hotplug event notification may come from outside the display 3064 * driver / device. An example of this is some USB Type-C setups where the hardware 3065 * muxes the DisplayPort data and aux-lines but does not pass the altmode HPD 3066 * status bit to the GPU's DP HPD pin. 3067 * 3068 * This function can be used to report these out-of-band events after obtaining 3069 * a drm_connector reference through calling drm_connector_find_by_fwnode(). 3070 */ 3071void drm_connector_oob_hotplug_event(struct fwnode_handle *connector_fwnode) 3072{ 3073 struct drm_connector *connector; 3074 3075 connector = drm_connector_find_by_fwnode(connector_fwnode); 3076 if (IS_ERR(connector)) 3077 return; 3078 3079 if (connector->funcs->oob_hotplug_event) 3080 connector->funcs->oob_hotplug_event(connector); 3081 3082 drm_connector_put(connector); 3083} 3084EXPORT_SYMBOL(drm_connector_oob_hotplug_event); 3085 3086 3087/** 3088 * DOC: Tile group 3089 * 3090 * Tile groups are used to represent tiled monitors with a unique integer 3091 * identifier. Tiled monitors using DisplayID v1.3 have a unique 8-byte handle, 3092 * we store this in a tile group, so we have a common identifier for all tiles 3093 * in a monitor group. The property is called "TILE". Drivers can manage tile 3094 * groups using drm_mode_create_tile_group(), drm_mode_put_tile_group() and 3095 * drm_mode_get_tile_group(). But this is only needed for internal panels where 3096 * the tile group information is exposed through a non-standard way. 3097 */ 3098 3099static void drm_tile_group_free(struct kref *kref) 3100{ 3101 struct drm_tile_group *tg = container_of(kref, struct drm_tile_group, refcount); 3102 struct drm_device *dev = tg->dev; 3103 3104 mutex_lock(&dev->mode_config.idr_mutex); 3105 idr_remove(&dev->mode_config.tile_idr, tg->id); 3106 mutex_unlock(&dev->mode_config.idr_mutex); 3107 kfree(tg); 3108} 3109 3110/** 3111 * drm_mode_put_tile_group - drop a reference to a tile group. 3112 * @dev: DRM device 3113 * @tg: tile group to drop reference to. 3114 * 3115 * drop reference to tile group and free if 0. 3116 */ 3117void drm_mode_put_tile_group(struct drm_device *dev, 3118 struct drm_tile_group *tg) 3119{ 3120 kref_put(&tg->refcount, drm_tile_group_free); 3121} 3122EXPORT_SYMBOL(drm_mode_put_tile_group); 3123 3124/** 3125 * drm_mode_get_tile_group - get a reference to an existing tile group 3126 * @dev: DRM device 3127 * @topology: 8-bytes unique per monitor. 3128 * 3129 * Use the unique bytes to get a reference to an existing tile group. 3130 * 3131 * RETURNS: 3132 * tile group or NULL if not found. 3133 */ 3134struct drm_tile_group *drm_mode_get_tile_group(struct drm_device *dev, 3135 const char topology[8]) 3136{ 3137 struct drm_tile_group *tg; 3138 int id; 3139 3140 mutex_lock(&dev->mode_config.idr_mutex); 3141 idr_for_each_entry(&dev->mode_config.tile_idr, tg, id) { 3142 if (!memcmp(tg->group_data, topology, 8)) { 3143 if (!kref_get_unless_zero(&tg->refcount)) 3144 tg = NULL; 3145 mutex_unlock(&dev->mode_config.idr_mutex); 3146 return tg; 3147 } 3148 } 3149 mutex_unlock(&dev->mode_config.idr_mutex); 3150 return NULL; 3151} 3152EXPORT_SYMBOL(drm_mode_get_tile_group); 3153 3154/** 3155 * drm_mode_create_tile_group - create a tile group from a displayid description 3156 * @dev: DRM device 3157 * @topology: 8-bytes unique per monitor. 3158 * 3159 * Create a tile group for the unique monitor, and get a unique 3160 * identifier for the tile group. 3161 * 3162 * RETURNS: 3163 * new tile group or NULL. 3164 */ 3165struct drm_tile_group *drm_mode_create_tile_group(struct drm_device *dev, 3166 const char topology[8]) 3167{ 3168 struct drm_tile_group *tg; 3169 int ret; 3170 3171 tg = kzalloc(sizeof(*tg), GFP_KERNEL); 3172 if (!tg) 3173 return NULL; 3174 3175 kref_init(&tg->refcount); 3176 memcpy(tg->group_data, topology, 8); 3177 tg->dev = dev; 3178 3179 mutex_lock(&dev->mode_config.idr_mutex); 3180 ret = idr_alloc(&dev->mode_config.tile_idr, tg, 1, 0, GFP_KERNEL); 3181 if (ret >= 0) { 3182 tg->id = ret; 3183 } else { 3184 kfree(tg); 3185 tg = NULL; 3186 } 3187 3188 mutex_unlock(&dev->mode_config.idr_mutex); 3189 return tg; 3190} 3191EXPORT_SYMBOL(drm_mode_create_tile_group); 3192