From 6064c1e48b622f53538f4df9bdd402c607a87d51 Mon Sep 17 00:00:00 2001 From: Konstantin Aladyshev Date: Sat, 10 Jul 2021 00:04:40 +0300 Subject: Move lessons to separate folder Signed-off-by: Konstantin Aladyshev --- Lesson_16/README.md | 286 ---------------------------------------------------- 1 file changed, 286 deletions(-) delete mode 100644 Lesson_16/README.md (limited to 'Lesson_16/README.md') diff --git a/Lesson_16/README.md b/Lesson_16/README.md deleted file mode 100644 index f983b52..0000000 --- a/Lesson_16/README.md +++ /dev/null @@ -1,286 +0,0 @@ -In previous lesson we've developed an app that showed us current boot options: -``` -FS0:\> ShowBootVariables.efi -Boot0000 -UiApp -Fv(7CB8BDC9-F8EB-4F34-AAEA-3EE4AF6516A1)/FvFile(462CAA21-7614-4503-836E-8AB6F4662331) - -Boot0001 -UEFI QEMU DVD-ROM QM00003 -PciRoot(0x0)/Pci(0x1,0x1)/Ata(0x0) - -Boot0002 -UEFI QEMU HARDDISK QM00001 -PciRoot(0x0)/Pci(0x1,0x1)/Ata(0x0) - -Boot0003* -EFI Internal Shell -Fv(7CB8BDC9-F8EB-4F34-AAEA-3EE4AF6516A1)/FvFile(7C04A583-9E3E-4F1C-AD65-E05268D0B4D1) - -Boot0004 -UEFI PXEv4 (MAC:525400123456) -PciRoot(0x0)/Pci(0x3,0x0)/MAC(525400123456,0x1)/IPv4(0.0.0.0) -``` - -If you want to know information about the printed GUIDs here it is: -- `FILE_GUID = 7C04A583-9E3E-4f1c-AD65-E05268D0B4D1 # gUefiShellFileGuid` -https://github.com/tianocore/edk2/blob/master/ShellPkg/Application/Shell/Shell.inf -- `FILE_GUID = 462CAA21-7614-4503-836E-8AB6F4662331` - UiApp module is driver for BDS phase -https://github.com/tianocore/edk2/blob/master/MdeModulePkg/Application/UiApp/UiApp.inf - -As for the `7CB8BDC9-F8EB-4F34-AAEA-3EE4AF6516A1` it is a GUID for the firmware volume in our OVMF image. -https://github.com/tianocore/edk2/blob/master/OvmfPkg/OvmfPkgX64.fdf - -This *.fdf file lists what drivers/apps are placed in every volume in the image (this includes volumes for SEC, PEI or DXE stages): -``` -... - -[FV.SECFV] -FvNameGuid = 763BED0D-DE9F-48F5-81F1-3E90E1B1A015 -BlockSize = 0x1000 -FvAlignment = 16 -... -INF <...> -... - -[FV.PEIFV] -FvNameGuid = 6938079B-B503-4E3D-9D24-B28337A25806 -BlockSize = 0x10000 -FvAlignment = 16 -... -INF <...> -... - -[FV.DXEFV] -FvForceRebase = FALSE -FvNameGuid = 7CB8BDC9-F8EB-4F34-AAEA-3EE4AF6516A1 ### <---- this is a GUID from our output -BlockSize = 0x10000 -FvAlignment = 16 -... -INF ShellPkg/Application/Shell/Shell.inf <--- this apps are placed in the FV.DXEFV firmware volume -... -INF MdeModulePkg/Application/UiApp/UiApp.inf -``` - -For the complete edk2 FDF file specification look at the https://edk2-docs.gitbook.io/edk-ii-fdf-specification/ - -If you look at the https://github.com/tianocore/edk2/blob/master/ShellPkg/Application/Shell/Shell.inf you'll see that EFI Shell is a simple `UEFI_APPLICATION`. We've developed a lot of those in these lessons, so let's try to add one of our apps to boot options. - -We will try to add our `HelloWorld` application to the boot options. We will look at how Shell app is included and try to do the same. - -First we need to add our app to OVMF image. So let's add `UefiLessonsPkg/HelloWorld/HelloWorld.inf` to the `[FV.DXEFV]` section next to `INF ShellPkg/Application/Shell/Shell.inf` in a `OvmfPkg/OvmfPkgX64.fdf b/OvmfPkg/OvmfPkgX64.fdf` we've already discussed. - -``` -[FV.DXEFV] -FvForceRebase = FALSE -FvNameGuid = 7CB8BDC9-F8EB-4F34-AAEA-3EE4AF6516A1 -BlockSize = 0x10000 -FvAlignment = 16 -... - - INF ShellPkg/Application/Shell/Shell.inf -+ INF UefiLessonsPkg/HelloWorld/HelloWorld.inf -... -``` - -If we try to build OVMF now we would get: -``` -$ build --platform=OvmfPkg/OvmfPkgX64.dsc --arch=X64 --buildtarget=RELEASE --tagname=GCC5 -... -build.py... - : error F001: Module /home/kostr/tiano/edk2/UefiLessonsPkg/HelloWorld/HelloWorld.inf NOT found in DSC file; Is it really a binary module? -... -``` - -Ok, so we need to add information to the `OvmfPkg/OvmfPkgX64.dsc` file. If you look at this file, you'll see that `ShellPkg/Application/Shell/Shell.inf` is listed under `[Components]` section. We've already used it in our first lesson when we've tried to compile our app without package. Add `UefiLessonsPkg/HelloWorld/HelloWorld.inf` next to the Shell INF file. -``` -[Components] - ... - ShellPkg/Application/Shell/Shell.inf { - ... - } -+ UefiLessonsPkg/HelloWorld/HelloWorld.inf - ... -``` -Shell.inf file has some information inside the brackets `{...}`. Don't mind it, we don't need such info for our simple `HelloWorld.inf`. - - -Now we can compile OVMF without errors: -``` -$ build --platform=OvmfPkg/OvmfPkgX64.dsc --arch=X64 --buildtarget=RELEASE --tagname=GCC5 -``` -Our `HelloWorld` app would be compiled and embedded in the OVMF image but unfortunately in wouldn't be listed in a boot options. - -When we used our `ShowBootVariables.efi` app we saw that UEFI shell boot option had a description `EFI Internal Shell`. Let's try search for that in a edk2 codebase: -``` -$ grep "EFI Internal Shell" -r ./ --exclude=Build -./ArmVirtPkg/Library/PlatformBootManagerLib/PlatformBm.c: &gUefiShellFileGuid, L"EFI Internal Shell", LOAD_OPTION_ACTIVE -./OvmfPkg/Library/PlatformBootManagerLib/BdsPlatform.c: &gUefiShellFileGuid, L"EFI Internal Shell", LOAD_OPTION_ACTIVE -./OvmfPkg/Library/PlatformBootManagerLibBhyve/BdsPlatform.c: &gUefiShellFileGuid, L"EFI Internal Shell", LOAD_OPTION_ACTIVE -./OvmfPkg/Library/PlatformBootManagerLibGrub/BdsPlatform.c: &gUefiShellFileGuid, L"EFI Internal Shell", LOAD_OPTION_ACTIVE -``` - -For our case we're interested in a `./OvmfPkg/Library/PlatformBootManagerLib/BdsPlatform.c` file: -``` -VOID -EFIAPI -PlatformBootManagerAfterConsole ( - VOID - ) -{ - ... - // - // Register UEFI Shell - // - PlatformRegisterFvBootOption ( - &gUefiShellFileGuid, L"EFI Internal Shell", LOAD_OPTION_ACTIVE - ); - - ... -} -``` -If you grep for a `gUefiShellFileGuid`: -``` -./OvmfPkg/Library/PlatformBootManagerLib/BdsPlatform.c: &gUefiShellFileGuid, L"EFI Internal Shell", LOAD_OPTION_ACTIVE -./OvmfPkg/Library/PlatformBootManagerLib/PlatformBootManagerLib.inf: gUefiShellFileGuid -./ShellPkg/Application/Shell/Shell.inf: FILE_GUID = 7C04A583-9E3E-4f1c-AD65-E05268D0B4D1 # gUefiShellFileGuid -./ShellPkg/ShellPkg.dec: gUefiShellFileGuid = {0x7c04a583, 0x9e3e, 0x4f1c, {0xad, 0x65, 0xe0, 0x52, 0x68, 0xd0, 0xb4, 0xd1}} -``` - -Ok it looks like we need to create a `UefiLessonsPkg/UefiLessonsPkg.dec` file with something like `gHelloWorldFileGuid` with a value equal to the one that is listed in a `UefiLessonsPkg/HelloWorld/HelloWorld.inf` file. - -Let's do it: -``` -[Defines] - DEC_SPECIFICATION = 0x00010005 - PACKAGE_NAME = UefiLessonsPkg - PACKAGE_GUID = 7e7edbba-ca2c-4177-a3f0-d3371358773a - PACKAGE_VERSION = 1.01 - -[Guids] - # FILE_GUID as defined in UefiLessonsPkg/HelloWorld/HelloWorld.inf - gHelloWorldFileGuid = {0x2e55fa38, 0xf148, 0x42d3, {0xaf, 0x90, 0x1b, 0xe2, 0x47, 0x32, 0x3e, 0x30}} - -``` -EDK2 Package Declaration (DEC) File Format Specification can be found at link https://edk2-docs.gitbook.io/edk-ii-dec-specification/ - -Let's add our GUID to the `OvmfPkg/Library/PlatformBootManagerLib/PlatformBootManagerLib.inf` file -``` -[Guids] - ... - gUefiShellFileGuid -+ gHelloWorldFileGuid -``` -So we could use it in a `OvmfPkg/Library/PlatformBootManagerLib/BdsPlatform.c` file: -``` -VOID -EFIAPI -PlatformBootManagerAfterConsole ( - VOID - ) -{ - ... - // - // Register UEFI Shell - // - PlatformRegisterFvBootOption ( - &gUefiShellFileGuid, L"EFI Internal Shell", LOAD_OPTION_ACTIVE - ); - - // - // Register HelloWorld app - // - PlatformRegisterFvBootOption ( - &gHelloWorldFileGuid, L"Hello World", LOAD_OPTION_ACTIVE - ); - ... -} -``` - -If we try to build OVMF now we would get an error: -``` -$ build --platform=OvmfPkg/OvmfPkgX64.dsc --arch=X64 --buildtarget=RELEASE --tagname=GCC5 -... - -build.py... -/home/kostr/tiano/edk2/OvmfPkg/Library/PlatformBootManagerLib/PlatformBootManagerLib.inf(87): error 4000: Value of Guid [gHelloWorldFileGuid] is not found under [Guids] section in - /home/kostr/tiano/edk2/MdePkg/MdePkg.dec - /home/kostr/tiano/edk2/MdeModulePkg/MdeModulePkg.dec - /home/kostr/tiano/edk2/SourceLevelDebugPkg/SourceLevelDebugPkg.dec - /home/kostr/tiano/edk2/OvmfPkg/OvmfPkg.dec - /home/kostr/tiano/edk2/SecurityPkg/SecurityPkg.dec - /home/kostr/tiano/edk2/ShellPkg/ShellPkg.dec -... -``` -To correct in we need our newly created `UefiLessonsPkg/UefiLessonsPkg.dec` to the `OvmfPkg/Library/PlatformBootManagerLib/PlatformBootManagerLib.inf`: -``` -[Packages] - ... - ShellPkg/ShellPkg.dec - UefiLessonsPkg/UefiLessonsPkg.dec -``` - -Finally we can successfully build OVMF. Let's run it and test our newly created boot option. - -Execute QEMU launch as usual. Now if you'll execute our `ShowBootVariables.efi` app you would get: -``` -FS0:\> ShowBootVariables.efi -Boot0000 -UiApp -Fv(7CB8BDC9-F8EB-4F34-AAEA-3EE4AF6516A1)/FvFile(462CAA21-7614-4503-836E-8AB6F4662331) - -Boot0001 -UEFI QEMU DVD-ROM QM00003 -PciRoot(0x0)/Pci(0x1,0x1)/Ata(0x0) - -Boot0002 -UEFI QEMU HARDDISK QM00001 -PciRoot(0x0)/Pci(0x1,0x1)/Ata(0x0) - -Boot0003* -EFI Internal Shell -Fv(7CB8BDC9-F8EB-4F34-AAEA-3EE4AF6516A1)/FvFile(7C04A583-9E3E-4F1C-AD65-E05268D0B4D1) - -Boot0004 -Hello World -Fv(7CB8BDC9-F8EB-4F34-AAEA-3EE4AF6516A1)/FvFile(2E55FA38-F148-42D3-AF90-1BE247323E30) - -Boot0005 -UEFI PXEv4 (MAC:525400123456) -PciRoot(0x0)/Pci(0x3,0x0)/MAC(525400123456,0x1)/IPv4(0.0.0.0) -``` - -Hooraay! Our boot option is present in the system. - -UEFI shell has a command `bcfg` to print boot variables. You can check that the data from our app is correct, if you execute `bcfg boot dump`: -``` -Shell> bcfg boot dump -Option: 00. Variable: Boot0000 - Desc - UiApp - DevPath - Fv(7CB8BDC9-F8EB-4F34-AAEA-3EE4AF6516A1)/FvFile(462CAA21-7614-4503-836E-8AB6F4662331) - Optional- N -Option: 01. Variable: Boot0001 - Desc - UEFI QEMU DVD-ROM QM00003 - DevPath - PciRoot(0x0)/Pci(0x1,0x1)/Ata(0x0) - Optional- Y -Option: 02. Variable: Boot0002 - Desc - UEFI QEMU HARDDISK QM00001 - DevPath - PciRoot(0x0)/Pci(0x1,0x1)/Ata(0x0) - Optional- Y -Shell> 03. Variable: Boot0003 - Desc - EFI Internal Shell - DevPath - Fv(7CB8BDC9-F8EB-4F34-AAEA-3EE4AF6516A1)/FvFile(7C04A583-9E3E-4F1C-AD65-E05268D0B4D1) - Optional- N -Option: 04. Variable: Boot0004 - Desc - Hello World - DevPath - Fv(7CB8BDC9-F8EB-4F34-AAEA-3EE4AF6516A1)/FvFile(2E55FA38-F148-42D3-AF90-1BE247323E30) - Optional- N -Option: 05. Variable: Boot0005 - Desc - UEFI PXEv4 (MAC:525400123456) - DevPath - PciRoot(0x0)/Pci(0x3,0x0)/MAC(525400123456,0x1)/IPv4(0.0.0.0) - Optional- Y -``` - -Just in case I've placed `Ovmf.diff` in this lesson folder that shows all the necessary changes. - - -- cgit v1.2.3-18-g5258