wsdisplayvar.h revision 1.3
1/* $OpenBSD: wsdisplayvar.h,v 1.3 2000/11/15 20:00:39 aaron Exp $ */
2/* $NetBSD: wsdisplayvar.h,v 1.14.4.1 2000/06/30 16:27:53 simonb Exp $ */
3
4/*
5 * Copyright (c) 1996, 1997 Christopher G. Demetriou.  All rights reserved.
6 *
7 * Redistribution and use in source and binary forms, with or without
8 * modification, are permitted provided that the following conditions
9 * are met:
10 * 1. Redistributions of source code must retain the above copyright
11 *    notice, this list of conditions and the following disclaimer.
12 * 2. Redistributions in binary form must reproduce the above copyright
13 *    notice, this list of conditions and the following disclaimer in the
14 *    documentation and/or other materials provided with the distribution.
15 * 3. All advertising materials mentioning features or use of this software
16 *    must display the following acknowledgement:
17 *      This product includes software developed by Christopher G. Demetriou
18 *	for the NetBSD Project.
19 * 4. The name of the author may not be used to endorse or promote products
20 *    derived from this software without specific prior written permission
21 *
22 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
23 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
24 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
25 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
26 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
27 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
28 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
29 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
30 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
31 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
32 */
33
34struct device;
35
36/*
37 * WSDISPLAY interfaces
38 */
39
40/*
41 * Emulation functions, for displays that can support glass-tty terminal
42 * emulations.  These are character oriented, with row and column
43 * numbers starting at zero in the upper left hand corner of the
44 * screen.
45 *
46 * These are used only when emulating a terminal.  Therefore, displays
47 * drivers which cannot emulate terminals do not have to provide them.
48 *
49 * There is a "void *" cookie provided by the display driver associated
50 * with these functions, which is passed to them when they are invoked.
51 */
52struct wsdisplay_emulops {
53	void	(*cursor) __P((void *c, int on, int row, int col));
54	int	(*mapchar) __P((void *, int, unsigned int *));
55	void	(*putchar) __P((void *c, int row, int col,
56				u_int uc, long attr));
57	void	(*copycols) __P((void *c, int row, int srccol, int dstcol,
58		    int ncols));
59	void	(*erasecols) __P((void *c, int row, int startcol,
60		    int ncols, long));
61	void	(*copyrows) __P((void *c, int srcrow, int dstrow,
62		    int nrows));
63	void	(*eraserows) __P((void *c, int row, int nrows, long));
64	int	(*alloc_attr) __P((void *c, int fg, int bg, int flags, long *));
65/* fg / bg values. Made identical to ANSI terminal color codes. */
66#define WSCOL_BLACK	0
67#define WSCOL_RED	1
68#define WSCOL_GREEN	2
69#define WSCOL_BROWN	3
70#define WSCOL_BLUE	4
71#define WSCOL_MAGENTA	5
72#define WSCOL_CYAN	6
73#define WSCOL_WHITE	7
74/* flag values: */
75#define WSATTR_REVERSE	1
76#define WSATTR_HILIT	2
77#define WSATTR_BLINK	4
78#define WSATTR_UNDERLINE 8
79#define WSATTR_WSCOLORS 16
80	/* XXX need a free_attr() ??? */
81};
82
83struct wsscreen_descr {
84	char *name;
85	int ncols, nrows;
86	const struct wsdisplay_emulops *textops;
87	int fontwidth, fontheight;
88	int capabilities;
89#define WSSCREEN_WSCOLORS	1	/* minimal color capability */
90#define WSSCREEN_REVERSE	2	/* can display reversed */
91#define WSSCREEN_HILIT		4	/* can highlight (however) */
92#define WSSCREEN_BLINK		8	/* can blink */
93#define WSSCREEN_UNDERLINE	16	/* can underline */
94};
95
96struct wsdisplay_font;
97/*
98 * Display access functions, invoked by user-land programs which require
99 * direct device access, such as X11.
100 *
101 * There is a "void *" cookie provided by the display driver associated
102 * with these functions, which is passed to them when they are invoked.
103 */
104struct wsdisplay_accessops {
105	int	(*ioctl) __P((void *v, u_long cmd, caddr_t data, int flag,
106		    struct proc *p));
107	int	(*mmap) __P((void *v, off_t off, int prot));
108	int	(*alloc_screen) __P((void *, const struct wsscreen_descr *,
109				     void **, int *, int *, long *));
110	void	(*free_screen) __P((void *, void *));
111	int	(*show_screen) __P((void *, void *, int,
112				    void (*) (void *, int, int), void *));
113	int	(*load_font) __P((void *, void *, struct wsdisplay_font *));
114	void	(*scrollback) __P((void *, void *, int));
115};
116
117/*
118 * Attachment information provided by wsdisplaydev devices when attaching
119 * wsdisplay units.
120 */
121struct wsdisplaydev_attach_args {
122	const struct wsdisplay_accessops *accessops;	/* access ops */
123	void	*accesscookie;				/* access cookie */
124};
125
126/* passed to wscons by the video driver to tell about its capabilities */
127struct wsscreen_list {
128	int nscreens;
129	const struct wsscreen_descr **screens;
130};
131
132/*
133 * Attachment information provided by wsemuldisplaydev devices when attaching
134 * wsdisplay units.
135 */
136struct wsemuldisplaydev_attach_args {
137	int	console;				/* is it console? */
138	const struct wsscreen_list *scrdata;		/* screen cfg info */
139	const struct wsdisplay_accessops *accessops;	/* access ops */
140	void	*accesscookie;				/* access cookie */
141};
142
143#define	WSEMULDISPLAYDEVCF_CONSOLE	0
144#define	wsemuldisplaydevcf_console	cf_loc[WSEMULDISPLAYDEVCF_CONSOLE]	/* spec'd as console? */
145#define	WSEMULDISPLAYDEVCF_CONSOLE_UNK	-1
146
147struct wscons_syncops {
148	int (*detach) __P((void *, int, void (*)(void *, int, int), void *));
149	int (*attach) __P((void *, int, void (*)(void *, int, int), void *));
150	int (*check) __P((void *));
151	void (*destroy) __P((void *));
152};
153
154/*
155 * Autoconfiguration helper functions.
156 */
157void	wsdisplay_cnattach __P((const struct wsscreen_descr *, void *,
158				int, int, long));
159int	wsdisplaydevprint __P((void *, const char *));
160int	wsemuldisplaydevprint __P((void *, const char *));
161
162/*
163 * Console interface.
164 */
165void	wsdisplay_cnputc __P((dev_t dev, int i));
166
167/*
168 * for use by compatibility code
169 */
170struct wsdisplay_softc;
171struct wsscreen;
172int wsscreen_attach_sync __P((struct wsscreen *,
173			      const struct wscons_syncops *, void *));
174int wsscreen_detach_sync __P((struct wsscreen *));
175int wsscreen_lookup_sync __P((struct wsscreen *,
176			      const struct wscons_syncops *, void **));
177
178int wsdisplay_maxscreenidx __P((struct wsdisplay_softc *));
179int wsdisplay_screenstate __P((struct wsdisplay_softc *, int));
180int wsdisplay_getactivescreen __P((struct wsdisplay_softc *));
181int wsscreen_switchwait __P((struct wsdisplay_softc *, int));
182
183int wsdisplay_internal_ioctl __P((struct wsdisplay_softc *sc,
184				  struct wsscreen *,
185				  u_long cmd, caddr_t data,
186				  int flag, struct proc *p));
187
188int wsdisplay_usl_ioctl1 __P((struct wsdisplay_softc *,
189			     u_long, caddr_t, int, struct proc *));
190
191int wsdisplay_usl_ioctl2 __P((struct wsdisplay_softc *, struct wsscreen *,
192			     u_long, caddr_t, int, struct proc *));
193
194int wsdisplay_cfg_ioctl __P((struct wsdisplay_softc *sc,
195			     u_long cmd, caddr_t data,
196			     int flag, struct proc *p));
197
198/*
199 * for general use
200 */
201void wsdisplay_switchtoconsole __P((void));
202
203/*
204 * for use by wskbd
205 */
206void wsscrollback __P((void *, int op));
207
208#define WSCONS_SCROLL_BACKWARD	0
209#define WSCONS_SCROLL_FORWARD	1
210