[linux-2.6-block.git] / arch / powerpc / include / asm / vas.h

/* SPDX-License-Identifier: GPL-2.0-or-later */
/*
 * Copyright 2016-17 IBM Corp.
 */

#ifndef _ASM_POWERPC_VAS_H
#define _ASM_POWERPC_VAS_H

struct vas_window;

/*
 * Min and max FIFO sizes are based on Version 1.05 Section 3.1.4.25
 * (Local FIFO Size Register) of the VAS workbook.
 */
#define VAS_RX_FIFO_SIZE_MIN	(1 << 10)	/* 1KB */
#define VAS_RX_FIFO_SIZE_MAX	(8 << 20)	/* 8MB */

/*
 * Threshold Control Mode: Have paste operation fail if the number of
 * requests in receive FIFO exceeds a threshold.
 *
 * NOTE: No special error code yet if paste is rejected because of these
 *	 limits. So users can't distinguish between this and other errors.
 */
#define VAS_THRESH_DISABLED		0
#define VAS_THRESH_FIFO_GT_HALF_FULL	1
#define VAS_THRESH_FIFO_GT_QTR_FULL	2
#define VAS_THRESH_FIFO_GT_EIGHTH_FULL	3

/*
 * Get/Set bit fields
 */
#define GET_FIELD(m, v)                (((v) & (m)) >> MASK_LSH(m))
#define MASK_LSH(m)            (__builtin_ffsl(m) - 1)
#define SET_FIELD(m, v, val)   \
		(((v) & ~(m)) | ((((typeof(v))(val)) << MASK_LSH(m)) & (m)))

/*
 * Co-processor Engine type.
 */
enum vas_cop_type {
	VAS_COP_TYPE_FAULT,
	VAS_COP_TYPE_842,
	VAS_COP_TYPE_842_HIPRI,
	VAS_COP_TYPE_GZIP,
	VAS_COP_TYPE_GZIP_HIPRI,
	VAS_COP_TYPE_FTW,
	VAS_COP_TYPE_MAX,
};

/*
 * Receive window attributes specified by the (in-kernel) owner of window.
 */
struct vas_rx_win_attr {
	void *rx_fifo;
	int rx_fifo_size;
	int wcreds_max;

	bool pin_win;
	bool rej_no_credit;
	bool tx_wcred_mode;
	bool rx_wcred_mode;
	bool tx_win_ord_mode;
	bool rx_win_ord_mode;
	bool data_stamp;
	bool nx_win;
	bool fault_win;
	bool user_win;
	bool notify_disable;
	bool intr_disable;
	bool notify_early;

	int lnotify_lpid;
	int lnotify_pid;
	int lnotify_tid;
	u32 pswid;

	int tc_mode;
};

/*
 * Window attributes specified by the in-kernel owner of a send window.
 */
struct vas_tx_win_attr {
	enum vas_cop_type cop;
	int wcreds_max;
	int lpid;
	int pidr;		/* hardware PID (from SPRN_PID) */
	int pid;		/* linux process id */
	int pswid;
	int rsvd_txbuf_count;
	int tc_mode;

	bool user_win;
	bool pin_win;
	bool rej_no_credit;
	bool rsvd_txbuf_enable;
	bool tx_wcred_mode;
	bool rx_wcred_mode;
	bool tx_win_ord_mode;
	bool rx_win_ord_mode;
};

/*
 * Helper to map a chip id to VAS id.
 * For POWER9, this is a 1:1 mapping. In the future this maybe a 1:N
 * mapping in which case, we will need to update this helper.
 *
 * Return the VAS id or -1 if no matching vasid is found.
 */
int chip_to_vas_id(int chipid);

/*
 * Helper to initialize receive window attributes to defaults for an
 * NX window.
 */
void vas_init_rx_win_attr(struct vas_rx_win_attr *rxattr, enum vas_cop_type cop);

/*
 * Open a VAS receive window for the instance of VAS identified by @vasid
 * Use @attr to initialize the attributes of the window.
 *
 * Return a handle to the window or ERR_PTR() on error.
 */
