include/soc/fsl/bman.h

   1 /* Copyright 2008 - 2016 Freescale Semiconductor, Inc.
   2  *
   3  * Redistribution and use in source and binary forms, with or without
   4  * modification, are permitted provided that the following conditions are met:
   5  *     * Redistributions of source code must retain the above copyright
   6  *       notice, this list of conditions and the following disclaimer.
   7  *     * Redistributions in binary form must reproduce the above copyright
   8  *       notice, this list of conditions and the following disclaimer in the
   9  *       documentation and/or other materials provided with the distribution.
  10  *     * Neither the name of Freescale Semiconductor nor the
  11  *       names of its contributors may be used to endorse or promote products
  12  *       derived from this software without specific prior written permission.
  13  *
  14  * ALTERNATIVELY, this software may be distributed under the terms of the
  15  * GNU General Public License ("GPL") as published by the Free Software
  16  * Foundation, either version 2 of that License or (at your option) any
  17  * later version.
  18  *
  19  * THIS SOFTWARE IS PROVIDED BY Freescale Semiconductor ``AS IS'' AND ANY
  20  * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
  21  * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
  22  * DISCLAIMED. IN NO EVENT SHALL Freescale Semiconductor BE LIABLE FOR ANY
  23  * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
  24  * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
  25  * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
  26  * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  27  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
  28  * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  29  */
  30
  31 #ifndef __FSL_BMAN_H
  32 #define __FSL_BMAN_H
  33
  34 /* wrapper for 48-bit buffers */
  35 struct bm_buffer {
  36         union {
  37                 struct {
  38                         __be16 bpid; /* hi 8-bits reserved */
  39                         __be16 hi; /* High 16-bits of 48-bit address */
  40                         __be32 lo; /* Low 32-bits of 48-bit address */
  41                 };
  42                 __be64 data;
  43         };
  44 } __aligned(8);
  45 /*
  46  * Restore the 48 bit address previously stored in BMan
  47  * hardware pools as a dma_addr_t
  48  */
  49 static inline dma_addr_t bm_buf_addr(const struct bm_buffer *buf)
  50 {
  51         return be64_to_cpu(buf->data) & 0xffffffffffffLLU;
  52 }
  53
  54 static inline u64 bm_buffer_get64(const struct bm_buffer *buf)
  55 {
  56         return be64_to_cpu(buf->data) & 0xffffffffffffLLU;
  57 }
  58
  59 static inline void bm_buffer_set64(struct bm_buffer *buf, u64 addr)
  60 {
  61         buf->hi = cpu_to_be16(upper_32_bits(addr));
  62         buf->lo = cpu_to_be32(lower_32_bits(addr));
  63 }
  64
  65 static inline u8 bm_buffer_get_bpid(const struct bm_buffer *buf)
  66 {
  67         return be16_to_cpu(buf->bpid) & 0xff;
  68 }
  69
  70 static inline void bm_buffer_set_bpid(struct bm_buffer *buf, int bpid)
  71 {
  72         buf->bpid = cpu_to_be16(bpid & 0xff);
  73 }
  74
  75 /* Managed portal, high-level i/face */
  76
  77 /* Portal and Buffer Pools */
  78 struct bman_portal;
  79 struct bman_pool;
  80
  81 #define BM_POOL_MAX             64 /* max # of buffer pools */
  82
  83 /**
  84  * bman_new_pool - Allocates a Buffer Pool object
  85  *
  86  * Creates a pool object, and returns a reference to it or NULL on error.
  87  */
  88 struct bman_pool *bman_new_pool(void);
  89
  90 /**
  91  * bman_free_pool - Deallocates a Buffer Pool object
  92  * @pool: the pool object to release
  93  */
  94 void bman_free_pool(struct bman_pool *pool);
  95
  96 /**
  97  * bman_get_bpid - Returns a pool object's BPID.
  98  * @pool: the pool object
  99  *
 100  * The returned value is the index of the encapsulated buffer pool,
 101  * in the range of [0, @BM_POOL_MAX-1].
 102  */
 103 int bman_get_bpid(const struct bman_pool *pool);
 104
 105 /**
 106  * bman_release - Release buffer(s) to the buffer pool
 107  * @pool: the buffer pool object to release to
 108  * @bufs: an array of buffers to release
 109  * @num: the number of buffers in @bufs (1-8)
 110  *
 111  * Adds the given buffers to RCR entries. If the RCR ring is unresponsive,
 112  * the function will return -ETIMEDOUT. Otherwise, it returns zero.
 113  */
 114 int bman_release(struct bman_pool *pool, const struct bm_buffer *bufs, u8 num);
 115
 116 /**
 117  * bman_acquire - Acquire buffer(s) from a buffer pool
 118  * @pool: the buffer pool object to acquire from
 119  * @bufs: array for storing the acquired buffers
 120  * @num: the number of buffers desired (@bufs is at least this big)
 121  *
 122  * Issues an "Acquire" command via the portal's management command interface.
 123  * The return value will be the number of buffers obtained from the pool, or a
 124  * negative error code if a h/w error or pool starvation was encountered. In
 125  * the latter case, the content of @bufs is undefined.
 126  */
 127 int bman_acquire(struct bman_pool *pool, struct bm_buffer *bufs, u8 num);
 128
 129 #endif  /* __FSL_BMAN_H */