1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
|
/*
*
* # #
* ## # #### ##### # #### ######
* # # # # # # # # # #
* # # # # # # # # #####
* # # # # # # # # #
* # ## # # # # # # #
* # # #### # # #### ######
*
* Now that it's P3 instead of P1 you are allowed
* to edit this file if it suits you.
*
* Please delete this notice.
*
*/
/** @file pts.h
*
* @brief console and keyboard functions.
*
* @author Hanjie Wu (hanjiew)
* @bug No functional bugs
*/
#ifndef _PTS_H
#define _PTS_H
#include <stdbool.h>
#include <stddef.h>
#include <stdint.h>
#include <string.h>
#include <x86/asm.h>
#include <x86/interrupt_defines.h>
#include <x86/keyhelp.h>
#include <x86/video_defines.h>
#include <pv.h>
#include <sync.h>
/**
* Someone is not satisfied with the type name char_t so we use this
* to reperesent a char on screen so that nobody will mistake it with 'char'
*/
typedef struct a_char_on_screen_s {
uint8_t ch; /** char */
uint8_t color; /** color */
} a_char_on_screen_t;
/** a node in queue of threads requesting keyboard access */
typedef struct kbd_request_s {
thread_t* t;
queue_t node;
} kbd_request_t;
/** size of scancode ring buffer, a big buffer enough for someone pressing
* keyboard fast */
#define KH_RING_SIZE PAGE_SIZE
/** size of character ring buffer, a big buffer enough for someone pressing
* keyboard fast */
#define CHR_RING_SIZE PAGE_SIZE
/** maximum readline size */
#define MAX_READLINE (CHR_RING_SIZE - 1)
typedef struct pts_s {
queue_t pts_link;
queue_t* pvs;
int refcount;
mutex_t lock;
a_char_on_screen_t mem[CONSOLE_HEIGHT][CONSOLE_WIDTH];
int cur_x;
int cur_y;
char cur_color;
int cur_shown;
queue_t* reqs;
mutex_t kbd_request_lock;
cv_t kbd_request_cv;
mutex_t input_lock;
cv_t input_cv;
unsigned char kh_ring[KH_RING_SIZE];
int kh_r_pos;
int kh_w_pos;
char chr_ring[CHR_RING_SIZE];
int chr_r_pos;
int chr_w_pos;
int forward_tab;
} pts_t;
extern pts_t* active_pts;
extern spl_t pts_lock;
void setup_pts();
void pts_init(pts_t* pts);
int putbyte(char ch);
/** @brief Prints character ch at the current location
* of the cursor.
*
* If the character is a newline ('\n'), the cursor is
* be moved to the beginning of the next line (scrolling if necessary). If
* the character is a carriage return ('\r'), the cursor
* is immediately reset to the beginning of the current
* line, causing any future output to overwrite any existing
* output on the line. If backsapce ('\b') is encountered,
* the previous character is erased. See the main console.c description
* for more backspace behavior.
*
* @param ch the character to print
* @return The input character
*/
int pts_putbyte(pts_t* pts, char ch);
/** @brief Prints the string s, starting at the current
* location of the cursor.
*
* If the string is longer than the current line, the
* string fills up the current line and then
* continues on the next line. If the string exceeds
* available space on the entire console, the screen
* scrolls up one line, and then the string
* continues on the new line. If '\n', '\r', and '\b' are
* encountered within the string, they are handled
* as per putbyte. If len is not a positive integer or s
* is null, the function has no effect.
*
* @param s The string to be printed.
* @param len The length of the string s.
* @return Void.
*/
void pts_putbytes(pts_t* pts, const char* s, int len);
/** @brief Changes the foreground and background color
* of future characters printed on the console.
*
* If the color code is invalid, the function has no effect.
*
* @param color The new color code.
* @return 0 on success or integer error code less than 0 if
* color code is invalid.
*/
int pts_set_term_color(pts_t* pts, int color);
/** @brief Writes the current foreground and background
* color of characters printed on the console
* into the argument color.
* @param color The address to which the current color
* information will be written.
* @return Void.
*/
void pts_get_term_color(pts_t* pts, int* color);
/** @brief Sets the position of the cursor to the
* position (row, col).
*
* Subsequent calls to putbytes should cause the console
* output to begin at the new position. If the cursor is
* currently hidden, a call to set_cursor() does not show
* the cursor.
*
* @param row The new row for the cursor.
* @param col The new column for the cursor.
* @return 0 on success or integer error code less than 0 if
* cursor location is invalid.
*/
int pts_set_cursor(pts_t* pts, int row, int col);
/** @brief Writes the current position of the cursor
* into the arguments row and col.
* @param row The address to which the current cursor
* row will be written.
* @param col The address to which the current cursor
* column will be written.
* @return Void.
*/
void pts_get_cursor(pts_t* pts, int* row, int* col);
int pts_print_at(pts_t* pts, int len, va_t buf, int row, int col, int color);
/**
* @brief read a line to userspace
* @param len max length to read
* @param buf buffer
* @return size on success, -1 on failure
*/
int do_readline(int len, va_t buf);
/**
* @brief read a char
* @return char read
*/
int do_getchar();
void switch_pts(pts_t* pts);
#endif /* _PTS_H */
|
