README


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43

xf86-video-armsoc
Open-source X.org graphics driver for ARM graphics

DRM driver selection
--------------------
While most operations use only the standard DRM modesetting interfaces, certain operations
unavoidably rely on specific driver behaviour (including dumb buffer allocation flags and cursor
plane z-ordering). As such, the armsoc driver must be configured for a particular DRM driver.

The currently supported DRM drivers are:
- pl111
- exynos

To configure armsoc for one of these, pass the --with-drmmode option to ./configure. For example:

$ ./configure --with-drmmode=pl111

For other drivers, you will need to implement this support yourself. A template implementation is
provided in src/drmmode_template which can be built by passing --with-drmmode=template to ./configure.
The interface is defined and documented in src/drmmode_driver.h, and you should refer to this while
modifying the template to set up your DRM driver's abstraction appropriately.

You can also copy src/drmmode_template into src/drmmode_<yourdrivername> and build with:

$ ./configure --with-drmmode=<yourdrivername>

HW Cursors support
-------------------

HW Cursor plane configuration
------------------------------

The cursor plane format needs to be modified to select the format that the platform expects. This can
be done by setting DRM_CURSOR_PLANE_FORMAT define to the desired format in omap_dumb.h.

Currently available options are:

HW_CURSOR_ARGB   -  Cursor images support full ARGB8888 pixel format.
HW_CURSOR_PL111  -  Cursor images support PL111 LBBP pixel format.

For example to set HW_CURSOR_PL111 cursor support set DRM_CURSOR_PLANE_FORMAT in the following way:

#define DRM_CURSOR_PLANE_FORMAT	HW_CURSOR_PL111