From 8d018588d6753c53185894026b1c52515416969f Mon Sep 17 00:00:00 2001 From: "ester.zhou" Date: Mon, 27 Jun 2022 13:43:07 +0800 Subject: [PATCH] update standard-system-porting-guide.md Signed-off-by: ester.zhou --- .../porting/figures/user-mode boot.png | Bin 0 -> 48539 bytes .../porting/standard-system-porting-guide.md | 381 +++++++----------- 2 files changed, 146 insertions(+), 235 deletions(-) create mode 100644 en/device-dev/porting/figures/user-mode boot.png diff --git a/en/device-dev/porting/figures/user-mode boot.png b/en/device-dev/porting/figures/user-mode boot.png new file mode 100644 index 0000000000000000000000000000000000000000..9c4a59a9e9e5f07fc4f22ddda300a3b575f739d3 GIT binary patch literal 48539 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 literal 0 HcmV?d00001 diff --git a/en/device-dev/porting/standard-system-porting-guide.md b/en/device-dev/porting/standard-system-porting-guide.md index 567640435d..27067313ed 100644 --- a/en/device-dev/porting/standard-system-porting-guide.md +++ b/en/device-dev/porting/standard-system-porting-guide.md @@ -1,16 +1,19 @@ -# Standard System Porting Guide +# Standard System Porting Guide -This document describes the general process for porting a development board, rather than the porting process specific to a System on Chip \(SoC\). In the future, the community will provide more development board porting examples for your reference. -## Defining a Development Board +This document describes the general process for porting a development board, rather than the porting process specific to a System on Chip (SoC). In the future, the community will provide more development board porting examples for your reference. + + +## Defining a Development Board This document uses the process of porting a development board named **MyProduct** as an example. This development board is provided by **MyProductVendor** and uses the SoC **MySOC** produced by **MySoCVendor**. -### Defining a Product -Create a **config.json** file in the directory **//vendor/MyProductVendor/*{product_name}***. This file is used to describe the SoC used by the product and the required subsystems. +### Defining a Product + +Create a file named **config.json** in the **//vendor/MyProductVendor/*{product_name}*** directory. This file is used to describe the SoC used by the product and the required subsystems. For example, if **product_name** is **MyProduct**, configure the **//vendor/MyProductVendor/MyProduct/config.json** file as follows: -For example, if **product_name** is **MyProduct**, configure the **//vendor/MyProductVendor/MyProduct/config.json** file as follows: +//vendor/MyProductVendor/MyProduct/config.json ``` @@ -29,23 +32,22 @@ For example, if **product_name** is **MyProduct**, configure the **//vendor/MyPr "components": [ { "component": "ace_engine_lite", "features":[""] } ] - }， - … + }, + ... ] } ``` - The main configurations are as follows: **product_name**: product name. This parameter is required. **version**: version. This parameter is required. -**type**: system level, which can be **mini**, **small**, or **standard**. This parameter is required. +**type**: system level, such as **small** or **standard**. This parameter is required. -**target_cpu**: CPU type of the device (depending on the actual situation, the target_cpu here may also be arm64, riscv, x86, etc..). This parameter is required. +**target_cpu**: CPU type of the device, such as **arm64**, **riscv**, or **x86**. This parameter is required. **ohos_version**: operating system version. This parameter is optional. @@ -55,33 +57,40 @@ The main configurations are as follows: **enable_ramdisk**: whether to enable the RAM disk. This parameter is required. -**kernel_type** and **kernel_version**: fixed in the standard system. They are optional. +**kernel_type**: kernel type. This parameter is optional. + +**kernel_version**: kernel version. This parameter is optional. Both **kernel_type** and **kernel_version** are fixed. **subsystems**: subsystem to enable. A subsystem can be treated as an independently built functional block. This parameter is required. **product_company**: device manufacturer name. It is not set in the configuration, but in the directory name, next to the vendor name. It can be accessed from **build.gn script**. -You can find predefined subsystems in **//build/subsystem\_config.json**. You can also customize subsystems. -You are advised to copy the configuration file of Hi3516D V300 and delete the **hisilicon\_products** subsystem, which is used to compile the kernel for Hi3516D V300. +You can find predefined subsystems in **//build/subsystem_config.json**. You can also customize subsystems. + +You are advised to copy the configuration file of Hi3516D V300 and delete the **hisilicon_products** subsystem, which is used to compile the kernel for Hi3516D V300. -### Verifying the Porting -Run the following command to start the build of your product: +### Verifying the Porting + + Run the following command to start the build of your product: ``` ./build.sh --product-name MyProduct ``` -After the build is complete, you can view the built OpenHarmony image file in **//out/{device_name}/packages/phone/images**. +After the build is complete, you can view the built image file in **//out/{*device_name*}/packages/phone/images**. + -## Porting the Kernel +## Porting the Kernel Now, you need to port the Linux kernel to enable it to run successfully. -### 1. Adding a Kernel-built Subsystem to the SoC -Add the following subsystem configuration to the **//build/subsystem\_config.json** file: +### 1. Adding a Kernel-built Subsystem to the SoC + +Add the following subsystem configuration to the **//build/subsystem_config.json** file: + ``` "MySOCVendor_products": { @@ -92,16 +101,18 @@ Add the following subsystem configuration to the **//build/subsystem\_config.jso }, ``` -Then, open the configuration file **//vendor/MyProductVendor/MyProduct/config.json**, which is used to define the product, and add the new subsystem to the product. +Then, open the configuration file **//vendor/MyProductVendor/MyProduct/config.json** and add the new subsystem to the product. + -### 2. Building the Kernel +### 2. Building the Kernel The OpenHarmony source code provides the Linux kernel 4.19, which is archived in **//kernel/linux-4.19**. This section uses this kernel version as an example to describe how to build the kernel. -The path for building the subsystem is defined when you define the subsystem in the previous step. The path is **//device/MySOCVendor/MySOC/build**. Now, you need to create a build script in this path to instruct the build system to build the kernel. +The path for building the subsystem is defined when you define the subsystem in the previous step. In this example, the path is `//device/MySOCVendor/MySOC/build`. Now, you need to create a build script in this path to instruct the build system to build the kernel. The recommended directory structure is as follows: + ``` ├── build │ ├── kernel @@ -113,49 +124,65 @@ The recommended directory structure is as follows: The **BUILD.gn** file is the only entry for building the subsystem. -The expected build result is as follows: - - - - - - - - - - - - -

