Home | History | Annotate | Line # | Download | only in wscons
      1 /* $NetBSD: wsdisplayvar.h,v 1.57 2023/03/01 08:42:33 riastradh Exp $ */
      2 
      3 /*
      4  * Copyright (c) 1996, 1997 Christopher G. Demetriou.  All rights reserved.
      5  *
      6  * Redistribution and use in source and binary forms, with or without
      7  * modification, are permitted provided that the following conditions
      8  * are met:
      9  * 1. Redistributions of source code must retain the above copyright
     10  *    notice, this list of conditions and the following disclaimer.
     11  * 2. Redistributions in binary form must reproduce the above copyright
     12  *    notice, this list of conditions and the following disclaimer in the
     13  *    documentation and/or other materials provided with the distribution.
     14  * 3. All advertising materials mentioning features or use of this software
     15  *    must display the following acknowledgement:
     16  *      This product includes software developed by Christopher G. Demetriou
     17  *	for the NetBSD Project.
     18  * 4. The name of the author may not be used to endorse or promote products
     19  *    derived from this software without specific prior written permission
     20  *
     21  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
     22  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
     23  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
     24  * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
     25  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
     26  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
     27  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
     28  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
     29  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
     30  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
     31  */
     32 
     33 #ifndef _DEV_WSCONS_WSDISPLAYVAR_H
     34 #define _DEV_WSCONS_WSDISPLAYVAR_H
     35 
     36 #include <sys/device.h>
     37 
     38 /*
     39  * WSDISPLAY interfaces
     40  */
     41 
     42 /*
     43  * Emulation functions, for displays that can support glass-tty terminal
     44  * emulations.  These are character oriented, with row and column
     45  * numbers starting at zero in the upper left hand corner of the
     46  * screen.
     47  *
     48  * These are used only when emulating a terminal.  Therefore, displays
     49  * drivers which cannot emulate terminals do not have to provide them.
     50  *
     51  * There is a "void *" cookie provided by the display driver associated
     52  * with these functions, which is passed to them when they are invoked.
     53  */
     54 struct wsdisplay_emulops {
     55 	void	(*cursor)(void *, int, int, int);
     56 	int	(*mapchar)(void *, int, unsigned int *);
     57 	void	(*putchar)(void *, int, int, u_int, long);
     58 	void	(*copycols)(void *, int, int, int, int);
     59 	void	(*erasecols)(void *, int, int, int, long);
     60 	void	(*copyrows)(void *, int, int, int);
     61 	void	(*eraserows)(void *, int, int, long);
     62 	int	(*allocattr)(void *, int, int, int, long *);
     63 /* fg / bg values. Made identical to ANSI terminal color codes. */
     64 #define WSCOL_BLACK	0
     65 #define WSCOL_RED	1
     66 #define WSCOL_GREEN	2
     67 #define WSCOL_BROWN	3
     68 #define WSCOL_BLUE	4
     69 #define WSCOL_MAGENTA	5
     70 #define WSCOL_CYAN	6
     71 #define WSCOL_WHITE	7
     72 #define WSCOL_LIGHT_GREY	(WSCOL_BLACK+8)
     73 #define WSCOL_LIGHT_RED		(WSCOL_RED+8)
     74 #define WSCOL_LIGHT_GREEN	(WSCOL_GREEN+8)
     75 #define WSCOL_LIGHT_BROWN	(WSCOL_BROWN+8)
     76 #define WSCOL_LIGHT_BLUE	(WSCOL_BLUE+8)
     77 #define WSCOL_LIGHT_MAGENTA	(WSCOL_MAGENTA+8)
     78 #define WSCOL_LIGHT_CYAN	(WSCOL_CYAN+8)
     79 #define WSCOL_LIGHT_WHITE	(WSCOL_WHITE+8)
     80 /* flag values: */
     81 #define WSATTR_REVERSE	1
     82 #define WSATTR_HILIT	2
     83 #define WSATTR_BLINK	4
     84 #define WSATTR_UNDERLINE 8
     85 #define WSATTR_WSCOLORS 16
     86 #define WSATTR_USERMASK 0x0fff
     87 /* private flags used by the driver */
     88 #define WSATTR_PRIVATE1  4096
     89 #define WSATTR_PRIVATE2  8192
     90 #define WSATTR_PRIVATE3 16384
     91 #define WSATTR_PRIVATE4 32768
     92 	/* XXX need a free_attr() ??? */
     93 	void	(*replaceattr)(void *, long, long);
     94 };
     95 
     96 struct wsscreen_descr {
     97 	const char *name;
     98 	int ncols, nrows;
     99 	const struct wsdisplay_emulops *textops;
    100 	int fontwidth, fontheight;
    101 	int capabilities;
    102 #define WSSCREEN_WSCOLORS	1	/* minimal color capability */
    103 #define WSSCREEN_REVERSE	2	/* can display reversed */
    104 #define WSSCREEN_HILIT		4	/* can highlight (however) */
    105 #define WSSCREEN_BLINK		8	/* can blink */
    106 #define WSSCREEN_UNDERLINE	16	/* can underline */
    107 #define WSSCREEN_RESIZE		32	/* can resize */
    108 #define WSSCREEN_FREE		64	/* free() this struct when deleting
    109 					 * internal only, do not set */
    110 	void *modecookie;
    111 };
    112 
    113 struct wsdisplay_font;
    114 struct wsdisplay_char;
    115 /*
    116  * Display access functions, invoked by user-land programs which require
    117  * direct device access, such as X11.
    118  *
    119  * There is a "void *" cookie provided by the display driver associated
    120  * with these functions, which is passed to them when they are invoked.
    121  */
    122 struct wsdisplay_accessops {
    123 	int	(*ioctl)(void *, void *, u_long, void *, int, struct lwp *);
    124 	paddr_t	(*mmap)(void *, void *, off_t, int);
    125 	int	(*alloc_screen)(void *, const struct wsscreen_descr *,
    126 				void **, int *, int *, long *);
    127 	void	(*free_screen)(void *, void *);
    128 	int	(*show_screen)(void *, void *, int,
    129 			       void (*)(void *, int, int), void *);
    130 	int	(*load_font)(void *, void *, struct wsdisplay_font *);
    131 	void	(*pollc)(void *, int);
    132 	void	(*scroll)(void *, void *, int);
    133 };
    134 
    135 /*
    136  * Attachment information provided by wsdisplaydev devices when attaching
    137  * wsdisplay units.
    138  */
    139 struct wsdisplaydev_attach_args {
    140 	const struct wsdisplay_accessops *accessops;	/* access ops */
    141 	void	*accesscookie;				/* access cookie */
    142 };
    143 
    144 /* passed to wscons by the video driver to tell about its capabilities */
    145 struct wsscreen_list {
    146 	int nscreens;
    147 	const struct wsscreen_descr **screens;
    148 };
    149 
    150 /*
    151  * Attachment information provided by wsemuldisplaydev devices when attaching
    152  * wsdisplay units.
    153  */
    154 struct wsemuldisplaydev_attach_args {
    155 	int	console;				/* is it console? */
    156 	const struct wsscreen_list *scrdata;		/* screen cfg info */
    157 	const struct wsdisplay_accessops *accessops;	/* access ops */
    158 	void	*accesscookie;				/* access cookie */
    159 };
    160 
    161 struct wscons_syncops {
    162 	int (*detach)(void *, int, void (*)(void *, int, int), void *);
    163 	int (*attach)(void *, int, void (*)(void *, int, int), void *);
    164 	int (*check)(void *);
    165 	void (*destroy)(void *);
    166 };
    167 
    168 /*
    169  * Autoconfiguration helper functions.
    170  */
    171 void	wsdisplay_cnattach(const struct wsscreen_descr *, void *, int, int,
    172             long);
    173 void	wsdisplay_preattach(const struct wsscreen_descr *, void *, int, int,
    174             long);
    175 void	wsdisplay_predetach(void);
    176 void	wsdisplay_cndetach(void);
    177 void	wsdisplay_multicons_suspend(bool);
    178 
    179 int	wsdisplaydevprint(void *, const char *);
    180 int	wsemuldisplaydevprint(void *, const char *);
    181 
    182 int	wsdisplay_handlex(int);
    183 
    184 /*
    185  * Console interface.
    186  */
    187 void	wsdisplay_cnputc(dev_t, int);
    188 
    189 /*
    190  * for use by compatibility code
    191  */
    192 struct wsdisplay_softc;
    193 struct wsscreen;
    194 int wsscreen_attach_sync(struct wsscreen *,
    195 			 const struct wscons_syncops *, void *);
    196 int wsscreen_detach_sync(struct wsscreen *);
    197 int wsscreen_lookup_sync(struct wsscreen *,
    198 			 const struct wscons_syncops *, void **);
    199 
    200 int wsdisplay_maxscreenidx(struct wsdisplay_softc *);
    201 int wsdisplay_screenstate(struct wsdisplay_softc *, int);
    202 int wsdisplay_getactivescreen(struct wsdisplay_softc *);
    203 int wsscreen_switchwait(struct wsdisplay_softc *, int);
    204 
    205 int wsdisplay_internal_ioctl(struct wsdisplay_softc *, struct wsscreen *,
    206 			     u_long, void *, int, struct lwp *);
    207 
    208 int wsdisplay_usl_ioctl1(device_t, u_long, void *, int, struct lwp *);
    209 
    210 int wsdisplay_usl_ioctl2(struct wsdisplay_softc *, struct wsscreen *,
    211 			 u_long, void *, int, struct lwp *);
    212 
    213 int wsdisplay_stat_ioctl(struct wsdisplay_softc *, u_long, void *,
    214 			 int, struct lwp *);
    215 
    216 int wsdisplay_cfg_ioctl(struct wsdisplay_softc *, u_long, void *,
    217 			int, struct lwp *);
    218 
    219 bool wsdisplay_isconsole(struct wsdisplay_softc *);
    220 
    221 struct wsdisplayio_edid_info;
    222 int wsdisplayio_get_edid(device_t, struct wsdisplayio_edid_info *);
    223 
    224 struct wsdisplayio_fbinfo;
    225 struct rasops_info;
    226 int wsdisplayio_get_fbinfo(struct rasops_info *, struct wsdisplayio_fbinfo *);
    227 
    228 #ifdef WSDISPLAY_SCROLLSUPPORT
    229 void wsdisplay_scroll(void *, int);
    230 #endif
    231 
    232 #define WSDISPLAY_SCROLL_BACKWARD	1
    233 #define WSDISPLAY_SCROLL_FORWARD	(1 << 1)
    234 #define WSDISPLAY_SCROLL_RESET		(1 << 2)
    235 #define WSDISPLAY_SCROLL_LOW		(1 << 3)
    236 
    237 int wsdisplay_stat_inject(device_t, u_int, int);
    238 
    239 /*
    240  * for general use
    241  */
    242 #define WSDISPLAY_NULLSCREEN	-1
    243 const struct wsscreen_descr *wsdisplay_screentype_pick(
    244     const struct wsscreen_list *, const char *);
    245 
    246 #if defined(_KERNEL)
    247 #  if defined(_KERNEL_OPT)
    248 #    include "opt_wsmsgattrs.h"
    249 #  endif
    250 #  if !defined(WS_DEFAULT_FG)
    251 #    define WS_DEFAULT_FG WSCOL_WHITE
    252 #  endif
    253 #  if !defined(WS_DEFAULT_BG)
    254 #    define WS_DEFAULT_BG WSCOL_BLACK
    255 #  endif
    256 #  if !defined(WS_DEFAULT_COLATTR)
    257 #    define WS_DEFAULT_COLATTR 0
    258 #  endif
    259 #  if !defined(WS_DEFAULT_MONOATTR)
    260 #    define WS_DEFAULT_MONOATTR 0
    261 #  endif
    262 #  if defined(WS_KERNEL_FG) || defined(WS_KERNEL_BG) || \
    263       defined(WS_KERNEL_COLATTR) || defined(WS_KERNEL_MONOATTR)
    264 #    define WS_KERNEL_CUSTOMIZED
    265 #  else
    266 #    undef WS_KERNEL_CUSTOMIZED
    267 #  endif
    268 #  if !defined(WS_KERNEL_FG)
    269 #    define WS_KERNEL_FG WS_DEFAULT_FG
    270 #  endif
    271 #  if !defined(WS_KERNEL_BG)
    272 #    define WS_KERNEL_BG WS_DEFAULT_BG
    273 #  endif
    274 #  if !defined(WS_KERNEL_COLATTR)
    275 #    define WS_KERNEL_COLATTR WS_DEFAULT_COLATTR
    276 #  endif
    277 #  if !defined(WS_KERNEL_MONOATTR)
    278 #    define WS_KERNEL_MONOATTR WS_DEFAULT_MONOATTR
    279 #  endif
    280 #  if !defined(WSDISPLAY_BORDER_COLOR)
    281 #    define WSDISPLAY_BORDER_COLOR WS_DEFAULT_BG
    282 #  endif
    283 #endif /* _KERNEL */
    284 
    285 #endif /* !_DEV_WSCONS_WSDISPLAYVAR_H */
    286