Changes between Version 4 and Version 5 of PalmPreInstall

Timestamp:

01/13/11 01:27:36 (2 years ago)

Author:

GarthPS

Comment:

First time off a first real guide

PalmPreInstall

@@ -1 @@
-= Installation and Usage of SHR on the Palm Pre =
+= Disclaimer (WebOSInternals' credit) =
 
-== What to expect ==
+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. 
 
-This howto will help you how to install a recent SHR image on the Palm Pre device. This don't take care about the webOS which can be installed in parallel! So don't expect a usable phone after you installed SHR! Even there is currently no working multi-boot solution.
+== 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!
+Even there is currently no working multi-boot solution.(That will change quickly!)
+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.
+
 
 == Installation ==
@@ -9 +18 @@
 === Needed things ===
 
- * fso-installer ( a Makefile :http://git.freesmartphone.org/?p=utilities.git;a=blob_plain;f=palmpre/fso-installer/Makefile;hb=HEAD )
- * novacom (developer.palm.com)
- * webos doctor (see webos-internals wiki)
- * kernel and image (here: to come)
+ * a computer under a linux distro
+ * an internet connection
+ * your device and its usb cable
+ * a new directory to do all our stuf :)
+ * the webos doctor corresponding to your device (see [http://www.webos-internals.org/wiki/Webos_Doctor_Versions WebOS Internals' wiki])
+ * novacom, [http://developer.palm.com/index.php?option=com_content&view=article&layout=page&id=1585&Itemid=55 and just novacom!]  Install it of course! (<= This for the pre only. For the pre2 they have not yet published  an updated version of novacom. But there ares solution. Come to our irc channel and we will see what we can so)
+
 
 === Step one ===
-Put all needed things in a dedicated directory, create a "downloads" directory and put in it the kernel, the image,and the webos jar.
-Modify the fso-installer Makefile ..
+ 
+ Create a "downloads" directory and put in there the webos version you have downloaded, something like webosxxxxx.jar .
+
+=== Step two ===
+
+ In our working directory (not in "downloads/" !), downloads the fso-installer ( a Makefile http://git.freesmartphone.org/?p=utilities.git;a=blob_plain;f=palmpre/fso-installer/Makefile;hb=HEAD )
+
+=== Step three ===
+
+ 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
+
+ So for now you have something like this : 
+
+{{{
+
+ workingdir/
+    =>Makefile
+    =>downloads/
+      =>webosdoctorp103ueuuna-wr-2.0.0.jar
+}}}
+
+
+
+=== Step four ===
+( You have not forgoten to save the Makefile I hope!)
+ Plug your device to your computer with the usb cable.
+
+=== Step five ===
+(wouhw step four was very hard... :) )
+
+ Put your device in dev mode.(see [http://www.webos-internals.org/wiki/Getting_started#Enabling_Developer_Mode WebOS Internals' wiki])
+
+=== Step six ===
+
+ Open a terminal in your working directory an launch the installation with 
+{{{
+make install-all
+}}}
+
+
+=== Step seven ===
+
+ It is time to go grab something/someone to eat/drink or kiss because from now your computer will follow the Makefile and making through all the needed things to install FSO/SHR on your precious!
+
+=== Step eight ===
+
+ You are still there wondering exactly what it is really doing? Good! well I mean no! un-good! I told you to take care of yourself or someone else!
+
+...
+
+Ok still here: then you can read the Makefile yourself, your old enough!!
+
+...
+
+Ok I will definitely order your some plastic... Here is your stuff
+
+{{{
+wget-stuff (kernel and image)
+memboot (reboot your device to be able to install all those wonderful things)
+backup (backup all your device into our working dir)
+lvm-resize (split the partition used to store your extra stuff into two partition => a new one for FSO/SHR)
+restore-media (restore back your data to media/internal like nothing happened)
+flash-image (you want an explanation? RTFM ! :) )
+flash-kernel (...)
+setup-init (setup simlinks to boot our stuff)
+reboot (yeah that's right! it does it for you!!)
+}}}
+
+=== Step nine ===
+
+ You come back from somewhere and your device is shining from ten miles away!!
+
+ Yes you don't dream :)  You have now FSO/SHR running on your precious!
+
+== How to switch OS ==
+
+ OK that is fun but FSO/SHR is not right the master piece you wanted (and you are right to do so! I mean expecting this master piece) for now so you want to swich from on OS to an other.
+
+ Even if we do not have a multi-boot solution, that is still simple.
+
+=== Step one ===
+
+ 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])
+
+=== Step two ===
+
+{{{
+make switch-boot
+}}}
+
+=== Step three ===
+
+{{{
+make reboot
+}}}
+
+== How to update all your FSO/SHR ==
+
+ Now you want to update your FSO/SHR version, good!
+
+ There is two solutions! 
+
+ The first one is just to update it directly from FSO/SHR
+
+{{{
+opkg update
+opkg upgrade
+}}}
+
+
+ The second one is more heavy stuff
+ 
+ WARNING: it will remove everything of your FSO/SHR partition
+
+=== Step one ===
+
+ 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])
+
+=== Step two ===
+
+{{{
+make update-all
+}}}
+
+=== Step three ===
+
+{{{
+make reboot
+}}}
+
+ NOTE: If you want to update just your kernel or your rootfs  you have then an other step for example:
+
+{{{
+make memload
+make update-kernel
+make reboot
+}}}
+
+That is all for tonight!
+
+== Status ==
 
 [...]