1 /* Project 16 Source Code~
\r
2 * Copyright (C) 2012-2022 sparky4 & pngwen & andrius4669 & joncampbell123 & yakui-lover
\r
4 * This file is part of Project 16.
\r
6 * Project 16 is free software; you can redistribute it and/or modify
\r
7 * it under the terms of the GNU General Public License as published by
\r
8 * the Free Software Foundation; either version 3 of the License, or
\r
9 * (at your option) any later version.
\r
11 * Project 16 is distributed in the hope that it will be useful,
\r
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
\r
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
\r
14 * GNU General Public License for more details.
\r
16 * You should have received a copy of the GNU General Public License
\r
17 * along with this program. If not, see <http://www.gnu.org/licenses/>, or
\r
18 * write to the Free Software Foundation, Inc., 51 Franklin Street,
\r
19 * Fifth Floor, Boston, MA 02110-1301 USA.
\r
23 #include "src/lib/16_dbg.h"
\r
25 // TODO: Could we also provide a build mode to emit debug to the "Bochs E9 hack?"
\r
27 # include <stdarg.h>
\r
28 # include <stdlib.h>
\r
31 unsigned char _DEBUG_INITed = 0;
\r
32 struct info_8250 *_DEBUG_uart = NULL;
\r
35 if (!_DEBUG_INITed) {
\r
39 if (!init_8250()) return 0;
\r
41 // what does the BIOS say the serial ports are?
\r
42 probe_8250_bios_ports();
\r
43 for (i=0;i < bios_8250_ports;i++) {
\r
44 port = get_8250_bios_port(i);
\r
45 if (port == 0) continue;
\r
49 // what about the standard serial ports?
\r
50 for (i=0;i < (sizeof(standard_8250_ports)/sizeof(standard_8250_ports[0]));i++) {
\r
51 port = standard_8250_ports[i];
\r
52 if (port == 0) continue;
\r
56 // pick the first port, which is probably COM1
\r
57 if (base_8250_ports == 0) return 0; // FIXME: You know "base_8250_ports" is probably a bad variable name for the max entries in info_8250_port[]
\r
58 _DEBUG_uart = &info_8250_port[0];
\r
61 // init the COM port.
\r
62 // in DOSBox-X, the "log" mode will receive our text and print it into the log file
\r
63 // on real hardware, our text will likely go over a null modem cable to another PC running a serial terminal program like PuTTY or minicom.
\r
64 // if nothing is connected, then the bytes go off into the ether to get lost and life goes on.
\r
65 uart_8250_enable_interrupt(_DEBUG_uart,0); // disable interrupts
\r
66 uart_8250_set_FIFO(_DEBUG_uart,0x07); // enable FIFO (why not?), also clear xmit/recv FIFO buffers, set threshhold to 1 byte
\r
67 uart_8250_set_MCR(_DEBUG_uart,3); // RTS and DTS on
\r
68 uart_8250_set_line_control(_DEBUG_uart,UART_8250_LCR_8BIT | UART_8250_LCR_PARITY); // 8 bit 1 stop bit odd parity
\r
69 uart_8250_set_baudrate(_DEBUG_uart,uart_8250_baud_to_divisor(_DEBUG_uart,9600)); // 9600 baud
\r
72 return _DEBUG_INITed;
\r
75 void _DEBUG(const char *msg) {
\r
76 if (_DEBUG_uart != NULL) {
\r
79 while ((c=(*msg++)) != 0/*NUL*/) {
\r
80 while (!uart_8250_can_write(_DEBUG_uart)); // wait for the UART to indicate readiness for our output
\r
81 uart_8250_write(_DEBUG_uart,(uint8_t)c); // then write it
\r
86 static char _DEBUGF_TMP[256];
\r
88 void _DEBUGF(const char *fmt,...) {
\r
92 vsnprintf(_DEBUGF_TMP,sizeof(_DEBUGF_TMP),fmt,va);
\r
93 _DEBUG(_DEBUGF_TMP);
\r