1 /* $NetBSD: wsdisplayvar.h,v 1.58 2025/11/02 22:16:24 nia 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 #define WSSCREEN_256COL 128 111 void *modecookie; 112 }; 113 114 struct wsdisplay_font; 115 struct wsdisplay_char; 116 /* 117 * Display access functions, invoked by user-land programs which require 118 * direct device access, such as X11. 119 * 120 * There is a "void *" cookie provided by the display driver associated 121 * with these functions, which is passed to them when they are invoked. 122 */ 123 struct wsdisplay_accessops { 124 int (*ioctl)(void *, void *, u_long, void *, int, struct lwp *); 125 paddr_t (*mmap)(void *, void *, off_t, int); 126 int (*alloc_screen)(void *, const struct wsscreen_descr *, 127 void **, int *, int *, long *); 128 void (*free_screen)(void *, void *); 129 int (*show_screen)(void *, void *, int, 130 void (*)(void *, int, int), void *); 131 int (*load_font)(void *, void *, struct wsdisplay_font *); 132 void (*pollc)(void *, int); 133 void (*scroll)(void *, void *, int); 134 }; 135 136 /* 137 * Attachment information provided by wsdisplaydev devices when attaching 138 * wsdisplay units. 139 */ 140 struct wsdisplaydev_attach_args { 141 const struct wsdisplay_accessops *accessops; /* access ops */ 142 void *accesscookie; /* access cookie */ 143 }; 144 145 /* passed to wscons by the video driver to tell about its capabilities */ 146 struct wsscreen_list { 147 int nscreens; 148 const struct wsscreen_descr **screens; 149 }; 150 151 /* 152 * Attachment information provided by wsemuldisplaydev devices when attaching 153 * wsdisplay units. 154 */ 155 struct wsemuldisplaydev_attach_args { 156 int console; /* is it console? */ 157 const struct wsscreen_list *scrdata; /* screen cfg info */ 158 const struct wsdisplay_accessops *accessops; /* access ops */ 159 void *accesscookie; /* access cookie */ 160 }; 161 162 struct wscons_syncops { 163 int (*detach)(void *, int, void (*)(void *, int, int), void *); 164 int (*attach)(void *, int, void (*)(void *, int, int), void *); 165 int (*check)(void *); 166 void (*destroy)(void *); 167 }; 168 169 /* 170 * Autoconfiguration helper functions. 171 */ 172 void wsdisplay_cnattach(const struct wsscreen_descr *, void *, int, int, 173 long); 174 void wsdisplay_preattach(const struct wsscreen_descr *, void *, int, int, 175 long); 176 void wsdisplay_predetach(void); 177 void wsdisplay_cndetach(void); 178 void wsdisplay_multicons_suspend(bool); 179 180 int wsdisplaydevprint(void *, const char *); 181 int wsemuldisplaydevprint(void *, const char *); 182 183 int wsdisplay_handlex(int); 184 185 /* 186 * Console interface. 187 */ 188 void wsdisplay_cnputc(dev_t, int); 189 190 /* 191 * for use by compatibility code 192 */ 193 struct wsdisplay_softc; 194 struct wsscreen; 195 int wsscreen_attach_sync(struct wsscreen *, 196 const struct wscons_syncops *, void *); 197 int wsscreen_detach_sync(struct wsscreen *); 198 int wsscreen_lookup_sync(struct wsscreen *, 199 const struct wscons_syncops *, void **); 200 201 int wsdisplay_maxscreenidx(struct wsdisplay_softc *); 202 int wsdisplay_screenstate(struct wsdisplay_softc *, int); 203 int wsdisplay_getactivescreen(struct wsdisplay_softc *); 204 int wsscreen_switchwait(struct wsdisplay_softc *, int); 205 206 int wsdisplay_internal_ioctl(struct wsdisplay_softc *, struct wsscreen *, 207 u_long, void *, int, struct lwp *); 208 209 int wsdisplay_usl_ioctl1(device_t, u_long, void *, int, struct lwp *); 210 211 int wsdisplay_usl_ioctl2(struct wsdisplay_softc *, struct wsscreen *, 212 u_long, void *, int, struct lwp *); 213 214 int wsdisplay_stat_ioctl(struct wsdisplay_softc *, u_long, void *, 215 int, struct lwp *); 216 217 int wsdisplay_cfg_ioctl(struct wsdisplay_softc *, u_long, void *, 218 int, struct lwp *); 219 220 bool wsdisplay_isconsole(struct wsdisplay_softc *); 221 222 struct wsdisplayio_edid_info; 223 int wsdisplayio_get_edid(device_t, struct wsdisplayio_edid_info *); 224 225 struct wsdisplayio_fbinfo; 226 struct rasops_info; 227 int wsdisplayio_get_fbinfo(struct rasops_info *, struct wsdisplayio_fbinfo *); 228 229 #ifdef WSDISPLAY_SCROLLSUPPORT 230 void wsdisplay_scroll(void *, int); 231 #endif 232 233 #define WSDISPLAY_SCROLL_BACKWARD 1 234 #define WSDISPLAY_SCROLL_FORWARD (1 << 1) 235 #define WSDISPLAY_SCROLL_RESET (1 << 2) 236 #define WSDISPLAY_SCROLL_LOW (1 << 3) 237 238 int wsdisplay_stat_inject(device_t, u_int, int); 239 240 /* 241 * for general use 242 */ 243 #define WSDISPLAY_NULLSCREEN -1 244 const struct wsscreen_descr *wsdisplay_screentype_pick( 245 const struct wsscreen_list *, const char *); 246 247 #if defined(_KERNEL) 248 # if defined(_KERNEL_OPT) 249 # include "opt_wsmsgattrs.h" 250 # endif 251 # if !defined(WS_DEFAULT_FG) 252 # define WS_DEFAULT_FG WSCOL_WHITE 253 # endif 254 # if !defined(WS_DEFAULT_BG) 255 # define WS_DEFAULT_BG WSCOL_BLACK 256 # endif 257 # if !defined(WS_DEFAULT_COLATTR) 258 # define WS_DEFAULT_COLATTR 0 259 # endif 260 # if !defined(WS_DEFAULT_MONOATTR) 261 # define WS_DEFAULT_MONOATTR 0 262 # endif 263 # if defined(WS_KERNEL_FG) || defined(WS_KERNEL_BG) || \ 264 defined(WS_KERNEL_COLATTR) || defined(WS_KERNEL_MONOATTR) 265 # define WS_KERNEL_CUSTOMIZED 266 # else 267 # undef WS_KERNEL_CUSTOMIZED 268 # endif 269 # if !defined(WS_KERNEL_FG) 270 # define WS_KERNEL_FG WS_DEFAULT_FG 271 # endif 272 # if !defined(WS_KERNEL_BG) 273 # define WS_KERNEL_BG WS_DEFAULT_BG 274 # endif 275 # if !defined(WS_KERNEL_COLATTR) 276 # define WS_KERNEL_COLATTR WS_DEFAULT_COLATTR 277 # endif 278 # if !defined(WS_KERNEL_MONOATTR) 279 # define WS_KERNEL_MONOATTR WS_DEFAULT_MONOATTR 280 # endif 281 # if !defined(WSDISPLAY_BORDER_COLOR) 282 # define WSDISPLAY_BORDER_COLOR WS_DEFAULT_BG 283 # endif 284 #endif /* _KERNEL */ 285 286 #endif /* !_DEV_WSCONS_WSDISPLAYVAR_H */ 287