1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
|
/* $OpenBSD: cgtworeg.h,v 1.4 2011/10/24 18:32:47 miod Exp $ */
/* $NetBSD: cgtworeg.h,v 1.3 1995/10/04 00:21:27 pk Exp $ */
/*
* Copyright (c) 1994 Dennis Ferguson
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
* 1. Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
* 2. Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in the
* documentation and/or other materials provided with the distribution.
*
* THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
* IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
* IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
* NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
* DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
* THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
* THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
*/
/* cgtworeg.h - CG2 colour frame buffer definitions
*
* The mapped memory looks like:
*
* offset contents
* 0x000000 bit plane map - 1st (of 8) plane used by the X server in -mono mode
* 0x100000 pixel map - used by the X server in color mode
* 0x200000 raster op mode memory map - unused by X server
* 0x300000 random control registers (lots of spaces in between)
* 0x310000 shadow colour map
*/
/* Frame buffer memory size and depth */
#define CG2_FBSIZE (1024 * 1024)
#define CG2_N_PLANE 8
/* Screen dimensions */
#define CG2_WIDTH 1152
#define CG2_HEIGHT 900
/* Colourmap size */
#define CG2_CMSIZE 256
#define CG2_BITPLANE_OFF 0
#define CG2_BITPLANE_SIZE 0x100000
#define CG2_PIXMAP_OFF (CG2_BITPLANE_OFF + CG2_BITPLANE_SIZE)
#define CG2_PIXMAP_SIZE 0x100000
#define CG2_ROPMEM_OFF (CG2_PIXMAP_OFF + CG2_PIXMAP_SIZE)
#define CG2_ROPMEM_SIZE 0x100000
#define CG2_CTLREG_OFF (CG2_ROPMEM_OFF + CG2_ROPMEM_SIZE)
#define CG2_CTLREG_SIZE 0x010600
#define CG2_MAPPED_SIZE (CG2_CTLREG_OFF + CG2_CTLREG_SIZE)
/* arrangement of bit plane mode memory */
union bitplane {
u_short word[CG2_HEIGHT][CG2_WIDTH/(CG2_N_PLANE * sizeof(u_short))];
u_short plane[CG2_FBSIZE/(CG2_N_PLANE * sizeof(u_short))];
};
/* arrangement of pixel mode memory */
union byteplane {
u_char pixel[CG2_HEIGHT][CG2_WIDTH];
u_char frame[CG2_FBSIZE];
};
/*
* Structure describing the first two megabytes of the frame buffer.
* Normal memory maps in bit plane and pixel modes
*/
struct cg2memfb {
union bitplane memplane[CG2_N_PLANE]; /* bit plane map */
union byteplane pixplane; /* pixel map */
};
/*
* Control/status register. The X server only appears to use update_cmap
* and video_enab.
*/
struct cg2statusreg {
uint16_t reserved:2; /* not used */
uint16_t fastread:1; /* r/o: has some feature I don't understand */
uint16_t id:1; /* r/o: ext status and ID registers exist */
uint16_t resolution:4; /* screen resolution, 0 means 1152x900 */
uint16_t retrace:1; /* r/o: retrace in progress */
uint16_t inpend:1; /* r/o: interrupt request */
uint16_t ropmode:3; /* ?? */
uint16_t inten:1; /* interrupt enable (for end of retrace) */
uint16_t update_cmap:1; /* copy/use shadow colour map */
uint16_t video_enab:1; /* enable video */
};
/*
* Extended status register. Unused by X server
*/
struct cg2_extstatus {
uint16_t gpintreq:1; /* interrupt request */
uint16_t gpintdis:1; /* interrupt disable */
uint16_t reserved:13; /* unused */
uint16_t gpbus:1; /* bus enabled */
};
/*
* Double buffer control register. It appears that (some of?) the
* cg2 cards support a pair of memory sets, referred to as `A' and
* `B', which can be swapped to allow atomic screen updates. This
* controls them.
*/
struct dblbufreg {
uint16_t display_b:1; /* display memory B (set) or A (reset) */
uint16_t read_b:1; /* access memory B (set) or A (reset) */
uint16_t nowrite_b:1; /* when set, writes don't update memory B */
uint16_t nowrite_a:1; /* when set, writes don't update memory A */
uint16_t read_ecmap:1; /* copy from(clear)/to(set) shadow colour map */
uint16_t fast_read:1; /* fast reads, but wrong data */
uint16_t wait:1; /* when set, remains so to end up v. retrace */
uint16_t update_ecmap:1; /* copy/use shadow colour map */
uint16_t reserved:8;
};
/*
* Zoom register, apparently present on Sun-2 colour boards only. See
* the Sun documentation, I don't know anyone who still has a Sun-2.
*/
struct cg2_zoom {
union {
u_short reg;
u_char reg_pad[4096];
} wordpan;
union {
struct {
uint16_t unused:8;
uint16_t lineoff:4;
uint16_t pixzoom:4;
} reg;
u_short word;
u_char reg_pad[4096];
} zoom;
union {
struct {
uint16_t unused:8;
uint16_t lorigin:4;
uint16_t pixeloff:4;
} reg;
u_short word;
u_char reg_pad[4096];
} pixpan;
union {
u_short reg;
u_char reg_pad[4096];
} varzoom;
};
/*
* Miscellany. On the Sun-3 these registers exist in place of the above.
*/
struct cg2_nozoom {
union { /* double buffer register (see above) */
struct dblbufreg reg;
u_short word;
u_char reg_pad[4096];
} dblbuf;
union { /* start of dma window */
u_short reg;
u_char reg_pad[4096];
} dmabase;
union { /* dma window size */
u_short reg; /* actually 8 bits. reg*16 == size */
u_char reg_pad[4096];
} dmawidth;
union { /* frame count */
u_short reg; /* actually 8 bits only. r/o */
u_char reg_pad[4096];
} framecnt;
};
/*
* Raster op control registers. X doesn't use this, but documented here
* for future reference.
*/
struct memropc {
u_short mrc_dest;
u_short mrc_source1;
u_short mrc_source2;
u_short mrc_pattern;
u_short mrc_mask1;
u_short mrc_mask2;
u_short mrc_shift;
u_short mrc_op;
u_short mrc_width;
u_short mrc_opcount;
u_short mrc_decoderout;
u_short mrc_x11;
u_short mrc_x12;
u_short mrc_x13;
u_short mrc_x14;
u_short mrc_x15;
};
/*
* Last chunk of the frame buffer (i.e. from offset 0x200000 and above).
* Exists separately from struct cg2memfb apparently because Sun software
* avoids mapping the latter, though X uses it.
*/
struct cg2fb {
union { /* raster op mode frame memory */
union bitplane ropplane[CG2_N_PLANE];
union byteplane roppixel;
} ropio;
union { /* raster op control unit (1 per plane) */
struct memropc ropregs;
struct {
u_char pad[2048];
struct memropc ropregs;
} prime;
u_char reg_pad[4096];
} ropcontrol[9];
union { /* status register */
struct cg2statusreg reg;
u_short word;
u_char reg_pad[4096];
} status;
union { /* per-plane mask register */
u_short reg; /* 8 bit mask register - set means plane r/w */
u_char reg_pad[4096];
} ppmask;
union { /* miscellaneous registers */
struct cg2_zoom zoom;
struct cg2_nozoom nozoom;
} misc;
union { /* interrupt vector */
u_short reg;
u_char reg_pad[32];
} intrptvec;
union { /* board ID */
u_short reg;
u_char reg_pad[16];
} id;
union { /* extended status */
struct cg2_extstatus reg;
u_short word;
u_char reg_pad[16];
} extstatus;
union { /* auxiliary raster op mode register (?)*/
u_short reg;
u_char reg_pad[4032];
} ropmode;
u_short redmap[CG2_CMSIZE]; /* shadow colour maps */
u_short greenmap[CG2_CMSIZE];
u_short bluemap[CG2_CMSIZE];
};
|
