[linux-2.6-block.git] / drivers / peci / internal.h

/* SPDX-License-Identifier: GPL-2.0-only */
/* Copyright (c) 2018-2021 Intel Corporation */

#ifndef __PECI_INTERNAL_H
#define __PECI_INTERNAL_H

#include <linux/device.h>
#include <linux/types.h>

struct peci_controller;
struct attribute_group;
struct peci_device;
struct peci_request;

/* PECI CPU address range 0x30-0x37 */
#define PECI_BASE_ADDR		0x30
#define PECI_DEVICE_NUM_MAX	8

struct peci_request *peci_request_alloc(struct peci_device *device, u8 tx_len, u8 rx_len);
void peci_request_free(struct peci_request *req);

int peci_request_status(struct peci_request *req);

u64 peci_request_dib_read(struct peci_request *req);
s16 peci_request_temp_read(struct peci_request *req);

u8 peci_request_data_readb(struct peci_request *req);
u16 peci_request_data_readw(struct peci_request *req);
u32 peci_request_data_readl(struct peci_request *req);
u64 peci_request_data_readq(struct peci_request *req);

struct peci_request *peci_xfer_get_dib(struct peci_device *device);
struct peci_request *peci_xfer_get_temp(struct peci_device *device);

struct peci_request *peci_xfer_pkg_cfg_readb(struct peci_device *device, u8 index, u16 param);
struct peci_request *peci_xfer_pkg_cfg_readw(struct peci_device *device, u8 index, u16 param);
struct peci_request *peci_xfer_pkg_cfg_readl(struct peci_device *device, u8 index, u16 param);
struct peci_request *peci_xfer_pkg_cfg_readq(struct peci_device *device, u8 index, u16 param);

struct peci_request *peci_xfer_pci_cfg_local_readb(struct peci_device *device,
						   u8 bus, u8 dev, u8 func, u16 reg);
struct peci_request *peci_xfer_pci_cfg_local_readw(struct peci_device *device,
						   u8 bus, u8 dev, u8 func, u16 reg);
struct peci_request *peci_xfer_pci_cfg_local_readl(struct peci_device *device,
						   u8 bus, u8 dev, u8 func, u16 reg);

struct peci_request *peci_xfer_ep_pci_cfg_local_readb(struct peci_device *device, u8 seg,
						      u8 bus, u8 dev, u8 func, u16 reg);
struct peci_request *peci_xfer_ep_pci_cfg_local_readw(struct peci_device *device, u8 seg,
						      u8 bus, u8 dev, u8 func, u16 reg);
struct peci_request *peci_xfer_ep_pci_cfg_local_readl(struct peci_device *device, u8 seg,
						      u8 bus, u8 dev, u8 func, u16 reg);

struct peci_request *peci_xfer_ep_pci_cfg_readb(struct peci_device *device, u8 seg,
						u8 bus, u8 dev, u8 func, u16 reg);
struct peci_request *peci_xfer_ep_pci_cfg_readw(struct peci_device *device, u8 seg,
						u8 bus, u8 dev, u8 func, u16 reg);
struct peci_request *peci_xfer_ep_pci_cfg_readl(struct peci_device *device, u8 seg,
						u8 bus, u8 dev, u8 func, u16 reg);

struct peci_request *peci_xfer_ep_mmio32_readl(struct peci_device *device, u8 bar, u8 seg,
					       u8 bus, u8 dev, u8 func, u64 offset);

struct peci_request *peci_xfer_ep_mmio64_readl(struct peci_device *device, u8 bar, u8 seg,
					       u8 bus, u8 dev, u8 func, u64 offset);
/**
 * struct peci_device_id - PECI device data to match
 * @data: pointer to driver private data specific to device
 * @x86_vfm: device vendor-family-model
 */
struct peci_device_id {
	const void *data;
	u32 x86_vfm;
};

extern const struct device_type peci_device_type;
extern const struct attribute_group *peci_device_groups[];

int peci_device_create(struct peci_controller *controller, u8 addr);
void peci_device_destroy(struct peci_device *device);

extern const struct bus_type peci_bus_type;
extern const struct attribute_group *peci_bus_groups[];

/**
 * struct peci_driver - PECI driver
 * @driver: inherit device driver
 * @probe: probe callback
 * @remove: remove callback
 * @id_table: PECI device match table to decide which device to bind
 */
