Bring-Up Overview

A bring-up process is a series of tasks to migrate a specific platform to a new System on a Chip (SoC) board. A common bring-up process consists of the following tasks:

  • Preparing required Board Support Package (BSP) files
  • Modifying the source codes
  • Verifying the basic operations and debugging errors

This page describes how to bring up webOS OSE from scratch.

We recommend using the target board, which supports meta-layer files for the Yocto build, but this is not required.

Bring-up Process

The following picture shows a brief summary of the bring-up process.

A process to bring up a webOS OSE
  1. Preparing Yocto SoC BSPs:

    First, you need to prepare BSP for your SoC board. The BSP files contain information to support specific hardware. These files are usually provided by SoC makers and depend on the type of your SoC board.

  2. Replacing meta-layers:

    A meta-layer is a set of files that determine how to build a target. You need to add, change, and remove meta-layers specific to your hardware target.

  3. Changing the machine configuration files:

    A machine configuration determines your target SoC board. Examine the machine configuration files and make necessary changes, such as the boot loader, kernel, and image size, to support your hardware target.

  4. (Optional) Changing the distribution configuration file:

    A distribution configuration determines policy configurations for your distribution. If you want to distribute webOS OSE, you can use webOS OSE’s distribution configuration file.

  5. Handling build errors

    Modify the recipe files to fix build errors.

  6. Installing an image

    Modify or add tasks to create an image format that is installable on your SoC board.

  7. Handling runtime errors

    Correct errors during running webOS OSE. Before starting this step, make sure that you understand the execution sequences of Luna Surface Manager (LSM) and Web Application Manager (WAM).

For more details on the bring-up process, see the Yocto Project Manual.

Verifying Bring-Up Process

Once you’ve done the bring-up process, you can go through the following checklist to see if the bring-up was successful.

  1. Swipe up the display and check whether Home Launcher is displayed.
  2. Click the apps in Home Launch and check whether the apps are launched properly.
  3. Check whether the sample native app is working properly. For details on how to install and run the sample app, see Developing External Native Apps.

You can verify the basic operation of LSM, WAM, System and Application Manager (SAM) using the following command:

# ls-monitor example to verify the operation
ls-monitor -l | grep -E "surfacemanager|webappmanager|applicationManager|sam"

250 com.webos.surfacemanager                /usr/bin/surface-manager    static                  T8seiy25
250          /usr/bin/surface-manager    unknown/client only     0uJxIsNQ
407 com.webos.service.applicationManager    /usr/sbin/sam               static                  4XkmWlpU
408 com.palm.webappmanager                  /usr/bin/WebAppMgr          static                  WQocBume
407 com.webos.service.applicationmanager    /usr/sbin/sam               static                  SjjHfvh6
407 com.webos.applicationManager            /usr/sbin/sam               static                  Pj6R8n6A

If all the steps work fine, then you succeed in bringing up webOS OSE.