Project

General

Profile

DeprecatedPortingToAndroid10 » History » Version 110

Denis 'GNUtoo' Carikli, 04/04/2019 02:06 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 1 Denis 'GNUtoo' Carikli
24 100 Denis 'GNUtoo' Carikli
h3. Building AOSP version
25 1 Denis 'GNUtoo' Carikli
26 100 Denis 'GNUtoo' Carikli
h4. Source code
27 88 Denis 'GNUtoo' Carikli
28 46 Denis 'GNUtoo' Carikli
First get the source code:
29 1 Denis 'GNUtoo' Carikli
<pre>
30 46 Denis 'GNUtoo' Carikli
$ repo init -u git://git.putti.eu/aosp/manifest_i9305.git -b android-9.0.0
31 1 Denis 'GNUtoo' Carikli
</pre>
32 88 Denis 'GNUtoo' Carikli
33 100 Denis 'GNUtoo' Carikli
h4. For Trisquel8
34 45 Denis 'GNUtoo' Carikli
<pre>
35 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
36
</pre>
37
38 100 Denis 'GNUtoo' Carikli
h4. Building it
39 88 Denis 'GNUtoo' Carikli
40
Once this is done, see the device/putti/i9305/README.md for the build instructions.
41
42 100 Denis 'GNUtoo' Carikli
h4. Trisquel 8 LXC
43 88 Denis 'GNUtoo' Carikli
44
If you use Parabola, you may be interested in running Trisquel 8 in LXC.
45
46
To do that first debootstrap a Trisquel 8 rootfs. 
47
48
Parabola's debootstrap does support Trisquel 8 and its manual has an example on how to do that:
49
<pre>
50
$ man debootstrap
51
[...]
52
# debootstrap flidas flidas-root http://archive.trisquel.info/trisquel
53
</pre>
54
55
Then you can use virt-manager to setup the LXC instance.
56
57 89 Denis 'GNUtoo' Carikli
The advantages of this solution are that:
58 88 Denis 'GNUtoo' Carikli
* The LXC guest and host shares their resources (CPU, RAM) with almost no penalty
59
* Trisquel 8 is not a rolling release distribution
60
61
The disadvantage of this solution are that:
62
* you need to configure again the Trisquel 8 LXC instance (vimrc, sshd_config, etc)
63 1 Denis 'GNUtoo' Carikli
* It's more complicated to setup
64 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
65 48 Denis 'GNUtoo' Carikli
66 102 Denis 'GNUtoo' Carikli
h2. LineageOS 16
67
68
h3. Building LineageOS 16 version
69
70 105 Denis 'GNUtoo' Carikli
h4. Status with LineageOS 16
71
72
The work hasn't started yet, to save time the documentation is done at the same moment as the work.
73
74
h4. Repositories and changes
75
76 106 Denis 'GNUtoo' Carikli
LineageOS 16 with the following:
77
* git://git.putti.eu/aosp/kernel_i9305.git
78
* git://git.putti.eu/aosp/device_i9305.git
79 105 Denis 'GNUtoo' Carikli
80 102 Denis 'GNUtoo' Carikli
h4. Source code
81
82
TODO
83
84
h4. For Trisquel8
85
<pre>
86 107 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
87 102 Denis 'GNUtoo' Carikli
</pre>
88
89 104 Denis 'GNUtoo' Carikli
h4. Launching the build
90
91 1 Denis 'GNUtoo' Carikli
<pre>
92 104 Denis 'GNUtoo' Carikli
$ source build/envsetup.sh
93 106 Denis 'GNUtoo' Carikli
$ breakfast aosp_i9305-userdebug
94 108 Denis 'GNUtoo' Carikli
$ cd device/putti/i9305-kernel
95
$ ARCH=arm make midas_defconfig && ARCH=arm CROSS_COMPILE=arm-linux-gnueabi- make zImage dtbs && cat arch/arm/boot/zImage arch/arm/boot/dts/exynos4412-i9305.dtb > Image.gz-dtb
96
97 104 Denis 'GNUtoo' Carikli
</pre>
98
99 45 Denis 'GNUtoo' Carikli
h2. TODO
100 38 Denis 'GNUtoo' Carikli
101 87 Denis 'GNUtoo' Carikli
First month of full time equivalent work:
102
103 51 Denis 'GNUtoo' Carikli
|_. Task |_. Time estimation |_. Comments |
104 74 Denis 'GNUtoo' Carikli
| -boot a device under AOSP9- | DONE | Only boots with graphics, not much more |
105 81 Denis 'GNUtoo' Carikli
| -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- 
106
Builds under Trisquel8|
107 57 Denis 'GNUtoo' Carikli
| * port the changes from AOSP9 to LineageOS 16
108
* cleanup the code
109 59 Denis 'GNUtoo' Carikli
* build the kernel from the Android build system
110
* make sure it builds with an FSDG compliant distribution
111 73 Denis 'GNUtoo' Carikli
* document the build procedure | 21h | |
112
| find, remove and document proprietary software in LineageOS 16 | 14h | |
113 1 Denis 'GNUtoo' Carikli
| find, remove and document privacy issues in LineageOS 16 | 21h | |
114 94 Denis 'GNUtoo' Carikli
| port the touch keys Linux driver | 7h | |
115
| port the AAT1290 flash led Linux driver | 7h | |
116 95 Denis 'GNUtoo' Carikli
| rebrand LineageOS as Replicant | 7h | |
117
| 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 | |
118 1 Denis 'GNUtoo' Carikli
|_. Total |_. 147h | ~1 month |
119 93 Denis 'GNUtoo' Carikli
120 1 Denis 'GNUtoo' Carikli
Second month of full time equivalent work:
121 95 Denis 'GNUtoo' Carikli
| * port  libsamsung-ril and libsamsung-ipc to Android 9
122
* 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 |
123 75 Denis 'GNUtoo' Carikli
|_. Total |_. 157h | ~1 month |
124
125 87 Denis 'GNUtoo' Carikli
Third month of full time equivalent work:
126 1 Denis 'GNUtoo' Carikli
|_. Task |_. Time estimation |_. Comments |
127 75 Denis 'GNUtoo' Carikli
| port the sensors libraries and other device specific libraries | 70h | |
128 57 Denis 'GNUtoo' Carikli
| add support for Audio | 70h | Might be way faster, depending on what Android 9 uses |
129 77 Denis 'GNUtoo' Carikli
| add support for the Galaxy SIII (i9300) and factorize the code with i9305 | 14h | |
130 76 Denis 'GNUtoo' Carikli
|_. Total |_. 154h | ~1 month |
131
132
|_. Task |_. Time estimation |_. Comments |
133 67 Denis 'GNUtoo' Carikli
| create a recovery | 21h | |
134 71 Denis 'GNUtoo' Carikli
| add internal WiFi support and validate the functionality | 6h | |
135 96 Denis 'GNUtoo' Carikli
| add external WiFi dongles support | 20h | External dongles support might be tricky |
136 74 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.
137 71 Denis 'GNUtoo' Carikli
We also created generic instructions but they tend to be harder to follow[1] than the device specific ones.
138
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. |
139 1 Denis 'GNUtoo' Carikli
140 92 Denis 'GNUtoo' Carikli
|_. Task |_. Time estimation |_. Comments |
141
| Estimate the amount of work to Reduce the attack surface | ? | |
142
| Estimate the amount of work to add in-system upgrades | ? | |
143 71 Denis 'GNUtoo' Carikli
144
fn1. The generic instructions were tested at Install parties in Paris 
145 1 Denis 'GNUtoo' Carikli
146
h3. Devices support:
147
148 82 Denis 'GNUtoo' Carikli
h4. Easy, because it's similar enough to the Galaxy SIII (I9300)
149 1 Denis 'GNUtoo' Carikli
150 85 Denis 'GNUtoo' Carikli
|_\3. Galaxy Note II (N7100) |
151 77 Denis 'GNUtoo' Carikli
|_. Task |_. Time estimation |_. Comments |
152 97 Denis 'GNUtoo' Carikli
| port the EA8061 LCD Linux driver | 35h | |
153
| port the S6EVR02 LCD Linux driver | 35h | |
154 94 Denis 'GNUtoo' Carikli
| port the MAX77693 flash led Linux driver | 7h | |
155 86 Denis 'GNUtoo' Carikli
| 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 |
156
| port the sensors libraries and other device specific libraries | 70h | It's difficult to evaluate how much time it could take |
157
| add support for Audio | 14h | Should be similar to the Galaxy SIII |
158
159
|_\3. Galaxy Note 8.0 (N5100) and 8.0 WiFi (N5110) |
160
|_. Task |_. Time estimation |_. Comments |
161
| Evaluate the time required to do the port | 14h | TODO |
162 1 Denis 'GNUtoo' Carikli
163 70 Denis 'GNUtoo' Carikli
h4. Needs more work and unknown upstream Linux status
164
165 69 Denis 'GNUtoo' Carikli
|_. Device |_. Time estimation |_. Comments |
166 94 Denis 'GNUtoo' Carikli
| Galaxy S II (i9100) | | Linux: devboard dts upstream? unknown status |
167
| Galaxy Note (N7000) | | unknown Linux upstream status |
168 54 Denis 'GNUtoo' Carikli
| Galaxy Nexus (I9250) | |/2. OMAP4, no dts upsrteam |
169
| Galaxy Tab 2 7.0 (P3100), 7.0 WiFi (P3110), 10.1 (P5100), 10.1 WiFi (P5110) | |
170
| GTA04 >= A4 | | TODO: a RIL needs to be written, userspace GPS support is missing, audio scenarios, etc |
171 34 Denis 'GNUtoo' Carikli
172
h2. Replicant 6.0 changes
173 2 Denis 'GNUtoo' Carikli
174 4 Denis 'GNUtoo' Carikli
|_. Repository path |_. rebase worked |_. Changes |
175 22 Denis 'GNUtoo' Carikli
| build | No | |
176 1 Denis 'GNUtoo' Carikli
| manifest | No | N/A |
177 32 Denis 'GNUtoo' Carikli
| bootable/recovery | Yes | * UI changes to improve usability 
178 5 Denis 'GNUtoo' Carikli
* Branding
179 31 Denis 'GNUtoo' Carikli
* Small fix(es) | 
180 4 Denis 'GNUtoo' Carikli
| external/boringssl | Yes | * Small fix(es) |
181
| external/heimdall | No | |
182
| frameworks/av | Yes | * Software rendering fix(es) |
183
| frameworks/base | Yes | * WiFi fixe(s) for external dongles
184
* Software rendering fix(es) 
185
* Privacy fix(es) 
186 1 Denis 'GNUtoo' Carikli
* Security improvements 
187 5 Denis 'GNUtoo' Carikli
* Usability improvements |
188
| frameworks/native | No |
189
| hardware/broadcom/wlan | Yes | * Remove nonfree software |
190 10 Denis 'GNUtoo' Carikli
| hardware/libhardware | Yes | * Software rendering fix(es) |
191 5 Denis 'GNUtoo' Carikli
| hardware/libhardware_legacy | Yes | * Don't depend on nonfree software |
192
| hardware/ti/omap4 | Yes | * Remove nonfree software 
193 33 Denis 'GNUtoo' Carikli
* Don't depend on nonfree software 
194
* Small fix(es) |
195 6 Denis 'GNUtoo' Carikli
| libcore | Yes | * Small fix(es) | 
196 8 Denis 'GNUtoo' Carikli
| packages/apps/Browser | Yes | * Privacy fix(es) 
197 33 Denis 'GNUtoo' Carikli
* Branding
198 7 Denis 'GNUtoo' Carikli
* Small fix(es) |
199 33 Denis 'GNUtoo' Carikli
| packages/apps/LegacyCamera | Yes | * Software rendering fix(es)
200 22 Denis 'GNUtoo' Carikli
* Small fix(es) |
201
| packages/apps/RepWifi | Not upstreamed, obsolete | N/A |
202 11 Denis 'GNUtoo' Carikli
| packages/apps/ReplicantWallpapers | Not upstreamed | * Branding |
203
| packages/apps/Settings | No | |
204
| packages/apps/SetupWizard | Yes | * Privacy fix(es) 
205
* Don't depend on nonfree software
206 12 Denis 'GNUtoo' Carikli
* Branding |
207
| packages/apps/ThemeChooser | Yes | * Privacy fix(es) ?
208 33 Denis 'GNUtoo' Carikli
* Don't depend on nonfree software ? |
209 13 Denis 'GNUtoo' Carikli
| packages/providers/ContactsProvider | Yes | * Small fix(es) |
210
| system/core | Yes | * Branding
211
* various fixes |
212
| vendor/replicant | No | |
213 14 Denis 'GNUtoo' Carikli
| vendor/cmsdk | Yes | * Branding |
214
| external/chromium-webview | ? | ? |
215
| external/drm_gralloc | Yes | * Software rendering fix(es) |
216
| external/llvm | Yes | * Software rendering fix(es) |
217
| external/mesa3d |  Yes | * Software rendering fix(es)
218 33 Denis 'GNUtoo' Carikli
* Performance debugging for software rendering |
219 14 Denis 'GNUtoo' Carikli
| external/parameter-framework | Yes | * Small fix(es) |
220
| external/protobuf | N/A | No changes |
221
| prebuilts/ndk | ? | ? |
222 33 Denis 'GNUtoo' Carikli
| prebuilts/sdk | ? | ? |
223
| sdk | Yes | * Small fix(es) |
224 14 Denis 'GNUtoo' Carikli
| toolchain/src/binutils | Yes | * Small fix(es) |
225 33 Denis 'GNUtoo' Carikli
| toolchain/src/gcc | No | |
226
| toolchain/src/jack | Yes | * Small fix(es) |
227 22 Denis 'GNUtoo' Carikli
| toolchain/src/jill | Yes | * Small fix(es) |
228 1 Denis 'GNUtoo' Carikli
| kernel/samsung/smdk4412 |/3. Yes |/3. * Security fixes
229
* Privacy Fixes (TrustZone)
230 20 Denis 'GNUtoo' Carikli
* Don't depend on nonfree software
231 33 Denis 'GNUtoo' Carikli
* Remove nonfree software
232 22 Denis 'GNUtoo' Carikli
* Small fix(es) |
233
| kernel/samsung/tuna |
234 28 Denis 'GNUtoo' Carikli
| kernel/samsung/espresso10 |
235
| device/samsung/i9100 | No |/14. * Replace nonfree software by free software
236
* free software sensors implementation(s)
237 25 Denis 'GNUtoo' Carikli
* free software modem audio implementation(s)
238 29 Denis 'GNUtoo' Carikli
* Software rendering fix(es)
239
* Privacy Fixes (TrustZone)
240
* Don't depend on nonfree software
241 1 Denis 'GNUtoo' Carikli
* Remove nonfree software
242 33 Denis 'GNUtoo' Carikli
* Branding
243 1 Denis 'GNUtoo' Carikli
* Small fix(es) |
244
| device/samsung/n7000 | Yes |
245
| device/samsung/i9300 | No |
246
| device/samsung/i9305 | No |
247 29 Denis 'GNUtoo' Carikli
| device/samsung/n7100 | Yes |
248
| device/samsung/n5100 | Yes |
249
| device/samsung/n5110 | Yes |
250
| device/samsung/maguro | Yes |
251 30 Denis 'GNUtoo' Carikli
| device/samsung/tuna | Yes |
252
| device/samsung/espressowifi | Yes |
253
| device/samsung/espresso3g | Yes |
254
| device/samsung/galaxys2-common | Yes |
255
| device/samsung/smdk4412-common | No |
256 22 Denis 'GNUtoo' Carikli
| device/samsung/kona-common | Yes |
257
| hardware/ril/samsung-ril | Not upstreamed | N/A |
258 23 Denis 'GNUtoo' Carikli
| external/libsamsung-ipc | Not upstreamed | N/A |
259 40 Denis 'GNUtoo' Carikli
| hardware/tinyalsa-audio | Not upstreamed? | N/A |
260
261
h2. Links 
262
263 1 Denis 'GNUtoo' Carikli
* https://source.android.com/setup/build/requirements