Documentation: ACPI: enumeration: add PCI hierarchy representation
authorFlavio Suligoi <f.suligoi@asem.it>
Fri, 20 Nov 2020 11:11:25 +0000 (12:11 +0100)
committerRafael J. Wysocki <rafael.j.wysocki@intel.com>
Mon, 23 Nov 2020 16:59:49 +0000 (17:59 +0100)
commit390029c27ea74099a7f56f7ae502d11953fa1187
treec14da597d50ba537ddd95a83e22677c3451855c8
parenta8b6cfdf978602dbbb0b9b19e74f25af7a8ca389
Documentation: ACPI: enumeration: add PCI hierarchy representation

For "fixed" PCI devices, such as chips directly soldered
on the main board (ethernet, Wi-Fi, serial ports, etc.),
it is possible to find an ACPI enumeration.

This allows to add useful properties to these devices.
Just for an example: the property "gpio-line-names" can be
added to the pins of a GPIO expander on the PCI bus.

In order to find the ACPI name of a PCI device, it's necessary
to disassemble the BIOS ACPI tables (in particular the DSDT)
and also to analyze the PCI bus topology of the board.

This patch, with a practical example, show how to do this.

Signed-off-by: Flavio Suligoi <f.suligoi@asem.it>
Reviewed-by: Mika Westerberg <mika.westerberg@linux.intel.com>
Reviewed-by: Andy Shevchenko <andriy.shevchenko@linux.intel.com>
Signed-off-by: Rafael J. Wysocki <rafael.j.wysocki@intel.com>
Documentation/firmware-guide/acpi/enumeration.rst