Flashing webOS Open Source Edition

This page provides details for flashing the webOS Open Source Edition (OSE) image to a microSD card. In addition, this page describes how to verify the flashed image on the target device.

Prerequisites

Before you begin flashing the webOS OSE image, make sure you have completed the following:

  • You must build the webOS OSE image on a Linux machine. For more information, see here.

    • To flash the image from Windows or Mac OS, you must download the built image from the Linux machine to the host machine.

  • You must insert a microSD card in the microSD card reader device connected to the host machine.

Flashing the Image

This section describes how to flash the webOS OSE image (.rpi-sdimg) to a microSD card, for each host operating system.

Windows

Flash image using Win32DiskImager.

Linux

First, change directory to where the image is located.

$ cd <path where the image is located>

Check the device name of the microSD card using the following command.

$ sudo fdisk -l

Run the commands as below to flash the image to the microSD card.

$ sudo umount /dev/sdXn
$ sudo dd bs=4M if=./**.rpi-sdimg of=/dev/sdX
$ sudo umount /dev/sdXn

  • sdXn denotes the device name of the microSD card, where n is a number suffix.
  • For dd command, you must pass sdX (without the suffix number) as a destination parameter. This indicates the mass storage device, not the partition.
After you run the dd command, the shell prompt will not display any message until the job is finished. Even if there is no message, you need to wait until the copying process is complete. For more information on dd command, see here.

Flashing Command Example for Linux

$ sudo umount /dev/sdb1
$ sudo dd bs=4M if=./webos-image-raspberrypi3.rootfs.rpi-sdimg of=/dev/sdb
$ sudo umount /dev/sdb1

Mac OS

First, change directory to where the image is located.

$ cd <path where the image is located>

Check the device name of the microSD card using the following command.

$ diskutil list

Run the commands as below to flash the image to the microSD card.

$ sudo diskutil umountDisk /dev/diskn
$ sudo dd bs=4M if=./**.rpi-sdimg of=/dev/rdiskn
$ sudo diskutil umountDisk /dev/diskn

  • diskn denotes the device name of the microSD card, where n is a number suffix.
  • For dd command, you must pass rdiskn as a destination parameter to speed up the copying process.
After you run the dd command, the shell prompt will not display any message until the job is finished. Even if there is no message, you need to wait until the copying process is complete. For more information on dd command, see here.

Flashing Command Example for Mac OS

$ sudo diskutil umountDisk /dev/disk2
$ sudo dd bs=4M if=./webos-image-raspberrypi3.rootfs.rpi-sdimg of=/dev/rdisk2
$ sudo diskutil umountDisk /dev/disk2

Verifying the Image

After you finish flashing the webOS OSE image to the microSD card, you can check how it works by taking the following steps:

  1. First, eject the microSD card from the reader device and insert it in the target device, Raspberry Pi 3.

  2. Connect the target device with peripherals.

    • Connect the target device with a monitor through HDMI cable.
    • Plug a keyboard and a mouse into the USB ports of the target device.
    • Connect Ethernet cable to the target device.
  3. Set the input mode of the monitor to the port connected with the target device.

  4. Plug the power cable in to the target device. The target device will boot up. Wait until the start-up screen with webOS OSE logo appears on the screen.

  5. Press F1 key on the keyboard, and you will see the Home Launcher UI popping up from the right side of the screen. Home Launcher should contain a list of pre-installed apps and an icon for Settings app, as shown in the figure below.

webOSOSE_HomeLauncher.png

 

Except as noted, this content is licensed under Creative Commons Attribution 4.0 and sample code is licensed under Apache License 2.0.