kdserial.c File Reference

#include <ntoskrnl.h>
#include <debug.h>

Include dependency graph for kdserial.c:

Go to the source code of this file.

Macros
#define	NDEBUG
#define	DEFAULT_BAUD_RATE   19200
#define	MAX_COM_PORTS   (sizeof(BaseArray) / sizeof(BaseArray[0]) - 1)

Functions
BOOLEAN NTAPI	KdPortInitializeEx (IN PCPPORT PortInformation, IN ULONG ComPortNumber)
BOOLEAN NTAPI	KdPortGetByteEx (IN PCPPORT PortInformation, OUT PUCHAR ByteReceived)
VOID NTAPI	KdPortPutByteEx (IN PCPPORT PortInformation, IN UCHAR ByteToSend)

Macro Definition Documentation

DEFAULT_BAUD_RATE

#define DEFAULT_BAUD_RATE   19200

Definition at line 19 of file kdserial.c.

MAX_COM_PORTS

#define MAX_COM_PORTS   (sizeof(BaseArray) / sizeof(BaseArray[0]) - 1)

Definition at line 38 of file kdserial.c.

NDEBUG

#define NDEBUG

Definition at line 13 of file kdserial.c.

Function Documentation

KdPortGetByteEx()

BOOLEAN NTAPI KdPortGetByteEx	(	IN PCPPORT	PortInformation,
		OUT PUCHAR	ByteReceived
	)

Definition at line 137 of file kdserial.c.

{
    return (CpGetByte(PortInformation, ByteReceived, FALSE, FALSE) == CP_GET_SUCCESS);
}

KdPortInitializeEx()

BOOLEAN NTAPI KdPortInitializeEx	(	IN PCPPORT	PortInformation,
		IN ULONG	ComPortNumber
	)

Definition at line 51 of file kdserial.c.

{
    NTSTATUS Status;
 
#if 0 // Deactivated because never used in fact (was in KdPortInitialize but we use KdPortInitializeEx)
    /*
     * Find the port if needed
     */
 
    if (!PortInitialized)
    {
        DefaultPort.BaudRate = PortInformation->BaudRate;
 
        if (ComPortNumber == 0)
        {
            /*
             * Start enumerating COM ports from the last one to the first one,
             * and break when we find a valid port.
             * If we reach the first element of the list, the invalid COM port,
             * then it means that no valid port was found.
             */
            for (ComPortNumber = MAX_COM_PORTS; ComPortNumber > 0; ComPortNumber--)
            {
                if (CpDoesPortExist(UlongToPtr(BaseArray[ComPortNumber])))
                {
                    PortInformation->Address = DefaultPort.Address = BaseArray[ComPortNumber];
                    break;
                }
            }
            if (ComPortNumber == 0)
            {
                HalDisplayString("\r\nKernel Debugger: No COM port found!\r\n\r\n");
                return FALSE;
            }
        }
 
        PortInitialized = TRUE;
    }
#endif
 
    /*
     * Initialize the port
     */
    Status = CpInitialize(PortInformation,
                          (ComPortNumber == 0 ? PortInformation->Address
                                              : UlongToPtr(BaseArray[ComPortNumber])),
                          (PortInformation->BaudRate == 0 ? DEFAULT_BAUD_RATE
                                                          : PortInformation->BaudRate));
    if (!NT_SUCCESS(Status))
    {
        HalDisplayString("\r\nKernel Debugger: Serial port not found!\r\n\r\n");
        return FALSE;
    }
    else
    {
#ifndef NDEBUG
        int Length;
        CHAR Buffer[82];
 
        /* Print message to blue screen */
        Length = snprintf(Buffer, sizeof(Buffer),
                          "\r\nKernel Debugger: Serial port found: COM%ld (Port 0x%p) BaudRate %ld\r\n\r\n",
                          ComPortNumber,
                          PortInformation->Address,
                          PortInformation->BaudRate);
        if (Length == -1)
        {
            /* Terminate it if we went over-board */
            Buffer[sizeof(Buffer) - 1] = ANSI_NULL;
        }
 
        HalDisplayString(Buffer);
#endif /* NDEBUG */
 
#if 0
        /* Set global info */
        KdComPortInUse = DefaultPort.Address;
#endif
        return TRUE;
    }
}

KdPortPutByteEx()

VOID NTAPI KdPortPutByteEx	(	IN PCPPORT	PortInformation,
		IN UCHAR	ByteToSend
	)

Definition at line 146 of file kdserial.c.

{
    CpPutByte(PortInformation, ByteToSend);
}