ACPI: docs: enumeration: Clarify ACPI bus concepts
authorRafael J. Wysocki <rafael.j.wysocki@intel.com>
Fri, 6 Oct 2023 15:29:53 +0000 (17:29 +0200)
committerRafael J. Wysocki <rafael.j.wysocki@intel.com>
Fri, 6 Oct 2023 15:29:53 +0000 (17:29 +0200)
commit5f3c10ac34ec2dc199e5bcc3ff856b42cf0e12df
treeaa8f546165b96785c3dcb8e96f39455615c04064
parent8a749fd1a8720d4619c91c8b6e7528c0a355c0aa
ACPI: docs: enumeration: Clarify ACPI bus concepts

In some cases, ACPI drivers are implemented as a way to manage devices
enumerated with the help of the platform firmware through ACPI.

This might be confusing, since the preferred way to implement a driver
for a device that cannot be enumerated natively, is a platform
driver, as stated in the documentation.

Clarify relationships between ACPI device objects, platform devices and
ACPI Namespace entries.

Suggested-by: Elena Reshetova <elena.reshetova@intel.com>
Co-developed-by: Michal Wilczynski <michal.wilczynski@intel.com>
Signed-off-by: Michal Wilczynski <michal.wilczynski@intel.com>
Signed-off-by: Rafael J. Wysocki <rafael.j.wysocki@intel.com>
Documentation/firmware-guide/acpi/enumeration.rst