Replicant

h1. Porting Replicant to Android 9

h2. Status

* The Galaxy SIII 4G (i9305) boots (with graphics hacks) under AOSP9, without having to import nonfree libraries. Not much has been validated beside that.

* The kernel used is based on Linux 5.0-rc6 and has ~150 Android specific patches on top and some patches for the Galaxy SIII 4G (i9305) on top

h2. Repositories and changes

* git://git.putti.eu/aosp/manifest_i9305.git

* git://git.putti.eu/aosp/kernel_i9305.git

* git://git.putti.eu/aosp/device_i9305.git

h2. Building

First get the source code:

<pre>

$ repo init -u git://git.putti.eu/aosp/manifest_i9305.git -b android-9.0.0

</pre>

For Trisquel8 (WIP):

<pre>

sudo apt-get install git-core gnupg flex bison gperf build-essential zip curl zlib1g-dev gcc-multilib g++-multilib libc6-dev-i386 lib32ncurses5-dev x11proto-core-dev libx11-dev lib32z-dev libgl1-mesa-dev libxml2-utils xsltproc unzip bc python-mako

</pre>

Then see the device/putti/i9305/README.md for the build instructions.

h2. TODO

|_. Task |_. Time estimation |_. Comments |

| -boot a device under AOSP9- | DONE | Only boots with graphics, not much more |

| build it under a "FSDG compliant distribution":https://www.gnu.org/distros/free-distros.html like Trisquel8 | 7h | WIP for AOSP, It's difficult to do precise time estimations as it could work out of the box or require one full time month of work depending on how much issues are encountered |

| * port the changes from AOSP9 to LineageOS 16

* cleanup the code

* build the kernel from the Android build system

* make sure it builds with an FSDG compliant distribution

* document the build procedure | 21h | |

| find, remove and document proprietary software in LineageOS 16 | 14h | |

| find, remove and document privacy issues in LineageOS 16 | 21h | |

| port the touch keys linux driver | 7h | |

| port the flash led linux driver | 7h | |

| Rebrand LineageOS as Replicant | 7h | |

| * port and cleanup the the i9300 "modem":https://github.com/fourkbomb/linux/tree/modem linux driver from 4.16 to 5.0

* Make the modem driver and libsamsung-ipc work together  | 70h | |

|_. Total |_. 154h | ~1 month |

| port  libsamsung-ril and libsamsung-ipc to Android 9| 157h | libsamsung-ipc should be trivial, libsamsung-ril probably needs to be heavily adapted to Trebble or the new RIL interfaces |

|_. Total |_. 157h | ~1 month |

|_. Task |_. Time estimation |_. Comments |

| port the sensors libraries and other device specific libraries | 70h | |

| add support for Audio | 70h | Might be way faster, depending on what Android 9 uses |

| add support for the i9300 and factorize the code with i9305 | 14h | |

| create a recovery | 21h | |

| add internal WiFi support and validate the functionality | 6h | |

| add external WiFi dongles suppor | 20h | External dongles support might be tricky |

| create new install and upgrade instructions | 35h | Our current install instructions don't scale as we have one copy for each device.

We also created generic instructions but they tend to be harder to follow[1] than the device specific ones.

This will be made in a modular format (for instance in LaTeX) that enables to generate per device install instructions without requiring to have multiples copy of the same text. The instructions will need to be able to be modified and compiled on an FSDG compliant distribution. |

| Reduce the attack surface | | |

| add in-system upgrades | |

fn1. The generic instructions were tested at Install parties in Paris 

h3. Devices support:

h4. Easy

|_. Device |_. Time estimation |_. Comments |

| Galaxy Note II (N7100) | |/2. Similar to the Galaxy SIII (I9300) | 

| Galaxy Note 8.0 (N5100) and 8.0 WiFi (N5110)| |

h4. Needs more work and unknown upstream Linux status

|_. Device |_. Time estimation |_. Comments |

| Galaxy S II (i9100) | | linux: devboard dts upstream? unknown status |

| Galaxy Note (N7000) | | unknown linux upstream status |

| Galaxy Nexus (I9250) | |/2. OMAP4, no dts upsrteam |

| Galaxy Tab 2 7.0 (P3100), 7.0 WiFi (P3110), 10.1 (P5100), 10.1 WiFi (P5110) | |

