xref: /xnu-8792.61.2/osfmk/console/serial_protos.h (revision 42e220869062b56f8d7d0726fd4c88954f87902c)
1*42e22086SApple OSS Distributions /*
2*42e22086SApple OSS Distributions  * Copyright (c) 2005-2020 Apple Computer, Inc. All rights reserved.
3*42e22086SApple OSS Distributions  *
4*42e22086SApple OSS Distributions  * @APPLE_OSREFERENCE_LICENSE_HEADER_START@
5*42e22086SApple OSS Distributions  *
6*42e22086SApple OSS Distributions  * This file contains Original Code and/or Modifications of Original Code
7*42e22086SApple OSS Distributions  * as defined in and that are subject to the Apple Public Source License
8*42e22086SApple OSS Distributions  * Version 2.0 (the 'License'). You may not use this file except in
9*42e22086SApple OSS Distributions  * compliance with the License. The rights granted to you under the License
10*42e22086SApple OSS Distributions  * may not be used to create, or enable the creation or redistribution of,
11*42e22086SApple OSS Distributions  * unlawful or unlicensed copies of an Apple operating system, or to
12*42e22086SApple OSS Distributions  * circumvent, violate, or enable the circumvention or violation of, any
13*42e22086SApple OSS Distributions  * terms of an Apple operating system software license agreement.
14*42e22086SApple OSS Distributions  *
15*42e22086SApple OSS Distributions  * Please obtain a copy of the License at
16*42e22086SApple OSS Distributions  * http://www.opensource.apple.com/apsl/ and read it before using this file.
17*42e22086SApple OSS Distributions  *
18*42e22086SApple OSS Distributions  * The Original Code and all software distributed under the License are
19*42e22086SApple OSS Distributions  * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
20*42e22086SApple OSS Distributions  * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
21*42e22086SApple OSS Distributions  * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
22*42e22086SApple OSS Distributions  * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
23*42e22086SApple OSS Distributions  * Please see the License for the specific language governing rights and
24*42e22086SApple OSS Distributions  * limitations under the License.
25*42e22086SApple OSS Distributions  *
26*42e22086SApple OSS Distributions  * @APPLE_OSREFERENCE_LICENSE_HEADER_END@
27*42e22086SApple OSS Distributions  */
28*42e22086SApple OSS Distributions /*
29*42e22086SApple OSS Distributions  * @OSF_COPYRIGHT@
30*42e22086SApple OSS Distributions  */
31*42e22086SApple OSS Distributions /*
32*42e22086SApple OSS Distributions  * @APPLE_FREE_COPYRIGHT@
33*42e22086SApple OSS Distributions  */
34*42e22086SApple OSS Distributions 
35*42e22086SApple OSS Distributions #ifndef _CONSOLE_SERIAL_PROTOS_H_
36*42e22086SApple OSS Distributions #define _CONSOLE_SERIAL_PROTOS_H_
37*42e22086SApple OSS Distributions 
38*42e22086SApple OSS Distributions #ifdef __cplusplus
39*42e22086SApple OSS Distributions extern "C" {
40*42e22086SApple OSS Distributions #endif
41*42e22086SApple OSS Distributions 
42*42e22086SApple OSS Distributions #include <stdbool.h>
43*42e22086SApple OSS Distributions 
44*42e22086SApple OSS Distributions void serial_keyboard_init(void);
45*42e22086SApple OSS Distributions void serial_keyboard_start(void) __dead2;
46*42e22086SApple OSS Distributions void serial_keyboard_poll(void) __dead2;
47*42e22086SApple OSS Distributions 
48*42e22086SApple OSS Distributions extern uint32_t serialmode;
49*42e22086SApple OSS Distributions 
50*42e22086SApple OSS Distributions #define SERIALMODE_OUTPUT    0x01
51*42e22086SApple OSS Distributions #define SERIALMODE_INPUT     0x02
52*42e22086SApple OSS Distributions #define SERIALMODE_SYNCDRAIN 0x04
53*42e22086SApple OSS Distributions #define SERIALMODE_BASE_TTY  0x08 /* Load Base/Recovery/FVUnlock TTY */
54*42e22086SApple OSS Distributions #define SERIALMODE_NO_IOLOG  0x10 /* prevent IOLogs writing to serial */
55*42e22086SApple OSS Distributions #define SERIALMODE_DKLOG     0x20 /* allow DriverKit os_log/IOLogs writing to serial */
56*42e22086SApple OSS Distributions 
57*42e22086SApple OSS Distributions extern uint32_t cons_ops_index;
58*42e22086SApple OSS Distributions extern const uint32_t nconsops;
59*42e22086SApple OSS Distributions extern bool disable_serial_output;
60*42e22086SApple OSS Distributions extern bool disable_iolog_serial_output;
61*42e22086SApple OSS Distributions extern bool enable_dklog_serial_output;
62*42e22086SApple OSS Distributions 
63*42e22086SApple OSS Distributions void console_init(void);
64*42e22086SApple OSS Distributions 
65*42e22086SApple OSS Distributions int _serial_getc(bool wait);
66*42e22086SApple OSS Distributions int _vcgetc(bool wait);
67*42e22086SApple OSS Distributions 
68*42e22086SApple OSS Distributions struct console_ops {
69*42e22086SApple OSS Distributions 	void (*putc)(char, bool);
70*42e22086SApple OSS Distributions 	int (*getc)(bool);
71*42e22086SApple OSS Distributions };
72*42e22086SApple OSS Distributions 
73*42e22086SApple OSS Distributions boolean_t console_is_serial(void);
74*42e22086SApple OSS Distributions int switch_to_serial_console(void);
75*42e22086SApple OSS Distributions int switch_to_video_console(void);
76*42e22086SApple OSS Distributions void switch_to_old_console(int old_console);
77*42e22086SApple OSS Distributions 
78*42e22086SApple OSS Distributions #define SERIAL_CONS_OPS 0
79*42e22086SApple OSS Distributions #define VC_CONS_OPS 1
80*42e22086SApple OSS Distributions 
81*42e22086SApple OSS Distributions #ifdef XNU_KERNEL_PRIVATE
82*42e22086SApple OSS Distributions 
83*42e22086SApple OSS Distributions #define SERIAL_CONS_BUF_SIZE  256
84*42e22086SApple OSS Distributions struct console_printbuf_state {
85*42e22086SApple OSS Distributions 	int pos;
86*42e22086SApple OSS Distributions 	int total;
87*42e22086SApple OSS Distributions 	int flags;
88*42e22086SApple OSS Distributions #define CONS_PB_WRITE_NEWLINE  0x1
89*42e22086SApple OSS Distributions #define CONS_PB_CANBLOCK       0x2
90*42e22086SApple OSS Distributions 	char str[SERIAL_CONS_BUF_SIZE];
91*42e22086SApple OSS Distributions };
92*42e22086SApple OSS Distributions 
93*42e22086SApple OSS Distributions extern int console_printbuf_drain_initialized;
94*42e22086SApple OSS Distributions void console_printbuf_state_init(struct console_printbuf_state * data, int write_on_newline, int can_block);
95*42e22086SApple OSS Distributions void console_printbuf_putc(int ch, void *arg);
96*42e22086SApple OSS Distributions void console_printbuf_clear(struct console_printbuf_state * info);
97*42e22086SApple OSS Distributions int console_write_try(char * str, int size);
98*42e22086SApple OSS Distributions 
99*42e22086SApple OSS Distributions 
100*42e22086SApple OSS Distributions #endif /* XNU_KERNEL_PRIVATE */
101*42e22086SApple OSS Distributions 
102*42e22086SApple OSS Distributions #ifdef __cplusplus
103*42e22086SApple OSS Distributions }
104*42e22086SApple OSS Distributions #endif
105*42e22086SApple OSS Distributions 
106*42e22086SApple OSS Distributions 
107*42e22086SApple OSS Distributions #endif /* _CONSOLE_SERIAL_PROTOS_H_ */
108