struct peci_driver {
	struct device_driver driver;
	int (*probe)(struct peci_device *device, const struct peci_device_id *id);
	void (*remove)(struct peci_device *device);
	const struct peci_device_id *id_table;
};

#define to_peci_driver(__drv)	container_of_const(__drv, struct peci_driver, driver)

int __peci_driver_register(struct peci_driver *driver, struct module *owner,
			   const char *mod_name);
/**
 * peci_driver_register() - register PECI driver
 * @driver: the driver to be registered
 *
 * PECI drivers that don't need to do anything special in module init should
 * use the convenience "module_peci_driver" macro instead
 *
 * Return: zero on success, else a negative error code.
 */
#define peci_driver_register(driver) \
	__peci_driver_register(driver, THIS_MODULE, KBUILD_MODNAME)
void peci_driver_unregister(struct peci_driver *driver);

/**
 * module_peci_driver() - helper macro for registering a modular PECI driver
 * @__peci_driver: peci_driver struct
 *
 * Helper macro for PECI drivers which do not do anything special in module
 * init/exit. This eliminates a lot of boilerplate. Each module may only
 * use this macro once, and calling it replaces module_init() and module_exit()
 */
#define module_peci_driver(__peci_driver) \
	module_driver(__peci_driver, peci_driver_register, peci_driver_unregister)

extern const struct device_type peci_controller_type;

int peci_controller_scan_devices(struct peci_controller *controller);

#endif /* __PECI_INTERNAL_H */
Commit	Line	Data
6523d3b2 IW	1	/* SPDX-License-Identifier: GPL-2.0-only */
	2	/* Copyright (c) 2018-2021 Intel Corporation */
	3
	4	#ifndef __PECI_INTERNAL_H
	5	#define __PECI_INTERNAL_H
	6
	7	#include <linux/device.h>
	8	#include <linux/types.h>
	9
	10	struct peci_controller;
42bed52b	11	struct attribute_group;
52857e68 IW	12	struct peci_device;
	13	struct peci_request;
	14
	15	/* PECI CPU address range 0x30-0x37 */
	16	#define PECI_BASE_ADDR 0x30
	17	#define PECI_DEVICE_NUM_MAX 8
	18
	19	struct peci_request peci_request_alloc(struct peci_device device, u8 tx_len, u8 rx_len);
	20	void peci_request_free(struct peci_request *req);
	21
6b8145b0 IW	22	int peci_request_status(struct peci_request *req);
	23
	24	u64 peci_request_dib_read(struct peci_request *req);
93e1821c	25	s16 peci_request_temp_read(struct peci_request *req);
6b8145b0 IW	26
	27	u8 peci_request_data_readb(struct peci_request *req);
	28	u16 peci_request_data_readw(struct peci_request *req);
	29	u32 peci_request_data_readl(struct peci_request *req);
	30	u64 peci_request_data_readq(struct peci_request *req);
	31
	32	struct peci_request peci_xfer_get_dib(struct peci_device device);
	33	struct peci_request peci_xfer_get_temp(struct peci_device device);
	34
	35	struct peci_request peci_xfer_pkg_cfg_readb(struct peci_device device, u8 index, u16 param);
	36	struct peci_request peci_xfer_pkg_cfg_readw(struct peci_device device, u8 index, u16 param);
	37	struct peci_request peci_xfer_pkg_cfg_readl(struct peci_device device, u8 index, u16 param);
	38	struct peci_request peci_xfer_pkg_cfg_readq(struct peci_device device, u8 index, u16 param);
	39
