Project

General

Profile

TasksFunding » History » Version 260

Denis 'GNUtoo' Carikli, 06/05/2019 05:12 PM

1 1 Denis 'GNUtoo' Carikli
{{>toc}}
2
3 181 Denis 'GNUtoo' Carikli
h1. Funding
4 1 Denis 'GNUtoo' Carikli
5 181 Denis 'GNUtoo' Carikli
h2. Funding procedure
6
7 258 Denis 'GNUtoo' Carikli
h3. Background and rationale for funding work through the NLnet foundation
8
9
The NLnet foundation managed to get some European Union grants to fund work on privacy and trust technologies.
10
11
It's then up to individuals to apply to it, and to define tasks that can improve privacy and trust on the Internet, which then the NLnet foundation can choose to fund.
12
13 260 Denis 'GNUtoo' Carikli
This could for instance be used to fund the advancement of software (Tor, Replicant, etc) and hardware freedom (RISC-V, etc).
14 258 Denis 'GNUtoo' Carikli
15
The only requirement (beside improving privacy and trust) seem to be that the individuals have to be located in the European Union. 
16
17 1 Denis 'GNUtoo' Carikli
They are then paid once tasks defined and/or the deliverables mentioned in the task have been completed.
18 260 Denis 'GNUtoo' Carikli
19
The NLnet foundation also have some resources to help pushing changes upstream and try to push the applicants into making their work as useful as possible by engaging with upstream communities.
20 258 Denis 'GNUtoo' Carikli
21
References:
22
* "Fosdem Lightning talks on the topic":https://fosdem.org/2019/schedule/event/nextgen_internet/
23
24 259 Denis 'GNUtoo' Carikli
h3. Tasks accepted for funding by the NLnet foundation
25 186 Denis 'GNUtoo' Carikli
26 247 Denis 'GNUtoo' Carikli
* [[Tasks_funding#"Finish porting Replicant to a newer Android version" nlnet Grant application|Finish porting Replicant to a newer Android version]]
27 248 Denis 'GNUtoo' Carikli
* [[TasksFunding#Graphics-acceleration|Graphics acceleration]]
28 84 Denis 'GNUtoo' Carikli
29
h3. Applicant criteria
30
31 249 Denis 'GNUtoo' Carikli
* -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.-
32
* -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.-
33
* -The applicants will need to be able to do contract work-
34
35
The application criteria wrere handled by the NLnet foundation.
36 93 Denis 'GNUtoo' Carikli
37 84 Denis 'GNUtoo' Carikli
h3. Discussions
38
39
There is "a thread about funding on the mailing list":https://lists.osuosl.org/pipermail/replicant/2019-January/001774.html about that
40 76 Denis 'GNUtoo' Carikli
41 257 Denis 'GNUtoo' Carikli
h3. Mistakes
42
43
When submitting a task to the NLnet Foundation:
44
* Make sure to select a call in "Please select a call", like "NGI Privacy & Trust Enhancing Technologies"
45
46 250 Denis 'GNUtoo' Carikli
h2. Port Replicant to a newer Android version
47 113 Denis 'GNUtoo' Carikli
48
Replicant is currently based on LineageOS 13 which is based on Android 6.0.
49
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:
50
* Replicant is currently lagging behind with security fixes
51
* Replicant cannot be built from a GNU/Linux distribution that follows the Free Software Distribution Guidelines
52
53
*Hardware requirements* :
54
* A computer that is able to build Replicant.
55
* A smartphone or tablet that can easily supported by the new version of Replicant and that meet Android 9 [[HardwareRequirements]].
56
57
*Expected outcomes*:
58
* Remove all proprietary components of LineageOS and make sure that Replicant follows the "Free Software Distributions Guidelines (FSDG)":https://www.gnu.org/distros/"
59
* Port all the changes needed to successfully boot without any proprietary software in Replicant
60
* Make sure that most of the security issues are fixed, and lower the attack surface if possible.
61
* 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/
62
* Rebrand LineageOS as Replicant
63
64 254 Denis 'GNUtoo' Carikli
*Funding*: We applied to https://nlnet.nl/PET
65 251 Denis 'GNUtoo' Carikli
66 254 Denis 'GNUtoo' Carikli
h3. NLnet foundation Grant application for "Finish porting Replicant to a newer Android version"
67 253 Denis 'GNUtoo' Carikli
68
h4. Contact information:
69
70
|_. Your name | Denis Carikli |
71
|_. Email address | [[PrivateContact#Email]] + our contact at the FSF |
72
|_. Phone numbers | GNUtoo's phone number |
73
|_. Organisation | Replicant and the FSF |
74
|_. Country | France(Denis Carikli), USA (FSF) |
75
76
h4. General project information
77
78 125 Denis 'GNUtoo' Carikli
|_. Project name | Finish porting Replicant to a newer Android version |
79 128 Denis 'GNUtoo' Carikli
|_. Website / wiki | https://redmine.replicant.us/projects/replicant/wiki/Porting_Replicant_to_Android_9 |
80 253 Denis 'GNUtoo' Carikli
|_. Abstract: Can you explain the whole project and its expected outcome(s).in 1200 characters | <pre>
81 196 Denis 'GNUtoo' Carikli
Replicant is a fully free software Android distribution which
82 1 Denis 'GNUtoo' Carikli
is approved by the FSF (http://gnu.org/distros).
83 196 Denis 'GNUtoo' Carikli
84
The combination of Android Open Source Project source code with
85
the Linux source code provided by the device vendor is not
86 216 Denis 'GNUtoo' Carikli
sufficient to produce a fully free Android distribution that
87 196 Denis 'GNUtoo' Carikli
works: a lot of the code that makes critical hardware components
88 216 Denis 'GNUtoo' Carikli
work (the modem, graphics, audio, GPS, etc) is in userspace.
89 196 Denis 'GNUtoo' Carikli
Because of that, most device manufacturers don't release them as
90 195 Denis 'GNUtoo' Carikli
free software.
91 196 Denis 'GNUtoo' Carikli
92
To make such hardware work, the Replicant project manages to
93 216 Denis 'GNUtoo' Carikli
replace or avoid such nonfree software.
94 196 Denis 'GNUtoo' Carikli
95
Replicant is currently based on LineageOS 13.0 which in turn is based
96 216 Denis 'GNUtoo' Carikli
on Android 6.0.1 which are both not supported anymore. Replicant is
97 196 Denis 'GNUtoo' Carikli
based on LineageOS because it supports way more smartphones and
98
tablets than the Android Open Source Project.
99 1 Denis 'GNUtoo' Carikli
100
The project consists in porting Replicant changes on top of the
101
Android 9 release of the Android Open Source project,
102
and when LineageOS 16 will be ready, to backport our changes on
103
top of LineageOS 16.
104 253 Denis 'GNUtoo' Carikli
</pre> |
105 1 Denis 'GNUtoo' Carikli
|_. Have you been involved with projects or organizations relevant to this project before?
106 253 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:
107
As a developer:
108
* I did most/all the initial system work and made it work for the the HTC Dream, and the Google Nexus One.
109
* 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.
110
* I am also doing code reviews for patches.
111
And as for managing the project I'm involved in:
112
* public relations (blog posts, etc)
113
* fund usage decisions
114
* infrastructure (system administration with other developers, etc)
115
* documentation
116
* project direction and strategic decisions |
117 1 Denis 'GNUtoo' Carikli
118 253 Denis 'GNUtoo' Carikli
h4. Requested support
119
120 140 Denis 'GNUtoo' Carikli
|_. Requested Amount (Between 5000 and 50000 Euros) | 50000 Euros |
121 253 Denis 'GNUtoo' Carikli
|_. Does the project have other funding sources, both past and present? | 
122
The Replicant project has about 200000 dollars at disposition:
123
* 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.
124
* 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 |
125 190 Denis 'GNUtoo' Carikli
126
Explain what the requested budget will be used for? 
127
<pre>
128 189 Denis 'GNUtoo' Carikli
The budget will only be used to fund this task through contract work.
129 217 Denis 'GNUtoo' Carikli
130 133 Denis 'GNUtoo' Carikli
We think it will take something between 3 and 6 months of work
131
for one full time developer.
132
133 217 Denis 'GNUtoo' Carikli
However it is always difficult to evaluate precisely the amount of time
134
that this kind of project would take as sometimes it can be slowed down
135 155 Denis 'GNUtoo' Carikli
a lot due to bugs needing to be fixed.
136
137
For instance, when adding support for the Nexus One to Replicant,
138
a lot of time was spent dealing with display issues that didn't affect
139 1 Denis 'GNUtoo' Carikli
the upstream projects, because they relied on the GPU which required
140
nonfree software to work.
141
142
If we take the cost of a Freelance developer in the USA (75$ to 150$
143
per hour) as a basis, to enable people living in Europe and the USA
144
to apply, we can fund a developer to work on it for a period that
145
is mostly equivalent to something between 2 to 4 months full
146
time.
147 169 Denis 'GNUtoo' Carikli
148
So far we have at least one person interested in working on it
149
as a contractor (me), and one volunteer who wants to work on it at the
150
same time, but who cannot do it full time. We will make sure
151 155 Denis 'GNUtoo' Carikli
that everybody has a chance to apply for doing contract work.
152
153
If the work is not done when the 50000E run out, and if we cannot
154 217 Denis 'GNUtoo' Carikli
make sure that it will be completed by volunteers in a reasonable
155
timeframe, the Replicant project will most probably use its existing
156
funds to pay for contract work to make sure that this task is completed.
157
158 155 Denis 'GNUtoo' Carikli
The Replicant project will also take care of ensuring that the
159 217 Denis 'GNUtoo' Carikli
people that will work on this task have the necessary hardware to
160
do it, for instance by shipping or reimbursing the purchase of a
161
compatible smartphone with the Replicant project money.
162 191 Denis 'GNUtoo' Carikli
163
Once we have the Samsung Galaxy SIII fully working with
164 217 Denis 'GNUtoo' Carikli
Replicant 9, we will add support for most smartphones
165 191 Denis 'GNUtoo' Carikli
and tablets we currently support in Replicant, and add support
166
for more recent smartphones (the most recent one we currently
167 171 Denis 'GNUtoo' Carikli
support has been released in 2013).
168 1 Denis 'GNUtoo' Carikli
169 217 Denis 'GNUtoo' Carikli
We also have a very basic documentation on the Android 9 port here:
170
https://redmine.replicant.us/projects/replicant/wiki/Porting_Replicant_to_Android_9
171
</pre>
172 1 Denis 'GNUtoo' Carikli
173 217 Denis 'GNUtoo' Carikli
Compare your own project with existing or historical efforts.
174 168 Denis 'GNUtoo' Carikli
<pre>
175
Upgrading Replicant to a new Android version usually took about 2 or 3
176
months of full-time equivalent work for one person.
177 170 Denis 'GNUtoo' Carikli
Here, we already have a device (The Galaxy SIII 4G) booting under Android 9
178
master before the release, with a kernel that is closely based on upstream
179
Linux, but a lot still needs to be done (modem, audio, sensors, etc) and
180 132 Denis 'GNUtoo' Carikli
validated. The Android architecture also changed a lot more between Android
181
6.0.1 and Android 9 than it did when we ported Replicant to newer Android
182 217 Denis 'GNUtoo' Carikli
versions.
183
</pre>
184
185
What are significant technical challenges you expect to solve during the project, if any?
186
<pre>
187 76 Denis 'GNUtoo' Carikli
We will also need to make sure that Replicant 9 can be built with a
188
GNU/Linux distribution that is approved by the FSF. This could be
189
challenging if they lack some of the packages required to build Android.
190 1 Denis 'GNUtoo' Carikli
</pre>
191
192
Describe the ecosystem of the project, and how you will engage with relevant actors and promote the outcomes?
193
<pre>
194
This project will re-use code from several projects such as Android,
195
drm-hwcomposer, Mesa and Lima driver. Whenever possible we will foster
196
collaboration with these projects and submit our changes upstream.
197
198
The Replicant project contributors and the FSF will supervise
199 253 Denis 'GNUtoo' Carikli
contractors to do the work.
200
201
A blog post will announce that the Replicant project
202
has got some funding for this specific task, and that it is
203
looking for a contractor to work on it. This is to make sure
204
that everyone has equal chances in the application process.
205
206
Then the most suited contractor will be selected. Only contractors
207
that already have worked on similar tasks as part of free and open
208
source software projects will be chosen. This way we can look at
209
their existing contributions and make sure that they are able to
210
do the task before engaging with them.
211
212
The Replicant project will also make sure that the contractor has
213
or gets the hardware required to work on the task, before starting
214
to work on it.</pre>
215
216
|_. Attachments | None |
217 256 Denis 'GNUtoo' Carikli
218
h4. How may we handle your information
219
220
|_. What should we do in the other case,
221
 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 |
222
|_. Send me a copy of this application. | check-box checked |
223
|_. PGP pubkey | None (if we use Replicant contact address, we can't encrypt to it) |
224 250 Denis 'GNUtoo' Carikli
225 165 dl lud
h2. Graphics acceleration
226 1 Denis 'GNUtoo' Carikli
227 173 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.
228 226 dl lud
The major consequences of this are that:
229 173 dl lud
* Critical applications like web browsers crash due to lack of GLES 2.0 (#705). Replicant currently uses an out-dated browser that has many security flaws.
230 1 Denis 'GNUtoo' Carikli
* Replicant relies on patches to the Android framework to make things like the camera application work.
231 166 dl lud
* 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.
232 235 dl lud
233 1 Denis 'GNUtoo' Carikli
This task aims to fix all these severe issues by putting together a new graphics stack for the Android 9 port. This new graphics stack must be compatible with Android 9 Hardware Abstraction Layers (HAL) and provide at least GLES 2.0 rendering. It should be flexible enough to do software rendering with "Mesa":https://www.mesa3d.org/intro.html or "SwiftShader":https://swiftshader.googlesource.com/SwiftShader (Google's current software renderer), and also GPU rendering on devices where a free GPU driver is available.
234 235 dl lud
235 1 Denis 'GNUtoo' Carikli
"Joonas Kylmälä":https://redmine.replicant.us/users/8585 has done some introductory work on the Android 9 port for the i9305, and found a way to have it rendering to the screen. He put together a graphics stack composed of: gbm_gralloc ("Gralloc HAL":https://source.android.com/devices/graphics/implement#gralloc_hal) + drm_hwcomposer ("Hardware Composer HAL":https://source.android.com/devices/graphics/implement#hardware_composer_hal) + Mesa with kms_swrast driver with softpipe backend (CPU software renderer for GLES). This will be the starting point for this task.
236 235 dl lud
237 1 Denis 'GNUtoo' Carikli
Joonas' prototype shows that Replicant can use "gbm_gralloc":https://osdn.net/projects/android-x86/scm/git/external-gbm_gralloc/summary, an existing graphics memory allocator (gralloc) HAL maintained(ish) by Android-x86, in conjunction with "drm-hwcomposer":https://gitlab.freedesktop.org/drm-hwcomposer/drm-hwcomposer, a libre implementation of Android's Hardware Composer HAL based on Linux's DRM, to achieve software rendering with Mesa. This solution avoids the need to write a custom gralloc for Replicant, and takes advantage of the hardware acceleration for composition provided by drm-hwcomposer on devices with a free software DRM driver (e.g. exynos-based smartphones and tablets).
238 236 dl lud
239 237 dl lud
Much more testing is needed to confirm that gbm_gralloc can be the definitive gralloc HAL on Replicant 9. It still wasn't tried with SwiftShader, or even Mesa's llvmpipe backend, which is a must since the softpipe backend is too slow to be usable.
240 235 dl lud
Joonas' tests showed that some other components will need our attention, mostly the drm/exynos driver. In order to make drm/exynos work with gbm_gralloc and drm-hwcomposer Joonas had to disable "DRM-Auth":https://en.wikipedia.org/wiki/Direct_Rendering_Manager#DRM-Master_and_DRM-Auth and hack some missing pixel formats into it by using the default pixel format for everything. Besides drm/exynos, we will also have to make the graphics stack work with the "virtual GEM (vGEM) driver":https://www.phoronix.com/scan.php?page=news_item&px=DRM-vGEM-Mesa-Software, in order to support devices that lack a real drm driver.
241
242
The major and first goal of this task is thus to build upon Joonas's prototype and put together a stable and fully free graphics stack, compatible with GLES 2.0, that does software rendering through Mesa's llvmpipe with a decent performance.
243 1 Denis 'GNUtoo' Carikli
244 165 dl lud
*Hardware requirements*: A computer that is able to build Replicant. A Samsung Galaxy S3 or S3 4G to run the [[Porting_Replicant_to_Android_9|current Replicant 9 port]].
245 1 Denis 'GNUtoo' Carikli
246
*Difficulty*: Medium / Hard
247
248
*Requirements/Prerequisites*: Knowledge of C++, kernel interfaces knowledge or the ability to learn them
249
250 235 dl lud
*Expected outcomes*:
251 226 dl lud
* Graphics stack with decent performance on software rendering
252 1 Denis 'GNUtoo' Carikli
* Working GLES 2.0 implementation
253
* Fast enough graphics
254 209 dl lud
* F-Droid applications not crashing anymore because of GLES.
255 1 Denis 'GNUtoo' Carikli
256 210 dl lud
*Time +estimation+*:
257 1 Denis 'GNUtoo' Carikli
258 237 dl lud
|_. Step |_. man-hours |
259
| Set up the development environment, including the current Replicant 9 port on the test device. |>. 24 |
260
| Read AOSP documentation and understand all details of the graphics stack. |>. 16 |
261
| Adapt the build files to use Mesa's llvmpipe backend instead of softpipe. Fix potential LLVM version incompatibilities between Mesa and Android. |>. 40 |
262
| Properly implement the missing pixel formats in drm/exynos and try to have it merged into upstream. |>. 72 |
263
| Find a proper way to use DRM-Master and DRM-Auth with gbm_gralloc and drm-hwcomposer. |>. 40 |
264 238 dl lud
| Create test scenarios and check if the graphics stack works as expected. Consider "alternative grallocs":https://redmine.replicant.us/projects/replicant/wiki/GraphicsResearch#Gralloc if necessary. |>. 40 |
265 234 dl lud
| Make the graphics stack work with vGEM driver besides drm/exynos. |>. 40 |
266 1 Denis 'GNUtoo' Carikli
| Document the design decisions. |>. 16 |
267
|_. TOTAL |_>. 288 |
268 252 Denis 'GNUtoo' Carikli
269 1 Denis 'GNUtoo' Carikli
h3. Subtasks
270
271 235 dl lud
The following sub-tasks could also be worked on after finishing writing the gralloc:
272 1 Denis 'GNUtoo' Carikli
* [[Tasks_funding#SwiftShader|SwiftShader]]
273
* [[Tasks_funding#llvmpipe optimizations|llvmpipe optimizations]]
274
* [[Tasks_funding#Lima driver|Lima driver]]
275 252 Denis 'GNUtoo' Carikli
276 235 dl lud
h3. SwiftShader
277 238 dl lud
278 1 Denis 'GNUtoo' Carikli
"SwiftShader":https://swiftshader.googlesource.com/SwiftShader is Google's current software renderer that is capable of GLES 2.0 and is now "under work to support Vulkan":https://swiftshader.googlesource.com/SwiftShader/+log/master.
279 238 dl lud
280 232 dl lud
Mesa is the preferred renderer on Replicant for several reasons such as its support for both software and hardware (GPU) rendering, and its big community, with hundreds of active contributors. However, Mesa lacks a Vulkan software renderer. With Vulkan soon becoming a "requirement for new Android versions":https://android-developers.googleblog.com/2019/03/introducing-android-q-beta.html, we must make sure that Replicant's graphics stack can use SwiftShader in order to become futureproof. Furthermore, SwiftShader was built with performance in mind, specially for ARM CPUs, and may bring speed improvements on some devices.
281 238 dl lud
282 233 dl lud
The goal of this sub-task is thus to create a compile-time or run-time option that allows using Replicant 9 with SwiftShader as it's software renderer instead of Mesa.
283 232 dl lud
284 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.
285
286
*Difficulty*: Medium
287
288
*Requirements/Prerequisites*: Knowledge of C++, Makefiles and git. Android's graphics stack knowledge or the ability to learn them.
289
290 238 dl lud
*Expected outcomes*:
291
* SwiftShader running on Replicant.
292 1 Denis 'GNUtoo' Carikli
* Working Vulkan implementation.
293 211 dl lud
294
*Time +estimation+*: 40 man-hours.
295 252 Denis 'GNUtoo' Carikli
296 1 Denis 'GNUtoo' Carikli
h3. llvmpipe optimizations
297
298
Mesa is a highly versatile library that can be extended with device drivers to allow it to be used in different environments ranging from software emulation to complete hardware acceleration. One such driver is the "Gallium llvmpipe driver":https://www.mesa3d.org/llvmpipe.html, which is a software rasterizer that uses LLVM to do runtime code generation. It only needs a CPU to run graphics computations and thus brings full GLES support to all Replicant devices.
299
300
"llvmpipe has been integrated in Replicant 6":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.
301
302
To fix that, llvmpipe and/or the integration of it in Replicant should be optimized. We should first start by configuring llvmpipe and/or Mesa "to not implement very expensive OpenGL operations":https://www.mesa3d.org/perf.html. If that's not sufficient, or if that breaks application compatibility, various software or hardware features ("ARM NEON":https://www.arm.com/products/processors/technologies/neon.php, hardware 2D acceleration, etc) could be used to improve the speed.
303 231 dl lud
304
Considerable speed improvements may be achieved with a fine-tuned emulation for division instructions. The ARM cores on many Replicant devices do not have hardware "support for the SDIV/UDIV instructions":https://community.arm.com/processors/b/blog/posts/divide-and-conquer. We should profile some apps and check whether GLES functions requiring divisions are to blame for the poor performance.
305 1 Denis 'GNUtoo' Carikli
306
*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.
307
308
*Difficulty*: Medium / Hard (depending on the amount of optimizations required)
309
310
*Requirements/Prerequisites*: See with Mesa project
311
312 211 dl lud
*Expected outcomes*: faster llvmpipe on ARM devices, able to run apps such as Fennec F-Droid (Firefox).
313
314
*Time +estimation+*:
315
316 234 dl lud
|_. Step |_. man-hours |
317
| Setup a "testing and benchmarking environment":https://source.android.com/devices/graphics/testing |>. 40 |
318
| Disable expensive OpenGL operations. Check speedup and stability. |>. 24 |
319
| Recap matrix operations (Linear Algebra) and study ARM NEON. |>. 48 |
320 242 dl lud
| Do a profiling of several apps to find the most used GLES operations. |>. 32 |
321 234 dl lud
| Use "Ne10 library":https://github.com/projectNe10/Ne10 or "Neon Intrinsics":https://developer.arm.com/architectures/instruction-sets/simd-isas/neon/intrinsics for the most used GLES operations. |>. 80 |
322
| Fix bugs, re-write the code where needed, get it stable. |>. 80 |
323 1 Denis 'GNUtoo' Carikli
|_. TOTAL |_>. 304 |
324 252 Denis 'GNUtoo' Carikli
325 1 Denis 'GNUtoo' Carikli
h3. Lima driver
326
327
"Lima":https://gitlab.freedesktop.org/lima is a free software Mesa driver for ARM Mali-4xx (Utgard) GPUs. These GPUs are present in several Replicant supported devices such as Galaxy S2, S3, S3 4G, Note and Note 2. 
328
329
Lima aims to full GLES support but it is still in development. However the "current implementation status":https://gitlab.freedesktop.org/lima/mesa/issues/39#note_79193 already allows the hardware acceleration of several tasks. GPU-based hardware acceleration is faster and less power hungry than software rendering, both by several orders of magnitude. It would allow Replicant devices to run applications with a performance close to that of non-free devices.
330 167 dl lud
331
*Hardware requirements* : A computer that is able to build Replicant. A Replicant device with a Mali-4xx GPU that can run mainline Linux (e.g. Galaxy S3 or Note 2).
332
333
*Difficulty*: Medium
334
335
*Requirements/Prerequisites*: "See with Lima project":https://gitlab.freedesktop.org/lima/web/wikis/home#build-and-install
336 1 Denis 'GNUtoo' Carikli
337 212 dl lud
*Expected outcomes*: Lima driver being used for GLES rendering on a supported device.
338
339 234 dl lud
|_. Step |_. man-hours |
340
| Rebase "Lima's Linux kernel DRM driver":https://gitlab.freedesktop.org/lima/linux on top of "forkbomb's Midas on Mainline kernel":https://blog.forkwhiletrue.me/pages/midas-mainline/. |>. 80 |
341
| Replace mainline Mesa for "Lima's Mesa":https://gitlab.freedesktop.org/lima/mesa (with their driver).  |>. 16 |
342
| Build and test thoroughly with "synthetic":https://source.android.com/devices/graphics/testing and real applications. |>. 40 |
343
| Create a fallback mechanism that uses the software renderer for GLES functions not yet implemented in Lima. |>. 100 |
344 222 dl lud
|_. TOTAL |_>. 236 |
345 252 Denis 'GNUtoo' Carikli
346 243 dl lud
h3. Software Bill of Materials
347
348
* "Replicant 9":https://redmine.replicant.us/projects/replicant/wiki/Porting_Replicant_to_Android_9
349
* "Mesa":https://www.mesa3d.org/intro.html (in particular: "Gallium llvmpipe driver":https://www.mesa3d.org/llvmpipe.html)
350
* "gbm_gralloc":https://osdn.net/projects/android-x86/scm/git/external-gbm_gralloc/summary
351
* "drm-hwcomposer":https://gitlab.freedesktop.org/drm-hwcomposer/drm-hwcomposer
352
* "Linux kernel":https://www.kernel.org/ (in particular: drm/exynos driver and "vGEM driver":https://www.phoronix.com/scan.php?page=news_item&px=DRM-vGEM-Mesa-Software)
353
* "SwiftShader":https://swiftshader.googlesource.com/SwiftShader
354
* "Ne10 library":https://github.com/projectNe10/Ne10
355
* "Neon Intrinsics":https://developer.arm.com/architectures/instruction-sets/simd-isas/neon/intrinsics
356
* "Lima":https://gitlab.freedesktop.org/lima
357 252 Denis 'GNUtoo' Carikli
358 222 dl lud
h3. "Graphics acceleration on Replicant" nlnet Grant application
359
360
|_. Project name | Graphics acceleration on Replicant |
361
|_. Website / wiki | https://redmine.replicant.us/projects/replicant/wiki/Tasks_funding#Graphics-acceleration |
362
363
Abstract: Can you explain the whole project and its expected outcome(s) in 1200 characters
364
<pre>
365
Replicant is a fully free software Android distribution which is approved by the
366
FSF. All supported devices on Replicant currently lack a free software driver
367
for their GPU. As such, OpenGL ES (GLES) rendering must be done on the CPU
368
through software rendering (SR).
369 223 dl lud
370 222 dl lud
Replicant's current renderer is both incomplete and slow. It causes essential
371
apps like web browsers to crash due to lack of GLES 2.0, and many other
372
apps run too slow to be usable.
373
374
This project aims to fix this by complementing Android's 9 graphics stack.
375
Adding a few missing components will created of a fully-free, fast and compliant
376
graphics stack.
377
378
First we will write a gralloc (graphics memory allocator) tailored for SR that
379
is compatible with drm-hwcomposer (a libre implementation of Android's Hardware
380
Composer HAL). This gralloc enables drm-hwcomposer to work with SurfaceFlinger
381
and SwiftShader, creating a stack capable of GLES 2.0 on the CPU of all Replicant
382
devices.
383
384
Afterwards we will integrate and optimize Mesa's llvmpipe SR, which offers better
385
community support than SwiftShader. As last step we will add support for the
386
Lima driver, which will bring an even faster GPU-backed GLES to at least 5
387
devices.
388
</pre> 
389
390
|_. Have you been involved with projects or organizations relevant to this project before?
391
And if so, can you tell us a bit about your contributions? | SEE TEMPLATE |
392
393
|_. Requested Amount (Between 5000 and 50000 Euros) | 50000 Euros |
394
|_. Does the project have other funding sources, both past and present? | SEE TEMPLATE |
395
396 1 Denis 'GNUtoo' Carikli
Explain what the requested budget will be used for? 
397 223 dl lud
<pre>
398 1 Denis 'GNUtoo' Carikli
The budget will only be used to fund this project through contract work.
399 223 dl lud
400
We estimate that this project should take 868 man-hours to reach full completion,
401
with 632 man-hours being enough to reach all software rendering goals, leaving only
402
the GPU rendering to be done. A detailed run-down of this estimate is available at
403
https://redmine.replicant.us/projects/replicant/wiki/Tasks_funding#Graphics-acceleration
404
405
So far we have a team of two people interested on working on this project (the
406
two authors and submitters of this application). Both can commit to the project
407
on a part-time regime (17.5 hours per week), which means that the project should
408
be fully completed in about 6 months.
409
410
We will make sure that everybody has a chance to apply for doing contract work.
411
If we take the cost of a freelance developer in the USA (75 to 150 USD
412
per hour) as a basis, to enable people living in Europe and the USA
413
to apply, we can fund between 380 and 760 man-hours with the 50000 EUR budget.
414
This should be enough to cover all work on software rendering plus the initial
415
work on GPU rendering.
416
417
As happens on all software projects, getting a precise time/effort evaluation is
418
a difficult endeavour, specially when dealing with a project that is heavy on
419
research such as this one.
420
421
If the software rendering goals are not reached when the 50000 EUR budget runs
422
out, or if the Replicant project deems it necessary to have GPU rendering, it
423
will use its existing funds to pay for contract work if no volunteers are found
424
to finish the project.
425
426
The Replicant project will also make sure that the people working on this project
427
have the necessary hardware to do it, for instance by shipping or reimbursing the
428 222 dl lud
purchase of a compatible smartphone with the Replicant project funds.
429
</pre>
430
431
Compare your own project with existing or historical efforts.
432 224 dl lud
<pre>
433
Past Replicant versions have relied on patches to the Android framework to make
434
software rendering work. These patches were quite specific for Replicant and
435
had no use elsewhere. This made them unfit for upstreaming or sharing with any
436 222 dl lud
other project.
437 224 dl lud
438
Android's Project Treble new graphics stack allows us to follow a different
439
approach this time. Instead of patching the Android framework, we will
440
implement one of the well defined Android HALs (Hardware Abstraction Layer):
441
the gralloc HAL. The end result will be a software library that can prove to be
442
useful on several projects besides Replicant (e.g. Android-x86 project) and
443
thus fit for upstreaming.
444
445
446
Furthermore, past Replicant versions relied on Google's software renderers
447
(ligAGL and libpixelflinger) for OpenGL ES support. As quite a few other
448
Google's open-source projects, these two had no community behind them and got
449
stalled as soon as Google deprecated them.
450
451
This time will we take a different approach. Although our first graphics stack
452
will rely on Google's SwiftShader renderer, we will then move our efforts into
453
Mesa. Mesa is a big community project, with hundreds of active contributors and
454
great community support. It includes the llvmpipe software renderer along with
455
new drivers in development for GPUs present on current and future Replicant
456 222 dl lud
devices. Mesa should provide a stable and maintained platform for years to come.
457
</pre>
458
459
What are significant technical challenges you expect to solve during the project, if any?
460 225 dl lud
<pre>
461
We expect to solve significant technical challenges during this project:
462
1. Implementation of the first Android gralloc library compatible with software
463
rendering.
464
2. Development of free-software benchmarks for OpenGL ES on Android, used to test
465
our optimizations to llvmpipe.
466
3. Optimization of llvmpipe by at least one order of magnitude.
467
4. Running an exynos based smartphone with fully free-software GPU graphics
468 222 dl lud
acceleration.
469
</pre>
470 229 dl lud
471
Describe the ecosystem of the project, and how you will engage with relevant actors and promote the outcomes?
472
<pre>
473
This project will re-use code from several projects such as Android,
474
drm-hwcomposer, Mesa and Lima driver. Whenever possible we will foster
475
collaboration with these projects and submit our changes upstream.
476
477
The Replicant project contributors and the FSF will supervise
478
contractors to do the work.
479
480
A blog post will announce that the Replicant project
481
has got some funding for this specific task, and that it is
482
looking for a contractor to work on it. This is to make sure
483
that everyone has equal chances in the application process.
484
485
Then the most suited contractor will be selected. Only contractors
486
that already have worked on similar tasks as part of free and open
487
source software projects will be chosen. This way we can look at
488
their existing contributions and make sure that they are able to
489
do the task before engaging with them.
490
491
The Replicant project will also make sure that the contractor has
492
or gets the hardware required to work on the task, before starting
493 1 Denis 'GNUtoo' Carikli
to work on it.
494 229 dl lud
</pre>
495 222 dl lud
496 167 dl lud
|_. Attachments | SEE TEMPLATE |