Project

General

Profile

DeprecatedPortingToAndroid10 » History » Version 121

Denis 'GNUtoo' Carikli, 04/14/2019 02:30 PM

1 1 Denis 'GNUtoo' Carikli
h1. Porting Replicant to Android 9
2
3 101 Denis 'GNUtoo' Carikli
{{>toc}}
4 1 Denis 'GNUtoo' Carikli
5 101 Denis 'GNUtoo' Carikli
h2. AOSP 9
6
7
h3. Status with AOSP 9
8
9 98 Denis 'GNUtoo' Carikli
* The Galaxy SIII 4G (i9305) boots (with graphics hacks) under AOSP9, without having to import nonfree libraries:
10 99 Denis 'GNUtoo' Carikli
** The device boots until the lock screen
11 98 Denis 'GNUtoo' Carikli
** The graphics work but are really slow as they have not been optimized
12 49 Denis 'GNUtoo' Carikli
** Sometime the display content is corrupted
13 1 Denis 'GNUtoo' Carikli
** The touchscreen works
14 100 Denis 'GNUtoo' Carikli
* 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
15
16
h3.  Repositories and changes
17 46 Denis 'GNUtoo' Carikli
 
18
* git://git.putti.eu/aosp/manifest_i9305.git
19
* git://git.putti.eu/aosp/kernel_i9305.git
20 1 Denis 'GNUtoo' Carikli
* git://git.putti.eu/aosp/device_i9305.git
21 109 Denis 'GNUtoo' Carikli
* git://git.putti.eu/aosp/external_mesa3d.git
22 110 Denis 'GNUtoo' Carikli
* git://git.putti.eu/aosp/build_make.git
23 111 Denis 'GNUtoo' Carikli
* git://git.putti.eu/aosp/core.git
24 1 Denis 'GNUtoo' Carikli
25 100 Denis 'GNUtoo' Carikli
h3. Building AOSP version
26 1 Denis 'GNUtoo' Carikli
27 100 Denis 'GNUtoo' Carikli
h4. Source code
28 88 Denis 'GNUtoo' Carikli
29 46 Denis 'GNUtoo' Carikli
First get the source code:
30 1 Denis 'GNUtoo' Carikli
<pre>
31 46 Denis 'GNUtoo' Carikli
$ repo init -u git://git.putti.eu/aosp/manifest_i9305.git -b android-9.0.0
32 1 Denis 'GNUtoo' Carikli
</pre>
33 88 Denis 'GNUtoo' Carikli
34 100 Denis 'GNUtoo' Carikli
h4. For Trisquel8
35 45 Denis 'GNUtoo' Carikli
<pre>
36 1 Denis 'GNUtoo' Carikli
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
37
</pre>
38
39 100 Denis 'GNUtoo' Carikli
h4. Building it
40 88 Denis 'GNUtoo' Carikli
41
Once this is done, see the device/putti/i9305/README.md for the build instructions.
42
43 100 Denis 'GNUtoo' Carikli
h4. Trisquel 8 LXC
44 88 Denis 'GNUtoo' Carikli
45
If you use Parabola, you may be interested in running Trisquel 8 in LXC.
46
47
To do that first debootstrap a Trisquel 8 rootfs. 
48
49
Parabola's debootstrap does support Trisquel 8 and its manual has an example on how to do that:
50
<pre>
51
$ man debootstrap
52
[...]
53
# debootstrap flidas flidas-root http://archive.trisquel.info/trisquel
54
</pre>
55
56
Then you can use virt-manager to setup the LXC instance.
57
58 89 Denis 'GNUtoo' Carikli
The advantages of this solution are that:
59 88 Denis 'GNUtoo' Carikli
* The LXC guest and host shares their resources (CPU, RAM) with almost no penalty
60
* Trisquel 8 is not a rolling release distribution
61
62
The disadvantage of this solution are that:
63
* you need to configure again the Trisquel 8 LXC instance (vimrc, sshd_config, etc)
64 1 Denis 'GNUtoo' Carikli
* It's more complicated to setup
65 90 Denis 'GNUtoo' Carikli
* The Android build system output a warning message about not being able to use namespaces which may become mandatory in newer Android versions
66 48 Denis 'GNUtoo' Carikli
67 102 Denis 'GNUtoo' Carikli
h2. LineageOS 16
68
69 120 Denis 'GNUtoo' Carikli
h3. Status with LineageOS 16
70 1 Denis 'GNUtoo' Carikli
71 121 Denis 'GNUtoo' Carikli
For now the focus is on rebasing all the changes on top of LineageOS 16:
72
* nothing is usable so far, nothing has been tested yet on real devices
73
* it probably contains proprietary software as it has not been removed yet
74
* the commits and the manifests are constantly rebased
75 105 Denis 'GNUtoo' Carikli
76 120 Denis 'GNUtoo' Carikli
h3. Repositories and changes for LineageOS 16
77 105 Denis 'GNUtoo' Carikli
78 114 Denis 'GNUtoo' Carikli
* git://git.putti.eu/aosp/kernel_i9305.git
79 1 Denis 'GNUtoo' Carikli
* git://git.putti.eu/aosp/external_mesa3d.git
80
* https://git.replicant.us/GNUtoo/android_build.git
81
* https://git.replicant.us/GNUtoo/device_i9305.git
82 116 Denis 'GNUtoo' Carikli
* https://git.replicant.us/GNUtoo/manifest.git
83
* https://git.replicant.us/GNUtoo/vendor_replicant.git
84 120 Denis 'GNUtoo' Carikli
85
h3. Building LineageOS 16 version
86 102 Denis 'GNUtoo' Carikli
87 1 Denis 'GNUtoo' Carikli
h4. Source code
88 102 Denis 'GNUtoo' Carikli
89 117 Denis 'GNUtoo' Carikli
-$ repo init -u https://git.replicant.us/GNUtoo/manifest.git -b GNUtoo/replicant-9-
90
91
The code is being rebased on top of the "i9300 unofficial support for LineageOS":https://github.com/CustomRoms/android_local_manifests_i9300
92 1 Denis 'GNUtoo' Carikli
<pre>
93 119 Denis 'GNUtoo' Carikli
$ rm -rf .repo/manifests/ # This enables me to force push and rebase the manifest repository as well
94 117 Denis 'GNUtoo' Carikli
$ repo init -u https://git.replicant.us/GNUtoo/manifest.git -b GNUtoo/lineage-16.0_i9300
95
$ repo sync --force-sync
96 102 Denis 'GNUtoo' Carikli
</pre>
97
98
h4. For Trisquel8
99 107 Denis 'GNUtoo' Carikli
<pre>
100 102 Denis 'GNUtoo' Carikli
sudo apt-get install bc bison build-essential ccache curl flex g++-multilib gcc-multilib git gnupg gperf imagemagick lib32ncurses5-dev lib32readline-dev lib32z1-dev liblz4-tool libncurses5-dev libsdl1.2-dev libssl-dev libwxgtk3.0-dev libxml2 libxml2-utils lzop pngcrush rsync schedtool squashfs-tools xsltproc zip zlib1g-dev gcc-5-arm-linux-gnueabi
101 104 Denis 'GNUtoo' Carikli
</pre>
102 1 Denis 'GNUtoo' Carikli
103 104 Denis 'GNUtoo' Carikli
h4. Launching the build
104 1 Denis 'GNUtoo' Carikli
105 118 Denis 'GNUtoo' Carikli
Follow the "i9300 manifest instructions:":https://github.com/CustomRoms/android_local_manifests_i9300
106 104 Denis 'GNUtoo' Carikli
<pre>
107 118 Denis 'GNUtoo' Carikli
$ subject='/C=US/ST=California/L=Mountain View/O=Android/OU=Android/CN=Android/emailAddress=android@android.com'
108
$ mkdir .android-certs
109
$ for x in releasekey platform shared media testkey; do \
110
  ./development/tools/make_key .android-certs/$x "$subject"; \
