1
2/* xf86DDC.h
3 *
4 * This file contains all information to interpret a standard EDIC block
5 * transmitted by a display device via DDC (Display Data Channel). So far
6 * there is no information to deal with optional EDID blocks.
7 * DDC is a Trademark of VESA (Video Electronics Standard Association).
8 *
9 * Copyright 1998 by Egbert Eich <Egbert.Eich@Physik.TU-Darmstadt.DE>
10 */
11
12#ifndef XF86_DDC_H
13# define XF86_DDC_H
14
15#include "edid.h"
16#include "xf86i2c.h"
17#include "xf86str.h"
18
19/* speed up / slow down */
20typedef enum {
21  DDC_SLOW,
22  DDC_FAST
23} xf86ddcSpeed;
24
25typedef void (* DDC1SetSpeedProc)(ScrnInfoPtr, xf86ddcSpeed);
26
27extern _X_EXPORT xf86MonPtr xf86DoEDID_DDC1(
28    int scrnIndex,
29    DDC1SetSpeedProc DDC1SetSpeed,
30    unsigned int (*DDC1Read)(ScrnInfoPtr)
31);
32
33extern _X_EXPORT xf86MonPtr xf86DoEDID_DDC2(
34   int scrnIndex,
35   I2CBusPtr pBus
36);
37
38extern _X_EXPORT xf86MonPtr xf86DoEEDID(int scrnIndex, I2CBusPtr pBus, Bool);
39
40extern _X_EXPORT xf86MonPtr xf86PrintEDID(
41    xf86MonPtr monPtr
42);
43
44extern _X_EXPORT xf86MonPtr xf86InterpretEDID(
45    int screenIndex, Uchar *block
46);
47
48extern _X_EXPORT xf86MonPtr xf86InterpretEEDID(
49    int screenIndex, Uchar *block
50);
51
52extern _X_EXPORT void
53xf86EdidMonitorSet(int scrnIndex, MonPtr Monitor, xf86MonPtr DDC);
54
55extern _X_EXPORT Bool xf86SetDDCproperties(
56    ScrnInfoPtr pScreen,
57    xf86MonPtr DDC
58);
59
60extern _X_EXPORT Bool
61xf86MonitorIsHDMI(xf86MonPtr mon);
62
63extern _X_EXPORT xf86MonPtr
64xf86DoDisplayID(int scrnIndex, I2CBusPtr pBus);
65
66extern _X_EXPORT void
67xf86DisplayIDMonitorSet(int scrnIndex, MonPtr mon, xf86MonPtr DDC);
68
69extern _X_EXPORT DisplayModePtr
70FindDMTMode(int hsize, int vsize, int refresh, Bool rb);
71
72extern _X_EXPORT const DisplayModeRec DMTModes[];
73
74/*
75 * Quirks to work around broken EDID data from various monitors.
76 */
77typedef enum {
78    DDC_QUIRK_NONE = 0,
79    /* First detailed mode is bogus, prefer largest mode at 60hz */
80    DDC_QUIRK_PREFER_LARGE_60 = 1 << 0,
81    /* 135MHz clock is too high, drop a bit */
82    DDC_QUIRK_135_CLOCK_TOO_HIGH = 1 << 1,
83    /* Prefer the largest mode at 75 Hz */
84    DDC_QUIRK_PREFER_LARGE_75 = 1 << 2,
85    /* Convert detailed timing's horizontal from units of cm to mm */
86    DDC_QUIRK_DETAILED_H_IN_CM = 1 << 3,
87    /* Convert detailed timing's vertical from units of cm to mm */
88    DDC_QUIRK_DETAILED_V_IN_CM = 1 << 4,
89    /* Detailed timing descriptors have bogus size values, so just take the
90     * maximum size and use that.
91     */
92    DDC_QUIRK_DETAILED_USE_MAXIMUM_SIZE = 1 << 5,
93    /* Monitor forgot to set the first detailed is preferred bit. */
94    DDC_QUIRK_FIRST_DETAILED_PREFERRED = 1 << 6,
95    /* use +hsync +vsync for detailed mode */
96    DDC_QUIRK_DETAILED_SYNC_PP = 1 << 7,
97    /* Force single-link DVI bandwidth limit */
98    DDC_QUIRK_DVI_SINGLE_LINK = 1 << 8,
99} ddc_quirk_t;
100
101typedef void (* handle_detailed_fn)(struct detailed_monitor_section *,void *);
102
103void xf86ForEachDetailedBlock(xf86MonPtr mon,
104                              handle_detailed_fn,
105                              void *data);
106
107ddc_quirk_t
108xf86DDCDetectQuirks(int scrnIndex, xf86MonPtr DDC, Bool verbose);
109
110void xf86DetTimingApplyQuirks(struct detailed_monitor_section *det_mon,
111                              ddc_quirk_t quirks, int hsize, int vsize);
112
113typedef void (* handle_video_fn)(struct cea_video_block *, void *);
114
115void xf86ForEachVideoBlock(xf86MonPtr,
116                           handle_video_fn,
117                           void *);
118
119#endif
120