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