Project

General

Profile

DeprecatedPortingToAndroid10 » History » Revision 97

Revision 96 (Denis 'GNUtoo' Carikli, 03/29/2019 12:33 AM) → Revision 97/289 (Denis 'GNUtoo' Carikli, 03/29/2019 12:36 AM)

h1. Porting Replicant to Android 9 

 h2. Status with AOSP 9 

 * 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. AOSP 9 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 AOSP version 

 h3. Source code 

 First get the source code: 
 <pre> 
 $ repo init -u git://git.putti.eu/aosp/manifest_i9305.git -b android-9.0.0 
 </pre> 

 h3. For Trisquel8 
 <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> 

 h3. Building it 

 Once this is done, see the device/putti/i9305/README.md for the build instructions. 

 h3. Trisquel 8 LXC 

 If you use Parabola, you may be interested in running Trisquel 8 in LXC. 

 To do that first debootstrap a Trisquel 8 rootfs.  

 Parabola's debootstrap does support Trisquel 8 and its manual has an example on how to do that: 
 <pre> 
 $ man debootstrap 
 [...] 
 # debootstrap flidas flidas-root http://archive.trisquel.info/trisquel 
 </pre> 

 Then you can use virt-manager to setup the LXC instance. 

 The advantages of this solution are that: 
 * The LXC guest and host shares their resources (CPU, RAM) with almost no penalty 
 * Trisquel 8 is not a rolling release distribution 

 The disadvantage of this solution are that: 
 * you need to configure again the Trisquel 8 LXC instance (vimrc, sshd_config, etc) 
 * It's more complicated to setup 
 * The Android build system output a warning message about not being able to use namespaces which may become mandatory in newer Android versions 

 h2. TODO 

 First month of full time equivalent work: 

 |_. 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- DONE | -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-  
 Builds under Trisquel8| 
 | * 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 AAT1290 flash led Linux driver | 7h | | 
 | rebrand LineageOS as Replicant | 7h | | 
 | port and cleanup the the Galaxy SIII (i9300) "modem":https://github.com/fourkbomb/linux/tree/modem Linux driver from 4.16 to 5.0 | 70h | | 
 |_. Total |_. 147h | ~1 month | 

 Second month of full time equivalent work: 
 | * port    libsamsung-ril and libsamsung-ipc to Android 9 
 * Make the modem driver and libsamsung-ipc work together | 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 | 

 Third month of full time equivalent work: 
 |_. 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 Galaxy SIII (i9300) and factorize the code with i9305 | 14h | | 
 |_. Total |_. 154h | ~1 month | 

 |_. Task |_. Time estimation |_. Comments | 
 | create a recovery | 21h | | 
 | add internal WiFi support and validate the functionality | 6h | | 
 | add external WiFi dongles support | 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. | 

 |_. Task |_. Time estimation |_. Comments | 
 | Estimate the amount of work to Reduce the attack surface | ? | | 
 | Estimate the amount of work to add in-system upgrades | ? | | 

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

 h3. Devices support: 

 

 h4. Easy, because it's similar enough to the Galaxy SIII (I9300) 

 |_\3. Galaxy Note II (N7100) | 
 |_. Task |_. Time estimation |_. Comments | 
 | port the EA8061 LCD Linux driver Driver | 35h | | 
 | port the S6EVR02 LCD Linux driver Driver | 35h | | 
 | port the MAX77693 flash led Linux driver | 7h | | 
 | android: add support for the Note II (N7100) and factorize the code with Galaxy SIII (i9300) and Galaxy SIII 4G (i9305) | 14h | Should be similar to the Galaxy SIII | 
 | port the sensors libraries and other device specific libraries | 70h | It's difficult to evaluate how much time it could take | 
 | add support for Audio | 14h | Should be similar to the Galaxy SIII | 

 |_\3. Galaxy Note 8.0 (N5100) and 8.0 WiFi (N5110) | 
 |_. Task |_. Time estimation |_. Comments | 
 | Evaluate the time required to do the port | 14h | TODO | 

 

 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