root/drivers/net/ethernet/chelsio/libcxgb/libcxgb_ppm.h

INCLUDED FROM

DEFINITIONS

1. cxgbi_ppm_is_ddp_tag
2. cxgbi_ppm_sw_tag_is_usable
3. cxgbi_ppm_make_non_ddp_tag
4. cxgbi_ppm_decode_non_ddp_tag
5. cxgbi_ppm_ddp_tag_get_idx
6. cxgbi_ppm_make_ddp_tag
7. cxgbi_ppm_get_tag_caller_data
8. cxgbi_ppm_ddp_tag_update_sw_bits
9. cxgbi_ppm_ppod_clear
10. cxgbi_tagmask_check

   1 /*
   2  * libcxgb_ppm.h: Chelsio common library for T3/T4/T5 iSCSI ddp operation
   3  *
   4  * Copyright (c) 2016 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  * Written by: Karen Xie (kxie@chelsio.com)
  35  */
  36 
  37 #ifndef __LIBCXGB_PPM_H__
  38 #define __LIBCXGB_PPM_H__
  39 
  40 #include <linux/kernel.h>
  41 #include <linux/errno.h>
  42 #include <linux/types.h>
  43 #include <linux/debugfs.h>
  44 #include <linux/list.h>
  45 #include <linux/netdevice.h>
  46 #include <linux/scatterlist.h>
  47 #include <linux/skbuff.h>
  48 #include <linux/vmalloc.h>
  49 #include <linux/bitmap.h>
  50 
  51 struct cxgbi_pagepod_hdr {
  52         u32 vld_tid;
  53         u32 pgsz_tag_clr;
  54         u32 max_offset;
  55         u32 page_offset;
  56         u64 rsvd;
  57 };
  58 
  59 #define PPOD_PAGES_MAX                  4
  60 struct cxgbi_pagepod {
  61         struct cxgbi_pagepod_hdr hdr;
  62         __be64 addr[PPOD_PAGES_MAX + 1];
  63 };
  64 
  65 /* ddp tag format
  66  * for a 32-bit tag:
  67  * bit #
  68  * 31 .....   .....  0
  69  *     X   Y...Y Z...Z, where
  70  *     ^   ^^^^^ ^^^^
  71  *     |   |      |____ when ddp bit = 0: color bits
  72  *     |   |
  73  *     |   |____ when ddp bit = 0: idx into the ddp memory region
  74  *     |
  75  *     |____ ddp bit: 0 - ddp tag, 1 - non-ddp tag
  76  *
  77  *  [page selector:2] [sw/free bits] [0] [idx] [color:6]
  78  */
  79 
  80 #define DDP_PGIDX_MAX           4
  81 #define DDP_PGSZ_BASE_SHIFT     12      /* base page 4K */
  82 
  83 struct cxgbi_task_tag_info {
  84         unsigned char flags;
  85 #define CXGBI_PPOD_INFO_FLAG_VALID      0x1
  86 #define CXGBI_PPOD_INFO_FLAG_MAPPED     0x2
  87         unsigned char cid;
  88         unsigned short pg_shift;
  89         unsigned int npods;
  90         unsigned int idx;
  91         unsigned int tag;
  92         struct cxgbi_pagepod_hdr hdr;
  93         int nents;
  94         int nr_pages;
  95         struct scatterlist *sgl;
  96 };
  97 
  98 struct cxgbi_tag_format {
  99         unsigned char pgsz_order[DDP_PGIDX_MAX];
 100         unsigned char pgsz_idx_dflt;
 101         unsigned char free_bits:4;
 102         unsigned char color_bits:4;
 103         unsigned char idx_bits;
 104         unsigned char rsvd_bits;
 105         unsigned int  no_ddp_mask;
 106         unsigned int  idx_mask;
 107         unsigned int  color_mask;
 108         unsigned int  idx_clr_mask;
 109         unsigned int  rsvd_mask;
 110 };
 111 
 112 struct cxgbi_ppod_data {
 113         unsigned char pg_idx:2;
 114         unsigned char color:6;
 115         unsigned char chan_id;
 116         unsigned short npods;
 117         unsigned long caller_data;
 118 };
 119 
 120 /* per cpu ppm pool */
 121 struct cxgbi_ppm_pool {
 122         unsigned int base;              /* base index */
 123         unsigned int next;              /* next possible free index */
 124         spinlock_t lock;                /* ppm pool lock */
 125         unsigned long bmap[0];
 126 } ____cacheline_aligned_in_smp;
 127 
 128 struct cxgbi_ppm {
 129         struct kref refcnt;
 130         struct net_device *ndev;        /* net_device, 1st port */
 131         struct pci_dev *pdev;
 132         void *lldev;
 133         void **ppm_pp;
 134         struct cxgbi_tag_format tformat;
 135         unsigned int ppmax;
 136         unsigned int llimit;
 137         unsigned int base_idx;
 138 
 139         unsigned int pool_rsvd;
 140         unsigned int pool_index_max;
 141         struct cxgbi_ppm_pool __percpu *pool;
 142         /* map lock */
 143         spinlock_t map_lock;            /* ppm map lock */
 144         unsigned int bmap_index_max;
 145         unsigned int next;
 146         unsigned int max_index_in_edram;
 147         unsigned long *ppod_bmap;
 148         struct cxgbi_ppod_data ppod_data[0];
 149 };
 150 
 151 #define DDP_THRESHOLD           512
 152 
 153 #define PPOD_PAGES_SHIFT        2       /*  4 pages per pod */
 154 
 155 #define IPPOD_SIZE               sizeof(struct cxgbi_pagepod)  /*  64 */
 156 #define PPOD_SIZE_SHIFT         6
 157 
 158 /* page pods are allocated in groups of this size (must be power of 2) */
 159 #define PPOD_CLUSTER_SIZE       16U
 160 
 161 #define ULPMEM_DSGL_MAX_NPPODS  16      /*  1024/PPOD_SIZE */
 162 #define ULPMEM_IDATA_MAX_NPPODS 3       /* (PPOD_SIZE * 3 + ulptx hdr) < 256B */
 163 #define PCIE_MEMWIN_MAX_NPPODS  16      /*  1024/PPOD_SIZE */
 164 
 165 #define PPOD_COLOR_SHIFT        0
 166 #define PPOD_COLOR(x)           ((x) << PPOD_COLOR_SHIFT)
 167 
 168 #define PPOD_IDX_SHIFT          6
 169 #define PPOD_IDX_MAX_SIZE       24
 170 
 171 #define PPOD_TID_SHIFT          0
 172 #define PPOD_TID(x)             ((x) << PPOD_TID_SHIFT)
 173 
 174 #define PPOD_TAG_SHIFT          6
 175 #define PPOD_TAG(x)             ((x) << PPOD_TAG_SHIFT)
 176 
 177 #define PPOD_VALID_SHIFT        24
 178 #define PPOD_VALID(x)           ((x) << PPOD_VALID_SHIFT)
 179 #define PPOD_VALID_FLAG         PPOD_VALID(1U)
 180 
 181 #define PPOD_PI_EXTRACT_CTL_SHIFT       31
 182 #define PPOD_PI_EXTRACT_CTL(x)          ((x) << PPOD_PI_EXTRACT_CTL_SHIFT)
 183 #define PPOD_PI_EXTRACT_CTL_FLAG        V_PPOD_PI_EXTRACT_CTL(1U)
 184 
 185 #define PPOD_PI_TYPE_SHIFT              29
 186 #define PPOD_PI_TYPE_MASK               0x3
 187 #define PPOD_PI_TYPE(x)                 ((x) << PPOD_PI_TYPE_SHIFT)
 188 
 189 #define PPOD_PI_CHECK_CTL_SHIFT         27
 190 #define PPOD_PI_CHECK_CTL_MASK          0x3
 191 #define PPOD_PI_CHECK_CTL(x)            ((x) << PPOD_PI_CHECK_CTL_SHIFT)
 192 
 193 #define PPOD_PI_REPORT_CTL_SHIFT        25
 194 #define PPOD_PI_REPORT_CTL_MASK         0x3
 195 #define PPOD_PI_REPORT_CTL(x)           ((x) << PPOD_PI_REPORT_CTL_SHIFT)
 196 
 197 static inline int cxgbi_ppm_is_ddp_tag(struct cxgbi_ppm *ppm, u32 tag)
 198 {
 199         return !(tag & ppm->tformat.no_ddp_mask);
 200 }
 201 
 202 static inline int cxgbi_ppm_sw_tag_is_usable(struct cxgbi_ppm *ppm,
 203                                              u32 tag)
 204 {
 205         /* the sw tag must be using <= 31 bits */
 206         return !(tag & 0x80000000U);
 207 }
 208 
 209 static inline int cxgbi_ppm_make_non_ddp_tag(struct cxgbi_ppm *ppm,
 210                                              u32 sw_tag,
 211                                              u32 *final_tag)
 212 {
 213         struct cxgbi_tag_format *tformat = &ppm->tformat;
 214 
 215         if (!cxgbi_ppm_sw_tag_is_usable(ppm, sw_tag)) {
 216                 pr_info("sw_tag 0x%x NOT usable.\n", sw_tag);
 217                 return -EINVAL;
 218         }
 219 
 220         if (!sw_tag) {
 221                 *final_tag = tformat->no_ddp_mask;
 222         } else {
 223                 unsigned int shift = tformat->idx_bits + tformat->color_bits;
 224                 u32 lower = sw_tag & tformat->idx_clr_mask;
 225                 u32 upper = (sw_tag >> shift) << (shift + 1);
 226 
 227                 *final_tag = upper | tformat->no_ddp_mask | lower;
 228         }
 229         return 0;
 230 }
 231 
 232 static inline u32 cxgbi_ppm_decode_non_ddp_tag(struct cxgbi_ppm *ppm,
 233                                                u32 tag)
 234 {
 235         struct cxgbi_tag_format *tformat = &ppm->tformat;
 236         unsigned int shift = tformat->idx_bits + tformat->color_bits;
 237         u32 lower = tag & tformat->idx_clr_mask;
 238         u32 upper = (tag >> tformat->rsvd_bits) << shift;
 239 
 240         return upper | lower;
 241 }
 242 
 243 static inline u32 cxgbi_ppm_ddp_tag_get_idx(struct cxgbi_ppm *ppm,
 244                                             u32 ddp_tag)
 245 {
 246         u32 hw_idx = (ddp_tag >> PPOD_IDX_SHIFT) &
 247                         ppm->tformat.idx_mask;
 248 
 249         return hw_idx - ppm->base_idx;
 250 }
 251 
 252 static inline u32 cxgbi_ppm_make_ddp_tag(unsigned int hw_idx,
 253                                          unsigned char color)
 254 {
 255         return (hw_idx << PPOD_IDX_SHIFT) | ((u32)color);
 256 }
 257 
 258 static inline unsigned long
 259 cxgbi_ppm_get_tag_caller_data(struct cxgbi_ppm *ppm,
 260                               u32 ddp_tag)
 261 {
 262         u32 idx = cxgbi_ppm_ddp_tag_get_idx(ppm, ddp_tag);
 263 
 264         return ppm->ppod_data[idx].caller_data;
 265 }
 266 
 267 /* sw bits are the free bits */
 268 static inline int cxgbi_ppm_ddp_tag_update_sw_bits(struct cxgbi_ppm *ppm,
 269                                                    u32 val, u32 orig_tag,
 270                                                    u32 *final_tag)
 271 {
 272         struct cxgbi_tag_format *tformat = &ppm->tformat;
 273         u32 v = val >> tformat->free_bits;
 274 
 275         if (v) {
 276                 pr_info("sw_bits 0x%x too large, avail bits %u.\n",
 277                         val, tformat->free_bits);
 278                 return -EINVAL;
 279         }
 280         if (!cxgbi_ppm_is_ddp_tag(ppm, orig_tag))
 281                 return -EINVAL;
 282 
 283         *final_tag = (val << tformat->rsvd_bits) |
 284                      (orig_tag & ppm->tformat.rsvd_mask);
 285         return 0;
 286 }
 287 
 288 static inline void cxgbi_ppm_ppod_clear(struct cxgbi_pagepod *ppod)
 289 {
 290         ppod->hdr.vld_tid = 0U;
 291 }
 292 
 293 static inline void cxgbi_tagmask_check(unsigned int tagmask,
 294                                        struct cxgbi_tag_format *tformat)
 295 {
 296         unsigned int bits = fls(tagmask);
 297 
 298         /* reserve top most 2 bits for page selector */
 299         tformat->free_bits = 32 - 2 - bits;
 300         tformat->rsvd_bits = bits;
 301         tformat->color_bits = PPOD_IDX_SHIFT;
 302         tformat->idx_bits = bits - 1 - PPOD_IDX_SHIFT;
 303         tformat->no_ddp_mask = 1 << (bits - 1);
 304         tformat->idx_mask = (1 << tformat->idx_bits) - 1;
 305         tformat->color_mask = (1 << PPOD_IDX_SHIFT) - 1;
 306         tformat->idx_clr_mask = (1 << (bits - 1)) - 1;
 307         tformat->rsvd_mask = (1 << bits) - 1;
 308 
 309         pr_info("ippm: tagmask 0x%x, rsvd %u=%u+%u+1, mask 0x%x,0x%x, "
 310                 "pg %u,%u,%u,%u.\n",
 311                 tagmask, tformat->rsvd_bits, tformat->idx_bits,
 312                 tformat->color_bits, tformat->no_ddp_mask, tformat->rsvd_mask,
 313                 tformat->pgsz_order[0], tformat->pgsz_order[1],
 314                 tformat->pgsz_order[2], tformat->pgsz_order[3]);
 315 }
 316 
 317 int cxgbi_ppm_find_page_index(struct cxgbi_ppm *ppm, unsigned long pgsz);
 318 void cxgbi_ppm_make_ppod_hdr(struct cxgbi_ppm *ppm, u32 tag,
 319                              unsigned int tid, unsigned int offset,
 320                              unsigned int length,
 321                              struct cxgbi_pagepod_hdr *hdr);
 322 void cxgbi_ppm_ppod_release(struct cxgbi_ppm *, u32 idx);
 323 int cxgbi_ppm_ppods_reserve(struct cxgbi_ppm *, unsigned short nr_pages,
 324                             u32 per_tag_pg_idx, u32 *ppod_idx, u32 *ddp_tag,
 325                             unsigned long caller_data);
 326 int cxgbi_ppm_init(void **ppm_pp, struct net_device *, struct pci_dev *,
 327                    void *lldev, struct cxgbi_tag_format *,
 328                    unsigned int iscsi_size, unsigned int llimit,
 329                    unsigned int start, unsigned int reserve_factor,
 330                    unsigned int edram_start, unsigned int edram_size);
 331 int cxgbi_ppm_release(struct cxgbi_ppm *ppm);
 332 void cxgbi_tagmask_check(unsigned int tagmask, struct cxgbi_tag_format *);
 333 unsigned int cxgbi_tagmask_set(unsigned int ppmax);
 334 
 335 #endif  /*__LIBCXGB_PPM_H__*/