xref: /linux/drivers/infiniband/hw/hfi1/sdma.h (revision 0ea5c948cb64bab5bc7a5516774eb8536f05aa0d)
1 /* SPDX-License-Identifier: GPL-2.0 OR BSD-3-Clause */
2 /*
3  * Copyright(c) 2015 - 2018 Intel Corporation.
4  */
5 
6 #ifndef _HFI1_SDMA_H
7 #define _HFI1_SDMA_H
8 
9 #include <linux/types.h>
10 #include <linux/list.h>
11 #include <asm/byteorder.h>
12 #include <linux/workqueue.h>
13 #include <linux/rculist.h>
14 
15 #include "hfi.h"
16 #include "verbs.h"
17 #include "sdma_txreq.h"
18 
19 /* Hardware limit */
20 #define MAX_DESC 64
21 /* Hardware limit for SDMA packet size */
22 #define MAX_SDMA_PKT_SIZE ((16 * 1024) - 1)
23 
24 #define SDMA_MAP_NONE          0
25 #define SDMA_MAP_SINGLE        1
26 #define SDMA_MAP_PAGE          2
27 
28 #define SDMA_AHG_VALUE_MASK          0xffff
29 #define SDMA_AHG_VALUE_SHIFT         0
30 #define SDMA_AHG_INDEX_MASK          0xf
31 #define SDMA_AHG_INDEX_SHIFT         16
32 #define SDMA_AHG_FIELD_LEN_MASK      0xf
33 #define SDMA_AHG_FIELD_LEN_SHIFT     20
34 #define SDMA_AHG_FIELD_START_MASK    0x1f
35 #define SDMA_AHG_FIELD_START_SHIFT   24
36 #define SDMA_AHG_UPDATE_ENABLE_MASK  0x1
37 #define SDMA_AHG_UPDATE_ENABLE_SHIFT 31
38 
39 /* AHG modes */
40 
41 /*
42  * Be aware the ordering and values
43  * for SDMA_AHG_APPLY_UPDATE[123]
44  * are assumed in generating a skip
45  * count in submit_tx() in sdma.c
46  */
47 #define SDMA_AHG_NO_AHG              0
48 #define SDMA_AHG_COPY                1
49 #define SDMA_AHG_APPLY_UPDATE1       2
50 #define SDMA_AHG_APPLY_UPDATE2       3
51 #define SDMA_AHG_APPLY_UPDATE3       4
52 
53 /*
54  * Bits defined in the send DMA descriptor.
55  */
56 #define SDMA_DESC0_FIRST_DESC_FLAG      BIT_ULL(63)
57 #define SDMA_DESC0_LAST_DESC_FLAG       BIT_ULL(62)
58 #define SDMA_DESC0_BYTE_COUNT_SHIFT     48
59 #define SDMA_DESC0_BYTE_COUNT_WIDTH     14
60 #define SDMA_DESC0_BYTE_COUNT_MASK \
61 	((1ULL << SDMA_DESC0_BYTE_COUNT_WIDTH) - 1)
62 #define SDMA_DESC0_BYTE_COUNT_SMASK \
63 	(SDMA_DESC0_BYTE_COUNT_MASK << SDMA_DESC0_BYTE_COUNT_SHIFT)
64 #define SDMA_DESC0_PHY_ADDR_SHIFT       0
65 #define SDMA_DESC0_PHY_ADDR_WIDTH       48
66 #define SDMA_DESC0_PHY_ADDR_MASK \
67 	((1ULL << SDMA_DESC0_PHY_ADDR_WIDTH) - 1)
68 #define SDMA_DESC0_PHY_ADDR_SMASK \
69 	(SDMA_DESC0_PHY_ADDR_MASK << SDMA_DESC0_PHY_ADDR_SHIFT)
70 
71 #define SDMA_DESC1_HEADER_UPDATE1_SHIFT 32
72 #define SDMA_DESC1_HEADER_UPDATE1_WIDTH 32
73 #define SDMA_DESC1_HEADER_UPDATE1_MASK \
74 	((1ULL << SDMA_DESC1_HEADER_UPDATE1_WIDTH) - 1)
75 #define SDMA_DESC1_HEADER_UPDATE1_SMASK \
76 	(SDMA_DESC1_HEADER_UPDATE1_MASK << SDMA_DESC1_HEADER_UPDATE1_SHIFT)
77 #define SDMA_DESC1_HEADER_MODE_SHIFT    13
78 #define SDMA_DESC1_HEADER_MODE_WIDTH    3
79 #define SDMA_DESC1_HEADER_MODE_MASK \
80 	((1ULL << SDMA_DESC1_HEADER_MODE_WIDTH) - 1)
81 #define SDMA_DESC1_HEADER_MODE_SMASK \
82 	(SDMA_DESC1_HEADER_MODE_MASK << SDMA_DESC1_HEADER_MODE_SHIFT)
83 #define SDMA_DESC1_HEADER_INDEX_SHIFT   8
84 #define SDMA_DESC1_HEADER_INDEX_WIDTH   5
85 #define SDMA_DESC1_HEADER_INDEX_MASK \
86 	((1ULL << SDMA_DESC1_HEADER_INDEX_WIDTH) - 1)
87 #define SDMA_DESC1_HEADER_INDEX_SMASK \
88 	(SDMA_DESC1_HEADER_INDEX_MASK << SDMA_DESC1_HEADER_INDEX_SHIFT)
89 #define SDMA_DESC1_HEADER_DWS_SHIFT     4
90 #define SDMA_DESC1_HEADER_DWS_WIDTH     4
91 #define SDMA_DESC1_HEADER_DWS_MASK \
92 	((1ULL << SDMA_DESC1_HEADER_DWS_WIDTH) - 1)
93 #define SDMA_DESC1_HEADER_DWS_SMASK \
94 	(SDMA_DESC1_HEADER_DWS_MASK << SDMA_DESC1_HEADER_DWS_SHIFT)
95 #define SDMA_DESC1_GENERATION_SHIFT     2
96 #define SDMA_DESC1_GENERATION_WIDTH     2
97 #define SDMA_DESC1_GENERATION_MASK \
98 	((1ULL << SDMA_DESC1_GENERATION_WIDTH) - 1)
99 #define SDMA_DESC1_GENERATION_SMASK \
100 	(SDMA_DESC1_GENERATION_MASK << SDMA_DESC1_GENERATION_SHIFT)
101 #define SDMA_DESC1_INT_REQ_FLAG         BIT_ULL(1)
102 #define SDMA_DESC1_HEAD_TO_HOST_FLAG    BIT_ULL(0)
103 
104 enum sdma_states {
105 	sdma_state_s00_hw_down,
106 	sdma_state_s10_hw_start_up_halt_wait,
107 	sdma_state_s15_hw_start_up_clean_wait,
108 	sdma_state_s20_idle,
109 	sdma_state_s30_sw_clean_up_wait,
110 	sdma_state_s40_hw_clean_up_wait,
111 	sdma_state_s50_hw_halt_wait,
112 	sdma_state_s60_idle_halt_wait,
113 	sdma_state_s80_hw_freeze,
114 	sdma_state_s82_freeze_sw_clean,
115 	sdma_state_s99_running,
116 };
117 
118 enum sdma_events {
119 	sdma_event_e00_go_hw_down,
120 	sdma_event_e10_go_hw_start,
121 	sdma_event_e15_hw_halt_done,
122 	sdma_event_e25_hw_clean_up_done,
123 	sdma_event_e30_go_running,
124 	sdma_event_e40_sw_cleaned,
125 	sdma_event_e50_hw_cleaned,
126 	sdma_event_e60_hw_halted,
127 	sdma_event_e70_go_idle,
128 	sdma_event_e80_hw_freeze,
129 	sdma_event_e81_hw_frozen,
130 	sdma_event_e82_hw_unfreeze,
131 	sdma_event_e85_link_down,
132 	sdma_event_e90_sw_halted,
133 };
134 
135 struct sdma_set_state_action {
136 	unsigned op_enable:1;
137 	unsigned op_intenable:1;
138 	unsigned op_halt:1;
139 	unsigned op_cleanup:1;
140 	unsigned go_s99_running_tofalse:1;
141 	unsigned go_s99_running_totrue:1;
142 };
143 
144 struct sdma_state {
145 	struct kref          kref;
146 	struct completion    comp;
147 	enum sdma_states current_state;
148 	unsigned             current_op;
149 	unsigned             go_s99_running;
150 	/* debugging/development */
151 	enum sdma_states previous_state;
152 	unsigned             previous_op;
153 	enum sdma_events last_event;
154 };
155 
156 /**
157  * DOC: sdma exported routines
158  *
159  * These sdma routines fit into three categories:
160  * - The SDMA API for building and submitting packets
161  *   to the ring
162  *
163  * - Initialization and tear down routines to buildup
164  *   and tear down SDMA
165  *
166  * - ISR entrances to handle interrupts, state changes
167  *   and errors
168  */
169 
170 /**
171  * DOC: sdma PSM/verbs API
172  *
173  * The sdma API is designed to be used by both PSM
174  * and verbs to supply packets to the SDMA ring.
175  *
176  * The usage of the API is as follows:
177  *
178  * Embed a struct iowait in the QP or
179  * PQ.  The iowait should be initialized with a
180  * call to iowait_init().
181  *
182  * The user of the API should create an allocation method
183  * for their version of the txreq. slabs, pre-allocated lists,
184  * and dma pools can be used.  Once the user's overload of
185  * the sdma_txreq has been allocated, the sdma_txreq member
186  * must be initialized with sdma_txinit() or sdma_txinit_ahg().
187  *
188  * The txreq must be declared with the sdma_txreq first.
189  *
190  * The tx request, once initialized,  is manipulated with calls to
191  * sdma_txadd_daddr(), sdma_txadd_page(), or sdma_txadd_kvaddr()
192  * for each disjoint memory location.  It is the user's responsibility
193  * to understand the packet boundaries and page boundaries to do the
194  * appropriate number of sdma_txadd_* calls..  The user
195  * must be prepared to deal with failures from these routines due to
196  * either memory allocation or dma_mapping failures.
197  *
198  * The mapping specifics for each memory location are recorded
199  * in the tx. Memory locations added with sdma_txadd_page()
200  * and sdma_txadd_kvaddr() are automatically mapped when added
201  * to the tx and nmapped as part of the progress processing in the
202  * SDMA interrupt handling.
203  *
204  * sdma_txadd_daddr() is used to add an dma_addr_t memory to the
205  * tx.   An example of a use case would be a pre-allocated
206  * set of headers allocated via dma_pool_alloc() or
207  * dma_alloc_coherent().  For these memory locations, it
208  * is the responsibility of the user to handle that unmapping.
209  * (This would usually be at an unload or job termination.)
210  *
211  * The routine sdma_send_txreq() is used to submit
212  * a tx to the ring after the appropriate number of
213  * sdma_txadd_* have been done.
214  *
215  * If it is desired to send a burst of sdma_txreqs, sdma_send_txlist()
216  * can be used to submit a list of packets.
217  *
218  * The user is free to use the link overhead in the struct sdma_txreq as
219  * long as the tx isn't in flight.
220  *
221  * The extreme degenerate case of the number of descriptors
222  * exceeding the ring size is automatically handled as
223  * memory locations are added.  An overflow of the descriptor
224  * array that is part of the sdma_txreq is also automatically
225  * handled.
226  *
227  */
228 
229 /**
230  * DOC: Infrastructure calls
231  *
232  * sdma_init() is used to initialize data structures and
233  * CSRs for the desired number of SDMA engines.
234  *
235  * sdma_start() is used to kick the SDMA engines initialized
236  * with sdma_init().   Interrupts must be enabled at this
237  * point since aspects of the state machine are interrupt
238  * driven.
239  *
240  * sdma_engine_error() and sdma_engine_interrupt() are
241  * entrances for interrupts.
242  *
243  * sdma_map_init() is for the management of the mapping
244  * table when the number of vls is changed.
245  *
246  */
247 
248 /*
249  * struct hw_sdma_desc - raw 128 bit SDMA descriptor
250  *
251  * This is the raw descriptor in the SDMA ring
252  */
253 struct hw_sdma_desc {
254 	/* private:  don't use directly */
255 	__le64 qw[2];
256 };
257 
258 /**
259  * struct sdma_engine - Data pertaining to each SDMA engine.
260  * @dd: a back-pointer to the device data
261  * @ppd: per port back-pointer
262  * @imask: mask for irq manipulation
263  * @idle_mask: mask for determining if an interrupt is due to sdma_idle
264  *
265  * This structure has the state for each sdma_engine.
266  *
267  * Accessing to non public fields are not supported
268  * since the private members are subject to change.
269  */
270 struct sdma_engine {
271 	/* read mostly */
272 	struct hfi1_devdata *dd;
273 	struct hfi1_pportdata *ppd;
274 	/* private: */
275 	void __iomem *tail_csr;
276 	u64 imask;			/* clear interrupt mask */
277 	u64 idle_mask;
278 	u64 progress_mask;
279 	u64 int_mask;
280 	/* private: */
281 	volatile __le64      *head_dma; /* DMA'ed by chip */
282 	/* private: */
283 	dma_addr_t            head_phys;
284 	/* private: */
285 	struct hw_sdma_desc *descq;
286 	/* private: */
287 	unsigned descq_full_count;
288 	struct sdma_txreq **tx_ring;
289 	/* private: */
290 	dma_addr_t            descq_phys;
291 	/* private */
292 	u32 sdma_mask;
293 	/* private */
294 	struct sdma_state state;
295 	/* private */
296 	int cpu;
297 	/* private: */
298 	u8 sdma_shift;
299 	/* private: */
300 	u8 this_idx; /* zero relative engine */
301 	/* protect changes to senddmactrl shadow */
302 	spinlock_t senddmactrl_lock;
303 	/* private: */
304 	u64 p_senddmactrl;		/* shadow per-engine SendDmaCtrl */
305 
306 	/* read/write using tail_lock */
307 	spinlock_t            tail_lock ____cacheline_aligned_in_smp;
308 #ifdef CONFIG_HFI1_DEBUG_SDMA_ORDER
309 	/* private: */
310 	u64                   tail_sn;
311 #endif
312 	/* private: */
313 	u32                   descq_tail;
314 	/* private: */
315 	unsigned long         ahg_bits;
316 	/* private: */
317 	u16                   desc_avail;
318 	/* private: */
319 	u16                   tx_tail;
320 	/* private: */
321 	u16 descq_cnt;
322 
323 	/* read/write using head_lock */
324 	/* private: */
325 	seqlock_t            head_lock ____cacheline_aligned_in_smp;
326 #ifdef CONFIG_HFI1_DEBUG_SDMA_ORDER
327 	/* private: */
328 	u64                   head_sn;
329 #endif
330 	/* private: */
331 	u32                   descq_head;
332 	/* private: */
333 	u16                   tx_head;
334 	/* private: */
335 	u64                   last_status;
336 	/* private */
337 	u64                     err_cnt;
338 	/* private */
339 	u64                     sdma_int_cnt;
340 	u64                     idle_int_cnt;
341 	u64                     progress_int_cnt;
342 
343 	/* private: */
344 	seqlock_t            waitlock;
345 	struct list_head      dmawait;
346 
347 	/* CONFIG SDMA for now, just blindly duplicate */
348 	/* private: */
349 	struct tasklet_struct sdma_hw_clean_up_task
350 		____cacheline_aligned_in_smp;
351 
352 	/* private: */
353 	struct tasklet_struct sdma_sw_clean_up_task
354 		____cacheline_aligned_in_smp;
355 	/* private: */
356 	struct work_struct err_halt_worker;
357 	/* private */
358 	struct timer_list     err_progress_check_timer;
359 	u32                   progress_check_head;
360 	/* private: */
361 	struct work_struct flush_worker;
362 	/* protect flush list */
363 	spinlock_t flushlist_lock;
364 	/* private: */
365 	struct list_head flushlist;
366 	struct cpumask cpu_mask;
367 	struct kobject kobj;
368 	u32 msix_intr;
369 };
370 
371 int sdma_init(struct hfi1_devdata *dd, u8 port);
372 void sdma_start(struct hfi1_devdata *dd);
373 void sdma_exit(struct hfi1_devdata *dd);
374 void sdma_clean(struct hfi1_devdata *dd, size_t num_engines);
375 void sdma_all_running(struct hfi1_devdata *dd);
376 void sdma_all_idle(struct hfi1_devdata *dd);
377 void sdma_freeze_notify(struct hfi1_devdata *dd, int go_idle);
378 void sdma_freeze(struct hfi1_devdata *dd);
379 void sdma_unfreeze(struct hfi1_devdata *dd);
380 void sdma_wait(struct hfi1_devdata *dd);
381 
382 /**
383  * sdma_empty() - idle engine test
384  * @engine: sdma engine
385  *
386  * Currently used by verbs as a latency optimization.
387  *
388  * Return:
389  * 1 - empty, 0 - non-empty
390  */
sdma_empty(struct sdma_engine * sde)391 static inline int sdma_empty(struct sdma_engine *sde)
392 {
393 	return sde->descq_tail == sde->descq_head;
394 }
395 
sdma_descq_freecnt(struct sdma_engine * sde)396 static inline u16 sdma_descq_freecnt(struct sdma_engine *sde)
397 {
398 	return sde->descq_cnt -
399 		(sde->descq_tail -
400 		 READ_ONCE(sde->descq_head)) - 1;
401 }
402 
sdma_descq_inprocess(struct sdma_engine * sde)403 static inline u16 sdma_descq_inprocess(struct sdma_engine *sde)
404 {
405 	return sde->descq_cnt - sdma_descq_freecnt(sde);
406 }
407 
408 /*
409  * Either head_lock or tail lock required to see
410  * a steady state.
411  */
__sdma_running(struct sdma_engine * engine)412 static inline int __sdma_running(struct sdma_engine *engine)
413 {
414 	return engine->state.current_state == sdma_state_s99_running;
415 }
416 
417 /**
418  * sdma_running() - state suitability test
419  * @engine: sdma engine
420  *
421  * sdma_running probes the internal state to determine if it is suitable
422  * for submitting packets.
423  *
424  * Return:
425  * 1 - ok to submit, 0 - not ok to submit
426  *
427  */
sdma_running(struct sdma_engine * engine)428 static inline int sdma_running(struct sdma_engine *engine)
429 {
430 	unsigned long flags;
431 	int ret;
432 
433 	spin_lock_irqsave(&engine->tail_lock, flags);
434 	ret = __sdma_running(engine);
435 	spin_unlock_irqrestore(&engine->tail_lock, flags);
436 	return ret;
437 }
438 
439 void _sdma_txreq_ahgadd(
440 	struct sdma_txreq *tx,
441 	u8 num_ahg,
442 	u8 ahg_entry,
443 	u32 *ahg,
444 	u8 ahg_hlen);
445 
446 /**
447  * sdma_txinit_ahg() - initialize an sdma_txreq struct with AHG
448  * @tx: tx request to initialize
449  * @flags: flags to key last descriptor additions
450  * @tlen: total packet length (pbc + headers + data)
451  * @ahg_entry: ahg entry to use  (0 - 31)
452  * @num_ahg: ahg descriptor for first descriptor (0 - 9)
453  * @ahg: array of AHG descriptors (up to 9 entries)
454  * @ahg_hlen: number of bytes from ASIC entry to use
455  * @cb: callback
456  *
457  * The allocation of the sdma_txreq and it enclosing structure is user
458  * dependent.  This routine must be called to initialize the user independent
459  * fields.
460  *
461  * The currently supported flags are SDMA_TXREQ_F_URGENT,
462  * SDMA_TXREQ_F_AHG_COPY, and SDMA_TXREQ_F_USE_AHG.
463  *
464  * SDMA_TXREQ_F_URGENT is used for latency sensitive situations where the
465  * completion is desired as soon as possible.
466  *
467  * SDMA_TXREQ_F_AHG_COPY causes the header in the first descriptor to be
468  * copied to chip entry. SDMA_TXREQ_F_USE_AHG causes the code to add in
469  * the AHG descriptors into the first 1 to 3 descriptors.
470  *
471  * Completions of submitted requests can be gotten on selected
472  * txreqs by giving a completion routine callback to sdma_txinit() or
473  * sdma_txinit_ahg().  The environment in which the callback runs
474  * can be from an ISR, a tasklet, or a thread, so no sleeping
475  * kernel routines can be used.   Aspects of the sdma ring may
476  * be locked so care should be taken with locking.
477  *
478  * The callback pointer can be NULL to avoid any callback for the packet
479  * being submitted. The callback will be provided this tx, a status, and a flag.
480  *
481  * The status will be one of SDMA_TXREQ_S_OK, SDMA_TXREQ_S_SENDERROR,
482  * SDMA_TXREQ_S_ABORTED, or SDMA_TXREQ_S_SHUTDOWN.
483  *
484  * The flag, if the is the iowait had been used, indicates the iowait
485  * sdma_busy count has reached zero.
486  *
487  * user data portion of tlen should be precise.   The sdma_txadd_* entrances
488  * will pad with a descriptor references 1 - 3 bytes when the number of bytes
489  * specified in tlen have been supplied to the sdma_txreq.
490  *
491  * ahg_hlen is used to determine the number of on-chip entry bytes to
492  * use as the header.   This is for cases where the stored header is
493  * larger than the header to be used in a packet.  This is typical
494  * for verbs where an RDMA_WRITE_FIRST is larger than the packet in
495  * and RDMA_WRITE_MIDDLE.
496  *
497  */
sdma_txinit_ahg(struct sdma_txreq * tx,u16 flags,u16 tlen,u8 ahg_entry,u8 num_ahg,u32 * ahg,u8 ahg_hlen,void (* cb)(struct sdma_txreq *,int))498 static inline int sdma_txinit_ahg(
499 	struct sdma_txreq *tx,
500 	u16 flags,
501 	u16 tlen,
502 	u8 ahg_entry,
503 	u8 num_ahg,
504 	u32 *ahg,
505 	u8 ahg_hlen,
506 	void (*cb)(struct sdma_txreq *, int))
507 {
508 	if (tlen == 0)
509 		return -ENODATA;
510 	if (tlen > MAX_SDMA_PKT_SIZE)
511 		return -EMSGSIZE;
512 	tx->desc_limit = ARRAY_SIZE(tx->descs);
513 	tx->descp = &tx->descs[0];
514 	INIT_LIST_HEAD(&tx->list);
515 	tx->num_desc = 0;
516 	tx->flags = flags;
517 	tx->complete = cb;
518 	tx->coalesce_buf = NULL;
519 	tx->wait = NULL;
520 	tx->packet_len = tlen;
521 	tx->tlen = tx->packet_len;
522 	tx->descs[0].qw[0] = SDMA_DESC0_FIRST_DESC_FLAG;
523 	tx->descs[0].qw[1] = 0;
524 	if (flags & SDMA_TXREQ_F_AHG_COPY)
525 		tx->descs[0].qw[1] |=
526 			(((u64)ahg_entry & SDMA_DESC1_HEADER_INDEX_MASK)
527 				<< SDMA_DESC1_HEADER_INDEX_SHIFT) |
528 			(((u64)SDMA_AHG_COPY & SDMA_DESC1_HEADER_MODE_MASK)
529 				<< SDMA_DESC1_HEADER_MODE_SHIFT);
530 	else if (flags & SDMA_TXREQ_F_USE_AHG && num_ahg)
531 		_sdma_txreq_ahgadd(tx, num_ahg, ahg_entry, ahg, ahg_hlen);
532 	return 0;
533 }
534 
535 /**
536  * sdma_txinit() - initialize an sdma_txreq struct (no AHG)
537  * @tx: tx request to initialize
538  * @flags: flags to key last descriptor additions
539  * @tlen: total packet length (pbc + headers + data)
540  * @cb: callback pointer
541  *
542  * The allocation of the sdma_txreq and it enclosing structure is user
543  * dependent.  This routine must be called to initialize the user
544  * independent fields.
545  *
546  * The currently supported flags is SDMA_TXREQ_F_URGENT.
547  *
548  * SDMA_TXREQ_F_URGENT is used for latency sensitive situations where the
549  * completion is desired as soon as possible.
550  *
551  * Completions of submitted requests can be gotten on selected
552  * txreqs by giving a completion routine callback to sdma_txinit() or
553  * sdma_txinit_ahg().  The environment in which the callback runs
554  * can be from an ISR, a tasklet, or a thread, so no sleeping
555  * kernel routines can be used.   The head size of the sdma ring may
556  * be locked so care should be taken with locking.
557  *
558  * The callback pointer can be NULL to avoid any callback for the packet
559  * being submitted.
560  *
561  * The callback, if non-NULL,  will be provided this tx and a status.  The
562  * status will be one of SDMA_TXREQ_S_OK, SDMA_TXREQ_S_SENDERROR,
563  * SDMA_TXREQ_S_ABORTED, or SDMA_TXREQ_S_SHUTDOWN.
564  *
565  */
sdma_txinit(struct sdma_txreq * tx,u16 flags,u16 tlen,void (* cb)(struct sdma_txreq *,int))566 static inline int sdma_txinit(
567 	struct sdma_txreq *tx,
568 	u16 flags,
569 	u16 tlen,
570 	void (*cb)(struct sdma_txreq *, int))
571 {
572 	return sdma_txinit_ahg(tx, flags, tlen, 0, 0, NULL, 0, cb);
573 }
574 
575 /* helpers - don't use */
sdma_mapping_type(struct sdma_desc * d)576 static inline int sdma_mapping_type(struct sdma_desc *d)
577 {
578 	return (d->qw[1] & SDMA_DESC1_GENERATION_SMASK)
579 		>> SDMA_DESC1_GENERATION_SHIFT;
580 }
581 
sdma_mapping_len(struct sdma_desc * d)582 static inline size_t sdma_mapping_len(struct sdma_desc *d)
583 {
584 	return (d->qw[0] & SDMA_DESC0_BYTE_COUNT_SMASK)
585 		>> SDMA_DESC0_BYTE_COUNT_SHIFT;
586 }
587 
sdma_mapping_addr(struct sdma_desc * d)588 static inline dma_addr_t sdma_mapping_addr(struct sdma_desc *d)
589 {
590 	return (d->qw[0] & SDMA_DESC0_PHY_ADDR_SMASK)
591 		>> SDMA_DESC0_PHY_ADDR_SHIFT;
592 }
593 
make_tx_sdma_desc(struct sdma_txreq * tx,int type,dma_addr_t addr,size_t len,void * pinning_ctx,void (* ctx_get)(void *),void (* ctx_put)(void *))594 static inline void make_tx_sdma_desc(
595 	struct sdma_txreq *tx,
596 	int type,
597 	dma_addr_t addr,
598 	size_t len,
599 	void *pinning_ctx,
600 	void (*ctx_get)(void *),
601 	void (*ctx_put)(void *))
602 {
603 	struct sdma_desc *desc = &tx->descp[tx->num_desc];
604 
605 	if (!tx->num_desc) {
606 		/* qw[0] zero; qw[1] first, ahg mode already in from init */
607 		desc->qw[1] |= ((u64)type & SDMA_DESC1_GENERATION_MASK)
608 				<< SDMA_DESC1_GENERATION_SHIFT;
609 	} else {
610 		desc->qw[0] = 0;
611 		desc->qw[1] = ((u64)type & SDMA_DESC1_GENERATION_MASK)
612 				<< SDMA_DESC1_GENERATION_SHIFT;
613 	}
614 	desc->qw[0] |= (((u64)addr & SDMA_DESC0_PHY_ADDR_MASK)
615 				<< SDMA_DESC0_PHY_ADDR_SHIFT) |
616 			(((u64)len & SDMA_DESC0_BYTE_COUNT_MASK)
617 				<< SDMA_DESC0_BYTE_COUNT_SHIFT);
618 
619 	desc->pinning_ctx = pinning_ctx;
620 	desc->ctx_put = ctx_put;
621 	if (pinning_ctx && ctx_get)
622 		ctx_get(pinning_ctx);
623 }
624 
625 /* helper to extend txreq */
626 int ext_coal_sdma_tx_descs(struct hfi1_devdata *dd, struct sdma_txreq *tx,
627 			   int type, void *kvaddr, struct page *page,
628 			   unsigned long offset, u16 len);
629 int _pad_sdma_tx_descs(struct hfi1_devdata *, struct sdma_txreq *);
630 void __sdma_txclean(struct hfi1_devdata *, struct sdma_txreq *);
631 
sdma_txclean(struct hfi1_devdata * dd,struct sdma_txreq * tx)632 static inline void sdma_txclean(struct hfi1_devdata *dd, struct sdma_txreq *tx)
633 {
634 	if (tx->num_desc)
635 		__sdma_txclean(dd, tx);
636 }
637 
638 /* helpers used by public routines */
_sdma_close_tx(struct hfi1_devdata * dd,struct sdma_txreq * tx)639 static inline void _sdma_close_tx(struct hfi1_devdata *dd,
640 				  struct sdma_txreq *tx)
641 {
642 	u16 last_desc = tx->num_desc - 1;
643 
644 	tx->descp[last_desc].qw[0] |= SDMA_DESC0_LAST_DESC_FLAG;
645 	tx->descp[last_desc].qw[1] |= dd->default_desc1;
646 	if (tx->flags & SDMA_TXREQ_F_URGENT)
647 		tx->descp[last_desc].qw[1] |= (SDMA_DESC1_HEAD_TO_HOST_FLAG |
648 					       SDMA_DESC1_INT_REQ_FLAG);
649 }
650 
_sdma_txadd_daddr(struct hfi1_devdata * dd,int type,struct sdma_txreq * tx,dma_addr_t addr,u16 len,void * pinning_ctx,void (* ctx_get)(void *),void (* ctx_put)(void *))651 static inline int _sdma_txadd_daddr(
652 	struct hfi1_devdata *dd,
653 	int type,
654 	struct sdma_txreq *tx,
655 	dma_addr_t addr,
656 	u16 len,
657 	void *pinning_ctx,
658 	void (*ctx_get)(void *),
659 	void (*ctx_put)(void *))
660 {
661 	int rval = 0;
662 
663 	make_tx_sdma_desc(
664 		tx,
665 		type,
666 		addr, len,
667 		pinning_ctx, ctx_get, ctx_put);
668 	WARN_ON(len > tx->tlen);
669 	tx->num_desc++;
670 	tx->tlen -= len;
671 	/* special cases for last */
672 	if (!tx->tlen) {
673 		if (tx->packet_len & (sizeof(u32) - 1)) {
674 			rval = _pad_sdma_tx_descs(dd, tx);
675 			if (rval)
676 				return rval;
677 		} else {
678 			_sdma_close_tx(dd, tx);
679 		}
680 	}
681 	return rval;
682 }
683 
684 /**
685  * sdma_txadd_page() - add a page to the sdma_txreq
686  * @dd: the device to use for mapping
687  * @tx: tx request to which the page is added
688  * @page: page to map
689  * @offset: offset within the page
690  * @len: length in bytes
691  * @pinning_ctx: context to be stored on struct sdma_desc .pinning_ctx. Not
692  *               added if coalesce buffer is used. E.g. pointer to pinned-page
693  *               cache entry for the sdma_desc.
694  * @ctx_get: optional function to take reference to @pinning_ctx. Not called if
695  *           @pinning_ctx is NULL.
696  * @ctx_put: optional function to release reference to @pinning_ctx after
697  *           sdma_desc completes. May be called in interrupt context so must
698  *           not sleep. Not called if @pinning_ctx is NULL.
699  *
700  * This is used to add a page/offset/length descriptor.
701  *
702  * The mapping/unmapping of the page/offset/len is automatically handled.
703  *
704  * Return:
705  * 0 - success, -ENOSPC - mapping fail, -ENOMEM - couldn't
706  * extend/coalesce descriptor array
707  */
sdma_txadd_page(struct hfi1_devdata * dd,struct sdma_txreq * tx,struct page * page,unsigned long offset,u16 len,void * pinning_ctx,void (* ctx_get)(void *),void (* ctx_put)(void *))708 static inline int sdma_txadd_page(
709 	struct hfi1_devdata *dd,
710 	struct sdma_txreq *tx,
711 	struct page *page,
712 	unsigned long offset,
713 	u16 len,
714 	void *pinning_ctx,
715 	void (*ctx_get)(void *),
716 	void (*ctx_put)(void *))
717 {
718 	dma_addr_t addr;
719 	int rval;
720 
721 	if ((unlikely(tx->num_desc == tx->desc_limit))) {
722 		rval = ext_coal_sdma_tx_descs(dd, tx, SDMA_MAP_PAGE,
723 					      NULL, page, offset, len);
724 		if (rval <= 0)
725 			return rval;
726 	}
727 
728 	addr = dma_map_page(
729 		       &dd->pcidev->dev,
730 		       page,
731 		       offset,
732 		       len,
733 		       DMA_TO_DEVICE);
734 
735 	if (unlikely(dma_mapping_error(&dd->pcidev->dev, addr))) {
736 		__sdma_txclean(dd, tx);
737 		return -ENOSPC;
738 	}
739 
740 	return _sdma_txadd_daddr(dd, SDMA_MAP_PAGE, tx, addr, len,
741 				 pinning_ctx, ctx_get, ctx_put);
742 }
743 
744 /**
745  * sdma_txadd_daddr() - add a dma address to the sdma_txreq
746  * @dd: the device to use for mapping
747  * @tx: sdma_txreq to which the page is added
748  * @addr: dma address mapped by caller
749  * @len: length in bytes
750  *
751  * This is used to add a descriptor for memory that is already dma mapped.
752  *
753  * In this case, there is no unmapping as part of the progress processing for
754  * this memory location.
755  *
756  * Return:
757  * 0 - success, -ENOMEM - couldn't extend descriptor array
758  */
759 
sdma_txadd_daddr(struct hfi1_devdata * dd,struct sdma_txreq * tx,dma_addr_t addr,u16 len)760 static inline int sdma_txadd_daddr(
761 	struct hfi1_devdata *dd,
762 	struct sdma_txreq *tx,
763 	dma_addr_t addr,
764 	u16 len)
765 {
766 	int rval;
767 
768 	if ((unlikely(tx->num_desc == tx->desc_limit))) {
769 		rval = ext_coal_sdma_tx_descs(dd, tx, SDMA_MAP_NONE,
770 					      NULL, NULL, 0, 0);
771 		if (rval <= 0)
772 			return rval;
773 	}
774 
775 	return _sdma_txadd_daddr(dd, SDMA_MAP_NONE, tx, addr, len,
776 				 NULL, NULL, NULL);
777 }
778 
779 /**
780  * sdma_txadd_kvaddr() - add a kernel virtual address to sdma_txreq
781  * @dd: the device to use for mapping
782  * @tx: sdma_txreq to which the page is added
783  * @kvaddr: the kernel virtual address
784  * @len: length in bytes
785  *
786  * This is used to add a descriptor referenced by the indicated kvaddr and
787  * len.
788  *
789  * The mapping/unmapping of the kvaddr and len is automatically handled.
790  *
791  * Return:
792  * 0 - success, -ENOSPC - mapping fail, -ENOMEM - couldn't extend/coalesce
793  * descriptor array
794  */
sdma_txadd_kvaddr(struct hfi1_devdata * dd,struct sdma_txreq * tx,void * kvaddr,u16 len)795 static inline int sdma_txadd_kvaddr(
796 	struct hfi1_devdata *dd,
797 	struct sdma_txreq *tx,
798 	void *kvaddr,
799 	u16 len)
800 {
801 	dma_addr_t addr;
802 	int rval;
803 
804 	if ((unlikely(tx->num_desc == tx->desc_limit))) {
805 		rval = ext_coal_sdma_tx_descs(dd, tx, SDMA_MAP_SINGLE,
806 					      kvaddr, NULL, 0, len);
807 		if (rval <= 0)
808 			return rval;
809 	}
810 
811 	addr = dma_map_single(
812 		       &dd->pcidev->dev,
813 		       kvaddr,
814 		       len,
815 		       DMA_TO_DEVICE);
816 
817 	if (unlikely(dma_mapping_error(&dd->pcidev->dev, addr))) {
818 		__sdma_txclean(dd, tx);
819 		return -ENOSPC;
820 	}
821 
822 	return _sdma_txadd_daddr(dd, SDMA_MAP_SINGLE, tx, addr, len,
823 				 NULL, NULL, NULL);
824 }
825 
826 struct iowait_work;
827 
828 int sdma_send_txreq(struct sdma_engine *sde,
829 		    struct iowait_work *wait,
830 		    struct sdma_txreq *tx,
831 		    bool pkts_sent);
832 int sdma_send_txlist(struct sdma_engine *sde,
833 		     struct iowait_work *wait,
834 		     struct list_head *tx_list,
835 		     u16 *count_out);
836 
837 int sdma_ahg_alloc(struct sdma_engine *sde);
838 void sdma_ahg_free(struct sdma_engine *sde, int ahg_index);
839 
840 /**
841  * sdma_build_ahg - build ahg descriptor
842  * @data
843  * @dwindex
844  * @startbit
845  * @bits
846  *
847  * Build and return a 32 bit descriptor.
848  */
sdma_build_ahg_descriptor(u16 data,u8 dwindex,u8 startbit,u8 bits)849 static inline u32 sdma_build_ahg_descriptor(
850 	u16 data,
851 	u8 dwindex,
852 	u8 startbit,
853 	u8 bits)
854 {
855 	return (u32)(1UL << SDMA_AHG_UPDATE_ENABLE_SHIFT |
856 		((startbit & SDMA_AHG_FIELD_START_MASK) <<
857 		SDMA_AHG_FIELD_START_SHIFT) |
858 		((bits & SDMA_AHG_FIELD_LEN_MASK) <<
859 		SDMA_AHG_FIELD_LEN_SHIFT) |
860 		((dwindex & SDMA_AHG_INDEX_MASK) <<
861 		SDMA_AHG_INDEX_SHIFT) |
862 		((data & SDMA_AHG_VALUE_MASK) <<
863 		SDMA_AHG_VALUE_SHIFT));
864 }
865 
866 /**
867  * sdma_progress - use seq number of detect head progress
868  * @sde: sdma_engine to check
869  * @seq: base seq count
870  * @tx: txreq for which we need to check descriptor availability
871  *
872  * This is used in the appropriate spot in the sleep routine
873  * to check for potential ring progress.  This routine gets the
874  * seqcount before queuing the iowait structure for progress.
875  *
876  * If the seqcount indicates that progress needs to be checked,
877  * re-submission is detected by checking whether the descriptor
878  * queue has enough descriptor for the txreq.
879  */
sdma_progress(struct sdma_engine * sde,unsigned seq,struct sdma_txreq * tx)880 static inline unsigned sdma_progress(struct sdma_engine *sde, unsigned seq,
881 				     struct sdma_txreq *tx)
882 {
883 	if (read_seqretry(&sde->head_lock, seq)) {
884 		sde->desc_avail = sdma_descq_freecnt(sde);
885 		if (tx->num_desc > sde->desc_avail)
886 			return 0;
887 		return 1;
888 	}
889 	return 0;
890 }
891 
892 /* for use by interrupt handling */
893 void sdma_engine_error(struct sdma_engine *sde, u64 status);
894 void sdma_engine_interrupt(struct sdma_engine *sde, u64 status);
895 
896 /*
897  *
898  * The diagram below details the relationship of the mapping structures
899  *
900  * Since the mapping now allows for non-uniform engines per vl, the
901  * number of engines for a vl is either the vl_engines[vl] or
902  * a computation based on num_sdma/num_vls:
903  *
904  * For example:
905  * nactual = vl_engines ? vl_engines[vl] : num_sdma/num_vls
906  *
907  * n = roundup to next highest power of 2 using nactual
908  *
909  * In the case where there are num_sdma/num_vls doesn't divide
910  * evenly, the extras are added from the last vl downward.
911  *
912  * For the case where n > nactual, the engines are assigned
913  * in a round robin fashion wrapping back to the first engine
914  * for a particular vl.
915  *
916  *               dd->sdma_map
917  *                    |                                   sdma_map_elem[0]
918  *                    |                                +--------------------+
919  *                    v                                |       mask         |
920  *               sdma_vl_map                           |--------------------|
921  *      +--------------------------+                   | sde[0] -> eng 1    |
922  *      |    list (RCU)            |                   |--------------------|
923  *      |--------------------------|                 ->| sde[1] -> eng 2    |
924  *      |    mask                  |              --/  |--------------------|
925  *      |--------------------------|            -/     |        *           |
926  *      |    actual_vls (max 8)    |          -/       |--------------------|
927  *      |--------------------------|       --/         | sde[n-1] -> eng n  |
928  *      |    vls (max 8)           |     -/            +--------------------+
929  *      |--------------------------|  --/
930  *      |    map[0]                |-/
931  *      |--------------------------|                   +---------------------+
932  *      |    map[1]                |---                |       mask          |
933  *      |--------------------------|   \----           |---------------------|
934  *      |           *              |        \--        | sde[0] -> eng 1+n   |
935  *      |           *              |           \----   |---------------------|
936  *      |           *              |                \->| sde[1] -> eng 2+n   |
937  *      |--------------------------|                   |---------------------|
938  *      |   map[vls - 1]           |-                  |         *           |
939  *      +--------------------------+ \-                |---------------------|
940  *                                     \-              | sde[m-1] -> eng m+n |
941  *                                       \             +---------------------+
942  *                                        \-
943  *                                          \
944  *                                           \-        +----------------------+
945  *                                             \-      |       mask           |
946  *                                               \     |----------------------|
947  *                                                \-   | sde[0] -> eng 1+m+n  |
948  *                                                  \- |----------------------|
949  *                                                    >| sde[1] -> eng 2+m+n  |
950  *                                                     |----------------------|
951  *                                                     |         *            |
952  *                                                     |----------------------|
953  *                                                     | sde[o-1] -> eng o+m+n|
954  *                                                     +----------------------+
955  *
956  */
957 
958 /**
959  * struct sdma_map_elem - mapping for a vl
960  * @mask - selector mask
961  * @sde - array of engines for this vl
962  *
963  * The mask is used to "mod" the selector
964  * to produce index into the trailing
965  * array of sdes.
966  */
967 struct sdma_map_elem {
968 	u32 mask;
969 	struct sdma_engine *sde[];
970 };
971 
972 /**
973  * struct sdma_map_el - mapping for a vl
974  * @engine_to_vl - map of an engine to a vl
975  * @list - rcu head for free callback
976  * @mask - vl mask to "mod" the vl to produce an index to map array
977  * @actual_vls - number of vls
978  * @vls - number of vls rounded to next power of 2
979  * @map - array of sdma_map_elem entries
980  *
981  * This is the parent mapping structure.  The trailing
982  * members of the struct point to sdma_map_elem entries, which
983  * in turn point to an array of sde's for that vl.
984  */
985 struct sdma_vl_map {
986 	s8 engine_to_vl[TXE_NUM_SDMA_ENGINES];
987 	struct rcu_head list;
988 	u32 mask;
989 	u8 actual_vls;
990 	u8 vls;
991 	struct sdma_map_elem *map[];
992 };
993 
994 int sdma_map_init(
995 	struct hfi1_devdata *dd,
996 	u8 port,
997 	u8 num_vls,
998 	u8 *vl_engines);
999 
1000 /* slow path */
1001 void _sdma_engine_progress_schedule(struct sdma_engine *sde);
1002 
1003 /**
1004  * sdma_engine_progress_schedule() - schedule progress on engine
1005  * @sde: sdma_engine to schedule progress
1006  *
1007  * This is the fast path.
1008  *
1009  */
sdma_engine_progress_schedule(struct sdma_engine * sde)1010 static inline void sdma_engine_progress_schedule(
1011 	struct sdma_engine *sde)
1012 {
1013 	if (!sde || sdma_descq_inprocess(sde) < (sde->descq_cnt / 8))
1014 		return;
1015 	_sdma_engine_progress_schedule(sde);
1016 }
1017 
1018 struct sdma_engine *sdma_select_engine_sc(
1019 	struct hfi1_devdata *dd,
1020 	u32 selector,
1021 	u8 sc5);
1022 
1023 struct sdma_engine *sdma_select_engine_vl(
1024 	struct hfi1_devdata *dd,
1025 	u32 selector,
1026 	u8 vl);
1027 
1028 struct sdma_engine *sdma_select_user_engine(struct hfi1_devdata *dd,
1029 					    u32 selector, u8 vl);
1030 ssize_t sdma_get_cpu_to_sde_map(struct sdma_engine *sde, char *buf);
1031 ssize_t sdma_set_cpu_to_sde_map(struct sdma_engine *sde, const char *buf,
1032 				size_t count);
1033 int sdma_engine_get_vl(struct sdma_engine *sde);
1034 void sdma_seqfile_dump_sde(struct seq_file *s, struct sdma_engine *);
1035 void sdma_seqfile_dump_cpu_list(struct seq_file *s, struct hfi1_devdata *dd,
1036 				unsigned long cpuid);
1037 
1038 #ifdef CONFIG_SDMA_VERBOSITY
1039 void sdma_dumpstate(struct sdma_engine *);
1040 #endif
slashstrip(char * s)1041 static inline char *slashstrip(char *s)
1042 {
1043 	char *r = s;
1044 
1045 	while (*s)
1046 		if (*s++ == '/')
1047 			r = s;
1048 	return r;
1049 }
1050 
1051 u16 sdma_get_descq_cnt(void);
1052 
1053 extern uint mod_num_sdma;
1054 
1055 void sdma_update_lmc(struct hfi1_devdata *dd, u64 mask, u32 lid);
1056 #endif
1057