Project

General

Profile

TasksFunding » History » Version 165

dl lud, 01/30/2019 08:21 PM
Reworked intro on graphics task.

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 149 Denis 'GNUtoo' Carikli
|_. Your name | Denis Carikli |
28
|_. Email address | [[PrivateContact#Email]] + our contact at the FSF |
29
|_. Phone numbers | GNUtoo's phone number |
30 108 Denis 'GNUtoo' Carikli
|_. Organisation | Replicant and the FSF |
31 149 Denis 'GNUtoo' Carikli
|_. Country | France(Denis Carikli), USA (FSF) |
32 95 Denis 'GNUtoo' Carikli
33
h4. General project information
34
35 150 Denis 'GNUtoo' Carikli
|_. Project name |  <Depend on the task>  |
36
|_. Website / wiki | <Depend on the task> |
37 151 Denis 'GNUtoo' Carikli
|_. Abstract: Can you explain the whole project and its expected outcome(s).(you have 1200 characters)
38 95 Denis 'GNUtoo' Carikli
Please be short and to the point in your answers; focus primarily on the what and how, not so much on the why.
39
Add longer descriptions as attachments (see below).
40
If English isn't your first language, don't worry - our reviewers don't care about spelling errors, only about great ideas.
41
On the up side, you can be as technical as you need to be (but you don't have to).
42 153 Denis 'GNUtoo' Carikli
Do stay concrete. | <Depend on the task> |
43 102 Denis 'GNUtoo' Carikli
|_. Have you been involved with projects or organizations relevant to this project before?
44 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:
45 102 Denis 'GNUtoo' Carikli
As a developer:
46 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.
47 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.
48
* I am also doing code reviews for patches.
49 145 Denis 'GNUtoo' Carikli
And for managing the project I'm involved in:
50 144 Denis 'GNUtoo' Carikli
* public relations (blog post, etc)
51 103 Denis 'GNUtoo' Carikli
* fund usage decisions
52 152 Denis 'GNUtoo' Carikli
* infrastructure (system administration with other developers, etc)
53 103 Denis 'GNUtoo' Carikli
* documentation
54
* project direction and strategic decisions |
55 95 Denis 'GNUtoo' Carikli
56
h4. Requested support
57
58 154 Denis 'GNUtoo' Carikli
|_. Requested Amount (Between 5000 and 50000 Euros) | <depends on the task> |
59 137 Denis 'GNUtoo' Carikli
|_. * Explain what the requested budget will be used for? | <depends on the task> |
60
|_. * Does the project have other funding sources, both past and present? | 
61 130 Denis 'GNUtoo' Carikli
The Replicant project has about 200000 dollars at disposition:
62 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.
63
* 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 |
64
|_. Compare your own project with existing or historical efforts. | <Depend on the task?> |
65
|_. What are significant technical challenges you expect to solve during the project, if any? | <Depend on the task?> |
66 138 Denis 'GNUtoo' Carikli
67
Describe the ecosystem of the project, and how you will engage with relevant actors and promote the outcomes?
68
<pre>
69 139 Denis 'GNUtoo' Carikli
The Replicant project contributors and the FSF will supervise
70
contractors to do the work.
71 1 Denis 'GNUtoo' Carikli
72 139 Denis 'GNUtoo' Carikli
I will write a blog post to anounce that the Replicant project
73
has got some funding for this specific task, and that it is
74
looking for a contractor to work on it. This is to make sure
75
that every one has equals chances in the application process.
76 1 Denis 'GNUtoo' Carikli
77 139 Denis 'GNUtoo' Carikli
Then the most suited contractor will be selected. Only contractors
78
that already have worked on similar tasks as part of free and open
79
source software projects will be chosen. This way we can look at
80
their existing contributions and make sure that they are able to
81
do the task before engaging with them.
82
Some people already involved in the Replicant project with proven
83
contributions, me included, are already interested about doing such
84
contract work, so finding someone suitable to work on the task
85
should not be an issue.
86 142 Denis 'GNUtoo' Carikli
87
The Replicant project will also make sure that the contractor has
88
or gets the hardware required to work on the task, before starting
89
to work on it.
90 138 Denis 'GNUtoo' Carikli
</pre>
91 96 Denis 'GNUtoo' Carikli
92 95 Denis 'GNUtoo' Carikli
|_. Attachments | None |
93
94
h4. How may we handle your information
95 98 Denis 'GNUtoo' Carikli
96
|_. What should we do in the other case,
97 95 Denis 'GNUtoo' Carikli
 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 |
98 98 Denis 'GNUtoo' Carikli
|_. Send me a copy of this application. | check-box checked |
99 94 Denis 'GNUtoo' Carikli
|_. PGP pubkey | None (if we use Replicant contact address, we can't encrypt to it) |
100 84 Denis 'GNUtoo' Carikli
101
h3. Discussions
102
103
There is "a thread about funding on the mailing list":https://lists.osuosl.org/pipermail/replicant/2019-January/001774.html about that
104 76 Denis 'GNUtoo' Carikli
105 38 Denis 'GNUtoo' Carikli
h2. Tasks that could be funded
106 77 Denis 'GNUtoo' Carikli
107 1 Denis 'GNUtoo' Carikli
h3. Port Replicant to a newer Android version
108 113 Denis 'GNUtoo' Carikli
109
Replicant is currently based on LineageOS 13 which is based on Android 6.0.
110
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:
111
* Replicant is currently lagging behind with security fixes
112
* Replicant cannot be built from a GNU/Linux distribution that follows the Free Software Distribution Guidelines
113
114
*Hardware requirements* :
115
* A computer that is able to build Replicant.
116
* A smartphone or tablet that can easily supported by the new version of Replicant and that meet Android 9 [[HardwareRequirements]].
117
118
*Expected outcomes*:
119
* Remove all proprietary components of LineageOS and make sure that Replicant follows the "Free Software Distributions Guidelines (FSDG)":https://www.gnu.org/distros/"
120
* Port all the changes needed to successfully boot without any proprietary software in Replicant
121
* Make sure that most of the security issues are fixed, and lower the attack surface if possible.
122
* 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/
123
* Rebrand LineageOS as Replicant
124
125
*Funding*: We could apply to https://nlnet.nl/PET
126
127 1 Denis 'GNUtoo' Carikli
h4. Subtasks
128
129 89 Denis 'GNUtoo' Carikli
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:
130 77 Denis 'GNUtoo' Carikli
* [[Tasks v2#Add support for devices with an upstream Linux kernel|Add support for devices with an upstream Linux kernel]]
131 80 Denis 'GNUtoo' Carikli
* [[Tasks v2#Add support for more recent smartphones|Add support for more recent smartphones]]
132 82 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]]
133 113 Denis 'GNUtoo' Carikli
* [[Tasks v2#Support in-system upgrades|Support in-system upgrades]]
134 78 Denis 'GNUtoo' Carikli
135
h4. Add support for devices with an upstream Linux kernel
136 57 Denis 'GNUtoo' Carikli
137 1 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:
138
139
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).
140
141
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.
142
143 89 Denis 'GNUtoo' Carikli
*Hardware requirements* :
144
In addition to the requirements for porting Replicant to a newer Android version:
145 1 Denis 'GNUtoo' Carikli
* 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.
146
147
*Difficulty*: Medium
148
149
*Requirements/Prerequisites*: Knowledge of C, some C++, the ability to understand Java, kernel interfaces knowledge
150 77 Denis 'GNUtoo' Carikli
151
*Expected outcomes*: 
152 1 Denis 'GNUtoo' Carikli
* 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.
153
154
h4. Add support for more recent smartphones
155
156
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.
157
158
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. 
159
160
It's advised to pick a device that:
161
* has an isolated modem (no shared memory between the modem and the processor running Android)
162
* meets Android 9 [[HardwareRequirements]] to still be useful when Replicant will be ported to Android 9
163
* has a modem that can easily be supported by samsung-ril and libsamsung-ipc 
164
* is or will be supported by lineageOS
165
166
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.
167 90 Denis 'GNUtoo' Carikli
168
*Hardware requirements*:
169 92 Denis 'GNUtoo' Carikli
In addition to the requirements for porting Replicant to a newer Android version: 
170 90 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.
171 1 Denis 'GNUtoo' Carikli
172
*Difficulty*: Medium
173
174
*Expected outcomes*: 
175 78 Denis 'GNUtoo' Carikli
* 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.
176
177 1 Denis 'GNUtoo' Carikli
h4. Add support for the devices supported in Replicant 6.0 and 4.2
178
179
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.
180
181
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.
182
183
*Hardware requirements and dependencies*:
184
In addition to the requirements for porting Replicant to a newer Android version:
185
* The port to the new Android version needs to be complete for at least one device before starting to work on this.
186
* All the devices will need to be shipped to (or acquired by) the person working on this task before starting to work on this.
187
188
*Expected outcomes*: 
189
* 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)
190
* 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.
191
192
*Difficulty*: Medium
193
194
h4. Support in-system upgrades
195
196
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.
197
198
Whenever possible, it would be useful to complete and submit some of the code written for Replicant to LineageOS.
199
200 78 Denis 'GNUtoo' Carikli
*Difficulty*: Medium
201
202
*Expected outcomes*: 
203 119 Denis 'GNUtoo' Carikli
* In-system updates working without being connected to a PC
204
205
h4. nlnet Grant application
206
207
|_. Project name | Port Replicant to a newer Android version |
208
|_. Website / wiki | https://redmine.replicant.us/projects/replicant/wiki/Tasks_funding#Port-Replicant-to-a-newer-Android-version |
209 125 Denis 'GNUtoo' Carikli
210
Abstract: Can you explain the whole project and its expected outcome(s).in 1200 characters
211 128 Denis 'GNUtoo' Carikli
<pre>
212 131 Denis 'GNUtoo' Carikli
Replicant is a fully free software Android distribution which
213 1 Denis 'GNUtoo' Carikli
is approved by the FSF (http://gnu.org/distros).
214
215 128 Denis 'GNUtoo' Carikli
The combination of Android Open Source Project source code with
216
the Linux source code provided by the device vendor is not
217
sufficient to produce a fully free Android distribution that
218
works: A lot of the code that makes critical hardware component
219 147 Denis 'GNUtoo' Carikli
work (the modem, graphics, audio, GPS, etc) is in userspace.
220
Because of that most device manufacturers don't release them as
221 1 Denis 'GNUtoo' Carikli
free software.
222 131 Denis 'GNUtoo' Carikli
223
To make such hardware work, the Replicant project manages to
224 1 Denis 'GNUtoo' Carikli
replace or avoid such nonfree software.
225 128 Denis 'GNUtoo' Carikli
226 127 Denis 'GNUtoo' Carikli
Replicant is currently based on LineageOS 13.0 which in turn is based
227
on Android 6.0.1 which are both not supported anymore. Replicant is
228
based on LineageOS because it supports many more smartphones and
229
tablets than the Android Open Source Project.
230 131 Denis 'GNUtoo' Carikli
231
The project consists in porting Replicant changes on top of the
232
"Android 9" release of the Android Open Source project,
233
and when LineageOS 16 will be ready, to backport our changes on
234 125 Denis 'GNUtoo' Carikli
top of LineageOS 16.
235 119 Denis 'GNUtoo' Carikli
</pre> 
236
237
|_. Have you been involved with projects or organizations relevant to this project before?
238
And if so, can you tell us a bit about your contributions? | SEE TEMPLATE |
239
240
|_. Requested Amount (Between 5000 and 50000 Euros) | 50000 Euros |
241 133 Denis 'GNUtoo' Carikli
|_. Does the project have other funding sources, both past and present? | SEE TEMPLATE |
242
243
Explain what the requested budget will be used for? 
244 134 Denis 'GNUtoo' Carikli
<pre>
245 140 Denis 'GNUtoo' Carikli
The budget will only be used to fund this task through contract work.
246 134 Denis 'GNUtoo' Carikli
247 133 Denis 'GNUtoo' Carikli
However it is difficult to evaluate precisely the amount of time such work
248
will take as sometime bugs can slow down a lot that kind of work.
249 143 Denis 'GNUtoo' Carikli
For instance, when adding support for the Nexus One to Replicant,
250 135 Denis 'GNUtoo' Carikli
a lot of time was spent dealing with display issues that didn't affect
251 133 Denis 'GNUtoo' Carikli
the upstream projects, because they relied on the GPU which required
252
nonfree software to work.
253
254
We think it will take something between 2 and 6 month of work
255
for one full time developer.
256 136 Denis 'GNUtoo' Carikli
257 155 Denis 'GNUtoo' Carikli
If we take the cost of a Freelance developer in the USA (75$ to 150$
258
per hour) as a basis, to enable people living in Europe and the USA
259
to apply, we can fund a developer to work on it for a period that
260
is mostly equivalent to something between 2 to 4 months full
261
time.
262 1 Denis 'GNUtoo' Carikli
263 155 Denis 'GNUtoo' Carikli
We also have at least one volunteer that wants to work on it at the
264 156 Denis 'GNUtoo' Carikli
same time, but that cannot do it full time. So the contractor will
265
also need to adapt his/her working hours to best collaborate with the
266
volunteers if that is more efficient.
267 155 Denis 'GNUtoo' Carikli
268
If the work is not done when the 50000 run out, and that we cannot
269
make sure that it will be completed by volunteers in a time that is
270
not too long, the Replicant project will most probably fund contract
271
work to make sure that this task is completed.
272
273 157 Denis 'GNUtoo' Carikli
The Replicant project will also take care of making sure that the
274
people that will work on this task have the necessary hardware to
275
do it, for instance by shipping or reimbursing the purchase of a
276
compatible smartphone with the Replicant project money.
277
278 155 Denis 'GNUtoo' Carikli
If the work is already done before the 50000 run out, we will continue
279
funding contract work with it, to add support for most the smartphones
280
we currently support in Replicant, to add support for more
281
recent smartphones (the most recent one we currently support has
282
been released in 2013).
283
284 141 Denis 'GNUtoo' Carikli
We also need to enable Replicant to use upstream Linux kernels in order
285
to support devices with free software bootloaders like the NC_1 from
286
Necuno Solutions, and to lower the time required to maintain Replicant.
287 155 Denis 'GNUtoo' Carikli
So if there is still some money left, we will use it to fund work to add
288
support for upstream kernels in the new Replicant version.
289 146 Denis 'GNUtoo' Carikli
</pre>
290
291 148 Denis 'GNUtoo' Carikli
Compare your own project with existing or historical efforts.
292
<pre>
293
This usually took about 2 or 3 months of full-time equivalent work for one person.
294 146 Denis 'GNUtoo' Carikli
However the Android architecture changed a lot more between Android 6.0.1 and
295 132 Denis 'GNUtoo' Carikli
Android 9 than it did when we ported Replicant to newer Android versions.
296
</pre>
297
298
What are significant technical challenges you expect to solve during the project, if any?
299
<pre>
300
To upgrade Replicant to a new Android release, we need to
301
adapt our free software replacement, and to find ways to not
302
depend on the nonfree software that we didn't replace
303
yet (like GPU drivers). We for instance had to find ways to
304
make Replicant graphics fast enough without being able to use
305
the GPU, as there is no free software GPU driver for some of
306
the devices we support.
307
308
Android has also changed a lot since Android 6.0.1: It has been
309
re-architectured to provide a more stable interface for userspace 
310 119 Denis 'GNUtoo' Carikli
hardware support code.
311 76 Denis 'GNUtoo' Carikli
</pre>
312
313
|_. Describe the ecosystem of the project, and how you will engage with relevant actors and promote the outcomes? | SEE TEMPLATE |
314
|_. Attachments | SEE TEMPLATE |
315
316
h3. Implement the missing features of Samsung-RIL
317
318
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).
319
320
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.
321
322
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).
323
324
*Hardware requirements* : A computer that is able to build Replicant. A smartphone or tablet supported by Samsung-RIL.
325
326
*Difficulty*: Medium to Hard
327
328
*Requirements/Prerequisites*: Knowledge of C.
329
330
*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.
331
332
*Dependencies*: This task should be fairly independent as:
333
* [[Libsamsung-ipc]] should already be independent of the Android version (it can even run on GNU/Linux)
334
* [[Samsung-RIL]] can probably easily be adapted to newer Android version
335
336
*Funding*: We could apply to https://nlnet.nl/PET
337
338
h3. Implement a fully-featured QMI-RIL
339
340
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.
341
342
*Hardware requirements* : A computer that is able to build Replicant. A smartphone or tablet supported by QMI-RIL like the Galaxy SIII 4G (i9305).
343
344
*Difficulty*: Hard
345
346
*Requirements/Prerequisites*: Knowledge of C.
347
348
*Expected outcomes*: A QMI-RIL that supports voice calls, SMS, and data, with as complete a protocol implementation as possible.
349
350
*Dependencies*: This task should be fairly independent as:
351 59 Denis 'GNUtoo' Carikli
* The lower layers should already be independent of the Android version as they are used under GNU/Linux
352
* [[QMI-RIL]] can probably easily be adapted to newer Android version
353
354
*Funding*: We could apply to https://nlnet.nl/PET
355
356
h3. Finish to port the Galaxy S 2 (I9100), Galaxy S 3 (I9300) and Galaxy Note 2 (N7100) to Mainline Linux
357
358
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.
359
360
*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.
361
362
*Difficulty*: Medium
363
364 105 Denis 'GNUtoo' Carikli
*Requirements/Prerequisites*: C programming language, driver development
365 68 Denis 'GNUtoo' Carikli
366 104 Denis 'GNUtoo' Carikli
*Expected outcomes*: Audio working, modem working, and Replicant or LineageOS booting with mainline Linux.
367
368 165 dl lud
h3. Graphics acceleration
369 1 Denis 'GNUtoo' Carikli
370 165 dl lud
Currently, all supported devices on Replicant lack a free software driver for their GPU. This means that OpenGL ES (GLES) rendering must be done on the CPU (software rendering). The current approach to software rendering on Replicant 6 is based on "libAGL":https://android.googlesource.com/platform/frameworks/native/+/master/opengl, an optimized GLES 1.x implementation that uses "libpixelflinger":https://android.googlesource.com/platform/system/core/+log/master/libpixelflinger software renderer. Development on both these libraries ceased in 2013 and no work was done to support newer GLES versions.
371
The major consequences of this are that:
372
- Critical applications like web browsers crash due to lack of GLES 2.x. Replicant currently uses an out-dated browser that has many security flaws.
373
- Replicant relies on patches to the Android framework to make things like the camera application work.
374
- The rendering speed has degraded over the newer Android versions like Android 6. Even applications that do not crash become difficult to use due to the huge rendering delays.
375 158 Denis 'GNUtoo' Carikli
376 165 dl lud
This task aims to fix all these severe issues by working in parallel with the Android 9 port and leveraging new graphics functionalities present in Android 9 like X, Y and Z. On Android 9 it should be easy to use "SwiftShader":https://swiftshader.googlesource.com/SwiftShader, Google's current software renderer that is capable of full GLES 2.x.
377 1 Denis 'GNUtoo' Carikli
378 165 dl lud
Unfortunately Android 9 doesn't have a gralloc library for software rendering that is compatible with hwcomposer. There are patches to work around that and have a gralloc library that uses the framebuffer interface, however this has very bad consequences on performance. This is also not an approach compatible with upstream projects as they have dropped support for the framebuffer interface.
379 1 Denis 'GNUtoo' Carikli
380 165 dl lud
The major and first goal of this task is thus to write a hwcomposer compatible gralloc library that has decent performance on software rendering. If used in conjunction with SwiftShader, this new graphics' stack should enable full GLES 2.x support on Replicant with a decent performance.
381
382 162 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.
383 1 Denis 'GNUtoo' Carikli
384 165 dl lud
*Expected outcomes*: Write a hwcomposer compatible gralloc that has decent performance on software rendering
385 1 Denis 'GNUtoo' Carikli
386 162 Denis 'GNUtoo' Carikli
*Difficulty*: Medium / Hard
387
388 163 Denis 'GNUtoo' Carikli
*Requirements/Prerequisites*: Knowledge of C++, kernel interfaces knowledge or the ability to learn them
389 162 Denis 'GNUtoo' Carikli
390
*Expected outcomes*:
391 165 dl lud
* Working GLES 2.x implementation
392
* Fast enough graphics
393
* F-Droid applications not crashing anymore because of GLES.
394 162 Denis 'GNUtoo' Carikli
395
*Funding*: We could apply to https://nlnet.nl/PET
396 158 Denis 'GNUtoo' Carikli
397 164 Denis 'GNUtoo' Carikli
h4. Subtasks
398
399
The following sub-tasks could also be worked on after finishing writing the gralloc:
400
* [[Tasks_funding#llvmpipe optimizations|llvmpipe optimizations]]
401 158 Denis 'GNUtoo' Carikli
402
h4. llvmpipe optimizations
403 159 Denis 'GNUtoo' Carikli
404 104 Denis 'GNUtoo' Carikli
Replicant 6 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).
405 1 Denis 'GNUtoo' Carikli
406 106 Denis 'GNUtoo' Carikli
"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.
407 68 Denis 'GNUtoo' Carikli
408 1 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.
409 68 Denis 'GNUtoo' Carikli
410 104 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.
411 68 Denis 'GNUtoo' Carikli
412
*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.
413
414 165 dl lud
*Difficulty*: Medium / Hard (depending on the amount of optimizations required)
415 72 Denis 'GNUtoo' Carikli
416
*Requirements/Prerequisites*: See with the MESA project
417
418
*Expected outcomes*:
419 68 Denis 'GNUtoo' Carikli
* Working EGL implementation
420 107 Denis 'GNUtoo' Carikli
* fast enough graphics
421
* F-droid applications not crashing anymore because of EGL.
422 86 Denis 'GNUtoo' Carikli
423 1 Denis 'GNUtoo' Carikli
*Funding*: We could apply to https://nlnet.nl/PET
424 86 Denis 'GNUtoo' Carikli
425 85 Denis 'GNUtoo' Carikli
h1. Other tasks
426
427
h2. Tasks that are being defined
428
429
h3. Test infrastructure
430
431
Having an automated build and test infrastructure would be very beneficial for Replicant.
432
433
Issues:
434
* Running costs of such infrastructure have to be kept low, not to depend on continuous flow of money
435
436
h3. Documentation
437
438
A lot of time is spent on the wiki documentation, and a lot of information is redundant (for instance the installation guide)
439
440
TODO:
441
* Research documentation systems
442 63 Denis 'GNUtoo' Carikli
* Research the technical knowledge required to use them
443
* Look into communities like RockBox on the benefit of non-wiki documentation
444
* Look if transitioning to non-wiki documentation would make the Replicant Project loose its contributors to the documentation
445
446 59 Denis 'GNUtoo' Carikli
h2. Devices with 512M of RAM or less
447
448
We might want to consider Android 9 [[HardwareRequirements]] before working on that
449
450
h3. Advance the Optimus Black U-Boot and Linux mainline ports
451
452
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.
453
454
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.
455
456
*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.
457
458
*Difficulty*: Medium to Hard
459 1 Denis 'GNUtoo' Carikli
460 61 Denis 'GNUtoo' Carikli
*Requirements/Prerequisites*: C programming language, driver development
461
462
*Expected outcomes*: Improved hardware support for the Optimus Black in U-Boot and Linux
463
464
h3. Advance the Kindle Fire (first generation) U-Boot and Linux mainline ports
465
466
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.
467
468
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.
469
470
*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.
471
472
*Difficulty*: Medium
473
474 62 Denis 'GNUtoo' Carikli
*Requirements/Prerequisites*: C programming language, driver development
475
476
*Expected outcomes*: Improved hardware support for the Kindle Fire (first generation) in U-Boot and Linux
477
478
h3. Select and/or port a tablet with an Allwinner SOC to mainline Linux and U-boot, and Replicant
479
480 67 Denis 'GNUtoo' Carikli
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.
481
482
The chosen tablet should have:
483
* 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.
484
* A Free software bootloader, or the ability to easily add support for the tablet to a free software bootloader.
485
* The ability to power and use an USB WiFi card or chip that is compatible with the ath9k_htc driver.
486
487
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.
488
489
*Hardware requirements* : A computer that is able to build Replicant. An Allwinner tablet, a serial port adapter to get the kernel boot logs.
490
491
*Difficulty*: Medium
492
493 56 Denis 'GNUtoo' Carikli
*Requirements/Prerequisites*: C programming language, driver development
494 3 Denis 'GNUtoo' Carikli
495 55 Denis 'GNUtoo' Carikli
*Expected outcomes*: Replicant support for a tablet using an Allwinner SOC, with free software bootloader and mainline based Linux kernel.
496
497 43 Denis 'GNUtoo' Carikli
h2. Tasks for Replicant 6.0
498
499
h3. Tackle security issues in Replicant 6.0
500
501
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.
502
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.
503
504
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.
505
506 1 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.
507 43 Denis 'GNUtoo' Carikli
508
*Difficulty*: Medium-Hard
509
510 46 Denis 'GNUtoo' Carikli
*Requirements/Prerequisites*: Android build system, knowledge of system security, advanced git
511
512
*Expected outcomes*: Integration or update of components of Replicant to tackle security issues
513
514 48 Denis 'GNUtoo' Carikli
h3. Fix the Free software distribution guidelines issues and improve the build system in Replicant 6.0
515
516 46 Denis 'GNUtoo' Carikli
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.
517
518
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.
519
520
*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.
521
522 47 Denis 'GNUtoo' Carikli
*Difficulty*: Easy
523 21 Denis 'GNUtoo' Carikli
524 44 Denis 'GNUtoo' Carikli
*Requirements/Prerequisites*: Knowledge of shell scripts and the ability to learn the Android build system
525 3 Denis 'GNUtoo' Carikli
526 1 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.
527 23 Denis 'GNUtoo' Carikli
528 36 Denis 'GNUtoo' Carikli
h2. Research
529
530 1 Denis 'GNUtoo' Carikli
h3. Improve support for the free software compatible external WiFi adapter
531 44 Denis 'GNUtoo' Carikli
532 1 Denis 'GNUtoo' Carikli
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.
533 39 Denis 'GNUtoo' Carikli
534
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.
535
536
This poses several issues:
537
* Some smartphones and tablets might not be compatible, at the hardware level, with such big power consumption.
538
* They can adversely impact battery life
539 1 Denis 'GNUtoo' Carikli
540 50 Denis 'GNUtoo' Carikli
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).
541
542
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.
543
544
You will also need to investigate how much miliampers USB devices can use, at the hardware level, on the smartphones and tablets Replicant supports.
545 65 Denis 'GNUtoo' Carikli
546
*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.
547
548 66 Denis 'GNUtoo' Carikli
*Difficulty*: Medium/Hard
549 1 Denis 'GNUtoo' Carikli
550
*Requirements/Prerequisites*: Knowledge of C
551
552
*Expected outcomes*: Reliable WiFi with external WiFi adapter