genode/repos/dde_linux/src/drivers/framebuffer/intel
Ehmry - 24deef9495 Use #!/usr/bin/env ... shebangs 2019-11-28 15:07:24 +01:00
..
include dde_linux: eliminate global ctors in lx_kit 2019-11-19 14:17:29 +01:00
README dde_linux: update intel_fb to 4.16.3 2018-08-28 16:18:33 +02:00
dummies.c intel_fb: enable Intel VBT lookup via ACPI 2018-09-13 14:54:21 +02:00
gen_dummy Use #!/usr/bin/env ... shebangs 2019-11-28 15:07:24 +01:00
i915_params.c dde_linux: update intel_fb to 4.16.3 2018-08-28 16:18:33 +02:00
lx_emul.cc timeout: use uint64_t for all plain time values 2019-05-06 16:15:26 +02:00
lx_emul_c.c dde_linux: update intel_fb to 4.16.3 2018-08-28 16:18:33 +02:00
main.cc dde_linux: eliminate global ctors in lx_kit 2019-11-19 14:17:29 +01:00
target.mk dde_linux: update intel_fb to 4.16.3 2018-08-28 16:18:33 +02:00

README

This driver is for Intel i915 compatible graphic cards.

Default behaviour
~~~~~~~~~~~~~~~~~
When no configuration is provided to the driver, it will switch on all devices
the graphic card is initially connected to. It will use the best resolution as
provided by the BIOS or EDID information from the display devices for each
connector. The virtual resolution delivered to the client is the maximum in
width and height of the different connectors. The framebuffer memory is
directly exported to the client of the driver. When newly connected devices are
detected by the hardware, the new connectors are enabled, probed, and again the
'best' resolution will be chosen for the device. Nevertheless, it won't have an
effect on the virtual resolution.

Configuration
~~~~~~~~~~~~~
Each of the connector can be configured explicitly in terms of resolution and
whether it should be enabled or not. This looks like the following:

! <config>
!   <connector name="LVDS-11" width="1280" height="800" hz="60" brightness="75" enabled="true"/>
! </config>

When the configuration changes during run-time, the driver will adapt to it. In
this case it will also change the current virtual resolution to the maximum of
the configured resolutions in width and height, and it will inform its client
about the change in resolution.

The brightness value is in percentage and takes effect only if supported by
the hardware.

If you experience problems like hotplugging of connectors does not work, you
can force the driver to poll frequently for hotplug events by defining a period
in milliseconds like this:

! <config poll="1000"/>

If you define a period of zero, the driver won't poll at all, which is the
default value.

To present all available connectors and their possible resolutions to the user
the driver is able to export a corresponding report ROM. This has to be
configured too, like in the following:

! <config>
!   <report connectors="yes"/>
! </config>

The exported report has the following format:

! <connectors>
!   <connector name="LVDS-11" connected="1" brightness="50">
!     <mode width="1280" height="800" hz="60"/>
!     ...
!   </connector>
!   <connector name="HDMI-A-1" connected="false"/>
!   <connector name="DP-1" connected="false"/>
! </connectors>

The brightness attribute is soley reported if the hardware supports it.