2015-12-02 08:20:56 +01:00
|
|
|
/*
|
|
|
|
* Non-Volatile Dual In-line Memory Module Virtualization Implementation
|
|
|
|
*
|
|
|
|
* Copyright(C) 2015 Intel Corporation.
|
|
|
|
*
|
|
|
|
* Author:
|
|
|
|
* Xiao Guangrong <guangrong.xiao@linux.intel.com>
|
|
|
|
*
|
|
|
|
* NVDIMM specifications and some documents can be found at:
|
|
|
|
* NVDIMM ACPI device and NFIT are introduced in ACPI 6:
|
|
|
|
* http://www.uefi.org/sites/default/files/resources/ACPI_6.0.pdf
|
|
|
|
* NVDIMM Namespace specification:
|
|
|
|
* http://pmem.io/documents/NVDIMM_Namespace_Spec.pdf
|
|
|
|
* DSM Interface Example:
|
|
|
|
* http://pmem.io/documents/NVDIMM_DSM_Interface_Example.pdf
|
|
|
|
* Driver Writer's Guide:
|
|
|
|
* http://pmem.io/documents/NVDIMM_Driver_Writers_Guide.pdf
|
|
|
|
*
|
|
|
|
* This work is licensed under the terms of the GNU GPL, version 2 or later.
|
|
|
|
* See the COPYING file in the top-level directory.
|
|
|
|
*/
|
|
|
|
|
|
|
|
#ifndef QEMU_NVDIMM_H
|
|
|
|
#define QEMU_NVDIMM_H
|
|
|
|
|
|
|
|
#include "hw/mem/pc-dimm.h"
|
2016-05-19 15:19:25 +02:00
|
|
|
#include "hw/acpi/bios-linker-loader.h"
|
2015-12-02 08:20:56 +01:00
|
|
|
|
2016-03-04 17:00:35 +01:00
|
|
|
#define NVDIMM_DEBUG 0
|
|
|
|
#define nvdimm_debug(fmt, ...) \
|
|
|
|
do { \
|
|
|
|
if (NVDIMM_DEBUG) { \
|
|
|
|
fprintf(stderr, "nvdimm: " fmt, ## __VA_ARGS__); \
|
|
|
|
} \
|
|
|
|
} while (0)
|
|
|
|
|
2016-06-07 14:21:58 +02:00
|
|
|
/*
|
|
|
|
* The minimum label data size is required by NVDIMM Namespace
|
|
|
|
* specification, see the chapter 2 Namespaces:
|
|
|
|
* "NVDIMMs following the NVDIMM Block Mode Specification use an area
|
|
|
|
* at least 128KB in size, which holds around 1000 labels."
|
|
|
|
*/
|
|
|
|
#define MIN_NAMESPACE_LABEL_SIZE (128UL << 10)
|
|
|
|
|
|
|
|
#define TYPE_NVDIMM "nvdimm"
|
|
|
|
#define NVDIMM(obj) OBJECT_CHECK(NVDIMMDevice, (obj), TYPE_NVDIMM)
|
|
|
|
#define NVDIMM_CLASS(oc) OBJECT_CLASS_CHECK(NVDIMMClass, (oc), TYPE_NVDIMM)
|
|
|
|
#define NVDIMM_GET_CLASS(obj) OBJECT_GET_CLASS(NVDIMMClass, (obj), \
|
|
|
|
TYPE_NVDIMM)
|
2017-12-11 08:28:05 +01:00
|
|
|
|
2018-05-21 18:32:00 +02:00
|
|
|
#define NVDIMM_LABEL_SIZE_PROP "label-size"
|
2017-12-11 08:28:06 +01:00
|
|
|
#define NVDIMM_UNARMED_PROP "unarmed"
|
2017-12-11 08:28:05 +01:00
|
|
|
|
2016-06-07 14:21:58 +02:00
|
|
|
struct NVDIMMDevice {
|
|
|
|
/* private */
|
|
|
|
PCDIMMDevice parent_obj;
|
|
|
|
|
|
|
|
/* public */
|
|
|
|
|
|
|
|
/*
|
|
|
|
* the size of label data in NVDIMM device which is presented to
|
|
|
|
* guest via __DSM "Get Namespace Label Size" function.
|
|
|
|
*/
|
|
|
|
uint64_t label_size;
|
|
|
|
|
|
|
|
/*
|
|
|
|
* the address of label data which is read by __DSM "Get Namespace
|
|
|
|
* Label Data" function and written by __DSM "Set Namespace Label
|
|
|
|
* Data" function.
|
|
|
|
*/
|
|
|
|
void *label_data;
|
|
|
|
|
|
|
|
/*
|
|
|
|
* it's the PMEM region in NVDIMM device, which is presented to
|
|
|
|
* guest via ACPI NFIT and _FIT method if NVDIMM hotplug is supported.
|
|
|
|
*/
|
2018-06-19 15:41:39 +02:00
|
|
|
MemoryRegion *nvdimm_mr;
|
2017-12-11 08:28:06 +01:00
|
|
|
|
|
|
|
/*
|
|
|
|
* The 'on' value results in the unarmed flag set in ACPI NFIT,
|
|
|
|
* which can be used to notify guest implicitly that the host
|
|
|
|
* backend (e.g., files on HDD, /dev/pmemX, etc.) cannot guarantee
|
|
|
|
* the guest write persistence.
|
|
|
|
*/
|
|
|
|
bool unarmed;
|
2016-06-07 14:21:58 +02:00
|
|
|
};
|
|
|
|
typedef struct NVDIMMDevice NVDIMMDevice;
|
|
|
|
|
|
|
|
struct NVDIMMClass {
|
|
|
|
/* private */
|
|
|
|
PCDIMMDeviceClass parent_class;
|
|
|
|
|
|
|
|
/* public */
|
|
|
|
|
|
|
|
/* read @size bytes from NVDIMM label data at @offset into @buf. */
|
|
|
|
void (*read_label_data)(NVDIMMDevice *nvdimm, void *buf,
|
|
|
|
uint64_t size, uint64_t offset);
|
|
|
|
/* write @size bytes from @buf to NVDIMM label data at @offset. */
|
|
|
|
void (*write_label_data)(NVDIMMDevice *nvdimm, const void *buf,
|
|
|
|
uint64_t size, uint64_t offset);
|
|
|
|
};
|
|
|
|
typedef struct NVDIMMClass NVDIMMClass;
|
nvdimm acpi: build ACPI NFIT table
NFIT is defined in ACPI 6.0: 5.2.25 NVDIMM Firmware Interface Table (NFIT)
Currently, we only support PMEM mode. Each device has 3 structures:
- SPA structure, defines the PMEM region info
- MEM DEV structure, it has the @handle which is used to associate specified
ACPI NVDIMM device we will introduce in later patch.
Also we can happily ignored the memory device's interleave, the real
nvdimm hardware access is hidden behind host
- DCR structure, it defines vendor ID used to associate specified vendor
nvdimm driver. Since we only implement PMEM mode this time, Command
window and Data window are not needed
The NVDIMM functionality is controlled by the parameter, 'nvdimm', which
is introduced for the machine, there is a example to enable it:
-machine pc,nvdimm -m 8G,maxmem=100G,slots=100 -object \
memory-backend-file,id=mem1,share,mem-path=/tmp/nvdimm1,size=10G -device \
nvdimm,memdev=mem1,id=nv1
It is disabled on default
Reviewed-by: Stefan Hajnoczi <stefanha@redhat.com>
Signed-off-by: Xiao Guangrong <guangrong.xiao@linux.intel.com>
Reviewed-by: Michael S. Tsirkin <mst@redhat.com>
Signed-off-by: Michael S. Tsirkin <mst@redhat.com>
2015-12-02 08:20:58 +01:00
|
|
|
|
2016-03-04 17:00:32 +01:00
|
|
|
#define NVDIMM_DSM_MEM_FILE "etc/acpi/nvdimm-mem"
|
|
|
|
|
|
|
|
/*
|
|
|
|
* 32 bits IO port starting from 0x0a18 in guest is reserved for
|
|
|
|
* NVDIMM ACPI emulation.
|
|
|
|
*/
|
|
|
|
#define NVDIMM_ACPI_IO_BASE 0x0a18
|
|
|
|
#define NVDIMM_ACPI_IO_LEN 4
|
|
|
|
|
2016-10-28 18:35:38 +02:00
|
|
|
/*
|
2016-11-07 12:13:37 +01:00
|
|
|
* NvdimmFitBuffer:
|
|
|
|
* @fit: FIT structures for present NVDIMMs. It is updated when
|
|
|
|
* the NVDIMM device is plugged or unplugged.
|
|
|
|
* @dirty: It allows OSPM to detect change and restart read in
|
|
|
|
* progress if there is any.
|
2016-10-28 18:35:38 +02:00
|
|
|
*/
|
|
|
|
struct NvdimmFitBuffer {
|
|
|
|
GArray *fit;
|
|
|
|
bool dirty;
|
|
|
|
};
|
|
|
|
typedef struct NvdimmFitBuffer NvdimmFitBuffer;
|
|
|
|
|
2019-03-08 19:20:52 +01:00
|
|
|
struct NVDIMMState {
|
2016-03-04 17:00:32 +01:00
|
|
|
/* detect if NVDIMM support is enabled. */
|
|
|
|
bool is_enabled;
|
|
|
|
|
|
|
|
/* the data of the fw_cfg file NVDIMM_DSM_MEM_FILE. */
|
|
|
|
GArray *dsm_mem;
|
2016-10-28 18:35:38 +02:00
|
|
|
|
|
|
|
NvdimmFitBuffer fit_buf;
|
|
|
|
|
2016-03-04 17:00:32 +01:00
|
|
|
/* the IO region used by OSPM to transfer control to QEMU. */
|
|
|
|
MemoryRegion io_mr;
|
2018-05-21 18:32:02 +02:00
|
|
|
|
|
|
|
/*
|
|
|
|
* Platform capabilities, section 5.2.25.9 of ACPI 6.2 Errata A
|
|
|
|
*/
|
2018-06-08 00:31:11 +02:00
|
|
|
int32_t persistence;
|
|
|
|
char *persistence_string;
|
2016-03-04 17:00:32 +01:00
|
|
|
};
|
2019-03-08 19:20:52 +01:00
|
|
|
typedef struct NVDIMMState NVDIMMState;
|
2016-03-04 17:00:32 +01:00
|
|
|
|
2019-03-08 19:20:52 +01:00
|
|
|
void nvdimm_init_acpi_state(NVDIMMState *state, MemoryRegion *io,
|
2016-03-04 17:00:32 +01:00
|
|
|
FWCfgState *fw_cfg, Object *owner);
|
nvdimm acpi: build ACPI NFIT table
NFIT is defined in ACPI 6.0: 5.2.25 NVDIMM Firmware Interface Table (NFIT)
Currently, we only support PMEM mode. Each device has 3 structures:
- SPA structure, defines the PMEM region info
- MEM DEV structure, it has the @handle which is used to associate specified
ACPI NVDIMM device we will introduce in later patch.
Also we can happily ignored the memory device's interleave, the real
nvdimm hardware access is hidden behind host
- DCR structure, it defines vendor ID used to associate specified vendor
nvdimm driver. Since we only implement PMEM mode this time, Command
window and Data window are not needed
The NVDIMM functionality is controlled by the parameter, 'nvdimm', which
is introduced for the machine, there is a example to enable it:
-machine pc,nvdimm -m 8G,maxmem=100G,slots=100 -object \
memory-backend-file,id=mem1,share,mem-path=/tmp/nvdimm1,size=10G -device \
nvdimm,memdev=mem1,id=nv1
It is disabled on default
Reviewed-by: Stefan Hajnoczi <stefanha@redhat.com>
Signed-off-by: Xiao Guangrong <guangrong.xiao@linux.intel.com>
Reviewed-by: Michael S. Tsirkin <mst@redhat.com>
Signed-off-by: Michael S. Tsirkin <mst@redhat.com>
2015-12-02 08:20:58 +01:00
|
|
|
void nvdimm_build_acpi(GArray *table_offsets, GArray *table_data,
|
2019-03-08 19:20:52 +01:00
|
|
|
BIOSLinker *linker, NVDIMMState *state,
|
2016-10-28 18:35:37 +02:00
|
|
|
uint32_t ram_slots);
|
2019-03-08 19:20:52 +01:00
|
|
|
void nvdimm_plug(NVDIMMState *state);
|
2016-11-07 12:13:38 +01:00
|
|
|
void nvdimm_acpi_plug_cb(HotplugHandler *hotplug_dev, DeviceState *dev);
|
2015-12-02 08:20:56 +01:00
|
|
|
#endif
|