93e1821c IW	40	struct peci_request peci_xfer_pci_cfg_local_readb(struct peci_device device,
	41	u8 bus, u8 dev, u8 func, u16 reg);
	42	struct peci_request peci_xfer_pci_cfg_local_readw(struct peci_device device,
	43	u8 bus, u8 dev, u8 func, u16 reg);
	44	struct peci_request peci_xfer_pci_cfg_local_readl(struct peci_device device,
	45	u8 bus, u8 dev, u8 func, u16 reg);
	46
	47	struct peci_request peci_xfer_ep_pci_cfg_local_readb(struct peci_device device, u8 seg,
	48	u8 bus, u8 dev, u8 func, u16 reg);
	49	struct peci_request peci_xfer_ep_pci_cfg_local_readw(struct peci_device device, u8 seg,
	50	u8 bus, u8 dev, u8 func, u16 reg);
	51	struct peci_request peci_xfer_ep_pci_cfg_local_readl(struct peci_device device, u8 seg,
	52	u8 bus, u8 dev, u8 func, u16 reg);
	53
	54	struct peci_request peci_xfer_ep_pci_cfg_readb(struct peci_device device, u8 seg,
	55	u8 bus, u8 dev, u8 func, u16 reg);
	56	struct peci_request peci_xfer_ep_pci_cfg_readw(struct peci_device device, u8 seg,
	57	u8 bus, u8 dev, u8 func, u16 reg);
	58	struct peci_request peci_xfer_ep_pci_cfg_readl(struct peci_device device, u8 seg,
	59	u8 bus, u8 dev, u8 func, u16 reg);
	60
	61	struct peci_request peci_xfer_ep_mmio32_readl(struct peci_device device, u8 bar, u8 seg,
	62	u8 bus, u8 dev, u8 func, u64 offset);
	63
	64	struct peci_request peci_xfer_ep_mmio64_readl(struct peci_device device, u8 bar, u8 seg,
	65	u8 bus, u8 dev, u8 func, u64 offset);
6b8145b0 IW	66	/**
	67	* struct peci_device_id - PECI device data to match
	68	* @data: pointer to driver private data specific to device
a43b9ec0	69	* @x86_vfm: device vendor-family-model
6b8145b0 IW	70	*/
	71	struct peci_device_id {
	72	const void *data;
a43b9ec0	73	u32 x86_vfm;
6b8145b0 IW	74	};
6b8145b0 IW	75
e6faf2b7	76	extern const struct device_type peci_device_type;
42bed52b	77	extern const struct attribute_group *peci_device_groups[];
52857e68 IW	78
	79	int peci_device_create(struct peci_controller *controller, u8 addr);
	80	void peci_device_destroy(struct peci_device *device);
6523d3b2	81
ed8c2dad	82	extern const struct bus_type peci_bus_type;
42bed52b	83	extern const struct attribute_group *peci_bus_groups[];
6523d3b2	84
6b8145b0 IW	85	/**
	86	* struct peci_driver - PECI driver
	87	* @driver: inherit device driver
	88	* @probe: probe callback
	89	* @remove: remove callback
	90	* @id_table: PECI device match table to decide which device to bind
	91	*/
	92	struct peci_driver {
	93	struct device_driver driver;
	94	int (probe)(struct peci_device device, const struct peci_device_id *id);
	95	void (remove)(struct peci_device device);
	96	const struct peci_device_id *id_table;
	97	};
	98
d69d8048	99	#define to_peci_driver(__drv) container_of_const(__drv, struct peci_driver, driver)
6b8145b0 IW	100
	101	int __peci_driver_register(struct peci_driver driver, struct module owner,
	102	const char *mod_name);
	103	/**
	104	* peci_driver_register() - register PECI driver
	105	* @driver: the driver to be registered
	106	*
	107	* PECI drivers that don't need to do anything special in module init should
	108	* use the convenience "module_peci_driver" macro instead
	109	*
	110	* Return: zero on success, else a negative error code.
	111	*/
	112	#define peci_driver_register(driver) \
	113	__peci_driver_register(driver, THIS_MODULE, KBUILD_MODNAME)
	114	void peci_driver_unregister(struct peci_driver *driver);
	115
	116	/**
	117	* module_peci_driver() - helper macro for registering a modular PECI driver
	118	* @__peci_driver: peci_driver struct
	119	*
	120	* Helper macro for PECI drivers which do not do anything special in module
	121	* init/exit. This eliminates a lot of boilerplate. Each module may only
	122	* use this macro once, and calling it replaces module_init() and module_exit()
	123	*/
	124	#define module_peci_driver(__peci_driver) \
	125	module_driver(__peci_driver, peci_driver_register, peci_driver_unregister)
	126
e6faf2b7	127	extern const struct device_type peci_controller_type;
6523d3b2	128
42bed52b IW	129	int peci_controller_scan_devices(struct peci_controller *controller);
42bed52b IW	130
6523d3b2	131	#endif /* __PECI_INTERNAL_H */