Project

General

Profile

DeprecatedPortingToAndroid10 » History » Version 164

dl lud, 07/13/2019 11:14 PM
Style: missing newline was turning all pre tag into bold highlighted text.

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 164 dl lud
h4. For Trisquel 8
35
36 45 Denis 'GNUtoo' Carikli
<pre>
37 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
38
</pre>
39
40 100 Denis 'GNUtoo' Carikli
h4. Building it
41 88 Denis 'GNUtoo' Carikli
42
Once this is done, see the device/putti/i9305/README.md for the build instructions.
43
44 100 Denis 'GNUtoo' Carikli
h4. Trisquel 8 LXC
45 88 Denis 'GNUtoo' Carikli
46
If you use Parabola, you may be interested in running Trisquel 8 in LXC.
47
48
To do that first debootstrap a Trisquel 8 rootfs. 
49
50
Parabola's debootstrap does support Trisquel 8 and its manual has an example on how to do that:
51
<pre>
52
$ man debootstrap
53
[...]
54
# debootstrap flidas flidas-root http://archive.trisquel.info/trisquel
55
</pre>
56
57
Then you can use virt-manager to setup the LXC instance.
58
59 89 Denis 'GNUtoo' Carikli
The advantages of this solution are that:
60 88 Denis 'GNUtoo' Carikli
* The LXC guest and host shares their resources (CPU, RAM) with almost no penalty
61
* Trisquel 8 is not a rolling release distribution
62
63
The disadvantage of this solution are that:
64
* you need to configure again the Trisquel 8 LXC instance (vimrc, sshd_config, etc)
65 1 Denis 'GNUtoo' Carikli
* It's more complicated to setup
66 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
67 48 Denis 'GNUtoo' Carikli
68 102 Denis 'GNUtoo' Carikli
h2. LineageOS 16
69
70 120 Denis 'GNUtoo' Carikli
h3. Repositories and changes for LineageOS 16
71 105 Denis 'GNUtoo' Carikli
72 152 Joonas Kylmälä
* https://git.replicant.us/GNUtoo/kernel_replicant_linux.git
73 1 Denis 'GNUtoo' Carikli
* git://git.putti.eu/aosp/external_mesa3d.git
74
* https://git.replicant.us/GNUtoo/android_build.git
75
* https://git.replicant.us/GNUtoo/device_i9305.git
76 116 Denis 'GNUtoo' Carikli
* https://git.replicant.us/GNUtoo/manifest.git
77
* https://git.replicant.us/GNUtoo/vendor_replicant.git
78 120 Denis 'GNUtoo' Carikli
79
h3. Building LineageOS 16 version
80 102 Denis 'GNUtoo' Carikli
81 1 Denis 'GNUtoo' Carikli
h4. Source code
82 102 Denis 'GNUtoo' Carikli
83 1 Denis 'GNUtoo' Carikli
<pre>
84
$ repo init -u https://git.replicant.us/GNUtoo/manifest.git -b GNUtoo/lineage-16.0-base
85 142 Denis 'GNUtoo' Carikli
$ repo sync
86 102 Denis 'GNUtoo' Carikli
</pre>
87
88 162 dl lud
h4. For Trisquel 8
89
90 1 Denis 'GNUtoo' Carikli
<pre>
91 163 dl lud
sudo apt-get install bc bison build-essential ccache curl flex g++-multilib gcc-multilib gettext 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 python-mako pngcrush rsync schedtool squashfs-tools xsltproc zip zlib1g-dev
92 162 dl lud
sudo apt-get install gcc-5-arm-linux-gnueabi
93 104 Denis 'GNUtoo' Carikli
</pre>
94 1 Denis 'GNUtoo' Carikli
95 104 Denis 'GNUtoo' Carikli
h4. Launching the build
96 1 Denis 'GNUtoo' Carikli
97 118 Denis 'GNUtoo' Carikli
Follow the "i9300 manifest instructions:":https://github.com/CustomRoms/android_local_manifests_i9300
98 104 Denis 'GNUtoo' Carikli
<pre>
99 118 Denis 'GNUtoo' Carikli
$ subject='/C=US/ST=California/L=Mountain View/O=Android/OU=Android/CN=Android/emailAddress=android@android.com'
100
$ mkdir .android-certs
101
$ for x in releasekey platform shared media testkey; do \
102
  ./development/tools/make_key .android-certs/$x "$subject"; \
103
  done
104
$ parallel_tasks=$(echo "$(grep 'processor' /proc/cpuinfo | wc -l ) + 1" | bc)
105 104 Denis 'GNUtoo' Carikli
$ source build/envsetup.sh
106 137 Denis 'GNUtoo' Carikli
$ lunch lineage_i9305-eng
107 118 Denis 'GNUtoo' Carikli
$ make -j${parallel_tasks} bacon
108 87 Denis 'GNUtoo' Carikli
</pre>
109 136 Denis 'GNUtoo' Carikli
110
The images can then be flashed with heimdall. They are then in:
111 1 Denis 'GNUtoo' Carikli
<pre>
112
  out/target/product/i9305/obj/PACKAGING/target_files_intermediates/lineage_i9305-target_files-eng.replicant/IMAGES/
113 142 Denis 'GNUtoo' Carikli
</pre>
114
115
h4. Getting lastest changes
116
117
* The repositories are being constantly modified with git push --force as we are trying things out, and don't want to make the commits history look too much dirty, so be sure to backup your local changes.
118
* Sometimes the manifest repository is also modified with git push --force. In that case the following commands will loose all the work you did locally but will make the repository consistent with upstream repositories again:
119
<pre>
120
$ rm -rf .repo/manifests/ # This enables me to force push and rebase the manifest repository as well
121
$ repo init -u https://git.replicant.us/GNUtoo/manifest.git -b GNUtoo/lineage-16.0-base
122
$ repo sync --force-sync
123
</pre>
124
* The following command might also be necessary to make the state consistent with upstream repositories again, when the manifest history wasn't rewritten, but it will also loose all the work you did locally: 
125
<pre>
126
$ repo sync --force-sync
127 136 Denis 'GNUtoo' Carikli
</pre>
128
129 138 Denis 'GNUtoo' Carikli
h4. Install the images
130
131
<pre>
132
$ sudo heimdall flash --BOOT out/target/product/i9305/obj/PACKAGING/target_files_intermediates/lineage_i9305-target_files-eng.replicant/IMAGES/boot.img --USERDATA out_target_product_i9305/obj/PACKAGING/target_files_intermediates/lineage_i9305-target_files-eng.replicant/IMAGES/userdata.img --SYSTEM out_target_product_i9305/obj/PACKAGING/target_files_intermediates/lineage_i9305-target_files-eng.replicant/IMAGES/system.img 
133
</pre>
134
135
h4. Get adb
136
137 147 Denis 'GNUtoo' Carikli
As the device IDs are the ones given by the Linux kernel, they are not in the adb udev rules, so for now it requires to run adb as root:
138 138 Denis 'GNUtoo' Carikli
<pre>
139
$ sudo adb shell
140
* daemon not running; starting now at tcp:5037
141
* daemon started successfully
142
i9305:/ #                                 
143
$ sudo adb kill-server
144
$ adb shell
145
* daemon not running; starting now at tcp:5037
146
* daemon started successfully
147
error: no devices/emulators found
148
</pre>
149
So make sure to kill the adb-server and run it as root:
150
<pre>
151
$ adb kill-server
152
$ sudo adb shell
153
* daemon not running; starting now at tcp:5037
154
* daemon started successfully
155
i9305:/ # 
156 1 Denis 'GNUtoo' Carikli
</pre>
157 147 Denis 'GNUtoo' Carikli
158
h4. Booting
159
160
At some point during boot, the device goes into suspend, so you will need to press some buttons like the power or volume button to make the boot continue until the graphical interface.
161
162
You can also follow the boot progress with adb:
163
<pre>
164
adb logcat
165
adb logcat -b main
166
</pre>
167
168 148 Denis 'GNUtoo' Carikli
Note that the device can go into suspend at any time, so adb might be interrupted. That looks like that:
169
First you get a shell
170
<pre>
171
$ sudo adb shell
172
i9305:/ #
173
</pre>
174
175
Then the connection is interrupted:
176
<pre>
177
$ adb shell
178
i9305:/ # [randomdev@fullyfreelaptop ]$                                                                                                     
179
</pre>
180
181
The effect with adb logcat is similar.
182 138 Denis 'GNUtoo' Carikli
183 150 Denis 'GNUtoo' Carikli
h3. cleanups to be done
184 140 Denis 'GNUtoo' Carikli
185
* Make adb work as user by using the right USB IDs, and make userspace do the USB setup.
186 149 Denis 'GNUtoo' Carikli
* -Make the kernel not use hardcoded CMDLINE_FORCE- Not possible unless the bootloader is changed or Linux is very heavily patched.
187 140 Denis 'GNUtoo' Carikli
* Make the kernel not use hardcoded partitions if possible (though we use system as root)
188 1 Denis 'GNUtoo' Carikli
* Make a clean Gatekeeper HAL module implementation instead of using the same hack than goldfish
189 149 Denis 'GNUtoo' Carikli
* look at "init.rc":https://android.googlesource.com/platform/system/core/+/master/init/README.md documentation to see if init.rc can be overriden clearly with the override statement to see if it's possible to keep the serial console patch for -eng
190 140 Denis 'GNUtoo' Carikli
191 153 Denis 'GNUtoo' Carikli
h2. Upstreaming status
192
193
* "Unbreak 5.2 booting":https://www.openwall.com/lists/kernel-hardening/2019/06/14/4
194 156 Denis 'GNUtoo' Carikli
* -"add flash support to galaxy-s3 boards":https://lists.infradead.org/pipermail/linux-arm-kernel/2019-June/660361.html- "applied":https://lists.infradead.org/pipermail/linux-arm-kernel/2019-June/661471.html
195 153 Denis 'GNUtoo' Carikli
196 87 Denis 'GNUtoo' Carikli
h2. TODO
197 51 Denis 'GNUtoo' Carikli
198 74 Denis 'GNUtoo' Carikli
First month of full time equivalent work:
199 81 Denis 'GNUtoo' Carikli
200 127 Denis 'GNUtoo' Carikli
|_. Time estimation  |_.Task |_. Comments |
201
| DONE | -boot a device under AOSP9- | Only boots with graphics, not much more |
202
| -7h- DONE | -build it under a "FSDG compliant distribution":https://www.gnu.org/distros/free-distros.html like Trisquel8- | -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- 
203 59 Denis 'GNUtoo' Carikli
Builds under Trisquel8|
204 144 Joonas Kylmälä
| 21h | * -port the changes from AOSP9 to LineageOS 16-
205 155 Denis 'GNUtoo' Carikli
* -cleanup the code-
206 151 Joonas Kylmälä
* -build the kernel from the Android build system-
207 125 Denis 'GNUtoo' Carikli
* -make sure it builds with an FSDG compliant distribution-
208 143 Denis 'GNUtoo' Carikli
* -document the build procedure- |
209
Status:
210 155 Denis 'GNUtoo' Carikli
* Boots with adb.
211 143 Denis 'GNUtoo' Carikli
* Has ultra slow graphics |
212 127 Denis 'GNUtoo' Carikli
| 14h | find, remove and document proprietary software in LineageOS 16 | |
213
| 21h | find, remove and document privacy issues in LineageOS 16 | |
214 139 Denis 'GNUtoo' Carikli
| 7h | port the touch keys Linux -driver- dts for the  galaxy-s3 boards | Also requires a n710x for testing the patch |
215 157 Denis 'GNUtoo' Carikli
| 7h | -upstream the AAT1290 flash led Linux dts for the galaxy-s3 boards- | "applied upstream":https://lists.infradead.org/pipermail/linux-arm-kernel/2019-June/661471.html |
216 127 Denis 'GNUtoo' Carikli
| 7h | rebrand LineageOS as Replicant | |
217
| 70h | port and cleanup the the Galaxy SIII (i9300) "modem":https://github.com/fourkbomb/linux/tree/modem Linux driver from 4.16 to 5.0| |
218
|_\3. Total: 147h (~1 month) |
219 95 Denis 'GNUtoo' Carikli
220 75 Denis 'GNUtoo' Carikli
Second month of full time equivalent work:
221 1 Denis 'GNUtoo' Carikli
| * port  libsamsung-ril and libsamsung-ipc to Android 9
222
* 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-
223 160 Denis 'GNUtoo' Carikli
-libsamsung-ipc and samsung-ril were fixed to compile on Android 9.-
224 158 Denis 'GNUtoo' Carikli
-The code was not yet tested at runtime.-
225 1 Denis 'GNUtoo' Carikli
-It also probably still need to be adapted to trebble or the new RIL interfaces to be more substainable.-
226 160 Denis 'GNUtoo' Carikli
Status:
227
* The code has been updated to work without a wrapper on Android 9, but some cleanups are needed in all the modem related components.
228
* The modem doesn't work yet on Replicant 9 but some of the initialization already works.
229 158 Denis 'GNUtoo' Carikli
On Replicant 6 we have:
230
<pre>
231
 D use-Rlog/RLOG-RIL-IPC: Starting i9300 modem boot
232
 D use-Rlog/RLOG-RIL-IPC: Opened modem image device
233
 D use-Rlog/RLOG-RIL-IPC: Mapped modem image data to memory
234
 D use-Rlog/RLOG-RIL-IPC: Opened modem boot device
235
 D use-Rlog/RLOG-RIL-IPC: Opened modem link device
236
 D use-Rlog/RLOG-RIL-IPC: Turned the modem off
237
 D use-Rlog/RLOG-RIL-IPC: Turned the modem on
238
 D use-Rlog/RLOG-RIL-IPC: Waited for link connected
239
 D use-Rlog/RLOG-RIL-IPC: Wrote ATAT in ASCII
240
 D use-Rlog/RLOG-RIL-IPC: Read chip id (0x16)
241
 D use-Rlog/RLOG-RIL-IPC: Wrote PSI header
242
 D use-Rlog/RLOG-RIL-IPC: Wrote PSI, CRC is 0xc8
243
 D use-Rlog/RLOG-RIL-IPC: Wrote PSI CRC (0xc8)
244
 D use-Rlog/RLOG-RIL-IPC: Read PSI CRC ACK
245
 D use-Rlog/RLOG-RIL-IPC: Read PSI ACK
246
 D use-Rlog/RLOG-RIL-IPC: Sent XMM626 HSIC PSI
