| 1 |
This is a historical description of what is now the kgsl backend |
| 2 |
in libdrm freedreno (before the upstream drm/msm driver). Note |
| 3 |
that the kgsl backend requires the "kgsl-drm" shim driver, which |
| 4 |
usually is in disrepair (QCOM does not build it for android), and |
| 5 |
due to random differences between different downstream android |
| 6 |
kernel branches it may or may not work. So YMMV. |
| 7 |
|
| 8 |
Original README: |
| 9 |
---------------- |
| 10 |
|
| 11 |
Note that current msm kernel driver is a bit strange. It provides a |
| 12 |
DRM interface for GEM, which is basically sufficient to have DRI2 |
| 13 |
working. But it does not provide KMS. And interface to 2d and 3d |
| 14 |
cores is via different other devices (/dev/kgsl-*). This is not |
| 15 |
quite how I'd write a DRM driver, but at this stage it is useful for |
| 16 |
xf86-video-freedreno and fdre (and eventual gallium driver) to be |
| 17 |
able to work on existing kernel driver from QCOM, to allow to |
| 18 |
capture cmdstream dumps from the binary blob drivers without having |
| 19 |
to reboot. So libdrm_freedreno attempts to hide most of the crazy. |
| 20 |
The intention is that when there is a proper kernel driver, it will |
| 21 |
be mostly just changes in libdrm_freedreno to adapt the gallium |
| 22 |
driver and xf86-video-freedreno (ignoring the fbdev->KMS changes). |
| 23 |
|
| 24 |
So don't look at freedreno as an example of how to write a libdrm |
| 25 |
module or a DRM driver.. it is just an attempt to paper over a non- |
| 26 |
standard kernel driver architecture. |