src/lib/16_dbg.c

   1 \r
   2 #include "src/16.h"\r
   3 \r
   4 // TODO: Could we also provide a build mode to emit debug to the "Bochs E9 hack?"\r
   5 #ifdef DEBUGSERIAL\r
   6 # include <stdarg.h>\r
   7 # include <stdlib.h>\r
   8 # include <stdio.h>\r
   9 \r
  10 unsigned char _DEBUG_INITed = 0;\r
  11 struct info_8250 *_DEBUG_uart = NULL;\r
  12 \r
  13 int _DEBUG_INIT() {\r
  14         if (!_DEBUG_INITed) {\r
  15                 unsigned int i;\r
  16                 uint16_t port;\r
  17 \r
  18                 if (!init_8250()) return 0;\r
  19 \r
  20                 // what does the BIOS say the serial ports are?\r
  21                 probe_8250_bios_ports();\r
  22                 for (i=0;i < bios_8250_ports;i++) {\r
  23                         port = get_8250_bios_port(i);\r
  24                         if (port == 0) continue;\r
  25                         probe_8250(port);\r
  26                 }\r
  27 \r
  28                 // what about the standard serial ports?\r
  29                 for (i=0;i < (sizeof(standard_8250_ports)/sizeof(standard_8250_ports[0]));i++) {\r
  30                         port = standard_8250_ports[i];\r
  31                         if (port == 0) continue;\r
  32                         probe_8250(port);\r
  33                 }\r
  34 \r
  35                 // pick the first port, which is probably COM1\r
  36                 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
  37                 _DEBUG_uart = &info_8250_port[0];\r
  38                 _DEBUG_INITed = 1;\r
  39 \r
  40                 // init the COM port.\r
  41                 // in DOSBox-X, the "log" mode will receive our text and print it into the log file\r
  42                 // 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
  43                 // if nothing is connected, then the bytes go off into the ether to get lost and life goes on.\r
  44                 uart_8250_enable_interrupt(_DEBUG_uart,0);      // disable interrupts\r
  45                 uart_8250_set_FIFO(_DEBUG_uart,0x07);           // enable FIFO (why not?), also clear xmit/recv FIFO buffers, set threshhold to 1 byte\r
  46                 uart_8250_set_MCR(_DEBUG_uart,3);               // RTS and DTS on\r
  47                 uart_8250_set_line_control(_DEBUG_uart,UART_8250_LCR_8BIT | UART_8250_LCR_PARITY); // 8 bit 1 stop bit odd parity\r
  48                 uart_8250_set_baudrate(_DEBUG_uart,uart_8250_baud_to_divisor(_DEBUG_uart,9600)); // 9600 baud\r
  49         }\r
  50 \r
  51         return _DEBUG_INITed;\r
  52 }\r
  53 \r
  54 void _DEBUG(const char *msg) {\r
  55         if (_DEBUG_uart != NULL) {\r
  56                 char c;\r
  57 \r
  58                 while ((c=(*msg++)) != 0/*NUL*/) {\r
  59                         while (!uart_8250_can_write(_DEBUG_uart)); // wait for the UART to indicate readiness for our output\r
  60                         uart_8250_write(_DEBUG_uart,(uint8_t)c); // then write it\r
  61                 }\r
  62         }\r
  63 }\r
  64 \r
  65 static char _DEBUGF_TMP[256];\r
  66 \r
  67 void _DEBUGF(const char *fmt,...) {\r
  68         va_list va;\r
  69 \r
  70         va_start(va,fmt);\r
  71         vsnprintf(_DEBUGF_TMP,sizeof(_DEBUGF_TMP),fmt,va);\r
  72         _DEBUG(_DEBUGF_TMP);\r
  73         va_end(va);\r
  74 }\r
  75 #endif\r
  76 \r