File

-

Description

-

$root_build_dir/packages/phone/images/uImage

-

Kernel image

-

$root_build_dir/packages/phone/images/uboot

-

Bootloader image

-
- -### 3. Verifying the Porting +The expected build result described in the table below. + +| File| Description| +| -------- | -------- | +| $root_build_dir/packages/phone/images/uImage | Kernel image.| +| $root_build_dir/packages/phone/images/uboot | Bootloader image.| + + +### 3. Verifying the Porting Now start build, and check whether the kernel image is generated as expected. -## Porting the HDF Driver +## User-mode Boot + +1. Overview of user-mode boot process + +![user-mode boot](figures/user-mode boot.png) + + When the system is powered on, the kernel loads and starts services and applications as follows: + +1. The kernel loads the init process, which is specified by **cmdline** of the kernel when the bootloader starts the kernel, for example, **init=/init root/dev/xxx**. +2. After the init process is started, **tmpfs** and **procfs** are mounted and basic **dev** nodes are created to establish a basic root file system. +3. The init process starts the ueventd process to listen for device hot-swap events in the kernel and creates **dev** nodes for related devices as well as partitions for the block device. +4. After mounting partitions (**system** and **vendor**) of the block device, the init process scans for the init startup script of each system service and launches the respective service ability (SA). +5. Each SA registers with the samgr process, which serves as the service registration center. The samgr process assigns each SA with an ID, which will be used by an application to access the desired SA. +6. The foundation process implements application lifecycle management. It is a special SA service process that provides the user program management framework and basic services. +7. The appspawn process directly spawns the application process, eliminating the need for the application to load the JS runtime environment. This reduces the application startup time. + +2. init module + + The configuration file of the init module contains service names, executable file paths, permissions, and other information of all key system services that need to be started by the init process. The boot script of each system service is installed in the **/system/etc/init** directory. + + When porting a new chip platform, you need to add the **/vendor/etc/init/init.{hardware}.cfg** file that contains the platform-level initialization configuration. This file is used to implement platform-level initialization, for example, installing the ko driver and configuring information on the related **/proc** nodes. + + The code of the init process is stored in the **//base/startup/init_lite** directory. This process is the first process in the system and does not depend on other processes. + + For details about how to develop the initialization configuration file, see [Startup](../subsystems/subsys-boot-overview.md). -### 1. LCD -This section describes how to port a Liquid Crystal Display \(LCD\) driver. The hardware driver framework \(HDF\) designs a driver model for the LCD. To support an LCD, you must compile a driver, generate a model instance in the driver, and register the instance. +## Porting the HDF Driver + + +### 1. LCD + +This section describes how to port a Liquid Crystal Display (LCD) driver. The hardware driver framework (HDF) designs a driver model for the LCD. To support an LCD, you must compile a driver, generate a model instance in the driver, and register the instance. The LCD drivers are stored in the **//drivers/framework/model/display/driver/panel** directory. -- Create a panel driver. +- Create a panel driver. + + In the **Init** method of the driver, call **RegisterPanel** to register the model instance. -In the **Init** method of the driver, call **RegisterPanel** to register the model instance. ``` int32_t XXXInit(struct HdfDeviceObject *object) { struct PanelData *panel = CreateYourPanel(); - // Register the model instance. + // Registration if (RegisterPanel(panel) != HDF_SUCCESS) { HDF_LOGE("%s: RegisterPanel failed", __func__); return HDF_FAILURE; @@ -172,7 +199,7 @@ struct HdfDriverEntry g_xxxxDevEntry = { HDF_INIT(g_xxxxDevEntry); ``` -- Configure and load the panel driver. All device information about the product is defined in the **//vendor/MyProductVendor/MyProduct/config/device\_info/device\_info.hcs** file. Modify the file by adding configurations for the device named **device\_lcd** to the host named **display**. Note: The value of **moduleName** must be the same as that in the panel driver. +- Configure and load the panel driver. All device information about the product is defined in the **//vendor/MyProductVendor/MyProduct/config/device_info/device_info.hcs** file. Modify the file by adding configurations for the device named **device_lcd** to the host named **display**. Note: The value of **moduleName** must be the same as that in the panel driver. ``` root { @@ -192,13 +219,15 @@ root { For details about driver development, see [LCD](../driver/driver-peripherals-lcd-des.md). -### 2. Touchscreen + +### 2. Touchscreen This section describes how to port a touchscreen driver. The touchscreen driver is stored in the **//drivers/framework/model/input/driver/touchscreen** directory. To port a touchscreen driver, register a **ChipDevice** model instance. -- Create a touchscreen driver. +- Create a touchscreen driver. + + Create the **touch_ic_name.c** file in the directory. Replace **ic_name** with the name of your chip. The file template is as follows: -Create the **touch\_ic\_name.c** file in the directory. Replace **ic\_name** with the name of your chip. The file template is as follows: ``` #include "hdf_touch.h" @@ -222,51 +251,20 @@ struct HdfDriverEntry g_touchXXXXChipEntry = { HDF_INIT(g_touchXXXXChipEntry); ``` -Implement the following interfaces in **ChipDevice**: - - - - - - - - - - - - - - - - - - - - - - - - -

