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 "i915_reg_defs.h"
27
28#include "intel_display_limits.h"
29
30enum drm_connector_status;
31struct drm_display_mode;
32struct i2c_adapter;
33
34struct intel_dvo_device {
35	const char *name;
36	int type;
37	/* DVOA/B/C */
38	enum port port;
39	/* GPIO register used for i2c bus to control this device */
40	u32 gpio;
41	int slave_addr;
42
43	const struct intel_dvo_dev_ops *dev_ops;
44	void *dev_priv;
45	struct i2c_adapter *i2c_bus;
46};
47
48struct intel_dvo_dev_ops {
49	/*
50	 * Initialize the device at startup time.
51	 * Returns NULL if the device does not exist.
52	 */
53	bool (*init)(struct intel_dvo_device *dvo,
54		     struct i2c_adapter *i2cbus);
55
56	/*
57	 * Turn on/off output.
58	 *
59	 * Because none of our dvo drivers support an intermediate power levels,
60	 * we don't expose this in the interfac.
61	 */
62	void (*dpms)(struct intel_dvo_device *dvo, bool enable);
63
64	/*
65	 * Callback for testing a video mode for a given output.
66	 *
67	 * This function should only check for cases where a mode can't
68	 * be supported on the output specifically, and not represent
69	 * generic CRTC limitations.
70	 *
71	 * \return MODE_OK if the mode is valid, or another MODE_* otherwise.
72	 */
73	enum drm_mode_status (*mode_valid)(struct intel_dvo_device *dvo,
74					   struct drm_display_mode *mode);
75
76	/*
77	 * Callback for setting up a video mode after fixups have been made.
78	 *
79	 * This is only called while the output is disabled.  The dpms callback
80	 * must be all that's necessary for the output, to turn the output on
81	 * after this function is called.
82	 */
83	void (*mode_set)(struct intel_dvo_device *dvo,
84			 const struct drm_display_mode *mode,
85			 const struct drm_display_mode *adjusted_mode);
86
87	/*
88	 * Probe for a connected output, and return detect_status.
89	 */
90	enum drm_connector_status (*detect)(struct intel_dvo_device *dvo);
91
92	/*
93	 * Probe the current hw status, returning true if the connected output
94	 * is active.
95	 */
96	bool (*get_hw_state)(struct intel_dvo_device *dev);
97
98	/**
99	 * Clean up driver-specific bits of the output
100	 */
101	void (*destroy) (struct intel_dvo_device *dvo);
102
103	/**
104	 * Debugging hook to dump device registers to log file
105	 */
106	void (*dump_regs)(struct intel_dvo_device *dvo);
107};
108
109extern const struct intel_dvo_dev_ops sil164_ops;
110extern const struct intel_dvo_dev_ops ch7xxx_ops;
111extern const struct intel_dvo_dev_ops ivch_ops;
112extern const struct intel_dvo_dev_ops tfp410_ops;
113extern const struct intel_dvo_dev_ops ch7017_ops;
114extern const struct intel_dvo_dev_ops ns2501_ops;
115
116#endif /* __INTEL_DVO_DEV_H__ */
117