user_sdma.h 7.9 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260
  1. #ifndef _HFI1_USER_SDMA_H
  2. #define _HFI1_USER_SDMA_H
  3. /*
  4. * Copyright(c) 2015 - 2018 Intel Corporation.
  5. *
  6. * This file is provided under a dual BSD/GPLv2 license. When using or
  7. * redistributing this file, you may do so under either license.
  8. *
  9. * GPL LICENSE SUMMARY
  10. *
  11. * This program is free software; you can redistribute it and/or modify
  12. * it under the terms of version 2 of the GNU General Public License as
  13. * published by the Free Software Foundation.
  14. *
  15. * This program is distributed in the hope that it will be useful, but
  16. * WITHOUT ANY WARRANTY; without even the implied warranty of
  17. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  18. * General Public License for more details.
  19. *
  20. * BSD LICENSE
  21. *
  22. * Redistribution and use in source and binary forms, with or without
  23. * modification, are permitted provided that the following conditions
  24. * are met:
  25. *
  26. * - Redistributions of source code must retain the above copyright
  27. * notice, this list of conditions and the following disclaimer.
  28. * - Redistributions in binary form must reproduce the above copyright
  29. * notice, this list of conditions and the following disclaimer in
  30. * the documentation and/or other materials provided with the
  31. * distribution.
  32. * - Neither the name of Intel Corporation nor the names of its
  33. * contributors may be used to endorse or promote products derived
  34. * from this software without specific prior written permission.
  35. *
  36. * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  37. * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  38. * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
  39. * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
  40. * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  41. * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
  42. * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  43. * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  44. * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  45. * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  46. * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  47. *
  48. */
  49. #include <linux/device.h>
  50. #include <linux/wait.h>
  51. #include "common.h"
  52. #include "iowait.h"
  53. #include "user_exp_rcv.h"
  54. /* The maximum number of Data io vectors per message/request */
  55. #define MAX_VECTORS_PER_REQ 8
  56. /*
  57. * Maximum number of packet to send from each message/request
  58. * before moving to the next one.
  59. */
  60. #define MAX_PKTS_PER_QUEUE 16
  61. #define num_pages(x) (1 + ((((x) - 1) & PAGE_MASK) >> PAGE_SHIFT))
  62. #define req_opcode(x) \
  63. (((x) >> HFI1_SDMA_REQ_OPCODE_SHIFT) & HFI1_SDMA_REQ_OPCODE_MASK)
  64. #define req_version(x) \
  65. (((x) >> HFI1_SDMA_REQ_VERSION_SHIFT) & HFI1_SDMA_REQ_OPCODE_MASK)
  66. #define req_iovcnt(x) \
  67. (((x) >> HFI1_SDMA_REQ_IOVCNT_SHIFT) & HFI1_SDMA_REQ_IOVCNT_MASK)
  68. /* Number of BTH.PSN bits used for sequence number in expected rcvs */
  69. #define BTH_SEQ_MASK 0x7ffull
  70. #define AHG_KDETH_INTR_SHIFT 12
  71. #define AHG_KDETH_SH_SHIFT 13
  72. #define AHG_KDETH_ARRAY_SIZE 9
  73. #define PBC2LRH(x) ((((x) & 0xfff) << 2) - 4)
  74. #define LRH2PBC(x) ((((x) >> 2) + 1) & 0xfff)
  75. /**
  76. * Build an SDMA AHG header update descriptor and save it to an array.
  77. * @arr - Array to save the descriptor to.
  78. * @idx - Index of the array at which the descriptor will be saved.
  79. * @array_size - Size of the array arr.
  80. * @dw - Update index into the header in DWs.
  81. * @bit - Start bit.
  82. * @width - Field width.
  83. * @value - 16 bits of immediate data to write into the field.
  84. * Returns -ERANGE if idx is invalid. If successful, returns the next index
  85. * (idx + 1) of the array to be used for the next descriptor.
  86. */
  87. static inline int ahg_header_set(u32 *arr, int idx, size_t array_size,
  88. u8 dw, u8 bit, u8 width, u16 value)
  89. {
  90. if ((size_t)idx >= array_size)
  91. return -ERANGE;
  92. arr[idx++] = sdma_build_ahg_descriptor(value, dw, bit, width);
  93. return idx;
  94. }
  95. /* Tx request flag bits */
  96. #define TXREQ_FLAGS_REQ_ACK BIT(0) /* Set the ACK bit in the header */
  97. #define TXREQ_FLAGS_REQ_DISABLE_SH BIT(1) /* Disable header suppression */
  98. enum pkt_q_sdma_state {
  99. SDMA_PKT_Q_ACTIVE,
  100. SDMA_PKT_Q_DEFERRED,
  101. };
  102. /*
  103. * Maximum retry attempts to submit a TX request
  104. * before putting the process to sleep.
  105. */
  106. #define MAX_DEFER_RETRY_COUNT 1
  107. #define SDMA_IOWAIT_TIMEOUT 1000 /* in milliseconds */
  108. #define SDMA_DBG(req, fmt, ...) \
  109. hfi1_cdbg(SDMA, "[%u:%u:%u:%u] " fmt, (req)->pq->dd->unit, \
  110. (req)->pq->ctxt, (req)->pq->subctxt, (req)->info.comp_idx, \
  111. ##__VA_ARGS__)
  112. struct hfi1_user_sdma_pkt_q {
  113. u16 ctxt;
  114. u16 subctxt;
  115. u16 n_max_reqs;
  116. atomic_t n_reqs;
  117. u16 reqidx;
  118. struct hfi1_devdata *dd;
  119. struct kmem_cache *txreq_cache;
  120. struct user_sdma_request *reqs;
  121. unsigned long *req_in_use;
  122. struct iowait busy;
  123. enum pkt_q_sdma_state state;
  124. wait_queue_head_t wait;
  125. unsigned long unpinned;
  126. struct mmu_rb_handler *handler;
  127. atomic_t n_locked;
  128. struct mm_struct *mm;
  129. };
  130. struct hfi1_user_sdma_comp_q {
  131. u16 nentries;
  132. struct hfi1_sdma_comp_entry *comps;
  133. };
  134. struct sdma_mmu_node {
  135. struct mmu_rb_node rb;
  136. struct hfi1_user_sdma_pkt_q *pq;
  137. atomic_t refcount;
  138. struct page **pages;
  139. unsigned int npages;
  140. };
  141. struct user_sdma_iovec {
  142. struct list_head list;
  143. struct iovec iov;
  144. /* number of pages in this vector */
  145. unsigned int npages;
  146. /* array of pinned pages for this vector */
  147. struct page **pages;
  148. /*
  149. * offset into the virtual address space of the vector at
  150. * which we last left off.
  151. */
  152. u64 offset;
  153. struct sdma_mmu_node *node;
  154. };
  155. /* evict operation argument */
  156. struct evict_data {
  157. u32 cleared; /* count evicted so far */
  158. u32 target; /* target count to evict */
  159. };
  160. struct user_sdma_request {
  161. /* This is the original header from user space */
  162. struct hfi1_pkt_header hdr;
  163. /* Read mostly fields */
  164. struct hfi1_user_sdma_pkt_q *pq ____cacheline_aligned_in_smp;
  165. struct hfi1_user_sdma_comp_q *cq;
  166. /*
  167. * Pointer to the SDMA engine for this request.
  168. * Since different request could be on different VLs,
  169. * each request will need it's own engine pointer.
  170. */
  171. struct sdma_engine *sde;
  172. struct sdma_req_info info;
  173. /* TID array values copied from the tid_iov vector */
  174. u32 *tids;
  175. /* total length of the data in the request */
  176. u32 data_len;
  177. /* number of elements copied to the tids array */
  178. u16 n_tids;
  179. /*
  180. * We copy the iovs for this request (based on
  181. * info.iovcnt). These are only the data vectors
  182. */
  183. u8 data_iovs;
  184. s8 ahg_idx;
  185. /* Writeable fields shared with interrupt */
  186. u64 seqcomp ____cacheline_aligned_in_smp;
  187. u64 seqsubmitted;
  188. /* Send side fields */
  189. struct list_head txps ____cacheline_aligned_in_smp;
  190. u64 seqnum;
  191. /*
  192. * KDETH.OFFSET (TID) field
  193. * The offset can cover multiple packets, depending on the
  194. * size of the TID entry.
  195. */
  196. u32 tidoffset;
  197. /*
  198. * KDETH.Offset (Eager) field
  199. * We need to remember the initial value so the headers
  200. * can be updated properly.
  201. */
  202. u32 koffset;
  203. u32 sent;
  204. /* TID index copied from the tid_iov vector */
  205. u16 tididx;
  206. /* progress index moving along the iovs array */
  207. u8 iov_idx;
  208. u8 has_error;
  209. struct user_sdma_iovec iovs[MAX_VECTORS_PER_REQ];
  210. } ____cacheline_aligned_in_smp;
  211. /*
  212. * A single txreq could span up to 3 physical pages when the MTU
  213. * is sufficiently large (> 4K). Each of the IOV pointers also
  214. * needs it's own set of flags so the vector has been handled
  215. * independently of each other.
  216. */
  217. struct user_sdma_txreq {
  218. /* Packet header for the txreq */
  219. struct hfi1_pkt_header hdr;
  220. struct sdma_txreq txreq;
  221. struct list_head list;
  222. struct user_sdma_request *req;
  223. u16 flags;
  224. u64 seqnum;
  225. };
  226. int hfi1_user_sdma_alloc_queues(struct hfi1_ctxtdata *uctxt,
  227. struct hfi1_filedata *fd);
  228. int hfi1_user_sdma_free_queues(struct hfi1_filedata *fd,
  229. struct hfi1_ctxtdata *uctxt);
  230. int hfi1_user_sdma_process_request(struct hfi1_filedata *fd,
  231. struct iovec *iovec, unsigned long dim,
  232. unsigned long *count);
  233. #endif /* _HFI1_USER_SDMA_H */