* [PATCH v8 2/9] bootimg_pcbios: move syslinux funcs to end of file
2025-08-14 4:25 [PATCH v8 1/9] bootimg_pcbios: move syslinux install into seperate functions Vincent Davis Jr
@ 2025-08-14 4:25 ` Vincent Davis Jr
2025-08-14 4:25 ` [PATCH v8 3/9] bootimg_pcbios: seperate bootloader config creation Vincent Davis Jr
` (6 subsequent siblings)
7 siblings, 0 replies; 9+ messages in thread
From: Vincent Davis Jr @ 2025-08-14 4:25 UTC (permalink / raw)
To: openembedded-core; +Cc: Vincent Davis Jr
This commit moves the seperated syslinux creation
functions from their current position to end of
file in the order
1. _do_configure_syslinux
2. _do_prepare_syslinux
3. _do_install_syslinux
This is to prepare for inclusion of other
bootloaders. It also makes reading
through the wics plugin much easier if
you group bootloader specific partition
creation functions together and place them
at the bottom of the file versus leaving
them in their current position.
Signed-off-by: Vincent Davis Jr. <vince@underview.tech>
---
.../lib/wic/plugins/source/bootimg_pcbios.py | 78 +++++++++----------
1 file changed, 39 insertions(+), 39 deletions(-)
diff --git a/scripts/lib/wic/plugins/source/bootimg_pcbios.py b/scripts/lib/wic/plugins/source/bootimg_pcbios.py
index 6bde7a67d3..9ad301b008 100644
--- a/scripts/lib/wic/plugins/source/bootimg_pcbios.py
+++ b/scripts/lib/wic/plugins/source/bootimg_pcbios.py
@@ -54,36 +54,6 @@ class BootimgPcbiosPlugin(SourcePlugin):
cls._do_install_syslinux(disk, disk_name, creator, workdir, oe_builddir,
bootimg_dir, kernel_dir, native_sysroot)
- @classmethod
- def _do_install_syslinux(cls, disk, disk_name, creator, workdir, oe_builddir,
- bootimg_dir, kernel_dir, native_sysroot):
- """
- Called after all partitions have been prepared and assembled into a
- disk image. In this case, we install the MBR.
- """
-
- bootimg_dir = cls._get_bootimg_dir(bootimg_dir, 'syslinux')
- mbrfile = "%s/syslinux/" % bootimg_dir
- if creator.ptable_format == 'msdos':
- mbrfile += "mbr.bin"
- elif creator.ptable_format == 'gpt':
- mbrfile += "gptmbr.bin"
- else:
- raise WicError("Unsupported partition table: %s" %
- creator.ptable_format)
-
- if not os.path.exists(mbrfile):
- raise WicError("Couldn't find %s. If using the -e option, do you "
- "have the right MACHINE set in local.conf? If not, "
- "is the bootimg_dir path correct?" % mbrfile)
-
- full_path = creator._full_path(workdir, disk_name, "direct")
- logger.debug("Installing MBR on disk %s as %s with size %s bytes",
- disk_name, full_path, disk.min_size)
-
- dd_cmd = "dd if=%s of=%s conv=notrunc" % (mbrfile, full_path)
- exec_cmd(dd_cmd, native_sysroot)
-
@classmethod
def do_configure_partition(cls, part, source_params, creator, cr_workdir,
oe_builddir, bootimg_dir, kernel_dir,
@@ -93,6 +63,15 @@ class BootimgPcbiosPlugin(SourcePlugin):
oe_builddir, bootimg_dir, kernel_dir,
native_sysroot)
+ @classmethod
+ def do_prepare_partition(cls, part, source_params, creator, cr_workdir,
+ oe_builddir, bootimg_dir, kernel_dir,
+ rootfs_dir, native_sysroot):
+
+ cls._do_prepare_syslinux(part, source_params, creator, cr_workdir,
+ oe_builddir, bootimg_dir, kernel_dir,
+ rootfs_dir, native_sysroot)
+
@classmethod
def _do_configure_syslinux(cls, part, source_params, creator, cr_workdir,
oe_builddir, bootimg_dir, kernel_dir,
@@ -152,15 +131,6 @@ class BootimgPcbiosPlugin(SourcePlugin):
cfg.write(syslinux_conf)
cfg.close()
- @classmethod
- def do_prepare_partition(cls, part, source_params, creator, cr_workdir,
- oe_builddir, bootimg_dir, kernel_dir,
- rootfs_dir, native_sysroot):
-
- cls._do_prepare_syslinux(part, source_params, creator, cr_workdir,
- oe_builddir, bootimg_dir, kernel_dir,
- rootfs_dir, native_sysroot)
-
@classmethod
def _do_prepare_syslinux(cls, part, source_params, creator, cr_workdir,
oe_builddir, bootimg_dir, kernel_dir,
@@ -234,3 +204,33 @@ class BootimgPcbiosPlugin(SourcePlugin):
part.size = int(bootimg_size)
part.source_file = bootimg
+
+ @classmethod
+ def _do_install_syslinux(cls, disk, disk_name, creator, workdir, oe_builddir,
+ bootimg_dir, kernel_dir, native_sysroot):
+ """
+ Called after all partitions have been prepared and assembled into a
+ disk image. In this case, we install the MBR.
+ """
+
+ bootimg_dir = cls._get_bootimg_dir(bootimg_dir, 'syslinux')
+ mbrfile = "%s/syslinux/" % bootimg_dir
+ if creator.ptable_format == 'msdos':
+ mbrfile += "mbr.bin"
+ elif creator.ptable_format == 'gpt':
+ mbrfile += "gptmbr.bin"
+ else:
+ raise WicError("Unsupported partition table: %s" %
+ creator.ptable_format)
+
+ if not os.path.exists(mbrfile):
+ raise WicError("Couldn't find %s. If using the -e option, do you "
+ "have the right MACHINE set in local.conf? If not, "
+ "is the bootimg_dir path correct?" % mbrfile)
+
+ full_path = creator._full_path(workdir, disk_name, "direct")
+ logger.debug("Installing MBR on disk %s as %s with size %s bytes",
+ disk_name, full_path, disk.min_size)
+
+ dd_cmd = "dd if=%s of=%s conv=notrunc" % (mbrfile, full_path)
+ exec_cmd(dd_cmd, native_sysroot)
--
2.34.1
^ permalink raw reply related [flat|nested] 9+ messages in thread* [PATCH v8 3/9] bootimg_pcbios: seperate bootloader config creation
2025-08-14 4:25 [PATCH v8 1/9] bootimg_pcbios: move syslinux install into seperate functions Vincent Davis Jr
2025-08-14 4:25 ` [PATCH v8 2/9] bootimg_pcbios: move syslinux funcs to end of file Vincent Davis Jr
@ 2025-08-14 4:25 ` Vincent Davis Jr
2025-08-14 4:25 ` [PATCH v8 4/9] bootimg_pcbios: cleanup _do_configure_syslinux function Vincent Davis Jr
` (5 subsequent siblings)
7 siblings, 0 replies; 9+ messages in thread
From: Vincent Davis Jr @ 2025-08-14 4:25 UTC (permalink / raw)
To: openembedded-core; +Cc: Vincent Davis Jr
Most bootloaders that will be included in this
wics plugin will require a configuration file
to define kernel params, execute custom
modules, or enable the ability to select
one of multiple boot entries.
Create a seperate generic function to facilitate
finding if a bootloader config file passed through
bootloader --configfile flag. So, that other functions
that are used to create/install a bootloader boot
configuration file can leverage the function.
Signed-off-by: Vincent Davis Jr. <vince@underview.tech>
---
.../lib/wic/plugins/source/bootimg_pcbios.py | 31 +++++++++++--------
1 file changed, 18 insertions(+), 13 deletions(-)
diff --git a/scripts/lib/wic/plugins/source/bootimg_pcbios.py b/scripts/lib/wic/plugins/source/bootimg_pcbios.py
index 9ad301b008..47fd4b9415 100644
--- a/scripts/lib/wic/plugins/source/bootimg_pcbios.py
+++ b/scripts/lib/wic/plugins/source/bootimg_pcbios.py
@@ -72,6 +72,22 @@ class BootimgPcbiosPlugin(SourcePlugin):
oe_builddir, bootimg_dir, kernel_dir,
rootfs_dir, native_sysroot)
+ @classmethod
+ def _get_bootloader_config(cls, bootloader, loader):
+ custom_cfg = None
+
+ if bootloader.configfile:
+ custom_cfg = get_custom_config(bootloader.configfile)
+ if custom_cfg:
+ logger.debug("Using custom configuration file %s "
+ "for %s.cfg", bootloader.configfile,
+ loader)
+ return custom_cfg
+ else:
+ raise WicError("configfile is specified but failed to "
+ "get it from %s." % bootloader.configfile)
+ return custom_cfg
+
@classmethod
def _do_configure_syslinux(cls, part, source_params, creator, cr_workdir,
oe_builddir, bootimg_dir, kernel_dir,
@@ -86,20 +102,9 @@ class BootimgPcbiosPlugin(SourcePlugin):
exec_cmd(install_cmd)
bootloader = creator.ks.bootloader
+ syslinux_conf = cls._get_bootloader_config(bootloader, 'syslinux')
- custom_cfg = None
- if bootloader.configfile:
- custom_cfg = get_custom_config(bootloader.configfile)
- if custom_cfg:
- # Use a custom configuration for grub
- syslinux_conf = custom_cfg
- logger.debug("Using custom configuration file %s "
- "for syslinux.cfg", bootloader.configfile)
- else:
- raise WicError("configfile is specified but failed to "
- "get it from %s." % bootloader.configfile)
-
- if not custom_cfg:
+ if not syslinux_conf:
# Create syslinux configuration using parameters from wks file
splash = os.path.join(cr_workdir, "/hdd/boot/splash.jpg")
if os.path.exists(splash):
--
2.34.1
^ permalink raw reply related [flat|nested] 9+ messages in thread* [PATCH v8 4/9] bootimg_pcbios: cleanup _do_configure_syslinux function
2025-08-14 4:25 [PATCH v8 1/9] bootimg_pcbios: move syslinux install into seperate functions Vincent Davis Jr
2025-08-14 4:25 ` [PATCH v8 2/9] bootimg_pcbios: move syslinux funcs to end of file Vincent Davis Jr
2025-08-14 4:25 ` [PATCH v8 3/9] bootimg_pcbios: seperate bootloader config creation Vincent Davis Jr
@ 2025-08-14 4:25 ` Vincent Davis Jr
2025-08-14 4:25 ` [PATCH v8 5/9] bootimg_pcbios: cleanup prepare and install syslinux funcs Vincent Davis Jr
` (4 subsequent siblings)
7 siblings, 0 replies; 9+ messages in thread
From: Vincent Davis Jr @ 2025-08-14 4:25 UTC (permalink / raw)
To: openembedded-core; +Cc: Vincent Davis Jr
This commit:
1. Removes all unrequired function parameters.
The part parameter was kept due to it's potential
future usage in _do_configure_syslinux function.
part.fstype specifically may be used with the
rootfstype kernel paramater.
2. Sets a default timeout to 500 if bootloader --timeout
not specified. To avoid 'None' being placed
as the value in resulting configuartion file.
3. Sets a default kernel parameter string if
bootloader --append not specified. This also
helps avoid 'None' being places as the value
in resulting configuration file.
4. Replace all instances of
cr_workdir, "/hdd/boot"
with variable
hdddir
as it's set at the top of the function. No,
need to re-implement what the variable is
already defined to store.
Signed-off-by: Vincent Davis Jr <vince@underview.tech>
---
.../lib/wic/plugins/source/bootimg_pcbios.py | 25 ++++++++++++-------
1 file changed, 16 insertions(+), 9 deletions(-)
diff --git a/scripts/lib/wic/plugins/source/bootimg_pcbios.py b/scripts/lib/wic/plugins/source/bootimg_pcbios.py
index 47fd4b9415..887a548cde 100644
--- a/scripts/lib/wic/plugins/source/bootimg_pcbios.py
+++ b/scripts/lib/wic/plugins/source/bootimg_pcbios.py
@@ -59,9 +59,7 @@ class BootimgPcbiosPlugin(SourcePlugin):
oe_builddir, bootimg_dir, kernel_dir,
native_sysroot):
- cls._do_configure_syslinux(part, source_params, creator, cr_workdir,
- oe_builddir, bootimg_dir, kernel_dir,
- native_sysroot)
+ cls._do_configure_syslinux(part, creator, cr_workdir)
@classmethod
def do_prepare_partition(cls, part, source_params, creator, cr_workdir,
@@ -89,9 +87,7 @@ class BootimgPcbiosPlugin(SourcePlugin):
return custom_cfg
@classmethod
- def _do_configure_syslinux(cls, part, source_params, creator, cr_workdir,
- oe_builddir, bootimg_dir, kernel_dir,
- native_sysroot):
+ def _do_configure_syslinux(cls, part, creator, cr_workdir):
"""
Called before do_prepare_partition(), creates syslinux config
"""
@@ -106,12 +102,24 @@ class BootimgPcbiosPlugin(SourcePlugin):
if not syslinux_conf:
# Create syslinux configuration using parameters from wks file
- splash = os.path.join(cr_workdir, "/hdd/boot/splash.jpg")
+ splash = os.path.join(hdddir, "/splash.jpg")
if os.path.exists(splash):
splashline = "menu background splash.jpg"
else:
splashline = ""
+ # Set a default timeout if none specified to avoid
+ # 'None' being the value placed within the configuration
+ # file.
+ if not bootloader.timeout:
+ bootloader.timeout = 500
+
+ # Set a default kernel params string if none specified
+ # to avoid 'None' being the value placed within the
+ # configuration file.
+ if not bootloader.append:
+ bootloader.append = "rootwait console=ttyS0,115200 console=tty0"
+
syslinux_conf = ""
syslinux_conf += "PROMPT 0\n"
syslinux_conf += "TIMEOUT " + str(bootloader.timeout) + "\n"
@@ -130,8 +138,7 @@ class BootimgPcbiosPlugin(SourcePlugin):
syslinux_conf += "APPEND label=boot root=%s %s\n" % \
(creator.rootdev, bootloader.append)
- logger.debug("Writing syslinux config %s/hdd/boot/syslinux.cfg",
- cr_workdir)
+ logger.debug("Writing syslinux config %s/syslinux.cfg", hdddir)
cfg = open("%s/hdd/boot/syslinux.cfg" % cr_workdir, "w")
cfg.write(syslinux_conf)
cfg.close()
--
2.34.1
^ permalink raw reply related [flat|nested] 9+ messages in thread* [PATCH v8 5/9] bootimg_pcbios: cleanup prepare and install syslinux funcs
2025-08-14 4:25 [PATCH v8 1/9] bootimg_pcbios: move syslinux install into seperate functions Vincent Davis Jr
` (2 preceding siblings ...)
2025-08-14 4:25 ` [PATCH v8 4/9] bootimg_pcbios: cleanup _do_configure_syslinux function Vincent Davis Jr
@ 2025-08-14 4:25 ` Vincent Davis Jr
2025-08-14 4:25 ` [PATCH v8 6/9] bootimg_pcbios: add funcs to configure booting with grub Vincent Davis Jr
` (3 subsequent siblings)
7 siblings, 0 replies; 9+ messages in thread
From: Vincent Davis Jr @ 2025-08-14 4:25 UTC (permalink / raw)
To: openembedded-core; +Cc: Vincent Davis Jr
This commit:
1. Removes unrequired function params from
* _do_prepare_syslinux
* _do_install_syslinux
Reason is that they aren't required by
the function.
2. Moves finding of resulting wic image
back into do_install_disk task. As
the same code may be leverage to install
other bootloaders to the resulting disk.
Signed-off-by: Vincent Davis Jr. <vince@underview.tech>
---
.../lib/wic/plugins/source/bootimg_pcbios.py | 25 ++++++++-----------
1 file changed, 11 insertions(+), 14 deletions(-)
diff --git a/scripts/lib/wic/plugins/source/bootimg_pcbios.py b/scripts/lib/wic/plugins/source/bootimg_pcbios.py
index 887a548cde..a4fabec0ae 100644
--- a/scripts/lib/wic/plugins/source/bootimg_pcbios.py
+++ b/scripts/lib/wic/plugins/source/bootimg_pcbios.py
@@ -50,9 +50,12 @@ class BootimgPcbiosPlugin(SourcePlugin):
@classmethod
def do_install_disk(cls, disk, disk_name, creator, workdir, oe_builddir,
bootimg_dir, kernel_dir, native_sysroot):
+ full_path = creator._full_path(workdir, disk_name, "direct")
+ logger.debug("Installing MBR on disk %s as %s with size %s bytes",
+ disk_name, full_path, disk.min_size)
- cls._do_install_syslinux(disk, disk_name, creator, workdir, oe_builddir,
- bootimg_dir, kernel_dir, native_sysroot)
+ cls._do_install_syslinux(creator, bootimg_dir,
+ native_sysroot, full_path)
@classmethod
def do_configure_partition(cls, part, source_params, creator, cr_workdir,
@@ -66,9 +69,8 @@ class BootimgPcbiosPlugin(SourcePlugin):
oe_builddir, bootimg_dir, kernel_dir,
rootfs_dir, native_sysroot):
- cls._do_prepare_syslinux(part, source_params, creator, cr_workdir,
- oe_builddir, bootimg_dir, kernel_dir,
- rootfs_dir, native_sysroot)
+ cls._do_prepare_syslinux(part, cr_workdir, bootimg_dir,
+ kernel_dir, native_sysroot)
@classmethod
def _get_bootloader_config(cls, bootloader, loader):
@@ -144,9 +146,8 @@ class BootimgPcbiosPlugin(SourcePlugin):
cfg.close()
@classmethod
- def _do_prepare_syslinux(cls, part, source_params, creator, cr_workdir,
- oe_builddir, bootimg_dir, kernel_dir,
- rootfs_dir, native_sysroot):
+ def _do_prepare_syslinux(cls, part, cr_workdir, bootimg_dir,
+ kernel_dir, native_sysroot):
"""
Called to do the actual content population for a partition i.e. it
'prepares' the partition to be incorporated into the image.
@@ -218,8 +219,8 @@ class BootimgPcbiosPlugin(SourcePlugin):
part.source_file = bootimg
@classmethod
- def _do_install_syslinux(cls, disk, disk_name, creator, workdir, oe_builddir,
- bootimg_dir, kernel_dir, native_sysroot):
+ def _do_install_syslinux(cls, creator, bootimg_dir,
+ native_sysroot, full_path):
"""
Called after all partitions have been prepared and assembled into a
disk image. In this case, we install the MBR.
@@ -240,9 +241,5 @@ class BootimgPcbiosPlugin(SourcePlugin):
"have the right MACHINE set in local.conf? If not, "
"is the bootimg_dir path correct?" % mbrfile)
- full_path = creator._full_path(workdir, disk_name, "direct")
- logger.debug("Installing MBR on disk %s as %s with size %s bytes",
- disk_name, full_path, disk.min_size)
-
dd_cmd = "dd if=%s of=%s conv=notrunc" % (mbrfile, full_path)
exec_cmd(dd_cmd, native_sysroot)
--
2.34.1
^ permalink raw reply related [flat|nested] 9+ messages in thread* [PATCH v8 6/9] bootimg_pcbios: add funcs to configure booting with grub
2025-08-14 4:25 [PATCH v8 1/9] bootimg_pcbios: move syslinux install into seperate functions Vincent Davis Jr
` (3 preceding siblings ...)
2025-08-14 4:25 ` [PATCH v8 5/9] bootimg_pcbios: cleanup prepare and install syslinux funcs Vincent Davis Jr
@ 2025-08-14 4:25 ` Vincent Davis Jr
2025-08-14 4:25 ` [PATCH v8 7/9] bootimg_pcbios: include grub as an optional bootloader Vincent Davis Jr
` (2 subsequent siblings)
7 siblings, 0 replies; 9+ messages in thread
From: Vincent Davis Jr @ 2025-08-14 4:25 UTC (permalink / raw)
To: openembedded-core; +Cc: Vincent Davis Jr
Functions added, but not executed during
wic image creation include:
_get_staging_libdir
* Finds target lib directory if for some
reason STAGING_LIBDIR isn't set.
_do_configure_grub
* Will search for a grub configuration passed via
bootloader --configfile. If not found build a
default one which searches for partition that
contains the given the kernel name via grub
search module.
_do_prepare_grub
1. Sets default values for GRUB_MKIMAGE_FORMAT_PC
and GRUB_PREFIX_PATH if none specified. Both
variables are required by grub-mkimage.
* GRUB_MKIMAGE_FORMAT_PC is used to define
target platform.
* GRUB_PREFIX_PATH is used to define which
directory grub config and modules are going
to reside in.
2. Generates grub config to embed into core.img.
This config is used to search for partition
containing grub config.
3. Creates a custom core.img or grub stage 1.5
with an embedded grub config.
4. Copies all the target built grub modules into
GRUB_PREFIX_PATH directory.
5. Creates boot partition
_do_install_grub
1. dd target platform specific boot.img to the first
0-440 bytes of the resulting wic image. dd grub
stage 1 to wic image. If this wics plugin is used
with GPT as partition table format and grub selected
as bootloader it's more than likely for grub hybrid
booting because bootimg_efi plugin should and more
than likely will be used in that case. So, boot.img
may be dd regardless if partition table format is
GPT or MBR.
2. dd custom core.img (grub stage 1.5) with embedded
configuration to the resulting wic image starting
at byte 512 up to sizeof(core.img).
3. Both boot.img and core.img are required for legacy
bios boot. See grub Wiki for more details on
boot.img and core.img.
https://en.wikipedia.org/wiki/GNU_GRUB
Commit also imports python modules required by the
above implemented functions.
Signed-off-by: Vincent Davis Jr <vince@underview.tech>
---
.../lib/wic/plugins/source/bootimg_pcbios.py | 167 ++++++++++++++++++
1 file changed, 167 insertions(+)
diff --git a/scripts/lib/wic/plugins/source/bootimg_pcbios.py b/scripts/lib/wic/plugins/source/bootimg_pcbios.py
index a4fabec0ae..f50a5ae0e2 100644
--- a/scripts/lib/wic/plugins/source/bootimg_pcbios.py
+++ b/scripts/lib/wic/plugins/source/bootimg_pcbios.py
@@ -13,7 +13,9 @@
import logging
import os
import re
+import shutil
+from glob import glob
from wic import WicError
from wic.engine import get_custom_config
from wic.pluginbase import SourcePlugin
@@ -72,6 +74,27 @@ class BootimgPcbiosPlugin(SourcePlugin):
cls._do_prepare_syslinux(part, cr_workdir, bootimg_dir,
kernel_dir, native_sysroot)
+ @classmethod
+ def _get_staging_libdir(cls):
+ """
+ For unknown reasons when running test with poky
+ STAGING_LIBDIR gets unset when wic create is executed.
+ Bellow is a hack to determine what STAGING_LIBDIR should
+ be if not specified.
+ """
+
+ staging_libdir = get_bitbake_var('STAGING_LIBDIR')
+ staging_dir_target = get_bitbake_var('STAGING_DIR_TARGET')
+
+ if not staging_libdir:
+ staging_libdir = '%s/usr/lib64' % staging_dir_target
+ if not os.path.isdir(staging_libdir):
+ staging_libdir = '%s/usr/lib32' % staging_dir_target
+ if not os.path.isdir(staging_libdir):
+ staging_libdir = '%s/usr/lib' % staging_dir_target
+
+ return staging_libdir
+
@classmethod
def _get_bootloader_config(cls, bootloader, loader):
custom_cfg = None
@@ -243,3 +266,147 @@ class BootimgPcbiosPlugin(SourcePlugin):
dd_cmd = "dd if=%s of=%s conv=notrunc" % (mbrfile, full_path)
exec_cmd(dd_cmd, native_sysroot)
+
+ @classmethod
+ def _do_configure_grub(cls, part, creator, cr_workdir):
+ hdddir = "%s/hdd" % cr_workdir
+ bootloader = creator.ks.bootloader
+
+ grub_conf = cls._get_bootloader_config(bootloader, 'grub')
+
+ grub_prefix_path = get_bitbake_var('GRUB_PREFIX_PATH')
+ if not grub_prefix_path:
+ grub_prefix_path = '/boot/grub'
+
+ grub_path = "%s/%s" %(hdddir, grub_prefix_path)
+ install_cmd = "install -d %s" % grub_path
+ exec_cmd(install_cmd)
+
+ if not grub_conf:
+ # Set a default timeout if none specified to avoid
+ # 'None' being the value placed within the configuration
+ # file.
+ if not bootloader.timeout:
+ bootloader.timeout = 500
+
+ # Set a default kernel params string if none specified
+ # to avoid 'None' being the value placed within the
+ # configuration file.
+ if not bootloader.append:
+ bootloader.append = "rootwait rootfstype=%s " % (part.fstype)
+ bootloader.append += "console=ttyS0,115200 console=tty0"
+
+ kernel = "/boot/" + get_bitbake_var("KERNEL_IMAGETYPE")
+
+ grub_conf = 'serial --unit=0 --speed=115200 --word=8 --parity=no --stop=1\n'
+ grub_conf += 'set gfxmode=auto\n'
+ grub_conf += 'set gfxpayload=keep\n\n'
+ grub_conf += 'set default=0\n\n'
+ grub_conf += '# Boot automatically after %d secs.\n' % (bootloader.timeout)
+ grub_conf += 'set timeout=%d\n\n' % (bootloader.timeout)
+ grub_conf += 'menuentry \'default\' {\n'
+ grub_conf += '\tsearch --no-floppy --set=root --file %s\n' % (kernel)
+ grub_conf += '\tprobe --set partuuid --part-uuid ($root)\n'
+ grub_conf += '\tlinux %s root=PARTUUID=$partuuid %s\n}\n' % \
+ (kernel, bootloader.append)
+
+ logger.debug("Writing grub config %s/grub.cfg", grub_path)
+ cfg = open("%s/grub.cfg" % grub_path, "w")
+ cfg.write(grub_conf)
+ cfg.close()
+
+ @classmethod
+ def _do_prepare_grub(cls, part, cr_workdir, oe_builddir,
+ kernel_dir, rootfs_dir, native_sysroot):
+ """
+ 1. Generate embed.cfg that'll later be embedded into core.img.
+ So, that core.img knows where to search for grub.cfg.
+ 2. Generate core.img or grub stage 1.5.
+ 3. Copy modules into partition.
+ 4. Create partition rootfs file.
+ """
+
+ hdddir = "%s/hdd" % cr_workdir
+
+ copy_types = [ '*.mod', '*.o', '*.lst' ]
+
+ builtin_modules = 'boot linux ext2 fat serial part_msdos part_gpt \
+ normal multiboot probe biosdisk msdospart configfile search loadenv test'
+
+ staging_libdir = cls._get_staging_libdir()
+
+ grub_format = get_bitbake_var('GRUB_MKIMAGE_FORMAT_PC')
+ if not grub_format:
+ grub_format = 'i386-pc'
+
+ grub_prefix_path = get_bitbake_var('GRUB_PREFIX_PATH')
+ if not grub_prefix_path:
+ grub_prefix_path = '/boot/grub'
+
+ grub_path = "%s/%s" %(hdddir, grub_prefix_path)
+ core_img = '%s/grub-bios-core.img' % (kernel_dir)
+ grub_mods_path = '%s/grub/%s' % (staging_libdir, grub_format)
+
+ # Generate embedded grub config
+ embed_cfg_str = 'search.file %s/grub.cfg root\n' % (grub_prefix_path)
+ embed_cfg_str += 'set prefix=($root)%s\n' % (grub_prefix_path)
+ embed_cfg_str += 'configfile ($root)%s/grub.cfg\n' % (grub_prefix_path)
+ cfg = open('%s/embed.cfg' % (kernel_dir), 'w+')
+ cfg.write(embed_cfg_str)
+ cfg.close()
+
+ # core.img doesn't get included into boot partition
+ # it's later dd onto the resulting wic image.
+ grub_mkimage = 'grub-mkimage \
+ --prefix=%s \
+ --format=%s \
+ --config=%s/embed.cfg \
+ --directory=%s \
+ --output=%s %s' % \
+ (grub_prefix_path, grub_format, kernel_dir,
+ grub_mods_path, core_img, builtin_modules)
+ exec_native_cmd(grub_mkimage, native_sysroot)
+
+ # Copy grub modules
+ install_dir = '%s/%s/%s' % (hdddir, grub_prefix_path, grub_format)
+ os.makedirs(install_dir, exist_ok=True)
+
+ for ctype in copy_types:
+ files = glob('%s/grub/%s/%s' % \
+ (staging_libdir, grub_format, ctype))
+ for file in files:
+ shutil.copy2(file, install_dir, follow_symlinks=True)
+
+ # Create boot partition
+ logger.debug('Prepare partition using rootfs in %s', hdddir)
+ part.prepare_rootfs(cr_workdir, oe_builddir, hdddir,
+ native_sysroot, False)
+
+ @classmethod
+ def _do_install_grub(cls, creator, kernel_dir,
+ native_sysroot, full_path):
+ core_img = '%s/grub-bios-core.img' % (kernel_dir)
+
+ staging_libdir = cls._get_staging_libdir()
+
+ grub_format = get_bitbake_var('GRUB_MKIMAGE_FORMAT_PC')
+ if not grub_format:
+ grub_format = 'i386-pc'
+
+ boot_img = '%s/grub/%s/boot.img' % (staging_libdir, grub_format)
+ if not os.path.exists(boot_img):
+ raise WicError("Couldn't find %s. Did you include "
+ "do_image_wic[depends] += \"grub:do_populate_sysroot\" "
+ "in your image recipe" % boot_img)
+
+ # Install boot.img or grub stage 1
+ dd_cmd = "dd if=%s of=%s conv=notrunc bs=1 seek=0 count=440" % (boot_img, full_path)
+ exec_cmd(dd_cmd, native_sysroot)
+
+ if creator.ptable_format == 'msdos':
+ # Install core.img or grub stage 1.5
+ dd_cmd = "dd if=%s of=%s conv=notrunc bs=1 seek=512" % (core_img, full_path)
+ exec_cmd(dd_cmd, native_sysroot)
+ else:
+ raise WicError("Unsupported partition table: %s" %
+ creator.ptable_format)
--
2.34.1
^ permalink raw reply related [flat|nested] 9+ messages in thread* [PATCH v8 7/9] bootimg_pcbios: include grub as an optional bootloader
2025-08-14 4:25 [PATCH v8 1/9] bootimg_pcbios: move syslinux install into seperate functions Vincent Davis Jr
` (4 preceding siblings ...)
2025-08-14 4:25 ` [PATCH v8 6/9] bootimg_pcbios: add funcs to configure booting with grub Vincent Davis Jr
@ 2025-08-14 4:25 ` Vincent Davis Jr
2025-08-14 4:25 ` [PATCH v8 8/9] bootimg_pcbios: add help and usage comments Vincent Davis Jr
2025-08-14 4:25 ` [PATCH v8 9/9] oe-selftest: add wic.Wic.test_grub_install_pcbios Vincent Davis Jr
7 siblings, 0 replies; 9+ messages in thread
From: Vincent Davis Jr @ 2025-08-14 4:25 UTC (permalink / raw)
To: openembedded-core; +Cc: Vincent Davis Jr
Commit adds in support for installation of both
grub and syslinux using newly added grub functions.
Due to the bootimg_biosplusefi source_params['loader']
had to be named source_params['loader-bios'] so not
to create conflict in the wics plugin.
Commits also adds ability to set and or not set
source_params. If source_params set check
for both
* syslinux
* grub
if not set default to using syslinux as bootloader.
Signed-off-by: Vincent Davis Jr <vince@underview.tech>
---
.../lib/wic/plugins/source/bootimg_pcbios.py | 42 ++++++++++++++++---
1 file changed, 36 insertions(+), 6 deletions(-)
diff --git a/scripts/lib/wic/plugins/source/bootimg_pcbios.py b/scripts/lib/wic/plugins/source/bootimg_pcbios.py
index f50a5ae0e2..1fa9d895bb 100644
--- a/scripts/lib/wic/plugins/source/bootimg_pcbios.py
+++ b/scripts/lib/wic/plugins/source/bootimg_pcbios.py
@@ -31,6 +31,9 @@ class BootimgPcbiosPlugin(SourcePlugin):
name = 'bootimg_pcbios'
+ # Variable required for do_install_disk
+ loader = ''
+
@classmethod
def _get_bootimg_dir(cls, bootimg_dir, dirname):
"""
@@ -56,23 +59,50 @@ class BootimgPcbiosPlugin(SourcePlugin):
logger.debug("Installing MBR on disk %s as %s with size %s bytes",
disk_name, full_path, disk.min_size)
- cls._do_install_syslinux(creator, bootimg_dir,
+ if cls.loader == 'grub':
+ cls._do_install_grub(creator, kernel_dir,
+ native_sysroot, full_path)
+ elif cls.loader == 'syslinux':
+ cls._do_install_syslinux(creator, bootimg_dir,
native_sysroot, full_path)
+ else:
+ raise WicError("boot loader some how not specified check do_prepare_partition")
@classmethod
def do_configure_partition(cls, part, source_params, creator, cr_workdir,
oe_builddir, bootimg_dir, kernel_dir,
native_sysroot):
-
- cls._do_configure_syslinux(part, creator, cr_workdir)
+ try:
+ if source_params['loader-bios'] == 'grub':
+ cls._do_configure_grub(part, creator, cr_workdir)
+ elif source_params['loader-bios'] == 'syslinux':
+ cls._do_configure_syslinux(part, creator, cr_workdir)
+ else:
+ raise WicError("unrecognized bootimg_pcbios loader: %s" % source_params['loader-bios'])
+ except KeyError:
+ cls._do_configure_syslinux(part, creator, cr_workdir)
@classmethod
def do_prepare_partition(cls, part, source_params, creator, cr_workdir,
oe_builddir, bootimg_dir, kernel_dir,
rootfs_dir, native_sysroot):
-
- cls._do_prepare_syslinux(part, cr_workdir, bootimg_dir,
- kernel_dir, native_sysroot)
+ try:
+ if source_params['loader-bios'] == 'grub':
+ cls._do_prepare_grub(part, cr_workdir, oe_builddir,
+ kernel_dir, rootfs_dir, native_sysroot)
+ elif source_params['loader-bios'] == 'syslinux':
+ cls._do_prepare_syslinux(part, cr_workdir, bootimg_dir,
+ kernel_dir, native_sysroot)
+ else:
+ raise WicError("unrecognized bootimg_pcbios loader: %s" % source_params['loader-bios'])
+
+ # Required by do_install_disk
+ cls.loader = source_params['loader-bios']
+ except KeyError:
+ # Required by do_install_disk
+ cls.loader = 'syslinux'
+ cls._do_prepare_syslinux(part, cr_workdir, bootimg_dir,
+ kernel_dir, native_sysroot)
@classmethod
def _get_staging_libdir(cls):
--
2.34.1
^ permalink raw reply related [flat|nested] 9+ messages in thread* [PATCH v8 8/9] bootimg_pcbios: add help and usage comments
2025-08-14 4:25 [PATCH v8 1/9] bootimg_pcbios: move syslinux install into seperate functions Vincent Davis Jr
` (5 preceding siblings ...)
2025-08-14 4:25 ` [PATCH v8 7/9] bootimg_pcbios: include grub as an optional bootloader Vincent Davis Jr
@ 2025-08-14 4:25 ` Vincent Davis Jr
2025-08-14 4:25 ` [PATCH v8 9/9] oe-selftest: add wic.Wic.test_grub_install_pcbios Vincent Davis Jr
7 siblings, 0 replies; 9+ messages in thread
From: Vincent Davis Jr @ 2025-08-14 4:25 UTC (permalink / raw)
To: openembedded-core; +Cc: Vincent Davis Jr
Adds comments underneath class declaration
defining plugin usage and potential
optional variables to set.
Signed-off-by: Vincent Davis Jr <vince@underview.tech>
---
.../lib/wic/plugins/source/bootimg_pcbios.py | 43 ++++++++++++++++++-
1 file changed, 42 insertions(+), 1 deletion(-)
diff --git a/scripts/lib/wic/plugins/source/bootimg_pcbios.py b/scripts/lib/wic/plugins/source/bootimg_pcbios.py
index 1fa9d895bb..caabda6318 100644
--- a/scripts/lib/wic/plugins/source/bootimg_pcbios.py
+++ b/scripts/lib/wic/plugins/source/bootimg_pcbios.py
@@ -26,7 +26,48 @@ logger = logging.getLogger('wic')
class BootimgPcbiosPlugin(SourcePlugin):
"""
- Create MBR boot partition and install syslinux on it.
+ Creates boot partition that is legacy BIOS firmare bootable with
+ MBR/MSDOS as partition table format. Plugin will install caller
+ selected bootloader directly to resulting wic image.
+
+ Supported Bootloaders:
+ * syslinux (default)
+ * grub
+
+ ****************** Wic Plugin Depends/Vars ******************
+ WKS_FILE_DEPENDS = "grub-native grub"
+ WKS_FILE_DEPENDS = "syslinux-native syslinux"
+
+ # Optional variables
+ # GRUB_MKIMAGE_FORMAT_PC - Used to define target platform.
+ # GRUB_PREFIX_PATH - Used to define which directory
+ # grub config and modules are going
+ # to reside in.
+ GRUB_PREFIX_PATH = '/boot/grub2' # Default: /boot/grub
+ GRUB_MKIMAGE_FORMAT_PC = 'i386-pc' # Default: i386-pc
+
+ WICVARS:append = "\
+ GRUB_PREFIX_PATH \
+ GRUB_MKIMAGE_FORMAT_PC \
+ "
+ ****************** Wic Plugin Depends/Vars ******************
+
+
+ **************** Example kickstart Legacy Bios Grub Boot ****************
+ part boot --label bios_boot --fstype ext4 --offset 1024 --fixed-size 78M
+ --source bootimg_pcbios --sourceparams="loader-bios=grub" --active
+
+ part roots --label rootfs --fstype ext4 --source rootfs --use-uuid
+ bootloader --ptable msdos --source bootimg_pcbios
+ **************** Example kickstart Legacy Bios Grub Boot ****************
+
+
+ *************** Example kickstart Legacy Bios Syslinux Boot ****************
+ part /boot --source bootimg_pcbios --sourceparams="loader-bios=syslinux"
+ --ondisk sda --label boot --fstype vfat --align 1024 --active
+
+ part roots --label rootfs --fstype ext4 --source rootfs --use-uuid
+ bootloader --ptable msdos --source bootimg_pcbios
"""
name = 'bootimg_pcbios'
--
2.34.1
^ permalink raw reply related [flat|nested] 9+ messages in thread* [PATCH v8 9/9] oe-selftest: add wic.Wic.test_grub_install_pcbios
2025-08-14 4:25 [PATCH v8 1/9] bootimg_pcbios: move syslinux install into seperate functions Vincent Davis Jr
` (6 preceding siblings ...)
2025-08-14 4:25 ` [PATCH v8 8/9] bootimg_pcbios: add help and usage comments Vincent Davis Jr
@ 2025-08-14 4:25 ` Vincent Davis Jr
7 siblings, 0 replies; 9+ messages in thread
From: Vincent Davis Jr @ 2025-08-14 4:25 UTC (permalink / raw)
To: openembedded-core; +Cc: Vincent Davis Jr
wic.Wic.test_grub_install_pcbios test
Test updates to the bootimg_pcbios plugin that
enables support for installing grub directly
to the resulting wic image.
The test checks to see if the wics plugin
generates a wic image. Then see's if normal.mod
and grub.cfg are located in the boot partition.
Signed-off-by: Vincent Davis Jr <vince@underview.tech>
---
meta/lib/oeqa/selftest/cases/wic.py | 41 +++++++++++++++++++++++++++++
1 file changed, 41 insertions(+)
diff --git a/meta/lib/oeqa/selftest/cases/wic.py b/meta/lib/oeqa/selftest/cases/wic.py
index 680f99d381..44442e402d 100644
--- a/meta/lib/oeqa/selftest/cases/wic.py
+++ b/meta/lib/oeqa/selftest/cases/wic.py
@@ -215,6 +215,47 @@ class Wic(WicTestCase):
found, "The kernel image '{}' was not found in the boot partition".format(kimgtype)
)
+ @skipIfNotArch(['x86_64'])
+ def test_grub_install_pcbios(self):
+ """
+ Test the installation of the grub modules + config
+ into the boot directory in the resulting wic image.
+ """
+
+ # create a temporary file for the WKS content
+ with NamedTemporaryFile("w", suffix=".wks") as wks:
+ wks.write(
+ 'part --source bootimg_pcbios --sourceparams="loader-bios=grub" '
+ '--offset 1024 --fixed-size 78M --label boot --active\n'
+ 'bootloader --ptable msdos --source bootimg_pcbios\n'
+ )
+ wks.flush()
+ # create a temporary directory to extract the disk image to
+ with TemporaryDirectory() as tmpdir:
+ img = "core-image-minimal"
+ config = 'DEPENDS:pn-%s += "grub-native grub"' % (img)
+
+ self.append_config(config)
+ bitbake(img)
+ self.remove_config(config)
+
+ cmd = "wic create %s -e %s -o %s" % (wks.name, img, self.resultdir)
+ runCmd(cmd)
+
+ wksname = os.path.splitext(os.path.basename(wks.name))[0]
+ out = glob(os.path.join(self.resultdir, "%s-*.direct" % wksname))
+ self.assertEqual(1, len(out))
+
+ sysroot = get_bb_var('RECIPE_SYSROOT_NATIVE', 'wic-tools')
+
+ # Check if grub.cfg is installed
+ result = runCmd("wic ls %s:1/boot/grub -n %s" % (out[0], sysroot))
+ self.assertIn('grub', result.output)
+
+ # Check if normal.mod is installed
+ result = runCmd("wic ls %s:1/boot/grub/i386-pc -n %s" % (out[0], sysroot))
+ self.assertIn('normal', result.output)
+
def test_build_image_name(self):
"""Test wic create wictestdisk --image-name=core-image-minimal"""
cmd = "wic create wictestdisk --image-name=core-image-minimal -o %s" % self.resultdir
--
2.34.1
^ permalink raw reply related [flat|nested] 9+ messages in thread