Patch

• Introduction
• Directory Structure
• Usage
• Build
• Repositories Involved

Introduction

Evolved from the open-source Linux kernel LTS 4.19.y and 5.10.y, the OpenHarmony Linux kernel has incorporated CVE patches and OpenHarmony features as the OpenHarmony common kernel baseline. Vendors can complete the kernel adaptation by applying the driver patches for boards.

For more information about Linux LTS 4.19.y, visit the official kernel website.

For more information about Linux LTS 5.10.y, visit the official kernel website.

During the build process, you can merge the driver code based on the chip platform and build the kernel image. All patches are licensed under GNU General Public License (GPL) 2.0.

Directory Structure

kernel/linux
├── build
│	├── BUILD.gn					# GN file of the build framework
│	├── kernel.mk					# Kernel build file
│	└── ohos.build					# Kernel build component file
├── patches
│	├── linux-4.19					# linux-4.19 patches
│	│   └── hi3516dv300_patch		
│	│   		├── hi3516dv300.patch	# linux-4.19 Hi3516D V300 SOC patches
│	│   		└── hdf.patch			# linux-4.19 Hi3516D V300 HDF patches
│	└── linux-5.10
│	    └── hi3516dv300_patch		
│	    		├── hi3516dv300.patch	# linux-5.10 Hi3516D V300 SOC patches
│	    		└── hdf.patch			# linux-5.10 Hi3516D V300 HDF patches
└── config
	├── linux-4.19
	│   └── arch
	│       └── arm
	│           └── configs
	│               ├── hi3516dv300_small_defconfig       # Small-system defconfig of the open-source Hi3516D V300 development board from HiSilicon
	│               ├── hi3516dv300_standard_defconfig    # Standard-system defconfig of the open-source Hi3516D V300 development board from HiSilicon
	│               ├── small_common_defconfig            # Common defconfig of the small-system kernel
	│               └── standard_common_defconfig         # Common defconfig of the standard-system kernel
	└── linux-5.10
	    └── arch
	        └── arm
	            └── configs
	                ├── hi3516dv300_small_defconfig       # Small-system defconfig of the open-source Hi3516D V300 development board from HiSilicon
	                ├── hi3516dv300_standard_defconfig    # Standard-system defconfig of the open-source Hi3516D V300 development board from HiSilicon
	                ├── small_common_defconfig            # Common defconfig of the small-system kernel
	                └── standard_common_defconfig         # Common defconfig of the standard-system kernel

Usage

1. Apply HDF patches.

   Apply the HDF kernel patches matching your kernel version. For details, see the method in kernel.mk in the kernel/linux/build repository.

   $(OHOS_BUILD_HOME)/drivers/adapter/khdf/linux/patch_hdf.sh $(OHOS_BUILD_HOME) $(KERNEL_SRC_TMP_PATH)     $(HDF_PATCH_FILE)

2. Apply the chip driver patches.

   The following uses Hi3516D V300 as an example.

   Place the patches for the chip component in the corresponding path based on the path and naming rules for the patches of the chip component in kernel.mk in the kernel/linux/build repository.

   DEVICE_PATCH_DIR := $(OHOS_BUILD_HOME)/kernel/linux/patches/${KERNEL_VERSION}/$(DEVICE_NAME)_patch
   DEVICE_PATCH_FILE := $(DEVICE_PATCH_DIR)/$(DEVICE_NAME).patch

3. Modify the config file to build.

   Place the config file for the chip component in the corresponding path based on the path and naming rules of the chip component in kernel.mk in the kernel/linux/build repository.

   KERNEL_CONFIG_PATH := $(OHOS_BUILD_HOME)/kernel/linux/config/${KERNEL_VERSION}
   DEFCONFIG_FILE := $(DEVICE_NAME)_$(BUILD_TYPE)_defconfig

   Note:

   In the OpenHarmony project build process, patches are installed after kernel/linux/linux-*.* is copied. Before using the version-level build command of OpenHarmony, ensure that the kernel/linux/linux-*.* source code is available.

   The kernel built is generated in the kernel directory under the out directory. Modify the config file based on the kernel built, and copy the generated .config file to the corresponding path in the config repository. Then, the configuration takes effect.

Build

The following uses the Hi3516D V300 development board and Ubuntu x86 server as an example.

Perform a full build for the project to generate the uImage kernel image.

./build.sh --product-name Hi3516DV300              # Build the Hi3516D V300 image.
    --build-target build_kernel                    # Build the uImage kernel image of Hi3516D V300.
    --gn-args linux_kernel_version=\"linux-5.10\"  # Build the specified kernel version.

Repositories Involved

kernel_linux_patches