3 Copyright (c) 2006, Intel Corporation. All rights reserved.<BR>
4 This program and the accompanying materials
5 are licensed and made available under the terms and conditions of the BSD License
6 which accompanies this distribution. The full text of the license may be found at
7 http://opensource.org/licenses/bsd-license.php
9 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
10 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
22 #ifndef _VESA_BIOS_EXTENSIONS_H
23 #define _VESA_BIOS_EXTENSIONS_H
26 // Turn on byte packing of data structures
30 // VESA BIOS Extensions status codes
32 #define VESA_BIOS_EXTENSIONS_STATUS_SUCCESS 0x004f
35 // VESA BIOS Extensions Services
37 #define VESA_BIOS_EXTENSIONS_RETURN_CONTROLLER_INFORMATION 0x4f00
42 Function 00 : Return Controller Information
47 ES:DI = Pointer to buffer to place VESA_BIOS_EXTENSIONS_INFORMATION_BLOCK structure
52 #define VESA_BIOS_EXTENSIONS_RETURN_MODE_INFORMATION 0x4f01
57 Function 01 : Return Mode Information
63 ES:DI = Pointer to buffer to place VESA_BIOS_EXTENSIONS_MODE_INFORMATION_BLOCK structure
68 #define VESA_BIOS_EXTENSIONS_SET_MODE 0x4f02
73 Function 02 : Set Mode
78 BX = Desired mode to set
80 D9-D10 = Reserved (must be 0)
81 D11 = 0 - Use current default refresh rate
82 = 1 - Use user specfieid CRTC values for refresh rate
83 D12-D13 = Reserved (must be 0)
84 D14 = 0 - Use windowed frame buffer model
85 = 1 - Use linear/flat frame buffer model
86 D15 = 0 - Clear display memory
87 = 1 - Don't clear display memory
88 ES:DI = Pointer to buffer to the VESA_BIOS_EXTENSIONS_CRTC_INFORMATION_BLOCK structure
93 #define VESA_BIOS_EXTENSIONS_RETURN_CURRENT_MODE 0x4f03
98 Function 03 : Return Current Mode
107 D14 = 0 - Windowed frame buffer model
108 = 1 - Linear/flat frame buffer model
109 D15 = 0 - Memory cleared at last mode set
110 = 1 - Memory not cleared at last mode set
113 #define VESA_BIOS_EXTENSIONS_SAVE_RESTORE_STATE 0x4f04
118 Function 04 : Save/Restore State
123 DL = 0x00 - Return Save/Restore State buffer size
125 = 0x02 - Restore State
126 CX = Requested Status
127 D0 = Save/Restore controller hardware state
128 D1 = Save/Restore BIOS data state
129 D2 = Save/Restore DAC state
130 D3 = Save/Restore Regsiter state
131 ES:BX = Pointer to buffer if DL=1 or DL=2
134 BX = Number of 64 byte blocks to hold the state buffer if DL=0
137 #define VESA_BIOS_EXTENSIONS_EDID 0x4f15
142 Function 15 : implement VBE/DDC service
147 BL = 0x00 - Report VBE/DDC Capabilities
148 CX = 0x00 - Controller unit number (00 = primary controller)
149 ES:DI = Null pointer, must be 0:0 in version 1.0
152 BH = Approx. time in seconds, rounded up, to transfer one EDID block(128 bytes)
153 BL = DDC level supported
154 D0 = 0 DDC1 not supported
156 D1 = 0 DDC2 not supported
158 D2 = 0 Screen not blanked during data transfer
159 = 1 Screen blanked during data transfer
163 BL = 0x01 - Read EDID
164 CX = 0x00 - Controller unit number (00 = primary controller)
165 DX = 0x00 - EDID block number
166 ES:DI = Pointer to buffer in which the EDID block is returned
172 // Timing data from EDID data block
174 #define VESA_BIOS_EXTENSIONS_EDID_BLOCK_SIZE 128
175 #define VESA_BIOS_EXTENSIONS_EDID_ESTABLISHED_TIMING_MAX_NUMBER 17
178 UINT16 HorizontalResolution
;
179 UINT16 VerticalResolution
;
181 } VESA_BIOS_EXTENSIONS_EDID_TIMING
;
185 UINT32 Key
[VESA_BIOS_EXTENSIONS_EDID_ESTABLISHED_TIMING_MAX_NUMBER
];
186 } VESA_BIOS_EXTENSIONS_VALID_EDID_TIMING
;
189 UINT8 Header
[8]; //EDID header "00 FF FF FF FF FF FF 00"
190 UINT16 ManufactureName
; //EISA 3-character ID
191 UINT16 ProductCode
; //Vendor assigned code
192 UINT32 SerialNumber
; //32-bit serial number
193 UINT8 WeekOfManufacture
; //Week number
194 UINT8 YearOfManufacture
; //Year
195 UINT8 EdidVersion
; //EDID Structure Version
196 UINT8 EdidRevision
; //EDID Structure Revision
197 UINT8 VideoInputDefinition
;
198 UINT8 MaxHorizontalImageSize
; //cm
199 UINT8 MaxVerticalImageSize
; //cm
200 UINT8 DisplayTransferCharacteristic
;
201 UINT8 FeatureSupport
;
202 UINT8 RedGreenLowBits
; //Rx1 Rx0 Ry1 Ry0 Gx1 Gx0 Gy1Gy0
203 UINT8 BlueWhiteLowBits
; //Bx1 Bx0 By1 By0 Wx1 Wx0 Wy1 Wy0
204 UINT8 RedX
; //Red-x Bits 9 - 2
205 UINT8 RedY
; //Red-y Bits 9 - 2
206 UINT8 GreenX
; //Green-x Bits 9 - 2
207 UINT8 GreenY
; //Green-y Bits 9 - 2
208 UINT8 BlueX
; //Blue-x Bits 9 - 2
209 UINT8 BlueY
; //Blue-y Bits 9 - 2
210 UINT8 WhiteX
; //White-x Bits 9 - 2
211 UINT8 WhiteY
; //White-x Bits 9 - 2
212 UINT8 EstablishedTimings
[3];
213 UINT8 StandardTimingIdentification
[16];
214 UINT8 DetailedTimingDescriptions
[72];
215 UINT8 ExtensionFlag
; //Number of (optional) 128-byte EDID extension blocks to follow
217 } VESA_BIOS_EXTENSIONS_EDID_DATA_BLOCK
;
220 // Super VGA Information Block
223 UINT32 VESASignature
; // 'VESA' 4 byte signature
224 UINT16 VESAVersion
; // VBE version number
225 UINT32 OEMStringPtr
; // Pointer to OEM string
226 UINT32 Capabilities
; // Capabilities of video card
227 UINT32 VideoModePtr
; // Pointer to an array of 16-bit supported modes values terminated by 0xFFFF
228 UINT16 TotalMemory
; // Number of 64kb memory blocks
229 UINT16 OemSoftwareRev
; // VBE implementation Software revision
230 UINT32 OemVendorNamePtr
; // VbeFarPtr to Vendor Name String
231 UINT32 OemProductNamePtr
; // VbeFarPtr to Product Name String
232 UINT32 OemProductRevPtr
; // VbeFarPtr to Product Revision String
233 UINT8 Reserved
[222]; // Reserved for VBE implementation scratch area
234 UINT8 OemData
[256]; // Data area for OEM strings. Pad to 512 byte block size
235 } VESA_BIOS_EXTENSIONS_INFORMATION_BLOCK
;
238 // Super VGA Information Block VESASignature values
240 #define VESA_BIOS_EXTENSIONS_VESA_SIGNATURE SIGNATURE_32 ('V', 'E', 'S', 'A')
241 #define VESA_BIOS_EXTENSIONS_VBE2_SIGNATURE SIGNATURE_32 ('V', 'B', 'E', '2')
244 // Super VGA Information Block VESAVersion values
246 #define VESA_BIOS_EXTENSIONS_VERSION_1_2 0x0102
247 #define VESA_BIOS_EXTENSIONS_VERSION_2_0 0x0200
248 #define VESA_BIOS_EXTENSIONS_VERSION_3_0 0x0300
251 // Super VGA Information Block Capabilities field bit defintions
253 #define VESA_BIOS_EXTENSIONS_CAPABILITY_8_BIT_DAC 0x01 // 0: DAC width is fixed at 6 bits/color
254 // 1: DAC width switchable to 8 bits/color
256 #define VESA_BIOS_EXTENSIONS_CAPABILITY_NOT_VGA 0x02 // 0: Controller is VGA compatible
257 // 1: Controller is not VGA compatible
259 #define VESA_BIOS_EXTENSIONS_CAPABILITY_NOT_NORMAL_RAMDAC 0x04 // 0: Normal RAMDAC operation
260 // 1: Use blank bit in function 9 to program RAMDAC
262 #define VESA_BIOS_EXTENSIONS_CAPABILITY_STEREOSCOPIC 0x08 // 0: No hardware stereoscopic signal support
263 // 1: Hardware stereoscopic signal support
265 #define VESA_BIOS_EXTENSIONS_CAPABILITY_VESA_EVC 0x10 // 0: Stero signaling supported via external VESA stereo connector
266 // 1: Stero signaling supported via VESA EVC connector
268 // Super VGA mode number bite field definitions
270 #define VESA_BIOS_EXTENSIONS_MODE_NUMBER_VESA 0x0100 // 0: Not a VESA defined VBE mode
271 // 1: A VESA defined VBE mode
273 #define VESA_BIOS_EXTENSIONS_MODE_NUMBER_REFRESH_CONTROL_USER 0x0800 // 0: Use current BIOS default referesh rate
274 // 1: Use the user specified CRTC values for refresh rate
276 #define VESA_BIOS_EXTENSIONS_MODE_NUMBER_LINEAR_FRAME_BUFFER 0x4000 // 0: Use a banked/windowed frame buffer
277 // 1: Use a linear/flat frame buffer
279 #define VESA_BIOS_EXTENSIONS_MODE_NUMBER_PRESERVE_MEMORY 0x8000 // 0: Clear display memory
280 // 1: Preseve display memory
282 // Super VGA Information Block mode list terminator value
284 #define VESA_BIOS_EXTENSIONS_END_OF_MODE_LIST 0xffff
291 (*VESA_BIOS_EXTENSIONS_WINDOW_FUNCTION
) (
296 // Super VGA Mode Information Block
300 // Manadory fields for all VESA Bios Extensions revisions
302 UINT16 ModeAttributes
; // Mode attributes
303 UINT8 WinAAttributes
; // Window A attributes
304 UINT8 WinBAttributes
; // Window B attributes
305 UINT16 WinGranularity
; // Window granularity in k
306 UINT16 WinSize
; // Window size in k
307 UINT16 WinASegment
; // Window A segment
308 UINT16 WinBSegment
; // Window B segment
309 UINT32 WindowFunction
; // Pointer to window function
310 UINT16 BytesPerScanLine
; // Bytes per scanline
312 // Manadory fields for VESA Bios Extensions 1.2 and above
314 UINT16 XResolution
; // Horizontal resolution
315 UINT16 YResolution
; // Vertical resolution
316 UINT8 XCharSize
; // Character cell width
317 UINT8 YCharSize
; // Character cell height
318 UINT8 NumberOfPlanes
; // Number of memory planes
319 UINT8 BitsPerPixel
; // Bits per pixel
320 UINT8 NumberOfBanks
; // Number of CGA style banks
321 UINT8 MemoryModel
; // Memory model type
322 UINT8 BankSize
; // Size of CGA style banks
323 UINT8 NumberOfImagePages
; // Number of images pages
324 UINT8 Reserved1
; // Reserved
325 UINT8 RedMaskSize
; // Size of direct color red mask
326 UINT8 RedFieldPosition
; // Bit posn of lsb of red mask
327 UINT8 GreenMaskSize
; // Size of direct color green mask
328 UINT8 GreenFieldPosition
; // Bit posn of lsb of green mask
329 UINT8 BlueMaskSize
; // Size of direct color blue mask
330 UINT8 BlueFieldPosition
; // Bit posn of lsb of blue mask
331 UINT8 RsvdMaskSize
; // Size of direct color res mask
332 UINT8 RsvdFieldPosition
; // Bit posn of lsb of res mask
333 UINT8 DirectColorModeInfo
; // Direct color mode attributes
335 // Manadory fields for VESA Bios Extensions 2.0 and above
337 UINT32 PhysBasePtr
; // Physical Address for flat memory frame buffer
338 UINT32 Reserved2
; // Reserved
339 UINT16 Reserved3
; // Reserved
341 // Manadory fields for VESA Bios Extensions 3.0 and above
343 UINT16 LinBytesPerScanLine
; // Bytes/scan line for linear modes
344 UINT8 BnkNumberOfImagePages
; // Number of images for banked modes
345 UINT8 LinNumberOfImagePages
; // Number of images for linear modes
346 UINT8 LinRedMaskSize
; // Size of direct color red mask (linear mode)
347 UINT8 LinRedFieldPosition
; // Bit posiiton of lsb of red mask (linear modes)
348 UINT8 LinGreenMaskSize
; // Size of direct color green mask (linear mode)
349 UINT8 LinGreenFieldPosition
; // Bit posiiton of lsb of green mask (linear modes)
350 UINT8 LinBlueMaskSize
; // Size of direct color blue mask (linear mode)
351 UINT8 LinBlueFieldPosition
; // Bit posiiton of lsb of blue mask (linear modes)
352 UINT8 LinRsvdMaskSize
; // Size of direct color reserved mask (linear mode)
353 UINT8 LinRsvdFieldPosition
; // Bit posiiton of lsb of reserved mask (linear modes)
354 UINT32 MaxPixelClock
; // Maximum pixel clock (in Hz) for graphics mode
355 UINT8 Pad
[190]; // Pad to 256 byte block size
356 } VESA_BIOS_EXTENSIONS_MODE_INFORMATION_BLOCK
;
359 // Super VGA Mode Information Block ModeAttributes field bit defintions
361 #define VESA_BIOS_EXTENSIONS_MODE_ATTRIBUTE_HARDWARE 0x0001 // 0: Mode not supported in handware
362 // 1: Mode supported in handware
364 #define VESA_BIOS_EXTENSIONS_MODE_ATTRIBUTE_TTY 0x0004 // 0: TTY Output functions not supported by BIOS
365 // 1: TTY Output functions supported by BIOS
367 #define VESA_BIOS_EXTENSIONS_MODE_ATTRIBUTE_COLOR 0x0008 // 0: Monochrome mode
370 #define VESA_BIOS_EXTENSIONS_MODE_ATTRIBUTE_GRAPHICS 0x0010 // 0: Text mode
373 #define VESA_BIOS_EXTENSIONS_MODE_ATTRIBUTE_NOT_VGA 0x0020 // 0: VGA compatible mode
374 // 1: Not a VGA compatible mode
376 #define VESA_BIOS_EXTENSIONS_MODE_ATTRIBUTE_NOT_WINDOWED 0x0040 // 0: VGA compatible windowed memory mode
377 // 1: Not a VGA compatible windowed memory mode
379 #define VESA_BIOS_EXTENSIONS_MODE_ATTRIBUTE_LINEAR_FRAME_BUFFER 0x0080 // 0: No linear fram buffer mode available
380 // 1: Linear frame buffer mode available
382 #define VESA_BIOS_EXTENSIONS_MODE_ATTRIBUTE_DOUBLE_SCAN 0x0100 // 0: No double scan mode available
383 // 1: Double scan mode available
385 #define VESA_BIOS_EXTENSIONS_MODE_ATTRIBUTE_INTERLACED 0x0200 // 0: No interlaced mode is available
386 // 1: Interlaced mode is available
388 #define VESA_BIOS_EXTENSIONS_MODE_ATTRIBUTE_NO_TRIPPLE_BUFFER 0x0400 // 0: No hardware triple buffer mode support available
389 // 1: Hardware triple buffer mode support available
391 #define VESA_BIOS_EXTENSIONS_MODE_ATTRIBUTE_STEREOSCOPIC 0x0800 // 0: No hardware steroscopic display support
392 // 1: Hardware steroscopic display support
394 #define VESA_BIOS_EXTENSIONS_MODE_ATTRIBUTE_DUAL_DISPLAY 0x1000 // 0: No dual display start address support
395 // 1: Dual display start address support
397 // Super VGA Mode Information Block WinAAttribite/WinBAttributes field bit defintions
399 #define VESA_BIOS_EXTENSIONS_WINX_ATTRIBUTE_RELOCATABLE 0x01 // 0: Single non-relocatable window only
400 // 1: Relocatable window(s) are supported
402 #define VESA_BIOS_EXTENSIONS_WINX_ATTRIBUTE_READABLE 0x02 // 0: Window is not readable
403 // 1: Window is readable
405 #define VESA_BIOS_EXTENSIONS_WINX_ATTRIBUTE_WRITABLE 0x04 // 0: Window is not writable
406 // 1: Window is writable
408 // Super VGA Mode Information Block DirectColorMode field bit defintions
410 #define VESA_BIOS_EXTENSIONS_DIRECT_COLOR_MODE_PROG_COLOR_RAMP 0x01 // 0: Color ram is fixed
411 // 1: Color ramp is programmable
413 #define VESA_BIOS_EXTENSIONS_DIRECT_COLOR_MODE_RSVD_USABLE 0x02 // 0: Bits in Rsvd field are reserved
414 // 1: Bits in Rsdv field are usable
416 // Super VGA Memory Models
419 memPL
= 3, // Planar memory model
420 memPK
= 4, // Packed pixel memory model
421 memRGB
= 6, // Direct color RGB memory model
422 memYUV
= 7 // Direct color YUV memory model
423 } VESA_BIOS_EXTENSIONS_MEMORY_MODELS
;
426 // Super VGA CRTC Information Block
429 UINT16 HorizontalTotal
; // Horizontal total in pixels
430 UINT16 HorizontalSyncStart
; // Horizontal sync start in pixels
431 UINT16 HorizontalSyncEnd
; // Horizontal sync end in pixels
432 UINT16 VericalTotal
; // Vertical total in pixels
433 UINT16 VericalSyncStart
; // Vertical sync start in pixels
434 UINT16 VericalSyncEnd
; // Vertical sync end in pixels
435 UINT8 Flags
; // Flags (Interlaced/DoubleScan/etc).
436 UINT32 PixelClock
; // Pixel clock in units of Hz
437 UINT16 RefreshRate
; // Refresh rate in units of 0.01 Hz
438 UINT8 Reserved
[40]; // Pad
439 } VESA_BIOS_EXTENSIONS_CRTC_INFORMATION_BLOCK
;
441 #define VESA_BIOS_EXTENSIONS_CRTC_FLAGS_DOUBLE_SCAN 0x01 // 0: Graphics mode is not souble scanned
442 // 1: Graphics mode is double scanned
444 #define VESA_BIOS_EXTENSIONS_CRTC_FLAGSINTERLACED 0x02 // 0: Graphics mode is not interlaced
445 // 1: Graphics mode is interlaced
447 #define VESA_BIOS_EXTENSIONS_CRTC_HORIZONTAL_SYNC_NEGATIVE 0x04 // 0: Horizontal sync polarity is positive(+)
448 // 0: Horizontal sync polarity is negative(-)
450 #define VESA_BIOS_EXTENSIONS_CRTC_VERITICAL_SYNC_NEGATIVE 0x08 // 0: Verical sync polarity is positive(+)
451 // 0: Verical sync polarity is negative(-)
453 // Turn off byte packing of data structures