]> git.proxmox.com Git - mirror_edk2.git/blame - UefiPayloadPkg/UniversalPayloadBuild.py
OvmfPkg: raise DXEFV size to 13 MB in the traditional platform FDFs
[mirror_edk2.git] / UefiPayloadPkg / UniversalPayloadBuild.py
CommitLineData
f4e72cf9
TD
1## @file\r
2# This file contains the script to build UniversalPayload\r
3#\r
4# Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>\r
5# SPDX-License-Identifier: BSD-2-Clause-Patent\r
6##\r
7\r
8import argparse\r
9import subprocess\r
10import os\r
11import shutil\r
12import sys\r
4a1899dd
GD
13from ctypes import *\r
14\r
15sys.dont_write_bytecode = True\r
16\r
17class UPLD_INFO_HEADER(LittleEndianStructure):\r
18 _pack_ = 1\r
19 _fields_ = [\r
20 ('Identifier', ARRAY(c_char, 4)),\r
21 ('HeaderLength', c_uint32),\r
22 ('SpecRevision', c_uint16),\r
23 ('Reserved', c_uint16),\r
24 ('Revision', c_uint32),\r
25 ('Attribute', c_uint32),\r
26 ('Capability', c_uint32),\r
27 ('ProducerId', ARRAY(c_char, 16)),\r
28 ('ImageId', ARRAY(c_char, 16)),\r
29 ]\r
30\r
31 def __init__(self):\r
b4be5f05 32 self.Identifier = b'PLDH'\r
4a1899dd 33 self.HeaderLength = sizeof(UPLD_INFO_HEADER)\r
85d805ed 34 self.SpecRevision = 0x0009\r
4a1899dd
GD
35 self.Revision = 0x0000010105\r
36 self.ImageId = b'UEFI'\r
37 self.ProducerId = b'INTEL'\r
f4e72cf9
TD
38\r
39def RunCommand(cmd):\r
40 print(cmd)\r
41 p = subprocess.Popen(cmd, shell=True, stdout=subprocess.PIPE, stderr=subprocess.STDOUT,cwd=os.environ['WORKSPACE'])\r
42 while True:\r
43 line = p.stdout.readline()\r
44 if not line:\r
45 break\r
46 print(line.strip().decode(errors='ignore'))\r
47\r
48 p.communicate()\r
49 if p.returncode != 0:\r
50 print("- Failed - error happened when run command: %s"%cmd)\r
51 raise Exception("ERROR: when run command: %s"%cmd)\r
52\r
53def BuildUniversalPayload(Args, MacroList):\r
54 BuildTarget = Args.Target\r
55 ToolChain = Args.ToolChain\r
4cfb28f1 56 Quiet = "--quiet" if Args.Quiet else ""\r
f4e72cf9 57 ElfToolChain = 'CLANGDWARF'\r
2306555b
TD
58 BuildDir = os.path.join(os.environ['WORKSPACE'], os.path.normpath("Build/UefiPayloadPkgX64"))\r
59 if Args.Arch == 'X64':\r
60 BuildArch = "X64"\r
61 ObjCopyFlag = "elf64-x86-64"\r
2aee08c0 62 EntryOutputDir = os.path.join(BuildDir, "{}_{}".format (BuildTarget, ElfToolChain), os.path.normpath("X64/UefiPayloadPkg/UefiPayloadEntry/UniversalPayloadEntry/DEBUG/UniversalPayloadEntry.dll"))\r
2306555b
TD
63 else:\r
64 BuildArch = "IA32 -a X64"\r
65 ObjCopyFlag = "elf32-i386"\r
2aee08c0 66 EntryOutputDir = os.path.join(BuildDir, "{}_{}".format (BuildTarget, ElfToolChain), os.path.normpath("IA32/UefiPayloadPkg/UefiPayloadEntry/UniversalPayloadEntry/DEBUG/UniversalPayloadEntry.dll"))\r
f4e72cf9
TD
67\r
68 EntryModuleInf = os.path.normpath("UefiPayloadPkg/UefiPayloadEntry/UniversalPayloadEntry.inf")\r
69 DscPath = os.path.normpath("UefiPayloadPkg/UefiPayloadPkg.dsc")\r
05da2d24
ML
70 DxeFvOutputDir = os.path.join(BuildDir, "{}_{}".format (BuildTarget, ToolChain), os.path.normpath("FV/DXEFV.Fv"))\r
71 BdsFvOutputDir = os.path.join(BuildDir, "{}_{}".format (BuildTarget, ToolChain), os.path.normpath("FV/BDSFV.Fv"))\r
f4e72cf9
TD
72 PayloadReportPath = os.path.join(BuildDir, "UefiUniversalPayload.txt")\r
73 ModuleReportPath = os.path.join(BuildDir, "UefiUniversalPayloadEntry.txt")\r
4a1899dd 74 UpldInfoFile = os.path.join(BuildDir, "UniversalPayloadInfo.bin")\r
f4e72cf9
TD
75\r
76 if "CLANG_BIN" in os.environ:\r
77 LlvmObjcopyPath = os.path.join(os.environ["CLANG_BIN"], "llvm-objcopy")\r
78 else:\r
79 LlvmObjcopyPath = "llvm-objcopy"\r
80 try:\r
81 RunCommand('"%s" --version'%LlvmObjcopyPath)\r
82 except:\r
83 print("- Failed - Please check if LLVM is installed or if CLANG_BIN is set correctly")\r
84 sys.exit(1)\r
85\r
cfe16514
GG
86 Pcds = ""\r
87 if (Args.pcd != None):\r
88 for PcdItem in Args.pcd:\r
89 Pcds += " --pcd {}".format (PcdItem)\r
90\r
f4e72cf9
TD
91 Defines = ""\r
92 for key in MacroList:\r
93 Defines +=" -D {0}={1}".format(key, MacroList[key])\r
94\r
95 #\r
96 # Building DXE core and DXE drivers as DXEFV.\r
97 #\r
2aee08c0 98 BuildPayload = "build -p {} -b {} -a X64 -t {} -y {} {}".format (DscPath, BuildTarget, ToolChain, PayloadReportPath, Quiet)\r
cfe16514 99 BuildPayload += Pcds\r
f4e72cf9
TD
100 BuildPayload += Defines\r
101 RunCommand(BuildPayload)\r
102 #\r
103 # Building Universal Payload entry.\r
104 #\r
2aee08c0 105 BuildModule = "build -p {} -b {} -a {} -m {} -t {} -y {} {}".format (DscPath, BuildTarget, BuildArch, EntryModuleInf, ElfToolChain, ModuleReportPath, Quiet)\r
cfe16514 106 BuildModule += Pcds\r
f4e72cf9
TD
107 BuildModule += Defines\r
108 RunCommand(BuildModule)\r
109\r
4a1899dd
GD
110 #\r
111 # Buid Universal Payload Information Section ".upld_info"\r
112 #\r
113 upld_info_hdr = UPLD_INFO_HEADER()\r
114 upld_info_hdr.ImageId = Args.ImageId.encode()[:16]\r
21e6ef75 115 upld_info_hdr.Attribute |= 1 if BuildTarget == "DEBUG" else 0\r
4a1899dd
GD
116 fp = open(UpldInfoFile, 'wb')\r
117 fp.write(bytearray(upld_info_hdr))\r
118 fp.close()\r
119\r
f4e72cf9
TD
120 #\r
121 # Copy the DXEFV as a section in elf format Universal Payload entry.\r
122 #\r
05da2d24 123 remove_section = '"{}" -I {} -O {} --remove-section .upld_info --remove-section .upld.uefi_fv --remove-section .upld.bds_fv {}'.format (\r
2aee08c0
KL
124 LlvmObjcopyPath,\r
125 ObjCopyFlag,\r
126 ObjCopyFlag,\r
127 EntryOutputDir\r
128 )\r
05da2d24 129 add_section = '"{}" -I {} -O {} --add-section .upld_info={} --add-section .upld.uefi_fv={} --add-section .upld.bds_fv={} {}'.format (\r
2aee08c0
KL
130 LlvmObjcopyPath,\r
131 ObjCopyFlag,\r
132 ObjCopyFlag,\r
133 UpldInfoFile,\r
05da2d24
ML
134 DxeFvOutputDir,\r
135 BdsFvOutputDir,\r
2aee08c0
KL
136 EntryOutputDir\r
137 )\r
3c16e6fb 138 set_section = '"{}" -I {} -O {} --set-section-alignment .upld_info=4 --set-section-alignment .upld.uefi_fv=16 --set-section-alignment .upld.bds_fv=16 {}'.format (\r
2aee08c0
KL
139 LlvmObjcopyPath,\r
140 ObjCopyFlag,\r
141 ObjCopyFlag,\r
142 EntryOutputDir\r
143 )\r
f4e72cf9
TD
144 RunCommand(remove_section)\r
145 RunCommand(add_section)\r
146 RunCommand(set_section)\r
147\r
148 shutil.copy (EntryOutputDir, os.path.join(BuildDir, 'UniversalPayload.elf'))\r
149\r
150def main():\r
151 parser = argparse.ArgumentParser(description='For building Universal Payload')\r
152 parser.add_argument('-t', '--ToolChain')\r
153 parser.add_argument('-b', '--Target', default='DEBUG')\r
67608430 154 parser.add_argument('-a', '--Arch', choices=['IA32', 'X64'], help='Specify the ARCH for payload entry module. Default build X64 image.', default ='X64')\r
f4e72cf9 155 parser.add_argument("-D", "--Macro", action="append", default=["UNIVERSAL_PAYLOAD=TRUE"])\r
4a1899dd 156 parser.add_argument('-i', '--ImageId', type=str, help='Specify payload ID (16 bytes maximal).', default ='UEFI')\r
4cfb28f1 157 parser.add_argument('-q', '--Quiet', action='store_true', help='Disable all build messages except FATAL ERRORS.')\r
cfe16514 158 parser.add_argument("-p", "--pcd", action="append")\r
f4e72cf9
TD
159 MacroList = {}\r
160 args = parser.parse_args()\r
161 if args.Macro is not None:\r
162 for Argument in args.Macro:\r
163 if Argument.count('=') != 1:\r
164 print("Unknown variable passed in: %s"%Argument)\r
165 raise Exception("ERROR: Unknown variable passed in: %s"%Argument)\r
166 tokens = Argument.strip().split('=')\r
167 MacroList[tokens[0].upper()] = tokens[1]\r
168 BuildUniversalPayload(args, MacroList)\r
169 print ("Successfully build Universal Payload")\r
170\r
171if __name__ == '__main__':\r
172 main()\r