[deliverable/linux.git] / drivers / acpi / nfit.h

/*
 * NVDIMM Firmware Interface Table - NFIT
 *
 * Copyright(c) 2013-2015 Intel Corporation. All rights reserved.
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of version 2 of the GNU General Public License as
 * published by the Free Software Foundation.
 *
 * This program is distributed in the hope that it will be useful, but
 * WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * General Public License for more details.
 */
#ifndef __NFIT_H__
#define __NFIT_H__
#include <linux/libnvdimm.h>
#include <linux/types.h>
#include <linux/uuid.h>
#include <linux/acpi.h>
#include <acpi/acuuid.h>

#define UUID_NFIT_BUS "2f10e7a4-9e91-11e4-89d3-123b93f75cba"
#define UUID_NFIT_DIMM "4309ac30-0d11-11e4-9191-0800200c9a66"
#define ACPI_NFIT_MEM_FAILED_MASK (ACPI_NFIT_MEM_SAVE_FAILED \
		| ACPI_NFIT_MEM_RESTORE_FAILED | ACPI_NFIT_MEM_FLUSH_FAILED \
		| ACPI_NFIT_MEM_ARMED)

enum nfit_uuids {
	NFIT_SPA_VOLATILE,
	NFIT_SPA_PM,
	NFIT_SPA_DCR,
	NFIT_SPA_BDW,
	NFIT_SPA_VDISK,
	NFIT_SPA_VCD,
	NFIT_SPA_PDISK,
	NFIT_SPA_PCD,
	NFIT_DEV_BUS,
	NFIT_DEV_DIMM,
	NFIT_UUID_MAX,
};

enum {
	ND_BLK_READ_FLUSH = 1,
	ND_BLK_DCR_LATCH = 2,
};

struct nfit_spa {
	struct acpi_nfit_system_address *spa;
	struct list_head list;
};

struct nfit_dcr {
	struct acpi_nfit_control_region *dcr;
	struct list_head list;
};

struct nfit_bdw {
	struct acpi_nfit_data_region *bdw;
	struct list_head list;
};

struct nfit_idt {
	struct acpi_nfit_interleave *idt;
	struct list_head list;
};

struct nfit_flush {
	struct acpi_nfit_flush_address *flush;
	struct list_head list;
};

struct nfit_memdev {
	struct acpi_nfit_memory_map *memdev;
	struct list_head list;
};

/* assembled tables for a given dimm/memory-device */
struct nfit_mem {
	struct nvdimm *nvdimm;
	struct acpi_nfit_memory_map *memdev_dcr;
	struct acpi_nfit_memory_map *memdev_pmem;
	struct acpi_nfit_memory_map *memdev_bdw;
	struct acpi_nfit_control_region *dcr;
	struct acpi_nfit_data_region *bdw;
	struct acpi_nfit_system_address *spa_dcr;
	struct acpi_nfit_system_address *spa_bdw;
	struct acpi_nfit_interleave *idt_dcr;
	struct acpi_nfit_interleave *idt_bdw;
	struct nfit_flush *nfit_flush;
	struct list_head list;
	struct acpi_device *adev;
	unsigned long dsm_mask;
};

struct acpi_nfit_desc {
	struct nvdimm_bus_descriptor nd_desc;
	struct acpi_table_nfit *nfit;
	struct mutex spa_map_mutex;
	struct list_head spa_maps;
	struct list_head memdevs;
	struct list_head flushes;
	struct list_head dimms;
	struct list_head spas;
	struct list_head dcrs;
	struct list_head bdws;
	struct list_head idts;
	struct nvdimm_bus *nvdimm_bus;
	struct device *dev;
	unsigned long dimm_dsm_force_en;
	unsigned long bus_dsm_force_en;
	int (*blk_do_io)(struct nd_blk_region *ndbr, resource_size_t dpa,
			void *iobuf, u64 len, int rw);
};

enum nd_blk_mmio_selector {
	BDW,
	DCR,
};

struct nd_blk_addr {
	union {
		void __iomem *base;
		void __pmem  *aperture;
	};
};

struct nfit_blk {
	struct nfit_blk_mmio {
		struct nd_blk_addr addr;
		u64 size;
		u64 base_offset;
		u32 line_size;
		u32 num_lines;
		u32 table_size;
		struct acpi_nfit_interleave *idt;
		struct acpi_nfit_system_address *spa;
	} mmio[2];
	struct nd_region *nd_region;
	u64 bdw_offset; /* post interleave offset */
	u64 stat_offset;
	u64 cmd_offset;
	void __iomem *nvdimm_flush;
	u32 dimm_flags;
};

enum spa_map_type {
	SPA_MAP_CONTROL,
	SPA_MAP_APERTURE,
};

