Project

General

Profile

TasksFunding » History » Version 138

Denis 'GNUtoo' Carikli, 01/23/2019 05:32 PM

1 1 Denis 'GNUtoo' Carikli
{{>toc}}
2
3 84 Denis 'GNUtoo' Carikli
h1. Tasks that could be funded
4 2 Denis 'GNUtoo' Carikli
5 84 Denis 'GNUtoo' Carikli
h2. What kind of tasks to fund
6 1 Denis 'GNUtoo' Carikli
7 84 Denis 'GNUtoo' Carikli
/!\ This is a draft. It doesn't represent the Replicant project decisions yet.
8 1 Denis 'GNUtoo' Carikli
9 84 Denis 'GNUtoo' Carikli
h3. Funding strategies
10 1 Denis 'GNUtoo' Carikli
11 84 Denis 'GNUtoo' Carikli
* Fund important and urgent tasks?
12
* Fund tasks that no one want to work on?
13
14
h3. Applicant criteria
15
16
* The applicants will need to already have Patches in Replicant to apply. So if you want to apply and don't have any patches in Replicant, the easiest way is just to send some useful patches.
17
* The applicants will need to be able to demonstrate that they have the required skills by showing contributions in free and open source project in similar areas.
18 93 Denis 'GNUtoo' Carikli
* The applicants will need to be able to do contract work
19
20 95 Denis 'GNUtoo' Carikli
h3. Grant application template
21 93 Denis 'GNUtoo' Carikli
22 1 Denis 'GNUtoo' Carikli
*url*: https://nlnet.nl/propose/
23 95 Denis 'GNUtoo' Carikli
*scope* : Is it per task?
24 84 Denis 'GNUtoo' Carikli
25 1 Denis 'GNUtoo' Carikli
h4. Contact information
26
27 108 Denis 'GNUtoo' Carikli
|_. Email address | [[PrivateContact#Email]] + FSF |
28
|_. Phone numbers | GNUtoo's phone number + FSF's phone number |
29
|_. Organisation | Replicant and the FSF |
30 109 Denis 'GNUtoo' Carikli
|_. Country | France(GNUtoo), USA (FSF) |
31 95 Denis 'GNUtoo' Carikli
32
h4. General project information
33
34 120 Denis 'GNUtoo' Carikli
|_. Project name |  <Depend on the task?>  |
35 95 Denis 'GNUtoo' Carikli
|_. Website / wiki | https://replicant.us? https://redmine.replicant.us/projects/replicant/wiki/Tasks_v2 ? |
36
|_. Abstract: Can you explain the whole project and its expected outcome(s).in 1200 characters
37
Please be short and to the point in your answers; focus primarily on the what and how, not so much on the why.
38
Add longer descriptions as attachments (see below).
39
If English isn't your first language, don't worry - our reviewers don't care about spelling errors, only about great ideas.
40
On the up side, you can be as technical as you need to be (but you don't have to).
41 101 Denis 'GNUtoo' Carikli
Do stay concrete. | <Depend on the task?> |
42 102 Denis 'GNUtoo' Carikli
|_. Have you been involved with projects or organizations relevant to this project before?
43 103 Denis 'GNUtoo' Carikli
And if so, can you tell us a bit about your contributions? | Yes: I've been involved in Replicant since the beginning both as a developer and for managing the project:
44 102 Denis 'GNUtoo' Carikli
As a developer:
45 1 Denis 'GNUtoo' Carikli
* I did most/all the initial system work and made it work for the the HTC Dream, and the Google Nexus One.
46 103 Denis 'GNUtoo' Carikli
* I also worked on porting the Goldelico GTA04, Galaxy nexus, Galaxy Tab 2 7.1 along with other Replicant developers and did various bug fixes and improvements.
47
* I am also doing code reviews for patches.
48
For managing the project:
49
* public relations
50
* fund usage decisions
51
* infrastructure (sysadmin, etc)
52
* documentation
53
* project direction and strategic decisions |
54 95 Denis 'GNUtoo' Carikli
55
h4. Requested support
56
57
|_. Requested Amount (Between 5000 and 50000 Euros) | |
58 137 Denis 'GNUtoo' Carikli
|_. * Explain what the requested budget will be used for? | <depends on the task> |
59
|_. * Does the project have other funding sources, both past and present? | 
60 130 Denis 'GNUtoo' Carikli
The Replicant project has about 200000 dollars at disposition:
61 96 Denis 'GNUtoo' Carikli
* The Replicant project has a donation page https://crm.fsf.org/civicrm/contribute/transact?reset=1&id=19. Part of the donations were used for buying devices and reimburse conference attendances. We have about 20000 dollars remaining from the donation.
62
* The Replicant project recently received 200000 dollars from Handshake: https://www.fsf.org/news/free-software-foundation-receives-1-million-from-handshake As the FSF takes 10% that leaves us 180000 dollars |
63
|_. Compare your own project with existing or historical efforts. | <Depend on the task?> |
64
|_. What are significant technical challenges you expect to solve during the project, if any? | <Depend on the task?> |
65 138 Denis 'GNUtoo' Carikli
66
Describe the ecosystem of the project, and how you will engage with relevant actors and promote the outcomes?
67
<pre>
68
The Replicant project contributors and the FSF will supervise contractors to do the work.
69
70
I will write a blog post to anounce that the Replicant project has got some funding for this specific task, and that it is looking for a contractor to work on it. This is to make sure that every one has equals chances in the application process.
71
72
Then the most suited contractor will be selected. Only contractors that already have worked on similar tasks as part of free and open source software projects will be chosen. This way we can look at their existing contributions and make sure that they are able to do the task before engaging with them.
73
Some people already involved in the Replicant project with proven contributions, me included, are already interested about doing such contract work, so finding someone suitable to work on the task should not be an issue.
74
</pre>
75
76 96 Denis 'GNUtoo' Carikli
|_. Attachments | None |
77 95 Denis 'GNUtoo' Carikli
78
h4. How may we handle your information
79
80 98 Denis 'GNUtoo' Carikli
|_. What should we do in the other case,
81
 e.g. when your project is not immediately selected? | I allow NLnet Foundation to keep the information I submit on record, should future funding opportunities arise |
82 95 Denis 'GNUtoo' Carikli
|_. Send me a copy of this application. | check-box checked |
83 98 Denis 'GNUtoo' Carikli
|_. PGP pubkey | None (if we use Replicant contact address, we can't encrypt to it) |
84 94 Denis 'GNUtoo' Carikli
85 84 Denis 'GNUtoo' Carikli
h3. Discussions
86
87
There is "a thread about funding on the mailing list":https://lists.osuosl.org/pipermail/replicant/2019-January/001774.html about that
88
89 76 Denis 'GNUtoo' Carikli
h2. Tasks that could be funded
90 38 Denis 'GNUtoo' Carikli
91 77 Denis 'GNUtoo' Carikli
h3. Port Replicant to a newer Android version
92 1 Denis 'GNUtoo' Carikli
93 113 Denis 'GNUtoo' Carikli
Replicant is currently based on LineageOS 13 which is based on Android 6.0.
94
It is becoming very urgent to upgrade Replicant to a newer release of Android, as Android 6.0 is not supported anymore. It would probably also make it way easier to fix the following issues:
95
* Replicant is currently lagging behind with security fixes
96
* Replicant cannot be built from a GNU/Linux distribution that follows the Free Software Distribution Guidelines
97
98
*Hardware requirements* :
99
* A computer that is able to build Replicant.
100
* A smartphone or tablet that can easily supported by the new version of Replicant and that meet Android 9 [[HardwareRequirements]].
101
102
*Expected outcomes*:
103
* Remove all proprietary components of LineageOS and make sure that Replicant follows the "Free Software Distributions Guidelines (FSDG)":https://www.gnu.org/distros/"
104
* Port all the changes needed to successfully boot without any proprietary software in Replicant
105
* Make sure that most of the security issues are fixed, and lower the attack surface if possible.
106
* Make sure that Replicant can be built on a GNU/Linux distribution that follows the "Free Software Distributions Guidelines (FSDG)":https://www.gnu.org/distros/
107
* Rebrand LineageOS as Replicant
108
109
*Funding*: We could apply to https://nlnet.nl/PET
110
111
h4. Subtasks
112 1 Denis 'GNUtoo' Carikli
113
The following sub-tasks could also be worked on along with porting Replicant to a newer Android version, as it doesn't make sense to do them for older Replicant versions:
114 89 Denis 'GNUtoo' Carikli
* [[Tasks v2#Add support for devices with an upstream Linux kernel|Add support for devices with an upstream Linux kernel]]
115 77 Denis 'GNUtoo' Carikli
* [[Tasks v2#Add support for more recent smartphones|Add support for more recent smartphones]]
116 80 Denis 'GNUtoo' Carikli
* [[Tasks v2#Add support for the devices supported in Replicant 6.0 and 4.2|Add support for the devices supported in Replicant 6.0 and 4.2]]
117 82 Denis 'GNUtoo' Carikli
* [[Tasks v2#Support in-system upgrades|Support in-system upgrades]]
118 113 Denis 'GNUtoo' Carikli
119 78 Denis 'GNUtoo' Carikli
h4. Add support for devices with an upstream Linux kernel
120
121 57 Denis 'GNUtoo' Carikli
It would also be useful to support devices using kernels that are based on upstream Linux with the least amount of kernel changes possible:
122 1 Denis 'GNUtoo' Carikli
123
Currently, Replicant uses a dedicated Hardware Abstraction Layer per device, because device manufacturers implemented non-standard kernel interfaces. However, Android works with mainline kernels and supports plug-n-play hardware nowadays, so it makes sense to have generic Hardware Abstraction Layers for the standard interfaces of the Linux kernel (ALSA, V4L2, etc).
124
125
See also the [[Upstream#Upstream-Linux|wiki page on Upstream Linux]] for more details on why using upstream kernel is beneficial, and for what devices to choose to work on this task.
126
127
*Hardware requirements* :
128 89 Denis 'GNUtoo' Carikli
In addition to the requirements for porting Replicant to a newer Android version:
129
* A device that is already well supported by the Upstream kernel. That device don't need to be already supported by LineageOS or even Android.
130 1 Denis 'GNUtoo' Carikli
131
*Difficulty*: Medium
132
133
*Requirements/Prerequisites*: Knowledge of C, some C++, the ability to understand Java, kernel interfaces knowledge
134
135 77 Denis 'GNUtoo' Carikli
*Expected outcomes*: 
136
* Basic features working (graphics, touchscreen, buttons, audio, and telephony if there is a modem) for at least one device that use a kernel that is very closely based on upstream Linux with the generic HALs.
137 1 Denis 'GNUtoo' Carikli
138
h4. Add support for more recent smartphones
139
140
The most recent smartphones that Replicant support are quite old (they were made around 2013). The goal here is to add support for more recent smartphones in Replicant.
141
142
Even if we think that it's at lot more important to support devices that are better for freedom (samsung devices usually have a nonfree bootloaders), adding supporting common (Samsung) phones and tablets is relatively easy and fast to do and could be a good way to get started in contributing to Replicant. 
143
144
It's advised to pick a device that:
145
* has an isolated modem (no shared memory between the modem and the processor running Android)
146
* meets Android 9 [[HardwareRequirements]] to still be useful when Replicant will be ported to Android 9
147
* has a modem that can easily be supported by samsung-ril and libsamsung-ipc 
148
* is or will be supported by lineageOS
149
150
Make sure to evaluate the device before starting to work on it. Some devices have been evaluated in the [[TargetsEvaluation|TargetsEvaluation wiki page]]. There is also a "forum section":https://redmine.replicant.us/projects/replicant/boards/27 for devices evaluation.
151
152 90 Denis 'GNUtoo' Carikli
*Hardware requirements*:
153
In addition to the requirements for porting Replicant to a newer Android version: 
154 92 Denis 'GNUtoo' Carikli
* One or more smartphones that are already well supported by LineageOS or the AOSP project and that can easily be added in Replicant.
155 90 Denis 'GNUtoo' Carikli
156 1 Denis 'GNUtoo' Carikli
*Difficulty*: Medium
157
158
*Expected outcomes*: 
159
* Basic features working (graphics, touchscreen, buttons, audio, and telephony if there is a modem) without requiring Replicant or the user to install or ship nonfree software or firmwares.
160 78 Denis 'GNUtoo' Carikli
161
h4. Add support for the devices supported in Replicant 6.0 and 4.2
162 1 Denis 'GNUtoo' Carikli
163
When porting Replicant to a new version, it's also a good idea to keep supporting all the devices we supported in the older versions, however this is not always possible or desirable.
164
165
In order not to require too much work, devices that were previously supported will have to meet the [[HardwareRequirements]] of the new Android version. Here many of the devices already supported by Replicant 6.0 already meet such requirements.
166
167
*Hardware requirements and dependencies*:
168
In addition to the requirements for porting Replicant to a newer Android version:
169
* The port to the new Android version needs to be complete for at least one device before starting to work on this.
170
* All the devices will need to be shipped to (or acquired by) the person working on this task before starting to work on this.
171
172
*Expected outcomes*: 
173
* For each device: evaluate if they meet the hardware requirements of the new Android version and document that in the wiki in an appropriate location  ( like [[HardwareRequirements]] for instance)
174
* For each device: basic features working (graphics, touchscreen, buttons, audio, and telephony if there is a modem) without requiring Replicant or the user to install or ship nonfree software or firmwares.
175
176
*Difficulty*: Medium
177
178
h4. Support in-system upgrades
179
180
It would be useful for a Replicant device to be able to update itself to a new version of Replicant without requiring being connected to a PC. LineageOS already supports this; we suspect that it should be possible to adapt this LineageOS functionality to Replicant.
181
182
Whenever possible, it would be useful to complete and submit some of the code written for Replicant to LineageOS.
183
184
*Difficulty*: Medium
185 78 Denis 'GNUtoo' Carikli
186
*Expected outcomes*: 
187
* In-system updates working without being connected to a PC
188 119 Denis 'GNUtoo' Carikli
189
h4. nlnet Grant application
190
191
|_. Project name | Port Replicant to a newer Android version |
192
|_. Website / wiki | https://redmine.replicant.us/projects/replicant/wiki/Tasks_funding#Port-Replicant-to-a-newer-Android-version |
193
194 125 Denis 'GNUtoo' Carikli
Abstract: Can you explain the whole project and its expected outcome(s).in 1200 characters
195
<pre>
196 128 Denis 'GNUtoo' Carikli
Replicant is a fully free software Android distribution which
197 131 Denis 'GNUtoo' Carikli
is approved by the FSF (http://gnu.org/distros).
198 1 Denis 'GNUtoo' Carikli
199
The combination of Android Open Source Project source code with
200 128 Denis 'GNUtoo' Carikli
the Linux source code provided by the device vendor is not
201
sufficient to produce a fully free Android distribution that
202
works: A lot of the code that makes critical hardware component
203
work (the modem, graphics, audio, gps, etc) is in userspace.
204 131 Denis 'GNUtoo' Carikli
Because of that most device manufacutrers don't release them as
205 128 Denis 'GNUtoo' Carikli
free software.
206 1 Denis 'GNUtoo' Carikli
207 131 Denis 'GNUtoo' Carikli
To make such hardware work, the Replicant project manages to
208
replace or avoid such nonfree software.
209 1 Denis 'GNUtoo' Carikli
210 128 Denis 'GNUtoo' Carikli
Replicant is currently based on LineageOS 13.0 which in turn is based
211 127 Denis 'GNUtoo' Carikli
on Android 6.0.1 which are both not supported anymore. Replicant is
212
based on LineageOS because it supports many more smartphones and
213
tablets than the Android Open Source Project.
214
215 131 Denis 'GNUtoo' Carikli
The project consists in porting Replicant changes on top of the
216
"Android 9" release of the Android Open Source project,
217
and when LineageOS 16 will be ready, to backport our changes on
218
top of LineageOS 16.
219 125 Denis 'GNUtoo' Carikli
</pre> 
220 119 Denis 'GNUtoo' Carikli
221
|_. Have you been involved with projects or organizations relevant to this project before?
222
And if so, can you tell us a bit about your contributions? | SEE TEMPLATE |
223
224
|_. Requested Amount (Between 5000 and 50000 Euros) | 50000 Euros |
225
|_. Does the project have other funding sources, both past and present? | SEE TEMPLATE |
226 133 Denis 'GNUtoo' Carikli
227
Explain what the requested budget will be used for? 
228
<pre>
229 134 Denis 'GNUtoo' Carikli
The budget will be used to fund this task through contract work.
230
231
However it is difficult to evaluate precisely the amount of time such work
232 133 Denis 'GNUtoo' Carikli
will take as sometime bugs can slow down a lot that kind of work.
233
For instance, when adding support for the Galaxy Nexus to Replicant,
234 135 Denis 'GNUtoo' Carikli
a lot of time was spent dealing with display issues that didn't affect
235
the upstream projects, because they relied on the GPU which required
236 133 Denis 'GNUtoo' Carikli
nonfree software to work.
237
238
We think it will take something between 2 and 6 month of work
239
for one full time developer.
240
241 136 Denis 'GNUtoo' Carikli
When that work is done, we will then need to add support for most the
242 133 Denis 'GNUtoo' Carikli
smartphones we currently support in Replicant, add support for more
243
recent smartphones as the most recent one we currently support has
244
been released in 2013.
245
246
We also need to enable Replicant to use upstream Linux kernels in order
247
to support devices with free software bootloaders like the NC_1 from
248
Necuno Solutions.
249
</pre>
250
251 119 Denis 'GNUtoo' Carikli
|_. Compare your own project with existing or historical efforts. | TODO |
252 132 Denis 'GNUtoo' Carikli
253
What are significant technical challenges you expect to solve during the project, if any?
254
<pre>
255
To upgrade Replicant to a new Android release, we need to
256
adapt our free software replacement, and to find ways to not
257
depend on the nonfree software that we didn't replace
258
yet (like GPU drivers). We for instance had to find ways to
259
make Replicant graphics fast enough without being able to use
260
the GPU, as there is no free software GPU driver for some of
261
the devices we support.
262
263
Android has also changed a lot since Android 6.0.1: It has been
264
re-architectured to provide a more stable interface for userspace 
265
hardware support code.
266
</pre>
267
268 119 Denis 'GNUtoo' Carikli
|_. Describe the ecosystem of the project, and how you will engage with relevant actors and promote the outcomes? | SEE TEMPLATE |
269 76 Denis 'GNUtoo' Carikli
|_. Attachments | SEE TEMPLATE |
270
271
h3. Implement the missing features of Samsung-RIL
272
273
Samsung-RIL is the RIL (Radio Interface Layer) that many Replicant devices use to communicate with the modem.  It is a free, reverse-engineered replacement for the proprietary RIL that the Samsung phones ship with by default (which has been found to have backdoors).
274
275
Right now, Samsung-RIL mostly implements only the protocol features that are absolutely necessary for the phone to be operable.  As a result, many more rarely used protocol features are unimplemented, which decreases functionality compared to the proprietary RIL. You can help by implementing the missing features of Samsung-RIL.
276
277
It would also be nice to fix most the reported bugs involving samsung-ril and libsamsung-ipc that are impacting users very seriously. This includes the bugs about the SIM card not being detected, and the issue about having metallic sound quality when doing voice calls over 3G (bug #1773). It would also be nice to be able to recover from EFS (the modem filesystem) corruptions (Bug #1869).
278
279
*Hardware requirements* : A computer that is able to build Replicant. A smartphone or tablet supported by Samsung-RIL.
280
281
*Difficulty*: Medium to Hard
282
283
*Requirements/Prerequisites*: Knowledge of C.
284
285
*Expected outcomes*: Implement the missing features listed at [[Samsung-RIL]]. When all the features have been implemented, also ask usptream (LineageOS) if they want to use libsamsung-ipc and samsung-ril.
286
287
*Dependencies*: This task should be fairly independent as:
288
* [[Libsamsung-ipc]] should already be independent of the Android version (it can even run on GNU/Linux)
289
* [[Samsung-RIL]] can probably easily be adapted to newer Android version
290
291
*Funding*: We could apply to https://nlnet.nl/PET
292
293
h3. Implement a fully-featured QMI-RIL
294
295
The LTE variants of the Samsung Galaxy S3 and Samsung Galaxy Note 2 use a different modem from the non-LTE variants that Replicant currently supports.  You can help Replicant support those modems by implementing a QMI-RIL, which performs a similar role on the LTE variants as what Samsung-RIL performs on the currently-supported non-LTE variants.  Wolfgang has done some preliminary work on this, so you'll probably be picking up where he left off.
296
297
*Hardware requirements* : A computer that is able to build Replicant. A smartphone or tablet supported by QMI-RIL like the Galaxy SIII 4G (i9305).
298
299
*Difficulty*: Hard
300
301
*Requirements/Prerequisites*: Knowledge of C.
302
303
*Expected outcomes*: A QMI-RIL that supports voice calls, SMS, and data, with as complete a protocol implementation as possible.
304
305
*Dependencies*: This task should be fairly independent as:
306
* The lower layers should already be independent of the Android version as they are used under GNU/Linux
307
* [[QMI-RIL]] can probably easily be adapted to newer Android version
308
309 59 Denis 'GNUtoo' Carikli
*Funding*: We could apply to https://nlnet.nl/PET
310
311
h3. Finish to port the Galaxy S 2 (I9100), Galaxy S 3 (I9300) and Galaxy Note 2 (N7100) to Mainline Linux
312
313
The the Galaxy S 2 (I9100), Galaxy S 3 (I9300) and Galaxy Note 2 (N7100) currently use a kernel based on a vendor fork of Linux, which poses a maintainability and security issue.  Forkbomb has done some initial work on porting these devices to use mainline Linux.  You can help by continuing this work. This would also enable these devices to use generic hardware abstraction layers (HAL) when abstractions layers are ready, and to do some research on whether the "TrustZone operating system":https://blog.fossencdi.org/u-boot-galaxys3.html can be removed from such devices.
314
315
*Hardware requirements* : A computer that is able to build Replicant. A Galaxy S 2 (I9100), Galaxy S 3 (I9300) or Galaxy Note 2 (N7100), and a serial port adapter to get the kernel boot logs.
316
317
*Difficulty*: Medium
318
319
*Requirements/Prerequisites*: C programming language, driver development
320
321
*Expected outcomes*: Audio working, modem working, and Replicant or LineageOS booting with mainline Linux.
322 105 Denis 'GNUtoo' Carikli
323 68 Denis 'GNUtoo' Carikli
h3. llvmpipe optimizations
324 104 Denis 'GNUtoo' Carikli
325
Replicant was relying on Android's OpenGL library (libAGL) which is fast but very incomplete. This prevent running many f-droid applications like browsers and also create many other issues (#705).
326
327
"llvmpipe has been integrated in Replicant":https://git.replicant.us/replicant/external_mesa3d/log/ but it's not activated by default yet as it is very slow. It is also not fully complete.
328 106 Denis 'GNUtoo' Carikli
329 104 Denis 'GNUtoo' Carikli
To fix that, llvmpipe and/or the integration of it in Replicant should be obtimized, while still being able to run most of the applications that come from f-droid. llvmpipe and/or Mesa could be "configured not to implement very expensive OpenGL operations":https://www.mesa3d.org/perf.html. If that's not sufficent or if that breaks application compatibility, various software or hardware features (ARM NEON, hardware 2D acceleration, etc) could be used to improve the speed.
330 106 Denis 'GNUtoo' Carikli
331 68 Denis 'GNUtoo' Carikli
See also the [[GraphicsResearch#llvmpipe|wiki page about graphics research / llvmpipe]] and [[Graphics]] for more details about the issue. Other solutions fixing the problem might be acceptable too, if it makes more sense.
332 1 Denis 'GNUtoo' Carikli
333 68 Denis 'GNUtoo' Carikli
*Hardware requirements* : A computer that is able to build Replicant. A smartphone or tablet that is supported by Replicant to be able to test the result.
334 104 Denis 'GNUtoo' Carikli
335 68 Denis 'GNUtoo' Carikli
*Difficulty*: Medium / Hard (depending on the amount of obtmisations required)
336
337
*Requirements/Prerequisites*: See with the MESA project
338 72 Denis 'GNUtoo' Carikli
339
*Expected outcomes*:
340
* Working EGL implementation
341
* fast enough graphics
342
* F-droid applications not crashing anymore because of EGL.
343
344 68 Denis 'GNUtoo' Carikli
*Funding*: We could apply to https://nlnet.nl/PET
345 107 Denis 'GNUtoo' Carikli
346
h4. Integrate llvmpipe with Gralloc / hwcomposer 
347 86 Denis 'GNUtoo' Carikli
348
h1. Other tasks
349 87 Denis 'GNUtoo' Carikli
350 85 Denis 'GNUtoo' Carikli
h2. Tasks that are being defined
351
352
h3. Test infrastructure
353
354
Having an automated build and test infrastructure would be very beneficial for Replicant.
355
356
Issues:
357
* Running costs of such infrastructure have to be kept low, not to depend on continuous flow of money
358
359
h3. Documentation
360
361
A lot of time is spent on the wiki documentation, and a lot of information is redundant (for instance the installation guide)
362
363
TODO:
364
* Research documentation systems
365
* Research the technical knowledge required to use them
366
* Look into communities like RockBox on the benefit of non-wiki documentation
367
* Look if transitioning to non-wiki documentation would make the Replicant Project loose its contributors to the documentation
368 63 Denis 'GNUtoo' Carikli
369
h2. Devices with 512M of RAM or less
370
371
We might want to consider Android 9 [[HardwareRequirements]] before working on that
372 59 Denis 'GNUtoo' Carikli
373
h3. Advance the Optimus Black U-Boot and Linux mainline ports
374
375
The Optimus Black from LG is an interesting device from the perspective of freedom and privacy/security. It has the ability to run a free bootloader and uses an OMAP3 SoC that is well-documented and supported in upstream U-Boot (bootloader) and Linux (kernel). Its modem is well-isolated from the rest of the device, ensuring a sane base for privacy/security. Currently, the device-specific parts of the mainline U-Boot and Linux ports are still at an early stage, where they are functional with a very limited set of supported hardware.
376
377
Advancing the Optimus Black U-Boot and Linux mainline ports would allow using the device with free, up-to-date and maintainable software and would pave the way for support in GNU/Linux systems as well as Replicant. A list of priorities in hardware support will be defined, with the objective of tackling as many as possible.
378
379
*Hardware requirements* : A computer that is able to build Replicant. An Optimus Black with u-boot and modified boot pins, a serial port adapter to get the kernel boot logs.
380
381
*Difficulty*: Medium to Hard
382
383
*Requirements/Prerequisites*: C programming language, driver development
384
385 1 Denis 'GNUtoo' Carikli
*Expected outcomes*: Improved hardware support for the Optimus Black in U-Boot and Linux
386 61 Denis 'GNUtoo' Carikli
387
h3. Advance the Kindle Fire (first generation) U-Boot and Linux mainline ports
388
389
The Kindle Fire (first generation) from Amazon is an interesting device from the perspective of freedom and privacy/security. It has the ability to run a free bootloader and uses an OMAP4 SoC that is well-documented and supported in upstream U-Boot (bootloader) and Linux (kernel). It does not embed a modem, ensuring a sane base for privacy/security. Currently, the device-specific parts of the mainline U-Boot and Linux ports are still at an early stage, where they are functional with a very limited set of supported hardware.
390
391
Advancing the Kindle Fire (first generation) U-Boot and Linux mainline ports would allow using the device with free, up-to-date and maintainable software and would pave the way for support in GNU/Linux systems as well as Replicant. A list of priorities in hardware support will be defined, with the objective of tackling as many as possible.
392
393
*Hardware requirements* : A computer that is able to build Replicant. A Kindle Fire first generation, a serial port adapter to get the kernel boot logs.
394
395
*Difficulty*: Medium
396
397
*Requirements/Prerequisites*: C programming language, driver development
398
399
*Expected outcomes*: Improved hardware support for the Kindle Fire (first generation) in U-Boot and Linux
400 62 Denis 'GNUtoo' Carikli
401
h3. Select and/or port a tablet with an Allwinner SOC to mainline Linux and U-boot, and Replicant
402
403
Tablets with Allwinner SOCs are an interesting targets because they do not use signed bootloaders and the SOCs and various devices using them have good Linux and u-boot mainline support. If not much work is required for that, once the code is merged, the candidate is also required to work on the generic abstraction layer project which is also documented in this page.
404
405
The chosen tablet should have:
406 67 Denis 'GNUtoo' Carikli
* A SOC that has good mainline support, see "the Linux mainlining effort page on linux-sunxi":https://linux-sunxi.org/Linux_mainlining_effort for more details.
407
* A Free software bootloader, or the ability to easily add support for the tablet to a free software bootloader.
408
* The ability to power and use an USB WiFi card or chip that is compatible with the ath9k_htc driver.
409
410
It would be better if the chosen tablet doesn't use an AllWinner SOC with a PowerVR GPU, as MALI GPU have more probability to be usable with free software in the future.
411
412
*Hardware requirements* : A computer that is able to build Replicant. An Allwinner tablet, a serial port adapter to get the kernel boot logs.
413
414
*Difficulty*: Medium
415
416
*Requirements/Prerequisites*: C programming language, driver development
417
418
*Expected outcomes*: Replicant support for a tablet using an Allwinner SOC, with free software bootloader and mainline based Linux kernel.
419 56 Denis 'GNUtoo' Carikli
420 3 Denis 'GNUtoo' Carikli
h2. Tasks for Replicant 6.0
421 55 Denis 'GNUtoo' Carikli
422
h3. Tackle security issues in Replicant 6.0
423 43 Denis 'GNUtoo' Carikli
424
Replicant is plagued by various security issues, that are mostly due to using a downstream codebase. One of the most crucial issues is that Replicant uses an old version of the Android WebView (from circa 2015), which is also a functionality drawback.
425
An initial evaluation of the security issues in Replicant should be conducted, followed by the integration or update of the concerned components of the system.
426
427
It would also be nice to do the same for privacy issues. Since Replicant indirectly depends on the "Android Open Source Project" and directly depends on LineageOS, not all privacy issues might have been found fixed by Replicant. Once security issues have been fixed, it would be nice to try to identify as many privacy issues as possible, and in a second time to fix them.
428
429
*Hardware requirements* : A computer that is able to build Replicant. A smartphone or tablet that is supported by Replicant to be able to test the result.
430
431
*Difficulty*: Medium-Hard
432 1 Denis 'GNUtoo' Carikli
433 43 Denis 'GNUtoo' Carikli
*Requirements/Prerequisites*: Android build system, knowledge of system security, advanced git
434
435
*Expected outcomes*: Integration or update of components of Replicant to tackle security issues
436 46 Denis 'GNUtoo' Carikli
437
h3. Fix the Free software distribution guidelines issues and improve the build system in Replicant 6.0
438
439
Replicant has some issues with "FSDG (Free System Distribution Guidelines)":https://www.gnu.org/distros/free-system-distribution-guidelines.html compliance: "F-droid":https://f-droid.org/ repository is not FSDG compliant anymore (Bug #1629), and Replicant can't be built from an FSDG distribution (Bug #1861). This ought to be fixed. Replicant should also be fixed to build without issue.
440 48 Denis 'GNUtoo' Carikli
441
It would also be nice to have the build system not depend on pre-built dependencies anymore, and to document which FSDG compliant F-droid applications crash because Replicant's incomplete EGL implementation (#705) and tag such applications as incompatible (so they are greyed out) until the EGL implemetation is fixed. Ideally Replicant builds should also be made "reproducible":https://en.wikipedia.org/wiki/Deterministic_compilation if they are not already.
442 46 Denis 'GNUtoo' Carikli
443
*Hardware requirements* : A computer that is able to build Replicant. A smartphone or tablet that is supported by Replicant to be able to test the result.
444
445
*Difficulty*: Easy
446
447
*Requirements/Prerequisites*: Knowledge of shell scripts and the ability to learn the Android build system
448 47 Denis 'GNUtoo' Carikli
449 21 Denis 'GNUtoo' Carikli
*Expected outcomes*: The ability to compile Replicant from "an FSDG distribution":https://www.gnu.org/distros/free-distros.html, F-droid only showing FSDG compliant software.
450 44 Denis 'GNUtoo' Carikli
451 3 Denis 'GNUtoo' Carikli
h2. Research
452 1 Denis 'GNUtoo' Carikli
453 23 Denis 'GNUtoo' Carikli
h3. Improve support for the free software compatible external WiFi adapter
454 36 Denis 'GNUtoo' Carikli
455
All devices currently supported by Replicant have WiFi chips that requires a non-free firmware to work. So to have WiFi working with free software, users need to use external WiFi adapters. They typically use tiny ath9k_htc compatible USB WiFi adapter along with a tiny USB OTG Host adapter.
456 1 Denis 'GNUtoo' Carikli
457 44 Denis 'GNUtoo' Carikli
Such external USB WiFi adapters used with Replicant are originally intended for laptops, not phones. As a result, they tend to consume a lot of power. According to lsusb some ath9k_htc compatible devices can consume up to 500mA.
458 1 Denis 'GNUtoo' Carikli
459 39 Denis 'GNUtoo' Carikli
This poses several issues:
460
* Some smartphones and tablets might not be compatible, at the hardware level, with such big power consumption.
461
* They can adversely impact battery life
462
463
Such USB WiFi adapters can also randomly stop working completely on some devices (e.g. needing to unplug and replug the adapter periodically to keep it operational).
464
465 1 Denis 'GNUtoo' Carikli
You will need to investigate reliability issues such as the one mentioned above and look how power consumption can be improved in the adapter firmware and/or kernel driver.
466 50 Denis 'GNUtoo' Carikli
467
You will also need to investigate how much miliampers USB devices can use, at the hardware level, on the smartphones and tablets Replicant supports.
468
469
*Hardware requirements* : An ath9k_htc compatible WiFi card, the ability to measure the current usage, the ability to build the ath9k_htc firmware and driver.
470
471 65 Denis 'GNUtoo' Carikli
*Difficulty*: Medium/Hard
472
473
*Requirements/Prerequisites*: Knowledge of C
474 66 Denis 'GNUtoo' Carikli
475 1 Denis 'GNUtoo' Carikli
*Expected outcomes*: Reliable WiFi with external WiFi adapter