xref: /OK3568_Linux_fs/kernel/drivers/scsi/be2iscsi/be.h (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1*4882a593Smuzhiyun /* SPDX-License-Identifier: GPL-2.0-only */
2*4882a593Smuzhiyun /*
3*4882a593Smuzhiyun  * Copyright 2017 Broadcom. All Rights Reserved.
4*4882a593Smuzhiyun  * The term "Broadcom" refers to Broadcom Limited and/or its subsidiaries.
5*4882a593Smuzhiyun  *
6*4882a593Smuzhiyun  * Contact Information:
7*4882a593Smuzhiyun  * linux-drivers@broadcom.com
8*4882a593Smuzhiyun  */
9*4882a593Smuzhiyun 
10*4882a593Smuzhiyun #ifndef BEISCSI_H
11*4882a593Smuzhiyun #define BEISCSI_H
12*4882a593Smuzhiyun 
13*4882a593Smuzhiyun #include <linux/pci.h>
14*4882a593Smuzhiyun #include <linux/if_vlan.h>
15*4882a593Smuzhiyun #include <linux/irq_poll.h>
16*4882a593Smuzhiyun #define FW_VER_LEN	32
17*4882a593Smuzhiyun #define MCC_Q_LEN	128
18*4882a593Smuzhiyun #define MCC_CQ_LEN	256
19*4882a593Smuzhiyun #define MAX_MCC_CMD	16
20*4882a593Smuzhiyun /* BladeEngine Generation numbers */
21*4882a593Smuzhiyun #define BE_GEN2 2
22*4882a593Smuzhiyun #define BE_GEN3 3
23*4882a593Smuzhiyun #define BE_GEN4	4
24*4882a593Smuzhiyun struct be_dma_mem {
25*4882a593Smuzhiyun 	void *va;
26*4882a593Smuzhiyun 	dma_addr_t dma;
27*4882a593Smuzhiyun 	u32 size;
28*4882a593Smuzhiyun };
29*4882a593Smuzhiyun 
30*4882a593Smuzhiyun struct be_queue_info {
31*4882a593Smuzhiyun 	struct be_dma_mem dma_mem;
32*4882a593Smuzhiyun 	u16 len;
33*4882a593Smuzhiyun 	u16 entry_size;		/* Size of an element in the queue */
34*4882a593Smuzhiyun 	u16 id;
35*4882a593Smuzhiyun 	u16 tail, head;
36*4882a593Smuzhiyun 	bool created;
37*4882a593Smuzhiyun 	u16 used;		/* Number of valid elements in the queue */
38*4882a593Smuzhiyun };
39*4882a593Smuzhiyun 
MODULO(u16 val,u16 limit)40*4882a593Smuzhiyun static inline u32 MODULO(u16 val, u16 limit)
41*4882a593Smuzhiyun {
42*4882a593Smuzhiyun 	WARN_ON(limit & (limit - 1));
43*4882a593Smuzhiyun 	return val & (limit - 1);
44*4882a593Smuzhiyun }
45*4882a593Smuzhiyun 
index_inc(u16 * index,u16 limit)46*4882a593Smuzhiyun static inline void index_inc(u16 *index, u16 limit)
47*4882a593Smuzhiyun {
48*4882a593Smuzhiyun 	*index = MODULO((*index + 1), limit);
49*4882a593Smuzhiyun }
50*4882a593Smuzhiyun 
queue_head_node(struct be_queue_info * q)51*4882a593Smuzhiyun static inline void *queue_head_node(struct be_queue_info *q)
52*4882a593Smuzhiyun {
53*4882a593Smuzhiyun 	return q->dma_mem.va + q->head * q->entry_size;
54*4882a593Smuzhiyun }
55*4882a593Smuzhiyun 
queue_get_wrb(struct be_queue_info * q,unsigned int wrb_num)56*4882a593Smuzhiyun static inline void *queue_get_wrb(struct be_queue_info *q, unsigned int wrb_num)
57*4882a593Smuzhiyun {
58*4882a593Smuzhiyun 	return q->dma_mem.va + wrb_num * q->entry_size;
59*4882a593Smuzhiyun }
60*4882a593Smuzhiyun 
queue_tail_node(struct be_queue_info * q)61*4882a593Smuzhiyun static inline void *queue_tail_node(struct be_queue_info *q)
62*4882a593Smuzhiyun {
63*4882a593Smuzhiyun 	return q->dma_mem.va + q->tail * q->entry_size;
64*4882a593Smuzhiyun }
65*4882a593Smuzhiyun 
queue_head_inc(struct be_queue_info * q)66*4882a593Smuzhiyun static inline void queue_head_inc(struct be_queue_info *q)
67*4882a593Smuzhiyun {
68*4882a593Smuzhiyun 	index_inc(&q->head, q->len);
69*4882a593Smuzhiyun }
70*4882a593Smuzhiyun 
queue_tail_inc(struct be_queue_info * q)71*4882a593Smuzhiyun static inline void queue_tail_inc(struct be_queue_info *q)
72*4882a593Smuzhiyun {
73*4882a593Smuzhiyun 	index_inc(&q->tail, q->len);
74*4882a593Smuzhiyun }
75*4882a593Smuzhiyun 
76*4882a593Smuzhiyun /*ISCSI */
77*4882a593Smuzhiyun 
78*4882a593Smuzhiyun struct be_aic_obj {		/* Adaptive interrupt coalescing (AIC) info */
79*4882a593Smuzhiyun 	unsigned long jiffies;
80*4882a593Smuzhiyun 	u32 eq_prev;		/* Used to calculate eqe */
81*4882a593Smuzhiyun 	u32 prev_eqd;
82*4882a593Smuzhiyun #define BEISCSI_EQ_DELAY_MIN	0
83*4882a593Smuzhiyun #define BEISCSI_EQ_DELAY_DEF	32
84*4882a593Smuzhiyun #define BEISCSI_EQ_DELAY_MAX	128
85*4882a593Smuzhiyun };
86*4882a593Smuzhiyun 
87*4882a593Smuzhiyun struct be_eq_obj {
88*4882a593Smuzhiyun 	u32 cq_count;
89*4882a593Smuzhiyun 	struct be_queue_info q;
90*4882a593Smuzhiyun 	struct beiscsi_hba *phba;
91*4882a593Smuzhiyun 	struct be_queue_info *cq;
92*4882a593Smuzhiyun 	struct work_struct mcc_work; /* Work Item */
93*4882a593Smuzhiyun 	struct irq_poll	iopoll;
94*4882a593Smuzhiyun };
95*4882a593Smuzhiyun 
96*4882a593Smuzhiyun struct be_mcc_obj {
97*4882a593Smuzhiyun 	struct be_queue_info q;
98*4882a593Smuzhiyun 	struct be_queue_info cq;
99*4882a593Smuzhiyun };
100*4882a593Smuzhiyun 
101*4882a593Smuzhiyun struct beiscsi_mcc_tag_state {
102*4882a593Smuzhiyun 	unsigned long tag_state;
103*4882a593Smuzhiyun #define MCC_TAG_STATE_RUNNING	0
104*4882a593Smuzhiyun #define MCC_TAG_STATE_TIMEOUT	1
105*4882a593Smuzhiyun #define MCC_TAG_STATE_ASYNC	2
106*4882a593Smuzhiyun #define MCC_TAG_STATE_IGNORE	3
107*4882a593Smuzhiyun 	void (*cbfn)(struct beiscsi_hba *, unsigned int);
108*4882a593Smuzhiyun 	struct be_dma_mem tag_mem_state;
109*4882a593Smuzhiyun };
110*4882a593Smuzhiyun 
111*4882a593Smuzhiyun struct be_ctrl_info {
112*4882a593Smuzhiyun 	u8 __iomem *csr;
113*4882a593Smuzhiyun 	u8 __iomem *db;		/* Door Bell */
114*4882a593Smuzhiyun 	u8 __iomem *pcicfg;	/* PCI config space */
115*4882a593Smuzhiyun 	struct pci_dev *pdev;
116*4882a593Smuzhiyun 
117*4882a593Smuzhiyun 	/* Mbox used for cmd request/response */
118*4882a593Smuzhiyun 	struct mutex mbox_lock;	/* For serializing mbox cmds to BE card */
119*4882a593Smuzhiyun 	struct be_dma_mem mbox_mem;
120*4882a593Smuzhiyun 	/* Mbox mem is adjusted to align to 16 bytes. The allocated addr
121*4882a593Smuzhiyun 	 * is stored for freeing purpose */
122*4882a593Smuzhiyun 	struct be_dma_mem mbox_mem_alloced;
123*4882a593Smuzhiyun 
124*4882a593Smuzhiyun 	/* MCC Rings */
125*4882a593Smuzhiyun 	struct be_mcc_obj mcc_obj;
126*4882a593Smuzhiyun 	spinlock_t mcc_lock;	/* For serializing mcc cmds to BE card */
127*4882a593Smuzhiyun 
128*4882a593Smuzhiyun 	wait_queue_head_t mcc_wait[MAX_MCC_CMD + 1];
129*4882a593Smuzhiyun 	unsigned int mcc_tag[MAX_MCC_CMD];
130*4882a593Smuzhiyun 	unsigned int mcc_tag_status[MAX_MCC_CMD + 1];
131*4882a593Smuzhiyun 	unsigned short mcc_alloc_index;
132*4882a593Smuzhiyun 	unsigned short mcc_free_index;
133*4882a593Smuzhiyun 	unsigned int mcc_tag_available;
134*4882a593Smuzhiyun 
135*4882a593Smuzhiyun 	struct beiscsi_mcc_tag_state ptag_state[MAX_MCC_CMD + 1];
136*4882a593Smuzhiyun };
137*4882a593Smuzhiyun 
138*4882a593Smuzhiyun #include "be_cmds.h"
139*4882a593Smuzhiyun 
140*4882a593Smuzhiyun /* WRB index mask for MCC_Q_LEN queue entries */
141*4882a593Smuzhiyun #define MCC_Q_WRB_IDX_MASK	CQE_STATUS_WRB_MASK
142*4882a593Smuzhiyun #define MCC_Q_WRB_IDX_SHIFT	CQE_STATUS_WRB_SHIFT
143*4882a593Smuzhiyun /* TAG is from 1...MAX_MCC_CMD, MASK includes MAX_MCC_CMD */
144*4882a593Smuzhiyun #define MCC_Q_CMD_TAG_MASK	((MAX_MCC_CMD << 1) - 1)
145*4882a593Smuzhiyun 
146*4882a593Smuzhiyun #define PAGE_SHIFT_4K		12
147*4882a593Smuzhiyun #define PAGE_SIZE_4K		(1 << PAGE_SHIFT_4K)
148*4882a593Smuzhiyun 
149*4882a593Smuzhiyun /* Returns number of pages spanned by the data starting at the given addr */
150*4882a593Smuzhiyun #define PAGES_4K_SPANNED(_address, size)				\
151*4882a593Smuzhiyun 		((u32)((((size_t)(_address) & (PAGE_SIZE_4K - 1)) +	\
152*4882a593Smuzhiyun 			(size) + (PAGE_SIZE_4K - 1)) >> PAGE_SHIFT_4K))
153*4882a593Smuzhiyun 
154*4882a593Smuzhiyun /* Returns bit offset within a DWORD of a bitfield */
155*4882a593Smuzhiyun #define AMAP_BIT_OFFSET(_struct, field)					\
156*4882a593Smuzhiyun 		(((size_t)&(((_struct *)0)->field))%32)
157*4882a593Smuzhiyun 
158*4882a593Smuzhiyun /* Returns the bit mask of the field that is NOT shifted into location. */
amap_mask(u32 bitsize)159*4882a593Smuzhiyun static inline u32 amap_mask(u32 bitsize)
160*4882a593Smuzhiyun {
161*4882a593Smuzhiyun 	return (bitsize == 32 ? 0xFFFFFFFF : (1 << bitsize) - 1);
162*4882a593Smuzhiyun }
163*4882a593Smuzhiyun 
amap_set(void * ptr,u32 dw_offset,u32 mask,u32 offset,u32 value)164*4882a593Smuzhiyun static inline void amap_set(void *ptr, u32 dw_offset, u32 mask,
165*4882a593Smuzhiyun 					u32 offset, u32 value)
166*4882a593Smuzhiyun {
167*4882a593Smuzhiyun 	u32 *dw = (u32 *) ptr + dw_offset;
168*4882a593Smuzhiyun 	*dw &= ~(mask << offset);
169*4882a593Smuzhiyun 	*dw |= (mask & value) << offset;
170*4882a593Smuzhiyun }
171*4882a593Smuzhiyun 
172*4882a593Smuzhiyun #define AMAP_SET_BITS(_struct, field, ptr, val)				\
173*4882a593Smuzhiyun 		amap_set(ptr,						\
174*4882a593Smuzhiyun 			offsetof(_struct, field)/32,			\
175*4882a593Smuzhiyun 			amap_mask(sizeof(((_struct *)0)->field)),	\
176*4882a593Smuzhiyun 			AMAP_BIT_OFFSET(_struct, field),		\
177*4882a593Smuzhiyun 			val)
178*4882a593Smuzhiyun 
amap_get(void * ptr,u32 dw_offset,u32 mask,u32 offset)179*4882a593Smuzhiyun static inline u32 amap_get(void *ptr, u32 dw_offset, u32 mask, u32 offset)
180*4882a593Smuzhiyun {
181*4882a593Smuzhiyun 	u32 *dw = ptr;
182*4882a593Smuzhiyun 	return mask & (*(dw + dw_offset) >> offset);
183*4882a593Smuzhiyun }
184*4882a593Smuzhiyun 
185*4882a593Smuzhiyun #define AMAP_GET_BITS(_struct, field, ptr)				\
186*4882a593Smuzhiyun 		amap_get(ptr,						\
187*4882a593Smuzhiyun 			offsetof(_struct, field)/32,			\
188*4882a593Smuzhiyun 			amap_mask(sizeof(((_struct *)0)->field)),	\
189*4882a593Smuzhiyun 			AMAP_BIT_OFFSET(_struct, field))
190*4882a593Smuzhiyun 
191*4882a593Smuzhiyun #define be_dws_cpu_to_le(wrb, len) swap_dws(wrb, len)
192*4882a593Smuzhiyun #define be_dws_le_to_cpu(wrb, len) swap_dws(wrb, len)
swap_dws(void * wrb,int len)193*4882a593Smuzhiyun static inline void swap_dws(void *wrb, int len)
194*4882a593Smuzhiyun {
195*4882a593Smuzhiyun #ifdef __BIG_ENDIAN
196*4882a593Smuzhiyun 	u32 *dw = wrb;
197*4882a593Smuzhiyun 	WARN_ON(len % 4);
198*4882a593Smuzhiyun 	do {
199*4882a593Smuzhiyun 		*dw = cpu_to_le32(*dw);
200*4882a593Smuzhiyun 		dw++;
201*4882a593Smuzhiyun 		len -= 4;
202*4882a593Smuzhiyun 	} while (len);
203*4882a593Smuzhiyun #endif /* __BIG_ENDIAN */
204*4882a593Smuzhiyun }
205*4882a593Smuzhiyun #endif /* BEISCSI_H */
206