drivers/gpu/drm/i915/dvo.h

   1 /*
   2  * Copyright © 2006 Eric Anholt
   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 #ifndef _INTEL_DVO_H
  24 #define _INTEL_DVO_H
  25
  26 #include <linux/i2c.h>
  27 #include "drmP.h"
  28 #include "drm.h"
  29 #include "drm_crtc.h"
  30 #include "intel_drv.h"
  31
  32 struct intel_dvo_device {
  33         char *name;
  34         int type;
  35         /* DVOA/B/C output register */
  36         u32 dvo_reg;
  37         /* GPIO register used for i2c bus to control this device */
  38         u32 gpio;
  39         int slave_addr;
  40         struct i2c_adapter *i2c_bus;
  41
  42         const struct intel_dvo_dev_ops *dev_ops;
  43         void *dev_priv;
  44
  45         struct drm_display_mode *panel_fixed_mode;
  46         bool panel_wants_dither;
  47 };
  48
  49 struct intel_dvo_dev_ops {
  50         /*
  51          * Initialize the device at startup time.
  52          * Returns NULL if the device does not exist.
  53          */
  54         bool (*init)(struct intel_dvo_device *dvo,
  55                      struct i2c_adapter *i2cbus);
  56
  57         /*
  58          * Called to allow the output a chance to create properties after the
  59          * RandR objects have been created.
  60          */
  61         void (*create_resources)(struct intel_dvo_device *dvo);
  62
  63         /*
  64          * Turn on/off output or set intermediate power levels if available.
  65          *
  66          * Unsupported intermediate modes drop to the lower power setting.
  67          * If the  mode is DPMSModeOff, the output must be disabled,
  68          * as the DPLL may be disabled afterwards.
  69          */
  70         void (*dpms)(struct intel_dvo_device *dvo, int mode);
  71
  72         /*
  73          * Callback for testing a video mode for a given output.
  74          *
  75          * This function should only check for cases where a mode can't
  76          * be supported on the output specifically, and not represent
  77          * generic CRTC limitations.
  78          *
  79          * \return MODE_OK if the mode is valid, or another MODE_* otherwise.
  80          */
  81         int (*mode_valid)(struct intel_dvo_device *dvo,
  82                           struct drm_display_mode *mode);
  83
  84         /*
  85          * Callback to adjust the mode to be set in the CRTC.
  86          *
  87          * This allows an output to adjust the clock or even the entire set of
  88          * timings, which is used for panels with fixed timings or for
  89          * buses with clock limitations.
  90          */
  91         bool (*mode_fixup)(struct intel_dvo_device *dvo,
  92                            struct drm_display_mode *mode,
  93                            struct drm_display_mode *adjusted_mode);
  94
  95         /*
  96          * Callback for preparing mode changes on an output
  97          */
  98         void (*prepare)(struct intel_dvo_device *dvo);
  99
 100         /*
 101          * Callback for committing mode changes on an output
 102          */
 103         void (*commit)(struct intel_dvo_device *dvo);
 104
 105         /*
 106          * Callback for setting up a video mode after fixups have been made.
 107          *
 108          * This is only called while the output is disabled.  The dpms callback
 109          * must be all that's necessary for the output, to turn the output on
 110          * after this function is called.
 111          */
 112         void (*mode_set)(struct intel_dvo_device *dvo,
 113                          struct drm_display_mode *mode,
 114                          struct drm_display_mode *adjusted_mode);
 115
 116         /*
 117          * Probe for a connected output, and return detect_status.
 118          */
 119         enum drm_connector_status (*detect)(struct intel_dvo_device *dvo);
 120
 121         /**
 122          * Query the device for the modes it provides.
 123          *
 124          * This function may also update MonInfo, mm_width, and mm_height.
 125          *
 126          * \return singly-linked list of modes or NULL if no modes found.
 127          */
 128         struct drm_display_mode *(*get_modes)(struct intel_dvo_device *dvo);
 129
 130         /**
 131          * Clean up driver-specific bits of the output
 132          */
 133         void (*destroy) (struct intel_dvo_device *dvo);
 134
 135         /**
 136          * Debugging hook to dump device registers to log file
 137          */
 138         void (*dump_regs)(struct intel_dvo_device *dvo);
 139 };
 140
 141 extern struct intel_dvo_dev_ops sil164_ops;
 142 extern struct intel_dvo_dev_ops ch7xxx_ops;
 143 extern struct intel_dvo_dev_ops ivch_ops;
 144 extern struct intel_dvo_dev_ops tfp410_ops;
 145 extern struct intel_dvo_dev_ops ch7017_ops;
 146
 147 #endif /* _INTEL_DVO_H */