vt.h revision 256964
1/*- 2 * Copyright (c) 2009 The FreeBSD Foundation 3 * All rights reserved. 4 * 5 * This software was developed by Ed Schouten under sponsorship from the 6 * FreeBSD Foundation. 7 * 8 * Redistribution and use in source and binary forms, with or without 9 * modification, are permitted provided that the following conditions 10 * are met: 11 * 1. Redistributions of source code must retain the above copyright 12 * notice, this list of conditions and the following disclaimer. 13 * 2. Redistributions in binary form must reproduce the above copyright 14 * notice, this list of conditions and the following disclaimer in the 15 * documentation and/or other materials provided with the distribution. 16 * 17 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND 18 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 19 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 20 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 21 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 22 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 23 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 24 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 25 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 26 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 27 * SUCH DAMAGE. 28 * 29 * $FreeBSD: user/ed/newcons/sys/dev/vt/vt.h 256964 2013-10-23 13:35:46Z ray $ 30 */ 31 32#ifndef _DEV_VT_VT_H_ 33#define _DEV_VT_VT_H_ 34 35#include <sys/param.h> 36#include <sys/_lock.h> 37#include <sys/_mutex.h> 38#include <sys/callout.h> 39#include <sys/condvar.h> 40#include <sys/consio.h> 41#include <sys/kbio.h> 42#include <sys/terminal.h> 43#include <sys/sysctl.h> 44 45#define VT_MAXWINDOWS 12 46#define VT_CONSWINDOW 0 47 48#define SC_DRIVER_NAME "vt" 49#define DPRINTF(_l, ...) if (vt_debug > (_l)) printf( __VA_ARGS__ ) 50#define ISSIGVALID(sig) ((sig) > 0 && (sig) < NSIG) 51 52#define VT_SYSCTL_INT(_name, _default, _descr) \ 53static int vt_##_name = _default; \ 54SYSCTL_INT(_kern_vt, OID_AUTO, _name, CTLFLAG_RW, &vt_##_name, _default,\ 55 _descr); \ 56TUNABLE_INT("kern.vt." #_name, &vt_##_name); 57 58struct vt_driver; 59 60void vt_allocate(struct vt_driver *, void *); 61 62typedef unsigned int vt_axis_t; 63 64/* 65 * List of locks 66 * (d) locked by vd_lock 67 * (b) locked by vb_lock 68 * (G) locked by Giant 69 * (u) unlocked, locked by higher levels 70 * (c) const until freeing 71 * (?) yet to be determined 72 */ 73 74/* 75 * Per-device datastructure. 76 */ 77 78struct vt_device { 79 struct vt_window *vd_windows[VT_MAXWINDOWS]; /* (c) Windows. */ 80 struct vt_window *vd_curwindow; /* (d) Current window. */ 81 const struct vt_driver *vd_driver; /* (c) Graphics driver. */ 82 void *vd_softc; /* (u) Driver data. */ 83 vt_axis_t vd_width; /* (?) Screen width. */ 84 vt_axis_t vd_height; /* (?) Screen height. */ 85 struct mtx vd_lock; /* Per-device lock. */ 86 struct cv vd_winswitch; /* (d) Window switch notify. */ 87 struct callout vd_timer; /* (d) Display timer. */ 88 int vd_flags; /* (d) Device flags. */ 89#define VDF_TEXTMODE 0x01 /* Do text mode rendering. */ 90#define VDF_SPLASH 0x02 /* Splash screen active. */ 91#define VDF_ASYNC 0x04 /* vt_timer() running. */ 92#define VDF_INVALID 0x08 /* Entire screen should be re-rendered. */ 93#define VDF_DEAD 0x10 /* Early probing found nothing. */ 94#define VDF_INITIALIZED 0x20 /* vtterm_cnprobe already done. */ 95 int vd_keyboard; /* (G) Keyboard index. */ 96 unsigned int vd_unit; /* (c) Device unit. */ 97}; 98 99/* 100 * Per-window terminal screen buffer. 101 * 102 * Because redrawing is performed asynchronously, the buffer keeps track 103 * of a rectangle that needs to be redrawn (vb_dirtyrect). Because this 104 * approach seemed to cause suboptimal performance (when the top left 105 * and the bottom right of the screen are modified), it also uses a set 106 * of bitmasks to keep track of the rows and columns (mod 64) that have 107 * been modified. 108 */ 109 110struct vt_bufmask { 111 uint64_t vbm_row, vbm_col; 112#define VBM_DIRTY UINT64_MAX 113}; 114 115struct vt_buf { 116 struct mtx vb_lock; /* Buffer lock. */ 117 term_pos_t vb_scr_size; /* (b) Screen dimensions. */ 118 int vb_flags; /* (b) Flags. */ 119#define VBF_CURSOR 0x1 /* Cursor visible. */ 120#define VBF_STATIC 0x2 /* Buffer is statically allocated. */ 121#define VBF_MTX_INIT 0x4 /* Mutex initialized. */ 122#define VBF_SCROLL 0x8 /* scroll locked mode. */ 123#define VBF_HISTORY_FULL 0x10 /* All rows filled. */ 124 int vb_history_size; 125#define VBF_DEFAULT_HISTORY_SIZE 200 126 int vb_roffset; /* (b) History rows offset. */ 127 int vb_curroffset; /* (b) Saved rows offset. */ 128 term_pos_t vb_cursor; /* (u) Cursor position. */ 129 term_rect_t vb_dirtyrect; /* (b) Dirty rectangle. */ 130 struct vt_bufmask vb_dirtymask; /* (b) Dirty bitmasks. */ 131 term_char_t *vb_buffer; /* (u) Data buffer. */ 132 term_char_t **vb_rows; /* (u) Array of rows */ 133}; 134 135void vtbuf_copy(struct vt_buf *, const term_rect_t *, const term_pos_t *); 136void vtbuf_fill_locked(struct vt_buf *, const term_rect_t *, term_char_t); 137void vtbuf_init_early(struct vt_buf *); 138void vtbuf_init(struct vt_buf *, const term_pos_t *); 139void vtbuf_grow(struct vt_buf *, const term_pos_t *, int); 140void vtbuf_putchar(struct vt_buf *, const term_pos_t *, term_char_t); 141void vtbuf_cursor_position(struct vt_buf *, const term_pos_t *); 142void vtbuf_cursor_visibility(struct vt_buf *, int); 143void vtbuf_undirty(struct vt_buf *, term_rect_t *, struct vt_bufmask *); 144void vtbuf_sethistory_size(struct vt_buf *, int); 145 146#define VTBUF_SLCK_ENABLE(vb) (vb)->vb_flags |= VBF_SCROLL 147#define VTBUF_SLCK_DISABLE(vb) (vb)->vb_flags &= ~VBF_SCROLL 148 149#define VTBUF_MAX_HEIGHT(vb) \ 150 ((vb)->vb_history_size) 151#define VTBUF_GET_ROW(vb, r) \ 152 ((vb)->vb_rows[((vb)->vb_roffset + (r)) % VTBUF_MAX_HEIGHT(vb)]) 153#define VTBUF_GET_FIELD(vb, r, c) \ 154 ((vb)->vb_rows[((vb)->vb_roffset + (r)) % VTBUF_MAX_HEIGHT(vb)][(c)]) 155#define VTBUF_FIELD(vb, r, c) \ 156 ((vb)->vb_rows[((vb)->vb_curroffset + (r)) % VTBUF_MAX_HEIGHT(vb)][(c)]) 157#define VTBUF_ISCURSOR(vb, r, c) \ 158 ((vb)->vb_flags & VBF_CURSOR && \ 159 (vb)->vb_cursor.tp_row == (r) && (vb)->vb_cursor.tp_col == (c)) 160#define VTBUF_DIRTYROW(mask, row) \ 161 ((mask)->vbm_row & ((uint64_t)1 << ((row) % 64))) 162#define VTBUF_DIRTYCOL(mask, col) \ 163 ((mask)->vbm_col & ((uint64_t)1 << ((col) % 64))) 164#define VTBUF_SPACE_CHAR (' ' | TC_WHITE << 26 | TC_BLACK << 29) 165 166#define VHS_SET 0 167#define VHS_CUR 1 168#define VHS_END 2 169int vthistory_seek(struct vt_buf *, int offset, int whence); 170void vthistory_addlines(struct vt_buf *vb, int offset); 171void vthistory_getpos(const struct vt_buf *, unsigned int *offset); 172 173/* 174 * Per-window datastructure. 175 */ 176 177struct vt_window { 178 struct vt_device *vw_device; /* (c) Device. */ 179 struct terminal *vw_terminal; /* (c) Terminal. */ 180 struct vt_buf vw_buf; /* (u) Screen buffer. */ 181 struct vt_font *vw_font; /* (d) Graphical font. */ 182 unsigned int vw_number; /* (c) Window number. */ 183 int vw_kbdmode; /* (?) Keyboard mode. */ 184 unsigned int vw_flags; /* (d) Per-window flags. */ 185#define VWF_BUSY 0x1 /* Busy reconfiguring device. */ 186#define VWF_OPENED 0x2 /* TTY in use. */ 187#define VWF_SCROLL 0x4 /* Keys influence scrollback. */ 188#define VWF_CONSOLE 0x8 /* Kernel message console window. */ 189#define VWF_VTYLOCK 0x10 /* Prevent window switch. */ 190#define VWF_SWWAIT_REL 0x10000 /* Program wait for VT acquire is done. */ 191#define VWF_SWWAIT_ACQ 0x20000 /* Program wait for VT release is done. */ 192 pid_t vw_pid; /* Terminal holding process */ 193 struct proc *vw_proc; 194 struct vt_mode vw_smode; /* switch mode */ 195 struct callout vw_proc_dead_timer; 196 struct vt_window *vw_switch_to; 197}; 198 199#define VT_AUTO 0 /* switching is automatic */ 200#define VT_PROCESS 1 /* switching controlled by prog */ 201#define VT_KERNEL 255 /* switching controlled in kernel */ 202 203#define IS_VT_PROC_MODE(vw) ((vw)->vw_smode.mode == VT_PROCESS) 204 205/* 206 * Per-device driver routines. 207 * 208 * vd_bitbltchr is used when the driver operates in graphics mode, while 209 * vd_putchar is used when the driver operates in text mode 210 * (VDF_TEXTMODE). 211 */ 212 213typedef int vd_init_t(struct vt_device *vd); 214typedef void vd_postswitch_t(struct vt_device *vd); 215typedef void vd_blank_t(struct vt_device *vd, term_color_t color); 216typedef void vd_bitbltchr_t(struct vt_device *vd, const uint8_t *src, 217 vt_axis_t top, vt_axis_t left, unsigned int width, unsigned int height, 218 term_color_t fg, term_color_t bg); 219typedef void vd_putchar_t(struct vt_device *vd, term_char_t, 220 vt_axis_t top, vt_axis_t left, term_color_t fg, term_color_t bg); 221 222struct vt_driver { 223 /* Console attachment. */ 224 vd_init_t *vd_init; 225 226 /* Drawing. */ 227 vd_blank_t *vd_blank; 228 vd_bitbltchr_t *vd_bitbltchr; 229 230 /* Text mode operation. */ 231 vd_putchar_t *vd_putchar; 232 233 /* Update display setting on vt switch. */ 234 vd_postswitch_t *vd_postswitch; 235 236 /* Priority to know which one can override */ 237 int vd_priority; 238#define VD_PRIORITY_DUMB 10 239#define VD_PRIORITY_GENERIC 100 240#define VD_PRIORITY_SPECIFIC 1000 241}; 242 243/* 244 * Console device madness. 245 * 246 * Utility macro to make early vt(4) instances work. 247 */ 248 249extern const struct terminal_class vt_termclass; 250void vt_upgrade(struct vt_device *vd); 251 252#define PIXEL_WIDTH(w) ((w) / 8) 253#define PIXEL_HEIGHT(h) ((h) / 16) 254 255#define VT_CONSDEV_DECLARE(driver, width, height, softc) \ 256static struct terminal driver ## _consterm; \ 257static struct vt_window driver ## _conswindow; \ 258static struct vt_device driver ## _consdev = { \ 259 .vd_driver = &driver, \ 260 .vd_softc = (softc), \ 261 .vd_flags = VDF_INVALID, \ 262 .vd_windows = { [VT_CONSWINDOW] = &driver ## _conswindow, }, \ 263 .vd_curwindow = &driver ## _conswindow, \ 264}; \ 265static term_char_t driver ## _constextbuf[(width) * \ 266 (VBF_DEFAULT_HISTORY_SIZE)]; \ 267static term_char_t *driver ## _constextbufrows[ \ 268 VBF_DEFAULT_HISTORY_SIZE]; \ 269static struct vt_window driver ## _conswindow = { \ 270 .vw_number = VT_CONSWINDOW, \ 271 .vw_flags = VWF_CONSOLE, \ 272 .vw_buf = { \ 273 .vb_buffer = driver ## _constextbuf, \ 274 .vb_rows = driver ## _constextbufrows, \ 275 .vb_history_size = VBF_DEFAULT_HISTORY_SIZE, \ 276 .vb_curroffset = 0, \ 277 .vb_roffset = 0, \ 278 .vb_flags = VBF_STATIC, \ 279 .vb_scr_size = { \ 280 .tp_row = height, \ 281 .tp_col = width, \ 282 }, \ 283 }, \ 284 .vw_device = &driver ## _consdev, \ 285 .vw_terminal = &driver ## _consterm, \ 286 .vw_kbdmode = K_XLATE, \ 287}; \ 288TERMINAL_DECLARE_EARLY(driver ## _consterm, vt_termclass, \ 289 &driver ## _conswindow); \ 290SYSINIT(vt_early_cons, SI_SUB_INT_CONFIG_HOOKS, SI_ORDER_ANY, \ 291 vt_upgrade, &driver ## _consdev) 292 293/* 294 * Fonts. 295 * 296 * Remapping tables are used to map Unicode points to glyphs. They need 297 * to be sorted, because vtfont_lookup() performs a binary search. Each 298 * font has two remapping tables, for normal and bold. When a character 299 * is not present in bold, it uses a normal glyph. When no glyph is 300 * available, it uses glyph 0, which is normally equal to U+FFFD. 301 */ 302 303struct vt_font_map { 304 uint32_t vfm_src; 305 uint16_t vfm_dst; 306 uint16_t vfm_len; 307}; 308 309struct vt_font { 310 struct vt_font_map *vf_bold; 311 struct vt_font_map *vf_normal; 312 uint8_t *vf_bytes; 313 unsigned int vf_height, vf_width, 314 vf_normal_length, vf_bold_length; 315 unsigned int vf_refcount; 316}; 317 318const uint8_t *vtfont_lookup(const struct vt_font *vf, term_char_t c); 319struct vt_font *vtfont_ref(struct vt_font *vf); 320void vtfont_unref(struct vt_font *vf); 321int vtfont_load(vfnt_t *f, struct vt_font **ret); 322 323/* Sysmouse. */ 324void sysmouse_process_event(mouse_info_t *mi); 325 326#endif /* !_DEV_VT_VT_H_ */ 327