From dd467bfc14aa5e1d27e87814588a871fec6aa51f Mon Sep 17 00:00:00 2001 From: Matt DeVillier Date: Thu, 14 May 2020 17:45:29 -0500 Subject: drivers/intel/gma: Add override for presence straps A handful of boards do not properly implement the presence straps, leading libgfxinit to fail to detect an attached display. Add an override, defaulting to N, which can be set for affected boards. Add a section to the documentation detailing the option and its usage. Signed-off-by: Matt DeVillier Change-Id: I43c61d67147878887658b23d90fb1c0b91e7a2af Reviewed-on: https://review.coreboot.org/c/coreboot/+/41416 Tested-by: build bot (Jenkins) Reviewed-by: Nico Huber --- Documentation/gfx/libgfxinit.md | 27 ++++++++++++++++++++++----- 1 file changed, 22 insertions(+), 5 deletions(-) (limited to 'Documentation') diff --git a/Documentation/gfx/libgfxinit.md b/Documentation/gfx/libgfxinit.md index bb4528b958..40f194a4eb 100644 --- a/Documentation/gfx/libgfxinit.md +++ b/Documentation/gfx/libgfxinit.md @@ -88,11 +88,28 @@ know through which interface the EDID can be queried: select GFX_GMA_ANALOG_I2C_HDMI_C # or select GFX_GMA_ANALOG_I2C_HDMI_D -Beside Kconfig options, *libgfxinit* needs to know which ports are -implemented on a board and should be probed for displays. The mapping -between the physical ports and these entries depends on the hardware -implementation and can be recovered by testing or studying the output -of `intelvbttool` or `intel_vbt_decode`. +*libgfxinit* needs to know which ports are implemented on a board +and should be probed for displays. There are two mechanisms to +constrain the list of ports to probe, 1. port presence straps on +the mainboard, and 2. a list of ports provided by *coreboot* (see +below). + +Presence straps are configured via the state of certains pins of +the chipset at reset time. They are documented in the chipset's +datasheets. By default, *libgfxinit* honors these straps for +safety. However, some boards don't implement the straps correctly. +If ports are not strapped as implemented by error, one can select +an option to ignore the straps: + + select GFX_GMA_IGNORE_PRESENCE_STRAPS + +In the opposite case, that ports are strapped as implemented, +but are actually unconnected, one has to make sure that the +list of ports in *coreboot* omits them. + +The mapping between the physical ports and these entries depends on +the hardware implementation and can be recovered by testing or +studying the output of `intelvbttool` or `intel_vbt_decode`. Each board has to implement the package `GMA.Mainboard` with a list: ports : HW.GFX.GMA.Display_Probing.Port_List; -- cgit v1.2.3