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 --- Lessons/Lesson_05/Conf/target.txt | 7 +++ Lessons/Lesson_05/README.md | 53 ++++++++++++++++++++++ .../UefiLessonsPkg/HelloWorld/HelloWorld.c | 15 ++++++ .../UefiLessonsPkg/HelloWorld/HelloWorld.inf | 18 ++++++++ .../UefiLessonsPkg/SimplestApp/SimplestApp.c | 10 ++++ .../UefiLessonsPkg/SimplestApp/SimplestApp.inf | 16 +++++++ .../Lesson_05/UefiLessonsPkg/UefiLessonsPkg.dsc | 30 ++++++++++++ 7 files changed, 149 insertions(+) create mode 100644 Lessons/Lesson_05/Conf/target.txt create mode 100644 Lessons/Lesson_05/README.md create mode 100644 Lessons/Lesson_05/UefiLessonsPkg/HelloWorld/HelloWorld.c create mode 100644 Lessons/Lesson_05/UefiLessonsPkg/HelloWorld/HelloWorld.inf create mode 100644 Lessons/Lesson_05/UefiLessonsPkg/SimplestApp/SimplestApp.c create mode 100644 Lessons/Lesson_05/UefiLessonsPkg/SimplestApp/SimplestApp.inf create mode 100644 Lessons/Lesson_05/UefiLessonsPkg/UefiLessonsPkg.dsc (limited to 'Lessons/Lesson_05') diff --git a/Lessons/Lesson_05/Conf/target.txt b/Lessons/Lesson_05/Conf/target.txt new file mode 100644 index 0000000..c109dcf --- /dev/null +++ b/Lessons/Lesson_05/Conf/target.txt @@ -0,0 +1,7 @@ +ACTIVE_PLATFORM = UefiLessonsPkg/UefiLessonsPkg.dsc +TARGET = RELEASE +TARGET_ARCH = X64 +TOOL_CHAIN_CONF = Conf/tools_def.txt +TOOL_CHAIN_TAG = GCC5 +BUILD_RULE_CONF = Conf/build_rule.txt + diff --git a/Lessons/Lesson_05/README.md b/Lessons/Lesson_05/README.md new file mode 100644 index 0000000..23130f4 --- /dev/null +++ b/Lessons/Lesson_05/README.md @@ -0,0 +1,53 @@ +To build modules in our package we've used something like this: +``` +$ build --platform=UefiLessonsPkg/UefiLessonsPkg.dsc \ + --module=UefiLessonsPkg/HelloWorld/HelloWorld.inf \ + --arch=X64 \ + --buildtarget=RELEASE \ + --tagname=GCC5 +``` + +This is kinda long string. Let's simplify it. + +First we can omit `module` option from the command and always compile our package entirely with all its modules: + +``` +$ build --platform=UefiLessonsPkg/UefiLessonsPkg.dsc \ + --arch=X64 \ + --buildtarget=RELEASE \ + --tagname=GCC5 +``` + +When we initiate our environment with: +``` +. edk2setup.sh +``` +`Conf` directory is created in the edk2 folder. This directory is populated with a bunch of files. +Also the `CONF_PATH` environment variable is created which points to the newly created `Conf` folder. + +Right now we are interested in the `Conf/target.txt` file. +By default it has many comments (lines that start with `#` symbol) and is prepopulated with these values: +``` +ACTIVE_PLATFORM = EmulatorPkg/EmulatorPkg.dsc +TARGET = DEBUG +TARGET_ARCH = IA32 +TOOL_CHAIN_CONF = Conf/tools_def.txt +TOOL_CHAIN_TAG = VS2015x86 +BUILD_RULE_CONF = Conf/build_rule.txt +``` + +We can put all our build command options in this file to simplify our everyday life. +``` +ACTIVE_PLATFORM = UefiLessonsPkg/UefiLessonsPkg.dsc +TARGET = RELEASE +TARGET_ARCH = X64 +TOOL_CHAIN_CONF = Conf/tools_def.txt +TOOL_CHAIN_TAG = GCC5 +BUILD_RULE_CONF = Conf/build_rule.txt +``` + +After that we could build our package with all its modules with the one single command: +``` +build +``` + diff --git a/Lessons/Lesson_05/UefiLessonsPkg/HelloWorld/HelloWorld.c b/Lessons/Lesson_05/UefiLessonsPkg/HelloWorld/HelloWorld.c new file mode 100644 index 0000000..1f05899 --- /dev/null +++ b/Lessons/Lesson_05/UefiLessonsPkg/HelloWorld/HelloWorld.c @@ -0,0 +1,15 @@ +#include +#include + +EFI_STATUS +EFIAPI +UefiMain ( + IN EFI_HANDLE ImageHandle, + IN EFI_SYSTEM_TABLE *SystemTable + ) +{ + SystemTable->ConOut->OutputString(SystemTable->ConOut, L"Hello World!\n"); + gST->ConOut->OutputString(gST->ConOut, L"Hello again!\n"); + Print(L"Bye!\n"); + return EFI_SUCCESS; +} diff --git a/Lessons/Lesson_05/UefiLessonsPkg/HelloWorld/HelloWorld.inf b/Lessons/Lesson_05/UefiLessonsPkg/HelloWorld/HelloWorld.inf new file mode 100644 index 0000000..d65ca2e --- /dev/null +++ b/Lessons/Lesson_05/UefiLessonsPkg/HelloWorld/HelloWorld.inf @@ -0,0 +1,18 @@ +[Defines] + INF_VERSION = 1.25 + BASE_NAME = HelloWorld + FILE_GUID = 2e55fa38-f148-42d3-af90-1be247323e30 + MODULE_TYPE = UEFI_APPLICATION + VERSION_STRING = 1.0 + ENTRY_POINT = UefiMain + +[Sources] + HelloWorld.c + +[Packages] + MdePkg/MdePkg.dec + +[LibraryClasses] + UefiApplicationEntryPoint + UefiLib + diff --git a/Lessons/Lesson_05/UefiLessonsPkg/SimplestApp/SimplestApp.c b/Lessons/Lesson_05/UefiLessonsPkg/SimplestApp/SimplestApp.c new file mode 100644 index 0000000..8bdf500 --- /dev/null +++ b/Lessons/Lesson_05/UefiLessonsPkg/SimplestApp/SimplestApp.c @@ -0,0 +1,10 @@ +EFI_STATUS +EFIAPI +UefiMain ( + IN EFI_HANDLE ImageHandle, + IN EFI_SYSTEM_TABLE *SystemTable + ) +{ + return EFI_SUCCESS; +} + diff --git a/Lessons/Lesson_05/UefiLessonsPkg/SimplestApp/SimplestApp.inf b/Lessons/Lesson_05/UefiLessonsPkg/SimplestApp/SimplestApp.inf new file mode 100644 index 0000000..7d4bae2 --- /dev/null +++ b/Lessons/Lesson_05/UefiLessonsPkg/SimplestApp/SimplestApp.inf @@ -0,0 +1,16 @@ +[Defines] + INF_VERSION = 1.25 + BASE_NAME = SimplestApp + FILE_GUID = 4a298956-fbe0-47fb-ae3a-2d5a0a959a26 + MODULE_TYPE = UEFI_APPLICATION + VERSION_STRING = 1.0 + ENTRY_POINT = UefiMain + +[Sources] + SimplestApp.c + +[Packages] + MdePkg/MdePkg.dec + +[LibraryClasses] + UefiApplicationEntryPoint diff --git a/Lessons/Lesson_05/UefiLessonsPkg/UefiLessonsPkg.dsc b/Lessons/Lesson_05/UefiLessonsPkg/UefiLessonsPkg.dsc new file mode 100644 index 0000000..0a2edbe --- /dev/null +++ b/Lessons/Lesson_05/UefiLessonsPkg/UefiLessonsPkg.dsc @@ -0,0 +1,30 @@ +[Defines] + DSC_SPECIFICATION = 0x0001001C + PLATFORM_GUID = 3db7270f-ffac-4139-90a4-0ae68f3f8167 + PLATFORM_VERSION = 0.01 + PLATFORM_NAME = UefiLessonsPkg + SKUID_IDENTIFIER = DEFAULT + SUPPORTED_ARCHITECTURES = X64 + BUILD_TARGETS = RELEASE + + +[LibraryClasses] + UefiApplicationEntryPoint|MdePkg/Library/UefiApplicationEntryPoint/UefiApplicationEntryPoint.inf + UefiBootServicesTableLib|MdePkg/Library/UefiBootServicesTableLib/UefiBootServicesTableLib.inf + DebugLib|MdePkg/Library/UefiDebugLibConOut/UefiDebugLibConOut.inf + BaseLib|MdePkg/Library/BaseLib/BaseLib.inf + PcdLib|MdePkg/Library/BasePcdLibNull/BasePcdLibNull.inf + BaseMemoryLib|MdePkg/Library/BaseMemoryLib/BaseMemoryLib.inf + RegisterFilterLib|MdePkg/Library/RegisterFilterLibNull/RegisterFilterLibNull.inf + PrintLib|MdePkg/Library/BasePrintLib/BasePrintLib.inf + DebugPrintErrorLevelLib|MdePkg/Library/BaseDebugPrintErrorLevelLib/BaseDebugPrintErrorLevelLib.inf + UefiLib|MdePkg/Library/UefiLib/UefiLib.inf + MemoryAllocationLib|MdePkg/Library/UefiMemoryAllocationLib/UefiMemoryAllocationLib.inf + DevicePathLib|MdePkg/Library/UefiDevicePathLib/UefiDevicePathLib.inf + UefiRuntimeServicesTableLib|MdePkg/Library/UefiRuntimeServicesTableLib/UefiRuntimeServicesTableLib.inf + +[Components] + UefiLessonsPkg/SimplestApp/SimplestApp.inf + UefiLessonsPkg/HelloWorld/HelloWorld.inf + + -- cgit v1.2.3-18-g5258