LXR linux/arch/powerpc/include/asm/vas.h

   1/* SPDX-License-Identifier: GPL-2.0-or-later */
   2/*
   3 * Copyright 2016-17 IBM Corp.
   4 */
   5
   6#ifndef _ASM_POWERPC_VAS_H
   7#define _ASM_POWERPC_VAS_H
   8
   9struct vas_window;
  10
  11/*
  12 * Min and max FIFO sizes are based on Version 1.05 Section 3.1.4.25
  13 * (Local FIFO Size Register) of the VAS workbook.
  14 */
  15#define VAS_RX_FIFO_SIZE_MIN    (1 << 10)       /* 1KB */
  16#define VAS_RX_FIFO_SIZE_MAX    (8 << 20)       /* 8MB */
  17
  18/*
  19 * Threshold Control Mode: Have paste operation fail if the number of
  20 * requests in receive FIFO exceeds a threshold.
  21 *
  22 * NOTE: No special error code yet if paste is rejected because of these
  23 *       limits. So users can't distinguish between this and other errors.
  24 */
  25#define VAS_THRESH_DISABLED             0
  26#define VAS_THRESH_FIFO_GT_HALF_FULL    1
  27#define VAS_THRESH_FIFO_GT_QTR_FULL     2
  28#define VAS_THRESH_FIFO_GT_EIGHTH_FULL  3
  29
  30/*
  31 * Get/Set bit fields
  32 */
  33#define GET_FIELD(m, v)                (((v) & (m)) >> MASK_LSH(m))
  34#define MASK_LSH(m)            (__builtin_ffsl(m) - 1)
  35#define SET_FIELD(m, v, val)   \
  36                (((v) & ~(m)) | ((((typeof(v))(val)) << MASK_LSH(m)) & (m)))
  37
  38/*
  39 * Co-processor Engine type.
  40 */
  41enum vas_cop_type {
  42        VAS_COP_TYPE_FAULT,
  43        VAS_COP_TYPE_842,
  44        VAS_COP_TYPE_842_HIPRI,
  45        VAS_COP_TYPE_GZIP,
  46        VAS_COP_TYPE_GZIP_HIPRI,
  47        VAS_COP_TYPE_FTW,
  48        VAS_COP_TYPE_MAX,
  49};
  50
  51/*
  52 * Receive window attributes specified by the (in-kernel) owner of window.
  53 */
  54struct vas_rx_win_attr {
  55        void *rx_fifo;
  56        int rx_fifo_size;
  57        int wcreds_max;
  58
  59        bool pin_win;
  60        bool rej_no_credit;
  61        bool tx_wcred_mode;
  62        bool rx_wcred_mode;
  63        bool tx_win_ord_mode;
  64        bool rx_win_ord_mode;
  65        bool data_stamp;
  66        bool nx_win;
  67        bool fault_win;
  68        bool user_win;
  69        bool notify_disable;
  70        bool intr_disable;
  71        bool notify_early;
  72
  73        int lnotify_lpid;
  74        int lnotify_pid;
  75        int lnotify_tid;
  76        u32 pswid;
  77
  78        int tc_mode;
  79};
  80
  81/*
  82 * Window attributes specified by the in-kernel owner of a send window.
  83 */
  84struct vas_tx_win_attr {
  85        enum vas_cop_type cop;
  86        int wcreds_max;
  87        int lpid;
  88        int pidr;               /* hardware PID (from SPRN_PID) */
  89        int pid;                /* linux process id */
  90        int pswid;
  91        int rsvd_txbuf_count;
  92        int tc_mode;
  93
  94        bool user_win;
  95        bool pin_win;
  96        bool rej_no_credit;
  97        bool rsvd_txbuf_enable;
  98        bool tx_wcred_mode;
  99        bool rx_wcred_mode;
 100        bool tx_win_ord_mode;
 101        bool rx_win_ord_mode;
 102};
 103
 104/*
 105 * Helper to map a chip id to VAS id.
 106 * For POWER9, this is a 1:1 mapping. In the future this maybe a 1:N
 107 * mapping in which case, we will need to update this helper.
 108 *
 109 * Return the VAS id or -1 if no matching vasid is found.
 110 */
 111int chip_to_vas_id(int chipid);
 112
 113/*
 114 * Helper to initialize receive window attributes to defaults for an
 115 * NX window.
 116 */
 117void vas_init_rx_win_attr(struct vas_rx_win_attr *rxattr, enum vas_cop_type cop);
 118
 119/*
 120 * Open a VAS receive window for the instance of VAS identified by @vasid
 121 * Use @attr to initialize the attributes of the window.
 122 *
 123 * Return a handle to the window or ERR_PTR() on error.
 124 */
 125struct vas_window *vas_rx_win_open(int vasid, enum vas_cop_type cop,
 126                                   struct vas_rx_win_attr *attr);
 127
 128/*
 129 * Helper to initialize send window attributes to defaults for an NX window.
 130 */
 131extern void vas_init_tx_win_attr(struct vas_tx_win_attr *txattr,
 132                        enum vas_cop_type cop);
 133
 134/*
 135 * Open a VAS send window for the instance of VAS identified by @vasid
 136 * and the co-processor type @cop. Use @attr to initialize attributes
 137 * of the window.
 138 *
 139 * Note: The instance of VAS must already have an open receive window for
 140 * the coprocessor type @cop.
 141 *
 142 * Return a handle to the send window or ERR_PTR() on error.
 143 */
 144struct vas_window *vas_tx_win_open(int vasid, enum vas_cop_type cop,
 145                        struct vas_tx_win_attr *attr);
 146
 147/*
 148 * Close the send or receive window identified by @win. For receive windows
 149 * return -EAGAIN if there are active send windows attached to this receive
 150 * window.
 151 */
 152int vas_win_close(struct vas_window *win);
 153
 154/*
 155 * Copy the co-processor request block (CRB) @crb into the local L2 cache.
 156 */
 157int vas_copy_crb(void *crb, int offset);
 158
 159/*
 160 * Paste a previously copied CRB (see vas_copy_crb()) from the L2 cache to
 161 * the hardware address associated with the window @win. @re is expected/
 162 * assumed to be true for NX windows.
 163 */
 164int vas_paste_crb(struct vas_window *win, int offset, bool re);
 165
 166#endif /* __ASM_POWERPC_VAS_H */
 167