struct nfit_spa_mapping {
	struct acpi_nfit_desc *acpi_desc;
	struct acpi_nfit_system_address *spa;
	struct list_head list;
	struct kref kref;
	enum spa_map_type type;
	struct nd_blk_addr addr;
};

static inline struct nfit_spa_mapping *to_spa_map(struct kref *kref)
{
	return container_of(kref, struct nfit_spa_mapping, kref);
}

static inline struct acpi_nfit_memory_map *__to_nfit_memdev(
		struct nfit_mem *nfit_mem)
{
	if (nfit_mem->memdev_dcr)
		return nfit_mem->memdev_dcr;
	return nfit_mem->memdev_pmem;
}

static inline struct acpi_nfit_desc *to_acpi_desc(
		struct nvdimm_bus_descriptor *nd_desc)
{
	return container_of(nd_desc, struct acpi_nfit_desc, nd_desc);
}

const u8 *to_nfit_uuid(enum nfit_uuids id);
int acpi_nfit_init(struct acpi_nfit_desc *nfit, acpi_size sz);
extern const struct attribute_group *acpi_nfit_attribute_groups[];
#endif /* __NFIT_H__ */
Commit	Line	Data
b94d5230 DW	1	/*
	2	* NVDIMM Firmware Interface Table - NFIT
	3	*
	4	* Copyright(c) 2013-2015 Intel Corporation. All rights reserved.
	5	*
	6	* This program is free software; you can redistribute it and/or modify
	7	* it under the terms of version 2 of the GNU General Public License as
	8	* published by the Free Software Foundation.
	9	*
	10	* This program is distributed in the hope that it will be useful, but
	11	* WITHOUT ANY WARRANTY; without even the implied warranty of
	12	* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
	13	* General Public License for more details.
	14	*/
	15	#ifndef __NFIT_H__
	16	#define __NFIT_H__
	17	#include <linux/libnvdimm.h>
	18	#include <linux/types.h>
	19	#include <linux/uuid.h>
	20	#include <linux/acpi.h>
	21	#include <acpi/acuuid.h>
	22
	23	#define UUID_NFIT_BUS "2f10e7a4-9e91-11e4-89d3-123b93f75cba"
	24	#define UUID_NFIT_DIMM "4309ac30-0d11-11e4-9191-0800200c9a66"
58138820 DW	25	#define ACPI_NFIT_MEM_FAILED_MASK (ACPI_NFIT_MEM_SAVE_FAILED \
	26	\| ACPI_NFIT_MEM_RESTORE_FAILED \| ACPI_NFIT_MEM_FLUSH_FAILED \
	27	\| ACPI_NFIT_MEM_ARMED)
b94d5230 DW	28
	29	enum nfit_uuids {
	30	NFIT_SPA_VOLATILE,
	31	NFIT_SPA_PM,
	32	NFIT_SPA_DCR,
	33	NFIT_SPA_BDW,
	34	NFIT_SPA_VDISK,
	35	NFIT_SPA_VCD,
	36	NFIT_SPA_PDISK,
	37	NFIT_SPA_PCD,
	38	NFIT_DEV_BUS,
	39	NFIT_DEV_DIMM,
	40	NFIT_UUID_MAX,
	41	};
	42
f0f2c072	43	enum {
67a3e8fe	44	ND_BLK_READ_FLUSH = 1,
f0f2c072 RZ	45	ND_BLK_DCR_LATCH = 2,
	46	};
	47
b94d5230 DW	48	struct nfit_spa {
	49	struct acpi_nfit_system_address *spa;
	50	struct list_head list;
	51	};
	52
	53	struct nfit_dcr {
	54	struct acpi_nfit_control_region *dcr;
	55	struct list_head list;
	56	};
	57
	58	struct nfit_bdw {
	59	struct acpi_nfit_data_region *bdw;
	60	struct list_head list;
	61	};
	62
047fc8a1 RZ	63	struct nfit_idt {
	64	struct acpi_nfit_interleave *idt;
	65	struct list_head list;
	66	};
	67
c2ad2954 RZ	68	struct nfit_flush {
	69	struct acpi_nfit_flush_address *flush;
	70	struct list_head list;
	71	};
	72