Interface

-

Description

-

int32_t (*Init)(ChipDevice *device)

-

Initializes a touchscreen.

-

int32_t (*Detect)(ChipDevice *device)

-

Detects a touchscreen.

-

int32_t (*Suspend)(ChipDevice *device)

-

Suspends a touchscreen.

-

int32_t (*Resume)(ChipDevice *device)

-

Resumes a touchscreen.

-

int32_t (*DataHandle)(ChipDevice *device)

-

Reads data from a touchscreen and writes the touch point data to device > driver > frameData.

-

int32_t (*UpdateFirmware)(ChipDevice *device)

-

Upgrades the firmware.

-
- -- Configure the product and load the driver. - - All device information about the product is defined in the **//vendor/MyProductVendor/MyProduct/config/device\_info/device\_info.hcs** file. Modify the file by adding configurations for the device named **device\_touch\_chip** to the host named **input**. Note: The value of **moduleName** must be the same as that in the touchscreen driver. +Implement the following APIs in **ChipDevice**: +| API| Description| +| -------- | -------- | +| int32_t (\*Init)(ChipDevice \*device) | Initializes a touchscreen.| +| int32_t (\*Detect)(ChipDevice \*device) | Detects a touchscreen.| +| int32_t (\*Suspend)(ChipDevice \*device) | Suspends a touchscreen.| +| int32_t (\*Resume)(ChipDevice \*device) | Resumes a touchscreen.| +| int32_t (\*DataHandle)(ChipDevice \*device) | Reads data from a touchscreen and writes the touch point data to **device** > **driver** > **frameData**.| +| int32_t (\*UpdateFirmware)(ChipDevice \*device) | Upgrades the firmware.| + +- Configure the product and load the driver. + + All device information about the product is defined in the **//vendor/MyProductVendor/MyProduct/config/device_info/device_info.hcs** file. Modify the file by adding configurations for the device named **device_touch_chip** to the host named **input**. Note: The value of **moduleName** must be the same as that in the touchscreen driver. ``` deviceN :: deviceNode { @@ -279,52 +277,29 @@ Implement the following interfaces in **ChipDevice**: } ``` -For details about driver development, see [TOUCHSCREEN](../driver/driver-peripherals-touch-des.md). +For details about driver development, see [Touchscreen](../driver/driver-peripherals-touch-des.md). + -### 3. WLAN +### 3. WLAN The WLAN driver is divided into two parts. One of the parts manages WLAN devices, and the other part manages WLAN traffic. HDF WLAN provides abstraction for the two parts. Currently, only the WLAN with the SDIO interface is supported. -**Figure 1** WLAN chip -![](figures/wlan-chip.png "wlan-chip") - -To support a chip, implement a **ChipDriver** for it. The major task is to implement the following interfaces provided by **HDF\_WLAN\_CORE** and **NetDevice**. - - - - - - - - - - - - - - - - - - - -

