windows-nt/Source/XPSP1/NT/drivers/video/ms/8514a/disp/hw.h

596 lines
20 KiB
C
Raw Normal View History

2020-09-26 03:20:57 -05:00
/******************************Module*Header*******************************\
* Module Name: hw.h
*
* All the hardware specific driver file stuff.
*
* Copyright (c) 1992-1994 Microsoft Corporation
*
\**************************************************************************/
////////////////////////////////////////////////////////////////////////
// Chip equates:
#define STATUS_1 0x3DA
#define VSY_NOT 0x08
#define CRTC_INDEX 0x3D4
#define CRTC_DATA 0x3D5
// Command types:
#define DRAW_LINE 0x2000
#define RECTANGLE_FILL 0x4000
#define BITBLT 0xC000
#define PATTERN_FILL 0xE000
#define BYTE_SWAP 0x1000
#define BUS_SIZE_16 0x0200
#define BUS_SIZE_8 0x0000
#define WAIT 0x0100
// Drawing directions (radial):
#define DRAWING_DIRECTION_0 0x0000
#define DRAWING_DIRECTION_45 0x0020
#define DRAWING_DIRECTION_90 0x0040
#define DRAWING_DIRECTION_135 0x0060
#define DRAWING_DIRECTION_180 0x0080
#define DRAWING_DIRECTION_225 0x00A0
#define DRAWING_DIRECTION_270 0x00C0
#define DRAWING_DIRECTION_315 0x00E0
// Drawing directions (x/y):
#define DRAWING_DIR_BTRLXM 0x0000
#define DRAWING_DIR_BTLRXM 0x0020
#define DRAWING_DIR_BTRLYM 0x0040
#define DRAWING_DIR_BTLRYM 0x0060
#define DRAWING_DIR_TBRLXM 0x0080
#define DRAWING_DIR_TBLRXM 0x00A0
#define DRAWING_DIR_TBRLYM 0x00C0
#define DRAWING_DIR_TBLRYM 0x00E0
// Drawing direction bits:
#define PLUS_X 0x0020
#define PLUS_Y 0x0080
#define MAJOR_Y 0x0040
// Draw:
#define DRAW 0x0010
// Direction type:
#define DIR_TYPE_RADIAL 0x0008
#define DIR_TYPE_XY 0x0000
// Last pixel:
#define LAST_PIXEL_OFF 0x0004
#define LAST_PIXEL_ON 0x0000
// Pixel mode:
#define MULTIPLE_PIXELS 0x0002
#define SINGLE_PIXEL 0x0000
// Read/write:
#define READ 0x0000
#define WRITE 0x0001
// Graphics processor status:
#define HARDWARE_BUSY 0x200
#define READ_DATA_AVAILABLE 0x100
// Fifo status in terms of empty entries:
#define FIFO_1_EMPTY 0x080
#define FIFO_2_EMPTY 0x040
#define FIFO_3_EMPTY 0x020
#define FIFO_4_EMPTY 0x010
#define FIFO_5_EMPTY 0x008
#define FIFO_6_EMPTY 0x004
#define FIFO_7_EMPTY 0x002
#define FIFO_8_EMPTY 0x001
// These are the defines for the multifunction control register.
// The 4 MSBs define the function of the register.
#define RECT_HEIGHT 0x0000
#define CLIP_TOP 0x1000
#define CLIP_LEFT 0x2000
#define CLIP_BOTTOM 0x3000
#define CLIP_RIGHT 0x4000
#define DATA_EXTENSION 0xA000
#define MULT_MISC_INDEX 0xE000
#define READ_SEL_INDEX 0xF000
#define ALL_ONES 0x0000
#define CPU_DATA 0x0080
#define DISPLAY_MEMORY 0x00C0
// Colour source:
#define BACKGROUND_COLOR 0x00
#define FOREGROUND_COLOR 0x20
#define SRC_CPU_DATA 0x40
#define SRC_DISPLAY_MEMORY 0x60
// Mix modes:
#define NOT_SCREEN 0x00
#define LOGICAL_0 0x01
#define LOGICAL_1 0x02
#define LEAVE_ALONE 0x03
#define NOT_NEW 0x04
#define SCREEN_XOR_NEW 0x05
#define NOT_SCREEN_XOR_NEW 0x06
#define OVERPAINT 0x07
#define NOT_SCREEN_OR_NOT_NEW 0x08
#define SCREEN_OR_NOT_NEW 0x09
#define NOT_SCREEN_OR_NEW 0x0A
#define SCREEN_OR_NEW 0x0B
#define SCREEN_AND_NEW 0x0C
#define NOT_SCREEN_AND_NEW 0x0D
#define SCREEN_AND_NOT_NEW 0x0E
#define NOT_SCREEN_AND_NOT_NEW 0x0F
// When one of the following bits is set in a hardware mix, it means
// that a pattern is needed (i.e., is none of NOT_SCREEN, LOGICAL_0,
// LOGICAL_1 or LEAVE_ALONE):
#define MIX_NEEDSPATTERN 0x0C
////////////////////////////////////////////////////////////////////
// 8514/A port control
////////////////////////////////////////////////////////////////////
// Accelerator port addresses:
#define SUBSYS_CNTL 0x42E8
#define CUR_Y 0x82E8
#define CUR_X 0x86E8
#define DEST_Y 0x8AE8
#define DEST_X 0x8EE8
#define AXSTP 0x8AE8
#define DIASTP 0x8EE8
#define ERR_TERM 0x92E8
#define MAJ_AXIS_PCNT 0x96E8
#define CMD 0x9AE8
#define SHORT_STROKE 0x9EE8
#define BKGD_COLOR 0xA2E8
#define FRGD_COLOR 0xA6E8
#define WRT_MASK 0xAAE8
#define RD_MASK 0xAEE8
#define COLOR_CMP 0xB2E8
#define BKGD_MIX 0xB6E8
#define FRGD_MIX 0xBAE8
#define MULTIFUNC_CNTL 0xBEE8
#define MIN_AXIS_PCNT 0xBEE8
#define SCISSORS_T 0xBEE8
#define SCISSORS_L 0xBEE8
#define SCISSORS_B 0xBEE8
#define SCISSORS_R 0xBEE8
#define PIX_CNTL 0xBEE8
#define PIX_TRANS 0xE2E8
////////////////////////////////////////////////////////////////////
// Macros for accessing accelerator registers:
#if defined(i386)
/////////////////////////////////////////////////////////////////////////
// x86
// Note: Don't cast (x) to a USHORT or compiler optimizations will
// be lost (the x86 compiler will convert any argument expressions
// to word operations, which will incur a one byte/one cycle
// size/performance hit from the resulting 0x66 size prefixes).
#define OUTPW(p, x) WRITE_PORT_USHORT((p), (x))
#define OUTP(p, x) WRITE_PORT_UCHAR((p), (x))
#define INPW(p) READ_PORT_USHORT(p)
#define INP(p) READ_PORT_UCHAR(p)
#define IN_WORD(p) INPW(p)
#define OUT_WORD(p, v) OUTPW((p), (v))
// Our x86 C compiler was insisting on turning any expression
// arguments into word operations -- e.g., WRITE_WORD(x + xOffset)
// where both 'x' and 'xOffset' were dwords would get converted to
// a word add operation before the word was written to memory. With a
// 32-bit segment, every word operation costs us a byte in size and a
// cycle in performance.
//
// The following expression was the only one I could find that gave me
// the asm I was looking for -- the only word operation is the final
// word write to memory.
#define WRITE_WORD(address, x) \
{ \
LONG l = (LONG) x; \
WRITE_REGISTER_USHORT((address), (USHORT) (l)); \
}
#else
/////////////////////////////////////////////////////////////////////////
// Alpha and Mips
//
// The code makes extensive use of the inp, inpw, outp and outpw x86
// intrinsic functions. Since these don't exist on the Alpha platform,
// map them into something we can handle. Since the CSRs are mapped
// on Alpha, we have to add the register base to the register number
// passed in the source.
extern UCHAR* gpucCsrBase;
#define INP(p) READ_PORT_UCHAR(gpucCsrBase + (p))
#define INPW(p) READ_PORT_USHORT(gpucCsrBase + (p))
#define OUTP(p,v ) WRITE_PORT_UCHAR(gpucCsrBase + (p), (v))
#define OUTPW(p, v) WRITE_PORT_USHORT(gpucCsrBase + (p), (v))
// OUT_WORD is a quick OUT routine where we can explicitly handle
// MEMORY_BARRIERs ourselves. It is best to use OUTPW for non-critical
// code, because it's easy to overwrite the IO cache when MEMORY_BARRIERs
// aren't bracketing everything. Note that the IO_ routines provide
// the necessary abstraction so that you don't usually have to think
// about memory barriers.
#define OUT_WORD(p, v) WRITE_REGISTER_USHORT(gpucCsrBase + (p), (USHORT) (v))
#define IN_WORD(p) READ_PORT_USHORT(gpucCsrBase + (p))
#define WRITE_WORD(p, v) // Shouldn't be using this on non-x86
// We redefine 'inp', 'inpw', 'outp' and 'outpw' just in case someone
// forgets to use the capitalized versions (so that it still works on
// the Mips/Alpha):
#define inp(p) INP(p)
#define inpw(p) INPW(p)
#define outp(p, v) OUTP((p), (v))
#define outpw(p, v) OUTPW((p), (v))
#endif
#define OUT_DWORD(p, x) // 8514/a doesn't do 32bpp
#define WRITE_DWORD(p, x) // 8514/a doesn't do 32bpp
// DEPTH32(ppdev) returns TRUE if running at 32bpp, meaning that DEPTH32
// macros must be used, and returns FALSE if running at 8 or 16bpp,
// meaning that DEPTH macros must be used:
#define DEPTH32(ppdev) (FALSE)
#define MM_BKGD_COLOR32(ppdev, pjMmBase, x) // Not used
#define MM_FRGD_COLOR32(ppdev, pjMmBase, x) // Not used
#define MM_WRT_MASK32(ppdev, pjMmBase, x) // Not used
#define MM_RD_MASK32(ppdev, pjMmBase, x) // Not used
#define MM_FRGD_MIX(ppdev, pjMmBase, x) // Not used
#define MM_BKGD_MIX(ppdev, pjMmBase, x) // Not used
#if DBG
/////////////////////////////////////////////////////////////////////////
// Checked Build
//
// We hook some of the accelerator macros on checked (debug) builds
// for sanity checking.
VOID vOutAccel(ULONG, ULONG);
VOID vOutDepth(PDEV*, ULONG, ULONG);
VOID vOutDepth32(PDEV*, ULONG, ULONG);
VOID vWriteAccel(VOID*, ULONG);
VOID vWriteDepth(PDEV*, VOID*, ULONG);
VOID vWriteDepth32(PDEV*, VOID*, ULONG);
VOID vFifoWait(PDEV*, LONG);
VOID vGpWait(PDEV*);
VOID vCheckDataReady(PDEV*);
VOID vCheckDataComplete(PDEV*);
#define IN_ACCEL(p) IN_WORD(p)
#define OUT_ACCEL(p, v) vOutAccel((p), (ULONG) (v))
#define OUT_DEPTH(ppdev, p, v) vOutDepth((ppdev), (p), (ULONG) (v))
#define OUT_DEPTH32(ppdev, p, v) vOutDepth32((ppdev), (p), (ULONG) (v))
#define WRITE_ACCEL(p, v) vWriteAccel((p), (ULONG) (v))
#define WRITE_DEPTH(ppdev, p, v) vWriteDepth((ppdev), (p), (ULONG) (v))
#define WRITE_DEPTH32(ppdev, p, v) vWriteDepth32((ppdev), (p), (ULONG) (v))
#define IO_FIFO_WAIT(ppdev, level) vFifoWait((ppdev), (level))
#define IO_GP_WAIT(ppdev) vGpWait(ppdev)
#define CHECK_DATA_READY(ppdev) vCheckDataReady(ppdev)
#define CHECK_DATA_COMPLETE(ppdev) vCheckDataComplete(ppdev)
#else
/////////////////////////////////////////////////////////////////////////
// Free Build
//
// For a free (non-debug build), we make everything in-line.
#define IN_ACCEL(p) IN_WORD(p)
#define OUT_ACCEL(p, v) OUT_WORD((p), (v))
#define OUT_DEPTH(ppdev, p, x) OUT_WORD((p), (x))
#define OUT_DEPTH32(ppdev, p, x) OUT_DWORD((p), (x))
#define WRITE_ACCEL(p, v) WRITE_WORD((p), (v))
#define WRITE_DEPTH(ppdev, p, x) WRITE_WORD((p), (x))
#define WRITE_DEPTH32(ppdev, p, x) WRITE_DWORD((p), (x))
#define IO_FIFO_WAIT(ppdev, level) \
while (IO_GP_STAT(ppdev) & ((FIFO_1_EMPTY << 1) >> (level)));
#define IO_GP_WAIT(ppdev) \
while (IO_GP_STAT(ppdev) & HARDWARE_BUSY);
#define CHECK_DATA_READY(ppdev) // Expands to nothing
#define CHECK_DATA_COMPLETE(ppdev) // Expands to nothing
#endif
// IO_TEST_WAIT is a useful replacement to IO_FIFO_WAIT that can give
// some indication of how often we have to wait for the hardware to
// finish drawing in key areas:
#define IO_TEST_WAIT(ppdev, level, cTotal, cWait) \
{ \
cTotal++; \
if (IO_GP_STAT(ppdev) & ((FIFO_1_EMPTY << 1) >> (level))) \
{ \
cWait++; \
IO_FIFO_WAIT(ppdev, level); \
} \
}
////////////////////////////////////////////////////////////////////
// Port access using I/O
// The following are ABSOLUTE positioning macros. They do NOT take
// the surface's offset into account (for off-screen device-format
// bitmaps):
#define IO_ABS_CUR_Y(ppdev, y) \
OUT_ACCEL(CUR_Y, (y))
#define IO_ABS_CUR_X(ppdev, x) \
OUT_ACCEL(CUR_X, (x))
#define IO_ABS_DEST_Y(ppdev, y) \
OUT_ACCEL(DEST_Y, (y))
#define IO_ABS_DEST_X(ppdev, x) \
OUT_ACCEL(DEST_X, (x))
#define IO_ABS_SCISSORS_T(ppdev, y) \
{ \
OUT_ACCEL(SCISSORS_T, (y) | CLIP_TOP); \
}
#define IO_ABS_SCISSORS_L(ppdev, x) \
{ \
OUT_ACCEL(SCISSORS_L, (x) | CLIP_LEFT); \
}
#define IO_ABS_SCISSORS_B(ppdev, y) \
{ \
OUT_ACCEL(SCISSORS_B, (y) | CLIP_BOTTOM); \
}
#define IO_ABS_SCISSORS_R(ppdev, x) \
{ \
OUT_ACCEL(SCISSORS_R, (x) | CLIP_RIGHT);\
}
// The following are RELATIVE positioning macros. They DO take
// the surface's offset into account:
#define IO_CUR_Y(ppdev, y) \
IO_ABS_CUR_Y(ppdev, (y) + ppdev->yOffset)
#define IO_CUR_X(ppdev, x) \
IO_ABS_CUR_X(ppdev, (x) + ppdev->xOffset)
#define IO_DEST_Y(ppdev, y) \
IO_ABS_DEST_Y(ppdev, (y) + ppdev->yOffset)
#define IO_DEST_X(ppdev, x) \
IO_ABS_DEST_X(ppdev, (x) + ppdev->xOffset)
#define IO_SCISSORS_T(ppdev, y) \
IO_ABS_SCISSORS_T(ppdev, (y) + ppdev->yOffset)
#define IO_SCISSORS_L(ppdev, x) \
IO_ABS_SCISSORS_L(ppdev, (x) + ppdev->xOffset)
#define IO_SCISSORS_B(ppdev, y) \
IO_ABS_SCISSORS_B(ppdev, (y) + ppdev->yOffset)
#define IO_SCISSORS_R(ppdev, x) \
IO_ABS_SCISSORS_R(ppdev, (x) + ppdev->xOffset)
#define IO_AXSTP(ppdev, x) \
OUT_ACCEL(AXSTP, (x))
#define IO_DIASTP(ppdev, x) \
OUT_ACCEL(DIASTP, (x))
#define IO_ERR_TERM(ppdev, x) \
OUT_ACCEL(ERR_TERM, (x))
#define IO_MAJ_AXIS_PCNT(ppdev, x) \
OUT_ACCEL(MAJ_AXIS_PCNT, (x))
#define IO_GP_STAT(ppdev) \
IN_ACCEL(CMD)
// Note that we have to put memory barriers before and after the
// command output. The first memory barrier ensures that all the
// settings registers have been set before the command is executed,
// and the second ensures that no subsequent changes to the settings
// registers will mess up the current command:
#define IO_CMD(ppdev, x) \
{ \
OUT_ACCEL(CMD, (x)); \
}
#define IO_SHORT_STROKE(ppdev, x) \
OUT_ACCEL(SHORT_STROKE, (x))
#define IO_BKGD_MIX(ppdev, x) \
OUT_ACCEL(BKGD_MIX, (x))
#define IO_FRGD_MIX(ppdev, x) \
OUT_ACCEL(FRGD_MIX, (x))
#define IO_MIN_AXIS_PCNT(ppdev, x) \
{ \
OUT_ACCEL(MIN_AXIS_PCNT, (x) | RECT_HEIGHT); \
}
#define IO_PIX_CNTL(ppdev, x) \
{ \
OUT_ACCEL(PIX_CNTL, (x) | DATA_EXTENSION); \
}
#define IO_READ_SEL(ppdev, x) // Not used
#define IO_MULT_MISC(ppdev, x) // Not used
#define IO_RD_REG_DT(ppdev, x) // Not used
#define IO_PIX_TRANS(ppdev, x) \
{ \
/* Can't use OUT_ACCEL: */ \
OUT_WORD(PIX_TRANS, (x)); \
}
// Macros for outputing colour-depth dependent values at 8bpp and 16bpp:
#define IO_BKGD_COLOR(ppdev, x) \
OUT_DEPTH(ppdev, BKGD_COLOR, (x))
#define IO_FRGD_COLOR(ppdev, x) \
OUT_DEPTH(ppdev, FRGD_COLOR, (x))
#define IO_WRT_MASK(ppdev, x) \
OUT_DEPTH(ppdev, WRT_MASK, (x))
#define IO_RD_MASK(ppdev, x) \
OUT_DEPTH(ppdev, RD_MASK, (x))
////////////////////////////////////////////////////////////////////
// Thunk this!
#define WAIT_FOR_DATA_AVAILABLE(ppdev) \
{ \
while (!(IO_GP_STAT(ppdev) & READ_DATA_AVAILABLE)) \
; \
}
#define IO_PIX_TRANS_IN(ppdev, x) \
{ \
(WORD) x = IN_ACCEL(PIX_TRANS); \
}
#define IO_PIX_TRANS_OUT(ppdev, x) \
{ \
/* Can't use OUT_ACCEL: */ \
OUT_WORD(PIX_TRANS, (x)); \
}
///////////////////////////////////////////////////////////////////
// ATI extensions
///////////////////////////////////////////////////////////////////
#define FG_COLOR_SRC 0xE000
#define SHIFT_FG_COLOR_SRC 0x000D
#define DATA_ORDER 0x1000
#define DATA_WIDTH 0x0200
#define BG_COLOR_SRC 0x0180
#define SHIFT_BG_COLOR_SRC 0x0007
#define EXT_MONO_SRC 0x0060
#define SHIFT_EXT_MONO_SRC 0x0005
#define DRAW 0x0010
#define READ_MODE 0x0004
#define POLY_FILL_MODE 0x0002
#define SRC_SWAP 0x0800
#define FG_COLOR_SRC_BG 0x0000
#define FG_COLOR_SRC_FG 0x2000
#define FG_COLOR_SRC_HOST 0x4000
#define FG_COLOR_SRC_BLIT 0x6000
#define FG_COLOR_SRC_GS 0x8000
#define FG_COLOR_SRC_PATT 0xA000
#define FG_COLOR_SRC_CLUH 0xC000
#define FG_COLOR_SRC_CLUB 0xE000
#define BG_COLOR_SRC_BG 0x0000
#define BG_COLOR_SRC_FG 0x0080
#define BG_COLOR_SRC_HOST 0x0100
#define BG_COLOR_SRC_BLIT 0x0180
#define EXT_MONO_SRC_ONE 0x0000
#define EXT_MONO_SRC_PATT 0x0020
#define EXT_MONO_SRC_HOST 0x0040
#define EXT_MONO_SRC_BLIT 0x0060
#define ONE_WORD 0x8000
#define TWO_WORDS 0xC000
#define THREE_WORDS 0xE000
#define FOUR_WORDS 0xF000
#define FIVE_WORDS 0xF800
#define SIX_WORDS 0xFC00
#define SEVEN_WORDS 0xFE00
#define EIGHT_WORDS 0xFF00
#define NINE_WORDS 0xFF80
#define TEN_WORDS 0xFFC0
#define ELEVEN_WORDS 0xFFE0
#define TWELVE_WORDS 0xFFF0
#define THIRTEEN_WORDS 0xFFF8
#define FOURTEEN_WORDS 0xFFFC
#define FIFTEEN_WORDS 0xFFFE
#define SIXTEEN_WORDS 0xFFFF
#define SRC_Y 0x8AE8
#define SRC_X 0x8EE8
#define EXT_FIFO_STATUS 0x9AEE
#define DEST_X_START 0xA6EE
#define DEST_X_END 0xAAEE
#define DEST_Y_END 0xAEEE
#define SRC_X_START 0xB2EE
#define ALU_BG_FN 0xB6EE
#define ALU_FG_FN 0xBAEE
#define SRC_X_END 0xBEEE
#define SRC_Y_DIR 0xC2EE
#define R_V_TOTAL 0xC2EE
#define EXT_SSV 0xC6EE
#define EXT_SHORT_STROKE 0xC6EE
#define R_V_DISP 0xC6EE
#define SCAN_X 0xCAEE
#define R_V_SYNC_STRT 0xCAEE
#define DP_CONFIG 0xCEEE
#define VERT_LINE_CNTR 0xCEEE
#define PATT_LENGTH 0xD2EE
#define R_V_SYNC_WID 0xD2EE
#define PATT_INDEX 0xD6EE
#define EXT_SCISSOR_L 0xDAEE
#define R_SRC_X 0xDAEE
#define EXT_SCISSOR_T 0xDEEE
#define R_SRC_Y 0xDEEE
#define PIX_TRANS 0xE2E8
#define EXT_SCISSOR_R 0xE2EE
#define EXT_SCISSOR_B 0xE6EE
#define SRC_CMP_COLOR 0xEAEE
#define DEST_CMP_FN 0xEEEE
#define LINEDRAW 0xFEEE
#define TOP_TO_BOTTOM 0x01
#define BOTTOM_TO_TOP 0x00