1#ifndef QEMU_CHAR_H
2#define QEMU_CHAR_H
3
4#include "qemu-common.h"
5#include "qemu/queue.h"
6#include "qemu/option.h"
7#include "qemu/config-file.h"
8#include "qapi/qmp/qobject.h"
9#include "qapi/qmp/qstring.h"
10
11/* character device */
12
13#define CHR_EVENT_BREAK   0 /* serial break char */
14#define CHR_EVENT_FOCUS   1 /* focus to this terminal (modal input needed) */
15#define CHR_EVENT_OPENED  2 /* new connection established */
16#define CHR_EVENT_MUX_IN  3 /* mux-focus was set to this terminal */
17#define CHR_EVENT_MUX_OUT 4 /* mux-focus will move on */
18#define CHR_EVENT_CLOSED  5 /* connection closed */
19
20
21#define CHR_IOCTL_SERIAL_SET_PARAMS   1
22typedef struct {
23    int speed;
24    int parity;
25    int data_bits;
26    int stop_bits;
27} QEMUSerialSetParams;
28
29#define CHR_IOCTL_SERIAL_SET_BREAK    2
30
31#define CHR_IOCTL_PP_READ_DATA        3
32#define CHR_IOCTL_PP_WRITE_DATA       4
33#define CHR_IOCTL_PP_READ_CONTROL     5
34#define CHR_IOCTL_PP_WRITE_CONTROL    6
35#define CHR_IOCTL_PP_READ_STATUS      7
36#define CHR_IOCTL_PP_EPP_READ_ADDR    8
37#define CHR_IOCTL_PP_EPP_READ         9
38#define CHR_IOCTL_PP_EPP_WRITE_ADDR  10
39#define CHR_IOCTL_PP_EPP_WRITE       11
40#define CHR_IOCTL_PP_DATA_DIR        12
41
42#define CHR_IOCTL_SERIAL_SET_TIOCM   13
43#define CHR_IOCTL_SERIAL_GET_TIOCM   14
44
45#define CHR_TIOCM_CTS	0x020
46#define CHR_TIOCM_CAR	0x040
47#define CHR_TIOCM_DSR	0x100
48#define CHR_TIOCM_RI	0x080
49#define CHR_TIOCM_DTR	0x002
50#define CHR_TIOCM_RTS	0x004
51
52typedef void IOEventHandler(void *opaque, int event);
53
54struct CharDriverState {
55    void (*init)(struct CharDriverState *s);
56    int (*chr_write)(struct CharDriverState *s, const uint8_t *buf, int len);
57    void (*chr_update_read_handler)(struct CharDriverState *s);
58    int (*chr_ioctl)(struct CharDriverState *s, int cmd, void *arg);
59    int (*get_msgfd)(struct CharDriverState *s);
60    IOEventHandler *chr_event;
61    IOCanReadHandler *chr_can_read;
62    IOReadHandler *chr_read;
63    void *handler_opaque;
64    void (*chr_send_event)(struct CharDriverState *chr, int event);
65    void (*chr_close)(struct CharDriverState *chr);
66    void (*chr_accept_input)(struct CharDriverState *chr);
67    void (*chr_set_echo)(struct CharDriverState *chr, bool echo);
68    void (*chr_guest_open)(struct CharDriverState *chr);
69    void (*chr_guest_close)(struct CharDriverState *chr);
70    void *opaque;
71    QEMUBH *bh;
72    char *label;
73    char *filename;
74    int opened;
75    int avail_connections;
76    QTAILQ_ENTRY(CharDriverState) next;
77};
78
79QemuOpts *qemu_chr_parse_compat(const char *label, const char *filename);
80CharDriverState *qemu_chr_open_opts(QemuOpts *opts,
81                                    void (*init)(struct CharDriverState *s));
82CharDriverState *qemu_chr_open(const char *label, const char *filename, void (*init)(struct CharDriverState *s));
83void qemu_chr_set_echo(struct CharDriverState *chr, bool echo);
84void qemu_chr_guest_open(struct CharDriverState *chr);
85void qemu_chr_guest_close(struct CharDriverState *chr);
86void qemu_chr_close(CharDriverState *chr);
87void qemu_chr_printf(CharDriverState *s, const char *fmt, ...)
88    GCC_FMT_ATTR(2, 3);
89int qemu_chr_write(CharDriverState *s, const uint8_t *buf, int len);
90void qemu_chr_send_event(CharDriverState *s, int event);
91void qemu_chr_add_handlers(CharDriverState *s,
92                           IOCanReadHandler *fd_can_read,
93                           IOReadHandler *fd_read,
94                           IOEventHandler *fd_event,
95                           void *opaque);
96int qemu_chr_ioctl(CharDriverState *s, int cmd, void *arg);
97void qemu_chr_initial_reset(void);
98void qemu_chr_generic_open(CharDriverState *s);
99int qemu_chr_can_read(CharDriverState *s);
100void qemu_chr_read(CharDriverState *s, uint8_t *buf, int len);
101int qemu_chr_get_msgfd(CharDriverState *s);
102void qemu_chr_accept_input(CharDriverState *s);
103void qemu_chr_info_print(Monitor *mon, const QObject *ret_data);
104void qemu_chr_info(Monitor *mon, QObject **ret_data);
105CharDriverState *qemu_chr_find(const char *name);
106
107/* add an eventfd to the qemu devices that are polled */
108CharDriverState *qemu_chr_open_eventfd(int eventfd);
109
110extern int term_escape_char;
111
112/* memory chardev */
113void qemu_chr_init_mem(CharDriverState *chr);
114void qemu_chr_close_mem(CharDriverState *chr);
115QString *qemu_chr_mem_to_qs(CharDriverState *chr);
116size_t qemu_chr_mem_osize(const CharDriverState *chr);
117
118/* async I/O support */
119
120int qemu_set_fd_handler2(int fd,
121                         IOCanReadHandler *fd_read_poll,
122                         IOHandler *fd_read,
123                         IOHandler *fd_write,
124                         void *opaque);
125int qemu_set_fd_handler(int fd,
126                        IOHandler *fd_read,
127                        IOHandler *fd_write,
128                        void *opaque);
129#endif
130