Sample boot service driver.
Signed-off-by: David Decotigny <decot@googlers.com>
This commit is contained in:
Nigel Croxon
parent
9d6b441ec5
commit
8f5ba0e4fd
@ -60,10 +60,19 @@ LOADLIBES += -T $(LDSCRIPT)
|
|||||||
|
|
||||||
FORMAT = efi-app-$(ARCH)
|
FORMAT = efi-app-$(ARCH)
|
||||||
|
|
||||||
TARGETS = t.efi t2.efi t3.efi t4.efi t5.efi t6.efi printenv.efi t7.efi tcc.efi modelist.efi route80h.efi
|
TARGET_APPS = t.efi t2.efi t3.efi t4.efi t5.efi t6.efi \
|
||||||
|
printenv.efi t7.efi tcc.efi modelist.efi \
|
||||||
|
route80h.efi drv0_use.efi
|
||||||
|
TARGET_BSDRIVERS = drv0.efi
|
||||||
|
TARGET_RTDRIVERS =
|
||||||
|
|
||||||
|
TARGETS = $(TARGET_APPS) $(TARGET_BSDRIVERS) $(TARGET_RTDRIVERS)
|
||||||
|
|
||||||
all: $(TARGETS)
|
all: $(TARGETS)
|
||||||
|
|
||||||
|
$(TARGET_BSDRIVERS): FORMAT=efi-bsdrv-$(ARCH)
|
||||||
|
$(TARGET_RTDRIVERS): FORMAT=efi-rtdrv-$(ARCH)
|
||||||
|
|
||||||
clean:
|
clean:
|
||||||
rm -f $(TARGETS) *~ *.o *.so
|
rm -f $(TARGETS) *~ *.o *.so
|
||||||
|
|
||||||
|
|||||||
193
gnu-efi-3.0/apps/drv0.c
Normal file
193
gnu-efi-3.0/apps/drv0.c
Normal file
@ -0,0 +1,193 @@
|
|||||||
|
/*
|
||||||
|
* Copyright (C) 2013 David Decotigny <decot@googlers.com>
|
||||||
|
*
|
||||||
|
* Sample EFI shell session, together with drv0_use.efi:
|
||||||
|
*
|
||||||
|
* # Loading first instance:
|
||||||
|
*
|
||||||
|
* fs0:\> load drv0.efi
|
||||||
|
* Driver instance loaded successfully.
|
||||||
|
* load: Image fs0:\drv0.efi loaded at 2FD7C000 - Success
|
||||||
|
*
|
||||||
|
* # Testing 1st instance:
|
||||||
|
*
|
||||||
|
* fs0:\> drv0_use.efi
|
||||||
|
* Playing with driver instance 0...
|
||||||
|
* Hello Sample UEFI Driver!
|
||||||
|
* Hello was called 1 time(s).
|
||||||
|
*
|
||||||
|
* fs0:\> drv0_use.efi
|
||||||
|
* Playing with driver instance 0...
|
||||||
|
* Hello Sample UEFI Driver!
|
||||||
|
* Hello was called 2 time(s).
|
||||||
|
*
|
||||||
|
* # Loading another instance:
|
||||||
|
*
|
||||||
|
* fs0:\> load drv0.efi
|
||||||
|
* Driver instance loaded successfully.
|
||||||
|
* load: Image fs0:\drv0.efi loaded at 2FD6D000 - Success
|
||||||
|
*
|
||||||
|
* # Using both instances:
|
||||||
|
*
|
||||||
|
* fs0:\> drv0_use.efi
|
||||||
|
* Playing with driver instance 0...
|
||||||
|
* Hello Sample UEFI Driver!
|
||||||
|
* Hello was called 3 time(s).
|
||||||
|
* Playing with driver instance 1...
|
||||||
|
* Hello Sample UEFI Driver!
|
||||||
|
* Hello was called 1 time(s).
|
||||||
|
*
|
||||||
|
* fs0:\> drv0_use.efi
|
||||||
|
* Playing with driver instance 0...
|
||||||
|
* Hello Sample UEFI Driver!
|
||||||
|
* Hello was called 4 time(s).
|
||||||
|
* Playing with driver instance 1...
|
||||||
|
* Hello Sample UEFI Driver!
|
||||||
|
* Hello was called 2 time(s).
|
||||||
|
*
|
||||||
|
* # Removing 1st instance:
|
||||||
|
*
|
||||||
|
* fs0:\> dh
|
||||||
|
* Handle dump
|
||||||
|
* 1: Image(DxeCore)
|
||||||
|
* [...]
|
||||||
|
* 79: Image(\/drv0.efi) ImageDevPath (..A,0x800,0x17F7DF)/\/drv0.efi)
|
||||||
|
* 7A: Image(\/drv0.efi) ImageDevPath (..A,0x800,0x17F7DF)/\/drv0.efi)
|
||||||
|
*
|
||||||
|
* fs0:\> unload 79
|
||||||
|
* 79: Image(\/drv0.efi) ImageDevPath (..A,0x800,0x17F7DF)/\/drv0.efi)
|
||||||
|
* Unload driver image (y/n)? y
|
||||||
|
* Driver instance unloaded.
|
||||||
|
* unload: Success
|
||||||
|
*
|
||||||
|
* # Only 2nd instance remaining:
|
||||||
|
*
|
||||||
|
* fs0:\> drv0_use.efi
|
||||||
|
* Playing with driver instance 0...
|
||||||
|
* Hello Sample UEFI Driver!
|
||||||
|
* Hello was called 3 time(s).
|
||||||
|
*
|
||||||
|
* # Removing 2nd/last instance:
|
||||||
|
*
|
||||||
|
* fs0:\> dh
|
||||||
|
* Handle dump
|
||||||
|
* 1: Image(DxeCore)
|
||||||
|
* [...]
|
||||||
|
* 79: Image(\/drv0.efi) ImageDevPath (..A,0x800,0x17F7DF)/\/drv0.efi)
|
||||||
|
*
|
||||||
|
* fs0:\> unload 79
|
||||||
|
* 79: Image(\/drv0.efi) ImageDevPath (..A,0x800,0x17F7DF)/\/drv0.efi)
|
||||||
|
* Unload driver image (y/n)? y
|
||||||
|
* Driver instance unloaded.
|
||||||
|
* unload: Success
|
||||||
|
*
|
||||||
|
* # Expect error: no other drv0 instance left
|
||||||
|
*
|
||||||
|
* fs0:\> drv0_use.efi
|
||||||
|
* Error looking up handles for proto: 14
|
||||||
|
*/
|
||||||
|
|
||||||
|
#include <efi.h>
|
||||||
|
#include <efilib.h>
|
||||||
|
#include "drv0.h"
|
||||||
|
|
||||||
|
|
||||||
|
static const EFI_GUID GnuEfiAppsDrv0ProtocolGuid
|
||||||
|
= GNU_EFI_APPS_DRV0_PROTOCOL_GUID;
|
||||||
|
|
||||||
|
static struct {
|
||||||
|
GNU_EFI_APPS_DRV0_PROTOCOL Proto;
|
||||||
|
UINTN Counter;
|
||||||
|
} InternalGnuEfiAppsDrv0ProtocolData;
|
||||||
|
|
||||||
|
|
||||||
|
static
|
||||||
|
EFI_STATUS
|
||||||
|
EFI_FUNCTION
|
||||||
|
Drv0SayHello(
|
||||||
|
IN struct _GNU_EFI_APPS_DRV0_PROTOCOL *This,
|
||||||
|
IN const CHAR16 *HelloWho
|
||||||
|
)
|
||||||
|
{
|
||||||
|
if (! HelloWho)
|
||||||
|
return EFI_INVALID_PARAMETER;
|
||||||
|
|
||||||
|
Print(L"Hello %s!\n", HelloWho);
|
||||||
|
InternalGnuEfiAppsDrv0ProtocolData.Counter ++;
|
||||||
|
return EFI_SUCCESS;
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
static
|
||||||
|
EFI_STATUS
|
||||||
|
EFI_FUNCTION
|
||||||
|
Drv0GetNumberOfHello(
|
||||||
|
IN struct _GNU_EFI_APPS_DRV0_PROTOCOL *This,
|
||||||
|
OUT UINTN *NumberOfHello
|
||||||
|
)
|
||||||
|
{
|
||||||
|
if (! NumberOfHello)
|
||||||
|
return EFI_INVALID_PARAMETER;
|
||||||
|
|
||||||
|
*NumberOfHello = InternalGnuEfiAppsDrv0ProtocolData.Counter;
|
||||||
|
return EFI_SUCCESS;
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
static
|
||||||
|
EFI_STATUS
|
||||||
|
EFI_FUNCTION
|
||||||
|
Drv0Unload(IN EFI_HANDLE ImageHandle)
|
||||||
|
{
|
||||||
|
LibUninstallProtocolInterfaces(ImageHandle,
|
||||||
|
&GnuEfiAppsDrv0ProtocolGuid,
|
||||||
|
&InternalGnuEfiAppsDrv0ProtocolData.Proto,
|
||||||
|
NULL);
|
||||||
|
Print(L"Driver instance unloaded.\n", ImageHandle);
|
||||||
|
return EFI_SUCCESS;
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
EFI_STATUS
|
||||||
|
efi_main (EFI_HANDLE ImageHandle, EFI_SYSTEM_TABLE *SysTab)
|
||||||
|
{
|
||||||
|
EFI_STATUS Status;
|
||||||
|
EFI_LOADED_IMAGE *LoadedImage = NULL;
|
||||||
|
|
||||||
|
InitializeLib(ImageHandle, SysTab);
|
||||||
|
|
||||||
|
/* Initialize global protocol definition + data */
|
||||||
|
InternalGnuEfiAppsDrv0ProtocolData.Proto.SayHello
|
||||||
|
= (GNU_EFI_APPS_DRV0_SAY_HELLO) Drv0SayHello;
|
||||||
|
InternalGnuEfiAppsDrv0ProtocolData.Proto.GetNumberOfHello
|
||||||
|
= (GNU_EFI_APPS_DRV0_GET_NUMBER_OF_HELLO) Drv0GetNumberOfHello;
|
||||||
|
InternalGnuEfiAppsDrv0ProtocolData.Counter = 0;
|
||||||
|
|
||||||
|
/* Grab handle to this image: we'll attach our proto instance to it */
|
||||||
|
Status = uefi_call_wrapper(BS->OpenProtocol, 6,
|
||||||
|
ImageHandle, &LoadedImageProtocol,
|
||||||
|
&LoadedImage, ImageHandle,
|
||||||
|
NULL, EFI_OPEN_PROTOCOL_GET_PROTOCOL);
|
||||||
|
if (EFI_ERROR(Status)) {
|
||||||
|
Print(L"Could not open loaded image protocol: %d\n", Status);
|
||||||
|
return Status;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Attach our proto to the current driver image */
|
||||||
|
Status = LibInstallProtocolInterfaces(
|
||||||
|
&ImageHandle, &GnuEfiAppsDrv0ProtocolGuid,
|
||||||
|
&InternalGnuEfiAppsDrv0ProtocolData.Proto, NULL);
|
||||||
|
if (EFI_ERROR(Status)) {
|
||||||
|
Print(L"Error registering driver instance: %d\n", Status);
|
||||||
|
return Status;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Register Unload callback, used to unregister current protocol
|
||||||
|
* instance from system */
|
||||||
|
LoadedImage->Unload = (EFI_IMAGE_UNLOAD)Drv0Unload;
|
||||||
|
|
||||||
|
Print(L"Driver instance loaded successfully.\n");
|
||||||
|
return EFI_SUCCESS; /* at this point, this instance stays resident
|
||||||
|
* until image is unloaded, eg. with shell's unload,
|
||||||
|
* ExitBootServices() */
|
||||||
|
}
|
||||||
37
gnu-efi-3.0/apps/drv0.h
Normal file
37
gnu-efi-3.0/apps/drv0.h
Normal file
@ -0,0 +1,37 @@
|
|||||||
|
#ifndef _GNU_EFI_APPS_DRV0_H_
|
||||||
|
#define _GNU_EFI_APPS_DRV0_H_
|
||||||
|
|
||||||
|
#ifdef __cplusplus
|
||||||
|
extern "C" {
|
||||||
|
#endif
|
||||||
|
|
||||||
|
/* UEFI naming conventions */
|
||||||
|
#define GNU_EFI_APPS_DRV0_PROTOCOL_GUID \
|
||||||
|
{ 0xe4dcafd0, 0x586c, 0x4b3d, {0x86, 0xe7, 0x28, 0xde, 0x7f, 0xcc, 0x04, 0xb8} }
|
||||||
|
|
||||||
|
INTERFACE_DECL(_GNU_EFI_APPS_DRV0_PROTOCOL);
|
||||||
|
|
||||||
|
typedef
|
||||||
|
EFI_STATUS
|
||||||
|
(EFIAPI *GNU_EFI_APPS_DRV0_SAY_HELLO) (
|
||||||
|
IN struct _GNU_EFI_APPS_DRV0_PROTOCOL *This,
|
||||||
|
IN const CHAR16 *HelloWho
|
||||||
|
);
|
||||||
|
|
||||||
|
typedef
|
||||||
|
EFI_STATUS
|
||||||
|
(EFIAPI *GNU_EFI_APPS_DRV0_GET_NUMBER_OF_HELLO) (
|
||||||
|
IN struct _GNU_EFI_APPS_DRV0_PROTOCOL *This,
|
||||||
|
OUT UINTN *NumberOfHello
|
||||||
|
);
|
||||||
|
|
||||||
|
typedef struct _GNU_EFI_APPS_DRV0_PROTOCOL {
|
||||||
|
GNU_EFI_APPS_DRV0_SAY_HELLO SayHello;
|
||||||
|
GNU_EFI_APPS_DRV0_GET_NUMBER_OF_HELLO GetNumberOfHello;
|
||||||
|
} GNU_EFI_APPS_DRV0_PROTOCOL;
|
||||||
|
|
||||||
|
#ifdef __cplusplus
|
||||||
|
}
|
||||||
|
#endif
|
||||||
|
|
||||||
|
#endif
|
||||||
79
gnu-efi-3.0/apps/drv0_use.c
Normal file
79
gnu-efi-3.0/apps/drv0_use.c
Normal file
@ -0,0 +1,79 @@
|
|||||||
|
/*
|
||||||
|
* Copyright (C) 2013 David Decotigny <decot@googlers.com>
|
||||||
|
*
|
||||||
|
* See drv0.c for an example session.
|
||||||
|
*/
|
||||||
|
|
||||||
|
#include <efi.h>
|
||||||
|
#include <efilib.h>
|
||||||
|
#include "drv0.h"
|
||||||
|
|
||||||
|
|
||||||
|
static EFI_GUID GnuEfiAppsDrv0ProtocolGuid
|
||||||
|
= GNU_EFI_APPS_DRV0_PROTOCOL_GUID;
|
||||||
|
|
||||||
|
|
||||||
|
static
|
||||||
|
EFI_STATUS
|
||||||
|
PlayWithGnuEfiAppsDrv0Protocol(IN EFI_HANDLE DrvHandle) {
|
||||||
|
EFI_STATUS Status;
|
||||||
|
GNU_EFI_APPS_DRV0_PROTOCOL *drv = NULL;
|
||||||
|
UINTN NumberOfHello = 0;
|
||||||
|
|
||||||
|
Status = uefi_call_wrapper(BS->OpenProtocol, 6,
|
||||||
|
DrvHandle,
|
||||||
|
&GnuEfiAppsDrv0ProtocolGuid,
|
||||||
|
&drv,
|
||||||
|
DrvHandle,
|
||||||
|
NULL,
|
||||||
|
EFI_OPEN_PROTOCOL_GET_PROTOCOL);
|
||||||
|
if (EFI_ERROR(Status)) {
|
||||||
|
Print(L"Cannot open proto: %d\n", Status);
|
||||||
|
return Status;
|
||||||
|
}
|
||||||
|
|
||||||
|
Status = uefi_call_wrapper(drv->SayHello, 2, drv, L"Sample UEFI Driver");
|
||||||
|
if (EFI_ERROR(Status)) {
|
||||||
|
Print(L"Cannot call SayHello: %d\n", Status);
|
||||||
|
}
|
||||||
|
|
||||||
|
Status = uefi_call_wrapper(drv->GetNumberOfHello, 2, drv, &NumberOfHello);
|
||||||
|
if (EFI_ERROR(Status)) {
|
||||||
|
Print(L"Cannot call GetNumberOfHello: %d\n", Status);
|
||||||
|
} else {
|
||||||
|
Print(L"Hello was called %d time(s).\n", NumberOfHello);
|
||||||
|
}
|
||||||
|
|
||||||
|
return EFI_SUCCESS;
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
EFI_STATUS
|
||||||
|
efi_main (EFI_HANDLE Image, EFI_SYSTEM_TABLE *SysTab)
|
||||||
|
{
|
||||||
|
EFI_STATUS Status;
|
||||||
|
EFI_HANDLE *Handles = NULL;
|
||||||
|
UINTN i, NoHandles = 0;
|
||||||
|
|
||||||
|
InitializeLib(Image, SysTab);
|
||||||
|
|
||||||
|
Status = LibLocateHandle(ByProtocol, &GnuEfiAppsDrv0ProtocolGuid,
|
||||||
|
NULL, &NoHandles, &Handles);
|
||||||
|
if (EFI_ERROR(Status)) {
|
||||||
|
Print(L"Error looking up handles for proto: %d\n", Status);
|
||||||
|
return Status;
|
||||||
|
}
|
||||||
|
|
||||||
|
for (i = 0 ; i < NoHandles ; ++i)
|
||||||
|
{
|
||||||
|
Print(L"Playing with driver instance %d...\n", i);
|
||||||
|
Status = PlayWithGnuEfiAppsDrv0Protocol(Handles[i]);
|
||||||
|
if (EFI_ERROR(Status))
|
||||||
|
Print(L"Error playing with instance %d, skipping\n", i);
|
||||||
|
}
|
||||||
|
|
||||||
|
if (Handles)
|
||||||
|
FreePool(Handles);
|
||||||
|
|
||||||
|
return EFI_SUCCESS;
|
||||||
|
}
|
||||||
Loading…
Reference in New Issue
Block a user