| GTA04 >= A4 | | TODO: a RIL needs to be written, userspace GPS support is missing, audio scenarios, etc |

h2. Replicant 6.0 changes

|_. Repository path |_. rebase worked |_. Changes |

| build | No | |

| manifest | No | N/A |

| bootable/recovery | Yes | * UI changes to improve usability 

* Branding

* Small fix(es) | 

| external/boringssl | Yes | * Small fix(es) |

| external/heimdall | No | |

| frameworks/av | Yes | * Software rendering fix(es) |

| frameworks/base | Yes | * WiFi fixe(s) for external dongles

* Software rendering fix(es) 

* Privacy fix(es) 

* Security improvements 

* Usability improvements |

| frameworks/native | No |

| hardware/broadcom/wlan | Yes | * Remove nonfree software |

| hardware/libhardware | Yes | * Software rendering fix(es) |

| hardware/libhardware_legacy | Yes | * Don't depend on nonfree software |

| hardware/ti/omap4 | Yes | * Remove nonfree software 

* Don't depend on nonfree software 

* Small fix(es) |

| libcore | Yes | * Small fix(es) | 

| packages/apps/Browser | Yes | * Privacy fix(es) 

* Branding

* Small fix(es) |

| packages/apps/LegacyCamera | Yes | * Software rendering fix(es)

* Small fix(es) |

| packages/apps/RepWifi | Not upstreamed, obsolete | N/A |

| packages/apps/ReplicantWallpapers | Not upstreamed | * Branding |

| packages/apps/Settings | No | |

| packages/apps/SetupWizard | Yes | * Privacy fix(es) 

* Don't depend on nonfree software

* Branding |

| packages/apps/ThemeChooser | Yes | * Privacy fix(es) ?

* Don't depend on nonfree software ? |

| packages/providers/ContactsProvider | Yes | * Small fix(es) |

| system/core | Yes | * Branding

* various fixes |

| vendor/replicant | No | |

| vendor/cmsdk | Yes | * Branding |

| external/chromium-webview | ? | ? |

| external/drm_gralloc | Yes | * Software rendering fix(es) |

| external/llvm | Yes | * Software rendering fix(es) |

| external/mesa3d |  Yes | * Software rendering fix(es)

* Performance debugging for software rendering |

| external/parameter-framework | Yes | * Small fix(es) |

| external/protobuf | N/A | No changes |

| prebuilts/ndk | ? | ? |

| prebuilts/sdk | ? | ? |

| sdk | Yes | * Small fix(es) |

| toolchain/src/binutils | Yes | * Small fix(es) |

| toolchain/src/gcc | No | |

| toolchain/src/jack | Yes | * Small fix(es) |

| toolchain/src/jill | Yes | * Small fix(es) |

| kernel/samsung/smdk4412 |/3. Yes |/3. * Security fixes

* Privacy Fixes (TrustZone)

* Don't depend on nonfree software

* Remove nonfree software

* Small fix(es) |

| kernel/samsung/tuna |

| kernel/samsung/espresso10 |

| device/samsung/i9100 | No |/14. * Replace nonfree software by free software

* free software sensors implementation(s)

* free software modem audio implementation(s)

* Software rendering fix(es)

* Privacy Fixes (TrustZone)

* Don't depend on nonfree software

* Remove nonfree software

* Branding

* Small fix(es) |

| device/samsung/n7000 | Yes |

| device/samsung/i9300 | No |

| device/samsung/i9305 | No |

| device/samsung/n7100 | Yes |

| device/samsung/n5100 | Yes |

| device/samsung/n5110 | Yes |

| device/samsung/maguro | Yes |

| device/samsung/tuna | Yes |

| device/samsung/espressowifi | Yes |

| device/samsung/espresso3g | Yes |

| device/samsung/galaxys2-common | Yes |

| device/samsung/smdk4412-common | No |

| device/samsung/kona-common | Yes |

| hardware/ril/samsung-ril | Not upstreamed | N/A |

| external/libsamsung-ipc | Not upstreamed | N/A |

| hardware/tinyalsa-audio | Not upstreamed? | N/A |

h2. Links 

* https://source.android.com/setup/build/requirements