1/*
2 * This file is part of the Chelsio FCoE driver for Linux.
3 *
4 * Copyright (c) 2008-2012 Chelsio Communications, Inc. All rights reserved.
5 *
6 * This software is available to you under a choice of one of two
7 * licenses.  You may choose to be licensed under the terms of the GNU
8 * General Public License (GPL) Version 2, available from the file
9 * COPYING in the main directory of this source tree, or the
10 * OpenIB.org BSD license below:
11 *
12 *     Redistribution and use in source and binary forms, with or
13 *     without modification, are permitted provided that the following
14 *     conditions are met:
15 *
16 *      - Redistributions of source code must retain the above
17 *        copyright notice, this list of conditions and the following
18 *        disclaimer.
19 *
20 *      - Redistributions in binary form must reproduce the above
21 *        copyright notice, this list of conditions and the following
22 *        disclaimer in the documentation and/or other materials
23 *        provided with the distribution.
24 *
25 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
26 * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
27 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
28 * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS
29 * BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
30 * ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
31 * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
32 * SOFTWARE.
33 */
34
35#ifndef __CSIO_WR_H__
36#define __CSIO_WR_H__
37
38#include <linux/cache.h>
39
40#include "csio_defs.h"
41#include "t4fw_api.h"
42#include "t4fw_api_stor.h"
43
44/*
45 * SGE register field values.
46 */
47#define X_INGPCIEBOUNDARY_32B		0
48#define X_INGPCIEBOUNDARY_64B		1
49#define X_INGPCIEBOUNDARY_128B		2
50#define X_INGPCIEBOUNDARY_256B		3
51#define X_INGPCIEBOUNDARY_512B		4
52#define X_INGPCIEBOUNDARY_1024B		5
53#define X_INGPCIEBOUNDARY_2048B		6
54#define X_INGPCIEBOUNDARY_4096B		7
55
56/* GTS register */
57#define X_TIMERREG_COUNTER0		0
58#define X_TIMERREG_COUNTER1		1
59#define X_TIMERREG_COUNTER2		2
60#define X_TIMERREG_COUNTER3		3
61#define X_TIMERREG_COUNTER4		4
62#define X_TIMERREG_COUNTER5		5
63#define X_TIMERREG_RESTART_COUNTER	6
64#define X_TIMERREG_UPDATE_CIDX		7
65
66/*
67 * Egress Context field values
68 */
69#define X_FETCHBURSTMIN_16B		0
70#define X_FETCHBURSTMIN_32B		1
71#define X_FETCHBURSTMIN_64B		2
72#define X_FETCHBURSTMIN_128B		3
73
74#define X_FETCHBURSTMAX_64B		0
75#define X_FETCHBURSTMAX_128B		1
76#define X_FETCHBURSTMAX_256B		2
77#define X_FETCHBURSTMAX_512B		3
78
79#define X_HOSTFCMODE_NONE		0
80#define X_HOSTFCMODE_INGRESS_QUEUE	1
81#define X_HOSTFCMODE_STATUS_PAGE	2
82#define X_HOSTFCMODE_BOTH		3
83
84/*
85 * Ingress Context field values
86 */
87#define X_UPDATESCHEDULING_TIMER	0
88#define X_UPDATESCHEDULING_COUNTER_OPTTIMER	1
89
90#define X_UPDATEDELIVERY_NONE		0
91#define X_UPDATEDELIVERY_INTERRUPT	1
92#define X_UPDATEDELIVERY_STATUS_PAGE	2
93#define X_UPDATEDELIVERY_BOTH		3
94
95#define X_INTERRUPTDESTINATION_PCIE	0
96#define X_INTERRUPTDESTINATION_IQ	1
97
98#define X_RSPD_TYPE_FLBUF		0
99#define X_RSPD_TYPE_CPL			1
100#define X_RSPD_TYPE_INTR		2
101
102/* WR status is at the same position as retval in a CMD header */
103#define csio_wr_status(_wr)		\
104		(FW_CMD_RETVAL_G(ntohl(((struct fw_cmd_hdr *)(_wr))->lo)))
105
106struct csio_hw;
107
108extern int csio_intr_coalesce_cnt;
109extern int csio_intr_coalesce_time;
110
111/* Ingress queue params */
112struct csio_iq_params {
113
114	uint8_t		iq_start:1;
115	uint8_t		iq_stop:1;
116	uint8_t		pfn:3;
117
118	uint8_t		vfn;
119
120	uint16_t	physiqid;
121	uint16_t	iqid;
122
123	uint16_t	fl0id;
124	uint16_t	fl1id;
125
126	uint8_t		viid;
127
128	uint8_t		type;
129	uint8_t		iqasynch;
130	uint8_t		reserved4;
131
132	uint8_t		iqandst;
133	uint8_t		iqanus;
134	uint8_t		iqanud;
135
136	uint16_t	iqandstindex;
137
138	uint8_t		iqdroprss;
139	uint8_t		iqpciech;
140	uint8_t		iqdcaen;
141
142	uint8_t		iqdcacpu;
143	uint8_t		iqintcntthresh;
144	uint8_t		iqo;
145
146	uint8_t		iqcprio;
147	uint8_t		iqesize;
148
149	uint16_t	iqsize;
150
151	uint64_t	iqaddr;
152
153	uint8_t		iqflintiqhsen;
154	uint8_t		reserved5;
155	uint8_t		iqflintcongen;
156	uint8_t		iqflintcngchmap;
157
158	uint32_t	reserved6;
159
160	uint8_t		fl0hostfcmode;
161	uint8_t		fl0cprio;
162	uint8_t		fl0paden;
163	uint8_t		fl0packen;
164	uint8_t		fl0congen;
165	uint8_t		fl0dcaen;
166
167	uint8_t		fl0dcacpu;
168	uint8_t		fl0fbmin;
169
170	uint8_t		fl0fbmax;
171	uint8_t		fl0cidxfthresho;
172	uint8_t		fl0cidxfthresh;
173
174	uint16_t	fl0size;
175
176	uint64_t	fl0addr;
177
178	uint64_t	reserved7;
179
180	uint8_t		fl1hostfcmode;
181	uint8_t		fl1cprio;
182	uint8_t		fl1paden;
183	uint8_t		fl1packen;
184	uint8_t		fl1congen;
185	uint8_t		fl1dcaen;
186
187	uint8_t		fl1dcacpu;
188	uint8_t		fl1fbmin;
189
190	uint8_t		fl1fbmax;
191	uint8_t		fl1cidxfthresho;
192	uint8_t		fl1cidxfthresh;
193
194	uint16_t	fl1size;
195
196	uint64_t	fl1addr;
197};
198
199/* Egress queue params */
200struct csio_eq_params {
201
202	uint8_t		pfn;
203	uint8_t		vfn;
204
205	uint8_t		eqstart:1;
206	uint8_t		eqstop:1;
207
208	uint16_t        physeqid;
209	uint32_t	eqid;
210
211	uint8_t		hostfcmode:2;
212	uint8_t		cprio:1;
213	uint8_t		pciechn:3;
214
215	uint16_t	iqid;
216
217	uint8_t		dcaen:1;
218	uint8_t		dcacpu:5;
219
220	uint8_t		fbmin:3;
221	uint8_t		fbmax:3;
222
223	uint8_t		cidxfthresho:1;
224	uint8_t		cidxfthresh:3;
225
226	uint16_t	eqsize;
227
228	uint64_t	eqaddr;
229};
230
231struct csio_dma_buf {
232	struct list_head	list;
233	void			*vaddr;		/* Virtual address */
234	dma_addr_t		paddr;		/* Physical address */
235	uint32_t		len;		/* Buffer size */
236};
237
238/* Generic I/O request structure */
239struct csio_ioreq {
240	struct csio_sm		sm;		/* SM, List
241						 * should be the first member
242						 */
243	int			iq_idx;		/* Ingress queue index */
244	int			eq_idx;		/* Egress queue index */
245	uint32_t		nsge;		/* Number of SG elements */
246	uint32_t		tmo;		/* Driver timeout */
247	uint32_t		datadir;	/* Data direction */
248	struct csio_dma_buf	dma_buf;	/* Req/resp DMA buffers */
249	uint16_t		wr_status;	/* WR completion status */
250	int16_t			drv_status;	/* Driver internal status */
251	struct csio_lnode	*lnode;		/* Owner lnode */
252	struct csio_rnode	*rnode;		/* Src/destination rnode */
253	void (*io_cbfn) (struct csio_hw *, struct csio_ioreq *);
254						/* completion callback */
255	void			*scratch1;	/* Scratch area 1.
256						 */
257	void			*scratch2;	/* Scratch area 2. */
258	struct list_head	gen_list;	/* Any list associated with
259						 * this ioreq.
260						 */
261	uint64_t		fw_handle;	/* Unique handle passed
262						 * to FW
263						 */
264	uint8_t			dcopy;		/* Data copy required */
265	uint8_t			reserved1;
266	uint16_t		reserved2;
267	struct completion	cmplobj;	/* ioreq completion object */
268} ____cacheline_aligned_in_smp;
269
270/*
271 * Egress status page for egress cidx updates
272 */
273struct csio_qstatus_page {
274	__be32 qid;
275	__be16 cidx;
276	__be16 pidx;
277};
278
279
280enum {
281	CSIO_MAX_FLBUF_PER_IQWR = 4,
282	CSIO_QCREDIT_SZ  = 64,			/* pidx/cidx increments
283						 * in bytes
284						 */
285	CSIO_MAX_QID = 0xFFFF,
286	CSIO_MAX_IQ = 128,
287
288	CSIO_SGE_NTIMERS = 6,
289	CSIO_SGE_NCOUNTERS = 4,
290	CSIO_SGE_FL_SIZE_REGS = 16,
291};
292
293/* Defines for type */
294enum {
295	CSIO_EGRESS	= 1,
296	CSIO_INGRESS	= 2,
297	CSIO_FREELIST	= 3,
298};
299
300/*
301 * Structure for footer (last 2 flits) of Ingress Queue Entry.
302 */
303struct csio_iqwr_footer {
304	__be32			hdrbuflen_pidx;
305	__be32			pldbuflen_qid;
306	union {
307		u8		type_gen;
308		__be64		last_flit;
309	} u;
310};
311
312#define IQWRF_NEWBUF		(1 << 31)
313#define IQWRF_LEN_GET(x)	(((x) >> 0) & 0x7fffffffU)
314#define IQWRF_GEN_SHIFT		7
315#define IQWRF_TYPE_GET(x)	(((x) >> 4) & 0x3U)
316
317
318/*
319 * WR pair:
320 * ========
321 * A WR can start towards the end of a queue, and then continue at the
322 * beginning, since the queue is considered to be circular. This will
323 * require a pair of address/len to be passed back to the caller -
324 * hence the Work request pair structure.
325 */
326struct csio_wr_pair {
327	void			*addr1;
328	uint32_t		size1;
329	void			*addr2;
330	uint32_t		size2;
331};
332
333/*
334 * The following structure is used by ingress processing to return the
335 * free list buffers to consumers.
336 */
337struct csio_fl_dma_buf {
338	struct csio_dma_buf	flbufs[CSIO_MAX_FLBUF_PER_IQWR];
339						/* Freelist DMA buffers */
340	int			offset;		/* Offset within the
341						 * first FL buf.
342						 */
343	uint32_t		totlen;		/* Total length */
344	uint8_t			defer_free;	/* Free of buffer can
345						 * deferred
346						 */
347};
348
349/* Data-types */
350typedef void (*iq_handler_t)(struct csio_hw *, void *, uint32_t,
351			     struct csio_fl_dma_buf *, void *);
352
353struct csio_iq {
354	uint16_t		iqid;		/* Queue ID */
355	uint16_t		physiqid;	/* Physical Queue ID */
356	uint16_t		genbit;		/* Generation bit,
357						 * initially set to 1
358						 */
359	int			flq_idx;	/* Freelist queue index */
360	iq_handler_t		iq_intx_handler; /* IQ INTx handler routine */
361};
362
363struct csio_eq {
364	uint16_t		eqid;		/* Qid */
365	uint16_t		physeqid;	/* Physical Queue ID */
366	uint8_t			wrap[512];	/* Temp area for q-wrap around*/
367};
368
369struct csio_fl {
370	uint16_t		flid;		/* Qid */
371	uint16_t		packen;		/* Packing enabled? */
372	int			offset;		/* Offset within FL buf */
373	int			sreg;		/* Size register */
374	struct csio_dma_buf	*bufs;		/* Free list buffer ptr array
375						 * indexed using flq->cidx/pidx
376						 */
377};
378
379struct csio_qstats {
380	uint32_t	n_tot_reqs;		/* Total no. of Requests */
381	uint32_t	n_tot_rsps;		/* Total no. of responses */
382	uint32_t	n_qwrap;		/* Queue wraps */
383	uint32_t	n_eq_wr_split;		/* Number of split EQ WRs */
384	uint32_t	n_qentry;		/* Queue entry */
385	uint32_t	n_qempty;		/* Queue empty */
386	uint32_t	n_qfull;		/* Queue fulls */
387	uint32_t	n_rsp_unknown;		/* Unknown response type */
388	uint32_t	n_stray_comp;		/* Stray completion intr */
389	uint32_t	n_flq_refill;		/* Number of FL refills */
390};
391
392/* Queue metadata */
393struct csio_q {
394	uint16_t		type;		/* Type: Ingress/Egress/FL */
395	uint16_t		pidx;		/* producer index */
396	uint16_t		cidx;		/* consumer index */
397	uint16_t		inc_idx;	/* Incremental index */
398	uint32_t		wr_sz;		/* Size of all WRs in this q
399						 * if fixed
400						 */
401	void			*vstart;	/* Base virtual address
402						 * of queue
403						 */
404	void			*vwrap;		/* Virtual end address to
405						 * wrap around at
406						 */
407	uint32_t		credits;	/* Size of queue in credits */
408	void			*owner;		/* Owner */
409	union {					/* Queue contexts */
410		struct csio_iq	iq;
411		struct csio_eq	eq;
412		struct csio_fl	fl;
413	} un;
414
415	dma_addr_t		pstart;		/* Base physical address of
416						 * queue
417						 */
418	uint32_t		portid;		/* PCIE Channel */
419	uint32_t		size;		/* Size of queue in bytes */
420	struct csio_qstats	stats;		/* Statistics */
421} ____cacheline_aligned_in_smp;
422
423struct csio_sge {
424	uint32_t	csio_fl_align;		/* Calculated and cached
425						 * for fast path
426						 */
427	uint32_t	sge_control;		/* padding, boundaries,
428						 * lengths, etc.
429						 */
430	uint32_t	sge_host_page_size;	/* Host page size */
431	uint32_t	sge_fl_buf_size[CSIO_SGE_FL_SIZE_REGS];
432						/* free list buffer sizes */
433	uint16_t	timer_val[CSIO_SGE_NTIMERS];
434	uint8_t		counter_val[CSIO_SGE_NCOUNTERS];
435};
436
437/* Work request module */
438struct csio_wrm {
439	int			num_q;		/* Number of queues */
440	struct csio_q		**q_arr;	/* Array of queue pointers
441						 * allocated dynamically
442						 * based on configured values
443						 */
444	uint32_t		fw_iq_start;	/* Start ID of IQ for this fn*/
445	uint32_t		fw_eq_start;	/* Start ID of EQ for this fn*/
446	struct csio_q		*intr_map[CSIO_MAX_IQ];
447						/* IQ-id to IQ map table. */
448	int			free_qidx;	/* queue idx of free queue */
449	struct csio_sge		sge;		/* SGE params */
450};
451
452#define csio_get_q(__hw, __idx)		((__hw)->wrm.q_arr[__idx])
453#define	csio_q_type(__hw, __idx)	((__hw)->wrm.q_arr[(__idx)]->type)
454#define	csio_q_pidx(__hw, __idx)	((__hw)->wrm.q_arr[(__idx)]->pidx)
455#define	csio_q_cidx(__hw, __idx)	((__hw)->wrm.q_arr[(__idx)]->cidx)
456#define	csio_q_inc_idx(__hw, __idx)	((__hw)->wrm.q_arr[(__idx)]->inc_idx)
457#define	csio_q_vstart(__hw, __idx)	((__hw)->wrm.q_arr[(__idx)]->vstart)
458#define	csio_q_pstart(__hw, __idx)	((__hw)->wrm.q_arr[(__idx)]->pstart)
459#define	csio_q_size(__hw, __idx)	((__hw)->wrm.q_arr[(__idx)]->size)
460#define	csio_q_credits(__hw, __idx)	((__hw)->wrm.q_arr[(__idx)]->credits)
461#define	csio_q_portid(__hw, __idx)	((__hw)->wrm.q_arr[(__idx)]->portid)
462#define	csio_q_wr_sz(__hw, __idx)	((__hw)->wrm.q_arr[(__idx)]->wr_sz)
463#define	csio_q_iqid(__hw, __idx)	((__hw)->wrm.q_arr[(__idx)]->un.iq.iqid)
464#define csio_q_physiqid(__hw, __idx)					\
465				((__hw)->wrm.q_arr[(__idx)]->un.iq.physiqid)
466#define csio_q_iq_flq_idx(__hw, __idx)					\
467				((__hw)->wrm.q_arr[(__idx)]->un.iq.flq_idx)
468#define	csio_q_eqid(__hw, __idx)	((__hw)->wrm.q_arr[(__idx)]->un.eq.eqid)
469#define	csio_q_flid(__hw, __idx)	((__hw)->wrm.q_arr[(__idx)]->un.fl.flid)
470
471#define csio_q_physeqid(__hw, __idx)					\
472				((__hw)->wrm.q_arr[(__idx)]->un.eq.physeqid)
473#define csio_iq_has_fl(__iq)		((__iq)->un.iq.flq_idx != -1)
474
475#define csio_q_iq_to_flid(__hw, __iq_idx)				\
476	csio_q_flid((__hw), (__hw)->wrm.q_arr[(__iq_qidx)]->un.iq.flq_idx)
477#define csio_q_set_intr_map(__hw, __iq_idx, __rel_iq_id)		\
478		(__hw)->wrm.intr_map[__rel_iq_id] = csio_get_q(__hw, __iq_idx)
479#define	csio_q_eq_wrap(__hw, __idx)	((__hw)->wrm.q_arr[(__idx)]->un.eq.wrap)
480
481struct csio_mb;
482
483int csio_wr_alloc_q(struct csio_hw *, uint32_t, uint32_t,
484		    uint16_t, void *, uint32_t, int, iq_handler_t);
485int csio_wr_iq_create(struct csio_hw *, void *, int,
486				uint32_t, uint8_t, bool,
487				void (*)(struct csio_hw *, struct csio_mb *));
488int csio_wr_eq_create(struct csio_hw *, void *, int, int, uint8_t,
489				void (*)(struct csio_hw *, struct csio_mb *));
490int csio_wr_destroy_queues(struct csio_hw *, bool cmd);
491
492
493int csio_wr_get(struct csio_hw *, int, uint32_t,
494			  struct csio_wr_pair *);
495void csio_wr_copy_to_wrp(void *, struct csio_wr_pair *, uint32_t, uint32_t);
496int csio_wr_issue(struct csio_hw *, int, bool);
497int csio_wr_process_iq(struct csio_hw *, struct csio_q *,
498				 void (*)(struct csio_hw *, void *,
499					  uint32_t, struct csio_fl_dma_buf *,
500					  void *),
501				 void *);
502int csio_wr_process_iq_idx(struct csio_hw *, int,
503				 void (*)(struct csio_hw *, void *,
504					  uint32_t, struct csio_fl_dma_buf *,
505					  void *),
506				 void *);
507
508void csio_wr_sge_init(struct csio_hw *);
509int csio_wrm_init(struct csio_wrm *, struct csio_hw *);
510void csio_wrm_exit(struct csio_wrm *, struct csio_hw *);
511
512#endif /* ifndef __CSIO_WR_H__ */
513