vt.h revision 271312
1214501Srpaulo/*- 2214501Srpaulo * Copyright (c) 2009, 2013 The FreeBSD Foundation 3214501Srpaulo * All rights reserved. 4214501Srpaulo * 5214501Srpaulo * This software was developed by Ed Schouten under sponsorship from the 6214501Srpaulo * FreeBSD Foundation. 7214501Srpaulo * 8214501Srpaulo * Portions of this software were developed by Oleksandr Rybalko 9214501Srpaulo * under sponsorship from the FreeBSD Foundation. 10214501Srpaulo * 11214501Srpaulo * Redistribution and use in source and binary forms, with or without 12214501Srpaulo * modification, are permitted provided that the following conditions 13214501Srpaulo * are met: 14214501Srpaulo * 1. Redistributions of source code must retain the above copyright 15214501Srpaulo * notice, this list of conditions and the following disclaimer. 16214501Srpaulo * 2. Redistributions in binary form must reproduce the above copyright 17214501Srpaulo * notice, this list of conditions and the following disclaimer in the 18214501Srpaulo * documentation and/or other materials provided with the distribution. 19214501Srpaulo * 20214501Srpaulo * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND 21214501Srpaulo * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 22214501Srpaulo * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 23 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 24 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 25 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 26 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 27 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 28 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 29 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 30 * SUCH DAMAGE. 31 * 32 * $FreeBSD: head/sys/dev/vt/vt.h 271312 2014-09-09 14:18:56Z ray $ 33 */ 34 35#ifndef _DEV_VT_VT_H_ 36#define _DEV_VT_VT_H_ 37 38#include <sys/param.h> 39#include <sys/_lock.h> 40#include <sys/_mutex.h> 41#include <sys/callout.h> 42#include <sys/condvar.h> 43#include <sys/conf.h> 44#include <sys/consio.h> 45#include <sys/kbio.h> 46#include <sys/mouse.h> 47#include <sys/terminal.h> 48#include <sys/sysctl.h> 49 50#include "opt_syscons.h" 51#include "opt_splash.h" 52 53#ifndef VT_MAXWINDOWS 54#ifdef MAXCONS 55#define VT_MAXWINDOWS MAXCONS 56#else 57#define VT_MAXWINDOWS 12 58#endif 59#endif 60 61#ifndef VT_ALT_TO_ESC_HACK 62#define VT_ALT_TO_ESC_HACK 1 63#endif 64 65#define VT_CONSWINDOW 0 66 67#if defined(SC_TWOBUTTON_MOUSE) || defined(VT_TWOBUTTON_MOUSE) 68#define VT_MOUSE_PASTEBUTTON MOUSE_BUTTON3DOWN /* right button */ 69#define VT_MOUSE_EXTENDBUTTON MOUSE_BUTTON2DOWN /* not really used */ 70#else 71#define VT_MOUSE_PASTEBUTTON MOUSE_BUTTON2DOWN /* middle button */ 72#define VT_MOUSE_EXTENDBUTTON MOUSE_BUTTON3DOWN /* right button */ 73#endif /* defined(SC_TWOBUTTON_MOUSE) || defined(VT_TWOBUTTON_MOUSE) */ 74 75#define SC_DRIVER_NAME "vt" 76#ifdef VT_DEBUG 77#define DPRINTF(_l, ...) if (vt_debug > (_l)) printf( __VA_ARGS__ ) 78#define VT_CONSOLECTL_DEBUG 79#define VT_SYSMOUSE_DEBUG 80#else 81#define DPRINTF(_l, ...) do {} while (0) 82#endif 83#define ISSIGVALID(sig) ((sig) > 0 && (sig) < NSIG) 84 85#define VT_SYSCTL_INT(_name, _default, _descr) \ 86static int vt_##_name = _default; \ 87SYSCTL_INT(_kern_vt, OID_AUTO, _name, CTLFLAG_RWTUN, &vt_##_name, _default,\ 88 _descr); 89 90struct vt_driver; 91 92void vt_allocate(struct vt_driver *, void *); 93void vt_resume(void); 94void vt_suspend(void); 95 96typedef unsigned int vt_axis_t; 97 98/* 99 * List of locks 100 * (d) locked by vd_lock 101 * (b) locked by vb_lock 102 * (G) locked by Giant 103 * (u) unlocked, locked by higher levels 104 * (c) const until freeing 105 * (?) yet to be determined 106 */ 107 108/* 109 * Per-device datastructure. 110 */ 111 112#ifndef SC_NO_CUTPASTE 113struct vt_mouse_cursor; 114#endif 115 116struct vt_device { 117 struct vt_window *vd_windows[VT_MAXWINDOWS]; /* (c) Windows. */ 118 struct vt_window *vd_curwindow; /* (d) Current window. */ 119 struct vt_window *vd_savedwindow;/* (?) Saved for suspend. */ 120 struct vt_window *vd_markedwin; /* (?) Copy/paste buf owner. */ 121 const struct vt_driver *vd_driver; /* (c) Graphics driver. */ 122 void *vd_softc; /* (u) Driver data. */ 123#ifndef SC_NO_CUTPASTE 124 struct vt_mouse_cursor *vd_mcursor; /* (?) Cursor bitmap. */ 125 term_color_t vd_mcursor_fg; /* (?) Cursor fg color. */ 126 term_color_t vd_mcursor_bg; /* (?) Cursor bg color. */ 127 vt_axis_t vd_mx_drawn; /* (?) Mouse X and Y */ 128 vt_axis_t vd_my_drawn; /* as of last redraw. */ 129 int vd_mshown; /* (?) Mouse shown during */ 130#endif /* last redrawn. */ 131 uint16_t vd_mx; /* (?) Current mouse X. */ 132 uint16_t vd_my; /* (?) current mouse Y. */ 133 uint32_t vd_mstate; /* (?) Mouse state. */ 134 vt_axis_t vd_width; /* (?) Screen width. */ 135 vt_axis_t vd_height; /* (?) Screen height. */ 136 struct mtx vd_lock; /* Per-device lock. */ 137 struct cv vd_winswitch; /* (d) Window switch notify. */ 138 struct callout vd_timer; /* (d) Display timer. */ 139 volatile unsigned int vd_timer_armed;/* (?) Display timer started.*/ 140 int vd_flags; /* (d) Device flags. */ 141#define VDF_TEXTMODE 0x01 /* Do text mode rendering. */ 142#define VDF_SPLASH 0x02 /* Splash screen active. */ 143#define VDF_ASYNC 0x04 /* vt_timer() running. */ 144#define VDF_INVALID 0x08 /* Entire screen should be re-rendered. */ 145#define VDF_DEAD 0x10 /* Early probing found nothing. */ 146#define VDF_INITIALIZED 0x20 /* vtterm_cnprobe already done. */ 147#define VDF_MOUSECURSOR 0x40 /* Mouse cursor visible. */ 148#define VDF_QUIET_BELL 0x80 /* Disable bell. */ 149 int vd_keyboard; /* (G) Keyboard index. */ 150 unsigned int vd_kbstate; /* (?) Device unit. */ 151 unsigned int vd_unit; /* (c) Device unit. */ 152}; 153 154/* 155 * Per-window terminal screen buffer. 156 * 157 * Because redrawing is performed asynchronously, the buffer keeps track 158 * of a rectangle that needs to be redrawn (vb_dirtyrect). Because this 159 * approach seemed to cause suboptimal performance (when the top left 160 * and the bottom right of the screen are modified), it also uses a set 161 * of bitmasks to keep track of the rows and columns (mod 64) that have 162 * been modified. 163 */ 164 165struct vt_bufmask { 166 uint64_t vbm_row, vbm_col; 167#define VBM_DIRTY UINT64_MAX 168}; 169 170struct vt_buf { 171 struct mtx vb_lock; /* Buffer lock. */ 172 term_pos_t vb_scr_size; /* (b) Screen dimensions. */ 173 int vb_flags; /* (b) Flags. */ 174#define VBF_CURSOR 0x1 /* Cursor visible. */ 175#define VBF_STATIC 0x2 /* Buffer is statically allocated. */ 176#define VBF_MTX_INIT 0x4 /* Mutex initialized. */ 177#define VBF_SCROLL 0x8 /* scroll locked mode. */ 178#define VBF_HISTORY_FULL 0x10 /* All rows filled. */ 179 unsigned int vb_history_size; 180#define VBF_DEFAULT_HISTORY_SIZE 500 181 int vb_roffset; /* (b) History rows offset. */ 182 int vb_curroffset; /* (b) Saved rows offset. */ 183 term_pos_t vb_cursor; /* (u) Cursor position. */ 184 term_pos_t vb_mark_start; /* (b) Copy region start. */ 185 term_pos_t vb_mark_end; /* (b) Copy region end. */ 186 int vb_mark_last; /* Last mouse event. */ 187 term_rect_t vb_dirtyrect; /* (b) Dirty rectangle. */ 188 struct vt_bufmask vb_dirtymask; /* (b) Dirty bitmasks. */ 189 term_char_t *vb_buffer; /* (u) Data buffer. */ 190 term_char_t **vb_rows; /* (u) Array of rows */ 191}; 192 193void vtbuf_copy(struct vt_buf *, const term_rect_t *, const term_pos_t *); 194void vtbuf_fill_locked(struct vt_buf *, const term_rect_t *, term_char_t); 195void vtbuf_init_early(struct vt_buf *); 196void vtbuf_init(struct vt_buf *, const term_pos_t *); 197void vtbuf_grow(struct vt_buf *, const term_pos_t *, unsigned int); 198void vtbuf_putchar(struct vt_buf *, const term_pos_t *, term_char_t); 199void vtbuf_cursor_position(struct vt_buf *, const term_pos_t *); 200void vtbuf_scroll_mode(struct vt_buf *vb, int yes); 201void vtbuf_dirty(struct vt_buf *vb, const term_rect_t *area); 202void vtbuf_undirty(struct vt_buf *, term_rect_t *, struct vt_bufmask *); 203void vtbuf_sethistory_size(struct vt_buf *, int); 204int vtbuf_iscursor(const struct vt_buf *vb, int row, int col); 205void vtbuf_cursor_visibility(struct vt_buf *, int); 206#ifndef SC_NO_CUTPASTE 207int vtbuf_set_mark(struct vt_buf *vb, int type, int col, int row); 208int vtbuf_get_marked_len(struct vt_buf *vb); 209void vtbuf_extract_marked(struct vt_buf *vb, term_char_t *buf, int sz); 210#endif 211 212#define VTB_MARK_NONE 0 213#define VTB_MARK_END 1 214#define VTB_MARK_START 2 215#define VTB_MARK_WORD 3 216#define VTB_MARK_ROW 4 217#define VTB_MARK_EXTEND 5 218#define VTB_MARK_MOVE 6 219 220#define VTBUF_SLCK_ENABLE(vb) vtbuf_scroll_mode((vb), 1) 221#define VTBUF_SLCK_DISABLE(vb) vtbuf_scroll_mode((vb), 0) 222 223#define VTBUF_MAX_HEIGHT(vb) \ 224 ((vb)->vb_history_size) 225#define VTBUF_GET_ROW(vb, r) \ 226 ((vb)->vb_rows[((vb)->vb_roffset + (r)) % VTBUF_MAX_HEIGHT(vb)]) 227#define VTBUF_GET_FIELD(vb, r, c) \ 228 ((vb)->vb_rows[((vb)->vb_roffset + (r)) % VTBUF_MAX_HEIGHT(vb)][(c)]) 229#define VTBUF_FIELD(vb, r, c) \ 230 ((vb)->vb_rows[((vb)->vb_curroffset + (r)) % VTBUF_MAX_HEIGHT(vb)][(c)]) 231#define VTBUF_ISCURSOR(vb, r, c) \ 232 vtbuf_iscursor((vb), (r), (c)) 233#define VTBUF_DIRTYROW(mask, row) \ 234 ((mask)->vbm_row & ((uint64_t)1 << ((row) % 64))) 235#define VTBUF_DIRTYCOL(mask, col) \ 236 ((mask)->vbm_col & ((uint64_t)1 << ((col) % 64))) 237#define VTBUF_SPACE_CHAR(attr) (' ' | (attr)) 238 239#define VHS_SET 0 240#define VHS_CUR 1 241#define VHS_END 2 242int vthistory_seek(struct vt_buf *, int offset, int whence); 243void vthistory_addlines(struct vt_buf *vb, int offset); 244void vthistory_getpos(const struct vt_buf *, unsigned int *offset); 245 246/* 247 * Per-window datastructure. 248 */ 249 250struct vt_window { 251 struct vt_device *vw_device; /* (c) Device. */ 252 struct terminal *vw_terminal; /* (c) Terminal. */ 253 struct vt_buf vw_buf; /* (u) Screen buffer. */ 254 struct vt_font *vw_font; /* (d) Graphical font. */ 255 term_rect_t vw_draw_area; /* (?) Drawable area. */ 256 unsigned int vw_number; /* (c) Window number. */ 257 int vw_kbdmode; /* (?) Keyboard mode. */ 258 int vw_prev_kbdmode;/* (?) Previous mode. */ 259 int vw_grabbed; /* (?) Grab count. */ 260 char *vw_kbdsq; /* Escape sequence queue*/ 261 unsigned int vw_flags; /* (d) Per-window flags. */ 262 int vw_mouse_level;/* Mouse op mode. */ 263#define VWF_BUSY 0x1 /* Busy reconfiguring device. */ 264#define VWF_OPENED 0x2 /* TTY in use. */ 265#define VWF_SCROLL 0x4 /* Keys influence scrollback. */ 266#define VWF_CONSOLE 0x8 /* Kernel message console window. */ 267#define VWF_VTYLOCK 0x10 /* Prevent window switch. */ 268#define VWF_MOUSE_HIDE 0x20 /* Disable mouse events processing. */ 269#define VWF_READY 0x40 /* Window fully initialized. */ 270#define VWF_GRAPHICS 0x80 /* Window in graphics mode (KDSETMODE). */ 271#define VWF_SWWAIT_REL 0x10000 /* Program wait for VT acquire is done. */ 272#define VWF_SWWAIT_ACQ 0x20000 /* Program wait for VT release is done. */ 273 pid_t vw_pid; /* Terminal holding process */ 274 struct proc *vw_proc; 275 struct vt_mode vw_smode; /* switch mode */ 276 struct callout vw_proc_dead_timer; 277 struct vt_window *vw_switch_to; 278}; 279 280#define VT_AUTO 0 /* switching is automatic */ 281#define VT_PROCESS 1 /* switching controlled by prog */ 282#define VT_KERNEL 255 /* switching controlled in kernel */ 283 284#define IS_VT_PROC_MODE(vw) ((vw)->vw_smode.mode == VT_PROCESS) 285 286/* 287 * Per-device driver routines. 288 */ 289 290typedef int vd_init_t(struct vt_device *vd); 291typedef int vd_probe_t(struct vt_device *vd); 292typedef void vd_postswitch_t(struct vt_device *vd); 293typedef void vd_blank_t(struct vt_device *vd, term_color_t color); 294typedef void vd_bitblt_text_t(struct vt_device *vd, const struct vt_window *vw, 295 const term_rect_t *area); 296typedef void vd_bitblt_bmp_t(struct vt_device *vd, const struct vt_window *vw, 297 const uint8_t *pattern, const uint8_t *mask, 298 unsigned int width, unsigned int height, 299 unsigned int x, unsigned int y, term_color_t fg, term_color_t bg); 300typedef int vd_fb_ioctl_t(struct vt_device *, u_long, caddr_t, struct thread *); 301typedef int vd_fb_mmap_t(struct vt_device *, vm_ooffset_t, vm_paddr_t *, int, 302 vm_memattr_t *); 303typedef void vd_drawrect_t(struct vt_device *, int, int, int, int, int, 304 term_color_t); 305typedef void vd_setpixel_t(struct vt_device *, int, int, term_color_t); 306 307struct vt_driver { 308 char vd_name[16]; 309 /* Console attachment. */ 310 vd_probe_t *vd_probe; 311 vd_init_t *vd_init; 312 313 /* Drawing. */ 314 vd_blank_t *vd_blank; 315 vd_drawrect_t *vd_drawrect; 316 vd_setpixel_t *vd_setpixel; 317 vd_bitblt_text_t *vd_bitblt_text; 318 vd_bitblt_bmp_t *vd_bitblt_bmp; 319 320 /* Framebuffer ioctls, if present. */ 321 vd_fb_ioctl_t *vd_fb_ioctl; 322 323 /* Framebuffer mmap, if present. */ 324 vd_fb_mmap_t *vd_fb_mmap; 325 326 /* Update display setting on vt switch. */ 327 vd_postswitch_t *vd_postswitch; 328 329 /* Priority to know which one can override */ 330 int vd_priority; 331#define VD_PRIORITY_DUMB 10 332#define VD_PRIORITY_GENERIC 100 333#define VD_PRIORITY_SPECIFIC 1000 334}; 335 336/* 337 * Console device madness. 338 * 339 * Utility macro to make early vt(4) instances work. 340 */ 341 342extern const struct terminal_class vt_termclass; 343void vt_upgrade(struct vt_device *vd); 344 345#define PIXEL_WIDTH(w) ((w) / 8) 346#define PIXEL_HEIGHT(h) ((h) / 16) 347 348#ifndef VT_FB_DEFAULT_WIDTH 349#define VT_FB_DEFAULT_WIDTH 2048 350#endif 351#ifndef VT_FB_DEFAULT_HEIGHT 352#define VT_FB_DEFAULT_HEIGHT 1200 353#endif 354 355/* name argument is not used yet. */ 356#define VT_DRIVER_DECLARE(name, drv) DATA_SET(vt_drv_set, drv) 357 358/* 359 * Fonts. 360 * 361 * Remapping tables are used to map Unicode points to glyphs. They need 362 * to be sorted, because vtfont_lookup() performs a binary search. Each 363 * font has two remapping tables, for normal and bold. When a character 364 * is not present in bold, it uses a normal glyph. When no glyph is 365 * available, it uses glyph 0, which is normally equal to U+FFFD. 366 */ 367 368struct vt_font_map { 369 uint32_t vfm_src; 370 uint16_t vfm_dst; 371 uint16_t vfm_len; 372}; 373 374struct vt_font { 375 struct vt_font_map *vf_map[VFNT_MAPS]; 376 uint8_t *vf_bytes; 377 unsigned int vf_height, vf_width; 378 unsigned int vf_map_count[VFNT_MAPS]; 379 unsigned int vf_refcount; 380}; 381 382#ifndef SC_NO_CUTPASTE 383struct vt_mouse_cursor { 384 uint8_t map[64 * 64 / 8]; 385 uint8_t mask[64 * 64 / 8]; 386 uint8_t width; 387 uint8_t height; 388}; 389#endif 390 391const uint8_t *vtfont_lookup(const struct vt_font *vf, term_char_t c); 392struct vt_font *vtfont_ref(struct vt_font *vf); 393void vtfont_unref(struct vt_font *vf); 394int vtfont_load(vfnt_t *f, struct vt_font **ret); 395 396/* Sysmouse. */ 397void sysmouse_process_event(mouse_info_t *mi); 398#ifndef SC_NO_CUTPASTE 399void vt_mouse_event(int type, int x, int y, int event, int cnt, int mlevel); 400void vt_mouse_state(int show); 401#endif 402#define VT_MOUSE_SHOW 1 403#define VT_MOUSE_HIDE 0 404 405/* Utilities. */ 406void vt_determine_colors(term_char_t c, int cursor, 407 term_color_t *fg, term_color_t *bg); 408int vt_is_cursor_in_area(const struct vt_device *vd, 409 const term_rect_t *area); 410 411#endif /* !_DEV_VT_VT_H_ */ 412 413