Project

General

Profile

DeprecatedPortingToAndroid10 » History » Version 265

dl lud, 06/29/2020 09:46 AM
make -jX does nothing nowdays, builds are always launched on all available cores (probably since Soong and Ninja were introduced).

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