Replicant

== Introduction ==

Many people bought many different phones, and some of them whish to help replicant and/or to port replicant to their phones or devices.

This guide will show what was done for the htc dream, so theses people could understand the process better.

== Build the source ==

The first thing to do is to download the replicant sources:

[wiki:BuildDream] can be used as a reference: download and build the sources for your device.

Let's say the user has an htc wildfire.

The main difference will be that instead of doing that:

{{{

lunch cyanogen_dream_sapphire-eng 

}}}

you would need to identify the right command that correspond to your device, so in order to do that:

when you run the following command look at the output.

{{{

$ source build/envsetup.sh

including device/geeksphone/one/vendorsetup.sh

including device/htc/ace/vendorsetup.sh

including device/htc/bravoc/vendorsetup.sh

including device/htc/bravo/vendorsetup.sh

including device/htc/buzz/vendorsetup.sh

including device/htc/glacier/vendorsetup.sh

including device/htc/heroc/vendorsetup.sh

including device/htc/inc/vendorsetup.sh

including device/htc/legend/vendorsetup.sh

including device/htc/liberty/vendorsetup.sh

including device/htc/supersonic/vendorsetup.sh

including device/htc/vision/vendorsetup.sh

including device/motorola/sholes/vendorsetup.sh

including device/nvidia/harmony/vendorsetup.sh

including vendor/cyanogen/vendorsetup.sh

}}}

The output include the list of supported(by cyanogenmod) devices.

For instance if you have the bravo phone do:

{{{

$ cat device/htc/buzz/vendorsetup.sh 

#

# Copyright (C) 2008 The Android Open Source Project

#

# Licensed under the Apache License, Version 2.0 (the "License");

# you may not use this file except in compliance with the License.

# You may obtain a copy of the License at

#

#      http://www.apache.org/licenses/LICENSE-2.0

#

# Unless required by applicable law or agreed to in writing, software

# distributed under the License is distributed on an "AS IS" BASIS,

# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

# See the License for the specific language governing permissions and

# limitations under the License.

#

# This file is executed by build/envsetup.sh, and can use anything

# defined in envsetup.sh.

#

# In particular, you can add lunch options with the add_lunch_combo

# function: add_lunch_combo generic-eng

add_lunch_combo generic_buzz-eng

}}}

Note that the developper is supposed to know the code of his device, that is to say that the htc wildfire correspond to the "buzz" codename.

then instead of typing that:

{{{

lunch cyanogen_dream_sapphire-eng 

}}}

type what correspond to your device:

{{{

lunch generic_buzz-eng

}}}

Then build the source, backup what's on your device, including the operating system, and flash the new replicant image.

Then test what works and what doesn't.

The images are located in 

{{{

out/target/product/dream_sapphire

}}}

in the case of the htcdream, look in the path that correspond to your device.

== Trying free replacements ==

As you built The source code you now have some libraries that could replace the proprietary libraries.

The list of proprietary libraries are available in  

{{{

device/htc/dream_sapphire/extract-files.sh

}}}

Note: don't run this file, just look at it, if you run it, not only you would make a build containing proprietary libraries,putting you and your users at risk, but is is also illegal to redistribute such build, because the libraries are not redistributable(the copyright owner didn't allow you to redistribute them)

=== Ril test ===

I will take the example of how to use the free ril to see if it works fine without modifications:

The proprietary ril library(which you don't have in the phone) location is found looking at the extract-files.sh

here's a part of extract-files.sh:

{{{

adb pull /system/lib/libhtc_ril.so ../../../vendor/htc/$DEVICE/proprietary/libhtc_ril.so

}}}

Note: don't run this command, just look at it, if you run it, not only you would make a build containing proprietary libraries,putting you and your users at risk, but is is also illegal to redistribute such build, because the libraries are not redistributable(the copyright owner didn't allow you to redistribute them)

So looking at the above line the proprietary ril is located here:

{{{

/system/lib/libhtc_ril.so

}}}

while the free ril is located here(known fact):

{{{

/system/lib/libreference-ril.so

}}}

In order to test the free ril you could be tempted to do that:

{{{

# ./adb remount

# ./adb shell

mv /system/lib/libreference-ril.so /system/lib/libhtc_ril.so

}}}

But that wouldn't work as it wouldn't be using the right serial port, the correct way to try that is to use getprop/setprop:

{{{

# ./adb shell

# setprop

usage: setprop <key> <value>

}}}

Here's how it looks on a working replicant on the htcdream:

{{{

# ./adb shell

# getprop | grep ril

[ro.ril.hsxpa]: [2]

[ro.ril.gprsclass]: [10]

[rild.libpath]: [/system/lib/libreference-ril.so]

[rild.libargs]: [-d/dev/smd0]

[init.svc.ril-daemon]: [running]

[ro.ril.def.agps.mode]: [2]

[gsm.version.ril-impl]: [android reference-ril 1.0]

}}}

 * /dev/smd0 is the (emulated)serial port

 * /system/lib/libreference-ril.so is where to look for the ril hardware specific library 

Then change the following properties and reboot:

{{{

./adb shell reboot

}}}

Then tryout the reference ril.

== Replace proprietary libraries for real ==

On the htcdream the following proprietary libraries were replaced:

( Refer to [wiki:ProprietaryHtcDreamLibsReplacement] for more up to date details(or fix it if it's less recent) )

The first thing you will have to do is to modify the build system.

The key thing to do is to change 

=== ril ===

if the ril you previously tried works fine, why not switching to it...directly in the build system.

Here's the diff between A working ril and a non-working ril for the htcdream:

{{{

android_device_htc_dream_sapphire$ git diff 5593d2899203ec378c306701788f1c43af9a6935 -- full_dream_sapphire.mk

diff --git a/full_dream_sapphire.mk b/full_dream_sapphire.mk

index 9ec7feb..eb1b956 100644

--- a/full_dream_sapphire.mk

+++ b/full_dream_sapphire.mk

@@ -40,7 +40,8 @@ PRODUCT_PROPERTY_OVERRIDES := \

     ro.media.dec.jpeg.memcap=10000000

 PRODUCT_PROPERTY_OVERRIDES += \

-    rild.libpath=/system/lib/libhtc_ril.so \

+    rild.libpath=/system/lib/libreference-ril.so \

+    rild.libargs=-d/dev/smd0 \

     wifi.interface=tiwlan0

 # Time between scans in seconds. Keep it high to minimize battery drain.

}}}

Note that full_dream_sapphire.mk is located here:

{{{

device/htc/dream_sapphire/full_dream_sapphire.mk

}}}

The diff is self-explanatory and how to do the change is left as an exercise to the reader.

In case the ril need to be modified the sources are in :

{{{

hardware/ril/reference-ril

}}}

They are written in C.