Interface

-

Header File

-

Description

-

HdfChipDriverFactory

-

//drivers/framework/include/wifi/hdf_wlan_chipdriver_manager.h

-

Factory of the ChipDriver, which is used to support multiple WLAN interfaces of a chip.

-

HdfChipDriver

-

//drivers/framework/include/wifi/wifi_module.h

-

Manages a specific WLAN interface. Each WLAN interface corresponds to an HdfChipDriver.

-

NetDeviceInterFace

-

//drivers/framework/include/net/net_device.h

-

Communicates with the protocol stack, such as sending data and setting the status of network interfaces.

-
+**Figure 1** WLAN chip + +![hdf_wifi](figures/hdf_wifi.png) + +To support a chip, implement a **ChipDriver** for it. The major task is to implement the following interfaces provided by **HDF_WLAN_CORE** and **NetDevice**. + +| API| Header File| Description| +| -------- | -------- | -------- | +| HdfChipDriverFactory | //drivers/framework/include/wifi/hdf_wlan_chipdriver_manager.h | Supports multiple WLAN interfaces of a chip.| +| HdfChipDriver | //drivers/framework/include/wifi/wifi_module.h | Manages a specific WLAN interface. Each WLAN interface corresponds to an **HdfChipDriver**.| +| NetDeviceInterFace | //drivers/framework/include/net/net_device.h | Communicates with the protocol stack, such as sending data and setting the status of network interfaces.| To port a WLAN driver, perform the following steps: -1. Create an HDF driver. You are advised to place the code file in the **//device/MySoCVendor/peripheral/wifi/chip\_name/** directory. The file template is as follows: +1. Create an HDF driver. You are advised to place the code file in the **//device/MySoCVendor/peripheral/wifi/chip_name/** directory. The file template is as follows: + ``` static int32_t HdfWlanHisiChipDriverInit(struct HdfDeviceObject *device) { @@ -347,95 +322,36 @@ struct HdfDriverEntry g_hdfXXXChipEntry = { HDF_INIT(g_hdfXXXChipEntry); ``` -Create an **HdfChipDriverFactory** in the **CreateChipDriverFactory**. The interfaces are as follows: - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Interface

