kdserial.c File Reference

#include <ntoskrnl.h>
#include <debug.h>
#include <cportlib/uartinfo.h>

Include dependency graph for kdserial.c:

Go to the source code of this file.

Macros
#define	NDEBUG

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

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 115 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 30 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)
        {
            /*
             * Enumerate COM ports from the last to the first one, and stop
             * when we find a valid port. If we reach the first list element
             * (the undefined COM port), 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 serial 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_DEBUG_BAUD_RATE
                                                          : PortInformation->BaudRate));
    if (!NT_SUCCESS(Status))
    {
        HalDisplayString("\r\nKernel Debugger: Serial port not available\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: Using COM%lu (Port 0x%p) BaudRate %lu\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 124 of file kdserial.c.

{
    CpPutByte(PortInformation, ByteToSend);
}