xref: /openbmc/qemu/include/hw/acpi/pcihp.h (revision 1136309df5e3de7d031a137221318f48784cca5d)
1 /*
2  * QEMU<->ACPI BIOS PCI hotplug interface
3  *
4  * QEMU supports PCI hotplug via ACPI. This module
5  * implements the interface between QEMU and the ACPI BIOS.
6  * Interface specification - see docs/specs/acpi_pci_hotplug.rst
7  *
8  * Copyright (c) 2013, Red Hat Inc, Michael S. Tsirkin (mst@redhat.com)
9  * Copyright (c) 2006 Fabrice Bellard
10  *
11  * This library is free software; you can redistribute it and/or
12  * modify it under the terms of the GNU Lesser General Public
13  * License version 2.1 as published by the Free Software Foundation.
14  *
15  * This library is distributed in the hope that it will be useful,
16  * but WITHOUT ANY WARRANTY; without even the implied warranty of
17  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
18  * Lesser General Public License for more details.
19  *
20  * You should have received a copy of the GNU Lesser General Public
21  * License along with this library; if not, see <http://www.gnu.org/licenses/>
22  *
23  * Contributions after 2012-01-13 are licensed under the terms of the
24  * GNU GPL, version 2 or (at your option) any later version.
25  */
26 
27 #ifndef HW_ACPI_PCIHP_H
28 #define HW_ACPI_PCIHP_H
29 
30 #include "hw/acpi/acpi.h"
31 #include "hw/hotplug.h"
32 
33 #define ACPI_PCIHP_IO_BASE_PROP "acpi-pcihp-io-base"
34 #define ACPI_PCIHP_IO_LEN_PROP "acpi-pcihp-io-len"
35 
36 /* PCI Hot-plug registers bases. See docs/specs/acpi_pci_hotplug.rst */
37 #define ACPI_PCIHP_SEJ_BASE 0x8
38 #define ACPI_PCIHP_BNMR_BASE 0x10
39 
40 typedef struct AcpiPciHpPciStatus {
41     uint32_t up;
42     uint32_t down;
43     uint32_t hotplug_enable;
44 } AcpiPciHpPciStatus;
45 
46 #define ACPI_PCIHP_PROP_BSEL "acpi-pcihp-bsel"
47 #define ACPI_PCIHP_MAX_HOTPLUG_BUS 256
48 #define ACPI_PCIHP_BSEL_DEFAULT 0x0
49 
50 typedef struct AcpiPciHpState {
51     AcpiPciHpPciStatus acpi_pcihp_pci_status[ACPI_PCIHP_MAX_HOTPLUG_BUS];
52     uint32_t hotplug_select;
53     uint32_t acpi_index;
54     PCIBus *root;
55     MemoryRegion io;
56     uint16_t io_base;
57     uint16_t io_len;
58     bool use_acpi_hotplug_bridge;
59     bool use_acpi_root_pci_hotplug;
60 } AcpiPciHpState;
61 
62 void acpi_pcihp_init(Object *owner, AcpiPciHpState *, PCIBus *root,
63                      MemoryRegion *io, uint16_t io_base);
64 
65 bool acpi_pcihp_is_hotpluggable_bus(AcpiPciHpState *s, BusState *bus);
66 void acpi_pcihp_device_pre_plug_cb(HotplugHandler *hotplug_dev,
67                                    DeviceState *dev, Error **errp);
68 void acpi_pcihp_device_plug_cb(HotplugHandler *hotplug_dev, AcpiPciHpState *s,
69                                DeviceState *dev, Error **errp);
70 void acpi_pcihp_device_unplug_cb(HotplugHandler *hotplug_dev, AcpiPciHpState *s,
71                                  DeviceState *dev, Error **errp);
72 void acpi_pcihp_device_unplug_request_cb(HotplugHandler *hotplug_dev,
73                                          AcpiPciHpState *s, DeviceState *dev,
74                                          Error **errp);
75 
76 void build_acpi_pci_hotplug(Aml *table, uint64_t pcihp_addr);
77 void build_append_pci_dsm_func0_common(Aml *ctx, Aml *retvar);
78 
79 /* Called on reset */
80 void acpi_pcihp_reset(AcpiPciHpState *s);
81 
82 void build_append_pcihp_slots(Aml *parent_scope, PCIBus *bus);
83 
84 extern const VMStateDescription vmstate_acpi_pcihp_pci_status;
85 
86 #define VMSTATE_PCI_HOTPLUG(pcihp, state, test_pcihp, test_acpi_index) \
87         VMSTATE_UINT32_TEST(pcihp.hotplug_select, state, \
88                             test_pcihp), \
89         VMSTATE_STRUCT_ARRAY_TEST(pcihp.acpi_pcihp_pci_status, state, \
90                                   ACPI_PCIHP_MAX_HOTPLUG_BUS, \
91                                   test_pcihp, 1, \
92                                   vmstate_acpi_pcihp_pci_status, \
93                                   AcpiPciHpPciStatus), \
94         VMSTATE_UINT32_TEST(pcihp.acpi_index, state, \
95                             test_acpi_index)
96 
97 #endif
98