diff options
author | Peter Maydell <peter.maydell@linaro.org> | 2021-07-27 18:04:12 +0100 |
---|---|---|
committer | Peter Maydell <peter.maydell@linaro.org> | 2021-08-26 17:02:00 +0100 |
commit | f054eb1c920671fe1055a62714087ec05aa09348 (patch) | |
tree | de4ac370085423b6814cf4321221091023b3be0d /docs/specs/acpi_pci_hotplug.rst | |
parent | 615a55827c590d75bff8a660fc20675fea6c73d3 (diff) |
docs/specs/acpi_pci_hotplug: Convert to rST
Convert the PCI hotplug spec document to rST.
Signed-off-by: Peter Maydell <peter.maydell@linaro.org>
Reviewed-by: Igor Mammedov <imammedo@redhat.com>
Diffstat (limited to 'docs/specs/acpi_pci_hotplug.rst')
-rw-r--r-- | docs/specs/acpi_pci_hotplug.rst | 48 |
1 files changed, 48 insertions, 0 deletions
diff --git a/docs/specs/acpi_pci_hotplug.rst b/docs/specs/acpi_pci_hotplug.rst new file mode 100644 index 0000000000..685bc5c322 --- /dev/null +++ b/docs/specs/acpi_pci_hotplug.rst @@ -0,0 +1,48 @@ +QEMU<->ACPI BIOS PCI hotplug interface +====================================== + +QEMU supports PCI hotplug via ACPI, for PCI bus 0. This document +describes the interface between QEMU and the ACPI BIOS. + +ACPI GPE block (IO ports 0xafe0-0xafe3, byte access) +---------------------------------------------------- + +Generic ACPI GPE block. Bit 1 (GPE.1) used to notify PCI hotplug/eject +event to ACPI BIOS, via SCI interrupt. + +PCI slot injection notification pending (IO port 0xae00-0xae03, 4-byte access) +------------------------------------------------------------------------------ + +Slot injection notification pending. One bit per slot. + +Read by ACPI BIOS GPE.1 handler to notify OS of injection +events. Read-only. + +PCI slot removal notification (IO port 0xae04-0xae07, 4-byte access) +-------------------------------------------------------------------- + +Slot removal notification pending. One bit per slot. + +Read by ACPI BIOS GPE.1 handler to notify OS of removal +events. Read-only. + +PCI device eject (IO port 0xae08-0xae0b, 4-byte access) +------------------------------------------------------- + +Write: Used by ACPI BIOS _EJ0 method to request device removal. +One bit per slot. + +Read: Hotplug features register. Used by platform to identify features +available. Current base feature set (no bits set): + +- Read-only "up" register @0xae00, 4-byte access, bit per slot +- Read-only "down" register @0xae04, 4-byte access, bit per slot +- Read/write "eject" register @0xae08, 4-byte access, + write: bit per slot eject, read: hotplug feature set +- Read-only hotplug capable register @0xae0c, 4-byte access, bit per slot + +PCI removability status (IO port 0xae0c-0xae0f, 4-byte access) +-------------------------------------------------------------- + +Used by ACPI BIOS _RMV method to indicate removability status to OS. One +bit per slot. Read-only. |