-

Description

-

const char *driverName

-

Indicates the driver name.

-

int32_t (*InitChip)(struct HdfWlanDevice *device)

-

Initializes a chip.

-

int32_t (*DeinitChip)(struct HdfWlanDevice *device)

-

Deinitializes a chip.

-

void (_ReleaseFactory)(struct HdfChipDriverFactory _factory)

-

Releases the HdfChipDriverFactory object.

-

struct HdfChipDriver _(_Build)(struct HdfWlanDevice *device, uint8_t ifIndex)

-

Creates an HdfChipDriver. In the input parameters, device indicates the device information, and ifIndex indicates the sequence number of this interface in the chip.

-

void (_Release)(struct HdfChipDriver _chipDriver)

-

Releases the HdfChipDriver.

-

uint8_t (*GetMaxIFCount)(struct HdfChipDriverFactory *factory)

-

Obtains the maximum number of interfaces supported by the current chip.

-
- -Implement the following interfaces in the **HdfChipDriver**. - - - - - - - - - - - - - - - - - - - - - -

Interface

-

Description

-

int32_t (*init)(struct HdfChipDriver *chipDriver, NetDevice *netDev)

-

Initializes the current network interface. The NetDeviceInterFace needs to be provided for the netDev.

-

int32_t (*deinit)(struct HdfChipDriver *chipDriver, NetDevice *netDev)

-

Deinitializes the current network interface.

-

struct HdfMac80211BaseOps *ops

-

Provides the WLAN basic capability interface set.

-

struct HdfMac80211STAOps *staOps

-

Provides the interface set required for supporting the standalone (STA) mode.

-

struct HdfMac80211APOps *apOps

-

Provides the interface set required for supporting the access point (AP) mode.

