edbgapi.c

三星2410的BSP开发包

//
// Copyright (c) Microsoft Corporation.  All rights reserved.
//
//
// Use of this source code is subject to the terms of the Microsoft end-user
// license agreement (EULA) under which you licensed this SOFTWARE PRODUCT.
// If you did not accept the terms of the EULA, you are not authorized to use
// this source code. For a copy of the EULA, please see the LICENSE.RTF on your
// install media.
//

/*++
THIS CODE AND INFORMATION IS PROVIDED "AS IS" WITHOUT WARRANTY OF
ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO
THE IMPLIED WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A
PARTICULAR PURPOSE.

Module Name:  

   edbgapi.c

Abstract:

Sample program illustrating debug Ethernet (EDBG) API.  This program can be
compiled for CE (UNDER_CE defines) and NT.  This file implements the interface
to the EDBG subsystem for both CE and NT.

Notes: 


--*/
#include <windows.h>
#include <ethdbg.h>


#ifndef UNDER_CE

#include <stdio.h>
#include <tchar.h>

#define RETAILMSG(exp, p)    ((exp) ? _tprintf p, 1 : 0)

#endif
                   
#ifdef UNDER_CE

// For CE, the EDBG functions are implemented as kernel IO controls (see halether.h)
#include <halether.h>
BOOL
EdbgRegisterClient(UCHAR *pId, char *ServiceName, UCHAR Flags, UCHAR WindowSize, UCHAR *pBufferPool)
{
    return CallEdbgRegisterClient(pId, ServiceName, Flags, WindowSize, pBufferPool);
}
BOOL
EdbgDeregisterClient(UCHAR Id)
{
    return CallEdbgDeregisterClient(Id);
}

BOOL
EdbgSend(UCHAR Id, UCHAR *pUserData, DWORD dwUserDataLen)
{
    return CallEdbgSend(Id,pUserData,dwUserDataLen);
}
BOOL
EdbgRecv(UCHAR Id, UCHAR *pRecvBuf, DWORD *pdwLen, DWORD Timeout)
{
    return CallEdbgRecv(Id, pRecvBuf, pdwLen, Timeout);
}

void
EdbgSetDebug(DWORD ZoneMask)
{
    CallEdbgSetDebug(ZoneMask);
}

#else
// Under NT, the EDBG functions are provided in EDBG.DLL

// EDBG.DLL function pointers
typedef BOOL (_cdecl *PFN_EdbgRegisterClient)(UCHAR *pId,char *ServiceName, UCHAR Flags,TCHAR *EshellServer,TCHAR *DeviceName);
PFN_EdbgRegisterClient pfnEdbgRegisterClient;
typedef BOOL (_cdecl *PFN_EdbgDeregisterClient)(UCHAR Id);
PFN_EdbgDeregisterClient pfnEdbgDeregisterClient;
typedef BOOL (_cdecl *PFN_EdbgSend)(UCHAR Id, UCHAR *pUserData, DWORD dwUserDataLen);
PFN_EdbgSend pfnEdbgSend;
typedef BOOL (_cdecl *PFN_EdbgRecv)(UCHAR Id, UCHAR *pRecvBuf, DWORD *pdwLen, DWORD Timeout);
PFN_EdbgRecv pfnEdbgRecv;
typedef void (_cdecl *PFN_EdbgSetDebug)(DWORD DebugZoneMask, PFN_OutputDebugString pDebugStringFunc);
PFN_EdbgSetDebug pfnEdbgSetDebug;


static BOOL
LoadEDBG()
{
    HINSTANCE hinstDll;
    
    if ((hinstDll = LoadLibrary("EDBG.DLL")) == NULL) {
        _tprintf(TEXT("Error in LoadLibrary(EDBG.DLL): %u\n"),GetLastError());
        return FALSE;
    }
    pfnEdbgRegisterClient = (PFN_EdbgRegisterClient)GetProcAddress(hinstDll,"EdbgRegisterClient");
    pfnEdbgDeregisterClient = (PFN_EdbgDeregisterClient)GetProcAddress(hinstDll,"EdbgDeregisterClient");
    pfnEdbgSend = (PFN_EdbgSend)GetProcAddress(hinstDll,"EdbgSend");
    pfnEdbgRecv = (PFN_EdbgRecv)GetProcAddress(hinstDll,"EdbgRecv");
    pfnEdbgSetDebug = (PFN_EdbgSetDebug)GetProcAddress(hinstDll,"EdbgSetDebug");

    if (!(pfnEdbgRegisterClient && pfnEdbgDeregisterClient && pfnEdbgSend && pfnEdbgRecv && pfnEdbgSetDebug)) {
        _tprintf(TEXT("Error loading function pointers from EDBG.DLL\n"));
        return FALSE;
    }
    return TRUE;
}

BOOL
EdbgRegisterClient(UCHAR *pId, char *ServiceName, UCHAR Flags, char *EshellServer, char *DeviceName)
{
    // Load function pointers if necessary
    if (!pfnEdbgRegisterClient && !LoadEDBG())
        return FALSE;
    return pfnEdbgRegisterClient(pId, ServiceName, Flags, EshellServer, DeviceName);
}
BOOL
EdbgDeregisterClient(UCHAR Id)
{
    // Load function pointers if necessary
    if (!pfnEdbgDeregisterClient && !LoadEDBG()) 
        return FALSE;
    return pfnEdbgDeregisterClient(Id);
}

BOOL
EdbgSend(UCHAR Id, UCHAR *pUserData, DWORD dwUserDataLen)
{
    // Load function pointers if necessary
    if (!pfnEdbgSend && !LoadEDBG()) 
        return FALSE;
    return pfnEdbgSend(Id,pUserData,dwUserDataLen);
}
BOOL
EdbgRecv(UCHAR Id, UCHAR *pRecvBuf, DWORD *pdwLen, DWORD Timeout)
{
    // Load function pointers if necessary
    if (!pfnEdbgRecv && !LoadEDBG()) 
        return FALSE;
    return pfnEdbgRecv(Id, pRecvBuf, pdwLen, Timeout);
}

void
EdbgSetDebug(DWORD ZoneMask, PFN_OutputDebugString pDebugStringFunc)
{
    // Load function pointers if necessary
    if (!pfnEdbgSetDebug && !LoadEDBG()) 
        return;
    pfnEdbgSetDebug(ZoneMask, pDebugStringFunc);
}
#endif