public inbox for devel@edk2.groups.io
 help / color / mirror / Atom feed
* [`edk2-devel][PATCH v2] UefiPayloadPkg: Add ".upld_info" in universal payload
@ 2021-09-25 23:12 Guo Dong
  2021-09-26  2:09 ` Ni, Ray
  0 siblings, 1 reply; 3+ messages in thread
From: Guo Dong @ 2021-09-25 23:12 UTC (permalink / raw)
  To: devel; +Cc: Guo Dong, Ray Ni, Maurice Ma, Benjamin You

From: Guo Dong <guo.dong@intel.com>

V2: Use LittleEndianStructure by review comment.

>From the universal scalable firmware payload requirement V0.75,
Payload must have Universal Payload Information Section ".upld_info"
So update the build tool to add this section.

Cc: Ray Ni <ray.ni@intel.com>
Cc: Maurice Ma <maurice.ma@intel.com>
Cc: Benjamin You <benjamin.you@intel.com>
Signed-off-by: Guo Dong <guo.dong@intel.com>
---
 UefiPayloadPkg/UniversalPayloadBuild.py | 42 +++++++++++++++++++++++++++++++++++++++---
 1 file changed, 39 insertions(+), 3 deletions(-)

diff --git a/UefiPayloadPkg/UniversalPayloadBuild.py b/UefiPayloadPkg/UniversalPayloadBuild.py
index b78c6a7620..e624ec5874 100644
--- a/UefiPayloadPkg/UniversalPayloadBuild.py
+++ b/UefiPayloadPkg/UniversalPayloadBuild.py
@@ -10,6 +10,31 @@ import subprocess
 import os
 import shutil
 import sys
+from   ctypes import *
+
+sys.dont_write_bytecode = True
+
+class UPLD_INFO_HEADER(LittleEndianStructure):
+    _pack_ = 1
+    _fields_ = [
+        ('Identifier',           ARRAY(c_char, 4)),
+        ('HeaderLength',         c_uint32),
+        ('SpecRevision',         c_uint16),
+        ('Reserved',             c_uint16),
+        ('Revision',             c_uint32),
+        ('Attribute',            c_uint32),
+        ('Capability',           c_uint32),
+        ('ProducerId',           ARRAY(c_char, 16)),
+        ('ImageId',              ARRAY(c_char, 16)),
+        ]
+
+    def __init__(self):
+        self.Identifier     =  b'UPLD'
+        self.HeaderLength   = sizeof(UPLD_INFO_HEADER)
+        self.HeaderRevision = 0x0075
+        self.Revision       = 0x0000010105
+        self.ImageId        = b'UEFI'
+        self.ProducerId     = b'INTEL'
 
 def RunCommand(cmd):
     print(cmd)
@@ -37,6 +62,7 @@ def BuildUniversalPayload(Args, MacroList):
     EntryOutputDir = os.path.join(BuildDir, f"{BuildTarget}_{ElfToolChain}", os.path.normpath("X64/UefiPayloadPkg/UefiPayloadEntry/UniversalPayloadEntry/DEBUG/UniversalPayloadEntry.dll"))
     PayloadReportPath = os.path.join(BuildDir, "UefiUniversalPayload.txt")
     ModuleReportPath = os.path.join(BuildDir, "UefiUniversalPayloadEntry.txt")
+    UpldInfoFile = os.path.join(BuildDir, "UniversalPayloadInfo.bin")
 
     if "CLANG_BIN" in os.environ:
         LlvmObjcopyPath = os.path.join(os.environ["CLANG_BIN"], "llvm-objcopy")
@@ -65,12 +91,21 @@ def BuildUniversalPayload(Args, MacroList):
     BuildModule += Defines
     RunCommand(BuildModule)
 
+    #
+    # Buid Universal Payload Information Section ".upld_info"
+    #
+    upld_info_hdr = UPLD_INFO_HEADER()
+    upld_info_hdr.ImageId = Args.ImageId.encode()[:16]
+    fp = open(UpldInfoFile, 'wb')
+    fp.write(bytearray(upld_info_hdr))
+    fp.close()
+
     #
     # Copy the DXEFV as a section in elf format Universal Payload entry.
     #
-    remove_section = '"%s" -I elf64-x86-64 -O elf64-x86-64 --remove-section .upld.uefi_fv %s'%(LlvmObjcopyPath, EntryOutputDir)
-    add_section = '"%s" -I elf64-x86-64 -O elf64-x86-64 --add-section .upld.uefi_fv=%s %s'%(LlvmObjcopyPath, FvOutputDir, EntryOutputDir)
-    set_section = '"%s" -I elf64-x86-64 -O elf64-x86-64 --set-section-alignment .upld.uefi_fv=16 %s'%(LlvmObjcopyPath, EntryOutputDir)
+    remove_section = '"%s" -I elf64-x86-64 -O elf64-x86-64 --remove-section .upld_info --remove-section .upld.uefi_fv %s'%(LlvmObjcopyPath, EntryOutputDir)
+    add_section    = '"%s" -I elf64-x86-64 -O elf64-x86-64 --add-section .upld_info=%s --add-section .upld.uefi_fv=%s %s'%(LlvmObjcopyPath, UpldInfoFile, FvOutputDir, EntryOutputDir)
+    set_section    = '"%s" -I elf64-x86-64 -O elf64-x86-64 --set-section-alignment .upld.upld_info=16 --set-section-alignment .upld.uefi_fv=16 %s'%(LlvmObjcopyPath, EntryOutputDir)
     RunCommand(remove_section)
     RunCommand(add_section)
     RunCommand(set_section)
@@ -82,6 +117,7 @@ def main():
     parser.add_argument('-t', '--ToolChain')
     parser.add_argument('-b', '--Target', default='DEBUG')
     parser.add_argument("-D", "--Macro", action="append", default=["UNIVERSAL_PAYLOAD=TRUE"])
+    parser.add_argument('-i', '--ImageId', type=str, help='Specify payload ID (16 bytes maximal).', default ='UEFI')
     MacroList = {}
     args = parser.parse_args()
     if args.Macro is not None:
-- 
2.32.0.windows.2


^ permalink raw reply related	[flat|nested] 3+ messages in thread

* Re: [`edk2-devel][PATCH v2] UefiPayloadPkg: Add ".upld_info" in universal payload
  2021-09-25 23:12 [`edk2-devel][PATCH v2] UefiPayloadPkg: Add ".upld_info" in universal payload Guo Dong
@ 2021-09-26  2:09 ` Ni, Ray
  2021-09-26  2:33   ` duntan
  0 siblings, 1 reply; 3+ messages in thread
From: Ni, Ray @ 2021-09-26  2:09 UTC (permalink / raw)
  To: Dong, Guo, devel@edk2.groups.io; +Cc: Ma, Maurice, You, Benjamin, Tan, Dun

Reviewed-by: Ray Ni <ray.ni@intel.com>

Dun, any comments?

-----Original Message-----
From: Dong, Guo <guo.dong@intel.com> 
Sent: Sunday, September 26, 2021 7:12 AM
To: devel@edk2.groups.io
Cc: Dong, Guo <guo.dong@intel.com>; Ni, Ray <ray.ni@intel.com>; Ma, Maurice <maurice.ma@intel.com>; You, Benjamin <benjamin.you@intel.com>
Subject: [`edk2-devel][PATCH v2] UefiPayloadPkg: Add ".upld_info" in universal payload

From: Guo Dong <guo.dong@intel.com>

V2: Use LittleEndianStructure by review comment.

>From the universal scalable firmware payload requirement V0.75,
Payload must have Universal Payload Information Section ".upld_info"
So update the build tool to add this section.

Cc: Ray Ni <ray.ni@intel.com>
Cc: Maurice Ma <maurice.ma@intel.com>
Cc: Benjamin You <benjamin.you@intel.com>
Signed-off-by: Guo Dong <guo.dong@intel.com>
---
 UefiPayloadPkg/UniversalPayloadBuild.py | 42 +++++++++++++++++++++++++++++++++++++++---
 1 file changed, 39 insertions(+), 3 deletions(-)

diff --git a/UefiPayloadPkg/UniversalPayloadBuild.py b/UefiPayloadPkg/UniversalPayloadBuild.py
index b78c6a7620..e624ec5874 100644
--- a/UefiPayloadPkg/UniversalPayloadBuild.py
+++ b/UefiPayloadPkg/UniversalPayloadBuild.py
@@ -10,6 +10,31 @@ import subprocess
 import os

 import shutil

 import sys

+from   ctypes import *

+

+sys.dont_write_bytecode = True

+

+class UPLD_INFO_HEADER(LittleEndianStructure):

+    _pack_ = 1

+    _fields_ = [

+        ('Identifier',           ARRAY(c_char, 4)),

+        ('HeaderLength',         c_uint32),

+        ('SpecRevision',         c_uint16),

+        ('Reserved',             c_uint16),

+        ('Revision',             c_uint32),

+        ('Attribute',            c_uint32),

+        ('Capability',           c_uint32),

+        ('ProducerId',           ARRAY(c_char, 16)),

+        ('ImageId',              ARRAY(c_char, 16)),

+        ]

+

+    def __init__(self):

+        self.Identifier     =  b'UPLD'

+        self.HeaderLength   = sizeof(UPLD_INFO_HEADER)

+        self.HeaderRevision = 0x0075

+        self.Revision       = 0x0000010105

+        self.ImageId        = b'UEFI'

+        self.ProducerId     = b'INTEL'

 

 def RunCommand(cmd):

     print(cmd)

@@ -37,6 +62,7 @@ def BuildUniversalPayload(Args, MacroList):
     EntryOutputDir = os.path.join(BuildDir, f"{BuildTarget}_{ElfToolChain}", os.path.normpath("X64/UefiPayloadPkg/UefiPayloadEntry/UniversalPayloadEntry/DEBUG/UniversalPayloadEntry.dll"))

     PayloadReportPath = os.path.join(BuildDir, "UefiUniversalPayload.txt")

     ModuleReportPath = os.path.join(BuildDir, "UefiUniversalPayloadEntry.txt")

+    UpldInfoFile = os.path.join(BuildDir, "UniversalPayloadInfo.bin")

 

     if "CLANG_BIN" in os.environ:

         LlvmObjcopyPath = os.path.join(os.environ["CLANG_BIN"], "llvm-objcopy")

@@ -65,12 +91,21 @@ def BuildUniversalPayload(Args, MacroList):
     BuildModule += Defines

     RunCommand(BuildModule)

 

+    #

+    # Buid Universal Payload Information Section ".upld_info"

+    #

+    upld_info_hdr = UPLD_INFO_HEADER()

+    upld_info_hdr.ImageId = Args.ImageId.encode()[:16]

+    fp = open(UpldInfoFile, 'wb')

+    fp.write(bytearray(upld_info_hdr))

+    fp.close()

+

     #

     # Copy the DXEFV as a section in elf format Universal Payload entry.

     #

-    remove_section = '"%s" -I elf64-x86-64 -O elf64-x86-64 --remove-section .upld.uefi_fv %s'%(LlvmObjcopyPath, EntryOutputDir)

-    add_section = '"%s" -I elf64-x86-64 -O elf64-x86-64 --add-section .upld.uefi_fv=%s %s'%(LlvmObjcopyPath, FvOutputDir, EntryOutputDir)

-    set_section = '"%s" -I elf64-x86-64 -O elf64-x86-64 --set-section-alignment .upld.uefi_fv=16 %s'%(LlvmObjcopyPath, EntryOutputDir)

+    remove_section = '"%s" -I elf64-x86-64 -O elf64-x86-64 --remove-section .upld_info --remove-section .upld.uefi_fv %s'%(LlvmObjcopyPath, EntryOutputDir)

+    add_section    = '"%s" -I elf64-x86-64 -O elf64-x86-64 --add-section .upld_info=%s --add-section .upld.uefi_fv=%s %s'%(LlvmObjcopyPath, UpldInfoFile, FvOutputDir, EntryOutputDir)

+    set_section    = '"%s" -I elf64-x86-64 -O elf64-x86-64 --set-section-alignment .upld.upld_info=16 --set-section-alignment .upld.uefi_fv=16 %s'%(LlvmObjcopyPath, EntryOutputDir)

     RunCommand(remove_section)

     RunCommand(add_section)

     RunCommand(set_section)

@@ -82,6 +117,7 @@ def main():
     parser.add_argument('-t', '--ToolChain')

     parser.add_argument('-b', '--Target', default='DEBUG')

     parser.add_argument("-D", "--Macro", action="append", default=["UNIVERSAL_PAYLOAD=TRUE"])

+    parser.add_argument('-i', '--ImageId', type=str, help='Specify payload ID (16 bytes maximal).', default ='UEFI')

     MacroList = {}

     args = parser.parse_args()

     if args.Macro is not None:

-- 
2.32.0.windows.2


^ permalink raw reply related	[flat|nested] 3+ messages in thread

* Re: [`edk2-devel][PATCH v2] UefiPayloadPkg: Add ".upld_info" in universal payload
  2021-09-26  2:09 ` Ni, Ray
@ 2021-09-26  2:33   ` duntan
  0 siblings, 0 replies; 3+ messages in thread
From: duntan @ 2021-09-26  2:33 UTC (permalink / raw)
  To: Ni, Ray, Dong, Guo, devel@edk2.groups.io; +Cc: Ma, Maurice, You, Benjamin

Hi Ray,
I have no comments.

Thanks,
Dun
-----Original Message-----
From: Ni, Ray <ray.ni@intel.com> 
Sent: Sunday, September 26, 2021 10:10 AM
To: Dong, Guo <guo.dong@intel.com>; devel@edk2.groups.io
Cc: Ma, Maurice <maurice.ma@intel.com>; You, Benjamin <benjamin.you@intel.com>; Tan, Dun <dun.tan@intel.com>
Subject: RE: [`edk2-devel][PATCH v2] UefiPayloadPkg: Add ".upld_info" in universal payload

Reviewed-by: Ray Ni <ray.ni@intel.com>

Dun, any comments?

-----Original Message-----
From: Dong, Guo <guo.dong@intel.com>
Sent: Sunday, September 26, 2021 7:12 AM
To: devel@edk2.groups.io
Cc: Dong, Guo <guo.dong@intel.com>; Ni, Ray <ray.ni@intel.com>; Ma, Maurice <maurice.ma@intel.com>; You, Benjamin <benjamin.you@intel.com>
Subject: [`edk2-devel][PATCH v2] UefiPayloadPkg: Add ".upld_info" in universal payload

From: Guo Dong <guo.dong@intel.com>

V2: Use LittleEndianStructure by review comment.

>From the universal scalable firmware payload requirement V0.75, Payload must have Universal Payload Information Section ".upld_info"
So update the build tool to add this section.

Cc: Ray Ni <ray.ni@intel.com>
Cc: Maurice Ma <maurice.ma@intel.com>
Cc: Benjamin You <benjamin.you@intel.com>
Signed-off-by: Guo Dong <guo.dong@intel.com>
---
 UefiPayloadPkg/UniversalPayloadBuild.py | 42 +++++++++++++++++++++++++++++++++++++++---
 1 file changed, 39 insertions(+), 3 deletions(-)

diff --git a/UefiPayloadPkg/UniversalPayloadBuild.py b/UefiPayloadPkg/UniversalPayloadBuild.py
index b78c6a7620..e624ec5874 100644
--- a/UefiPayloadPkg/UniversalPayloadBuild.py
+++ b/UefiPayloadPkg/UniversalPayloadBuild.py
@@ -10,6 +10,31 @@ import subprocess
 import os

 import shutil

 import sys

+from   ctypes import *

+

+sys.dont_write_bytecode = True

+

+class UPLD_INFO_HEADER(LittleEndianStructure):

+    _pack_ = 1

+    _fields_ = [

+        ('Identifier',           ARRAY(c_char, 4)),

+        ('HeaderLength',         c_uint32),

+        ('SpecRevision',         c_uint16),

+        ('Reserved',             c_uint16),

+        ('Revision',             c_uint32),

+        ('Attribute',            c_uint32),

+        ('Capability',           c_uint32),

+        ('ProducerId',           ARRAY(c_char, 16)),

+        ('ImageId',              ARRAY(c_char, 16)),

+        ]

+

+    def __init__(self):

+        self.Identifier     =  b'UPLD'

+        self.HeaderLength   = sizeof(UPLD_INFO_HEADER)

+        self.HeaderRevision = 0x0075

+        self.Revision       = 0x0000010105

+        self.ImageId        = b'UEFI'

+        self.ProducerId     = b'INTEL'

 

 def RunCommand(cmd):

     print(cmd)

@@ -37,6 +62,7 @@ def BuildUniversalPayload(Args, MacroList):
     EntryOutputDir = os.path.join(BuildDir, f"{BuildTarget}_{ElfToolChain}", os.path.normpath("X64/UefiPayloadPkg/UefiPayloadEntry/UniversalPayloadEntry/DEBUG/UniversalPayloadEntry.dll"))

     PayloadReportPath = os.path.join(BuildDir, "UefiUniversalPayload.txt")

     ModuleReportPath = os.path.join(BuildDir, "UefiUniversalPayloadEntry.txt")

+    UpldInfoFile = os.path.join(BuildDir, "UniversalPayloadInfo.bin")

 

     if "CLANG_BIN" in os.environ:

         LlvmObjcopyPath = os.path.join(os.environ["CLANG_BIN"], "llvm-objcopy")

@@ -65,12 +91,21 @@ def BuildUniversalPayload(Args, MacroList):
     BuildModule += Defines

     RunCommand(BuildModule)

 

+    #

+    # Buid Universal Payload Information Section ".upld_info"

+    #

+    upld_info_hdr = UPLD_INFO_HEADER()

+    upld_info_hdr.ImageId = Args.ImageId.encode()[:16]

+    fp = open(UpldInfoFile, 'wb')

+    fp.write(bytearray(upld_info_hdr))

+    fp.close()

+

     #

     # Copy the DXEFV as a section in elf format Universal Payload entry.

     #

-    remove_section = '"%s" -I elf64-x86-64 -O elf64-x86-64 --remove-section .upld.uefi_fv %s'%(LlvmObjcopyPath, EntryOutputDir)

-    add_section = '"%s" -I elf64-x86-64 -O elf64-x86-64 --add-section .upld.uefi_fv=%s %s'%(LlvmObjcopyPath, FvOutputDir, EntryOutputDir)

-    set_section = '"%s" -I elf64-x86-64 -O elf64-x86-64 --set-section-alignment .upld.uefi_fv=16 %s'%(LlvmObjcopyPath, EntryOutputDir)

+    remove_section = '"%s" -I elf64-x86-64 -O elf64-x86-64 
+ --remove-section .upld_info --remove-section .upld.uefi_fv 
+ %s'%(LlvmObjcopyPath, EntryOutputDir)

+    add_section    = '"%s" -I elf64-x86-64 -O elf64-x86-64 --add-section .upld_info=%s --add-section .upld.uefi_fv=%s %s'%(LlvmObjcopyPath, UpldInfoFile, FvOutputDir, EntryOutputDir)

+    set_section    = '"%s" -I elf64-x86-64 -O elf64-x86-64 --set-section-alignment .upld.upld_info=16 --set-section-alignment .upld.uefi_fv=16 %s'%(LlvmObjcopyPath, EntryOutputDir)

     RunCommand(remove_section)

     RunCommand(add_section)

     RunCommand(set_section)

@@ -82,6 +117,7 @@ def main():
     parser.add_argument('-t', '--ToolChain')

     parser.add_argument('-b', '--Target', default='DEBUG')

     parser.add_argument("-D", "--Macro", action="append", default=["UNIVERSAL_PAYLOAD=TRUE"])

+    parser.add_argument('-i', '--ImageId', type=str, help='Specify 
+ payload ID (16 bytes maximal).', default ='UEFI')

     MacroList = {}

     args = parser.parse_args()

     if args.Macro is not None:

--
2.32.0.windows.2


^ permalink raw reply related	[flat|nested] 3+ messages in thread

end of thread, other threads:[~2021-09-26  2:33 UTC | newest]

Thread overview: 3+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2021-09-25 23:12 [`edk2-devel][PATCH v2] UefiPayloadPkg: Add ".upld_info" in universal payload Guo Dong
2021-09-26  2:09 ` Ni, Ray
2021-09-26  2:33   ` duntan

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox