Project

General

Profile

PortingToAndroid10 » History » Version 261

Denis 'GNUtoo' Carikli, 06/12/2020 07:14 PM
update patch status by pointing to new created project bugtracker (easier to track in one place + has status)

1 1 Denis 'GNUtoo' Carikli
h1. Porting Replicant to Android 9
2
3 101 Denis 'GNUtoo' Carikli
{{>toc}}
4 1 Denis 'GNUtoo' Carikli
5 256 Denis 'GNUtoo' Carikli
h2. LineageOS 17 (Android 10)
6
7 258 Denis 'GNUtoo' Carikli
The development is moving toward Android 10. 
8
9
The basic features working on Replicant 9 have also been confirmed to work on Replicant 10, but not everything has been tested yet on either version.
10
11
At this point, the Replicant 9 source code is kept to do regression tracking, and the development has moved to Replicant 10.
12
13 256 Denis 'GNUtoo' Carikli
h3. Building LineageOS 17 version
14
15
h4. Source code
16
17
<pre>
18
$ repo init -u https://git.replicant.us/replicant-9/manifest.git -b replicant-10-wip
19
$ repo sync
20
</pre>
21
22
Alternatively a shallow copy of the source tree can be fetched in order to save on disk space:
23
24
<pre>
25 259 Denis 'GNUtoo' Carikli
$ repo init -u https://git.replicant.us/replicant-9/manifest.git -b replicant-10-wip --depth=1
26 256 Denis 'GNUtoo' Carikli
$ repo sync -c
27
</pre>
28
29
To `unshallow` a specific module:
30
31
<pre>
32
$ cd path/to/module
33
$ git fetch --unshallow <remote>
34
</pre>
35
36
h4. For Trisquel 8
37
38
<pre>
39
sudo apt-get install bc bison build-essential bsdmainutils 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
40
sudo apt-get install gcc-5-arm-linux-gnueabi
41
</pre>
42
43
h4. Launching the build
44
45 260 Denis 'GNUtoo' Carikli
Not 100% sure if this is still needed:
46 256 Denis 'GNUtoo' Carikli
<pre>
47
$ subject='/C=US/ST=California/L=Mountain View/O=Android/OU=Android/CN=Android/emailAddress=android@android.com'
48
$ mkdir .android-certs
49
$ for x in releasekey platform shared media testkey; do \
50
  ./development/tools/make_key .android-certs/$x "$subject"; \
51
  done
52 260 Denis 'GNUtoo' Carikli
</pre>
53
54
To avoid the following error:
55
<pre>
56
16:20:13 See https://android.googlesource.com/platform/build/+/master/Changes.md#PATH_Tools for more information.
57
[  3% 2585/70375] build out/target/product/i9305/gen/STATIC_LIBRARIES/libmesa_nir_intermediates/nir/nir_builder_opcodes.h
58
FAILED: out/target/product/i9305/gen/STATIC_LIBRARIES/libmesa_nir_intermediates/nir/nir_builder_opcodes.h
59
/bin/bash -c "python external/mesa3d/src/compiler/nir/nir_builder_opcodes_h.py external/mesa3d/src/compiler/nir/nir_opcodes.py > out/target/product/i9305/gen/STATIC_LIBRARIES/libmesa_nir_intermediates/nir/nir_builder_opcodes.h"
60
Traceback (most recent call last):
61
  File "external/mesa3d/src/compiler/nir/nir_builder_opcodes_h.py", line 106, in <module>
62
    from mako.template import Template
63
ImportError: No module named mako.template
64
16:20:20 ninja failed with: exit status 1
65
</pre>
66
67
You need to run the following command:
68
<pre>
69
$ cd prebuilts/build-tools/path/linux-x86/
70
$ rm python && ln -s /usr/bin/python python
71
</pre>
72
73
Then you can launch the build:
74
<pre>
75 256 Denis 'GNUtoo' Carikli
$ parallel_tasks=$(echo "$(grep 'processor' /proc/cpuinfo | wc -l ) + 1" | bc)
76
$ source build/envsetup.sh
77 1 Denis 'GNUtoo' Carikli
$ export TEMPORARY_DISABLE_PATH_RESTRICTIONS=true
78 257 Denis 'GNUtoo' Carikli
$ lunch lineage_i9305-eng
79 256 Denis 'GNUtoo' Carikli
$ make -j${parallel_tasks} bacon
80
</pre>
81
82
h4. Getting lastest changes
83
84
* 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 dirty, so be sure to backup your local changes.
85
* 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:
86
<pre>
87
$ rm -rf .repo/manifests/ # This enables me to force push and rebase the manifest repository as well
88
$ repo init -u https://git.replicant.us/replicant-9/manifest.git -b replicant-10-wip
89
$ repo sync --force-sync
90
</pre>
91
* 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: 
92
<pre>
93
$ repo sync --force-sync
94
</pre>
95
96
h4. Install the images
97
98
TODO
99
100
h4. Get adb
101
102
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:
103
<pre>
104
$ sudo adb shell
105
* daemon not running; starting now at tcp:5037
106
* daemon started successfully
107
i9305:/ #                                 
108
$ sudo adb kill-server
109
$ adb shell
110
* daemon not running; starting now at tcp:5037
111
* daemon started successfully
112
error: no devices/emulators found
113
</pre>
114
So make sure to kill the adb-server and run it as root:
115
<pre>
116
$ adb kill-server
117
$ sudo adb shell
118
* daemon not running; starting now at tcp:5037
119
* daemon started successfully
120
i9305:/ # 
121
</pre>
122
123
h2. LineageOS 16 (Android 9)
124 102 Denis 'GNUtoo' Carikli
125 120 Denis 'GNUtoo' Carikli
h3. Repositories and changes for LineageOS 16
126 105 Denis 'GNUtoo' Carikli
127 152 Joonas Kylmälä
* https://git.replicant.us/GNUtoo/kernel_replicant_linux.git
128 1 Denis 'GNUtoo' Carikli
* git://git.putti.eu/aosp/external_mesa3d.git
129
* https://git.replicant.us/GNUtoo/android_build.git
130
* https://git.replicant.us/GNUtoo/device_i9305.git
131 116 Denis 'GNUtoo' Carikli
* https://git.replicant.us/GNUtoo/manifest.git
132
* https://git.replicant.us/GNUtoo/vendor_replicant.git
133 120 Denis 'GNUtoo' Carikli
134
h3. Building LineageOS 16 version
135 102 Denis 'GNUtoo' Carikli
136 1 Denis 'GNUtoo' Carikli
h4. Source code
137 102 Denis 'GNUtoo' Carikli
138 1 Denis 'GNUtoo' Carikli
<pre>
139 197 Denis 'GNUtoo' Carikli
$ repo init -u https://git.replicant.us/replicant-9/manifest.git -b replicant-9
140 142 Denis 'GNUtoo' Carikli
$ repo sync
141 102 Denis 'GNUtoo' Carikli
</pre>
142
143 200 Grim Kriegor
Alternatively a shallow copy of the source tree can be fetched in order to save on disk space:
144
145
<pre>
146
$ repo init -u https://git.replicant.us/replicant-9/manifest.git -b replicant-9 --depth=1
147
$ repo sync -c
148
</pre>
149
150
To `unshallow` a specific module:
151
152
<pre>
153
$ cd path/to/module
154
$ git fetch --unshallow <remote>
155
</pre>
156
157 162 dl lud
h4. For Trisquel 8
158
159 1 Denis 'GNUtoo' Carikli
<pre>
160 207 dl lud
sudo apt-get install bc bison build-essential bsdmainutils 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
161 162 dl lud
sudo apt-get install gcc-5-arm-linux-gnueabi
162 104 Denis 'GNUtoo' Carikli
</pre>
163 1 Denis 'GNUtoo' Carikli
164 104 Denis 'GNUtoo' Carikli
h4. Launching the build
165 1 Denis 'GNUtoo' Carikli
166 118 Denis 'GNUtoo' Carikli
Follow the "i9300 manifest instructions:":https://github.com/CustomRoms/android_local_manifests_i9300
167 104 Denis 'GNUtoo' Carikli
<pre>
168 118 Denis 'GNUtoo' Carikli
$ subject='/C=US/ST=California/L=Mountain View/O=Android/OU=Android/CN=Android/emailAddress=android@android.com'
169
$ mkdir .android-certs
170
$ for x in releasekey platform shared media testkey; do \
171
  ./development/tools/make_key .android-certs/$x "$subject"; \
172
  done
173
$ parallel_tasks=$(echo "$(grep 'processor' /proc/cpuinfo | wc -l ) + 1" | bc)
174 104 Denis 'GNUtoo' Carikli
$ source build/envsetup.sh
175 137 Denis 'GNUtoo' Carikli
$ lunch lineage_i9305-eng
176 118 Denis 'GNUtoo' Carikli
$ make -j${parallel_tasks} bacon
177 87 Denis 'GNUtoo' Carikli
</pre>
178 136 Denis 'GNUtoo' Carikli
179
The images can then be flashed with heimdall. They are then in:
180 1 Denis 'GNUtoo' Carikli
<pre>
181
  out/target/product/i9305/obj/PACKAGING/target_files_intermediates/lineage_i9305-target_files-eng.replicant/IMAGES/
182 142 Denis 'GNUtoo' Carikli
</pre>
183
184
h4. Getting lastest changes
185
186 201 Kurtis Hanna
* 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 dirty, so be sure to backup your local changes.
187 142 Denis 'GNUtoo' Carikli
* 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:
188
<pre>
189
$ rm -rf .repo/manifests/ # This enables me to force push and rebase the manifest repository as well
190 198 Denis 'GNUtoo' Carikli
$ repo init -u https://git.replicant.us/replicant-9/manifest.git -b replicant-9
191 142 Denis 'GNUtoo' Carikli
$ repo sync --force-sync
192
</pre>
193
* 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: 
194
<pre>
195
$ repo sync --force-sync
196 136 Denis 'GNUtoo' Carikli
</pre>
197
198 138 Denis 'GNUtoo' Carikli
h4. Install the images
199
200
<pre>
201 165 dl lud
$ 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 
202 138 Denis 'GNUtoo' Carikli
</pre>
203
204
h4. Get adb
205
206 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:
207 138 Denis 'GNUtoo' Carikli
<pre>
208 1 Denis 'GNUtoo' Carikli
$ sudo adb shell
209
* daemon not running; starting now at tcp:5037
210
* daemon started successfully
211
i9305:/ #                                 
212
$ sudo adb kill-server
213
$ adb shell
214
* daemon not running; starting now at tcp:5037
215
* daemon started successfully
216
error: no devices/emulators found
217
</pre>
218
So make sure to kill the adb-server and run it as root:
219
<pre>
220
$ adb kill-server
221
$ sudo adb shell
222
* daemon not running; starting now at tcp:5037
223
* daemon started successfully
224
i9305:/ # 
225
</pre>
226
227
h4. Booting
228
229
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.
230
231
You can also follow the boot progress with adb:
232
<pre>
233
adb logcat
234
adb logcat -b main
235
</pre>
236
237
Note that the device can go into suspend at any time, so adb might be interrupted. That looks like that:
238
First you get a shell
239
<pre>
240
$ sudo adb shell
241
i9305:/ #
242
</pre>
243
244
Then the connection is interrupted:
245
<pre>
246
$ adb shell
247
i9305:/ # [randomdev@fullyfreelaptop ]$                                                                                                     
248
</pre>
249
250
The effect with adb logcat is similar.
251
252
h3. cleanups to be done
253
254
* Make adb work as user by using the right USB IDs, and make userspace do the USB setup.
255
* -Make the kernel not use hardcoded CMDLINE_FORCE- Not possible unless the bootloader is changed or Linux is very heavily patched.
256
* Make the kernel not use hardcoded partitions if possible (though we use system as root)
257
* Make a clean Gatekeeper HAL module implementation instead of using the same hack than goldfish
258
* 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
259
260
h3. Using SwiftShader instead of Mesa3D llvmpipe for software rendering
261
262
To use SwifShader you need a kernel that supports UDIV/SDIV emulation, you can checkout the branch GNUtoo/udiv-emulation for kernel/replicant/linux. After doing that that run the following commands to use SwiftShader:
263
264
<pre>
265
$ adb remount
266
$ adb shell
267
i9305:/ # rm vendor/lib/egl/libGLES_mesa.so # or move it somewhere safe meanwhile you test SwiftShader
268
i9305:/ # nano system/build.prop # set ro.hardware.hwcomposer=ranchu and ro.hardware.gralloc=default
269
$ adb reboot
270
</pre>
271 199 Kurtis Hanna
272
h2. AOSP 9
273
274
h3. Status with AOSP 9
275
276
* The Galaxy SIII 4G (i9305) boots (with graphics hacks) under AOSP9, without having to import nonfree libraries:
277
** The device boots until the lock screen
278
** The graphics work but are really slow as they have not been optimized
279
** Sometime the display content is corrupted
280
** The touchscreen works
281
* 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
282
283
h3.  Repositories and changes
284
 
285
* git://git.putti.eu/aosp/manifest_i9305.git
286
* git://git.putti.eu/aosp/kernel_i9305.git
287
* git://git.putti.eu/aosp/device_i9305.git
288
* git://git.putti.eu/aosp/external_mesa3d.git
289
* git://git.putti.eu/aosp/build_make.git
290
* git://git.putti.eu/aosp/core.git
291
292
h3. Building AOSP version
293
294
h4. Source code
295
296
First get the source code:
297
<pre>
298
$ repo init -u git://git.putti.eu/aosp/manifest_i9305.git -b android-9.0.0
299
</pre>
300
301
h4. For Trisquel 8
302
303
<pre>
304
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 gcc-5-arm-linux-gnueabi
305
</pre>
306
307
h4. Building it
308
309
Once this is done, see the device/putti/i9305/README.md for the build instructions.
310
311
h4. Trisquel 8 LXC
312
313
If you use Parabola, you may be interested in running Trisquel 8 in LXC.
314
315
To do that first debootstrap a Trisquel 8 rootfs. 
316
317
Parabola's debootstrap does support Trisquel 8 and its manual has an example on how to do that:
318
<pre>
319
$ man debootstrap
320
[...]
321
# debootstrap flidas flidas-root http://archive.trisquel.info/trisquel
322
</pre>
323
324
Then you can use virt-manager to setup the LXC instance.
325
326
The advantages of this solution are that:
327
* The LXC guest and host shares their resources (CPU, RAM) with almost no penalty
328
* Trisquel 8 is not a rolling release distribution
329
330
The disadvantage of this solution are that:
331
* you need to configure again the Trisquel 8 LXC instance (vimrc, sshd_config, etc)
332
* It's more complicated to setup
333
* The Android build system output a warning message about not being able to use namespaces which may become mandatory in newer Android versions
334 172 Joonas Kylmälä
335 153 Denis 'GNUtoo' Carikli
h2. Upstreaming status
336
337 261 Denis 'GNUtoo' Carikli
* The stock bootloader is incompatible with Linux, see [[BootloadersIncompatibleWithLinux#Devices-with-the-Exynos-4412]] for more information. So we maintain patches to enable the Galaxy SIII, and Galaxy Note II to boot with the stock bootloader. In the long run we need to look into using u-boot in the kernel partition as using u-boot instead of the stock bootloader currently require nonfree and non-redistributable software (BL1).
338
* For the patches that are not merged yet, see the "issues of the redmine upstreaming sub-project":https://redmine.replicant.us/projects/upstreaming/issues
339 153 Denis 'GNUtoo' Carikli
340 227 Denis 'GNUtoo' Carikli
h2. Modem status
341
342 228 Denis 'GNUtoo' Carikli
*libsamsung-ipc:* 
343
* Fully tested under GNU/Linux only
344 235 Denis 'GNUtoo' Carikli
* Can initialize completely the modem and receive messages (see the #1954 bug report for the logs)
345 228 Denis 'GNUtoo' Carikli
* Needs more cleanup but there is now a better abstraction
346 229 Denis 'GNUtoo' Carikli
347 228 Denis 'GNUtoo' Carikli
*libsamsung-ril:* 
348
* Ported to Replicant 9 using a wrapper for the API >=12 in libsamsung-ril source code that needs to be removed
349
* Tested under Replicant 9 without up to date libsamsung-ipc (no modem init)
350
* Tested and validated under Replicant 6 (doesn't break telephony)
351
352
h3. Modem status TODO
353
354 227 Denis 'GNUtoo' Carikli
* Implement the missing part to shut down the modem, close the interfaces and such, in order to need to reboot after each test.
355
* Continue to clean up the libsamsung-ipc and libsamsung-ril patches, test the patches in Replicant 6 when applicable, and merge them in the upstream repositories.
356
* Convert the firmware loading driver to the upstream API and then adapt libsamsung-ipc for that. This should also benefit other devices like the Galaxy SIII 4G, and the Galaxy Note II 4G which probably don't need much more to get their modem supported by upstream Linux.
357
* Cleanup and convert the rest of the drivers to look like the ones for the Nokia N900 and adapt the userspace in libsamsung-ipc, and merge libsamsung-ipc support for that once the kernel API is stable.
358
* Test the code under Replicant 9 when the graphics status will enable to have decent enough speed to do some testing through human interaction.
359
360 87 Denis 'GNUtoo' Carikli
h2. TODO
361 51 Denis 'GNUtoo' Carikli
362 74 Denis 'GNUtoo' Carikli
First month of full time equivalent work:
363 81 Denis 'GNUtoo' Carikli
364 127 Denis 'GNUtoo' Carikli
|_. Time estimation  |_.Task |_. Comments |
365
| DONE | -boot a device under AOSP9- | Only boots with graphics, not much more |
366
| -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- 
367 59 Denis 'GNUtoo' Carikli
Builds under Trisquel8|
368 213 Denis 'GNUtoo' Carikli
| -21h- DONE | * -port the changes from AOSP9 to LineageOS 16-
369 155 Denis 'GNUtoo' Carikli
* -cleanup the code-
370 151 Joonas Kylmälä
* -build the kernel from the Android build system-
371 125 Denis 'GNUtoo' Carikli
* -make sure it builds with an FSDG compliant distribution-
372 143 Denis 'GNUtoo' Carikli
* -document the build procedure- |
373
Status:
374 155 Denis 'GNUtoo' Carikli
* Boots with adb.
375 143 Denis 'GNUtoo' Carikli
* Has ultra slow graphics |
376 127 Denis 'GNUtoo' Carikli
| 14h | find, remove and document proprietary software in LineageOS 16 | |
377
| 21h | find, remove and document privacy issues in LineageOS 16 | |
378 241 Denis 'GNUtoo' Carikli
| 7h | -Add support for the touch keys driver in the  galaxy-s3 dts- | "applied":https://lists.infradead.org/pipermail/linux-arm-kernel/2019-November/694100.html |
379 240 Denis 'GNUtoo' Carikli
| 7h | -upstream the AAT1290 flash led Linux dts for the galaxy-s3 boards- | "Now in 5.3":https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/commit/?h=v5.3&id=4e4dfcb2a425cccc6dd1fb7d46e060cd57999afc |
380 127 Denis 'GNUtoo' Carikli
| 7h | rebrand LineageOS as Replicant | |
381 234 Denis 'GNUtoo' Carikli
| 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| See the [[PortingToAndroid9/#Modem-status|modem status]] for more details |
382 127 Denis 'GNUtoo' Carikli
|_\3. Total: 147h (~1 month) |
383 95 Denis 'GNUtoo' Carikli
384 1 Denis 'GNUtoo' Carikli
Second month of full time equivalent work:
385 216 Denis 'GNUtoo' Carikli
| * port  libsamsung-ril and libsamsung-ipc to Android 9
386 234 Denis 'GNUtoo' Carikli
* Make the modem driver and libsamsung-ipc work together | 157h | See the [[PortingToAndroid9/#Modem-status|modem status]] for more details |
387 1 Denis 'GNUtoo' Carikli
|_. Total |_. 157h | ~1 month |
388
389
Third month of full time equivalent work:
390
|_. Task |_. Time estimation |_. Comments |
391 213 Denis 'GNUtoo' Carikli
| -port the sensors libraries and other device specific libraries-
392
Look which sensor libraries can be used | 70h | Already done by the unofficial LineageOS port of the Galaxy SIII (i9300), needs testing |
393 255 Denis 'GNUtoo' Carikli
| add support for Audio with the upstream kernel driver | 70h | Might be way faster, depending on what Android 9 uses
394
                                                               See also "this bugreport":https://github.com/CustomROMs/android_local_manifests_i9300/issues/1 |
395 212 Denis 'GNUtoo' Carikli
| -add partial (no modem) support for the Galaxy SIII 4G (i9305) and- factorize the code with i9300 | 14h | * The source code on which the work was based changed from AOSP to an unofficial LineageOS port to a port of i9305 support for AOSP by Joonas to the official LineageOS so it's now supported by default
396
* The work to factorize the code between the i9300 and i9305 still need to be done |
397
 |
398 1 Denis 'GNUtoo' Carikli
|_. Total |_. 154h | ~1 month |
399 67 Denis 'GNUtoo' Carikli
400 71 Denis 'GNUtoo' Carikli
|_. Task |_. Time estimation |_. Comments |
401 96 Denis 'GNUtoo' Carikli
| create a recovery | 21h | |
402 74 Denis 'GNUtoo' Carikli
| add internal WiFi support and validate the functionality | 6h | |
403 71 Denis 'GNUtoo' Carikli
| add external WiFi dongles support | 20h | External dongles support might be tricky |
404 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.-
405
-We also created generic instructions but they tend to be harder to follow[1] than the device specific ones.-
406
-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.-
407 214 Denis 'GNUtoo' Carikli
-The instructions will need to be able to be modified and compiled on an FSDG compliant distribution.-
408
Mostly done: 
409
* The installation instructions are now generic enough. 
410
* Some long standing TODO were also done along the way like adding backup instructions for the EFS.
411
* The current instructions are still for Replicant 6.0 and will need to be updated for Replicant 9.0 |
412 92 Denis 'GNUtoo' Carikli
413 71 Denis 'GNUtoo' Carikli
|_. Task |_. Time estimation |_. Comments |
414
| Estimate the amount of work to Reduce the attack surface | ? | |
415 1 Denis 'GNUtoo' Carikli
| Estimate the amount of work to add in-system upgrades | ? | |
416
417 82 Denis 'GNUtoo' Carikli
fn1. The generic instructions were tested at Install parties in Paris 
418 1 Denis 'GNUtoo' Carikli
419 85 Denis 'GNUtoo' Carikli
h3. Devices support:
420 1 Denis 'GNUtoo' Carikli
421 77 Denis 'GNUtoo' Carikli
h4. Easy, because it's similar enough to the Galaxy SIII (I9300)
422 97 Denis 'GNUtoo' Carikli
423
|_\3. Galaxy Note II (N7100) |
424 94 Denis 'GNUtoo' Carikli
|_. Task |_. Time estimation |_. Comments |
425 86 Denis 'GNUtoo' Carikli
| port the EA8061 LCD Linux driver | 35h | |
426
| port the S6EVR02 LCD Linux driver | 35h | |
427
| port the MAX77693 flash led Linux driver | 7h | |
428
| 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 |
429
| port the sensors libraries and other device specific libraries | 70h | It's difficult to evaluate how much time it could take |
430 125 Denis 'GNUtoo' Carikli
| add support for Audio with the upstream kernel driver | 14h | Should be similar to the Galaxy SIII |
431 86 Denis 'GNUtoo' Carikli
432 1 Denis 'GNUtoo' Carikli
|_\3. Galaxy Note 8.0 (N5100) and 8.0 WiFi (N5110) |
433 70 Denis 'GNUtoo' Carikli
|_. Task |_. Time estimation |_. Comments |
434
| Evaluate the time required to do the port | 14h | TODO |
435 69 Denis 'GNUtoo' Carikli
436 94 Denis 'GNUtoo' Carikli
h4. Needs more work and unknown upstream Linux status
437
438 54 Denis 'GNUtoo' Carikli
|_. Device |_. Time estimation |_. Comments |
439
| Galaxy S II (i9100) | | Linux: devboard dts upstream? unknown status |
440
| Galaxy Note (N7000) | | unknown Linux upstream status |
441 254 Jens Korte
| Galaxy Nexus (I9250) | |/2. OMAP4, no dts upstream |
442 34 Denis 'GNUtoo' Carikli
| Galaxy Tab 2 7.0 (P3100), 7.0 WiFi (P3110), 10.1 (P5100), 10.1 WiFi (P5110) | |
443 2 Denis 'GNUtoo' Carikli
| GTA04 >= A4 | | TODO: a RIL needs to be written, userspace GPS support is missing, audio scenarios, etc |
444 4 Denis 'GNUtoo' Carikli
445 128 Denis 'GNUtoo' Carikli
h2. Documentation
446 1 Denis 'GNUtoo' Carikli
447 128 Denis 'GNUtoo' Carikli
h3. Replicant 6.0 changes
448
449 252 Denis 'GNUtoo' Carikli
See [[Replican6Changes]].
450 128 Denis 'GNUtoo' Carikli
451 193 Denis 'GNUtoo' Carikli
h3. Other rebases
452
453 253 Denis 'GNUtoo' Carikli
See the [[Samsung-ipc]] page.
454 193 Denis 'GNUtoo' Carikli
455 217 Denis 'GNUtoo' Carikli
h2. Other attempts
456
457 218 Denis 'GNUtoo' Carikli
* It might be interesting to contact the people doing ports once we have something working well enough.
458
* It is also interesting to look at other attempts to understand if a given device is powerful enough to run Android 9 and what configuration was used to achieve it.
459
460 217 Denis 'GNUtoo' Carikli
|_. Device(s) |_. Repository |_. status |_. Comments |
461 238 Kurtis Hanna
| i9300 | "CustomROMs":https://github.com/CustomROMs/android_local_manifests_i9300 | * "March 3 2019 release":https://forum.xda-developers.com/galaxy-s3/development/rom-lineageos-16-0-t3875899 | |
462
| i9300 | "Team InFusion":https://github.com/team-infusion-developers/android_local_manifests_i9300 | * "August 20 2019 release":https://forum.xda-developers.com/galaxy-s3/development/rom-optimized-lineageos-16-0-team-t3940142 | Issues: * Uses a Samsung kernel
463
* Uses too many nonfree libraries
464 237 Kurtis Hanna
=> Probably nothing we could reuse from its code |
465
| N7100 | "ComicoTeam":https://github.com/ComicoTeam/android_device_samsung_n7100 | * "September 13 2019 release":https://forum.xda-developers.com/galaxy-note-2/development/rom-lineageos-16-0-20190112-comico-t3889281 | |
466 236 Kurtis Hanna
| I9100 | | "XDA":https://forum.xda-developers.com/galaxy-s2/development-derivatives/pie-i9100-t3850588 | |
467 217 Denis 'GNUtoo' Carikli
468 220 Denis 'GNUtoo' Carikli
h3. Links for other attempts
469
470
* https://www.xda-developers.com/android-pie-android-9-port-custom-roms/
471
472 128 Denis 'GNUtoo' Carikli
h3. CustomROMs i9300 components
473
474 131 Denis 'GNUtoo' Carikli
|_. Repository |_. Tree path |_. Dependencies |_. Function |_. Comments |
475
|/8. https://github.com/CustomROMs/android_hardware_samsung
476
lineage-16.0 branch | hardware/samsung/macloader | | Loads the MAC Address of the WiFi network interface | Might be useful |
477
| hardware/samsung/wifiloader | | Loads the wifi kernel module (like modprobe) and setup firmware filesystems permissions | May be useful |
478
| hardware/samsung/audio | | seems to contains ril related stuff as well | Look if the ril stuff is required, go for standard audio |
479
| hardware/samsung/lineagehw/hidl/livedisplay | | livedisplay is a feature similar to what redshift does on GNU/Linux | Not sure if it works with mainline |
480
| 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 |
481
| all other directories in hardware/samsung/exynos/ | nonfree firmwares, nonfree software?, smdk kernel? | audio/video decoding offload | Avoid using that |
482
| 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 |
483 202 Kurtis Hanna
| hardware/samsung/exynos4 |
484 1 Denis 'GNUtoo' Carikli
485
h2. Links 
486 205 dl lud
487
* "Android build requirements - hardware and software":https://source.android.com/setup/build/requirements
488
* "Why LineageOS Developers are building Android Go-optimized custom ROMs":https://www.xda-developers.com/android-go-old-android-8-1-oreo/
489
* "Android Go recommended default values for propreties for optimization":https://android.googlesource.com/platform/build/+/master/target/product/go_defaults_common.mk
490
* "Team InFusion i9300 optimized system.prop":https://github.com/team-infusion-developers/android_device_samsung_i9300/blob/lineage-16.0/system.prop#L23
491
* "Hack to fix high CPU usage caused by logd":https://github.com/team-infusion-developers/android_device_samsung_smdk4412-common/commit/c66015514fc9779edfed2665f67e841f3620c71e
492
* "Use low-end video codecs":https://github.com/team-infusion-developers/android_device_samsung_smdk4412-common/commit/adc919f04b981a4fe005fab2cf443596a22992b2
493
* "Optimize ActivityManager cached apps":https://github.com/team-infusion-developers/android_device_samsung_smdk4412-common/commit/24bc62970d35eb5a7a257463e7dbfe873ceb5779
494
* "Use 1Gb Dalvik config":https://github.com/team-infusion-developers/android_device_samsung_smdk4412-common/commit/8a7cebc5af772a2949420ac4a383f5f75236c65c