1/*-
2 * SPDX-License-Identifier: BSD-2-Clause
3 *
4 * Copyright (c) 2009, 2013 The FreeBSD Foundation
5 *
6 * This software was developed by Ed Schouten under sponsorship from the
7 * FreeBSD Foundation.
8 *
9 * Portions of this software were developed by Oleksandr Rybalko
10 * under sponsorship from the FreeBSD Foundation.
11 *
12 * Redistribution and use in source and binary forms, with or without
13 * modification, are permitted provided that the following conditions
14 * are met:
15 * 1. Redistributions of source code must retain the above copyright
16 *    notice, this list of conditions and the following disclaimer.
17 * 2. Redistributions in binary form must reproduce the above copyright
18 *    notice, this list of conditions and the following disclaimer in the
19 *    documentation and/or other materials provided with the distribution.
20 *
21 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
22 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
23 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
24 * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
25 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
26 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
27 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
28 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
29 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
30 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
31 * SUCH DAMAGE.
32 */
33
34#ifndef _DEV_VT_VT_H_
35#define	_DEV_VT_VT_H_
36
37#include <sys/param.h>
38#include <sys/_lock.h>
39#include <sys/_mutex.h>
40#include <sys/callout.h>
41#include <sys/condvar.h>
42#include <sys/conf.h>
43#include <sys/consio.h>
44#include <sys/kbio.h>
45#include <sys/mouse.h>
46#include <sys/terminal.h>
47#include <sys/sysctl.h>
48#include <sys/font.h>
49#include <sys/taskqueue.h>
50
51#include "opt_syscons.h"
52#include "opt_splash.h"
53
54#ifndef	VT_MAXWINDOWS
55#ifdef	MAXCONS
56#define	VT_MAXWINDOWS	MAXCONS
57#else
58#define	VT_MAXWINDOWS	12
59#endif
60#endif
61
62#ifndef VT_ALT_TO_ESC_HACK
63#define	VT_ALT_TO_ESC_HACK	1
64#endif
65
66#define	VT_CONSWINDOW	0
67
68#if defined(SC_TWOBUTTON_MOUSE) || defined(VT_TWOBUTTON_MOUSE)
69#define VT_MOUSE_PASTEBUTTON	MOUSE_BUTTON3DOWN	/* right button */
70#define VT_MOUSE_EXTENDBUTTON	MOUSE_BUTTON2DOWN	/* not really used */
71#else
72#define VT_MOUSE_PASTEBUTTON	MOUSE_BUTTON2DOWN	/* middle button */
73#define VT_MOUSE_EXTENDBUTTON	MOUSE_BUTTON3DOWN	/* right button */
74#endif /* defined(SC_TWOBUTTON_MOUSE) || defined(VT_TWOBUTTON_MOUSE) */
75
76#define	SC_DRIVER_NAME	"vt"
77#ifdef VT_DEBUG
78#define	DPRINTF(_l, ...)	if (vt_debug > (_l)) printf( __VA_ARGS__ )
79#define VT_CONSOLECTL_DEBUG
80#define VT_SYSMOUSE_DEBUG
81#else
82#define	DPRINTF(_l, ...)	do {} while (0)
83#endif
84#define	ISSIGVALID(sig)	((sig) > 0 && (sig) < NSIG)
85
86#define	VT_SYSCTL_INT(_name, _default, _descr)				\
87int vt_##_name = (_default);						\
88SYSCTL_INT(_kern_vt, OID_AUTO, _name, CTLFLAG_RWTUN, &vt_##_name, 0, _descr)
89
90struct vt_driver;
91
92int vt_allocate(const struct vt_driver *, void *);
93int vt_deallocate(const struct vt_driver *, void *);
94
95typedef unsigned int	vt_axis_t;
96
97/*
98 * List of locks
99 * (d)	locked by vd_lock
100 * (b)	locked by vb_lock
101 * (G)	locked by Giant
102 * (u)	unlocked, locked by higher levels
103 * (c)	const until freeing
104 * (?)	yet to be determined
105 */
106
107/*
108 * Per-device datastructure.
109 */
110
111#ifndef SC_NO_CUTPASTE
112struct vt_mouse_cursor;
113#endif
114
115struct vt_pastebuf {
116	term_char_t		*vpb_buf;	/* Copy-paste buffer. */
117	unsigned int		 vpb_bufsz;	/* Buffer size. */
118	unsigned int		 vpb_len;	/* Length of a last selection. */
119};
120
121struct vt_device {
122	struct vt_window	*vd_windows[VT_MAXWINDOWS]; /* (c) Windows. */
123	struct vt_window	*vd_curwindow;	/* (d) Current window. */
124	struct vt_window	*vd_savedwindow;/* (?) Saved for suspend. */
125	struct vt_window	*vd_grabwindow;	/* (?) Saved before cngrab. */
126	struct vt_pastebuf	 vd_pastebuf;	/* (?) Copy/paste buf. */
127	const struct vt_driver	*vd_driver;	/* (c) Graphics driver. */
128	void			*vd_softc;	/* (u) Driver data. */
129	const struct vt_driver	*vd_prev_driver;/* (?) Previous driver. */
130	void			*vd_prev_softc;	/* (?) Previous driver data. */
131	device_t		 vd_video_dev;	/* (?) Video adapter. */
132#ifndef SC_NO_CUTPASTE
133	struct vt_mouse_cursor	*vd_mcursor;	/* (?) Cursor bitmap. */
134	term_color_t		 vd_mcursor_fg;	/* (?) Cursor fg color. */
135	term_color_t		 vd_mcursor_bg;	/* (?) Cursor bg color. */
136	vt_axis_t		 vd_mx_drawn;	/* (?) Mouse X and Y      */
137	vt_axis_t		 vd_my_drawn;	/*     as of last redraw. */
138	int			 vd_mshown;	/* (?) Mouse shown during */
139#endif						/*     last redrawn.      */
140	uint16_t		 vd_mx;		/* (?) Current mouse X. */
141	uint16_t		 vd_my;		/* (?) current mouse Y. */
142	uint32_t		 vd_mstate;	/* (?) Mouse state. */
143	vt_axis_t		 vd_width;	/* (?) Screen width. */
144	vt_axis_t		 vd_height;	/* (?) Screen height. */
145	size_t			 vd_transpose;	/* (?) Screen offset in FB */
146	struct mtx		 vd_lock;	/* Per-device lock. */
147	struct cv		 vd_winswitch;	/* (d) Window switch notify. */
148	struct callout		 vd_timer;	/* (d) Display timer. */
149	volatile unsigned int	 vd_timer_armed;/* (?) Display timer started.*/
150	int			 vd_flags;	/* (d) Device flags. */
151#define	VDF_TEXTMODE	0x01	/* Do text mode rendering. */
152#define	VDF_SPLASH	0x02	/* Splash screen active. */
153#define	VDF_ASYNC	0x04	/* vt_timer() running. */
154#define	VDF_INVALID	0x08	/* Entire screen should be re-rendered. */
155#define	VDF_DEAD	0x10	/* Early probing found nothing. */
156#define	VDF_INITIALIZED	0x20	/* vtterm_cnprobe already done. */
157#define	VDF_MOUSECURSOR	0x40	/* Mouse cursor visible. */
158#define	VDF_QUIET_BELL	0x80	/* Disable bell. */
159#define	VDF_SUSPENDED	0x100	/* Device has been suspended. */
160#define	VDF_DOWNGRADE	0x8000	/* The driver is being downgraded. */
161	struct keyboard		*vd_keyboard;	/* (G) Keyboard. */
162	unsigned int		 vd_kbstate;	/* (?) Device unit. */
163	unsigned int		 vd_unit;	/* (c) Device unit. */
164	int			 vd_altbrk;	/* (?) Alt break seq. state */
165	term_char_t		*vd_drawn;	/* (?) Most recent char drawn. */
166	term_color_t		*vd_drawnfg;	/* (?) Most recent fg color drawn. */
167	term_color_t		*vd_drawnbg;	/* (?) Most recent bg color drawn. */
168
169	struct mtx		 vd_flush_lock;	/* (?) vt_flush() lock. */
170	bool			*vd_pos_to_flush;/* (?) Positions to flush. */
171};
172
173#define	VD_PASTEBUF(vd)	((vd)->vd_pastebuf.vpb_buf)
174#define	VD_PASTEBUFSZ(vd)	((vd)->vd_pastebuf.vpb_bufsz)
175#define	VD_PASTEBUFLEN(vd)	((vd)->vd_pastebuf.vpb_len)
176
177#define	VT_LOCK(vd)	mtx_lock(&(vd)->vd_lock)
178#define	VT_UNLOCK(vd)	mtx_unlock(&(vd)->vd_lock)
179#define	VT_LOCK_ASSERT(vd, what)	mtx_assert(&(vd)->vd_lock, what)
180
181#define	VT_FLUSH_LOCK(vd)	\
182    if ((vd)->vd_driver->vd_bitblt_after_vtbuf_unlock) \
183	    mtx_lock(&(vd)->vd_flush_lock)
184
185#define	VT_FLUSH_UNLOCK(vd)	\
186    if ((vd)->vd_driver->vd_bitblt_after_vtbuf_unlock) \
187	    mtx_unlock(&(vd)->vd_flush_lock)
188
189void vt_resume(struct vt_device *vd);
190void vt_resume_flush_timer(struct vt_window *vw, int ms);
191void vt_suspend(struct vt_device *vd);
192
193/*
194 * Per-window terminal screen buffer.
195 *
196 * Because redrawing is performed asynchronously, the buffer keeps track
197 * of a rectangle that needs to be redrawn (vb_dirtyrect).  Because this
198 * approach seemed to cause suboptimal performance (when the top left
199 * and the bottom right of the screen are modified), it also uses a set
200 * of bitmasks to keep track of the rows and columns (mod 64) that have
201 * been modified.
202 */
203
204struct vt_buf {
205	struct mtx		 vb_lock;	/* Buffer lock. */
206	struct terminal		*vb_terminal;
207	term_pos_t		 vb_scr_size;	/* (b) Screen dimensions. */
208	int			 vb_flags;	/* (b) Flags. */
209#define	VBF_CURSOR	0x1	/* Cursor visible. */
210#define	VBF_STATIC	0x2	/* Buffer is statically allocated. */
211#define	VBF_MTX_INIT	0x4	/* Mutex initialized. */
212#define	VBF_SCROLL	0x8	/* scroll locked mode. */
213#define	VBF_HISTORY_FULL 0x10	/* All rows filled. */
214	unsigned int		 vb_history_size;
215	unsigned int		 vb_roffset;	/* (b) History rows offset. */
216	unsigned int		 vb_curroffset;	/* (b) Saved rows offset. */
217	term_pos_t		 vb_cursor;	/* (u) Cursor position. */
218	term_pos_t		 vb_mark_start;	/* (b) Copy region start. */
219	term_pos_t		 vb_mark_end;	/* (b) Copy region end. */
220	int			 vb_mark_last;	/* Last mouse event. */
221	term_rect_t		 vb_dirtyrect;	/* (b) Dirty rectangle. */
222	term_char_t		*vb_buffer;	/* (u) Data buffer. */
223	term_char_t		**vb_rows;	/* (u) Array of rows */
224};
225
226#ifdef SC_HISTORY_SIZE
227#define	VBF_DEFAULT_HISTORY_SIZE	SC_HISTORY_SIZE
228#else
229#define	VBF_DEFAULT_HISTORY_SIZE	500
230#endif
231
232void vtbuf_lock(struct vt_buf *);
233void vtbuf_unlock(struct vt_buf *);
234void vtbuf_copy(struct vt_buf *, const term_rect_t *, const term_pos_t *);
235void vtbuf_fill(struct vt_buf *, const term_rect_t *, term_char_t);
236void vtbuf_init_early(struct vt_buf *);
237void vtbuf_init(struct vt_buf *, const term_pos_t *);
238void vtbuf_grow(struct vt_buf *, const term_pos_t *, unsigned int);
239void vtbuf_putchar(struct vt_buf *, const term_pos_t *, term_char_t);
240void vtbuf_cursor_position(struct vt_buf *, const term_pos_t *);
241void vtbuf_scroll_mode(struct vt_buf *vb, int yes);
242void vtbuf_dirty(struct vt_buf *vb, const term_rect_t *area);
243void vtbuf_undirty(struct vt_buf *, term_rect_t *);
244void vtbuf_sethistory_size(struct vt_buf *, unsigned int);
245void vtbuf_clearhistory(struct vt_buf *);
246int vtbuf_iscursor(const struct vt_buf *vb, int row, int col);
247void vtbuf_cursor_visibility(struct vt_buf *, int);
248#ifndef SC_NO_CUTPASTE
249int vtbuf_set_mark(struct vt_buf *vb, int type, int col, int row);
250int vtbuf_get_marked_len(struct vt_buf *vb);
251void vtbuf_extract_marked(struct vt_buf *vb, term_char_t *buf, int sz, int mark);
252#endif
253
254#define	VTB_MARK_NONE		0
255#define	VTB_MARK_END		1
256#define	VTB_MARK_START		2
257#define	VTB_MARK_WORD		3
258#define	VTB_MARK_ROW		4
259#define	VTB_MARK_EXTEND		5
260#define	VTB_MARK_MOVE		6
261
262#define	VTBUF_SLCK_ENABLE(vb)	vtbuf_scroll_mode((vb), 1)
263#define	VTBUF_SLCK_DISABLE(vb)	vtbuf_scroll_mode((vb), 0)
264
265#define	VTBUF_MAX_HEIGHT(vb) \
266	((vb)->vb_history_size)
267#define	VTBUF_GET_ROW(vb, r) \
268	((vb)->vb_rows[((vb)->vb_roffset + (r)) % VTBUF_MAX_HEIGHT(vb)])
269#define	VTBUF_GET_FIELD(vb, r, c) \
270	((vb)->vb_rows[((vb)->vb_roffset + (r)) % VTBUF_MAX_HEIGHT(vb)][(c)])
271#define	VTBUF_FIELD(vb, r, c) \
272	((vb)->vb_rows[((vb)->vb_curroffset + (r)) % VTBUF_MAX_HEIGHT(vb)][(c)])
273#define	VTBUF_ISCURSOR(vb, r, c) \
274	vtbuf_iscursor((vb), (r), (c))
275#define	VTBUF_DIRTYROW(mask, row) \
276	((mask)->vbm_row & ((uint64_t)1 << ((row) % 64)))
277#define	VTBUF_DIRTYCOL(mask, col) \
278	((mask)->vbm_col & ((uint64_t)1 << ((col) % 64)))
279#define	VTBUF_SPACE_CHAR(attr)	(' ' | (attr))
280
281#define	VHS_SET	0
282#define	VHS_CUR	1
283#define	VHS_END	2
284int vthistory_seek(struct vt_buf *, int offset, int whence);
285void vthistory_addlines(struct vt_buf *vb, int offset);
286void vthistory_getpos(const struct vt_buf *, unsigned int *offset);
287
288/*
289 * Per-window datastructure.
290 */
291
292struct vt_window {
293	struct vt_device	*vw_device;	/* (c) Device. */
294	struct terminal		*vw_terminal;	/* (c) Terminal. */
295	struct vt_buf		 vw_buf;	/* (u) Screen buffer. */
296	struct vt_font		*vw_font;	/* (d) Graphical font. */
297	term_rect_t		 vw_draw_area;	/* (?) Drawable area. */
298	unsigned int		 vw_number;	/* (c) Window number. */
299	int			 vw_kbdmode;	/* (?) Keyboard mode. */
300	int			 vw_prev_kbdmode;/* (?) Previous mode. */
301	int			 vw_kbdstate;	/* (?) Keyboard state. */
302	int			 vw_grabbed;	/* (?) Grab count. */
303	char			*vw_kbdsq;	/* Escape sequence queue*/
304	unsigned int		 vw_flags;	/* (d) Per-window flags. */
305	int			 vw_mouse_level;/* Mouse op mode. */
306#define	VWF_BUSY	0x1	/* Busy reconfiguring device. */
307#define	VWF_OPENED	0x2	/* TTY in use. */
308#define	VWF_SCROLL	0x4	/* Keys influence scrollback. */
309#define	VWF_CONSOLE	0x8	/* Kernel message console window. */
310#define	VWF_VTYLOCK	0x10	/* Prevent window switch. */
311#define	VWF_MOUSE_HIDE	0x20	/* Disable mouse events processing. */
312#define	VWF_READY	0x40	/* Window fully initialized. */
313#define	VWF_GRAPHICS	0x80	/* Window in graphics mode (KDSETMODE). */
314#define	VWF_SWWAIT_REL	0x10000	/* Program wait for VT acquire is done. */
315#define	VWF_SWWAIT_ACQ	0x20000	/* Program wait for VT release is done. */
316	pid_t			 vw_pid;	/* Terminal holding process */
317	struct proc		*vw_proc;
318	struct vt_mode		 vw_smode;	/* switch mode */
319	struct timeout_task	 vw_timeout_task_dead;
320	struct vt_window	*vw_switch_to;
321	int			 vw_bell_pitch;	/* (?) Bell pitch */
322	sbintime_t		 vw_bell_duration; /* (?) Bell duration */
323};
324
325#define	VT_AUTO		0		/* switching is automatic */
326#define	VT_PROCESS	1		/* switching controlled by prog */
327#define	VT_KERNEL	255		/* switching controlled in kernel */
328
329#define	IS_VT_PROC_MODE(vw)	((vw)->vw_smode.mode == VT_PROCESS)
330
331/*
332 * Per-device driver routines.
333 */
334
335typedef int vd_init_t(struct vt_device *vd);
336typedef int vd_probe_t(struct vt_device *vd);
337typedef void vd_fini_t(struct vt_device *vd, void *softc);
338typedef void vd_postswitch_t(struct vt_device *vd);
339typedef void vd_blank_t(struct vt_device *vd, term_color_t color);
340typedef void vd_bitblt_text_t(struct vt_device *vd, const struct vt_window *vw,
341    const term_rect_t *area);
342typedef void vd_invalidate_text_t(struct vt_device *vd,
343    const term_rect_t *area);
344typedef void vd_bitblt_bmp_t(struct vt_device *vd, const struct vt_window *vw,
345    const uint8_t *pattern, const uint8_t *mask,
346    unsigned int width, unsigned int height,
347    unsigned int x, unsigned int y, term_color_t fg, term_color_t bg);
348typedef int vd_fb_ioctl_t(struct vt_device *, u_long, caddr_t, struct thread *);
349typedef int vd_fb_mmap_t(struct vt_device *, vm_ooffset_t, vm_paddr_t *, int,
350    vm_memattr_t *);
351typedef void vd_drawrect_t(struct vt_device *, int, int, int, int, int,
352    term_color_t);
353typedef void vd_setpixel_t(struct vt_device *, int, int, term_color_t);
354typedef void vd_suspend_t(struct vt_device *);
355typedef void vd_resume_t(struct vt_device *);
356
357struct vt_driver {
358	char		 vd_name[16];
359	/* Console attachment. */
360	vd_probe_t	*vd_probe;
361	vd_init_t	*vd_init;
362	vd_fini_t	*vd_fini;
363
364	/* Drawing. */
365	vd_blank_t	*vd_blank;
366	vd_drawrect_t	*vd_drawrect;
367	vd_setpixel_t	*vd_setpixel;
368	vd_bitblt_text_t *vd_bitblt_text;
369	vd_invalidate_text_t *vd_invalidate_text;
370	vd_bitblt_bmp_t	*vd_bitblt_bmp;
371
372	/* Framebuffer ioctls, if present. */
373	vd_fb_ioctl_t	*vd_fb_ioctl;
374
375	/* Framebuffer mmap, if present. */
376	vd_fb_mmap_t	*vd_fb_mmap;
377
378	/* Update display setting on vt switch. */
379	vd_postswitch_t	*vd_postswitch;
380
381	/* Suspend/resume handlers. */
382	vd_suspend_t	*vd_suspend;
383	vd_resume_t	*vd_resume;
384
385	/* Priority to know which one can override */
386	int		vd_priority;
387#define	VD_PRIORITY_DUMB	10
388#define	VD_PRIORITY_GENERIC	100
389#define	VD_PRIORITY_SPECIFIC	1000
390
391	/*
392	 * Should vd_bitblt_text() be called after unlocking vtbuf? If true,
393	 * characters are copied before vd_bitblt_bmp() is called.
394	 *
395	 * This is only valid when the default bitblt_text callback is used.
396	 */
397	bool		vd_bitblt_after_vtbuf_unlock;
398};
399
400/*
401 * Console device madness.
402 *
403 * Utility macro to make early vt(4) instances work.
404 */
405
406extern struct vt_device vt_consdev;
407void vt_upgrade(struct vt_device *vd);
408
409#define	PIXEL_WIDTH(w)	((w) / 8)
410#define	PIXEL_HEIGHT(h)	((h) / 16)
411
412#ifndef VT_FB_MAX_WIDTH
413#define	VT_FB_MAX_WIDTH	4096
414#endif
415#ifndef VT_FB_MAX_HEIGHT
416#define	VT_FB_MAX_HEIGHT	2400
417#endif
418
419/* name argument is not used yet. */
420#define VT_DRIVER_DECLARE(name, drv) DATA_SET(vt_drv_set, drv)
421
422#ifndef SC_NO_CUTPASTE
423struct vt_mouse_cursor {
424	uint8_t map[64 * 64 / 8];
425	uint8_t mask[64 * 64 / 8];
426	uint8_t width;
427	uint8_t height;
428};
429#endif
430
431const uint8_t	*vtfont_lookup(const struct vt_font *vf, term_char_t c);
432struct vt_font	*vtfont_ref(struct vt_font *vf);
433void		 vtfont_unref(struct vt_font *vf);
434int		 vtfont_load(vfnt_t *f, struct vt_font **ret);
435
436/* Sysmouse. */
437void sysmouse_process_event(mouse_info_t *mi);
438#ifndef SC_NO_CUTPASTE
439void vt_mouse_event(int type, int x, int y, int event, int cnt, int mlevel);
440void vt_mouse_state(int show);
441#endif
442#define	VT_MOUSE_SHOW 1
443#define	VT_MOUSE_HIDE 0
444
445/* Utilities. */
446void	vt_compute_drawable_area(struct vt_window *);
447void	vt_determine_colors(term_char_t c, int cursor,
448	    term_color_t *fg, term_color_t *bg);
449int	vt_is_cursor_in_area(const struct vt_device *vd,
450	    const term_rect_t *area);
451void	vt_termsize(struct vt_device *, struct vt_font *, term_pos_t *);
452void	vt_winsize(struct vt_device *, struct vt_font *, struct winsize *);
453
454/* Logos-on-boot. */
455#define	VT_LOGOS_DRAW_BEASTIE		0
456#define	VT_LOGOS_DRAW_ALT_BEASTIE	1
457#define	VT_LOGOS_DRAW_ORB		2
458
459extern int vt_draw_logo_cpus;
460extern int vt_splash_cpu;
461extern int vt_splash_ncpu;
462extern int vt_splash_cpu_style;
463extern int vt_splash_cpu_duration;
464
465extern const unsigned int vt_logo_sprite_height;
466extern const unsigned int vt_logo_sprite_width;
467
468void vtterm_draw_cpu_logos(struct vt_device *);
469
470#endif /* !_DEV_VT_VT_H_ */
471