struct vas_window *vas_rx_win_open(int vasid, enum vas_cop_type cop,
				   struct vas_rx_win_attr *attr);

/*
 * Helper to initialize send window attributes to defaults for an NX window.
 */
extern void vas_init_tx_win_attr(struct vas_tx_win_attr *txattr,
			enum vas_cop_type cop);

/*
 * Open a VAS send window for the instance of VAS identified by @vasid
 * and the co-processor type @cop. Use @attr to initialize attributes
 * of the window.
 *
 * Note: The instance of VAS must already have an open receive window for
 * the coprocessor type @cop.
 *
 * Return a handle to the send window or ERR_PTR() on error.
 */
struct vas_window *vas_tx_win_open(int vasid, enum vas_cop_type cop,
			struct vas_tx_win_attr *attr);

/*
 * Close the send or receive window identified by @win. For receive windows
 * return -EAGAIN if there are active send windows attached to this receive
 * window.
 */
int vas_win_close(struct vas_window *win);

/*
 * Copy the co-processor request block (CRB) @crb into the local L2 cache.
 */
int vas_copy_crb(void *crb, int offset);

/*
 * Paste a previously copied CRB (see vas_copy_crb()) from the L2 cache to
 * the hardware address associated with the window @win. @re is expected/
 * assumed to be true for NX windows.
 */
int vas_paste_crb(struct vas_window *win, int offset, bool re);

#endif /* __ASM_POWERPC_VAS_H */
Commit	Line	Data
2874c5fd	1	/* SPDX-License-Identifier: GPL-2.0-or-later */
96768914 SB	2	/*
96768914 SB	3	* Copyright 2016-17 IBM Corp.
96768914 SB	4	*/
	5
	6	#ifndef _ASM_POWERPC_VAS_H
	7	#define _ASM_POWERPC_VAS_H
	8
5676be2f SB	9	struct vas_window;
5676be2f SB	10
96768914 SB	11	/*
	12	* Min and max FIFO sizes are based on Version 1.05 Section 3.1.4.25
	13	* (Local FIFO Size Register) of the VAS workbook.
	14	*/
	15	#define VAS_RX_FIFO_SIZE_MIN (1 << 10) /* 1KB */
	16	#define VAS_RX_FIFO_SIZE_MAX (8 << 20) /* 8MB */
	17
	18	/*
	19	* Threshold Control Mode: Have paste operation fail if the number of
	20	* requests in receive FIFO exceeds a threshold.
	21	*
	22	* NOTE: No special error code yet if paste is rejected because of these
	23	* limits. So users can't distinguish between this and other errors.
	24	*/
	25	#define VAS_THRESH_DISABLED 0
	26	#define VAS_THRESH_FIFO_GT_HALF_FULL 1
	27	#define VAS_THRESH_FIFO_GT_QTR_FULL 2
	28	#define VAS_THRESH_FIFO_GT_EIGHTH_FULL 3
	29
b6622a33 SB	30	/*
	31	* Get/Set bit fields
	32	*/
	33	#define GET_FIELD(m, v) (((v) & (m)) >> MASK_LSH(m))
	34	#define MASK_LSH(m) (__builtin_ffsl(m) - 1)
	35	#define SET_FIELD(m, v, val) \
	36	(((v) & ~(m)) \| ((((typeof(v))(val)) << MASK_LSH(m)) & (m)))
	37
96768914 SB	38	/*
	39	* Co-processor Engine type.
	40	*/
	41	enum vas_cop_type {
	42	VAS_COP_TYPE_FAULT,
	43	VAS_COP_TYPE_842,
	44	VAS_COP_TYPE_842_HIPRI,
	45	VAS_COP_TYPE_GZIP,
	46	VAS_COP_TYPE_GZIP_HIPRI,
	47	VAS_COP_TYPE_FTW,
	48	VAS_COP_TYPE_MAX,
	49	};
	50
