Latest

.github/CODEOWNERS

@@ -3,5 +3,7 @@
 * @sjakki88 @vishwasudupa @bjordiscollaku @simonbeaudoin0935
 
 # Specific ownership for the ubuntu folder
-ubuntu/* @vkraleti @sbanerjee-quic @vishwasudupa @bjordiscollaku
-
+scripts/*    @vishwasudupa @bjordiscollaku @simonbeaudoin0935
+rootfs/*     @bjordiscollaku
+kernel/*     @bjordiscollaku
+bootloader/* @bjordiscollaku

README.md

@@ -1,20 +1,67 @@
-qcom-build-utils
---------
+# Clone qcom-build-utils
+```
+ git clone [email protected]:qualcomm-linux/qcom-build-utils.git -b latest
+```
+```
+cd qcom-build-utils
+```
 
-Overview
---------
-qcom-build-utils holds set of tools which to developers to build, test and debug platform and CI/CD utilities.
+# Sync and build qcom-next
+```
+cd kernel && export BUILD_TOP=`pwd`
+```
+```
+git clone https://github.com/qualcomm-linux/kernel.git --single-branch -b qcom-next --depth=1 $BUILD_TOP/qcom-next
+```
 
-Branches
---------
-main: Primary development branch. Contributors should develop submissions based on this branch, and submit pull requests to this branch.
+### Add Kernel SQUASHFS configs required for Ubuntu
+```
+./scripts/enable_squashfs_configs.sh $BUILD_TOP/qcom-next/
+```
 
-Features
---------
-- ubuntu/build-utils scripts helps to assist build debian package, create system image and other tools related to ubuntu.
+### Run build_kernel.sh
+```
+./scripts/build_kernel.sh
+```
+At the end of kernel build, below products will be deployed in ```kernel/out/```
 
-for more information, please refer to the README in each subdirectory.
+# Generate Linux Kernel Debian Package
+Run ```build-kernel-deb.sh``` and pass as argument the directory where kernel build artifacts were deployed (```out/```):
+```
+./scripts/build-kernel-deb.sh out/
+```
+```linux-kernel-<kversion>-arm64.deb``` will be generated in ```kernel/```
 
-License
--------
-qcom-build-utils is licensed under the [BSD-3-clause-clear License](https://spdx.org/licenses/BSD-3-Clause-Clear.html). See [LICENSE](LICENSE.txt) for the full license text.
+# Build EFI System Partition Image
+```
+cd ../  # Moves you into the qcom-build-utils/ directory
+```
+```
+./bootloader/build-efi-esp.sh
+```
+```efiesp.bin``` will be generated and deployed in ```qcom-build-utils/```
+
+# Download firmware debian package for X Elite CRD
+```
+wget "https://qli-stg-kernel-gh-artifacts.s3.amazonaws.com/kernel/ubuntu-firmware/linux-firmware-xelite_1.0-1%2Bnoble_arm64.deb?AWSAccessKeyId=AKIAXYMT55OHLXWGCTOU&Signature=TiG%2FZrnzJwhZoWK91y4qEf%2BczzA%3D&Expires=1788577277" -O "linux-firmware-xelite_1.0-1+noble_arm64.deb"
+```
+```linux-firmware-xelite_1.0-1+noble_arm64.deb``` will be downloaded in ```qcom-build-utils/linux-firmware-xelite_1.0-1+noble_arm64.deb```
+
+# Build Ubuntu Rootfs
+```
+./rootfs/scripts/build-ubuntu-rootfs.sh kernel/linux-kernel-<kversion>-arm64.deb linux-firmware-xelite_1.0-1+noble_arm64.deb
+```
+```ubuntu.img``` root filesystem image will be generated in ```qcom-build-utils/ubuntu.img```
+
+# Final Products
+Kernel Debian Package:
+```qcom-build-utils/kernel/```
+```
+  -linux-kernel-<kversion>-arm64.deb
+```
+Bootable images: 
+```qcom-build-utils/```
+```
+    - efiesp.bin
+    - ubuntu.img
+```

bootloader/build-efi-esp.sh

@@ -0,0 +1,101 @@
+#!/bin/bash
+# Copyright (c) Qualcomm Technologies, Inc. and/or its subsidiaries.
+#
+# SPDX-License-Identifier: BSD-3-Clause-Clear
+#
+# ==============================================================================
+# Script: build-efi-esp.sh
+# ------------------------------------------------------------------------------
+# Description:
+#   Creates a standalone EFI System Partition image (efiesp.bin) for ARM64
+#   platforms.
+#
+#   Workflow:
+#     1. **Auto‑elevate** – re‑executes itself with `sudo` if not already root.
+#     2. **Install tooling** – `grub-efi-arm64-bin`, `grub2-common`, `dosfstools`.
+#     3. **Allocate** a 200 MB blank file and format it FAT32.
+#     4. **Loop‑attach** the image and install GRUB for the arm64‑efi target
+#        in *removable* mode (no NVRAM writes).
+#     5. **Seed** a minimal `grub.cfg` that chain‑loads the main GRUB on
+#        the rootfs partition (assumed GPT 13).
+#     6. **Cleanup** – unmount, detach loop device, and report success.
+#
+# Usage:
+#   ./build-efi-esp.sh
+#
+# Output:
+#   efiesp.bin  → flash to appropriate ESP partition
+#
+# Author: Bjordis Collaku <[email protected]>
+# ==============================================================================
+
+set -euo pipefail
+
+# ==============================================================================
+# Step 0  Auto‑elevate if not run as root
+# ==============================================================================
+if [[ "$EUID" -ne 0 ]]; then
+    echo "[INFO] Re‑running script as root using sudo…"
+    exec sudo "$0" "$@"
+fi
+
+# ==============================================================================
+# Step 1  Configuration
+# ==============================================================================
+ESP_IMG="efiesp.bin"
+ESP_SIZE_MB=200
+MNT_DIR="mnt"
+
+# ==============================================================================
+# Step 2  Install Required Packages
+# ==============================================================================
+echo "[INFO] Installing required packages…"
+apt-get update -y
+apt-get install -y grub2-common grub-efi-arm64-bin dosfstools
+
+# ==============================================================================
+# Step 3  Create and Format ESP Image
+# ==============================================================================
+echo "[INFO] Creating ${ESP_SIZE_MB} MB EFI System Partition image: ${ESP_IMG}"
+dd if=/dev/zero of="${ESP_IMG}" bs=1M count="${ESP_SIZE_MB}" status=progress
+
+LOOP_DEV=$(losetup --show -fP "${ESP_IMG}")
+echo "[INFO] Loop device attached: ${LOOP_DEV}"
+
+echo "[INFO] Formatting as FAT32…"
+mkfs.vfat -F 32 "${LOOP_DEV}"
+
+# ==============================================================================
+# Step 4  Install GRUB to ESP Image
+# ==============================================================================
+mkdir -p "${MNT_DIR}"
+mount "${LOOP_DEV}" "${MNT_DIR}"
+mkdir -p "${MNT_DIR}/boot"
+
+echo "[INFO] Installing GRUB bootloader (arm64‑efi)…"
+grub-install \
+    --target=arm64-efi \
+    --efi-directory="${MNT_DIR}" \
+    --boot-directory="${MNT_DIR}/boot" \
+    --removable \
+    --no-nvram
+
+# ==============================================================================
+# Step 5  Write Bootstrap grub.cfg
+# ==============================================================================
+echo "[INFO] Writing bootstrap grub.cfg…"
+cat > "${MNT_DIR}/boot/grub/grub.cfg" <<EOF
+search --no-floppy --label system --set=root
+set prefix=(\$root)/boot/grub
+configfile /boot/grub.cfg
+EOF
+
+# ==============================================================================
+# Step 6  Cleanup
+# ==============================================================================
+umount -l "${MNT_DIR}"
+losetup -d "${LOOP_DEV}"
+rm -rf "${MNT_DIR}"
+
+echo "[SUCCESS] EFI System Partition image created: ${ESP_IMG}"
+

kernel/out/README.txt

@@ -0,0 +1,5 @@
+Required to host raw kernel build products:
+	- .config
+	- Image
+	- .dtbs
+	- modules/lib/modules/<kernel_version>