#include "kddll.h"
#include <arc/arc.h>
#include <stdlib.h>
#include <ndk/halfuncs.h>
#include <cportlib/cportlib.h>
#include <cportlib/uartinfo.h>

Include dependency graph for kdcom.c:

Macros
#define	CONST_STR_LEN(x) (sizeof(x)/sizeof(x[0]) - 1)

Functions
NTSTATUS NTAPI	KdD0Transition (VOID)

NTSTATUS NTAPI	KdD3Transition (VOID)

NTSTATUS NTAPI	KdSave (IN BOOLEAN SleepTransition)

NTSTATUS NTAPI	KdRestore (IN BOOLEAN SleepTransition)

NTSTATUS NTAPI	KdpPortInitialize (_In_ PUCHAR PortAddress, _In_ ULONG BaudRate)

NTSTATUS NTAPI	KdDebuggerInitialize0 (IN PLOADER_PARAMETER_BLOCK LoaderBlock OPTIONAL)

NTSTATUS NTAPI	KdDebuggerInitialize1 (IN PLOADER_PARAMETER_BLOCK LoaderBlock OPTIONAL)

VOID NTAPI	KdpSendByte (IN UCHAR Byte)

KDP_STATUS NTAPI	KdpPollByte (OUT PUCHAR OutByte)

KDP_STATUS NTAPI	KdpReceiveByte (OUT PUCHAR OutByte)

KDP_STATUS NTAPI	KdpPollBreakIn (VOID)

Variables
CPPORT	KdComPort

Macro Definition Documentation

◆ CONST_STR_LEN

#define CONST_STR_LEN ( x ) (sizeof(x)/sizeof(x[0]) - 1)

Function Documentation

◆ KdD0Transition()

NTSTATUS NTAPI KdD0Transition ( VOID )

Definition at line 67 of file kdcom.c.

{
    return STATUS_SUCCESS;
}

Referenced by KdPowerTransition().

◆ KdD3Transition()

NTSTATUS NTAPI KdD3Transition ( VOID )

Definition at line 74 of file kdcom.c.

{
    return STATUS_SUCCESS;
}

Referenced by KdPowerTransition().

◆ KdDebuggerInitialize0()

NTSTATUS NTAPI KdDebuggerInitialize0 ( IN PLOADER_PARAMETER_BLOCK LoaderBlock OPTIONAL )

Definition at line 119 of file kdcom.c.

{
#define CONST_STR_LEN(x) (sizeof(x)/sizeof(x[0]) - 1)
 
    ULONG ComPortNumber   = DEFAULT_DEBUG_PORT;
    ULONG ComPortBaudRate = DEFAULT_DEBUG_BAUD_RATE;
    PUCHAR ComPortAddress = NULL;
 
    PSTR CommandLine, PortString, BaudString;
    ULONG Value;
 
    /* Check if we have a LoaderBlock */
    if (LoaderBlock)
    {
        /* Get the Command Line */
        CommandLine = LoaderBlock->LoadOptions;
 
        /* Upcase it */
        _strupr(CommandLine);
 
        /* Get the port and baud rate */
        PortString = strstr(CommandLine, "DEBUGPORT");
        BaudString = strstr(CommandLine, "BAUDRATE");
 
        /* Check if we got the DEBUGPORT parameter */
        if (PortString)
        {
            /* Move past the actual string and any spaces */
            PortString += CONST_STR_LEN("DEBUGPORT");
            while (*PortString == ' ') ++PortString;
            /* Skip the equals sign */
            if (*PortString) ++PortString;
 
            /* Do we have a serial port? */
            if (_strnicmp(PortString, "COM", CONST_STR_LEN("COM")) != 0)
                return STATUS_INVALID_PARAMETER;
 
            /* Check for a valid serial port */
            PortString += CONST_STR_LEN("COM");
            if (*PortString != ':')
            {
                Value = (ULONG)atol(PortString);
                if (Value > MAX_COM_PORTS)
                    return STATUS_INVALID_PARAMETER;
                // if (Value > 0 && Value <= MAX_COM_PORTS)
                /* Set the port to use */
                ComPortNumber = Value;
            }
            else
            {
                /* Retrieve and set its address */
                Value = strtoul(PortString + 1, NULL, 0);
                if (Value)
                {
                    ComPortNumber = 0;
                    ComPortAddress = UlongToPtr(Value);
                }
            }
        }
 
        /* Check if we got a baud rate */
        if (BaudString)
        {
            /* Move past the actual string and any spaces */
            BaudString += CONST_STR_LEN("BAUDRATE");
            while (*BaudString == ' ') ++BaudString;
 
            /* Make sure we have a rate */
            if (*BaudString)
            {
                /* Read and set it */
                Value = (ULONG)atol(BaudString + 1);
                if (Value) ComPortBaudRate = Value;
            }
        }
    }
 
    if (!ComPortAddress)
        ComPortAddress = UlongToPtr(BaseArray[ComPortNumber]);
 
#ifdef KDDEBUG
    /*
     * Try to find a free COM port and use it as the KD debugging port.
     * NOTE: Inspired by freeldr/comm/rs232.c, Rs232PortInitialize(...)
     */
    {
    /*
     * 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.
     */
    PUCHAR Address = NULL;
    ULONG ComPort;
    for (ComPort = MAX_COM_PORTS; ComPort > 0; ComPort--)
    {
        /* Check if the port exist; skip the KD port */
        Address = UlongToPtr(BaseArray[ComPort]);
        if ((Address != ComPortAddress) && CpDoesPortExist(Address))
            break;
    }
    if (ComPort != 0 && Address != NULL)
        CpInitialize(&KdDebugComPort, Address, DEFAULT_BAUD_RATE);
    }
#endif
 
    /* Initialize the port */
    return KdpPortInitialize(ComPortAddress, ComPortBaudRate);
}

