Skip to content

Commit 1ce91b3

Browse files
committed
cxl: docs/platform/acpi/srat Add generic target documentation
Add description in the SRAT document to describe the Generic Port Affinity sub-table. Reviewed-by: Gregory Price <gourry@gourry.net> Reviewed-by: Alison Schofield <alison.schofield@intel.com> Link: https://patch.msgid.link/20250515000923.2590820-3-dave.jiang@intel.com Signed-off-by: Dave Jiang <dave.jiang@intel.com>
1 parent 49cee8f commit 1ce91b3

File tree

1 file changed

+27
-0
lines changed
  • Documentation/driver-api/cxl/platform/acpi

1 file changed

+27
-0
lines changed

Documentation/driver-api/cxl/platform/acpi/srat.rst

Lines changed: 27 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -42,3 +42,30 @@ Example ::
4242
Enabled : 1
4343
Hot Pluggable : 1
4444
Non-Volatile : 0
45+
46+
47+
Generic Port Affinity
48+
=====================
49+
The Generic Port Affinity subtable provides an association between a proximity
50+
domain and a device handle representing a Generic Port such as a CXL host
51+
bridge. With the association, latency and bandwidth numbers can be retrieved
52+
from the SRAT for the path between CPU(s) (initiator) and the Generic Port.
53+
This is used to construct performance coordinates for hotplugged CXL DEVICES,
54+
which cannot be enumerated at boot by platform firmware.
55+
56+
Example ::
57+
58+
Subtable Type : 06 [Generic Port Affinity]
59+
Length : 20 <- 32d, length of table
60+
Reserved : 00
61+
Device Handle Type : 00 <- 0 - ACPI, 1 - PCI
62+
Proximity Domain : 00000001
63+
Device Handle : ACPI0016:01
64+
Flags : 00000001 <- Bit 0 (Enabled)
65+
Reserved : 00000000
66+
67+
The Proximity Domain is matched up to the :doc:`HMAT <hmat>` SSLBI Target
68+
Proximity Domain List for the related latency or bandwidth numbers. Those
69+
performance numbers are tied to a CXL host bridge via the Device Handle.
70+
The driver uses the association to retrieve the Generic Port performance
71+
numbers for the whole CXL path access coordinates calculation.

0 commit comments

Comments
 (0)