| 1 | Kernel driver `ddcmon.o' |
|---|
| 2 | ======================== |
|---|
| 3 | |
|---|
| 4 | Status: As complete as we want it to be, lightly tested |
|---|
| 5 | |
|---|
| 6 | Supported chips: |
|---|
| 7 | * Any DDC Monitor EDID EEPROM chip at 0x50 |
|---|
| 8 | Prefix `ddcmon' |
|---|
| 9 | Addresses scanned: I2C 0x50 |
|---|
| 10 | Standards: available for purchase from VESA http://www.vesa.org |
|---|
| 11 | Datasheets: Publicly available from Atmel (www.atmel.com), |
|---|
| 12 | Fairchild (www.fairchildsemi.com), and |
|---|
| 13 | Microchip (www.microchip.com) |
|---|
| 14 | |
|---|
| 15 | Chip Size (bits) Address |
|---|
| 16 | 24C01 1K 0x50 (shadows at 0x51 - 0x57) |
|---|
| 17 | (Typical device in monitors) |
|---|
| 18 | 24C01A 1K 0x50 - 0x57 (Typical device in monitors) |
|---|
| 19 | 24C02 2K 0x50 - 0x57 |
|---|
| 20 | 24C04 4K 0x50, 0x52, 0x54, 0x56 |
|---|
| 21 | (additional data at 0x51, 0x53, 0x55, 0x57) |
|---|
| 22 | 24C08 8K 0x50, 0x54 (additional data at 0x51, 0x52, |
|---|
| 23 | 0x53, 0x55, 0x56, 0x57) |
|---|
| 24 | 24C16 16K 0x50 (additional data at 0x51 - 0x57) |
|---|
| 25 | |
|---|
| 26 | |
|---|
| 27 | Author: Frodo Looijaard <frodol@dds.nl>, Philip Edelbrock |
|---|
| 28 | <phil@netroedge.com>, Mark Studebaker <mdsxyz123@yahoo.com> and |
|---|
| 29 | Jean Delvare <khali@linux-fr.org> |
|---|
| 30 | |
|---|
| 31 | Special assistance on DDC provided by Petr Vandrovec <vandrove@vc.cvut.cz> |
|---|
| 32 | |
|---|
| 33 | License: GPL |
|---|
| 34 | |
|---|
| 35 | |
|---|
| 36 | Module Parameters |
|---|
| 37 | ----------------- |
|---|
| 38 | |
|---|
| 39 | * force: short array (min = 1, max = 48) |
|---|
| 40 | List of adapter,address pairs to boldly assume to be present |
|---|
| 41 | * force_ddcmon: short array (min = 1, max = 48) |
|---|
| 42 | Same as 'force' |
|---|
| 43 | * ignore: short array (min = 1, max = 48) |
|---|
| 44 | List of adapter,address pairs not to scan |
|---|
| 45 | * ignore_range: short array (min = 1, max = 48) |
|---|
| 46 | List of adapter,start-addr,end-addr triples not to scan |
|---|
| 47 | * probe: short array (min = 1, max = 48) |
|---|
| 48 | List of adapter,address pairs to scan additionally |
|---|
| 49 | * probe_range: short array (min = 1, max = 48) |
|---|
| 50 | List of adapter,start-addr,end-addr triples to scan additionally |
|---|
| 51 | * checksum: int |
|---|
| 52 | Only accept eeproms whose checksum is correct |
|---|
| 53 | |
|---|
| 54 | |
|---|
| 55 | Description |
|---|
| 56 | ----------- |
|---|
| 57 | |
|---|
| 58 | This is a simple module for reading the EEPROM on a DDC-compliant monitor. |
|---|
| 59 | DDC (Display Data Channel) is the I2C-based communication channel |
|---|
| 60 | to the monitor. The EEPROM contains a 128-byte data structure defined |
|---|
| 61 | by the EDID (Extended Display Identification Data) standard. |
|---|
| 62 | |
|---|
| 63 | Use: |
|---|
| 64 | |
|---|
| 65 | After inserting the module (and any other required smbus/i2c modules), you |
|---|
| 66 | should have a directory in /proc/sys/dev/sensors/ with a name such |
|---|
| 67 | as "ddcmon-i2c-3-50". Inside each of these is a series of files which |
|---|
| 68 | represent interesting data from the DDC monitor. |
|---|
| 69 | |
|---|
| 70 | /proc entries: |
|---|
| 71 | |
|---|
| 72 | dpms: bitmask |
|---|
| 73 | DPMS support flags |
|---|
| 74 | 0x20 Active Off |
|---|
| 75 | 0x40 Suspend |
|---|
| 76 | 0x80 Standby |
|---|
| 77 | |
|---|
| 78 | edid: 2 integers |
|---|
| 79 | EDID version and revision |
|---|
| 80 | |
|---|
| 81 | gamma: 1 float |
|---|
| 82 | gamma factor |
|---|
| 83 | |
|---|
| 84 | id: 2 integers |
|---|
| 85 | manufacturer ID and product ID |
|---|
| 86 | Manufacturer ID is encoded, see 'sensors' |
|---|
| 87 | source ../../prog/sensors/chips.c. |
|---|
| 88 | |
|---|
| 89 | maxclock: 1 integer |
|---|
| 90 | max pixel clock (also known as video bandwidth) (MHz) |
|---|
| 91 | 0 if not available. |
|---|
| 92 | |
|---|
| 93 | serial: 1 integer |
|---|
| 94 | serial number |
|---|
| 95 | Encoding depends on the manufacturer, don't expect the |
|---|
| 96 | real serial number here. 0 probably means "not available". |
|---|
| 97 | |
|---|
| 98 | size: 2 integers |
|---|
| 99 | vertical monitor size (cm) |
|---|
| 100 | horizontal monitor size (cm) |
|---|
| 101 | |
|---|
| 102 | sync: 4 integers |
|---|
| 103 | minimum vertical sync frequency (Hz) |
|---|
| 104 | maximum vertical sync frequency (Hz) |
|---|
| 105 | minimum horizontal sync frequency (KHz) |
|---|
| 106 | maximum horizontal sync frequency (KHz) |
|---|
| 107 | 0 0 0 0 if not available. |
|---|
| 108 | |
|---|
| 109 | time: 2 integers |
|---|
| 110 | Manufacture year and week |
|---|
| 111 | |
|---|
| 112 | timing[1-8]: 3 integers |
|---|
| 113 | supported standard timing |
|---|
| 114 | horizontal resolution |
|---|
| 115 | vertical resolution |
|---|
| 116 | (vertical) refresh rate |
|---|
| 117 | 0 0 0 if not used. |
|---|
| 118 | |
|---|
| 119 | timings: bitmask |
|---|
| 120 | supported established timings |
|---|
| 121 | 0x000001 720x400@70Hz (VGA 640x400, IBM) |
|---|
| 122 | 0x000002 720x400@88Hz (XGA2) |
|---|
| 123 | 0x000004 640x480@60Hz (VGA) |
|---|
| 124 | 0x000008 640x480@67Hz (Mac II, Apple) |
|---|
| 125 | 0x000010 640x480@72Hz (VESA) |
|---|
| 126 | 0x000020 640x480@75Hz (VESA) |
|---|
| 127 | 0x000040 800x600@56Hz (VESA) |
|---|
| 128 | 0x000080 800x600@60Hz (VESA) |
|---|
| 129 | 0x000100 800x600@72Hz (VESA) |
|---|
| 130 | 0x000200 800x600@75Hz (VESA) |
|---|
| 131 | 0x000400 832x624@75Hz (Mac II) |
|---|
| 132 | 0x000800 1024x768@87Hz interlaced (8514A) |
|---|
| 133 | 0x001000 1024x768@60Hz (VESA) |
|---|
| 134 | 0x002000 1024x768@70Hz (VESA) |
|---|
| 135 | 0x004000 1024x768@75Hz (VESA) |
|---|
| 136 | 0x008000 1280x1024@75Hz (VESA) |
|---|
| 137 | 0x010000 - 0x800000 Manufacturer reserved |
|---|
| 138 | 0x800000 1152x870 @ 75 Hz (Mac II, Apple)? |
|---|
| 139 | |
|---|
| 140 | |
|---|
| 141 | Chip Features |
|---|
| 142 | ------------- |
|---|
| 143 | |
|---|
| 144 | Chip 'ddcmon' |
|---|
| 145 | |
|---|
| 146 | LABEL LABEL CLASS COMPUTE CLASS MODE MAGN |
|---|
| 147 | Manufacturer ID - - R- 0 |
|---|
| 148 | Model Number - - R- 0 |
|---|
| 149 | Monitor Size (cm) - - R- 0 |
|---|
| 150 | hsize Monitor Size (cm) - R- 0 |
|---|
| 151 | Vertical Sync (Hz) - - R- 0 |
|---|
| 152 | v_sync_max Vertical Sync (Hz) - R- 0 |
|---|
| 153 | Horizontal Sync (KHz) - - R- 0 |
|---|
| 154 | h_sync_max Horizontal Sync (KHz) - R- 0 |
|---|
| 155 | Established Timings - - R- 0 |
|---|
| 156 | Serial Number - - R- 0 |
|---|
| 157 | Manufacture Time - - R- 0 |
|---|
| 158 | week Manufacture Time - R- 0 |
|---|
| 159 | EDID Version - - R- 0 |
|---|
| 160 | revision EDID Version - R- 0 |
|---|
| 161 | Gamma Factor - - R- 2 |
|---|
| 162 | DPMS Modes - - R- 0 |
|---|
| 163 | Standard Timing 1 - - R- 0 |
|---|
| 164 | vertical Standard Timing 1 - R- 0 |
|---|
| 165 | refresh Standard Timing 1 - R- 0 |
|---|
| 166 | Standard Timing 2 - - R- 0 |
|---|
| 167 | vertical Standard Timing 2 - R- 0 |
|---|
| 168 | refresh Standard Timing 2 - R- 0 |
|---|
| 169 | Standard Timing 3 - - R- 0 |
|---|
| 170 | vertical Standard Timing 3 - R- 0 |
|---|
| 171 | refresh Standard Timing 3 - R- 0 |
|---|
| 172 | Standard Timing 4 - - R- 0 |
|---|
| 173 | vertical Standard Timing 4 - R- 0 |
|---|
| 174 | refresh Standard Timing 4 - R- 0 |
|---|
| 175 | Standard Timing 5 - - R- 0 |
|---|
| 176 | vertical Standard Timing 5 - R- 0 |
|---|
| 177 | refresh Standard Timing 5 - R- 0 |
|---|
| 178 | Standard Timing 6 - - R- 0 |
|---|
| 179 | vertical Standard Timing 6 - R- 0 |
|---|
| 180 | refresh Standard Timing 6 - R- 0 |
|---|
| 181 | Standard Timing 7 - - R- 0 |
|---|
| 182 | vertical Standard Timing 7 - R- 0 |
|---|
| 183 | refresh Standard Timing 7 - R- 0 |
|---|
| 184 | Standard Timing 8 - - R- 0 |
|---|
| 185 | vertical Standard Timing 8 - R- 0 |
|---|
| 186 | refresh Standard Timing 8 - R- 0 |
|---|
| 187 | Max Pixel Clock (MHz) - - R- 0 |
|---|
| 188 | |
|---|
| 189 | LABEL FEATURE SYMBOL SYSCTL FILE:N |
|---|
| 190 | Manufacturer ID SENSORS_DDCMON_MAN_ID id:1 |
|---|
| 191 | Model Number SENSORS_DDCMON_PROD_ID id:2 |
|---|
| 192 | Monitor Size (cm) SENSORS_DDCMON_VERSIZE size:1 |
|---|
| 193 | hsize SENSORS_DDCMON_HORSIZE size:2 |
|---|
| 194 | Vertical Sync (Hz) SENSORS_DDCMON_VERSYNCMIN sync:1 |
|---|
| 195 | v_sync_max SENSORS_DDCMON_VERSYNCMAX sync:2 |
|---|
| 196 | Horizontal Sync (KHz) SENSORS_DDCMON_HORSYNCMIN sync:3 |
|---|
| 197 | h_sync_max SENSORS_DDCMON_HORSYNCMAX sync:4 |
|---|
| 198 | Established Timings SENSORS_DDCMON_TIMINGS timings:1 |
|---|
| 199 | Serial Number SENSORS_DDCMON_SERIAL serial:1 |
|---|
| 200 | Manufacture Time SENSORS_DDCMON_YEAR time:1 |
|---|
| 201 | week SENSORS_DDCMON_WEEK time:2 |
|---|
| 202 | EDID Version SENSORS_DDCMON_EDID_VER edid:1 |
|---|
| 203 | revision SENSORS_DDCMON_EDID_REV edid:2 |
|---|
| 204 | Gamma Factor SENSORS_DDCMON_GAMMA gamma:1 |
|---|
| 205 | DPMS Modes SENSORS_DDCMON_DPMS dpms:1 |
|---|
| 206 | Standard Timing 1 SENSORS_DDCMON_TIMING1_HOR timing1:1 |
|---|
| 207 | vertical SENSORS_DDCMON_TIMING1_VER timing1:2 |
|---|
| 208 | refresh SENSORS_DDCMON_TIMING1_REF timing1:3 |
|---|
| 209 | Standard Timing 2 SENSORS_DDCMON_TIMING2_HOR timing2:1 |
|---|
| 210 | vertical SENSORS_DDCMON_TIMING2_VER timing2:2 |
|---|
| 211 | refresh SENSORS_DDCMON_TIMING2_REF timing2:3 |
|---|
| 212 | Standard Timing 3 SENSORS_DDCMON_TIMING3_HOR timing3:1 |
|---|
| 213 | vertical SENSORS_DDCMON_TIMING3_VER timing3:2 |
|---|
| 214 | refresh SENSORS_DDCMON_TIMING3_REF timing3:3 |
|---|
| 215 | Standard Timing 4 SENSORS_DDCMON_TIMING4_HOR timing4:1 |
|---|
| 216 | vertical SENSORS_DDCMON_TIMING4_VER timing4:2 |
|---|
| 217 | refresh SENSORS_DDCMON_TIMING4_REF timing4:3 |
|---|
| 218 | Standard Timing 5 SENSORS_DDCMON_TIMING5_HOR timing5:1 |
|---|
| 219 | vertical SENSORS_DDCMON_TIMING5_VER timing5:2 |
|---|
| 220 | refresh SENSORS_DDCMON_TIMING5_REF timing5:3 |
|---|
| 221 | Standard Timing 6 SENSORS_DDCMON_TIMING6_HOR timing6:1 |
|---|
| 222 | vertical SENSORS_DDCMON_TIMING6_VER timing6:2 |
|---|
| 223 | refresh SENSORS_DDCMON_TIMING6_REF timing6:3 |
|---|
| 224 | Standard Timing 7 SENSORS_DDCMON_TIMING7_HOR timing7:1 |
|---|
| 225 | vertical SENSORS_DDCMON_TIMING7_VER timing7:2 |
|---|
| 226 | refresh SENSORS_DDCMON_TIMING7_REF timing7:3 |
|---|
| 227 | Standard Timing 8 SENSORS_DDCMON_TIMING8_HOR timing8:1 |
|---|
| 228 | vertical SENSORS_DDCMON_TIMING8_VER timing8:2 |
|---|
| 229 | refresh SENSORS_DDCMON_TIMING8_REF timing8:3 |
|---|
| 230 | Max Pixel Clock (MHz) SENSORS_DDCMON_MAXCLOCK maxclock:1 |
|---|
| 231 | |
|---|
| 232 | |
|---|
| 233 | Notes |
|---|
| 234 | ----- |
|---|
| 235 | |
|---|
| 236 | - The eeprom.o module will also attach to a DDC monitor. Install the |
|---|
| 237 | ddcmon.o module before the eeprom.o module to prevent this. |
|---|
| 238 | Alternatively, give the eeprom.o module an ignore= parameter or |
|---|
| 239 | a checksum= parameter. The ddcmon.o module will not attach to non-DDC |
|---|
| 240 | eeproms because it checks for a DDC 'signature' at the beginning |
|---|
| 241 | of the DDC Monitor's eeprom. Additionally, you can give it a checksum= |
|---|
| 242 | parameter. |
|---|
| 243 | |
|---|
| 244 | - If a DDC monitor eeprom lacks the 'signature', you may use the |
|---|
| 245 | 'force' parameter (modprobe ddcmon force=x,0x50 where 'x' is the |
|---|
| 246 | i2c bus number). |
|---|
| 247 | |
|---|
| 248 | - This module requires a bus driver for your video chip to access the |
|---|
| 249 | DDC bus. In this package, drivers exist for Voodoo3/Banshee chips. |
|---|
| 250 | See documentation for those drivers in ../busses. Other drivers |
|---|
| 251 | (Matrox and NVidia, for example) are available in the kernel or |
|---|
| 252 | elsewhere. See our 'Supported Devices' web page for details. |
|---|
| 253 | |
|---|
| 254 | - There is a checksum over the 128 bytes in the eeprom. The driver |
|---|
| 255 | used not to check it, now it does (providing you give it a |
|---|
| 256 | checksum= parameter). |
|---|
| 257 | |
|---|
| 258 | - More information is available in the eeprom which could be made |
|---|
| 259 | available by enhancing the driver. |
|---|
| 260 | To see the entire eeprom, use the eeprom.o module instead of ddcmon.o. |
|---|
| 261 | However, then you lose the DDC-specific formatting. |
|---|
| 262 | Also see ../../prog/eeprom/decode-edid.pl. |
|---|
| 263 | |
|---|
| 264 | - This driver does not support the DDC/CI (DDC2Bi) bidirectional |
|---|
| 265 | communications channel to the monitor for controlling the monitor. |
|---|
| 266 | |
|---|
| 267 | - The driver caches the data from the monitor and only rereads it |
|---|
| 268 | from the eeprom if the cache is more than 5 minutes old. |
|---|
| 269 | |
|---|
| 270 | - X 4.0 also accesses the DDC monitor EEPROM to auto-configure itself. |
|---|
| 271 | There could possibly be conflicts from these multiple accesses, but |
|---|
| 272 | none were ever reported so far. |
|---|
