qemu/hw/acpi/generic_event_device.c
<<
>>
Prefs
   1/*
   2 *
   3 * Copyright (c) 2018 Intel Corporation
   4 * Copyright (c) 2019 Huawei Technologies R & D (UK) Ltd
   5 * Written by Samuel Ortiz, Shameer Kolothum
   6 *
   7 * This program is free software; you can redistribute it and/or modify it
   8 * under the terms and conditions of the GNU General Public License,
   9 * version 2 or later, as published by the Free Software Foundation.
  10 */
  11
  12#include "qemu/osdep.h"
  13#include "qapi/error.h"
  14#include "exec/address-spaces.h"
  15#include "hw/acpi/acpi.h"
  16#include "hw/acpi/generic_event_device.h"
  17#include "hw/irq.h"
  18#include "hw/mem/pc-dimm.h"
  19#include "hw/mem/nvdimm.h"
  20#include "hw/qdev-properties.h"
  21#include "migration/vmstate.h"
  22#include "qemu/error-report.h"
  23
  24static const uint32_t ged_supported_events[] = {
  25    ACPI_GED_MEM_HOTPLUG_EVT,
  26    ACPI_GED_PWR_DOWN_EVT,
  27    ACPI_GED_NVDIMM_HOTPLUG_EVT,
  28};
  29
  30/*
  31 * The ACPI Generic Event Device (GED) is a hardware-reduced specific
  32 * device[ACPI v6.1 Section 5.6.9] that handles all platform events,
  33 * including the hotplug ones. Platforms need to specify their own
  34 * GED Event bitmap to describe what kind of events they want to support
  35 * through GED. This routine uses a single interrupt for the GED device,
  36 * relying on IO memory region to communicate the type of device
  37 * affected by the interrupt. This way, we can support up to 32 events
  38 * with a unique interrupt.
  39 */
  40void build_ged_aml(Aml *table, const char *name, HotplugHandler *hotplug_dev,
  41                   uint32_t ged_irq, AmlRegionSpace rs, hwaddr ged_base)
  42{
  43    AcpiGedState *s = ACPI_GED(hotplug_dev);
  44    Aml *crs = aml_resource_template();
  45    Aml *evt, *field;
  46    Aml *dev = aml_device("%s", name);
  47    Aml *evt_sel = aml_local(0);
  48    Aml *esel = aml_name(AML_GED_EVT_SEL);
  49
  50    /* _CRS interrupt */
  51    aml_append(crs, aml_interrupt(AML_CONSUMER, AML_EDGE, AML_ACTIVE_HIGH,
  52                                  AML_EXCLUSIVE, &ged_irq, 1));
  53
  54    aml_append(dev, aml_name_decl("_HID", aml_string("ACPI0013")));
  55    aml_append(dev, aml_name_decl("_UID", aml_string(GED_DEVICE)));
  56    aml_append(dev, aml_name_decl("_CRS", crs));
  57
  58    /* Append IO region */
  59    aml_append(dev, aml_operation_region(AML_GED_EVT_REG, rs,
  60               aml_int(ged_base + ACPI_GED_EVT_SEL_OFFSET),
  61               ACPI_GED_EVT_SEL_LEN));
  62    field = aml_field(AML_GED_EVT_REG, AML_DWORD_ACC, AML_NOLOCK,
  63                      AML_WRITE_AS_ZEROS);
  64    aml_append(field, aml_named_field(AML_GED_EVT_SEL,
  65                                      ACPI_GED_EVT_SEL_LEN * BITS_PER_BYTE));
  66    aml_append(dev, field);
  67
  68    /*
  69     * For each GED event we:
  70     * - Add a conditional block for each event, inside a loop.
  71     * - Call a method for each supported GED event type.
  72     *
  73     * The resulting ASL code looks like:
  74     *
  75     * Local0 = ESEL
  76     * If ((Local0 & One) == One)
  77     * {
  78     *     MethodEvent0()
  79     * }
  80     *
  81     * If ((Local0 & 0x2) == 0x2)
  82     * {
  83     *     MethodEvent1()
  84     * }
  85     * ...
  86     */
  87    evt = aml_method("_EVT", 1, AML_SERIALIZED);
  88    {
  89        Aml *if_ctx;
  90        uint32_t i;
  91        uint32_t ged_events = ctpop32(s->ged_event_bitmap);
  92
  93        /* Local0 = ESEL */
  94        aml_append(evt, aml_store(esel, evt_sel));
  95
  96        for (i = 0; i < ARRAY_SIZE(ged_supported_events) && ged_events; i++) {
  97            uint32_t event = s->ged_event_bitmap & ged_supported_events[i];
  98
  99            if (!event) {
 100                continue;
 101            }
 102
 103            if_ctx = aml_if(aml_equal(aml_and(evt_sel, aml_int(event), NULL),
 104                                      aml_int(event)));
 105            switch (event) {
 106            case ACPI_GED_MEM_HOTPLUG_EVT:
 107                aml_append(if_ctx, aml_call0(MEMORY_DEVICES_CONTAINER "."
 108                                             MEMORY_SLOT_SCAN_METHOD));
 109                break;
 110            case ACPI_GED_PWR_DOWN_EVT:
 111                aml_append(if_ctx,
 112                           aml_notify(aml_name(ACPI_POWER_BUTTON_DEVICE),
 113                                      aml_int(0x80)));
 114                break;
 115            case ACPI_GED_NVDIMM_HOTPLUG_EVT:
 116                aml_append(if_ctx,
 117                           aml_notify(aml_name("\\_SB.NVDR"),
 118                                      aml_int(0x80)));
 119                break;
 120            default:
 121                /*
 122                 * Please make sure all the events in ged_supported_events[]
 123                 * are handled above.
 124                 */
 125                g_assert_not_reached();
 126            }
 127
 128            aml_append(evt, if_ctx);
 129            ged_events--;
 130        }
 131
 132        if (ged_events) {
 133            error_report("Unsupported events specified");
 134            abort();
 135        }
 136    }
 137
 138    /* Append _EVT method */
 139    aml_append(dev, evt);
 140
 141    aml_append(table, dev);
 142}
 143
 144/* Memory read by the GED _EVT AML dynamic method */
 145static uint64_t ged_evt_read(void *opaque, hwaddr addr, unsigned size)
 146{
 147    uint64_t val = 0;
 148    GEDState *ged_st = opaque;
 149
 150    switch (addr) {
 151    case ACPI_GED_EVT_SEL_OFFSET:
 152        /* Read the selector value and reset it */
 153        val = ged_st->sel;
 154        ged_st->sel = 0;
 155        break;
 156    default:
 157        break;
 158    }
 159
 160    return val;
 161}
 162
 163/* Nothing is expected to be written to the GED memory region */
 164static void ged_evt_write(void *opaque, hwaddr addr, uint64_t data,
 165                          unsigned int size)
 166{
 167}
 168
 169static const MemoryRegionOps ged_evt_ops = {
 170    .read = ged_evt_read,
 171    .write = ged_evt_write,
 172    .endianness = DEVICE_LITTLE_ENDIAN,
 173    .valid = {
 174        .min_access_size = 4,
 175        .max_access_size = 4,
 176    },
 177};
 178
 179static void acpi_ged_device_plug_cb(HotplugHandler *hotplug_dev,
 180                                    DeviceState *dev, Error **errp)
 181{
 182    AcpiGedState *s = ACPI_GED(hotplug_dev);
 183
 184    if (object_dynamic_cast(OBJECT(dev), TYPE_PC_DIMM)) {
 185        if (object_dynamic_cast(OBJECT(dev), TYPE_NVDIMM)) {
 186            nvdimm_acpi_plug_cb(hotplug_dev, dev);
 187        } else {
 188            acpi_memory_plug_cb(hotplug_dev, &s->memhp_state, dev, errp);
 189        }
 190    } else {
 191        error_setg(errp, "virt: device plug request for unsupported device"
 192                   " type: %s", object_get_typename(OBJECT(dev)));
 193    }
 194}
 195
 196static void acpi_ged_unplug_request_cb(HotplugHandler *hotplug_dev,
 197                                       DeviceState *dev, Error **errp)
 198{
 199    AcpiGedState *s = ACPI_GED(hotplug_dev);
 200
 201    if ((object_dynamic_cast(OBJECT(dev), TYPE_PC_DIMM) &&
 202                       !(object_dynamic_cast(OBJECT(dev), TYPE_NVDIMM)))) {
 203        acpi_memory_unplug_request_cb(hotplug_dev, &s->memhp_state, dev, errp);
 204    } else {
 205        error_setg(errp, "acpi: device unplug request for unsupported device"
 206                   " type: %s", object_get_typename(OBJECT(dev)));
 207    }
 208}
 209
 210static void acpi_ged_unplug_cb(HotplugHandler *hotplug_dev,
 211                               DeviceState *dev, Error **errp)
 212{
 213    AcpiGedState *s = ACPI_GED(hotplug_dev);
 214
 215    if (object_dynamic_cast(OBJECT(dev), TYPE_PC_DIMM)) {
 216        acpi_memory_unplug_cb(&s->memhp_state, dev, errp);
 217    } else {
 218        error_setg(errp, "acpi: device unplug for unsupported device"
 219                   " type: %s", object_get_typename(OBJECT(dev)));
 220    }
 221}
 222
 223static void acpi_ged_send_event(AcpiDeviceIf *adev, AcpiEventStatusBits ev)
 224{
 225    AcpiGedState *s = ACPI_GED(adev);
 226    GEDState *ged_st = &s->ged_state;
 227    uint32_t sel;
 228
 229    if (ev & ACPI_MEMORY_HOTPLUG_STATUS) {
 230        sel = ACPI_GED_MEM_HOTPLUG_EVT;
 231    } else if (ev & ACPI_POWER_DOWN_STATUS) {
 232        sel = ACPI_GED_PWR_DOWN_EVT;
 233    } else if (ev & ACPI_NVDIMM_HOTPLUG_STATUS) {
 234        sel = ACPI_GED_NVDIMM_HOTPLUG_EVT;
 235    } else {
 236        /* Unknown event. Return without generating interrupt. */
 237        warn_report("GED: Unsupported event %d. No irq injected", ev);
 238        return;
 239    }
 240
 241    /*
 242     * Set the GED selector field to communicate the event type.
 243     * This will be read by GED aml code to select the appropriate
 244     * event method.
 245     */
 246    ged_st->sel |= sel;
 247
 248    /* Trigger the event by sending an interrupt to the guest. */
 249    qemu_irq_pulse(s->irq);
 250}
 251
 252static Property acpi_ged_properties[] = {
 253    DEFINE_PROP_UINT32("ged-event", AcpiGedState, ged_event_bitmap, 0),
 254    DEFINE_PROP_END_OF_LIST(),
 255};
 256
 257static const VMStateDescription vmstate_memhp_state = {
 258    .name = "acpi-ged/memhp",
 259    .version_id = 1,
 260    .minimum_version_id = 1,
 261    .fields      = (VMStateField[]) {
 262        VMSTATE_MEMORY_HOTPLUG(memhp_state, AcpiGedState),
 263        VMSTATE_END_OF_LIST()
 264    }
 265};
 266
 267static const VMStateDescription vmstate_ged_state = {
 268    .name = "acpi-ged-state",
 269    .version_id = 1,
 270    .minimum_version_id = 1,
 271    .fields      = (VMStateField[]) {
 272        VMSTATE_UINT32(sel, GEDState),
 273        VMSTATE_END_OF_LIST()
 274    }
 275};
 276
 277static bool ghes_needed(void *opaque)
 278{
 279    AcpiGedState *s = opaque;
 280    return s->ghes_state.ghes_addr_le;
 281}
 282
 283static const VMStateDescription vmstate_ghes_state = {
 284    .name = "acpi-ged/ghes",
 285    .version_id = 1,
 286    .minimum_version_id = 1,
 287    .needed = ghes_needed,
 288    .fields      = (VMStateField[]) {
 289        VMSTATE_STRUCT(ghes_state, AcpiGedState, 1,
 290                       vmstate_ghes_state, AcpiGhesState),
 291        VMSTATE_END_OF_LIST()
 292    }
 293};
 294
 295static const VMStateDescription vmstate_acpi_ged = {
 296    .name = "acpi-ged",
 297    .version_id = 1,
 298    .minimum_version_id = 1,
 299    .fields = (VMStateField[]) {
 300        VMSTATE_STRUCT(ged_state, AcpiGedState, 1, vmstate_ged_state, GEDState),
 301        VMSTATE_END_OF_LIST(),
 302    },
 303    .subsections = (const VMStateDescription * []) {
 304        &vmstate_memhp_state,
 305        &vmstate_ghes_state,
 306        NULL
 307    }
 308};
 309
 310static void acpi_ged_initfn(Object *obj)
 311{
 312    DeviceState *dev = DEVICE(obj);
 313    AcpiGedState *s = ACPI_GED(dev);
 314    SysBusDevice *sbd = SYS_BUS_DEVICE(obj);
 315    GEDState *ged_st = &s->ged_state;
 316
 317    memory_region_init_io(&ged_st->evt, obj, &ged_evt_ops, ged_st,
 318                          TYPE_ACPI_GED, ACPI_GED_EVT_SEL_LEN);
 319    sysbus_init_mmio(sbd, &ged_st->evt);
 320
 321    sysbus_init_irq(sbd, &s->irq);
 322
 323    s->memhp_state.is_enabled = true;
 324    /*
 325     * GED handles memory hotplug event and acpi-mem-hotplug
 326     * memory region gets initialized here. Create an exclusive
 327     * container for memory hotplug IO and expose it as GED sysbus
 328     * MMIO so that boards can map it separately.
 329     */
 330     memory_region_init(&s->container_memhp, OBJECT(dev), "memhp container",
 331                        MEMORY_HOTPLUG_IO_LEN);
 332     sysbus_init_mmio(sbd, &s->container_memhp);
 333     acpi_memory_hotplug_init(&s->container_memhp, OBJECT(dev),
 334                              &s->memhp_state, 0);
 335}
 336
 337static void acpi_ged_class_init(ObjectClass *class, void *data)
 338{
 339    DeviceClass *dc = DEVICE_CLASS(class);
 340    HotplugHandlerClass *hc = HOTPLUG_HANDLER_CLASS(class);
 341    AcpiDeviceIfClass *adevc = ACPI_DEVICE_IF_CLASS(class);
 342
 343    dc->desc = "ACPI Generic Event Device";
 344    device_class_set_props(dc, acpi_ged_properties);
 345    dc->vmsd = &vmstate_acpi_ged;
 346
 347    hc->plug = acpi_ged_device_plug_cb;
 348    hc->unplug_request = acpi_ged_unplug_request_cb;
 349    hc->unplug = acpi_ged_unplug_cb;
 350
 351    adevc->send_event = acpi_ged_send_event;
 352}
 353
 354static const TypeInfo acpi_ged_info = {
 355    .name          = TYPE_ACPI_GED,
 356    .parent        = TYPE_SYS_BUS_DEVICE,
 357    .instance_size = sizeof(AcpiGedState),
 358    .instance_init  = acpi_ged_initfn,
 359    .class_init    = acpi_ged_class_init,
 360    .interfaces = (InterfaceInfo[]) {
 361        { TYPE_HOTPLUG_HANDLER },
 362        { TYPE_ACPI_DEVICE_IF },
 363        { }
 364    }
 365};
 366
 367static void acpi_ged_register_types(void)
 368{
 369    type_register_static(&acpi_ged_info);
 370}
 371
 372type_init(acpi_ged_register_types)
 373