-
+Create an **HdfChipDriverFactory** in the **CreateChipDriverFactory**. The APIs are as follows: + +| API| Description| +| -------- | -------- | +| const char \*driverName | Indicates the driver name.| +| int32_t (\*InitChip)(struct HdfWlanDevice \*device) | Initializes a chip.| +| int32_t (\*DeinitChip)(struct HdfWlanDevice \*device) | Deinitializes a chip.| +| void (*ReleaseFactory)(struct HdfChipDriverFactory *factory) | Releases the **HdfChipDriverFactory** object.| +| struct HdfChipDriver *(_Build)(struct HdfWlanDevice \*device, uint8*t ifIndex) | Creates an **HdfChipDriver**. In the input parameters, **device** indicates the device information, and **ifIndex** indicates the sequence number of this interface in the chip.| +| void (*Release)(struct HdfChipDriver *chipDriver) | Releases the **HdfChipDriver**.| +| uint8_t (\*GetMaxIFCount)(struct HdfChipDriverFactory \*factory) | Obtains the maximum number of APIs supported by the current chip.| + +Implement the following APIs in the **HdfChipDriver**. + +| API| Description| +| -------- | -------- | +| int32_t (\*init)(struct HdfChipDriver \*chipDriver, NetDevice \*netDev) | Initializes the current network interface. The **NetDeviceInterFace** needs to be provided for the **netDev**.| +| int32_t (\*deinit)(struct HdfChipDriver \*chipDriver, NetDevice \*netDev) | Deinitializes the current network interface.| +| struct HdfMac80211BaseOps \*ops | Provides the WLAN basic capability interface set.| +| struct HdfMac80211STAOps \*staOps | Provides the interface set required for supporting the standalone (STA) mode.| +| struct HdfMac80211APOps \*apOps | Provides the interface set required for supporting the access point (AP) mode.| 2. Compile the configuration file to describe the devices supported by the driver. -Create the chip configuration file **//vendor/MyProductVendor/MyProduct/config/wifi/wlan\_chip\_chip\_name.hcs** in the product configuration directory. + Create the chip configuration file **//vendor/MyProductVendor/MyProduct/config/wifi/wlan_chip_chip_name.hcs** in the product configuration directory. -Replace **MyProductVendor**, **MyProduct**, and **chip\_name** in the path with the actual names. + Replace **MyProductVendor**, **MyProduct**, and **chip_name** in the path with the actual names. + + The sample code is as follows: -The sample code is as follows: ``` root { @@ -456,7 +372,8 @@ root { 3. Edit the configuration file and load the driver. -All device information about the product is defined in the **//vendor/MyProductVendor/MyProduct/config/device\_info/device\_info.hcs** file. Modify the file by adding configurations for the device named **device\_wlan\_chips** to the host named **network**. Note: The value of **moduleName** must be the same as that in the touchscreen driver. + All device information about the product is defined in the **//vendor/MyProductVendor/MyProduct/config/device_info/device_info.hcs** file. Modify the file by adding configurations for the device named **device_wlan_chips** to the host named **network**. Note: The value of **moduleName** must be the same as that in the touchscreen driver. + ``` deviceN :: deviceNode { @@ -470,7 +387,7 @@ All device information about the product is defined in the **//vendor/MyProductV 4. Build the driver. -- Create a kernel configuration menu. Create a **Kconfig** file in the **//device/MySoCVendor/peripheral** directory. The file template is as follows: +- Create a kernel configuration menu. Create a **Kconfig** file in the **//device/MySoCVendor/peripheral** directory. The file template is as follows: ``` config DRIVERS_WLAN_XXX @@ -483,23 +400,17 @@ config DRIVERS_WLAN_XXX Add the following sample code to the end of the **//drivers/adapter/khdf/linux/model/network/wifi/Kconfig** file to add the configuration menu to the kernel: + ``` source "../../../../../device/MySoCVendor/peripheral/Kconfig" ``` -- Create a build script. - - Add the following configuration to the end of the **//drivers/adapter/khdf/linux/model/network/wifi/Makefile** file: - - +- Create a build script. + +Add the following configuration to the end of the **//drivers/adapter/khdf/linux/model/network/wifi/Makefile** file: ``` HDF_DEVICE_ROOT := $(HDF_DIR_PREFIX)/../device obj-$(CONFIG_DRIVERS_WLAN_XXX) += $(HDF_DEVICE_ROOT)/MySoCVendor/peripheral/build/standard/ ``` -When **DRIVERS\_WLAN\_XXX** is enabled in the kernel, **makefile** in **//device/MySoCVendor/peripheral/build/standard/** is called. For more details, see [WLAN Development](../guide/device-wlan-led-control.md). - -### 4. Samples - -For details about the porting sample, see the DAYU development board adaptation guide. - +When **DRIVERS_WLAN_XXX** is enabled in the kernel, **makefile** in **//device/MySoCVendor/peripheral/build/standard/** is called. For details about the development, see [LED Peripheral Control](../guide/device-wlan-led-control.md). -- GitLab