247
 D use-Rlog/RLOG-RIL-IPC: Wrote EBL size
248
 D use-Rlog/RLOG-RIL-IPC: Wrote EBL, CRC is 0xb5
249
 D use-Rlog/RLOG-RIL-IPC: Wrote EBL CRC (0xb5)
250
 [...]
251
</pre>
252
On Replicant 9 we have:
253
<pre>
254
 D use-Rlog/RLOG-RIL-IPC: Starting generic modem boot
255
 D use-Rlog/RLOG-RIL-IPC: Opened modem image device
256
 D use-Rlog/RLOG-RIL-IPC: Mapped modem image data to memory
257
 D use-Rlog/RLOG-RIL-IPC: Turned the modem off
258
 D use-Rlog/RLOG-RIL-IPC: Turned the modem on
259
 D use-Rlog/RLOG-RIL-IPC: Opened modem boot device
260
 D use-Rlog/RLOG-RIL-IPC: Wrote ATAT in ASCII
261
 D use-Rlog/RLOG-RIL-IPC: Read chip id (0x16)
262
 D use-Rlog/RLOG-RIL-IPC: Wrote PSI header
263
 D use-Rlog/RLOG-RIL-IPC: Wrote PSI, CRC is 0x7d
264
 D use-Rlog/RLOG-RIL-IPC: Wrote PSI CRC (0x7d)
265
 D use-Rlog/RLOG-RIL-IPC: Read PSI CRC ACK
266
 D use-Rlog/RLOG-RIL-IPC: Reading PSI ACK failed
267
 D use-Rlog/RLOG-RIL-IPC: Sending XMM626 HSIC PSI failed
268
 E use-Rlog/RLOG-RIL-IPC: Booting IPC FMT client failed
269
 E use-Rlog/RLOG-RIL: Opening IPC FMT client failed
