wiki:Devices/PalmPre/InstallGuide

Version 3 (modified by GarthPS, 9 years ago) (diff)

remove statement about limited capacity of published novacom

Disclaimer (WebOSInternals' credit)

Enacting any set of instructions from this site has the (remote, but greater than zero) potential to void your warranty. Our intention and the specific design of all instructions is such that you should be able to recover using the webOS Doctor should anything go wrong, and put your device back to a state which is indistinguishable from a factory-new device, but we give no guarantee. Use any information from this site at your own risk. At the very least, you should be prepared to lose all data on your phone at any time. We cannot tell you what you should do - we provide the information, but it's up to your own sense of personal responsibility to determine what you do with that information. We require you to use the webOS Doctor to put your device back to factory condition before contacting Palm or your cellular carrier for service or support.

Please report any issue to shr-devel attt lists.shr-project.org with subject "PalmPreInstall" to help us in our project. Thanks

Installation and Usage of SHR on the Palm Pre

What to expect

This howto will help you how to install a recent SHR image on the Palm Pre/Pre2 device. We try to not lose your data from WebOS which can be installed in parallel, but don't be surprised if not! Don't expect a usable phone after you installed SHR too! You have been warned. That said, currently the installation is quite safe. Your device is backed up before doing anything, so you should be able to restore your data later. See Status section to see what progress has been made

Manual installation

Needed things

The following five steps are the basic steps you need to use the fso-installer.

  1. Create a "downloads" directory and put in there the webos version you have downloaded, something like webosxxxxx.jar .
  2. In our working directory (not in "downloads/" !), download the fso-installer (a Makefile http://git.freesmartphone.org/?p=utilities.git;a=blob_plain;f=palmpre/fso-installer/Makefile;hb=HEAD )
  3. You have then to modify only two things in the Makefile : TARGET and CONFIG_WEBOS_MEDIA_TARGET_SIZE as explained at the top of the Makefile
  4. Plug your device to your computer with the usb cable.
  5. Put your device in developer mode.(see WebOS Internals' wiki)

Reboot your device into 'flash' mode

Power your device off, hold the volume up key and plug a usb cable in (the other end should be in your computer). Wait until the usb logo is on the screen, then run the following command:

make memload

Backup up everything

Before we execute any of the steps below we backup every data from your device to be able to restore it later. You do that with entering the command while the device is connected:

make backup

Resize internal flash disk of your device

To flash a SHR image to your device we first need to get some free space for it. As of the initial state with webOS installed there is all space required by webOS. Some parts are used for the webOS system and the biggest part ist used for the media partition. This one we need to resize in the following steps to get some free space for SHR.

First you have to decided how many space you want for the webOS media partition left. You specify this in the Makefile with adjusting the CONFIG_WEBOS_MEDIA_TARGET_SIZE variable.

As next step we start the resize process by entering the command. It will resize the internal lvm partitions and create a new one for SHR which will be used for flashing later.

make lvm-resize

Intall the bootloader

To be able to boot the system and to switch between webOS and SHR on boot you need to install the bootloader called bootr with

make install-bootr

Flash the kernel

Flashing a kernel is very simple. You just need to download or build a kernel for the device and flash it with the following command to the device:

make KERNEL=~/path/to/your/kernel/uImage-palmpre.bin flash-kernel

Flash the image

Flashing the image to the device is as simple as flashing the kernel to the device.

make IMAGE=~/path/to/your/kernel/shr-image.tar.gz flash-image