Install LuneOS for Tenderloin

From WebOS-Ports
Revision as of 15:48, 15 September 2014 by Herrie (talk | contribs) (Herrie moved page Install WOP for Tenderloin to Install LuneOS for Tenderloin)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.

This guide will walk you through the process of taking the Touchpad from stock to having ability to flash the latest version of LuneOS.


Rules that you must agree to before using these images

Before you use our testing feeds, please read and agree to the following rules:

  1. Anyone participating in WebOS Ports alpha or beta testing of any kind must be prepared to fully erase and reflash their device at a moment's notice without warning and without any regrets or complaints.

  1. They must be prepared to and able to log into the command line on the device and type Linux commands when instructed to do so. If you are not intimately familiar with linux GO NO FURTHER
  2. They must be prepared to go to great and extraordinary lengths to try and reliably reproduce any problems they encounter.
  3. They must give full and detailed bug reports, leaving out no piece of information which could possibly be remotely connected to the problem.
  4. They must read any and all documentation and forums threads (in their entirety) before asking a question.
  5. They must fastidiously follow the IRC Channel where the alpha testing is being discussed by the authors, and follow precisely any instructions given there.
  6. They will never post the raw testing feed URLs or instructions anywhere, but will always refer others directly to this page using only the URL http://testing-{{{device_name}}}
  7. When asking for help, they will include the phrase (which may change occasionally) "I've read and understand the rules". Failure to include the phrase will result in the request for help being silently ignored.

If you're not prepared to do *all* the above, and do it all in good spirit, then please wait for the public release of the item.

If you are prepared to do *all* the above, then by all means please participate in the alpha or beta testing.

Note that everything above is a function of attitude, not of skill. These images do NOT constitute a ROM, They are individual pieces and NOT intended or expected to be included in any ROM

Important Notes

HP started a firesale of the Touchpad for $99 the 16GB and $149,- for the 32GB version, 7 weeks after it's release when it announced to stop producing webOS hardware. This tablet became popular very quickly due to the good value for money. It's being used in various projects as a porting target (CyanogenMod, Ubuntu Touch and LuneOS for example).

Preparing your device & installation instructions

These instructions will guide you on how to create a dual boot on your TouchPad with webOS 3.0.x and LuneOS.

Prerequisites: You need to have Novacom/Novaterm installed on your machine. These are included in the PDK/SDK for example. Most of the links on the HP sites are no longer working, but you can still get them using the links provided in this topic on WebOSNation or at Open WebOS Project.

Creating a partition to host LuneOS

You need a lvm partition of at least 1GB to host LuneOS. You want to separate LuneOS from legacy webOS and optware, Ubuntu/Debian chroots and probably Android. For people that know their way around Linux and lvm, just create a lvm partition named "/dev/store/luneos-root" with ext3, maybe following this guide and adjusting to your needs. For everybody else I recommend the use of Tailor. Please note that Tailor 0.3.1 added support for luneos-root, while earlier versions didn't support it.

1. Reboot your TouchPad into webOS.

2. Start Tailor

3. Select "USB (media)" and select "Unmount Partition"

4. Now press "Check Filesystem" (USB should still be selected). This will take a while.

5. Now Select "Resize Partition" as activity (this will only be available after a filesystem check) and reduce the size by 1000-2000 MiB. This will take even longer.

6. Now select "Unused space" in the list of partitions, select "luneos-root" in Tailor 0.3.1 or higher or "Android (system)" (in Tailor 0.3.0 or lower) as partition type and create the partition.

If you happen to have Android installed on your TouchPad and can not select "Android (system)" in Tailor, please run the following command in a command line on your device (see step 8 for command line instructions):

lvrename /dev/store/cm-system /dev/store/cm-system-disabled

Also make sure to follow the last step of this section and do not boot Android in between.

7. Now select "USB (media)" form partition list again, select "Mount partition" as activity and press the button.

The following steps are only required with Tailor 0.3.0 and lower, with Tailor 0.3.1 you DON'T need to follow step 8 and 9.

8. When the partition is created go into a command line on your device. The best way is probably to hook up the TP to your Computer and run novaterm.

9. Run the following command on device:

lvrename /dev/store/cm-system /dev/store/luneos-root

10. To check if everything went well, run this command: lvscan

