From 6446c98725949dbc5bbf51a2ce1ae004c74a511c Mon Sep 17 00:00:00 2001 From: lgao4 Date: Mon, 19 Oct 2009 10:07:34 +0000 Subject: [PATCH] Add an example HII driver to show how to generate HII resource section git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@9344 6f19259b-4bc3-4df7-8a09-765794883524 --- .../HiiResourcesSample.c | 156 ++++++++++++++++++ .../HiiResourcesSampleDxe.inf | 53 ++++++ .../HiiResourcesSampleDxe/Sample.vfr | 46 ++++++ .../HiiResourcesSampleDxe/SampleStrings.uni | Bin 0 -> 4424 bytes 4 files changed, 255 insertions(+) create mode 100644 MdeModulePkg/Universal/HiiResourcesSampleDxe/HiiResourcesSample.c create mode 100644 MdeModulePkg/Universal/HiiResourcesSampleDxe/HiiResourcesSampleDxe.inf create mode 100644 MdeModulePkg/Universal/HiiResourcesSampleDxe/Sample.vfr create mode 100644 MdeModulePkg/Universal/HiiResourcesSampleDxe/SampleStrings.uni diff --git a/MdeModulePkg/Universal/HiiResourcesSampleDxe/HiiResourcesSample.c b/MdeModulePkg/Universal/HiiResourcesSampleDxe/HiiResourcesSample.c new file mode 100644 index 0000000000..c3c5725660 --- /dev/null +++ b/MdeModulePkg/Universal/HiiResourcesSampleDxe/HiiResourcesSample.c @@ -0,0 +1,156 @@ +/** @file +This is an example of how a driver retrieve HII data using HII Package List +Protocol, and how to publish the HII data. + +Copyright (c) 2009, Intel Corporation +All rights reserved. This program and the accompanying materials +are licensed and made available under the terms and conditions of the BSD License +which accompanies this distribution. The full text of the license may be found at +http://opensource.org/licenses/bsd-license.php + +THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, +WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. + +**/ + +#include +#include +#include +#include +#include +#include +#include + +#pragma pack(1) +/// +/// HII specific Vendor Device Path definition. +/// +typedef struct { + VENDOR_DEVICE_PATH VendorDevicePath; + EFI_DEVICE_PATH_PROTOCOL End; +} HII_VENDOR_DEVICE_PATH; +#pragma pack() + + +EFI_HII_HANDLE mHiiHandle = NULL; +EFI_HANDLE mDriverHandle = NULL; + +HII_VENDOR_DEVICE_PATH mHiiVendorDevicePath = { + { + { + HARDWARE_DEVICE_PATH, + HW_VENDOR_DP, + { + (UINT8) (sizeof (VENDOR_DEVICE_PATH)), + (UINT8) ((sizeof (VENDOR_DEVICE_PATH)) >> 8) + } + }, + // + // {D49D2EB0-44D5-4621-9FD6-1A92C9109B99} + // + { 0xD49D2EB0, 0x44D5, 0x4621, { 0x9F, 0xD6, 0x1A, 0x92, 0xC9, 0x10, 0x9B, 0x99 } } + }, + { + END_DEVICE_PATH_TYPE, + END_ENTIRE_DEVICE_PATH_SUBTYPE, + { + (UINT8) (END_DEVICE_PATH_LENGTH), + (UINT8) ((END_DEVICE_PATH_LENGTH) >> 8) + } + } +}; + +/** + Main entry for this driver. + + @param[in] ImageHandle Image handle this driver. + @param[in] SystemTable Pointer to SystemTable. + + @retval EFI_SUCESS This function always complete successfully. + +**/ +EFI_STATUS +EFIAPI +HiiResourcesSampleInit ( + IN EFI_HANDLE ImageHandle, + IN EFI_SYSTEM_TABLE *SystemTable + ) +{ + EFI_STATUS Status; + EFI_HII_PACKAGE_LIST_HEADER *PackageList; + + // + // Retrieve HII package list from ImageHandle + // + Status = gBS->OpenProtocol ( + ImageHandle, + &gEfiHiiPackageListProtocolGuid, + (VOID **) &PackageList, + ImageHandle, + NULL, + EFI_OPEN_PROTOCOL_GET_PROTOCOL + ); + if (EFI_ERROR (Status)) { + return Status; + } + + // + // Publish sample Fromset + // + Status = gBS->InstallProtocolInterface ( + &mDriverHandle, + &gEfiDevicePathProtocolGuid, + EFI_NATIVE_INTERFACE, + &mHiiVendorDevicePath + ); + if (EFI_ERROR (Status)) { + return Status; + } + + // + // Publish HII package list to HII Database. Here we use ImageHandle as + // the "Driver Handle" for HiiDatabase->NewPackageList(), since there will + // be EFI_LOADED_IMAGE_DEVICE_PATH_PROTOCOL installed on the ImageHandle. + // + Status = gHiiDatabase->NewPackageList ( + gHiiDatabase, + PackageList, + mDriverHandle, + &mHiiHandle + ); + if (EFI_ERROR (Status)) { + return Status; + } + + return EFI_SUCCESS; +} + +/** + Unloads the application and its installed protocol. + + @param[in] ImageHandle Handle that identifies the image to be unloaded. + + @retval EFI_SUCCESS The image has been unloaded. +**/ +EFI_STATUS +EFIAPI +HiiResourcesSampleUnload ( + IN EFI_HANDLE ImageHandle + ) +{ + if (mDriverHandle != NULL) { + gBS->UninstallProtocolInterface ( + mDriverHandle, + &gEfiDevicePathProtocolGuid, + &mHiiVendorDevicePath + ); + mDriverHandle = NULL; + } + + if (mHiiHandle != NULL) { + HiiRemovePackages (mHiiHandle); + mHiiHandle = NULL; + } + + return EFI_SUCCESS; +} diff --git a/MdeModulePkg/Universal/HiiResourcesSampleDxe/HiiResourcesSampleDxe.inf b/MdeModulePkg/Universal/HiiResourcesSampleDxe/HiiResourcesSampleDxe.inf new file mode 100644 index 0000000000..82e24128ef --- /dev/null +++ b/MdeModulePkg/Universal/HiiResourcesSampleDxe/HiiResourcesSampleDxe.inf @@ -0,0 +1,53 @@ +#/** @file +# This is an example of how a driver retrieve HII data using HII Package List +# Protocol, and how to publish the HII data. +# +# Copyright (c) 2009, Intel Corporation. All rights reserved. +# +# All rights reserved. This program and the accompanying materials +# are licensed and made available under the terms and conditions of the BSD License +# which accompanies this distribution. The full text of the license may be found at +# http://opensource.org/licenses/bsd-license.php +# +# THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, +# WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. +# +# +#**/ + +[Defines] + INF_VERSION = 0x00010005 + BASE_NAME = HiiResourcesSample + FILE_GUID = D49D2EB0-44D5-4621-9FD6-1A92C9109B99 + MODULE_TYPE = UEFI_DRIVER + VERSION_STRING = 1.0 + ENTRY_POINT = HiiResourcesSampleInit + UNLOAD_IMAGE = HiiResourcesSampleUnload +# +# This flag specifies whether HII resource section is generated into PE image. +# + UEFI_HII_RESOURCE_SECTION = TRUE + +# +# The following information is for reference only and not required by the build tools. +# +# VALID_ARCHITECTURES = IA32 X64 IPF EBC +# + +[Sources] + HiiResourcesSample.c + SampleStrings.uni + Sample.vfr + +[Packages] + MdePkg/MdePkg.dec + MdeModulePkg/MdeModulePkg.dec + +[LibraryClasses] + UefiBootServicesTableLib + UefiDriverEntryPoint + UefiHiiServicesLib + HiiLib + +[Protocols] + gEfiHiiPackageListProtocolGuid ## CONSUMES diff --git a/MdeModulePkg/Universal/HiiResourcesSampleDxe/Sample.vfr b/MdeModulePkg/Universal/HiiResourcesSampleDxe/Sample.vfr new file mode 100644 index 0000000000..ad0ecad19b --- /dev/null +++ b/MdeModulePkg/Universal/HiiResourcesSampleDxe/Sample.vfr @@ -0,0 +1,46 @@ +// *++ +// +// Copyright (c) 2009, Intel Corporation +// All rights reserved. This program and the accompanying materials +// are licensed and made available under the terms and conditions of the BSD License +// which accompanies this distribution. The full text of the license may be found at +// http://opensource.org/licenses/bsd-license.php +// +// THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, +// WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. +// +// Module Name: +// +// Sample.vfr +// +// Abstract: +// +// Sample Form. +// +// Revision History: +// +// --*/ + +#define SAMPLE_GUID { 0x4f4ef7f0, 0xaa29, 0x4ce9, 0xba, 0x41, 0x64, 0x3e, 0x1, 0x23, 0xa9, 0x9f } + + +formset + guid = SAMPLE_GUID, + title = STRING_TOKEN(STR_SAMPLE_FORM_SET_TITLE), + help = STRING_TOKEN(STR_SAMPLE_FORM_SET_HELP), + + form formid = 1, + title = STRING_TOKEN(STR_SAMPLE_FORM1_TITLE); + + text + help = STRING_TOKEN(STR_SAMPLE_VERSION_HELP), + text = STRING_TOKEN(STR_SAMPLE_VERSION_TEXT), + text = STRING_TOKEN(STR_SAMPLE_EMPTY); + + subtitle text = STRING_TOKEN(STR_SAMPLE_EMPTY); + + subtitle text = STRING_TOKEN(STR_SAMPLE_ESC); + + endform; + +endformset; diff --git a/MdeModulePkg/Universal/HiiResourcesSampleDxe/SampleStrings.uni b/MdeModulePkg/Universal/HiiResourcesSampleDxe/SampleStrings.uni new file mode 100644 index 0000000000000000000000000000000000000000..5b3f1d9766ddcdbf24de7124c8f02a0d3cadfcdc GIT binary patch literal 4424 zcmc(i+fNfg6vof9iT}f_me>n>$@A2nFsjVj#J26+e%iH-ZD6PN-6pJkW*vJ@`_^9b zyt7yIYc}Fr&(7#;&zN0$pD;V1H)8&=pUj%XHo+xi(TdbZJxjqnwoBe!D>K)^#sRYl z_{ZQrbsL6^Pq3j&J7Go7#~pY$w;?O_?V5cf)+fx!YRMhYJ9BAww>_diL6S6{A+JMk z?H{{0%E%hy_sX1qQfAuN(zW%uFJ+{B=U3GE z|3(r0|C9N6k|O$+?O7F;8rHPBec-)m`;2SEU_unCZ82N3EjyxD^~gN31KKL{ikBcE zMs1DiRAt4XORm#Xbv?IiYK@R%?VWtlDL*aDJuz$QRitT-B+TU~kpF%;ZGrHCStqvC_HYRqi%xBKp|d zC%(I$Z_2y_@?}U4Y|PGxxKdIN{rgX^JcneC@>o?dMXxe$Fx!{pdYhgpTCEB($w|+z z3i6}O#A{yPH56->@>|s|kETqO?=u_m#$FSPE|HV+3uo1yk0vhX`W8IvWcG{cX(?Gj z-g{f~oH}?qjy6t+TlxW4$2%c2u)9J2E z{~9xShC+sXL!WX-QBbvS$WYwv(^I^)XccWO|C*1Dh~)xpr=TxdARG4BSz}%trtp>3 zMX}#=Z)Tk4y%B89>w0*95!yU=4@G-lZdHRm!F|!fMQC-lWYHnC@ivmN+`tbV`!Vx| z&S7~x@mA;C1--NB%!v60+ACDOI$l>5DHA^_zYcxfew1&)L#y)1Dy+PlFW=mnA;G81 z_%a{;37$}e8cwsf7#R;8EkZM&2meB|95M4;HX zBCf+-_hv=b*`<@OwldD{gYte{F0L3!?mW4@9xIzvr@L^e+wuI(So{{xy5bH0rj@!g zXa8+3yk_XX(kiRPALfY5A>o5ntKdGQ6!S9)sS$RO~#T literal 0 HcmV?d00001