blob: 2c242d017e43a8e8828a52e5547136c68f61bedf (
plain)
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
|
/*
* Copyright (c) 2017 Richard Braun.
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program. If not, see <http://www.gnu.org/licenses/>.
*
*
* Device-independent console interface.
*/
#ifndef KERN_CONSOLE_H
#define KERN_CONSOLE_H
#include <kern/cbuf.h>
#include <kern/init.h>
#include <kern/list.h>
#include <kern/spinlock.h>
#include <kern/thread.h>
#define CONSOLE_SCROLL_UP 0x12 /* DC2 */
#define CONSOLE_SCROLL_DOWN 0x14 /* DC4 */
struct console;
struct console_ops {
void (*putc)(struct console *console, char c);
};
#define CONSOLE_BUF_SIZE 64
#define CONSOLE_NAME_SIZE 16
/*
* Console device.
*
* This structure should be embedded in the hardware-specific console
* objects. Calls to console operations are all serialized by this module
* for each device. Interrupts are disabled when calling operations.
*/
struct console {
struct spinlock lock;
const struct console_ops *ops;
char buffer[CONSOLE_BUF_SIZE];
struct cbuf recvbuf;
struct thread *waiter;
struct list node;
char name[CONSOLE_NAME_SIZE];
};
/*
* Console initialization.
*/
void console_init(struct console *console, const char *name,
const struct console_ops *ops);
/*
* Register a console device.
*
* The given console must be initialized before calling this function.
*
* This function isn't thread-safe and can only be called during system
* initialization.
*/
void console_register(struct console *console);
/*
* Console interrupt handler.
*
* This function is meant to be used by low-level drivers to fill the
* receive buffer.
*
* Interrupts must be disabled when calling this function.
*/
void console_intr(struct console *console, const char *s);
/*
* Write/read a single character to all registered console devices.
*
* Writing may not block in order to allow printf functions to be used in any
* context. Reading may block waiting for input.
*/
void console_putchar(char c);
char console_getchar(void);
/*
* This init operation provides :
* - registration of consoles
*/
INIT_OP_DECLARE(console_bootstrap);
/*
* This init operation provides :
* - all consoles have been registered
* - module fully initialized
*/
INIT_OP_DECLARE(console_setup);
#endif /* KERN_CONSOLE_H */
|