111
  done
112
$ parallel_tasks=$(echo "$(grep 'processor' /proc/cpuinfo | wc -l ) + 1" | bc)
113 104 Denis 'GNUtoo' Carikli
$ source build/envsetup.sh
114 118 Denis 'GNUtoo' Carikli
$ lunch lineage_i9300-userdebug
115
$ make -j${parallel_tasks} bacon
116 38 Denis 'GNUtoo' Carikli
</pre>
117 87 Denis 'GNUtoo' Carikli
118
h2. TODO
119 51 Denis 'GNUtoo' Carikli
120 74 Denis 'GNUtoo' Carikli
First month of full time equivalent work:
121 81 Denis 'GNUtoo' Carikli
122
|_. Task |_. Time estimation |_. Comments |
123 57 Denis 'GNUtoo' Carikli
| -boot a device under AOSP9- | DONE | Only boots with graphics, not much more |
124
| -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- 
125 59 Denis 'GNUtoo' Carikli
Builds under Trisquel8|
126
| * port the changes from AOSP9 to LineageOS 16
127 73 Denis 'GNUtoo' Carikli
* cleanup the code
128
* build the kernel from the Android build system
129 1 Denis 'GNUtoo' Carikli
* make sure it builds with an FSDG compliant distribution
130 94 Denis 'GNUtoo' Carikli
* document the build procedure | 21h | |
131
| find, remove and document proprietary software in LineageOS 16 | 14h | |
132 95 Denis 'GNUtoo' Carikli
| find, remove and document privacy issues in LineageOS 16 | 21h | |
133
| port the touch keys Linux driver | 7h | |
134 1 Denis 'GNUtoo' Carikli
| port the AAT1290 flash led Linux driver | 7h | |
135 93 Denis 'GNUtoo' Carikli
| rebrand LineageOS as Replicant | 7h | |
136 1 Denis 'GNUtoo' Carikli
| 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 | |
137 95 Denis 'GNUtoo' Carikli
|_. Total |_. 147h | ~1 month |
138
139 75 Denis 'GNUtoo' Carikli
Second month of full time equivalent work:
140
| * port  libsamsung-ril and libsamsung-ipc to Android 9
141 87 Denis 'GNUtoo' Carikli
* 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 |
142 1 Denis 'GNUtoo' Carikli
|_. Total |_. 157h | ~1 month |
143 75 Denis 'GNUtoo' Carikli
144 57 Denis 'GNUtoo' Carikli
Third month of full time equivalent work:
145 77 Denis 'GNUtoo' Carikli
|_. Task |_. Time estimation |_. Comments |
146 76 Denis 'GNUtoo' Carikli
| port the sensors libraries and other device specific libraries | 70h | |
147
| add support for Audio | 70h | Might be way faster, depending on what Android 9 uses |
148
| add support for the Galaxy SIII (i9300) and factorize the code with i9305 | 14h | |
149 67 Denis 'GNUtoo' Carikli
|_. Total |_. 154h | ~1 month |
150 71 Denis 'GNUtoo' Carikli
151 96 Denis 'GNUtoo' Carikli
|_. Task |_. Time estimation |_. Comments |
152 74 Denis 'GNUtoo' Carikli
| create a recovery | 21h | |
153 71 Denis 'GNUtoo' Carikli
| add internal WiFi support and validate the functionality | 6h | |
154
| add external WiFi dongles support | 20h | External dongles support might be tricky |
155 1 Denis 'GNUtoo' Carikli
| create new install and upgrade instructions | 35h | Our current install instructions don't scale as we have one copy for each device.
156 92 Denis 'GNUtoo' Carikli
We also created generic instructions but they tend to be harder to follow[1] than the device specific ones.
157
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. |
158
159 71 Denis 'GNUtoo' Carikli
|_. Task |_. Time estimation |_. Comments |
160
| Estimate the amount of work to Reduce the attack surface | ? | |
161 1 Denis 'GNUtoo' Carikli
| Estimate the amount of work to add in-system upgrades | ? | |
162
163
fn1. The generic instructions were tested at Install parties in Paris 
164 82 Denis 'GNUtoo' Carikli
165 1 Denis 'GNUtoo' Carikli
h3. Devices support:
166 85 Denis 'GNUtoo' Carikli
167 77 Denis 'GNUtoo' Carikli
h4. Easy, because it's similar enough to the Galaxy SIII (I9300)
168 97 Denis 'GNUtoo' Carikli
169
|_\3. Galaxy Note II (N7100) |
170 94 Denis 'GNUtoo' Carikli
|_. Task |_. Time estimation |_. Comments |
171 86 Denis 'GNUtoo' Carikli
| port the EA8061 LCD Linux driver | 35h | |
172
| port the S6EVR02 LCD Linux driver | 35h | |
173
| port the MAX77693 flash led Linux driver | 7h | |
174
| 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 |
175
| port the sensors libraries and other device specific libraries | 70h | It's difficult to evaluate how much time it could take |
176
| add support for Audio | 14h | Should be similar to the Galaxy SIII |
177
178 1 Denis 'GNUtoo' Carikli
|_\3. Galaxy Note 8.0 (N5100) and 8.0 WiFi (N5110) |
179 70 Denis 'GNUtoo' Carikli
|_. Task |_. Time estimation |_. Comments |
180
| Evaluate the time required to do the port | 14h | TODO |
181 69 Denis 'GNUtoo' Carikli
182 94 Denis 'GNUtoo' Carikli
h4. Needs more work and unknown upstream Linux status
183
184 54 Denis 'GNUtoo' Carikli
|_. Device |_. Time estimation |_. Comments |
185
| Galaxy S II (i9100) | | Linux: devboard dts upstream? unknown status |
186
| Galaxy Note (N7000) | | unknown Linux upstream status |
187 34 Denis 'GNUtoo' Carikli
| Galaxy Nexus (I9250) | |/2. OMAP4, no dts upsrteam |
188
| Galaxy Tab 2 7.0 (P3100), 7.0 WiFi (P3110), 10.1 (P5100), 10.1 WiFi (P5110) | |
189 2 Denis 'GNUtoo' Carikli
| GTA04 >= A4 | | TODO: a RIL needs to be written, userspace GPS support is missing, audio scenarios, etc |
190 4 Denis 'GNUtoo' Carikli
191 22 Denis 'GNUtoo' Carikli
h2. Replicant 6.0 changes
192 1 Denis 'GNUtoo' Carikli
193 32 Denis 'GNUtoo' Carikli
|_. Repository path |_. rebase worked |_. Changes |
194 5 Denis 'GNUtoo' Carikli
| build | No | |
195 31 Denis 'GNUtoo' Carikli
| manifest | No | N/A |
196 4 Denis 'GNUtoo' Carikli
| bootable/recovery | Yes | * UI changes to improve usability 
197
* Branding
198
* Small fix(es) | 
199
| external/boringssl | Yes | * Small fix(es) |
200
| external/heimdall | No | |
201
| frameworks/av | Yes | * Software rendering fix(es) |
202 1 Denis 'GNUtoo' Carikli
| frameworks/base | Yes | * WiFi fixe(s) for external dongles
203 5 Denis 'GNUtoo' Carikli
* Software rendering fix(es) 
204
* Privacy fix(es) 
205
* Security improvements 
206 10 Denis 'GNUtoo' Carikli
* Usability improvements |
207 5 Denis 'GNUtoo' Carikli
| frameworks/native | No |
208
| hardware/broadcom/wlan | Yes | * Remove nonfree software |
209 33 Denis 'GNUtoo' Carikli
| hardware/libhardware | Yes | * Software rendering fix(es) |
210
| hardware/libhardware_legacy | Yes | * Don't depend on nonfree software |
211 6 Denis 'GNUtoo' Carikli
| hardware/ti/omap4 | Yes | * Remove nonfree software 
212 8 Denis 'GNUtoo' Carikli
* Don't depend on nonfree software 
213 33 Denis 'GNUtoo' Carikli
* Small fix(es) |
214 7 Denis 'GNUtoo' Carikli
| libcore | Yes | * Small fix(es) | 
215 33 Denis 'GNUtoo' Carikli
| packages/apps/Browser | Yes | * Privacy fix(es) 
216 22 Denis 'GNUtoo' Carikli
* Branding
217
* Small fix(es) |
218 11 Denis 'GNUtoo' Carikli
| packages/apps/LegacyCamera | Yes | * Software rendering fix(es)
219
* Small fix(es) |
220
| packages/apps/RepWifi | Not upstreamed, obsolete | N/A |
221
| packages/apps/ReplicantWallpapers | Not upstreamed | * Branding |
222 12 Denis 'GNUtoo' Carikli
| packages/apps/Settings | No | |
223
| packages/apps/SetupWizard | Yes | * Privacy fix(es) 
224 33 Denis 'GNUtoo' Carikli
* Don't depend on nonfree software
225 13 Denis 'GNUtoo' Carikli
* Branding |
226
| packages/apps/ThemeChooser | Yes | * Privacy fix(es) ?
227
* Don't depend on nonfree software ? |
228
| packages/providers/ContactsProvider | Yes | * Small fix(es) |
229 14 Denis 'GNUtoo' Carikli
| system/core | Yes | * Branding
230
* various fixes |
231
| vendor/replicant | No | |
232
| vendor/cmsdk | Yes | * Branding |
233
| external/chromium-webview | ? | ? |
234 33 Denis 'GNUtoo' Carikli
| external/drm_gralloc | Yes | * Software rendering fix(es) |
235 14 Denis 'GNUtoo' Carikli
| external/llvm | Yes | * Software rendering fix(es) |
236
| external/mesa3d |  Yes | * Software rendering fix(es)
237
* Performance debugging for software rendering |
238 33 Denis 'GNUtoo' Carikli
| external/parameter-framework | Yes | * Small fix(es) |
239
| external/protobuf | N/A | No changes |
240 14 Denis 'GNUtoo' Carikli
| prebuilts/ndk | ? | ? |
241 33 Denis 'GNUtoo' Carikli
| prebuilts/sdk | ? | ? |
242
| sdk | Yes | * Small fix(es) |
243 22 Denis 'GNUtoo' Carikli
| toolchain/src/binutils | Yes | * Small fix(es) |
244 1 Denis 'GNUtoo' Carikli
| toolchain/src/gcc | No | |
245
| toolchain/src/jack | Yes | * Small fix(es) |
246 20 Denis 'GNUtoo' Carikli
| toolchain/src/jill | Yes | * Small fix(es) |
247 33 Denis 'GNUtoo' Carikli
| kernel/samsung/smdk4412 |/3. Yes |/3. * Security fixes
248 22 Denis 'GNUtoo' Carikli
* Privacy Fixes (TrustZone)
249
* Don't depend on nonfree software
250 28 Denis 'GNUtoo' Carikli
* Remove nonfree software
251
* Small fix(es) |
252
| kernel/samsung/tuna |
253 25 Denis 'GNUtoo' Carikli
| kernel/samsung/espresso10 |
254 29 Denis 'GNUtoo' Carikli
| device/samsung/i9100 | No |/14. * Replace nonfree software by free software
255
* free software sensors implementation(s)
256
* free software modem audio implementation(s)
257 1 Denis 'GNUtoo' Carikli
* Software rendering fix(es)
258 33 Denis 'GNUtoo' Carikli
* Privacy Fixes (TrustZone)
259 1 Denis 'GNUtoo' Carikli
* Don't depend on nonfree software
260
* Remove nonfree software
261
* Branding
262
* Small fix(es) |
263 29 Denis 'GNUtoo' Carikli
| device/samsung/n7000 | Yes |
264
| device/samsung/i9300 | No |
265
| device/samsung/i9305 | No |
266
| device/samsung/n7100 | Yes |
267 30 Denis 'GNUtoo' Carikli
| device/samsung/n5100 | Yes |
268
| device/samsung/n5110 | Yes |
269
| device/samsung/maguro | Yes |
270
| device/samsung/tuna | Yes |
271
| device/samsung/espressowifi | Yes |
272 22 Denis 'GNUtoo' Carikli
| device/samsung/espresso3g | Yes |
273
| device/samsung/galaxys2-common | Yes |
274 23 Denis 'GNUtoo' Carikli
| device/samsung/smdk4412-common | No |
275 40 Denis 'GNUtoo' Carikli
| device/samsung/kona-common | Yes |
276
| hardware/ril/samsung-ril | Not upstreamed | N/A |
277
| external/libsamsung-ipc | Not upstreamed | N/A |
278
| hardware/tinyalsa-audio | Not upstreamed? | N/A |
279 1 Denis 'GNUtoo' Carikli
280
h2. Links 
281
282
* https://source.android.com/setup/build/requirements