summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorRyszard Knop <ryszard.knop@intel.com>2022-05-20 12:39:45 +0200
committerPetri Latvala <petri.latvala@intel.com>2022-05-25 12:52:51 +0300
commit1b5f7f139660ac27f3c8b4c4a2d23fdd9430ccab (patch)
treecaf077c270e78ae3c880138dd164818d8605ad5f /docs
parent980f69dfe33f11f0fa65a1c8f4602ecb2f93355c (diff)
tests/kms_chamelium: Check if port adapters are in use
If a DUT has Chamelium ports connected via an adapter (for example, DP on the Chamelium side -> DP-HDMI adapter -> HDMI on the DUT), this will usually cause many tests to fail. If mismatching port types are found on both sides, the tests will now be aborted with a warning. This behavior can be overridden with a new AdapterAllowed config value, which must be set in [Chamelium:PORT] blocks in .igtrc. Signed-off-by: Ryszard Knop <ryszard.knop@intel.com> Reviewed-by: Petri Latvala <petri.latvala@intel.com>
Diffstat (limited to 'docs')
-rw-r--r--docs/chamelium.txt18
1 files changed, 14 insertions, 4 deletions
diff --git a/docs/chamelium.txt b/docs/chamelium.txt
index 32c296f7..7484a3f8 100644
--- a/docs/chamelium.txt
+++ b/docs/chamelium.txt
@@ -94,7 +94,8 @@ example (only Chamelium.URL is mandatory):
URL=http://192.168.1.2:9992
# The rest of the sections are used for defining connector mappings. This
- # is optional, the mappings will be discovered automatically.
+ # is optional if the same connector type (ex. DP-DP) is used on both sides,
+ # the mappings will be discovered automatically.
# The name of the DRM connector
# The DP-1 of [Chamelium:DP-1] and the HDMI-A-1 of [Chamelium:HDMI-A-1] indicate
@@ -102,13 +103,22 @@ example (only Chamelium.URL is mandatory):
[Chamelium:DP-1]
# The ChameliumPortID indicates physical port (device) id of a Chamelium Board.
# A Chamelium daemon program defines these port ids as
- # DP1 (located next to the HDMI port) = 1
- # DP2 (located next to the VGA connector) = 2
- # HDMI = 3 and VGA = 4
+ # - DP1 (located next to the HDMI port) = 1
+ # - DP2 (located next to the VGA connector) = 2
+ # - HDMI = 3
+ # - VGA = 4
# The port ids are defined at:
# https://chromium.googlesource.com/chromiumos/platform/chameleon/+/master/chameleond/utils/ids.py
ChameliumPortID=1
+ [Chamelium:HDMI-A-1]
+ # Notice that the DRM side has HDMI, but Chamelium has DP on port 2.
+ # This is possible via an HDMI-DP adapter, but such scenarios often cause
+ # issues, so by default we fail if mismatching connector types are found.
+ # If AdapterAllowed is set to 1, the tests will proceed with a warning.
+ ChameliumPortID=2
+ AdapterAllowed=1
+
[Chamelium:HDMI-A-2]
ChameliumPortID=3