62c4eda4 SB	51	/*
	52	* Receive window attributes specified by the (in-kernel) owner of window.
	53	*/
	54	struct vas_rx_win_attr {
	55	void *rx_fifo;
	56	int rx_fifo_size;
	57	int wcreds_max;
	58
	59	bool pin_win;
	60	bool rej_no_credit;
	61	bool tx_wcred_mode;
	62	bool rx_wcred_mode;
	63	bool tx_win_ord_mode;
	64	bool rx_win_ord_mode;
	65	bool data_stamp;
	66	bool nx_win;
	67	bool fault_win;
	68	bool user_win;
	69	bool notify_disable;
	70	bool intr_disable;
	71	bool notify_early;
	72
	73	int lnotify_lpid;
	74	int lnotify_pid;
	75	int lnotify_tid;
	76	u32 pswid;
	77
	78	int tc_mode;
	79	};
	80
5239af67 SB	81	/*
	82	* Window attributes specified by the in-kernel owner of a send window.
	83	*/
	84	struct vas_tx_win_attr {
	85	enum vas_cop_type cop;
	86	int wcreds_max;
	87	int lpid;
	88	int pidr; /* hardware PID (from SPRN_PID) */
	89	int pid; /* linux process id */
	90	int pswid;
	91	int rsvd_txbuf_count;
	92	int tc_mode;
	93
	94	bool user_win;
	95	bool pin_win;
	96	bool rej_no_credit;
	97	bool rsvd_txbuf_enable;
	98	bool tx_wcred_mode;
	99	bool rx_wcred_mode;
	100	bool tx_win_ord_mode;
	101	bool rx_win_ord_mode;
	102	};
	103
d4ef61b5 SB	104	/*
	105	* Helper to map a chip id to VAS id.
	106	* For POWER9, this is a 1:1 mapping. In the future this maybe a 1:N
	107	* mapping in which case, we will need to update this helper.
	108	*
	109	* Return the VAS id or -1 if no matching vasid is found.
	110	*/
	111	int chip_to_vas_id(int chipid);
	112
62c4eda4 SB	113	/*
	114	* Helper to initialize receive window attributes to defaults for an
	115	* NX window.
	116	*/
	117	void vas_init_rx_win_attr(struct vas_rx_win_attr *rxattr, enum vas_cop_type cop);
	118
	119	/*
	120	* Open a VAS receive window for the instance of VAS identified by @vasid
	121	* Use @attr to initialize the attributes of the window.
	122	*
	123	* Return a handle to the window or ERR_PTR() on error.
	124	*/
	125	struct vas_window *vas_rx_win_open(int vasid, enum vas_cop_type cop,
	126	struct vas_rx_win_attr *attr);
	127
5239af67 SB	128	/*
	129	* Helper to initialize send window attributes to defaults for an NX window.
	130	*/
	131	extern void vas_init_tx_win_attr(struct vas_tx_win_attr *txattr,
	132	enum vas_cop_type cop);
	133
	134	/*
	135	* Open a VAS send window for the instance of VAS identified by @vasid
	136	* and the co-processor type @cop. Use @attr to initialize attributes
	137	* of the window.
	138	*
	139	* Note: The instance of VAS must already have an open receive window for
	140	* the coprocessor type @cop.
	141	*
	142	* Return a handle to the send window or ERR_PTR() on error.
	143	*/
	144	struct vas_window *vas_tx_win_open(int vasid, enum vas_cop_type cop,
	145	struct vas_tx_win_attr *attr);
	146
98271d41 SB	147	/*
	148	* Close the send or receive window identified by @win. For receive windows
	149	* return -EAGAIN if there are active send windows attached to this receive
	150	* window.
	151	*/
	152	int vas_win_close(struct vas_window *win);
	153
2392c8c8 SB	154	/*
	155	* Copy the co-processor request block (CRB) @crb into the local L2 cache.
	156	*/
	157	int vas_copy_crb(void *crb, int offset);
	158
	159	/*
	160	* Paste a previously copied CRB (see vas_copy_crb()) from the L2 cache to
	161	* the hardware address associated with the window @win. @re is expected/
	162	* assumed to be true for NX windows.
	163	*/
	164	int vas_paste_crb(struct vas_window *win, int offset, bool re);
	165
96768914	166	#endif /* __ASM_POWERPC_VAS_H */