Project

General

Profile

DeprecatedInstallation » History » Revision 12

Revision 11 (Paul Kocialkowski, 09/26/2011 07:37 PM) → Revision 12/35 (Paul Kocialkowski, 09/26/2011 07:43 PM)

== Summary == 

  * [#installdetailed Detailed instructions to install Replicant] 
  * [#installsummary Summary of the instructions to install Replicant] 

 == Detailed instructions to install Replicant == #installdetailed 

  1. '''Make sure your phone is supported'''[[BR]][[BR]] 
     Replicant only supports a few phones. Make sure the phone you want to install Replicant on is on the ReplicantStatus list. If it's not, you won't be able to install Replicant on your device without at least a bit of software hacking.[[BR]][[BR]] 
  2. '''Make sure your phone allows non-official images'''[[BR]][[BR]] 
     Some phones come with software that allows the user to ''flash'' the memory (replace the content of the memory partitions, like the system or the kernel one), but it's not always the case. Google-branded phones (Nexus One and Nexus S) come with this allowed but for some other devices, you'll certainly have to do some more operations to make this possible (it's required to flash Replicant).[[BR]] 
     Please, refer to the [http://wiki.cyanogenmod.com/wiki/Main_Page CyanogenMod wiki] to find and follow the instructions to '''root the phone'''. Note that instructions for Replicant 2.2 correspond to CyanogenMod 6 and Replicant 2.3 correspond to CyanogenMod 7.[[BR]] 
     For instance on the [http://wiki.cyanogenmod.com/wiki/HTC_Dream HTC Dream] page, you'll need to follow the instructions to '''root the phone''' and to install '''DangerSPL'''.[[BR]][[BR]] 
     '''Note: all the radio images and bootloader images that are provided on these pages are not free software.'''[[BR]][[BR]] 
  3. '''Download the Replicant images and tools for your phone'''[[BR]][[BR]] 
    a. '''Find the codename of your phone'''[[BR]] 
       Each device we support has a codename. You can find the codenames on the ReplicantStatus page. [[BR]] 
       For instance, HTC Dream has {{{ Codename: dream_sapphire }}}.[[BR]][[BR]] 
    b. '''Find the latest usable Replicant image'''[[BR]] 
       The ReplicantStatus page also shows the latest usable Replicant image for each device.[[BR]] 
       For instance, HTC Dream/HTC Magic has {{{ Last usable image: Replicant 2.2 preview 0008 }}}.[[BR]][[BR]] 
    c. '''Find '''Download the base location of tools to send the tools/images for your device'''[[BR]][[BR]] Replicant image to the phone'''[[BR]][[BR]] 
       Replicant images are hosted at: http://ftp.osuosl.org/pub/replicant/images/ [[BR]] 
       From this page, select the Replicant version (replicant-2.2, replicant-2.3, etc) of the latest usable Replicant image for your device.[[BR]] 
       Then, select the Replicant image type (preview or release) of the latest usable Replicant image for your device.[[BR]] 
       Select the Replicant image number (0006 for example) of the latest usable Replicant image for your device.[[BR]] 
       Select the '''tools''' directory and download the '''fastboot''' utility to write Replicant on your device. [[BR]] 
       For instance, if the phone is HTC Dream and the latest image {{{ Replicant 2.2 preview 0008 }}}, the base '''fastboot''' location will be: {{{ http://ftp.osuosl.org/pub/replicant/images/replicant_2.2/preview/0008/ }}}.[[BR]][[BR]] 
    d. '''Download the tools http://ftp.osuosl.org/pub/replicant/images/replicant_2.2/preview/0008/tools/fastboot }}}. 
  3. '''Root your phone'''[[BR]][[BR]] 
     The phone needs to flash your device'''[[BR]][[BR]] 
       From the base location be rooted so we just found out, select can install Replicant. You should be able to follow the '''tools''' directory CyanogenMod instructions for this. Go to {{{ http://wiki.cyanogenmod.com/wiki/ }}} and download the '''fastboot''' utility find your device's installation instructions. 
  4. '''[HTC DREAM ONLY] Install DangerSPL'''[[BR]][[BR]] 
     MarkTraceur had to write Replicant do this in order to make enough space on your device. [[BR]][[BR]] 
    e. '''Download the Replicant images his phone for your device'''[[BR]][[BR]] 
       From the base location we just found out, select images, you might have to as well. You should still be following the ''pieces'' directory and then CyanogenMod instructions, so continue from the directory corresponding rooting section on to your phone codename and download the '''boot.img''' (kernel), '''system.img''' (OS) 'Flashing Radio' and '''userdata.img''' (data) files. 'installing DangerSPL' instructions. It should be pretty straightforward from there, since you can take some time. [[BR]][[BR]] 
 now install the images. Here is a direct link: {{{ http://wiki.cyanogenmod.com/wiki/Dream:DangerSPL#How_do_I_check_if_I_already_have_DangerSPL.3F }}} 

 == Summary of the instructions to install Replicant == #installsummary 

 == Requirements == 
  * a rooted or unlocked phone 
  * fastboot(can be built or obtained [http://ftp.osuosl.org/pub/replicant/images/replicant_2.2/ from our ftp]) 
  * the images(can be built or obtained [http://ftp.osuosl.org/pub/replicant/images/replicant_2.2/ from our ftp]) 

 == Installation == 

 Put the phone in fastboot mode (by holding the Camera button and the Power button, then following on-screen instructions), make sure it's connected to your computer, and run the following commands on your computer. You may need to use sudo. 

 '''Note, if you don't have instructions for entering fastboot mode, you may need to install DangerSPL using the CyanogenMod instructions.''' 

 '''Note that it will erase everything on the phone'''  
 {{{ 
 ./fastboot flash system system.img 
 ./fastboot flash boot boot.img 
 ./fastboot flash userdata userdata.img  
 ./fastboot erase cache 
 ./fastboot reboot 
 }}}