Referenced by KdInitSystem().

◆ KdDebuggerInitialize1()

NTSTATUS NTAPI KdDebuggerInitialize1 ( IN PLOADER_PARAMETER_BLOCK LoaderBlock OPTIONAL )

Definition at line 236 of file kdcom.c.

{
    return STATUS_SUCCESS;
}

Referenced by Phase1InitializationDiscard().

◆ KdpPollBreakIn()

KDP_STATUS NTAPI KdpPollBreakIn ( VOID )

Definition at line 296 of file kdcom.c.

{
    KDP_STATUS KdStatus;
    UCHAR Byte;
 
    KdStatus = KdpPollByte(&Byte);
    if ((KdStatus == KDP_PACKET_RECEIVED) && (Byte == BREAKIN_PACKET_BYTE))
    {
        return KDP_PACKET_RECEIVED;
    }
    return KDP_PACKET_TIMEOUT;
}

Referenced by KdReceivePacket().

◆ KdpPollByte()

KDP_STATUS NTAPI KdpPollByte ( OUT PUCHAR OutByte )

Definition at line 252 of file kdcom.c.

{
    USHORT Status;
 
    /* Poll the byte */
    Status = CpGetByte(&KdComPort, OutByte, FALSE, FALSE);
    switch (Status)
    {
        case CP_GET_SUCCESS:
            return KDP_PACKET_RECEIVED;
 
        case CP_GET_NODATA:
            return KDP_PACKET_TIMEOUT;
 
        case CP_GET_ERROR:
        default:
            return KDP_PACKET_RESEND;
    }
}

Referenced by gdb_receive_packet(), and KdpPollBreakIn().

◆ KdpPortInitialize()

NTSTATUS NTAPI KdpPortInitialize	(	_In_ PUCHAR	PortAddress,
		_In_ ULONG	BaudRate
	)

Definition at line 97 of file kdcom.c.

{
    NTSTATUS Status;
 
    Status = CpInitialize(&KdComPort, PortAddress, BaudRate);
    if (!NT_SUCCESS(Status))
        return STATUS_INVALID_PARAMETER;
 
    KdComPortInUse = KdComPort.Address;
    return STATUS_SUCCESS;
}

Referenced by KdDebuggerInitialize0().

◆ KdpReceiveByte()

KDP_STATUS NTAPI KdpReceiveByte ( OUT PUCHAR OutByte )

Definition at line 274 of file kdcom.c.

{
    USHORT Status;
 
    /* Get the byte */
    Status = CpGetByte(&KdComPort, OutByte, TRUE, FALSE);
    switch (Status)
    {
        case CP_GET_SUCCESS:
            return KDP_PACKET_RECEIVED;
 
        case CP_GET_NODATA:
            return KDP_PACKET_TIMEOUT;
 
        case CP_GET_ERROR:
        default:
            return KDP_PACKET_RESEND;
    }
}

Referenced by finish_gdb_packet(), gdb_receive_packet(), KdpReceiveBuffer(), and KdpReceivePacketLeader().

◆ KdpSendByte()

VOID NTAPI KdpSendByte ( IN UCHAR Byte )

Definition at line 244 of file kdcom.c.

{
    /* Send the byte */
    CpPutByte(&KdComPort, Byte);
}

Referenced by finish_gdb_packet(), gdb_receive_packet(), KdpPollBreakIn(), KdpSendBuffer(), KdSendPacket(), send_gdb_partial_binary(), send_gdb_partial_packet(), and start_gdb_packet().

◆ KdRestore()

NTSTATUS NTAPI KdRestore ( IN BOOLEAN SleepTransition )

Definition at line 89 of file kdcom.c.

{
    /* Nothing to do on COM ports */
    return STATUS_SUCCESS;
}

Referenced by KdExitDebugger(), and KdReportProcessorChange().

◆ KdSave()

NTSTATUS NTAPI KdSave ( IN BOOLEAN SleepTransition )

Definition at line 81 of file kdcom.c.

{
    /* Nothing to do on COM ports */
    return STATUS_SUCCESS;
}

Referenced by KdEnterDebugger(), and KdReportProcessorChange().

Variable Documentation

◆ KdComPort

CPPORT KdComPort

Definition at line 20 of file kdcom.c.

Referenced by KdpPollByte(), KdpPortInitialize(), KdpReceiveByte(), and KdpSendByte().

Macros

Functions

Variables