LCOV - code coverage report
Current view: top level - drivers/gpu/drm - drm_probe_helper.c (source / functions) Hit Total Coverage
Test: coverage.info Lines: 142 408 34.8 %
Date: 2023-03-27 20:00:47 Functions: 9 28 32.1 %

          Line data    Source code
       1             : /*
       2             :  * Copyright (c) 2006-2008 Intel Corporation
       3             :  * Copyright (c) 2007 Dave Airlie <airlied@linux.ie>
       4             :  *
       5             :  * DRM core CRTC related functions
       6             :  *
       7             :  * Permission to use, copy, modify, distribute, and sell this software and its
       8             :  * documentation for any purpose is hereby granted without fee, provided that
       9             :  * the above copyright notice appear in all copies and that both that copyright
      10             :  * notice and this permission notice appear in supporting documentation, and
      11             :  * that the name of the copyright holders not be used in advertising or
      12             :  * publicity pertaining to distribution of the software without specific,
      13             :  * written prior permission.  The copyright holders make no representations
      14             :  * about the suitability of this software for any purpose.  It is provided "as
      15             :  * is" without express or implied warranty.
      16             :  *
      17             :  * THE COPYRIGHT HOLDERS DISCLAIM ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
      18             :  * INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
      19             :  * EVENT SHALL THE COPYRIGHT HOLDERS BE LIABLE FOR ANY SPECIAL, INDIRECT OR
      20             :  * CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
      21             :  * DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
      22             :  * TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE
      23             :  * OF THIS SOFTWARE.
      24             :  *
      25             :  * Authors:
      26             :  *      Keith Packard
      27             :  *      Eric Anholt <eric@anholt.net>
      28             :  *      Dave Airlie <airlied@linux.ie>
      29             :  *      Jesse Barnes <jesse.barnes@intel.com>
      30             :  */
      31             : 
      32             : #include <linux/export.h>
      33             : #include <linux/moduleparam.h>
      34             : 
      35             : #include <drm/drm_bridge.h>
      36             : #include <drm/drm_client.h>
      37             : #include <drm/drm_crtc.h>
      38             : #include <drm/drm_edid.h>
      39             : #include <drm/drm_fourcc.h>
      40             : #include <drm/drm_modeset_helper_vtables.h>
      41             : #include <drm/drm_print.h>
      42             : #include <drm/drm_probe_helper.h>
      43             : #include <drm/drm_sysfs.h>
      44             : 
      45             : #include "drm_crtc_helper_internal.h"
      46             : 
      47             : /**
      48             :  * DOC: output probing helper overview
      49             :  *
      50             :  * This library provides some helper code for output probing. It provides an
      51             :  * implementation of the core &drm_connector_funcs.fill_modes interface with
      52             :  * drm_helper_probe_single_connector_modes().
      53             :  *
      54             :  * It also provides support for polling connectors with a work item and for
      55             :  * generic hotplug interrupt handling where the driver doesn't or cannot keep
      56             :  * track of a per-connector hpd interrupt.
      57             :  *
      58             :  * This helper library can be used independently of the modeset helper library.
      59             :  * Drivers can also overwrite different parts e.g. use their own hotplug
      60             :  * handling code to avoid probing unrelated outputs.
      61             :  *
      62             :  * The probe helpers share the function table structures with other display
      63             :  * helper libraries. See &struct drm_connector_helper_funcs for the details.
      64             :  */
      65             : 
      66             : static bool drm_kms_helper_poll = true;
      67             : module_param_named(poll, drm_kms_helper_poll, bool, 0600);
      68             : 
      69             : static enum drm_mode_status
      70             : drm_mode_validate_flag(const struct drm_display_mode *mode,
      71             :                        int flags)
      72             : {
      73         135 :         if ((mode->flags & DRM_MODE_FLAG_INTERLACE) &&
      74          10 :             !(flags & DRM_MODE_FLAG_INTERLACE))
      75             :                 return MODE_NO_INTERLACE;
      76             : 
      77         125 :         if ((mode->flags & DRM_MODE_FLAG_DBLSCAN) &&
      78           0 :             !(flags & DRM_MODE_FLAG_DBLSCAN))
      79             :                 return MODE_NO_DBLESCAN;
      80             : 
      81         125 :         if ((mode->flags & DRM_MODE_FLAG_3D_MASK) &&
      82           0 :             !(flags & DRM_MODE_FLAG_3D_MASK))
      83             :                 return MODE_NO_STEREO;
      84             : 
      85             :         return MODE_OK;
      86             : }
      87             : 
      88             : static int
      89         125 : drm_mode_validate_pipeline(struct drm_display_mode *mode,
      90             :                            struct drm_connector *connector,
      91             :                            struct drm_modeset_acquire_ctx *ctx,
      92             :                            enum drm_mode_status *status)
      93             : {
      94         125 :         struct drm_device *dev = connector->dev;
      95             :         struct drm_encoder *encoder;
      96             :         int ret;
      97             : 
      98             :         /* Step 1: Validate against connector */
      99         125 :         ret = drm_connector_mode_valid(connector, mode, ctx, status);
     100         125 :         if (ret || *status != MODE_OK)
     101             :                 return ret;
     102             : 
     103             :         /* Step 2: Validate against encoders and crtcs */
     104         125 :         drm_connector_for_each_possible_encoder(connector, encoder) {
     105             :                 struct drm_bridge *bridge;
     106             :                 struct drm_crtc *crtc;
     107             : 
     108           0 :                 *status = drm_encoder_mode_valid(encoder, mode);
     109           0 :                 if (*status != MODE_OK) {
     110             :                         /* No point in continuing for crtc check as this encoder
     111             :                          * will not accept the mode anyway. If all encoders
     112             :                          * reject the mode then, at exit, ret will not be
     113             :                          * MODE_OK. */
     114           0 :                         continue;
     115             :                 }
     116             : 
     117           0 :                 bridge = drm_bridge_chain_get_first_bridge(encoder);
     118           0 :                 *status = drm_bridge_chain_mode_valid(bridge,
     119           0 :                                                       &connector->display_info,
     120             :                                                       mode);
     121           0 :                 if (*status != MODE_OK) {
     122             :                         /* There is also no point in continuing for crtc check
     123             :                          * here. */
     124           0 :                         continue;
     125             :                 }
     126             : 
     127           0 :                 drm_for_each_crtc(crtc, dev) {
     128           0 :                         if (!drm_encoder_crtc_ok(encoder, crtc))
     129           0 :                                 continue;
     130             : 
     131           0 :                         *status = drm_crtc_mode_valid(crtc, mode);
     132           0 :                         if (*status == MODE_OK) {
     133             :                                 /* If we get to this point there is at least
     134             :                                  * one combination of encoder+crtc that works
     135             :                                  * for this mode. Lets return now. */
     136             :                                 return 0;
     137             :                         }
     138             :                 }
     139             :         }
     140             : 
     141             :         return 0;
     142             : }
     143             : 
     144           5 : static int drm_helper_probe_add_cmdline_mode(struct drm_connector *connector)
     145             : {
     146             :         struct drm_cmdline_mode *cmdline_mode;
     147             :         struct drm_display_mode *mode;
     148             : 
     149           5 :         cmdline_mode = &connector->cmdline_mode;
     150           5 :         if (!cmdline_mode->specified)
     151             :                 return 0;
     152             : 
     153             :         /* Only add a GTF mode if we find no matching probed modes */
     154         133 :         list_for_each_entry(mode, &connector->probed_modes, head) {
     155         139 :                 if (mode->hdisplay != cmdline_mode->xres ||
     156           6 :                     mode->vdisplay != cmdline_mode->yres)
     157         128 :                         continue;
     158             : 
     159           5 :                 if (cmdline_mode->refresh_specified) {
     160             :                         /* The probed mode's vrefresh is set until later */
     161           1 :                         if (drm_mode_vrefresh(mode) != cmdline_mode->refresh)
     162           0 :                                 continue;
     163             :                 }
     164             : 
     165             :                 /* Mark the matching mode as being preferred by the user */
     166           5 :                 mode->type |= DRM_MODE_TYPE_USERDEF;
     167           5 :                 return 0;
     168             :         }
     169             : 
     170           0 :         mode = drm_mode_create_from_cmdline_mode(connector->dev,
     171             :                                                  cmdline_mode);
     172           0 :         if (mode == NULL)
     173             :                 return 0;
     174             : 
     175           0 :         drm_mode_probed_add(connector, mode);
     176           0 :         return 1;
     177             : }
     178             : 
     179           0 : enum drm_mode_status drm_crtc_mode_valid(struct drm_crtc *crtc,
     180             :                                          const struct drm_display_mode *mode)
     181             : {
     182           0 :         const struct drm_crtc_helper_funcs *crtc_funcs = crtc->helper_private;
     183             : 
     184           0 :         if (!crtc_funcs || !crtc_funcs->mode_valid)
     185             :                 return MODE_OK;
     186             : 
     187           0 :         return crtc_funcs->mode_valid(crtc, mode);
     188             : }
     189             : 
     190           0 : enum drm_mode_status drm_encoder_mode_valid(struct drm_encoder *encoder,
     191             :                                             const struct drm_display_mode *mode)
     192             : {
     193           0 :         const struct drm_encoder_helper_funcs *encoder_funcs =
     194             :                 encoder->helper_private;
     195             : 
     196           0 :         if (!encoder_funcs || !encoder_funcs->mode_valid)
     197             :                 return MODE_OK;
     198             : 
     199           0 :         return encoder_funcs->mode_valid(encoder, mode);
     200             : }
     201             : 
     202             : int
     203         125 : drm_connector_mode_valid(struct drm_connector *connector,
     204             :                          struct drm_display_mode *mode,
     205             :                          struct drm_modeset_acquire_ctx *ctx,
     206             :                          enum drm_mode_status *status)
     207             : {
     208         125 :         const struct drm_connector_helper_funcs *connector_funcs =
     209             :                 connector->helper_private;
     210         125 :         int ret = 0;
     211             : 
     212         125 :         if (!connector_funcs)
     213           0 :                 *status = MODE_OK;
     214         125 :         else if (connector_funcs->mode_valid_ctx)
     215           0 :                 ret = connector_funcs->mode_valid_ctx(connector, mode, ctx,
     216             :                                                       status);
     217         125 :         else if (connector_funcs->mode_valid)
     218           0 :                 *status = connector_funcs->mode_valid(connector, mode);
     219             :         else
     220         125 :                 *status = MODE_OK;
     221             : 
     222         125 :         return ret;
     223             : }
     224             : 
     225           0 : static void drm_kms_helper_disable_hpd(struct drm_device *dev)
     226             : {
     227             :         struct drm_connector *connector;
     228             :         struct drm_connector_list_iter conn_iter;
     229             : 
     230           0 :         drm_connector_list_iter_begin(dev, &conn_iter);
     231           0 :         drm_for_each_connector_iter(connector, &conn_iter) {
     232           0 :                 const struct drm_connector_helper_funcs *funcs =
     233             :                         connector->helper_private;
     234             : 
     235           0 :                 if (funcs && funcs->disable_hpd)
     236           0 :                         funcs->disable_hpd(connector);
     237             :         }
     238           0 :         drm_connector_list_iter_end(&conn_iter);
     239           0 : }
     240             : 
     241           0 : static bool drm_kms_helper_enable_hpd(struct drm_device *dev)
     242             : {
     243           0 :         bool poll = false;
     244             :         struct drm_connector *connector;
     245             :         struct drm_connector_list_iter conn_iter;
     246             : 
     247           0 :         drm_connector_list_iter_begin(dev, &conn_iter);
     248           0 :         drm_for_each_connector_iter(connector, &conn_iter) {
     249           0 :                 const struct drm_connector_helper_funcs *funcs =
     250             :                         connector->helper_private;
     251             : 
     252           0 :                 if (funcs && funcs->enable_hpd)
     253           0 :                         funcs->enable_hpd(connector);
     254             : 
     255           0 :                 if (connector->polled & (DRM_CONNECTOR_POLL_CONNECT |
     256             :                                          DRM_CONNECTOR_POLL_DISCONNECT))
     257           0 :                         poll = true;
     258             :         }
     259           0 :         drm_connector_list_iter_end(&conn_iter);
     260             : 
     261           0 :         return poll;
     262             : }
     263             : 
     264             : #define DRM_OUTPUT_POLL_PERIOD (10*HZ)
     265             : /**
     266             :  * drm_kms_helper_poll_enable - re-enable output polling.
     267             :  * @dev: drm_device
     268             :  *
     269             :  * This function re-enables the output polling work, after it has been
     270             :  * temporarily disabled using drm_kms_helper_poll_disable(), for example over
     271             :  * suspend/resume.
     272             :  *
     273             :  * Drivers can call this helper from their device resume implementation. It is
     274             :  * not an error to call this even when output polling isn't enabled.
     275             :  *
     276             :  * Note that calls to enable and disable polling must be strictly ordered, which
     277             :  * is automatically the case when they're only call from suspend/resume
     278             :  * callbacks.
     279             :  */
     280           5 : void drm_kms_helper_poll_enable(struct drm_device *dev)
     281             : {
     282           5 :         bool poll = false;
     283           5 :         unsigned long delay = DRM_OUTPUT_POLL_PERIOD;
     284             : 
     285           5 :         if (!dev->mode_config.poll_enabled || !drm_kms_helper_poll ||
     286           0 :             dev->mode_config.poll_running)
     287             :                 return;
     288             : 
     289           0 :         poll = drm_kms_helper_enable_hpd(dev);
     290             : 
     291           0 :         if (dev->mode_config.delayed_event) {
     292             :                 /*
     293             :                  * FIXME:
     294             :                  *
     295             :                  * Use short (1s) delay to handle the initial delayed event.
     296             :                  * This delay should not be needed, but Optimus/nouveau will
     297             :                  * fail in a mysterious way if the delayed event is handled as
     298             :                  * soon as possible like it is done in
     299             :                  * drm_helper_probe_single_connector_modes() in case the poll
     300             :                  * was enabled before.
     301             :                  */
     302           0 :                 poll = true;
     303           0 :                 delay = HZ;
     304             :         }
     305             : 
     306           0 :         if (poll)
     307           0 :                 schedule_delayed_work(&dev->mode_config.output_poll_work, delay);
     308             : 
     309           0 :         dev->mode_config.poll_running = true;
     310             : }
     311             : EXPORT_SYMBOL(drm_kms_helper_poll_enable);
     312             : 
     313             : static enum drm_connector_status
     314           0 : drm_helper_probe_detect_ctx(struct drm_connector *connector, bool force)
     315             : {
     316           0 :         const struct drm_connector_helper_funcs *funcs = connector->helper_private;
     317             :         struct drm_modeset_acquire_ctx ctx;
     318             :         int ret;
     319             : 
     320           0 :         drm_modeset_acquire_init(&ctx, 0);
     321             : 
     322             : retry:
     323           0 :         ret = drm_modeset_lock(&connector->dev->mode_config.connection_mutex, &ctx);
     324           0 :         if (!ret) {
     325           0 :                 if (funcs->detect_ctx)
     326           0 :                         ret = funcs->detect_ctx(connector, &ctx, force);
     327           0 :                 else if (connector->funcs->detect)
     328           0 :                         ret = connector->funcs->detect(connector, force);
     329             :                 else
     330             :                         ret = connector_status_connected;
     331             :         }
     332             : 
     333           0 :         if (ret == -EDEADLK) {
     334           0 :                 drm_modeset_backoff(&ctx);
     335           0 :                 goto retry;
     336             :         }
     337             : 
     338           0 :         if (WARN_ON(ret < 0))
     339           0 :                 ret = connector_status_unknown;
     340             : 
     341           0 :         if (ret != connector->status)
     342           0 :                 connector->epoch_counter += 1;
     343             : 
     344           0 :         drm_modeset_drop_locks(&ctx);
     345           0 :         drm_modeset_acquire_fini(&ctx);
     346             : 
     347           0 :         return ret;
     348             : }
     349             : 
     350             : /**
     351             :  * drm_helper_probe_detect - probe connector status
     352             :  * @connector: connector to probe
     353             :  * @ctx: acquire_ctx, or NULL to let this function handle locking.
     354             :  * @force: Whether destructive probe operations should be performed.
     355             :  *
     356             :  * This function calls the detect callbacks of the connector.
     357             :  * This function returns &drm_connector_status, or
     358             :  * if @ctx is set, it might also return -EDEADLK.
     359             :  */
     360             : int
     361           5 : drm_helper_probe_detect(struct drm_connector *connector,
     362             :                         struct drm_modeset_acquire_ctx *ctx,
     363             :                         bool force)
     364             : {
     365           5 :         const struct drm_connector_helper_funcs *funcs = connector->helper_private;
     366           5 :         struct drm_device *dev = connector->dev;
     367             :         int ret;
     368             : 
     369           5 :         if (!ctx)
     370           0 :                 return drm_helper_probe_detect_ctx(connector, force);
     371             : 
     372           5 :         ret = drm_modeset_lock(&dev->mode_config.connection_mutex, ctx);
     373           5 :         if (ret)
     374             :                 return ret;
     375             : 
     376           5 :         if (funcs->detect_ctx)
     377           0 :                 ret = funcs->detect_ctx(connector, ctx, force);
     378           5 :         else if (connector->funcs->detect)
     379           0 :                 ret = connector->funcs->detect(connector, force);
     380             :         else
     381             :                 ret = connector_status_connected;
     382             : 
     383           5 :         if (ret != connector->status)
     384           5 :                 connector->epoch_counter += 1;
     385             : 
     386             :         return ret;
     387             : }
     388             : EXPORT_SYMBOL(drm_helper_probe_detect);
     389             : 
     390           5 : static int drm_helper_probe_get_modes(struct drm_connector *connector)
     391             : {
     392           5 :         const struct drm_connector_helper_funcs *connector_funcs =
     393             :                 connector->helper_private;
     394             :         int count;
     395             : 
     396           5 :         count = connector_funcs->get_modes(connector);
     397             : 
     398             :         /*
     399             :          * Fallback for when DDC probe failed in drm_get_edid() and thus skipped
     400             :          * override/firmware EDID.
     401             :          */
     402           5 :         if (count == 0 && connector->status == connector_status_connected)
     403           0 :                 count = drm_edid_override_connector_update(connector);
     404             : 
     405           5 :         return count;
     406             : }
     407             : 
     408           5 : static int __drm_helper_update_and_validate(struct drm_connector *connector,
     409             :                                             uint32_t maxX, uint32_t maxY,
     410             :                                             struct drm_modeset_acquire_ctx *ctx)
     411             : {
     412           5 :         struct drm_device *dev = connector->dev;
     413             :         struct drm_display_mode *mode;
     414           5 :         int mode_flags = 0;
     415             :         int ret;
     416             : 
     417           5 :         drm_connector_list_update(connector);
     418             : 
     419           5 :         if (connector->interlace_allowed)
     420           5 :                 mode_flags |= DRM_MODE_FLAG_INTERLACE;
     421           5 :         if (connector->doublescan_allowed)
     422           5 :                 mode_flags |= DRM_MODE_FLAG_DBLSCAN;
     423           5 :         if (connector->stereo_allowed)
     424           0 :                 mode_flags |= DRM_MODE_FLAG_3D_MASK;
     425             : 
     426         145 :         list_for_each_entry(mode, &connector->modes, head) {
     427         140 :                 if (mode->status != MODE_OK)
     428           0 :                         continue;
     429             : 
     430         140 :                 mode->status = drm_mode_validate_driver(dev, mode);
     431         140 :                 if (mode->status != MODE_OK)
     432           0 :                         continue;
     433             : 
     434         140 :                 mode->status = drm_mode_validate_size(mode, maxX, maxY);
     435         140 :                 if (mode->status != MODE_OK)
     436          15 :                         continue;
     437             : 
     438         250 :                 mode->status = drm_mode_validate_flag(mode, mode_flags);
     439         125 :                 if (mode->status != MODE_OK)
     440           0 :                         continue;
     441             : 
     442         125 :                 ret = drm_mode_validate_pipeline(mode, connector, ctx,
     443             :                                                  &mode->status);
     444         125 :                 if (ret) {
     445           0 :                         drm_dbg_kms(dev,
     446             :                                     "drm_mode_validate_pipeline failed: %d\n",
     447             :                                     ret);
     448             : 
     449           0 :                         if (drm_WARN_ON_ONCE(dev, ret != -EDEADLK))
     450           0 :                                 mode->status = MODE_ERROR;
     451             :                         else
     452             :                                 return -EDEADLK;
     453             :                 }
     454             : 
     455         125 :                 if (mode->status != MODE_OK)
     456           0 :                         continue;
     457         125 :                 mode->status = drm_mode_validate_ycbcr420(mode, connector);
     458             :         }
     459             : 
     460             :         return 0;
     461             : }
     462             : 
     463             : /**
     464             :  * drm_helper_probe_single_connector_modes - get complete set of display modes
     465             :  * @connector: connector to probe
     466             :  * @maxX: max width for modes
     467             :  * @maxY: max height for modes
     468             :  *
     469             :  * Based on the helper callbacks implemented by @connector in struct
     470             :  * &drm_connector_helper_funcs try to detect all valid modes.  Modes will first
     471             :  * be added to the connector's probed_modes list, then culled (based on validity
     472             :  * and the @maxX, @maxY parameters) and put into the normal modes list.
     473             :  *
     474             :  * Intended to be used as a generic implementation of the
     475             :  * &drm_connector_funcs.fill_modes() vfunc for drivers that use the CRTC helpers
     476             :  * for output mode filtering and detection.
     477             :  *
     478             :  * The basic procedure is as follows
     479             :  *
     480             :  * 1. All modes currently on the connector's modes list are marked as stale
     481             :  *
     482             :  * 2. New modes are added to the connector's probed_modes list with
     483             :  *    drm_mode_probed_add(). New modes start their life with status as OK.
     484             :  *    Modes are added from a single source using the following priority order.
     485             :  *
     486             :  *    - &drm_connector_helper_funcs.get_modes vfunc
     487             :  *    - if the connector status is connector_status_connected, standard
     488             :  *      VESA DMT modes up to 1024x768 are automatically added
     489             :  *      (drm_add_modes_noedid())
     490             :  *
     491             :  *    Finally modes specified via the kernel command line (video=...) are
     492             :  *    added in addition to what the earlier probes produced
     493             :  *    (drm_helper_probe_add_cmdline_mode()). These modes are generated
     494             :  *    using the VESA GTF/CVT formulas.
     495             :  *
     496             :  * 3. Modes are moved from the probed_modes list to the modes list. Potential
     497             :  *    duplicates are merged together (see drm_connector_list_update()).
     498             :  *    After this step the probed_modes list will be empty again.
     499             :  *
     500             :  * 4. Any non-stale mode on the modes list then undergoes validation
     501             :  *
     502             :  *    - drm_mode_validate_basic() performs basic sanity checks
     503             :  *    - drm_mode_validate_size() filters out modes larger than @maxX and @maxY
     504             :  *      (if specified)
     505             :  *    - drm_mode_validate_flag() checks the modes against basic connector
     506             :  *      capabilities (interlace_allowed,doublescan_allowed,stereo_allowed)
     507             :  *    - the optional &drm_connector_helper_funcs.mode_valid or
     508             :  *      &drm_connector_helper_funcs.mode_valid_ctx helpers can perform driver
     509             :  *      and/or sink specific checks
     510             :  *    - the optional &drm_crtc_helper_funcs.mode_valid,
     511             :  *      &drm_bridge_funcs.mode_valid and &drm_encoder_helper_funcs.mode_valid
     512             :  *      helpers can perform driver and/or source specific checks which are also
     513             :  *      enforced by the modeset/atomic helpers
     514             :  *
     515             :  * 5. Any mode whose status is not OK is pruned from the connector's modes list,
     516             :  *    accompanied by a debug message indicating the reason for the mode's
     517             :  *    rejection (see drm_mode_prune_invalid()).
     518             :  *
     519             :  * Returns:
     520             :  * The number of modes found on @connector.
     521             :  */
     522           5 : int drm_helper_probe_single_connector_modes(struct drm_connector *connector,
     523             :                                             uint32_t maxX, uint32_t maxY)
     524             : {
     525           5 :         struct drm_device *dev = connector->dev;
     526             :         struct drm_display_mode *mode;
     527           5 :         int count = 0, ret;
     528             :         enum drm_connector_status old_status;
     529             :         struct drm_modeset_acquire_ctx ctx;
     530             : 
     531           5 :         WARN_ON(!mutex_is_locked(&dev->mode_config.mutex));
     532             : 
     533           5 :         drm_modeset_acquire_init(&ctx, 0);
     534             : 
     535           5 :         DRM_DEBUG_KMS("[CONNECTOR:%d:%s]\n", connector->base.id,
     536             :                         connector->name);
     537             : 
     538             : retry:
     539           5 :         ret = drm_modeset_lock(&dev->mode_config.connection_mutex, &ctx);
     540           5 :         if (ret == -EDEADLK) {
     541           0 :                 drm_modeset_backoff(&ctx);
     542           0 :                 goto retry;
     543             :         } else
     544           5 :                 WARN_ON(ret < 0);
     545             : 
     546             :         /* set all old modes to the stale state */
     547           5 :         list_for_each_entry(mode, &connector->modes, head)
     548           0 :                 mode->status = MODE_STALE;
     549             : 
     550           5 :         old_status = connector->status;
     551             : 
     552           5 :         if (connector->force) {
     553           0 :                 if (connector->force == DRM_FORCE_ON ||
     554             :                     connector->force == DRM_FORCE_ON_DIGITAL)
     555           0 :                         connector->status = connector_status_connected;
     556             :                 else
     557           0 :                         connector->status = connector_status_disconnected;
     558           0 :                 if (connector->funcs->force)
     559           0 :                         connector->funcs->force(connector);
     560             :         } else {
     561           5 :                 ret = drm_helper_probe_detect(connector, &ctx, true);
     562             : 
     563           5 :                 if (ret == -EDEADLK) {
     564           0 :                         drm_modeset_backoff(&ctx);
     565           0 :                         goto retry;
     566           5 :                 } else if (WARN(ret < 0, "Invalid return value %i for connector detection\n", ret))
     567           0 :                         ret = connector_status_unknown;
     568             : 
     569           5 :                 connector->status = ret;
     570             :         }
     571             : 
     572             :         /*
     573             :          * Normally either the driver's hpd code or the poll loop should
     574             :          * pick up any changes and fire the hotplug event. But if
     575             :          * userspace sneaks in a probe, we might miss a change. Hence
     576             :          * check here, and if anything changed start the hotplug code.
     577             :          */
     578           5 :         if (old_status != connector->status) {
     579           5 :                 DRM_DEBUG_KMS("[CONNECTOR:%d:%s] status updated from %s to %s\n",
     580             :                               connector->base.id,
     581             :                               connector->name,
     582             :                               drm_get_connector_status_name(old_status),
     583             :                               drm_get_connector_status_name(connector->status));
     584             : 
     585             :                 /*
     586             :                  * The hotplug event code might call into the fb
     587             :                  * helpers, and so expects that we do not hold any
     588             :                  * locks. Fire up the poll struct instead, it will
     589             :                  * disable itself again.
     590             :                  */
     591           5 :                 dev->mode_config.delayed_event = true;
     592           5 :                 if (dev->mode_config.poll_enabled)
     593           0 :                         mod_delayed_work(system_wq,
     594             :                                          &dev->mode_config.output_poll_work,
     595             :                                          0);
     596             :         }
     597             : 
     598             :         /* Re-enable polling in case the global poll config changed. */
     599           5 :         drm_kms_helper_poll_enable(dev);
     600             : 
     601           5 :         if (connector->status == connector_status_disconnected) {
     602           0 :                 DRM_DEBUG_KMS("[CONNECTOR:%d:%s] disconnected\n",
     603             :                         connector->base.id, connector->name);
     604           0 :                 drm_connector_update_edid_property(connector, NULL);
     605           0 :                 drm_mode_prune_invalid(dev, &connector->modes, false);
     606           0 :                 goto exit;
     607             :         }
     608             : 
     609           5 :         count = drm_helper_probe_get_modes(connector);
     610             : 
     611           5 :         if (count == 0 && (connector->status == connector_status_connected ||
     612             :                            connector->status == connector_status_unknown)) {
     613           0 :                 count = drm_add_modes_noedid(connector, 1024, 768);
     614             : 
     615             :                 /*
     616             :                  * Section 4.2.2.6 (EDID Corruption Detection) of the DP 1.4a
     617             :                  * Link CTS specifies that 640x480 (the official "failsafe"
     618             :                  * mode) needs to be the default if there's no EDID.
     619             :                  */
     620           0 :                 if (connector->connector_type == DRM_MODE_CONNECTOR_DisplayPort)
     621           0 :                         drm_set_preferred_mode(connector, 640, 480);
     622             :         }
     623           5 :         count += drm_helper_probe_add_cmdline_mode(connector);
     624           5 :         if (count != 0) {
     625           5 :                 ret = __drm_helper_update_and_validate(connector, maxX, maxY, &ctx);
     626           5 :                 if (ret == -EDEADLK) {
     627           0 :                         drm_modeset_backoff(&ctx);
     628           0 :                         goto retry;
     629             :                 }
     630             :         }
     631             : 
     632           5 :         drm_mode_prune_invalid(dev, &connector->modes, true);
     633             : 
     634             :         /*
     635             :          * Displayport spec section 5.2.1.2 ("Video Timing Format") says that
     636             :          * all detachable sinks shall support 640x480 @60Hz as a fail safe
     637             :          * mode. If all modes were pruned, perhaps because they need more
     638             :          * lanes or a higher pixel clock than available, at least try to add
     639             :          * in 640x480.
     640             :          */
     641          10 :         if (list_empty(&connector->modes) &&
     642           0 :             connector->connector_type == DRM_MODE_CONNECTOR_DisplayPort) {
     643           0 :                 count = drm_add_modes_noedid(connector, 640, 480);
     644           0 :                 ret = __drm_helper_update_and_validate(connector, maxX, maxY, &ctx);
     645           0 :                 if (ret == -EDEADLK) {
     646           0 :                         drm_modeset_backoff(&ctx);
     647           0 :                         goto retry;
     648             :                 }
     649           0 :                 drm_mode_prune_invalid(dev, &connector->modes, true);
     650             :         }
     651             : 
     652             : exit:
     653           5 :         drm_modeset_drop_locks(&ctx);
     654           5 :         drm_modeset_acquire_fini(&ctx);
     655             : 
     656          10 :         if (list_empty(&connector->modes))
     657             :                 return 0;
     658             : 
     659           5 :         drm_mode_sort(&connector->modes);
     660             : 
     661           5 :         DRM_DEBUG_KMS("[CONNECTOR:%d:%s] probed modes :\n", connector->base.id,
     662             :                         connector->name);
     663         130 :         list_for_each_entry(mode, &connector->modes, head) {
     664         125 :                 drm_mode_set_crtcinfo(mode, CRTC_INTERLACE_HALVE_V);
     665         125 :                 drm_mode_debug_printmodeline(mode);
     666             :         }
     667             : 
     668             :         return count;
     669             : }
     670             : EXPORT_SYMBOL(drm_helper_probe_single_connector_modes);
     671             : 
     672             : /**
     673             :  * drm_kms_helper_hotplug_event - fire off KMS hotplug events
     674             :  * @dev: drm_device whose connector state changed
     675             :  *
     676             :  * This function fires off the uevent for userspace and also calls the
     677             :  * output_poll_changed function, which is most commonly used to inform the fbdev
     678             :  * emulation code and allow it to update the fbcon output configuration.
     679             :  *
     680             :  * Drivers should call this from their hotplug handling code when a change is
     681             :  * detected. Note that this function does not do any output detection of its
     682             :  * own, like drm_helper_hpd_irq_event() does - this is assumed to be done by the
     683             :  * driver already.
     684             :  *
     685             :  * This function must be called from process context with no mode
     686             :  * setting locks held.
     687             :  *
     688             :  * If only a single connector has changed, consider calling
     689             :  * drm_kms_helper_connector_hotplug_event() instead.
     690             :  */
     691           0 : void drm_kms_helper_hotplug_event(struct drm_device *dev)
     692             : {
     693             :         /* send a uevent + call fbdev */
     694           0 :         drm_sysfs_hotplug_event(dev);
     695           0 :         if (dev->mode_config.funcs->output_poll_changed)
     696           0 :                 dev->mode_config.funcs->output_poll_changed(dev);
     697             : 
     698           0 :         drm_client_dev_hotplug(dev);
     699           0 : }
     700             : EXPORT_SYMBOL(drm_kms_helper_hotplug_event);
     701             : 
     702             : /**
     703             :  * drm_kms_helper_connector_hotplug_event - fire off a KMS connector hotplug event
     704             :  * @connector: drm_connector which has changed
     705             :  *
     706             :  * This is the same as drm_kms_helper_hotplug_event(), except it fires a more
     707             :  * fine-grained uevent for a single connector.
     708             :  */
     709           0 : void drm_kms_helper_connector_hotplug_event(struct drm_connector *connector)
     710             : {
     711           0 :         struct drm_device *dev = connector->dev;
     712             : 
     713             :         /* send a uevent + call fbdev */
     714           0 :         drm_sysfs_connector_hotplug_event(connector);
     715           0 :         if (dev->mode_config.funcs->output_poll_changed)
     716           0 :                 dev->mode_config.funcs->output_poll_changed(dev);
     717             : 
     718           0 :         drm_client_dev_hotplug(dev);
     719           0 : }
     720             : EXPORT_SYMBOL(drm_kms_helper_connector_hotplug_event);
     721             : 
     722           0 : static void output_poll_execute(struct work_struct *work)
     723             : {
     724           0 :         struct delayed_work *delayed_work = to_delayed_work(work);
     725           0 :         struct drm_device *dev = container_of(delayed_work, struct drm_device, mode_config.output_poll_work);
     726             :         struct drm_connector *connector;
     727             :         struct drm_connector_list_iter conn_iter;
     728             :         enum drm_connector_status old_status;
     729           0 :         bool repoll = false, changed;
     730             :         u64 old_epoch_counter;
     731             : 
     732           0 :         if (!dev->mode_config.poll_enabled)
     733           0 :                 return;
     734             : 
     735             :         /* Pick up any changes detected by the probe functions. */
     736           0 :         changed = dev->mode_config.delayed_event;
     737           0 :         dev->mode_config.delayed_event = false;
     738             : 
     739           0 :         if (!drm_kms_helper_poll && dev->mode_config.poll_running) {
     740           0 :                 drm_kms_helper_disable_hpd(dev);
     741           0 :                 dev->mode_config.poll_running = false;
     742           0 :                 goto out;
     743             :         }
     744             : 
     745           0 :         if (!mutex_trylock(&dev->mode_config.mutex)) {
     746             :                 repoll = true;
     747             :                 goto out;
     748             :         }
     749             : 
     750           0 :         drm_connector_list_iter_begin(dev, &conn_iter);
     751           0 :         drm_for_each_connector_iter(connector, &conn_iter) {
     752             :                 /* Ignore forced connectors. */
     753           0 :                 if (connector->force)
     754           0 :                         continue;
     755             : 
     756             :                 /* Ignore HPD capable connectors and connectors where we don't
     757             :                  * want any hotplug detection at all for polling. */
     758           0 :                 if (!connector->polled || connector->polled == DRM_CONNECTOR_POLL_HPD)
     759           0 :                         continue;
     760             : 
     761           0 :                 old_status = connector->status;
     762             :                 /* if we are connected and don't want to poll for disconnect
     763             :                    skip it */
     764           0 :                 if (old_status == connector_status_connected &&
     765             :                     !(connector->polled & DRM_CONNECTOR_POLL_DISCONNECT))
     766           0 :                         continue;
     767             : 
     768           0 :                 repoll = true;
     769             : 
     770           0 :                 old_epoch_counter = connector->epoch_counter;
     771           0 :                 connector->status = drm_helper_probe_detect(connector, NULL, false);
     772           0 :                 if (old_epoch_counter != connector->epoch_counter) {
     773             :                         const char *old, *new;
     774             : 
     775             :                         /*
     776             :                          * The poll work sets force=false when calling detect so
     777             :                          * that drivers can avoid to do disruptive tests (e.g.
     778             :                          * when load detect cycles could cause flickering on
     779             :                          * other, running displays). This bears the risk that we
     780             :                          * flip-flop between unknown here in the poll work and
     781             :                          * the real state when userspace forces a full detect
     782             :                          * call after receiving a hotplug event due to this
     783             :                          * change.
     784             :                          *
     785             :                          * Hence clamp an unknown detect status to the old
     786             :                          * value.
     787             :                          */
     788           0 :                         if (connector->status == connector_status_unknown) {
     789           0 :                                 connector->status = old_status;
     790           0 :                                 continue;
     791             :                         }
     792             : 
     793           0 :                         old = drm_get_connector_status_name(old_status);
     794           0 :                         new = drm_get_connector_status_name(connector->status);
     795             : 
     796           0 :                         DRM_DEBUG_KMS("[CONNECTOR:%d:%s] "
     797             :                                       "status updated from %s to %s\n",
     798             :                                       connector->base.id,
     799             :                                       connector->name,
     800             :                                       old, new);
     801           0 :                         DRM_DEBUG_KMS("[CONNECTOR:%d:%s] epoch counter %llu -> %llu\n",
     802             :                                       connector->base.id, connector->name,
     803             :                                       old_epoch_counter, connector->epoch_counter);
     804             : 
     805           0 :                         changed = true;
     806             :                 }
     807             :         }
     808           0 :         drm_connector_list_iter_end(&conn_iter);
     809             : 
     810           0 :         mutex_unlock(&dev->mode_config.mutex);
     811             : 
     812             : out:
     813           0 :         if (changed)
     814           0 :                 drm_kms_helper_hotplug_event(dev);
     815             : 
     816           0 :         if (repoll)
     817             :                 schedule_delayed_work(delayed_work, DRM_OUTPUT_POLL_PERIOD);
     818             : }
     819             : 
     820             : /**
     821             :  * drm_kms_helper_is_poll_worker - is %current task an output poll worker?
     822             :  *
     823             :  * Determine if %current task is an output poll worker.  This can be used
     824             :  * to select distinct code paths for output polling versus other contexts.
     825             :  *
     826             :  * One use case is to avoid a deadlock between the output poll worker and
     827             :  * the autosuspend worker wherein the latter waits for polling to finish
     828             :  * upon calling drm_kms_helper_poll_disable(), while the former waits for
     829             :  * runtime suspend to finish upon calling pm_runtime_get_sync() in a
     830             :  * connector ->detect hook.
     831             :  */
     832           0 : bool drm_kms_helper_is_poll_worker(void)
     833             : {
     834           0 :         struct work_struct *work = current_work();
     835             : 
     836           0 :         return work && work->func == output_poll_execute;
     837             : }
     838             : EXPORT_SYMBOL(drm_kms_helper_is_poll_worker);
     839             : 
     840             : /**
     841             :  * drm_kms_helper_poll_disable - disable output polling
     842             :  * @dev: drm_device
     843             :  *
     844             :  * This function disables the output polling work.
     845             :  *
     846             :  * Drivers can call this helper from their device suspend implementation. It is
     847             :  * not an error to call this even when output polling isn't enabled or already
     848             :  * disabled. Polling is re-enabled by calling drm_kms_helper_poll_enable().
     849             :  *
     850             :  * Note that calls to enable and disable polling must be strictly ordered, which
     851             :  * is automatically the case when they're only call from suspend/resume
     852             :  * callbacks.
     853             :  */
     854           0 : void drm_kms_helper_poll_disable(struct drm_device *dev)
     855             : {
     856           0 :         if (dev->mode_config.poll_running)
     857           0 :                 drm_kms_helper_disable_hpd(dev);
     858             : 
     859           0 :         cancel_delayed_work_sync(&dev->mode_config.output_poll_work);
     860             : 
     861           0 :         dev->mode_config.poll_running = false;
     862           0 : }
     863             : EXPORT_SYMBOL(drm_kms_helper_poll_disable);
     864             : 
     865             : /**
     866             :  * drm_kms_helper_poll_init - initialize and enable output polling
     867             :  * @dev: drm_device
     868             :  *
     869             :  * This function initializes and then also enables output polling support for
     870             :  * @dev. Drivers which do not have reliable hotplug support in hardware can use
     871             :  * this helper infrastructure to regularly poll such connectors for changes in
     872             :  * their connection state.
     873             :  *
     874             :  * Drivers can control which connectors are polled by setting the
     875             :  * DRM_CONNECTOR_POLL_CONNECT and DRM_CONNECTOR_POLL_DISCONNECT flags. On
     876             :  * connectors where probing live outputs can result in visual distortion drivers
     877             :  * should not set the DRM_CONNECTOR_POLL_DISCONNECT flag to avoid this.
     878             :  * Connectors which have no flag or only DRM_CONNECTOR_POLL_HPD set are
     879             :  * completely ignored by the polling logic.
     880             :  *
     881             :  * Note that a connector can be both polled and probed from the hotplug handler,
     882             :  * in case the hotplug interrupt is known to be unreliable.
     883             :  */
     884           0 : void drm_kms_helper_poll_init(struct drm_device *dev)
     885             : {
     886           0 :         INIT_DELAYED_WORK(&dev->mode_config.output_poll_work, output_poll_execute);
     887           0 :         dev->mode_config.poll_enabled = true;
     888             : 
     889           0 :         drm_kms_helper_poll_enable(dev);
     890           0 : }
     891             : EXPORT_SYMBOL(drm_kms_helper_poll_init);
     892             : 
     893             : /**
     894             :  * drm_kms_helper_poll_fini - disable output polling and clean it up
     895             :  * @dev: drm_device
     896             :  */
     897           0 : void drm_kms_helper_poll_fini(struct drm_device *dev)
     898             : {
     899           0 :         if (!dev->mode_config.poll_enabled)
     900             :                 return;
     901             : 
     902           0 :         drm_kms_helper_poll_disable(dev);
     903             : 
     904           0 :         dev->mode_config.poll_enabled = false;
     905             : }
     906             : EXPORT_SYMBOL(drm_kms_helper_poll_fini);
     907             : 
     908           0 : static bool check_connector_changed(struct drm_connector *connector)
     909             : {
     910           0 :         struct drm_device *dev = connector->dev;
     911             :         enum drm_connector_status old_status;
     912             :         u64 old_epoch_counter;
     913             : 
     914             :         /* Only handle HPD capable connectors. */
     915           0 :         drm_WARN_ON(dev, !(connector->polled & DRM_CONNECTOR_POLL_HPD));
     916             : 
     917           0 :         drm_WARN_ON(dev, !mutex_is_locked(&dev->mode_config.mutex));
     918             : 
     919           0 :         old_status = connector->status;
     920           0 :         old_epoch_counter = connector->epoch_counter;
     921           0 :         connector->status = drm_helper_probe_detect(connector, NULL, false);
     922             : 
     923           0 :         if (old_epoch_counter == connector->epoch_counter) {
     924           0 :                 drm_dbg_kms(dev, "[CONNECTOR:%d:%s] Same epoch counter %llu\n",
     925             :                             connector->base.id,
     926             :                             connector->name,
     927             :                             connector->epoch_counter);
     928             : 
     929           0 :                 return false;
     930             :         }
     931             : 
     932           0 :         drm_dbg_kms(dev, "[CONNECTOR:%d:%s] status updated from %s to %s\n",
     933             :                     connector->base.id,
     934             :                     connector->name,
     935             :                     drm_get_connector_status_name(old_status),
     936             :                     drm_get_connector_status_name(connector->status));
     937             : 
     938           0 :         drm_dbg_kms(dev, "[CONNECTOR:%d:%s] Changed epoch counter %llu => %llu\n",
     939             :                     connector->base.id,
     940             :                     connector->name,
     941             :                     old_epoch_counter,
     942             :                     connector->epoch_counter);
     943             : 
     944           0 :         return true;
     945             : }
     946             : 
     947             : /**
     948             :  * drm_connector_helper_hpd_irq_event - hotplug processing
     949             :  * @connector: drm_connector
     950             :  *
     951             :  * Drivers can use this helper function to run a detect cycle on a connector
     952             :  * which has the DRM_CONNECTOR_POLL_HPD flag set in its &polled member.
     953             :  *
     954             :  * This helper function is useful for drivers which can track hotplug
     955             :  * interrupts for a single connector. Drivers that want to send a
     956             :  * hotplug event for all connectors or can't track hotplug interrupts
     957             :  * per connector need to use drm_helper_hpd_irq_event().
     958             :  *
     959             :  * This function must be called from process context with no mode
     960             :  * setting locks held.
     961             :  *
     962             :  * Note that a connector can be both polled and probed from the hotplug
     963             :  * handler, in case the hotplug interrupt is known to be unreliable.
     964             :  *
     965             :  * Returns:
     966             :  * A boolean indicating whether the connector status changed or not
     967             :  */
     968           0 : bool drm_connector_helper_hpd_irq_event(struct drm_connector *connector)
     969             : {
     970           0 :         struct drm_device *dev = connector->dev;
     971             :         bool changed;
     972             : 
     973           0 :         mutex_lock(&dev->mode_config.mutex);
     974           0 :         changed = check_connector_changed(connector);
     975           0 :         mutex_unlock(&dev->mode_config.mutex);
     976             : 
     977           0 :         if (changed) {
     978           0 :                 drm_kms_helper_connector_hotplug_event(connector);
     979           0 :                 drm_dbg_kms(dev, "[CONNECTOR:%d:%s] Sent hotplug event\n",
     980             :                             connector->base.id,
     981             :                             connector->name);
     982             :         }
     983             : 
     984           0 :         return changed;
     985             : }
     986             : EXPORT_SYMBOL(drm_connector_helper_hpd_irq_event);
     987             : 
     988             : /**
     989             :  * drm_helper_hpd_irq_event - hotplug processing
     990             :  * @dev: drm_device
     991             :  *
     992             :  * Drivers can use this helper function to run a detect cycle on all connectors
     993             :  * which have the DRM_CONNECTOR_POLL_HPD flag set in their &polled member. All
     994             :  * other connectors are ignored, which is useful to avoid reprobing fixed
     995             :  * panels.
     996             :  *
     997             :  * This helper function is useful for drivers which can't or don't track hotplug
     998             :  * interrupts for each connector.
     999             :  *
    1000             :  * Drivers which support hotplug interrupts for each connector individually and
    1001             :  * which have a more fine-grained detect logic can use
    1002             :  * drm_connector_helper_hpd_irq_event(). Alternatively, they should bypass this
    1003             :  * code and directly call drm_kms_helper_hotplug_event() in case the connector
    1004             :  * state changed.
    1005             :  *
    1006             :  * This function must be called from process context with no mode
    1007             :  * setting locks held.
    1008             :  *
    1009             :  * Note that a connector can be both polled and probed from the hotplug handler,
    1010             :  * in case the hotplug interrupt is known to be unreliable.
    1011             :  *
    1012             :  * Returns:
    1013             :  * A boolean indicating whether the connector status changed or not
    1014             :  */
    1015           0 : bool drm_helper_hpd_irq_event(struct drm_device *dev)
    1016             : {
    1017           0 :         struct drm_connector *connector, *first_changed_connector = NULL;
    1018             :         struct drm_connector_list_iter conn_iter;
    1019           0 :         int changed = 0;
    1020             : 
    1021           0 :         if (!dev->mode_config.poll_enabled)
    1022             :                 return false;
    1023             : 
    1024           0 :         mutex_lock(&dev->mode_config.mutex);
    1025           0 :         drm_connector_list_iter_begin(dev, &conn_iter);
    1026           0 :         drm_for_each_connector_iter(connector, &conn_iter) {
    1027             :                 /* Only handle HPD capable connectors. */
    1028           0 :                 if (!(connector->polled & DRM_CONNECTOR_POLL_HPD))
    1029           0 :                         continue;
    1030             : 
    1031           0 :                 if (check_connector_changed(connector)) {
    1032           0 :                         if (!first_changed_connector) {
    1033           0 :                                 drm_connector_get(connector);
    1034           0 :                                 first_changed_connector = connector;
    1035             :                         }
    1036             : 
    1037           0 :                         changed++;
    1038             :                 }
    1039             :         }
    1040           0 :         drm_connector_list_iter_end(&conn_iter);
    1041           0 :         mutex_unlock(&dev->mode_config.mutex);
    1042             : 
    1043           0 :         if (changed == 1)
    1044           0 :                 drm_kms_helper_connector_hotplug_event(first_changed_connector);
    1045           0 :         else if (changed > 0)
    1046           0 :                 drm_kms_helper_hotplug_event(dev);
    1047             : 
    1048           0 :         if (first_changed_connector)
    1049             :                 drm_connector_put(first_changed_connector);
    1050             : 
    1051           0 :         return changed;
    1052             : }
    1053             : EXPORT_SYMBOL(drm_helper_hpd_irq_event);
    1054             : 
    1055             : /**
    1056             :  * drm_crtc_helper_mode_valid_fixed - Validates a display mode
    1057             :  * @crtc: the crtc
    1058             :  * @mode: the mode to validate
    1059             :  * @fixed_mode: the display hardware's mode
    1060             :  *
    1061             :  * Returns:
    1062             :  * MODE_OK on success, or another mode-status code otherwise.
    1063             :  */
    1064           0 : enum drm_mode_status drm_crtc_helper_mode_valid_fixed(struct drm_crtc *crtc,
    1065             :                                                       const struct drm_display_mode *mode,
    1066             :                                                       const struct drm_display_mode *fixed_mode)
    1067             : {
    1068           0 :         if (mode->hdisplay != fixed_mode->hdisplay && mode->vdisplay != fixed_mode->vdisplay)
    1069             :                 return MODE_ONE_SIZE;
    1070           0 :         else if (mode->hdisplay != fixed_mode->hdisplay)
    1071             :                 return MODE_ONE_WIDTH;
    1072           0 :         else if (mode->vdisplay != fixed_mode->vdisplay)
    1073             :                 return MODE_ONE_HEIGHT;
    1074             : 
    1075           0 :         return MODE_OK;
    1076             : }
    1077             : EXPORT_SYMBOL(drm_crtc_helper_mode_valid_fixed);
    1078             : 
    1079             : /**
    1080             :  * drm_connector_helper_get_modes_from_ddc - Updates the connector's EDID
    1081             :  *                                           property from the connector's
    1082             :  *                                           DDC channel
    1083             :  * @connector: The connector
    1084             :  *
    1085             :  * Returns:
    1086             :  * The number of detected display modes.
    1087             :  *
    1088             :  * Uses a connector's DDC channel to retrieve EDID data and update the
    1089             :  * connector's EDID property and display modes. Drivers can use this
    1090             :  * function to implement struct &drm_connector_helper_funcs.get_modes
    1091             :  * for connectors with a DDC channel.
    1092             :  */
    1093           0 : int drm_connector_helper_get_modes_from_ddc(struct drm_connector *connector)
    1094             : {
    1095             :         struct edid *edid;
    1096           0 :         int count = 0;
    1097             : 
    1098           0 :         if (!connector->ddc)
    1099             :                 return 0;
    1100             : 
    1101           0 :         edid = drm_get_edid(connector, connector->ddc);
    1102             : 
    1103             :         // clears property if EDID is NULL
    1104           0 :         drm_connector_update_edid_property(connector, edid);
    1105             : 
    1106           0 :         if (edid) {
    1107           0 :                 count = drm_add_edid_modes(connector, edid);
    1108           0 :                 kfree(edid);
    1109             :         }
    1110             : 
    1111             :         return count;
    1112             : }
    1113             : EXPORT_SYMBOL(drm_connector_helper_get_modes_from_ddc);
    1114             : 
    1115             : /**
    1116             :  * drm_connector_helper_get_modes_fixed - Duplicates a display mode for a connector
    1117             :  * @connector: the connector
    1118             :  * @fixed_mode: the display hardware's mode
    1119             :  *
    1120             :  * This function duplicates a display modes for a connector. Drivers for hardware
    1121             :  * that only supports a single fixed mode can use this function in their connector's
    1122             :  * get_modes helper.
    1123             :  *
    1124             :  * Returns:
    1125             :  * The number of created modes.
    1126             :  */
    1127           0 : int drm_connector_helper_get_modes_fixed(struct drm_connector *connector,
    1128             :                                          const struct drm_display_mode *fixed_mode)
    1129             : {
    1130           0 :         struct drm_device *dev = connector->dev;
    1131             :         struct drm_display_mode *mode;
    1132             : 
    1133           0 :         mode = drm_mode_duplicate(dev, fixed_mode);
    1134           0 :         if (!mode) {
    1135           0 :                 drm_err(dev, "Failed to duplicate mode " DRM_MODE_FMT "\n",
    1136             :                         DRM_MODE_ARG(fixed_mode));
    1137           0 :                 return 0;
    1138             :         }
    1139             : 
    1140           0 :         if (mode->name[0] == '\0')
    1141           0 :                 drm_mode_set_name(mode);
    1142             : 
    1143           0 :         mode->type |= DRM_MODE_TYPE_PREFERRED;
    1144           0 :         drm_mode_probed_add(connector, mode);
    1145             : 
    1146           0 :         if (mode->width_mm)
    1147           0 :                 connector->display_info.width_mm = mode->width_mm;
    1148           0 :         if (mode->height_mm)
    1149           0 :                 connector->display_info.height_mm = mode->height_mm;
    1150             : 
    1151             :         return 1;
    1152             : }
    1153             : EXPORT_SYMBOL(drm_connector_helper_get_modes_fixed);
    1154             : 
    1155             : /**
    1156             :  * drm_connector_helper_get_modes - Read EDID and update connector.
    1157             :  * @connector: The connector
    1158             :  *
    1159             :  * Read the EDID using drm_edid_read() (which requires that connector->ddc is
    1160             :  * set), and update the connector using the EDID.
    1161             :  *
    1162             :  * This can be used as the "default" connector helper .get_modes() hook if the
    1163             :  * driver does not need any special processing. This is sets the example what
    1164             :  * custom .get_modes() hooks should do regarding EDID read and connector update.
    1165             :  *
    1166             :  * Returns: Number of modes.
    1167             :  */
    1168           0 : int drm_connector_helper_get_modes(struct drm_connector *connector)
    1169             : {
    1170             :         const struct drm_edid *drm_edid;
    1171             :         int count;
    1172             : 
    1173           0 :         drm_edid = drm_edid_read(connector);
    1174             : 
    1175             :         /*
    1176             :          * Unconditionally update the connector. If the EDID was read
    1177             :          * successfully, fill in the connector information derived from the
    1178             :          * EDID. Otherwise, if the EDID is NULL, clear the connector
    1179             :          * information.
    1180             :          */
    1181           0 :         drm_edid_connector_update(connector, drm_edid);
    1182             : 
    1183           0 :         count = drm_edid_connector_add_modes(connector);
    1184             : 
    1185           0 :         drm_edid_free(drm_edid);
    1186             : 
    1187           0 :         return count;
    1188             : }
    1189             : EXPORT_SYMBOL(drm_connector_helper_get_modes);
    1190             : 
    1191             : /**
    1192             :  * drm_connector_helper_tv_get_modes - Fills the modes availables to a TV connector
    1193             :  * @connector: The connector
    1194             :  *
    1195             :  * Fills the available modes for a TV connector based on the supported
    1196             :  * TV modes, and the default mode expressed by the kernel command line.
    1197             :  *
    1198             :  * This can be used as the default TV connector helper .get_modes() hook
    1199             :  * if the driver does not need any special processing.
    1200             :  *
    1201             :  * Returns:
    1202             :  * The number of modes added to the connector.
    1203             :  */
    1204           7 : int drm_connector_helper_tv_get_modes(struct drm_connector *connector)
    1205             : {
    1206           7 :         struct drm_device *dev = connector->dev;
    1207           7 :         struct drm_property *tv_mode_property =
    1208             :                 dev->mode_config.tv_mode_property;
    1209           7 :         struct drm_cmdline_mode *cmdline = &connector->cmdline_mode;
    1210           7 :         unsigned int ntsc_modes = BIT(DRM_MODE_TV_MODE_NTSC) |
    1211             :                 BIT(DRM_MODE_TV_MODE_NTSC_443) |
    1212             :                 BIT(DRM_MODE_TV_MODE_NTSC_J) |
    1213             :                 BIT(DRM_MODE_TV_MODE_PAL_M);
    1214           7 :         unsigned int pal_modes = BIT(DRM_MODE_TV_MODE_PAL) |
    1215             :                 BIT(DRM_MODE_TV_MODE_PAL_N) |
    1216             :                 BIT(DRM_MODE_TV_MODE_SECAM);
    1217           7 :         unsigned int tv_modes[2] = { UINT_MAX, UINT_MAX };
    1218           7 :         unsigned int i, supported_tv_modes = 0;
    1219             : 
    1220           7 :         if (!tv_mode_property)
    1221             :                 return 0;
    1222             : 
    1223          10 :         for (i = 0; i < tv_mode_property->num_values; i++)
    1224          10 :                 supported_tv_modes |= BIT(tv_mode_property->values[i]);
    1225             : 
    1226          12 :         if ((supported_tv_modes & ntsc_modes) &&
    1227           9 :             (supported_tv_modes & pal_modes)) {
    1228             :                 uint64_t default_mode;
    1229             : 
    1230           4 :                 if (drm_object_property_get_default_value(&connector->base,
    1231             :                                                           tv_mode_property,
    1232             :                                                           &default_mode))
    1233           0 :                         return 0;
    1234             : 
    1235           4 :                 if (cmdline->tv_mode_specified)
    1236           2 :                         default_mode = cmdline->tv_mode;
    1237             : 
    1238           4 :                 if (BIT(default_mode) & ntsc_modes) {
    1239           2 :                         tv_modes[0] = DRM_MODE_TV_MODE_NTSC;
    1240           2 :                         tv_modes[1] = DRM_MODE_TV_MODE_PAL;
    1241             :                 } else {
    1242           2 :                         tv_modes[0] = DRM_MODE_TV_MODE_PAL;
    1243           2 :                         tv_modes[1] = DRM_MODE_TV_MODE_NTSC;
    1244             :                 }
    1245           3 :         } else if (supported_tv_modes & ntsc_modes) {
    1246           1 :                 tv_modes[0] = DRM_MODE_TV_MODE_NTSC;
    1247           2 :         } else if (supported_tv_modes & pal_modes) {
    1248           1 :                 tv_modes[0] = DRM_MODE_TV_MODE_PAL;
    1249             :         } else {
    1250             :                 return 0;
    1251             :         }
    1252             : 
    1253          10 :         for (i = 0; i < ARRAY_SIZE(tv_modes); i++) {
    1254             :                 struct drm_display_mode *mode;
    1255             : 
    1256          12 :                 if (tv_modes[i] == DRM_MODE_TV_MODE_NTSC)
    1257           5 :                         mode = drm_mode_analog_ntsc_480i(dev);
    1258           7 :                 else if (tv_modes[i] == DRM_MODE_TV_MODE_PAL)
    1259           5 :                         mode = drm_mode_analog_pal_576i(dev);
    1260             :                 else
    1261             :                         break;
    1262          10 :                 if (!mode)
    1263           0 :                         return i;
    1264          10 :                 if (!i)
    1265           6 :                         mode->type |= DRM_MODE_TYPE_PREFERRED;
    1266          10 :                 drm_mode_probed_add(connector, mode);
    1267             :         }
    1268             : 
    1269           6 :         return i;
    1270             : }
    1271             : EXPORT_SYMBOL(drm_connector_helper_tv_get_modes);

Generated by: LCOV version 1.14