Changes between Version 17 and Version 18 of PalmPreInstall


Ignore:
Timestamp:
Mar 21, 2011, 10:58:50 AM (9 years ago)
Author:
pespin
Comment:

moved to Devices/PalmPre/InstallGuide

Legend:

Unmodified
Added
Removed
Modified
  • PalmPreInstall

    v17 v18  
    1 = Disclaimer (WebOSInternals' credit) =
    2 
    3 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.
    4 
    5 '''Please report any issue to  shr-devel attt lists.shr-project.org  with subject "PalmPreInstall" to help us in our project. Thanks '''
    6 
    7 == Installation and Usage of SHR on the Palm Pre ==
    8 
    9 === What to expect ===
    10 
    11 This howto will help you how to install a recent SHR image on the Palm Pre/Pre2 device.
    12 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!
    13 You have been warned.
    14 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.
    15 See Status section to see what progress has been made
    16 
    17 == Manual installation ==
    18 
    19 === Needed things ===
    20 
    21  * a computer with linux installed
    22  * an active internet connection
    23  * Palm Pre device attached over USB to your compuer
    24  * the webos doctor corresponding to your device (see [http://www.webos-internals.org/wiki/Webos_Doctor_Versions WebOS Internals' wiki])
    25  * novacom, [http://developer.palm.com/index.php?option=com_content&view=article&layout=page&id=1585&Itemid=55 and just novacom!] (<= This for the pre only. For the pre2 they have not yet published  an updated version of novacom. Come to our irc channel and we will see what we can do)
    26 
    27 The following five steps are the basic steps you need to use the fso-installer.
    28  
    29  1. Create a "downloads" directory and put in there the webos version you have downloaded, something like webosxxxxx.jar .
    30  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 )
    31  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
    32  4. Plug your device to your computer with the usb cable.
    33  5. Put your device in developer mode.(see [http://www.webos-internals.org/wiki/Getting_started#Enabling_Developer_Mode WebOS Internals' wiki])
    34 
    35 === Reboot your device into 'flash' mode ===
    36 
    37 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:
    38 
    39 {{{
    40 make memload
    41 }}}
    42 
    43 === Backup up everything ===
    44 
    45 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:
    46 
    47 {{{
    48 make backup
    49 }}}
    50 
    51 === Resize internal flash disk of your device ===
    52 
    53 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.
    54 
    55 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.
    56 
    57 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.
    58 
    59 {{{
    60 make lvm-resize
    61 }}}
    62 
    63 === Intall the bootloader ===
    64 
    65 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
    66 
    67 {{{
    68 make install-bootr
    69 }}}
    70 
    71 === Flash the kernel ===
    72 
    73 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:
    74 
    75 {{{
    76 make KERNEL=~/path/to/your/kernel/uImage-palmpre.bin flash-kernel
    77 }}}
    78 
    79 === Flash the image ===
    80 
    81 Flashing the image to the device is as simple as flashing the kernel to the device.
    82 
    83 {{{
    84 make IMAGE=~/path/to/your/kernel/shr-image.tar.gz flash-image
    85 }}}
    86 
    87 == How to update all your FSO/SHR ==
    88 
    89 === Step one ===
    90 
    91 Plug your device to your computer with the usb cable and put it in recover mode.(see [http://www.webos-internals.org/wiki/Recover_mode WebOS Internals' wiki])
    92 
    93 === Step two ===
    94 
    95 {{{
    96 make update-all
    97 }}}
    98 
    99 === Step three ===
    100 
    101 {{{
    102 make reboot
    103 }}}
    104 
    105 NOTE: If you want to update just your kernel or your rootfs  you have then an other step for example:
    106 
    107 {{{
    108 make memload
    109 make update-kernel
    110 make reboot
    111 }}}
    112 
    113 
    114 == Status ==
    115 
    116 '''WARNING! It is still really experimental for the moment! only not for beginners.'''
    117 
    118 SHR on pre's device still does not offer much than just standards applications working.. no gsm?
    119 
    120 a link to what FSO supports ?