The results should look like

 ACTIVE            '/dev/store/root' [568.00 MB] inherit
 ACTIVE            '/dev/store/var' [64.00 MB] inherit
 ACTIVE            '/dev/store/update' [16.00 MB] inherit
 ACTIVE            '/dev/store/log' [24.00 MB] inherit
 ACTIVE            '/dev/store/mojodb' [256.00 MB] inherit
 ACTIVE            '/dev/store/filecache' [136.00 MB] inherit
 ACTIVE            '/dev/store/media' [19.86 GB] inherit
 ACTIVE            '/dev/store/swap' [400.00 MB] inherit
 ACTIVE            '/dev/store/luneos-root' [2.09 GB] inherit

Of course this depends a bit on what you use on your system. But important is the luneos-root part.

In case you're using Tailor 0.3.0 or lower and have Android on your Touchpad, you want to check the following as well:

11. If you had to rename the Android partition before, restore it with the following command:

lvrename /dev/store/cm-system-disabled /dev/store/cm-system

Install the kernel

The following steps you need to do on your local PC

1. Download the latest Moboot (0.3.8) with filename

2. Unpack and you will have a file called uImage.moboot_0.3.8

3. Download the kernel (uImage) and add it to the boot partition as uImage.LuneOS and either symlink it to uImage or use Moboot. Follow the instruction below when using Moboot:

At this stage you have the following 2 files in a local folder/directory on your pc: uImage.moboot_0.3.8 and uImage

- Boot into webOS (make sure to have Developer Mode enabled!)

- Run novaterm

mount -o remount,rw /boot

cd /boot

rm uImage


You should now be back at your command prompt on the OS (Linux, Windows, Mac OS) on your PC. In case you don't get returned to your command prompt, you can always open another one! From here run the following commands:

(You need to make sure you can run novacom from the folder with uImage.moboot_0.3.8 and uImage (in Windows you need to add the folder/directory with Novacom to your PATH variable, instructions for this can be found here). Another solution is to copy the 2 files uImage.moboot_0.3.8 and uImage to the folder where your Novacom is located.

novacom put file://boot/uImage.LuneOS < uImage

novacom put file://boot/uImage.moboot < uImage.moboot_0.3.8


cd /boot

ln -sf uImage.moboot uImage

ln -sf uImage-2.6.35-palm-tenderloin uImage.webOS

ls -l

Output should look like: Moboot.png

Install the image

Download the image, copy it to the USB drive (/media/internal), eject the USB drive, and extract the image into the new partition by issuing the following commands (using Novaterm or Command Line in WebOSQuickInstall):

mount -o remount,rw /

mkdir /media/luneos-root

mount /dev/store/luneos-root /media/luneos-root

cd /media/internal

tar xzf luneos-dev-image-tenderloin.tar.gz -C /media/luneos-root

If you installed LuneOS into ext3fs before and had no issues (because you don't use optware or a chroot in webOS), you can stay with that. Just exchange "ext3fs" against "luneos-root" in the instructions above.

Installing a newer or different image

Using webOS

  1. reboot your Touchpad into webOS
  2. copy the new or different image to the USB drive
  3. eject the USB drive
  4. using Novaterm or Command Line in WebOSQuickInstall:

mount /dev/store/luneos-root /media/luneos-root

rm -rf /media/luneos-root/*

tar xzf /media/internal/luneos-dev-image-tenderloin.tar.gz -C /media/luneos-root

If you installed LuneOS into ext3fs before and had no issues (because you don't use optware or a chroot in webOS), you can stay with that. Just exchange "ext3fs" against "luneos-root" in the instructions above.

In case you also want to replace the kernel you need to do the following steps as well:

mount -o remount,rw /boot

On your PC issue the following command in the directory where your uImage is located:

novacom put file://boot/uImage.LuneOS < uImage

Using Android

  1. reboot your Touchpad into Android
  2. copy the new or different image (both kernel and system) to the USB drive
  3. authorize access through ADB, including root access
  4. open a terminal on your PC, and start an adb shell:

adb shell

  1. now the steps are similar as for the install from webOS:

mkdir /media/luneos-root

mount -t ext3 /dev/store/luneos-root /media/luneos-root

rm -rf /media/luneos-root/*

tar xzf /storage/sdcard0/Downloads/luneos-dev-image-tenderloin.tar.gz -C /media/luneos-root

umount /media/luneos-root

If you installed LuneOS into ext3fs before and had no issues (because you don't use optware or a chroot in webOS), you can stay with that. Just exchange "ext3fs" against "luneos-root" in the instructions above.

In case you also want to replace the kernel you need to do the following steps as well:

mount -o remount,rw /boot

cp /storage/sdcard0/Downloads/uImage /boot/uImage.LuneOS

Helpful Tip

See something wrong on this page? Report it here.