270
</pre>  |
271 1 Denis 'GNUtoo' Carikli
|_. Total |_. 157h | ~1 month |
272
273
Third month of full time equivalent work:
274 75 Denis 'GNUtoo' Carikli
|_. Task |_. Time estimation |_. Comments |
275 125 Denis 'GNUtoo' Carikli
| -port the sensors libraries and other device specific libraries- | -70h- | Already done by the unofficial LineageOS port of the Galaxy SIII (i9300), needs testing |
276
| add support for Audio with the upstream kernel driver | 70h | Might be way faster, depending on what Android 9 uses |
277
| add partial (no modem) support for the -Galaxy SIII (i9300)- Galaxy SIII 4G (i9305) and factorize the code with i9305 | 14h | The work for the Galaxy SIII (i9300) has already been done by the unofficial LineageOS port.
278
It needs to be adapted to the upstream kernel and not to use proprietary libraries.
279
It also needs to be adapted to the Galaxy SIII 4G (i9305) |
280 1 Denis 'GNUtoo' Carikli
|_. Total |_. 154h | ~1 month |
281 67 Denis 'GNUtoo' Carikli
282 71 Denis 'GNUtoo' Carikli
|_. Task |_. Time estimation |_. Comments |
283 96 Denis 'GNUtoo' Carikli
| create a recovery | 21h | |
284 74 Denis 'GNUtoo' Carikli
| add internal WiFi support and validate the functionality | 6h | |
285 71 Denis 'GNUtoo' Carikli
| add external WiFi dongles support | 20h | External dongles support might be tricky |
286 125 Denis 'GNUtoo' Carikli
| -create new- update the install and upgrade instructions | -35h- | -Our current install instructions don't scale as we have one copy for each device.-
287
-We also created generic instructions but they tend to be harder to follow[1] than the device specific ones.-
288
-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.-
289
-The instructions will need to be able to be modified and compiled on an FSDG compliant distribution.- |
290 92 Denis 'GNUtoo' Carikli
291 71 Denis 'GNUtoo' Carikli
|_. Task |_. Time estimation |_. Comments |
292
| Estimate the amount of work to Reduce the attack surface | ? | |
293 1 Denis 'GNUtoo' Carikli
| Estimate the amount of work to add in-system upgrades | ? | |
294
295 82 Denis 'GNUtoo' Carikli
fn1. The generic instructions were tested at Install parties in Paris 
296 1 Denis 'GNUtoo' Carikli
297 85 Denis 'GNUtoo' Carikli
h3. Devices support:
298 1 Denis 'GNUtoo' Carikli
299 77 Denis 'GNUtoo' Carikli
h4. Easy, because it's similar enough to the Galaxy SIII (I9300)
300 97 Denis 'GNUtoo' Carikli
301
|_\3. Galaxy Note II (N7100) |
302 94 Denis 'GNUtoo' Carikli
|_. Task |_. Time estimation |_. Comments |
303 86 Denis 'GNUtoo' Carikli
| port the EA8061 LCD Linux driver | 35h | |
304
| port the S6EVR02 LCD Linux driver | 35h | |
305
| port the MAX77693 flash led Linux driver | 7h | |
306
| 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 |
307
| port the sensors libraries and other device specific libraries | 70h | It's difficult to evaluate how much time it could take |
308 125 Denis 'GNUtoo' Carikli
| add support for Audio with the upstream kernel driver | 14h | Should be similar to the Galaxy SIII |
309 86 Denis 'GNUtoo' Carikli
310 1 Denis 'GNUtoo' Carikli
|_\3. Galaxy Note 8.0 (N5100) and 8.0 WiFi (N5110) |
311 70 Denis 'GNUtoo' Carikli
|_. Task |_. Time estimation |_. Comments |
312
| Evaluate the time required to do the port | 14h | TODO |
313 69 Denis 'GNUtoo' Carikli
314 94 Denis 'GNUtoo' Carikli
h4. Needs more work and unknown upstream Linux status
315
316 54 Denis 'GNUtoo' Carikli
|_. Device |_. Time estimation |_. Comments |
317
| Galaxy S II (i9100) | | Linux: devboard dts upstream? unknown status |
318
| Galaxy Note (N7000) | | unknown Linux upstream status |
319 34 Denis 'GNUtoo' Carikli
| Galaxy Nexus (I9250) | |/2. OMAP4, no dts upsrteam |
320
| Galaxy Tab 2 7.0 (P3100), 7.0 WiFi (P3110), 10.1 (P5100), 10.1 WiFi (P5110) | |
321 2 Denis 'GNUtoo' Carikli
| GTA04 >= A4 | | TODO: a RIL needs to be written, userspace GPS support is missing, audio scenarios, etc |
322 4 Denis 'GNUtoo' Carikli
323 128 Denis 'GNUtoo' Carikli
h2. Documentation
324 1 Denis 'GNUtoo' Carikli
325 128 Denis 'GNUtoo' Carikli
h3. Replicant 6.0 changes
326
327 32 Denis 'GNUtoo' Carikli
|_. Repository path |_. rebase worked |_. Changes |
328 5 Denis 'GNUtoo' Carikli
| build | No | |
329 31 Denis 'GNUtoo' Carikli
| manifest | No | N/A |
330 4 Denis 'GNUtoo' Carikli
| bootable/recovery | Yes | * UI changes to improve usability 
331
* Branding
332
* Small fix(es) | 
333
| external/boringssl | Yes | * Small fix(es) |
334
| external/heimdall | No | |
335
| frameworks/av | Yes | * Software rendering fix(es) |
336 1 Denis 'GNUtoo' Carikli
| frameworks/base | Yes | * WiFi fixe(s) for external dongles
337 5 Denis 'GNUtoo' Carikli
* Software rendering fix(es) 
338
* Privacy fix(es) 
339
* Security improvements 
340 10 Denis 'GNUtoo' Carikli
* Usability improvements |
341 5 Denis 'GNUtoo' Carikli
| frameworks/native | No |
342
| hardware/broadcom/wlan | Yes | * Remove nonfree software |
343 33 Denis 'GNUtoo' Carikli
| hardware/libhardware | Yes | * Software rendering fix(es) |
344
| hardware/libhardware_legacy | Yes | * Don't depend on nonfree software |
345 6 Denis 'GNUtoo' Carikli
| hardware/ti/omap4 | Yes | * Remove nonfree software 
346 8 Denis 'GNUtoo' Carikli
* Don't depend on nonfree software 
347 33 Denis 'GNUtoo' Carikli
* Small fix(es) |
348 7 Denis 'GNUtoo' Carikli
| libcore | Yes | * Small fix(es) | 
349 33 Denis 'GNUtoo' Carikli
| packages/apps/Browser | Yes | * Privacy fix(es) 
350 22 Denis 'GNUtoo' Carikli
* Branding
351
* Small fix(es) |
352 11 Denis 'GNUtoo' Carikli
| packages/apps/LegacyCamera | Yes | * Software rendering fix(es)
353
* Small fix(es) |
354
| packages/apps/RepWifi | Not upstreamed, obsolete | N/A |
355
| packages/apps/ReplicantWallpapers | Not upstreamed | * Branding |
356 12 Denis 'GNUtoo' Carikli
| packages/apps/Settings | No | |
357
| packages/apps/SetupWizard | Yes | * Privacy fix(es) 
358 33 Denis 'GNUtoo' Carikli
* Don't depend on nonfree software
359 13 Denis 'GNUtoo' Carikli
* Branding |
360
| packages/apps/ThemeChooser | Yes | * Privacy fix(es) ?
361
* Don't depend on nonfree software ? |
362
| packages/providers/ContactsProvider | Yes | * Small fix(es) |
363 14 Denis 'GNUtoo' Carikli
| system/core | Yes | * Branding
364
* various fixes |
365
| vendor/replicant | No | |
366
| vendor/cmsdk | Yes | * Branding |
367
| external/chromium-webview | ? | ? |
368 33 Denis 'GNUtoo' Carikli
| external/drm_gralloc | Yes | * Software rendering fix(es) |
369 14 Denis 'GNUtoo' Carikli
| external/llvm | Yes | * Software rendering fix(es) |
370
| external/mesa3d |  Yes | * Software rendering fix(es)
371
* Performance debugging for software rendering |
372 33 Denis 'GNUtoo' Carikli
| external/parameter-framework | Yes | * Small fix(es) |
373
| external/protobuf | N/A | No changes |
374 14 Denis 'GNUtoo' Carikli
| prebuilts/ndk | ? | ? |
375 33 Denis 'GNUtoo' Carikli
| prebuilts/sdk | ? | ? |
376
| sdk | Yes | * Small fix(es) |
377 22 Denis 'GNUtoo' Carikli
| toolchain/src/binutils | Yes | * Small fix(es) |
378 1 Denis 'GNUtoo' Carikli
| toolchain/src/gcc | No | |
379
| toolchain/src/jack | Yes | * Small fix(es) |
380 20 Denis 'GNUtoo' Carikli
| toolchain/src/jill | Yes | * Small fix(es) |
381 33 Denis 'GNUtoo' Carikli
| kernel/samsung/smdk4412 |/3. Yes |/3. * Security fixes
382 22 Denis 'GNUtoo' Carikli
* Privacy Fixes (TrustZone)
383
* Don't depend on nonfree software
384 28 Denis 'GNUtoo' Carikli
* Remove nonfree software
385
* Small fix(es) |
386
| kernel/samsung/tuna |
387 25 Denis 'GNUtoo' Carikli
| kernel/samsung/espresso10 |
388 29 Denis 'GNUtoo' Carikli
| device/samsung/i9100 | No |/14. * Replace nonfree software by free software
389
* free software sensors implementation(s)
390
* free software modem audio implementation(s)
391 1 Denis 'GNUtoo' Carikli
* Software rendering fix(es)
392 33 Denis 'GNUtoo' Carikli
* Privacy Fixes (TrustZone)
393 1 Denis 'GNUtoo' Carikli
* Don't depend on nonfree software
394
* Remove nonfree software
395
* Branding
396
* Small fix(es) |
397 29 Denis 'GNUtoo' Carikli
| device/samsung/n7000 | Yes |
398
| device/samsung/i9300 | No |
399
| device/samsung/i9305 | No |
400
| device/samsung/n7100 | Yes |
401 30 Denis 'GNUtoo' Carikli
| device/samsung/n5100 | Yes |
402
| device/samsung/n5110 | Yes |
403
| device/samsung/maguro | Yes |
404
| device/samsung/tuna | Yes |
405
| device/samsung/espressowifi | Yes |
406 22 Denis 'GNUtoo' Carikli
| device/samsung/espresso3g | Yes |
407
| device/samsung/galaxys2-common | Yes |
408 23 Denis 'GNUtoo' Carikli
| device/samsung/smdk4412-common | No |
409 40 Denis 'GNUtoo' Carikli
| device/samsung/kona-common | Yes |
410
| hardware/ril/samsung-ril | Not upstreamed | N/A |
411
| external/libsamsung-ipc | Not upstreamed | N/A |
412 1 Denis 'GNUtoo' Carikli
| hardware/tinyalsa-audio | Not upstreamed? | N/A |
413 128 Denis 'GNUtoo' Carikli
414
h3. CustomROMs i9300 components
415
416 131 Denis 'GNUtoo' Carikli
|_. Repository |_. Tree path |_. Dependencies |_. Function |_. Comments |
417
|/8. https://github.com/CustomROMs/android_hardware_samsung
418
lineage-16.0 branch | hardware/samsung/macloader | | Loads the MAC Address of the WiFi network interface | Might be useful |
419
| hardware/samsung/wifiloader | | Loads the wifi kernel module (like modprobe) and setup firmware filesystems permissions | May be useful |
420
| hardware/samsung/audio | | seems to contains ril related stuff as well | Look if the ril stuff is required, go for standard audio |
421
| hardware/samsung/lineagehw/hidl/livedisplay | | livedisplay is a feature similar to what redshift does on GNU/Linux | Not sure if it works with mainline |
422
| hardware/samsung/exynos/multimedia/utils/ | seem meant for audio/video decoding offload | assembly obtimized color conversion and resize code | check assembly code license, not sure if useful |
423
| all other directories in hardware/samsung/exynos/ | nonfree firmwares, nonfree software?, smdk kernel? | audio/video decoding offload | Avoid using that |
424
| hardware/samsung/exynos3 |/2. nonfree firmwares?, nonfree software?, smdk kernel? |/2. some light libraries, display stuff (gralloc, etc), 2D acceleration (FIMG), camera (FIMC), 3D acceleration, etc |/2. Avoid using that for now |
425
| hardware/samsung/exynos4 | 
426 1 Denis 'GNUtoo' Carikli
427
h2. Links 
428
429
* https://source.android.com/setup/build/requirements
430 132 Denis 'GNUtoo' Carikli
* https://forum.xda-developers.com/galaxy-s3/development/rom-lineageos-16-0-t3875899 : status of the unofficial LineageOS port