1 # DRM lease support layer
3 This yocto layer adds support for using DRM leases to partition display
4 controller output resources between multiple processes.
6 This layer adds a drm-lease-manager deamon (with systemd configuration)
7 and a client library for receiving DRM leases from the daemon. For more details
8 the DRM lease manager and client see the repository at
9 (https://gerrit.automotivelinux.org/gerrit/gitweb?p=src/drm-lease-manager.git)
13 Enable the `agl-drm-lease` AGL feature when setting up your build environment
16 This will add the `drm-lease-manager` package to the image, and will add DRM
17 lease support to the following packages:
21 `kmscube` is not included in the image by default. To add the package to the
22 image, add the following to your local.conf
25 IMAGE_INSTALL:append = " kmscube"
28 ## Starting the DRM lease manager
30 The drm-lease-manager must be the only process to directly open the DRM device.
31 Shut down any running window systems (eg. weston or agl-compositor) and run:
34 # systemctl start drm-lease-manager
37 This will create 1 lease for each output connection on the platform.
38 The name of each lease will be in the form of `card0-<output name>`
39 (eg. `card0-LVDS-1` or `card0-HDMI-A-1`)
43 weston can be started on any available DRM lease by running with the
44 `--drm-lease=<lease name>` option. Eg:
46 # weston --drm-lease=card0-HDMI-A-1
49 ## Running kmscube sample
51 With the `drm-lease-manager` running `kmscube` can display on any available
52 lease by running with the `-L -D<lease name>` options. Eg:
55 # kmscube -L -Dcard0-HDMI-A-1
58 Multiple kmscube instances (one per DRM lease) can be started at the same time.
62 This layer has been tested on the Renesas R-Car Gen3 platform. Other platforms
63 supporting the Linux DRM API may work as well.
65 maintainer: agl-dev-community@lists.automotivelinux.org
66 patch: agl-dev-community@lists.automotivelinux.org