/*
 * Copyright © 2006 Eric Anholt
 *
 * Permission to use, copy, modify, distribute, and sell this software and its
 * documentation for any purpose is hereby granted without fee, provided that
 * the above copyright notice appear in all copies and that both that copyright
 * notice and this permission notice appear in supporting documentation, and
 * that the name of the copyright holders not be used in advertising or
 * publicity pertaining to distribution of the software without specific,
 * written prior permission.  The copyright holders make no representations
 * about the suitability of this software for any purpose.  It is provided "as
 * is" without express or implied warranty.
 *
 * THE COPYRIGHT HOLDERS DISCLAIM ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
 * INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
 * EVENT SHALL THE COPYRIGHT HOLDERS BE LIABLE FOR ANY SPECIAL, INDIRECT OR
 * CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
 * DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
 * TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE
 * OF THIS SOFTWARE.
 */

#ifndef __INTEL_DVO_DEV_H__
#define __INTEL_DVO_DEV_H__

#include "i915_reg_defs.h"

#include "intel_display_limits.h"

enum drm_connector_status;
struct drm_display_mode;
struct i2c_adapter;

struct intel_dvo_device {
 const char *name;
 int type;
 /* DVOA/B/C */
 enum port port;
 /* GPIO register used for i2c bus to control this device */
 u32 gpio;
 int target_addr;

 const struct intel_dvo_dev_ops *dev_ops;
 void *dev_priv;
 struct i2c_adapter *i2c_bus;
};

struct intel_dvo_dev_ops {
 /*
  * Initialize the device at startup time.
  * Returns NULL if the device does not exist.
 */
 bool (*init)(struct intel_dvo_device *dvo,
       struct i2c_adapter *i2cbus);

 /*
  * Turn on/off output.
  *
  * Because none of our dvo drivers support an intermediate power levels,
  * we don't expose this in the interface.
 */
 void (*dpms)(struct intel_dvo_device *dvo, bool enable);

 /*
  * Callback for testing a video mode for a given output.
  *
  * This function should only check for cases where a mode can't
  * be supported on the output specifically, and not represent
  * generic CRTC limitations.
  *
  * \return MODE_OK if the mode is valid, or another MODE_* otherwise.
 */
 enum drm_mode_status (*mode_valid)(struct intel_dvo_device *dvo,
        const struct drm_display_mode *mode);

 /*
  * Callback for setting up a video mode after fixups have been made.
  *
  * This is only called while the output is disabled.  The dpms callback
  * must be all that's necessary for the output, to turn the output on
  * after this function is called.
 */
 void (*mode_set)(struct intel_dvo_device *dvo,
    const struct drm_display_mode *mode,
    const struct drm_display_mode *adjusted_mode);

 /*
  * Probe for a connected output, and return detect_status.
 */
 enum drm_connector_status (*detect)(struct intel_dvo_device *dvo);

 /*
  * Probe the current hw status, returning true if the connected output
  * is active.
 */
 bool (*get_hw_state)(struct intel_dvo_device *dev);

 /**
  * Clean up driver-specific bits of the output
 */
 void (*destroy) (struct intel_dvo_device *dvo);

 /**
  * Debugging hook to dump device registers to log file
 */
 void (*dump_regs)(struct intel_dvo_device *dvo);
};

extern const struct intel_dvo_dev_ops sil164_ops;
extern const struct intel_dvo_dev_ops ch7xxx_ops;
extern const struct intel_dvo_dev_ops ivch_ops;
extern const struct intel_dvo_dev_ops tfp410_ops;
extern const struct intel_dvo_dev_ops ch7017_ops;
extern const struct intel_dvo_dev_ops ns2501_ops;

#endif /* __INTEL_DVO_DEV_H__ */