b94d5230 DW	73	struct nfit_memdev {
	74	struct acpi_nfit_memory_map *memdev;
	75	struct list_head list;
	76	};
	77
	78	/* assembled tables for a given dimm/memory-device */
	79	struct nfit_mem {
e6dfb2de	80	struct nvdimm *nvdimm;
b94d5230 DW	81	struct acpi_nfit_memory_map *memdev_dcr;
b94d5230 DW	82	struct acpi_nfit_memory_map *memdev_pmem;
047fc8a1	83	struct acpi_nfit_memory_map *memdev_bdw;
b94d5230 DW	84	struct acpi_nfit_control_region *dcr;
	85	struct acpi_nfit_data_region *bdw;
	86	struct acpi_nfit_system_address *spa_dcr;
	87	struct acpi_nfit_system_address *spa_bdw;
047fc8a1 RZ	88	struct acpi_nfit_interleave *idt_dcr;
047fc8a1 RZ	89	struct acpi_nfit_interleave *idt_bdw;
c2ad2954	90	struct nfit_flush *nfit_flush;
b94d5230	91	struct list_head list;
62232e45 DW	92	struct acpi_device *adev;
62232e45 DW	93	unsigned long dsm_mask;
b94d5230 DW	94	};
	95
	96	struct acpi_nfit_desc {
	97	struct nvdimm_bus_descriptor nd_desc;
	98	struct acpi_table_nfit *nfit;
047fc8a1 RZ	99	struct mutex spa_map_mutex;
047fc8a1 RZ	100	struct list_head spa_maps;
b94d5230	101	struct list_head memdevs;
c2ad2954	102	struct list_head flushes;
b94d5230 DW	103	struct list_head dimms;
	104	struct list_head spas;
	105	struct list_head dcrs;
	106	struct list_head bdws;
047fc8a1	107	struct list_head idts;
b94d5230 DW	108	struct nvdimm_bus *nvdimm_bus;
b94d5230 DW	109	struct device *dev;
62232e45	110	unsigned long dimm_dsm_force_en;
39c686b8	111	unsigned long bus_dsm_force_en;
6bc75619 DW	112	int (blk_do_io)(struct nd_blk_region ndbr, resource_size_t dpa,
6bc75619 DW	113	void *iobuf, u64 len, int rw);
b94d5230 DW	114	};
b94d5230 DW	115
047fc8a1 RZ	116	enum nd_blk_mmio_selector {
	117	BDW,
	118	DCR,
	119	};
	120
67a3e8fe RZ	121	struct nd_blk_addr {
	122	union {
	123	void __iomem *base;
	124	void __pmem *aperture;
	125	};
	126	};
	127
047fc8a1 RZ	128	struct nfit_blk {
047fc8a1 RZ	129	struct nfit_blk_mmio {
67a3e8fe	130	struct nd_blk_addr addr;
047fc8a1 RZ	131	u64 size;
	132	u64 base_offset;
	133	u32 line_size;
	134	u32 num_lines;
	135	u32 table_size;
	136	struct acpi_nfit_interleave *idt;
	137	struct acpi_nfit_system_address *spa;
	138	} mmio[2];
	139	struct nd_region *nd_region;
	140	u64 bdw_offset; /* post interleave offset */
	141	u64 stat_offset;
	142	u64 cmd_offset;
c2ad2954	143	void __iomem *nvdimm_flush;
f0f2c072	144	u32 dimm_flags;
c2ad2954 RZ	145	};
	146
	147	enum spa_map_type {
	148	SPA_MAP_CONTROL,
	149	SPA_MAP_APERTURE,
047fc8a1 RZ	150	};
	151
	152	struct nfit_spa_mapping {
	153	struct acpi_nfit_desc *acpi_desc;
	154	struct acpi_nfit_system_address *spa;
	155	struct list_head list;
	156	struct kref kref;
67a3e8fe RZ	157	enum spa_map_type type;
67a3e8fe RZ	158	struct nd_blk_addr addr;
047fc8a1 RZ	159	};
	160
	161	static inline struct nfit_spa_mapping to_spa_map(struct kref kref)
	162	{
	163	return container_of(kref, struct nfit_spa_mapping, kref);
	164	}
	165
b94d5230 DW	166	static inline struct acpi_nfit_memory_map *__to_nfit_memdev(
	167	struct nfit_mem *nfit_mem)
	168	{
	169	if (nfit_mem->memdev_dcr)
	170	return nfit_mem->memdev_dcr;
	171	return nfit_mem->memdev_pmem;
	172	}
45def22c DW	173
	174	static inline struct acpi_nfit_desc *to_acpi_desc(
	175	struct nvdimm_bus_descriptor *nd_desc)
	176	{
	177	return container_of(nd_desc, struct acpi_nfit_desc, nd_desc);
	178	}
6bc75619 DW	179
	180	const u8 *to_nfit_uuid(enum nfit_uuids id);
	181	int acpi_nfit_init(struct acpi_nfit_desc *nfit, acpi_size sz);
	182	extern const struct attribute_group *acpi_nfit_attribute_groups[];
b94d5230	183	#endif /* __NFIT_H__ */